Simple Installation for Centos

A step by step guide to installing ApTest Manager on a RedHat Enterprise Linux / Centos machine.

NOTE: Starting with RHEL / Centos 7 some packages are no longer maintained in the central repositories. You will need to add the 'epel-release' package to your system BEFORE installing the required modules below. Also note that the system version of the perl List::Util module on these machines is substantially out of date. You should replace this using a command like cpan List::Util before attempting to install ApTest Manager on these machines. Finally, AND VERY IMPORTANTLY, be certain that your umask is set to 002 or 022 so that everything you install is readable and executable by other users - in particular, the user that your web server runs as.

  1. Install the basic required modules with the commands:
    yum groupinstall "Development tools"
    yum install httpd mod_perl mod_perl-devel db4-devel openssl-devel \
    gd-devel libpng-devel libjpeg-devel freetype-devel
  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/html
  4. Create the directory atm with the command mkdir atm
  5. Copy the tgz file into /var/www/html/atm and 'cd' into that directory.
  6. Unpack the tgz file into /var/www/html/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/html/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/html/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 'apache'.
  16. It will ask the web server group. Answer 'apache'.
  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/httpd/conf
    2. vi httpd.conf
    3. Toward the bottom of the file add:
      <Directory /var/www/html/atm>
          AllowOverride All
          Order deny,allow
          Allow from all
      </Directory>
      
      PerlRequire /var/www/html/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!