|
| 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. |
- 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.
- Use a text editor to open your
settings.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, run the env.cgi script that came with the download.
- If you need help configuring your settings.cfg file, visit our support forum, we'd be glad to help.
- 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, emAlbum_setup.cgi, and env.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, emAlbum_setup.cgi, and env.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, emAlbum_setup.cgi, and env.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.
- 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.
- Now you can begin uploading all of your images to your web server.
You can choose to put all of your thumbnails in one
directory or organize them by matching the same directory
structure in your thumbnails directory to your albums
directory. Make sure to change settings.cfg
accordingly.
Delete the Test folder and add as many top-level folders as you like. *emAlbum will not recognize folders with a period (.) in the folder name
or folders that begin with an underscore (_)* 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.
- 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 online documentation for more details on how to use XnView.
|
|
|
|
|
|
|
|
