Upgrading ApTest Manager

Preparing for the upgrade
Performing the upgrade
Post-upgrade operations
Completing your upgrade

Note: before starting any upgrade, please ensure your data is backed up. You should also set ApTest Manager to be closed to non-administrative users (through the ApTest Manager Configuration screen) so that there are no changes to the data during the upgrade.

1 Preparing for the upgrade

To perform the upgrade, all you need do is unpack an ApTest Manager archive (zip or tar file) on top of your existing installation. For example, if ApTest Manager is installed on your machine in the directory /home/httpd/html/atm, you could do this:

[root@example /]# cd /tmp 
[root@example /tmp]# unzip atmSE_2.15.zip

    lots of output...

[root@example tmp]# cd atmSE_2.15 
[root@example atmSE_2.15]# cp -r . /home/httpd/html/atm

This will copy all of the files for this release on top of your existing ApTest Manager tree. Overwriting the existing files will not modify your configuration unless you have customized any ApTest Manager components.

2 Performing the upgrade

In order to complete the installation, you will need to run the INSTALL.pl script. It will ask if you want to upgrade.

Note: you must run INSTALL.pl as the super-user.

    [root@example atm]# perl INSTALL.pl

   lots of output, including:

You appear to be upgrading an alread installed copy of ApTest Manager.

Proceed with the upgrade? [n]

Note: The upgrade process will examine your user data, test suites, sets, and sessions and may update their internal data structures. While this is a safe process, there is always a very slim chance of corrupting data when it is manipulated. Please, please, please ensure you have a backup of your "data" and "suites" directories before executing the INSTALL.pl script.

Note: If you're running Apache with mod_perl, you will need to restart Apache after upgrading.

3 Post-upgrade operations

3.1 Encrypting passwords

Starting with version 2.13, it is possible for ApTest Manager to store user passwords in clear text or encrypted form. Prior versions always stored passwords in clear text. If you would like to convert your system to use encrypted passwords, you will need to run a conversion utility and update your configuration file:

[root@example atm]# bin/encryptPasswords.pl

Answer the questions and follow the instructions presented to complete the conversion.

3.2 Checking your configuration

Using your web browser, navigate to the special checkSetup.pl script in the ApTest Manager directory (e.g. http://www.example.com/atm/checkSetup.pl). This script will examine your installation and ensure everything is OK. If there are any errors, they need to be fixed before you can use ApTest Manager. If the script refuses to run, this indicates that your web server is misconfigured. Ensure that the web server can run .pl scripts as CGI scripts.

3.3 Converting "formatted" fields to "wysiwyg"

Starting with release 2.13, a new "wysiwyg" style is available for textarea fields. If you have existing textarea fields of style "formatted" that you would like to change to "wysiwyg", use the convertFormatted utility in the bin directory:

[root@example atm]# perl bin/convertFormatted suite fieldName1 [fieldName2...]

The script will ask that you confirm the change, and the proceed with the conversion. See the utility's built in documentation for more options and details.

4 Completing your upgrade

Once the upgrade process is complete, you will need to log back in to ApTest Manager. Please log in as user "admin" to ensure that the system is fully functional and to initialize various system settings. Then, re-open the system to non-administrative users.