emAlbum.com
Welcome, Guest. Please Login or Register.
 
 :: emAlbum Standard - Documentation
Installation
This page will explain how to install emAlbum Standard v2.0 on Unix and Windows systems. If you are upgrading your version of emAlbum, please see the Upgrading page.
  1. Unzip the contents of emAlbum-v*.zip to a folder on your computer.

    You should see two folders:
    - cgi-bin: Contains the emAlbum scripts and configuration files.
    - public_html: Contains your template images and album folders.


  2. Use a text editor to open your emAlbum.cfg file which is located in your cgi-bin/emAlbum folder. This is the main configuration file and will determine the features and function of emAlbum. A detailed explanation of each setting can be found in the Configuration page.

    Troubleshooting:
    - If you are having trouble determining your server path settings, download and install this script.
    - If you need help configuring your emAlbum.cfg file, visit our support forum, we'd be glad to help.

  3. FTP into your web server/host and upload your files.

    Upload the contents of the cgi-bin folder into a folder that can execute CGI scripts - usually called cgi-bin. Make sure to transfer all of these files in ASCII mode.

    Linux/Unix Servers
    - Set the permissions (chmod) on emAlbum.cgi and emAlbum_setup.cgi to 755 (rwxr-xr-x).
    - If the path to Perl is anything other than #!/usr/bin/perl, edit the first line in both emAlbum.cgi and emAlbum_setup.cgi with the correct path.

    Windows Servers
    - The permissions are usually already set on the server side, so you should not need to worry permissions.
    - Environmental variables are usually already set up for Perl, so you probably would not need to worry about changing the path to Perl, but it might be a good to edit the first line in both emAlbum.cgi and emAlbum_setup.cgi with the correct path, just in case.

    Upload the contents of the public_html folder anywhere on your web server, but not under the cgi-bin folder. Make sure to transfer all these files (images) in BINARY mode.

    Note: You can change names of the albums, images, or thumbnails folders but you cannot change the name of the emAlbum folder that goes under your cgi-bin folder.


  4. Open your web browser and enter the URL to your emAlbum_setup.cgi file. The setup file will test your settings and inform you if something is not working correctly. If all of the setup tests pass, you will see a link to view your album. Click that link and if everything was setup correctly you should see a Test album. Verify that everything works in the test album.


  5. Now you can begin uploading all of your images to your web server.

    Delete the Test folder and add as many top-level folders as you like. *emAlbum will not recognize folder's with a period (.) in the folder name* Each top-level folder can have one level of sub-folders. You can have as many sub-folders as you like, but emAlbum does not support sub-sub-folders.


  6. Your emAlbum installation is now complete. emAlbum.cgi can be executed directly, through Server Side Includes (SSI), or by using a DirectoryIndex - visit our Support Forum for more details. See the Template Guide page for information on how to customize your template.

    Thumbnails: I recommend using XnView to create your thumbnails. It is a free program that works on Linux and Windows. Read about thumbnails in the User's Guide (coming soon) for more details on how to use XnView.
Terms of Use :: Copyright Information :: Privacy Policy
© 2003-2009 emAlbum. All Rights Reserved.