Operations Automation updates installer is a utility for downloading and installing updates and hotfixes.
It is invoked via the command line on the management node.
Linux (5.5, 6.0 and 7.0 versions):
# /usr/local/pem/bin/pa_updates_installer COMMAND [options]
Linux (7.1 and above):
# /usr/bin/pa_updates_installer COMMAND [options]
Windows (5.5 version):
C:\> "C:\Program Files (x86)\SWsoft\PEM\bin\pa_updates_installer.exe" COMMAND [options]
Windows (6.0 version):
C:\>python.exe "C:\Program Files (x86)\SWsoft\PEM\bin\pa_updates_installer" COMMAND [options]
Note that Python version 2.7 must be used.
This command specifies the utility's working mode:
Check for product updates (default):
This will check for updates and hotfixes for the product installed on the system.
Download product updates:
# pa_updates_installer --download
This will download all updates and hotfixes available for the installed product(s). If an update already has been downloaded, the utility will check its checksum. If it does not match, the existing file will be removed and the update will be downloaded again. Otherwise, it will skip the update download.
# pa_updates_installer --precheck
This will download prechecks for available product updates and run them. Prechecks do not modify the system and are run to discover issues which could block product update installation. It is recommended to run this command several days before actually installing product updates. Note: This command is only available in versions from Operations Automation 5.5 and higher.
Install product updates:
# pa_updates_installer --install
This will install all the updates and hotfixes available for the installed product(s).
If required, the updates will be downloaded as they would be when using the "download" command. Also, this command implies running prechecks.
Important! When installing a hotfix that has a billing component, the following warning can be observed:
[WARNING] Host #2 (some.hostname.provider.com) is one of Billing hosts and have to be updated later, with launch "pa_updates_installer --update-billing"
If you face this warning, then run the command pa_updates_installer --update-billing right after pa_updates_installer --install finishes. Also note that Billing will restart when the command is run.
Install additional locales (supported starting from 7.2)
# pa_updates_installer --add-locales <LOCALE>[,<LOCALE2>]
LOCALEis the ISO country code; available locales are:
Warning: after you have installed locales, it will be impossible to remove them; maximum allowed locales in the system is 8 (including English).
/usr/bin/pa_updates_installer --add-locales de, es, fr
Additional Options The tool also has some additional options and configuration files that can be used to configure its behavior.
--version=serial number of update
This option can limit product updates which will be considered by pa_updates_installer. For example, only install Operations Automation 5.5.2 when there is already Operations Automation 5.5.3 by specifying --version=2.
Specifies the base URL of the updates repository. The default is "http://download.pa.parallels.com/."
Specifies the log file location.
The default location is:
C:\Program Files (x86)\SWsoft\PEM\var\log\pa_updates_installer\pa_updates_installer.log
Use of Privacy Proxy
pa_updates_installer requires access to the Internet to download product updates. In most cases, there is no direct access to the Internet from the Operations Automation management node. To overcome this limitation, Privacy Proxy service must be deployed in the system. The latter will be automatically discovered by pa_updates_installer.
- Known issues
Many parameters that were adjusted manually previously, such as coordinator-environment, might be overwritten in
/usr/local/pem/jboss-eap-6.2/standalone/configuration/standalone-full.xml file during updates installation.
Please make sure to create a backup of this file before installing updates.
After updates installation is completed, compare the file to the saved copy, return the required values (that have been overwritten) and restart the MN services:
For OA versions before 7.0:
service pem stop service pau restart service pem start
For OA versions since 7.0:
service pa-agent stop service pau restart service pa-agent start