Installing the AgoraCart
In this section we will explain first of all where to get the most recent files, download them to your hard drive and get them ready for uploading and installing in the simplest way.

Downloading the files
The ONLY place to download the legitimate and official release of the latest version of Agora is from http://www.agoracart.com/agoracgi.tgz as this is guaranteed to be virus free and is provided by the authors themselves. Downloading the Agora program from any other online source may cause problems, so be warned!!

Extracting the files on your hard drive
Once you've downloaded the agoracgi.tgz file to your hard drive, you will need to extract the main file from the compressed file. There are other ways to decompress the files by doing so online, but many (poor) web hosts do not supply the software on their systems so this is pretty much a failsafe way of doing so. To extract the files you'll need some decompression software like WinRar, so if you don't have it already........ get it now and install it!!

Once you have the WinRar software installed, double click on the agoracgi.tgz file on your hard drive and click EXTRACT to save the agoracgi.tar file to your hard drive. You'll notice that the agoracgi.tar file is much larger than the agoracgi.tgz file but this is normal as the agoracgi.tar file is a bundle containing all relevant files but the agoracgi.tgz file is actually a compressed version to make it download quicker.

Keep BOTH versions on your hard drive, the .tgz file and the .tar file as you never know when you'll need a backup!

Uploading the files
Now that you've extracted the main agoracgi.tgz to your hard drive, you're left with the agoracgi.tar file. Connect to your webspace in the normal way using your FTP software. Make sure that you set it to perform a BINARY transfer as you're sending up an archive. Upload the agoracgi.tar file into your CGI directory (on most web hosts this will be named cgi-bin but many hosts allow you to upload anywhere, so if in doubt look for the cgi-bin directory and upload the file to there!)

Now, change your transfer mode to ASCII and upload the install.cgi file which is available from http://groups.yahoo.com/group/agora2/files (and may also have been bundled with your Agora download in some cases) into the same location as you uploaded the agoracgi.tar file.

Installing by WEB
Once you have uploaded the install.cgi file, change the permissions of this file to 755 and open a web browser window. Now, all you have to do to install the store is to activate the install.cgi script on your server by visiting http://www.yourdomain.com/cgi-bin/install.cgi (assuming you installed the scripts in your cgi-bin directory).

Installing by TELNET
If you would rather have more control over your installation (and if your host allows!!) then you may wish to use your TELNET software to access your webspace and install the script by command line. To do this, CD into your cgi-bin (or wherever you uploaded the files to) and type the following command :

tar -xvpf agoracgi.tar 2>&1

This will extract the files for you and set all the permissions correctly.

Installation problems?
Some web hosts are such that these installations never go as they should! One quick remedy in most cases is to actually create a directory within your cgi-bin called "store", then move your agoracgi.tar and install.cgi files into this folder, then attempt the WEB installation again, this time using http://www.yourdomain.com/cgi-bin/store/install.cgi as your address. If you're experiencing problems after attempting this, I would suggest contacting your host and asking their advice.

Your first steps....
Now that you've actually INSTALLED the Agora cart, it's time to start making the changes. The first thing you should do now is to use your FTP software (in ASCII transfer mode!!!!) to access your "store" folder on your webspace, go into the "protected" folder and edit the manager.cgi file to change the default login and password. If you DON'T change these at this stage, then any Agora user will be able to get into your Store Manager if they know your URL. Right near the top of the manager.cgi file you'll see the following lines of coding....

$username="manager";
$password="admin";

Make your changes here, ensuring NOT to remove the inverted commas around the login and pass that you provide. Once you have made the changes (which WILL be case sensitive!!), save your file and re-upload it to the space. Your login and pass details are now changed.

Now read more about the Store Manager setup here....