1. Unzip the file and transfer to your server with the following directory structure:

2. Chmod csBanner.cgi to executable (chmod 755). Ask your server administrator for assistance if required.

4. Run csBanner.cgi from your webrowser.

Example: http://www.mycompany.com/cgi-script/csBanner/csBanner.cgi

When the script is run for the first time, it goes into setup mode. A setup screen will appear where you can verify and modify the setup variables. Most of the time, there will be no need to modify any of these variables except the username and password. Those control access to the control panel and you can change then to anything you desire.

When you click the save button on the installation screen, it should automatically create a file called setup.cgi which will look something like:

$cgiurl='http://www.yourdomain.com/cgi-script/csBanner';
$cgipath='/home/httpd/vhosts/cgi-script/csBanner';
$datapath='/home/httpd/vhosts/cgi-script/csBanner/data';
$bannerpath='/home/httpd/vhosts/cgi-script/csBanner/banners';
$bannerurl='http://www.yourdomain.com/cgi-script/csBanner/banners';
$username='demo';
$password='CShjQYpiFrHXU';
1;

Note: Installations on unix servers will have the password encrypted

Note: If you get an error saying permission denied when you save the configuration screen, then you need to chmod the csBanner directory, the banners subdirectory and the data subdirectory to 777.

Hint: Deleting the setup.cgi file will trigger the script to go back into setup mode. This is also how you can reset the password in case you forget it.

Installing the script in your cgi-bin directory
If you can only run scripts from your cgi-bin directory then you will need to store the banners subdirectory somewhere outside the cgi-bin directory. This is due to the fact that cgi-bin directories won't allow you to view normal files like images. The html templates stay in the cgi-bin directory because they are outputted by the script are not meant to be directly accessible from your webbrowser. The only except is the client login page, login.htm. That page can be moved anywhere as long as the form action points to the csBanner installation.

1. Unzip the file on your local harddrive.
2. Upload the csBanner directory and the data subdirectory to your cgi-bin directory.
3. CHMOD the csBanner.cgi file to 755. You should end up with a structure like:

/cgi-bin/csBanner <-- csBanner directory
/cgi-bin/csBanner/color_selector.htm
/cgi-bin/csBanner/csBanner.cgi
/cgi-bin/csBanner/libs.cgi
/cgi-bin/csBanner/login.htm
/cgi-bin/csBanner/mod.cgi
/cgi-bin/csBanner/modsc.cgi
/cgi-bin/csBanner/readme.htm
/cgi-bin/csBanner/styles.pl
/cgi-bin/csBanner/t_add_banner.htm
/cgi-bin/csBanner/t_adddb.htm
/cgi-bin/csBanner/t_banner_advanced_settings.htm
/cgi-bin/csBanner/t_cp.htm
/cgi-bin/csBanner/t_login.htm
/cgi-bin/csBanner/t_manage.htm
/cgi-bin/csBanner/t_pub_manage.htm
/cgi-bin/csBanner/t_setup.htm
/cgi-bin/csBanner/t_show_links.htm
/cgi-bin/csBanner/t_show_links_mod.htm
/cgi-bin/csBanner/t_upload.htm
/cgi-script/csBanner/data <-- directory to store the banners
/cgi-script/csBanner/data/index.htm

/cgi-script/csBanner/banners <-- directory to store the banners
/cgi-script/csBanner/banners/index.htm
/cgi-script/csBanner/banners/logo_login.gif

If you have any problems or questions with the installation, don't hesitate to email support. We also offer installation services.

Install the new version of csBanner as described above. You can either install it in a new directory or overwrite the old files. The preferred method would be to install it in a different directory like csBanner2 instead of csBanner. If you are overwriting the files, then you will also need to delete the old setup.cgi file for the new version to go into the auto-setup mode.

import.cgi (included in the zip file) with a text editor and modify the following variables:
$oldbannerpath = '....';
$oldbannerurl = '....';

These variables should point to the old csBanner directory path and old csBanner directory URL. This would be the directory that contained the 'banners' subdirectory in case you had the directories split up on your previous install. Usually, it would be the $htmlpath and $htmlurl variables from the old version. 

Upload import.cgi to the same directory where csBanner.cgi is located and chmod it to 755.it up with your webbrowser. For example,
http://www.yourdomain.com/cgi-script/csBanner/import.cgi

You will see a series of messages. If all goes well, when you log into the new version of csBanner you will see all your old groups and banners imported.

The final phase of upgrading is to go into the link wizard and replace the old display code currently on your site with the display code from the new version. The code between the old version and new version are different so you will need to redo the display code or your banners will not display on your pages.

If you experience any problems or questions, please feel free to email contact