Simple Installation for Ubuntu

A step by step guide to installing ApTest Manager on a Ubuntu or similar Linux machine.

  1. Install the basic required modules with the command
    apt-get install build-essential apache2 libapache2-mod-perl2 \
    libberkeleydb-perl libssl-dev libnet-ssleay-perl libgd2-xpm libgd2-xpm-dev
  2. Download the tgz file for the latest version of ApTest Manager and your ApTest Manager LICENSE file. You will need your ApTest Manager licensee username and password to do this.
  3. Open a shell window as the user 'root' and change directory to /var/www
  4. Create the directory atm with the command mkdir atm
  5. Copy the tgz file into /var/www/atm and 'cd' into that directory.
  6. Unpack the tgz file into /var/www/atm with the command tar zxf atmSE_VERSION.tgz where VERSION is the version of ApTest Manager that you downloaded.
  7. Copy the LICENSE.dat file into /var/www/atm/data
  8. Type the command perl INSTALL.pl
  9. Answer 'Y' when asked if you want the installer to install the missing modules for you. Also answer 'Y' when asked if you want them installed locally. The INSTALL.pl script will then download whatever components are not already on your system and install them. There may be some questions asked during this process. The default answer is always correct.
  10. The system will ask "How will this copy of ATM be connected to your web server?" Answer '3' for mod_perl 2 mode.
  11. It will ask the name of the virtual directory. The default answer '/atm' is correct.
  12. It will ask what is the file system path to ATM. The default answer '/var/www/atm' is correct.
  13. It will ask for a password for the administrator account. The default pasword is 'admin'. You should change this to something unique and memorable.
  14. It will ask if you want passwords encrypted. The default answer is 'n'.
  15. It will ask the web server username. Answer 'www-data'.
  16. It will ask the web server group. Answer 'www-data'.
  17. It will ask about a network proxy server. If your server requires a proxy server to access the internet specify that address. If not, leave it blank.
  18. At this point, ApTest Manager is installed and ready to use. However, we still need to tell Apache how to access it. Follow these steps:
    1. cd to /etc/apache2
    2. vi apache2.conf
    3. Toward the bottom of the file add:
      <Directory /var/www/atm>
          AllowOverride All
          Order deny,allow
          Allow from all
      </Directory>
      
      PerlRequire /var/www/atm/ATMHandler.pm
      
    4. Restart Apache to enable ApTest Manager
  19. Point your browser to http://atmServer/atm/checkSetup.pl - this will examine your server and ensure that everything is set up correctly. If you have followed the instructions about, it should be perfect. If there are any warnings, you will need to resolve them before continuing.
  20. If checkSetup.pl reports that everything is fine, go to http://atmServer/atm and log in as admin using the password you specified above. Once logged in you can create regular user accounts. Don't forget to go into the "Manage System Configuration" page and open the system to non-administrative users. It is the first option on that page.

If you have any questions, don't hesitate to contact support or ask your question in the forums at http://www.aptest.com/forum. Good luck!