Package Deployment Wizard

You can use the Package Deployment wizard to schedule the installation of new packages or upgrades of existing packages. Please note: the PEM server must have internet access to deploy packages for deployment.

Before invoking the Package Deployment wizard, you must modify the PEM agent configuration file (on Linux) or the registry (on Windows) and restart the agent; first on the server, and then on each system where packages will be deployed.

On a Linux system, modify the agent.cfg file (by default, located in /opt/PEM/agent/etc), setting the allow_package_management property to true.

On a Windows system, use the Registry Editor to modify the registry entry for the agent, setting the value of the AllowPackageManagement property to true:

  • On a 64-bit Windows installation, modify the entry located in HKEY_LOCAL_MACHINESOFTWAREWow6432NodeEnterpriseDBPEMagent
  • On a 32-bit Windows installation, modify the entry located in HKEY_LOCAL_MACHINESOFTWAREEnterpriseDBPEMagent

After modifying the agent configuration properties, you must restart the PEM agent. On a Linux host, use a version-specific command to restart the agent; for example:

service pemagent restart

Or on a Windows host, use the Services dialog to restart the pemAgent service:

Postgres Enterprise Manager - pemAgent

After enabling package management and restarting the agents, you should also confirm that agent-level probes are enabled on the host of the PEM server, and on any system on which a package will be deployed. To access the Manage Probes tab, highlight the name of the PEM agent in the PEM client tree control, and select Manage Probes… from the Management menu. The following probes must be enabled:

  • the Package Catalog probe on the PEM server host.
  • the Installed Packages probe on any system on which you wish to install packages.

Then, to open the Package Deployment wizard, select Package Deployment… from the Management menu. The Package Deployment wizard Welcome… dialog opens:

Package deployment welcome page

Click Next to continue.

Package deployment mode page

Use the radio buttons on the Deployment Mode Selection dialog to specify the type of deployment that you are scheduling:

  • Select the New package installation radio button to schedule the installation of a package that has not been previously installed on the server. This is the default.
  • Select the Upgrade packages radio button to schedule an upgrade of packages that are currently installed on the server.

When you’ve made a selection, click Next to continue.

Installing a New Package

If you select New package installation on the Deployment mode selection dialog, the Package Deployment wizard opens a dialog that allows you to specify the agents and servers on which the new applications will be installed.

Package deployment select servers page

Expand the Agents/Server selection tree control, and check the box next to each server on which you wish to install a new package; then, click Next. The package selection dialog opens:

Package deployment package selection page

Expand the tree control to review a list of applications that are available for installation. Check the box next to an application name to mark the application for installation. Note that the Package Deployment wizard will automatically check the boxes next to any supporting applications required by the applications you select.

Package deployment selected packages page

When you’ve selected all of the packages you wish to add, click Next to continue.

Package deployment review options page

Check the box to the left of a host or package name, and if prompted by the Package Deployment wizard provide any options requested. Please note that options displayed in bold font are required. Click Next to continue:

Package deployment download packages page

Click the Start download button to instruct the Package Deployment wizard to download application installers. During the download, you can click the Cancel download button to abort the batch download. When the download completes, click Next:

Package deployment schedule install page

Use the options on the scheduling dialog to schedule an installation time for the new packages:

  • Set the slider next to Deploy now to Yes to instruct the respective PEM agents to install the downloaded packages immediately. Please note that if a package requires a server restart, current user sessions may be interrupted.
  • Set the slider next to Deploy now to No and use the Time selector to specify a later date and time that you would like the package installation to begin.

Click Finish to install the downloaded packages or schedule the installation and exit the package deployment wizard. If you have scheduled an installation for a later date/time, the scheduled task will be displayed on the Scheduled Tasks tab. To open the Scheduled Tasks tab, select Scheduled Tasks… from the Management menu:

Package deployment scheduled tasks page

Upgrading an Installed Package

To upgrade a package, select Upgrade Packages on the Deployment mode selection window of the Package Deployment dialog:

Package deployment upgrade packages page

Click Next to continue.

Package deployment upgrade select packages page

The Package Deployment wizard displays a tree control that allows you to specify which packages will be updated. Expand the tree control, and check the box next to each package that you wish to upgrade; click Next to continue.

Package deployment upgrade review packages page

Highlight an installed package name to review or modify installation options for that package. When you’ve reviewed the list, click Next to continue.

Package deployment upgrade start download page

Click the Start Download button to instruct the Package Deployment wizard to download application installers. During the download, you can click the Cancel Download button to abort the batch download. When the download completes, click Next:

Package deployment scheduled install page

Use the options on the scheduling dialog to schedule an installation time for the new packages:

  • Set the slider next to Deploy Now to Yes to instruct the respective PEM agents to install the downloaded packages immediately. Please note that if a package requires a server restart, current user sessions may be interrupted.
  • Set the slider next to Deploy Now to No and use the Time selector to specify a later date and time that you would like the package installation to begin.

Click Finish to install the downloaded packages or schedule the installation and exit the package deployment wizard. If you have scheduled an installation for a later date/time, the scheduled task will be displayed on the Scheduled Tasks tab. To open the Scheduled Tasks tab, select Scheduled Tasks… from the Management menu.