Upgrade or Install Agents Accelerator | Pricefx Knowledge Base

Prerequisites

Before proceeding, ensure that the accelerator is backed up and available in Git.

If these prerequisites are not met, do not continue. First, follow the instructions in 3. Ensure Accelerator Objects Are Backed Up or Already Stored in Git.

Remember that the Agents accelerator should never be customized.

Steps

If it is not the latest version, select the “Upgrade” package in the PlatformManager for deployment.
If the accelerator is not yet installed, select the new installation package in the PlatformManager for deployment.

The accelerators will automatically deploy the necessary library logics. There is no need to deploy these manually.

1. Deploy Agents Accelerator 1.2.2 and Add it to Git

The 1.2.0 version and later version of the Agents Accelerator was supported only with release 15.0 and higher due to the dashboard that required QueryAPI for Analytics. Since 1.2.2 the dashboard is deployed as a an individual accelerator, so you can deploy 1.2.2 even on 14.0 release.

Follow the installation instructions for the Agents Accelerator.
• Installation (Agents Accelerator)
Download the accelerator source code to component folder using the PfxComponents tool window:
1. Search for the component Agents Accelerator Source Code.
2. Click Import.
Navigate to the Fetch tool window:
1. Select the agents-accelerator component folder.
2. Click the Select all entities and their objects that exist in the selected directory ( ) button in the entity panel.
  Feature is only available within the Pricefx Studio version 15.2 or higher.
3. Deselect Internationalization entity.
4. Click Fetch.
In the same folder:
1. Make sure you fetch the following Advanced Configuration options.
  • chartContextualMenu
  • All options that contain ag.
Commit to Git branch pfxagent with a commit message such as:
PFAGENTS-123 installation of Agents Accelerator 1.2.2
Replace the ticket number and version as appropriate.

2. Deploy Agents Accelerator Dashboards 1.2.2 and Add it to Git (for 15.x and Later)

These dashboards were introduced as part of 1.2.2 release and extracted from Agents accelerator in order to not block deployments for 14.x. Once all the customers are upgraded to 15.x release, this package will be merged back to the Agents Accelerator.

Follow the installation instructions for the Agents Accelerator.
• Installation (Agents Accelerator)
Download the accelerator source code to component folder using the PfxComponents tool window:
1. Search for the component Agents Accelerator Dashboards Source Code.
2. Click Import.
Navigate to the Fetch tool window:
1. Select the agents-accelerator folder.
2. Click the Select all entities and their objects that exist in the selected directory ( ) button in the entity panel.
  Feature is only available within the Pricefx Studio version 15.2 or higher.
3. Deselect Internationalization entity.
4. Click Fetch.
Commit to git branch pfxagent with a commit message such as:
PFAGENTS-123 installation of Agents Accelerator Dashboards 1.2.2
Replace the ticket number and version as appropriate.
Assign the ticket to QA to initiate testing.

2. Deploy Agent Assessment Dashboard Component and Add it to Git (for 14.x)

If your partition on 15.0+ skip this step, since that is already part of Agents accelerator 1.2.0. If your partition is on 14.x release, use this is component from demo team. Note that this component is still under development, so it is recommended to upgrade to the latest version it regurarly.

Download the component using the PfxComponents tool window:
1. Search for the component Agent Assessment Dashboard.
2. Click Import.
Navigate to the Deploy tool window:
1. Select the folder agent-assessment-dashboard and the agents partition.
2. Click Deploy.
Commit to Git branch pfxagent with a commit message such as:
PFAGENTS-123 installation of Agent Assessment Dashboard 1.3.2
Replace the ticket number and version as appropriate.
Assign the ticket to QA to initiate testing.

Once the dashboard becomes part of the accelerator, this component folder should be removed from Git and the accelerator dashboard should be fetched to git in the agents-accelerator folder instead.

3. Download Shared Library Accelerator and add it to Git

Download the accelerator source code to component folder using the PfxComponents tool window:
1. Search for the component Shared Library Accelerator Source Code.
2. Click Import.
Navigate to the Fetch tool window:
1. Select the shared-library-accelerator folder:
2. Click the Select all entities and their objects that exist in the selected directory ( ) button in the entity panel.
  Feature is only available within the Pricefx Studio version 15.2 or higher.
3. Click Fetch.
Commit to Git branch pfxagent with a commit message such as:
PFAGENTS-123 installation of Shared Library Accelerator 1.9.0
Replace the ticket number and version as appropriate.

4. Download Dashboard Library Accelerator and Add it to Git

Download the accelerator source code to component folder using the Components marketplace in the Pricefx Studio:
1. Search the component Dashboard Library Accelerator Source Code.
2. Click Import.
Navigate to the Fetch tool window:
1. Select the dashboard-library-accelerator folder:
2. Click the Select all entities and their objects that exist in the selected directory ( ) button in the entity panel.
  Feature is only available within the Pricefx Studio version 15.2 or higher.
3. Click Fetch.
Commit to git branch pfxagent with a commit message such as
PFAGENTS-123 installation of Dashboard Library Accelerator 1.5.0
Replace the ticket number and version as appropriate.

5. Migrate Watchers (Optional)

If the Actionable Insights were previously installed, migrate the Watcher model objects to the Agent model objects by following the steps outlined in Migrate Watcher Model Objects to Agent Model Objects.