ACR 15.1 Upgrade procedures

Patch Installation Procedure

This version now uses the ACR Patch Tool utility, which can be used with ACR 15.1 and ACR 15.1FP1. In 15.1 and 15.1FP1 the utility must be manually installed on each recorder server. (In future releases it will be installed automatically.)

Patch Tool Utility

1. On Linux make sure you are logged on the recorder as the witness user
2. Locate the ACR install folder (on Linux it is /opt/witness and Windows installationFolder\Avaya\ContactRecorder
3. Create a new folder called patches alongside logs, keystore, properties
4. Copy the patchtool.jar file into the newly created patches folder.
5. The patch tool will create a rollback patch, apply the new patch files and delete the work folder.

Normally any patch can be applied as long as it is higher that the currently installed patch. However, occasionally a patch may need a specific earlier patch to be installed first. If this is the case, the patch tool will warn you, and you will have to obtain and install the earlier patch first.

Linux Systems

1. Copy the patch (.apa) file to the recorder via sftp using the witness user. /tmp is the best location for the patch file
2. Log onto the recorder as the witness user
3. Stop the recorder

su - -c "service cscm stop"

4. Change directory to the patches folder

cd /opt/witness/patches

5. Check the current patch

../java/latest/jre/bin/java -cp patchtool.jar Patcher

6. Apply the new patch(es)

../java/latest/jre/bin/java -cp patchtool.jar Patcher /tmp/acr-15.1fp1-patchNumber.apa

7. Perform any property file changes indicated in the fixed issues table. Under Linux, the property file is /opt/witness/properties/acr.properties
8. Restart the recorder

su - -c "service cscm start"

Windows Systems

1. Copy the patch (.apa) file to a temporary folder on the recorder
2. Stop the recorder service
3. Start a Command Prompt window
4. Change directory to the patches folder

cd installationFolder\Avaya\ContactRecorder\patches

5. Check the current patch

(with current directory set to \patches folder, run command exactly as follows)

..\jre\bin\java -cp patchtool.jar PatcherGui

6. Apply the new patch(es) using the File/Open menu option
7. Perform any property file changes indicated in the fixed issues table. Under Windows, the property file is installationFolder\Avaya\ContactRecorder\properties\acr.properties
8. Restart the recorder

After the patch has been applied to the recorder ensure that the recorder has started. Log on to the recorder's admin page and confirm the patch number displayed on the license page matches the patch applied. Perform a test call to a targeted station and confirm that this call is recorded by replaying the recording.

Patch Rollback

If you currently have patch 0044 installed and you install patch 0055, the patch tool will create a 'rollback' patch that allows you to roll back from 0055 to 0044. The rollback patch will be created in the rollback subfolder of the patches folder and will include 0055to0044 in the name. Apply a rollback patch the same way as a normal patch. The patcher utility checks that the rollback is appropriate (e.g. the 0055to0044 rollback can only be applied if the current version is 0055). After you apply a rollback patch you can delete the rollback patch archive file from the patches/rollback folder. Not all patches can be rolled back. Once a patch is rolled back a new patch can be applied before starting the recorder.

Development Patches

You may occasionally have to install a development patch - typically to help to diagnose a problem. Development patches always end in a letter e.g. 0055a. When you apply a development patch it creates a rollback patch as above. What is different is that, having applied a development patch, you will not be able to apply any other patches until you rollback the development patch.