getting started: installing ATX v2

ATX v2 installation - short version

ATX v2 installation - step 1/4 - OS detection

The very first step to installing ATX is finding out which OS is running on your server,
so you can download the correct installation package of ATX.
You can either ask the tech support of your host, or use one of the following commands

On FreeBSD systems you can find out the version by typing:

uname -a

Finding the version on FreeBSD
This example is running FreeBSD 5.5

On linux systems, you can try the following command

cat /etc/issue

cat /etc/issue
This example is running Fedora Core 4

In case the file doesn't exist or doesn't give the right info, try the following command

ls /etc/ | grep release

ls /etc/ | grep release
Usually a file will appear with a name like
redhat-release
debian-release

To read this file simply type

cat /etc/redhat-release

cat /etc/redhat/release
This example is running Fedora Core 4

If you're still unable to find out which OS is on your server contact the tech support of your host.

ATX v2 installation - step 2/4 - download ATX v2

Now that we've found out which OS you have on your server it is time to download the corresponding installation package.

Operating System Download Link ATX version
FreeBSD 4.x - 32 BIT download ATX v2.10
FreeBSD 5.x - 32 BIT download ATX v2.10
FreeBSD 6.x - 32 BIT download ATX v2.10
FreeBSD 6.x - 64 BIT download ATX v2.10
FreeBSD 7.x - 32 BIT download ATX v2.10
FreeBSD 7.x - 64 BIT download ATX v2.10

Operating System Download Link ATX version
Linux package II - 32 bit
redhat 8, redhat 9, Fedora Core 1, Fedora Core 2, CentOS 3, Debian 3
download ATX v2.10
Linux package III - 32 bit
Fedora Core 3 - 6, Debian 4
download ATX v2.10
Linux package III - 64 BIT
Fedora Core 3 - 6, Debian 4
download ATX v2.10
Linux package IV - 32 bit
CentOS 4, RedHat Enterprise Linux ES Release 4
download ATX v2.10
Linux package V - 64 BIT
CentOS 5
download ATX v2.10

step 3/4 - downloading atx system files

download the following package: http://www.arrowscripts.com/atxv2/img.zip
Extract the files for this zip package, and upload the contents to domain.com/a2/
Make sure that you upload the image files to domain.com/a2/, not domain.com/cgi-bin/a2/
It's an often made mistake

step 4/4 - running the installer

Connect to your server with your FTP client (filezilla, smartftp, flashfxp, etc),
and browse to the cgi-bin directory of your site.
This directory usually looks like domain.com/cgi-bin/ or domain.com/htdocs/cgi-bin
In this directory, create a subdirectory, call it a2, and upload atx.tar.gz file to it in binary mode!
URL wise, it looks like this: http://www.domain.com/cgi-bin/a2/atx.tar.gz

We are now ready to run the installer.
Connect to your server with your SSH client (putty, secureCRT, WinSCP, etc).

putty

When using putty, type your domain in the "Host Name (or IP address) field and click on "Open"
Your server will ask for a username and password.
Remember that while you're typing the password nothing will show on the screen.

After logging in, go to the /cgi-bin/a2 directory, where you have just uploaded the file atx.tar.gz file to.
Type ls -l to display the contents of the directory you're in
Type pwd to display the current path
Type cd dirname to go to a sub-directory named dirname
Type cd ../ to go to a parent directory

You probably need to type one of these commands

cd domain.com/cgi-bin/a2

cd cgi-bin/a2

cd htdocs/cgi-bin/a2

Now it's time to extract and install ATX, so type the following commands:

gunzip atx.tar.gz

tar -xvpf atx.tar

chmod 755 sh_install.cgi

./sh_install.cgi

1 (new installation)

chmod 0 sh_install.cgi

rm -f atx.tar


If no errors occured you can close your ssh client by typing
exit
If the installer did report any errors, write down the error and contact support

continue to "Getting Started: After installation"

Getting Started: After installation