Picture Placemat

version 2.0 (2011)

Installation using a Hosting Service

Main Page

Web Interface/Management Type
Document Not Complete or Validated

CPanel Based Systems
Plesk Based Systems

Notes:
- make sure the web service options show that 'CGI Support' or 'CGI Scripts' or similar is enabled
- usually you can not unpack an archive file (zip, tar, bz etc) so you will likely have to copy the files individually via ftp or the web interface
- before you begin, you should be prepared to provide a few bits of information
  1. a name for the directory that will hold all your images. A default name is provided. More Information on Image File & Directory Layout (link)
  2. a name for the Database Table. This is a smaller area within the database. A default is provided, it does not impact picture presentations
  3. a Database User Name, used by scripts to access the database and does not impact picture presentations
  4. the Database User's Password, used by scripts to access the database and does not impact picture presentations
    this should be 5 to 10 characters long. Letters and Numbers only, no special characters

CPanel Based Systems
Tested at: !!TOTALLY UNTESTED!!
1. Ensure you have Apache Web Server, MySQL Database Server, Image Magick (image utilities) and Curl installed
  - if you're not sure, you can just test for Apache and MySQL. The install will check the rest anyway.
2. untar locally
3. copy (ftp, scp) files from the tar archive into the cgi-bin directory on the web server
4. use interface to set these 4 files to permissions of 500 (wx--)
  - ppm_home.sh
  - ppm_libs-f.sh
  - ppm_libs-v.sh
  - ppm_setup-env.sh
  or using ftp cd into cgi-bin and run:
```
  chmod 500 ppm_home.sh ppm_libs-f.sh ppm_libs-v.sh ppm_setup-env.sh
      
```
5. in your web browser enter: (replace 'example.com' with your domain name)
```
  http://example.com/cgi-bin/ppm_home.sh
      
```
  - this starts the setup program
  - most fields are prepopulated but must be confirmed
  - you must provide:
    - 'Database Name', 'DB User-name' and 'DB User Password'
    - in most cases the DocumentRoot should be correct, but on a Debian based or custom configured service this may not work
      in which case you may be best to just ask the support team at the Hosting Service
      - there is a field for the basic directory name and a second one which must include the full path
  - complete all steps, including setting Administrator password, and ending in the Admin Tools area
6. next step is Set Up the Images Area

TOP

Plesk Based Systems
Tested at: webnames.ca
1. Ensure you have Apache Web Server, MySQL Database Server, Image Magick (image utilities) and Curl installed
  - if you're not sure, you can just test for Apache and MySQL. The install will check the rest anyway.
2. in your browser, go to the hosting service. Probably something like http://hosting-service.com/login
3. go to database tool. Create users if not existing, go to databse should only be one.
  - you will need the Database User Name and Password as well as the Database Name later in the install
4. untar locally
5. copy (ftp, scp) files from the tar archive into the cgi-bin directory on the web server
6. untar it
7. copy files from the tar archive into the cgi-bin directory
8. use interface to set these 4 files to permissions of 500 (wx--)
  - ppm_home.sh
  - ppm_libs-f.sh
  - ppm_libs-v.sh
  - ppm_setup-env.sh
  or using ftp cd into cgi-bin and run:
```
  chmod 500 ppm_home.sh ppm_libs-f.sh ppm_libs-v.sh ppm_setup-env.sh
      
```
9. in your web browser enter: (replace 'example.com' with your domain name)
```
  http://example.com/cgi-bin/ppm_home.sh
      
```
  - this starts the setup program
  - most fields are prepopulated but must be confirmed
  - you must provide:
    - 'Database Name', 'DB User-name' and 'DB User Password'
  - complete all steps, including setting Administrator password, and ending in the Admin Tools area
10. next step is Set Up the Images Area

TOP