Jump to: navigation, search

Deployment Wizard

The Automated Deployment Wizard deploys an installation package (IP) or solution definition to the specified hosts and installs and configures the service as directed by the Service Package Definition.

Before You Begin

While you are using the Automated Deployment Wizard, take note of the following:

  • Most of the fields in the Wizard are auto-complete fields. You can enter only part of the value in the field, and then you are presented with a list of all entries that contain the text that you entered; you can then select the appropriate item.
  • The Wizard verifies the IPs, based on the operating system of the intended hosts. When you are selecting hosts, make sure that you select those that are running the required operating system.
  • If an IP is already installed on a host, by default the Wizard will reinstall the IP. All parameters entered during the previous deployment are saved by Genesys Administrator Extension and automatically prepopulated in the Wizard.
  • When upgrading an existing IP, the IP's permissions and connections are updated to the new Application object.

Items That Can Be Merged

For scenarios in which the existing IP and the new IP have conflicting values, the existing IP's values are maintained. If the existing IP does not contain a value, the value of the new IP is used. The following values are available to be merged:

  • options
  • annex
  • connections
  • ports
  • timeout
  • autorestart
  • commandlinearguments
  • commandline
  • state
  • shutdowntimeout
  • attempts
  • redundancytype
  • isprimary
  • startuptimeout

Plug-ins are installed using the same procedures as IPs, but take note of the following:

  • The plug-in install profile automatically fetches GAX Application objects for selected Host objects.
  • Plug-in options are merged into the affected GAX Application objects.
  • Some input fields do not appear, such as those relating to Application Object, App Port, and Tenant Object.

Procedures

The following are possible scenarios that you may perform by using the Automated Deployment Wizard:

Installing an Installation Package

To install an installation package (IP), perform the following actions:

  1. In the Installation Packages panel, select the IP to use for the install.
  2. A new panel with additional information about the IP appears to the right. Click the Related button, then select Install.
  3. The Automated Deployment Wizard panel displays to the right. Click the Next button.
  4. The panel updates to show the Host set selection list. Select the host to receive the IP. Click the Next button.
  5. The panel updates to show the Application Parameters list. In theGAX Application object for host field, select the Genesys Administrator Extension Application object.
  6. Click the Next button.
  7. The panel updates to display the Installation Parameters (silent.ini) list. You can set the target installation path in the field.
  8. Click the Next button.
  9. The panel updates to display the Deployment report. Review the settings, and perform one of the following actions:
    • Click the Finish button to install the IP.
    • Click the Previous button to return to a previous panel and modify settings.
  10. The panel updates to display a progress bar of the deployment. This information also displays in the Deployed IPs panel.
Important
If a deployment fails, you can review a log of the deployment by selecting the IP from the Deployed IPs panel. A new panel displays with additional information about the IP. Click the Deployment Action Log.

Upgrading an Installation Package

To upgrade an installation package (IP), perform the following actions:

  1. In the Deployed IPs panel, select the IP to use for the upgrade.
  2. A new panel with additional information about the IP appears to the right. Click the Deploy Profile:upgrade to (version number) button.
  3. The Automated Deployment Wizard panel displays to the right. Click the Next button.
  4. The panel updates to show the Host set selection list. Select the host to receive the IP. By default, the host that received the previous version of the IP is already selected. Click the Next button.
  5. The panel updates to show the Application Parameters list. Values from the previous version of the IP deployment may be displayed in the following fields:
    • Existing Application Object—This field is automatically generated by Genesys Administrator Extension for each host to which an IP is targeted. This is the Application object in Configuration Server for which Genesys Administrator Extension will update connections.
    • Tenant Object—This is the Tenant that is set on an IP Application object. Click the Browse button to select a Tenant from a list.
    • App port—Specify a port number for the Application object to use.
    • Primary Configuration Server—Click the Browse button to select the Primary Configuration Server to use. This field defaults to a Genesys Administrator Extension Application object.
    • Backup Configuration Server—Click the Browse button to select the Backup Configuration Server to use. This field defaults to a Genesys Administrator Extension Application object.
    • Skip IP Re-install—Choose one of the following options:
      • True—Reinstall the IP only if the Application object does not exist in Configuration Server.
      • False—Always reinstall the IP.
  6. Click the Next button.
  7. The panel updates to display the Silent.ini Parameters list. These values are prepopulated from the previous version of the IP, but the settings can be modified, if necessary.
  8. The panel updates to display the Deployment Summary report. Review the settings, and perform one of the following actions:
    • Click the Finish button to upgrade the IP.
    • Click the Previous button to return to a previous panel and modify settings.
  9. The panel updates to display a progress bar of the upgrade deployment. This information also displays in the Deployed IPs panel.
Important
If a deployment fails, you can review a log of the deployment by selecting the IP from the Deployed IPs panel. A new panel displays with additional information about the IP. Click the Deployment Action Log.

Rolling Back an Installation Package

To roll back an IP, perform the following actions:

  1. In the Deployed IPs panel, select the IP to roll back.
  2. A new panel with additional information about the IP appears to the right. Click the Deploy Profile:rollback to (version number) button.
  3. The Automated Deployment Wizard panel displays to the right. Click the Next button.
  4. The panel updates to show the Host set selection list. Select the host to receive the IP. By default, the host that previously received the IP is already selected. Click the Next button.
  5. The panel updates to show the Application Parameters list. Values from the previous IP deployment may be displayed in the following fields:
    • Existing Application Object—This field is automatically generated by Genesys Administrator Extension for each host to which an IP is targeted. This is the Application object in Configuration Server for which Genesys Administrator Extension will update connections.
    • Tenant Object—The Tenant that is set on an IP Application object. Click the Browse button to select a Tenant from a list.
    • App port—Specify a port number for the Application object to use.
    • Primary Configuration Server—Click the Browse button to select the Primary Configuration Server to use. This field defaults to a Genesys Administrator Extension Application object.
    • Backup Configuration Server—Click the Browse button to select the Backup Configuration Server to use. This field defaults to a Genesys Administrator Extension Application object.
    • Skip IP Re-install—Choose one of the following options:
      • True—Reinstall the IP only if the Application object does not exist in Configuration Server.
      • False—Always reinstall the IP.
  6. Click the Next button.
  7. The panel updates to display the Silent.ini Parameters list. These values are prepopulated from the previous deployment of the IP, but the settings can be modified, if necessary.
  8. The panel updates to display the Deployment Summary report. Review the settings, and perform one of the following actions:
    • Click the Finish button to upgrade the IP.
    • Click the Previous button to return to a previous panel and modify settings.
  9. The panel updates to display a progress bar of the deployment. This information also displays in the Deployed IPs panel.
Important
If a deployment fails, you can review a log of the deployment by selecting the IP from the Deployed IPs panel. A new panel displays with additional information about the IP. Click the Deployment Action Log.
This page was last edited on July 17, 2020, at 16:00.
Comments or questions about this documentation? Contact us for support!