Simple Installation for Windows with IIS

A step by step guide to installing ApTest Manager on a Windows machine with IIS.

  1. Download and install the latest version of Strawberry Perl 5.12 32 bit. Use the default settings for the installation.
  2. Download the zip 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. Unpack the zip file into c:\inetpub\wwwroot\atm
  4. Copy the LICENSE.dat file into c:\inetpub\wwwroot\atm\data
  5. Open a command shell, and change directory to c:\inetpub\wwwroot\atm
  6. Type the command perl INSTALL.pl
  7. Answer 'Y' when asked if you want the installer to install the missing modules for you. 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.
  8. The system will ask "How will this copy of ATM be connected to your web server?" Answer '0' for CGI mode.
  9. It will ask the name of the virtual directory. The default answer '/atm' is correct.
  10. It will ask what is the file system path to ATM. The default answer 'c:/Inetpub/wwwroot/atm' is correct.
  11. It will ask for a password for the administrator account. The default pasword is 'admin'.
  12. It will ask if you want passwords encrypted. The default answer is 'n'.

At this point, ApTest Manager is installed and ready to use. However, we still need to tell IIS how to access it. Follow these steps for IIS 7. Earlier versions of IIS have similar steps, but the security model is slightly different.

  1. Start up the IIS Administration Snap-in
  2. Look in the Default Web Site area and find the 'atm' entry. Select it.
  3. Use the 'permissions' setting and ensure the web server user has full access to the mason, data, and suites directories. The default name for this user is IUSR.
  4. Open the Handler Mappings tool. Add two mappings:
    1. a mapping for *.pl that uses c:\strawberry\perl\bin\perl.exe %s
    2. a mapping for *.mpl that uses c:\strawberry\perl\bin\perl.exe "c:\inetpub\wwwroot\atm\cgi_handler.pl"
  5. Restart your server - this will ensure that all the DLLs installed are available to IIS.
  6. Point your browser on the server to http://localhost/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.
  7. If checkSetup.pl reports that everything is fine, go to http://localhost/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!