1. Unzip files. Unzip the software files on your local computer, preserving the directory structure.
More information on Unzipping Files
2. Find Web Root. Using an FTP program, log into your server and locate your "Web Root". This is the top-level directory you can place web pages which will be displayed on your website. This is the same directory in which your website's homepage resides.
More information on FTP
More information on your Web Root
3. Find cgi-bin.
Some web servers require you to put your CGI Scripts in a special directory called "cgi-bin", while
others will let you run cgi scripts from any directory. If you are not sure how
your web server is configured you should try to locate the cgi-bin using your FTP
program. The cgi-bin directory will be named
If you can't find the cgi-bin as described then your server is probably the type
that let's you run CGI Scripts from any directory and you should be able to install
the program anywhere under your Web Root.
More information on cgi-bin directories
4. Create dir under web root. Create a new directory under your Web Root with your FTP program.
We recommend you call the directory
5. Create dir under cgi-bin. Create a directory within your CGI Directory.
We recommend also calling this directory /artman2/. If you don't have a CGI Directory, as discussed in Step 3, you won't need to create a second directory, simply use the same directory you created in Step 4.
6. Upload files. Upload the files and directories that you unzipped in step 1 into the
web server directories that you created in steps 4 and 5.
Make sure that the files are transferred in the correct mode (either "ascii" or "binary").
Note: Most FTP program have a auto-detect setting for transferring files in the correct mode.
| upload from (your PC) | upload to (web server) | upload mode |
| ||
| [web root]/artman2/css/ | ascii | |
| [web root]/artman2/images/ | binary | |
| [web root]/artman2/javascript/ | ascii | |
| [web root]/artman2/publish/ | ascii | |
| [web root]/artman2/uploads/ | binary | |
| [web root]/artman2/wysiwyg/ | ascii | |
| [cgi-bin]/artman2/data/ | ascii | |
| [cgi-bin]/artman2/modules/ | ascii | |
| [cgi-bin]/artman2/templates/ | ascii | |
| [cgi-bin]/artman2/utils/ | ascii | |
| [cgi-bin]/artman2/* | ascii | |
| * All files in this directory. | * All files in this directory. | |
Mac Users: If your FTP program has a setting for "Translate ISO characters" (e.g. Fetch), make sure it's disabled before you upload. |
||
More information on FTP upload modes (ascii or binary)
More information on Mac "Translate ISO Characters" issue
7. Set File Permissions. If you are using a Unix-based Server, you will now need to set file permissions on some of the files and directories you uploaded. Most FTP clients have the ability to change file permissions. Unix-based servers also include Linux, Solaris, BSD, etc. For windows users, appropriate permissions may already be set.
Unix File Permissions *
| Folder | chmod | Description |
| [webroot]/artman2/publish/ | 777 (writable) | the directory itself |
| [webroot]/artman2/uploads/ | 777 (writable) | the directory itself |
| [cgi-bin]/artman2/data/ | 777 (writable) | this directory and all files within it |
| [cgi-bin]/artman2/templates/ | 777 (writable) | this directory, including all files & subdirectories |
| [cgi-bin]/artman2/ | 755 (executable) | this directory and all .cgi files within it |
| [cgi-bin]/artman2/utils/ | 755 (executable) | this directory and all files within it |
| ||
*Refers to all Unix-based operating systems, such as Linux, Solaris, BSD, etc.
Windows Permissions *
| Folder | Permission | Description |
| [webroot]/artman2/publish/ | Modify | the directory itself |
| [webroot]/artman2/uploads/ | Modify | the directory itself |
| [cgi-bin]/artman2/data/ | Modify | this directory and all files within it |
| [cgi-bin]/artman2/templates/ | Modify | this directory, including all files & subdirectories |
| [cgi-bin]/artman2/ | Read and Execute | this directory and all .cgi files within it |
| [cgi-bin]/artman2/utils/ | Read and Execute | this directory and all files within it |
| ||
*Most commonly these permissions are set to IUSR_servername (where servername is the name of the server). To change these permissions, either contact your hosting provider or change them via your control panel (if available).
8. Run Program. Finally, run the admin program /artman2/admin.cgi with your Web Browser. The program will take you through the final steps of the installation. If you encounter any problems when attempting to run this program, please see the Troubleshooting section of this manual.