Administer Agents › How to automatically Upgrade Agents through CA Process Automation Content › Run the Pre-Upgrade Content

Run the Pre-Upgrade Content

The pre-upgrade content enables you to obtain the details of the agents in the existing environment. The steps that are involved in obtaining the details for agents are as follows:

1. Obtain the details of the active agents
2. View the output of content execution

Obtain the Details of the Agents

To obtain the details of the agents in the existing environment, run the pre-upgrade content. The pre-upgrade content uses the details of the agents to upgrade the agents to the current release.

Important! Run the content before you upgrade the domain orchestrator to a new version.

Follow these steps:

1. Start the SRF Get Agents details from the Pre-Upgrade Process Watch.
2. Enter the SOAP URL in the SOAP_URL field and click Finish.

   The content starts obtaining details of the agents in your environment and is run for both windows and non-windows agents.

3. Monitor the Get Agents Details process using the Pre-Upgrade Process Watch until the process instance changes to the Waiting state.

   Based on the number of agents in your environment, the ‘Results for Get Agents Details’ task can take more time to populate.

4. Navigate to the Group Tasks tab of the Tasks pane to view the ‘Results for Get Agents Details’ task.
5. Right-click the 'Results for Get Agents Details' task and select Reply to view the results.

   If there are no inactive agents, a success message displays in the task. However, agents can fail due to many reasons and a list of inactive agents is displayed for the same.

   You can decide to resolve the problems with the inactive agents and rerun the SRF Get Agents Details as follows:

   1. Start the inactive agents in the InactiveAgentsList dataset.

      Note: For more information, see Start the Agent in the CA Process Automation Installation Guide.

   2. Follow steps 2 through 5.
   3. Verify the output.

      The content updates the details of the agents in the Agent Details and Inactive AgentList datasets. Information regarding the inactive agents that are activated is appended to the Agent Details dataset and the Totalnumberofactiveagents field is increased.

      Similarly, the information regarding the inactive agents that are activated is removed from the InactiveAgentList dataset. You can run the content until the Totalnumberofinactiveagents field changes to zero.

6. Click Finish.

   The content is run successfully and the status of the 'Results for Get Agents Details' task changes to Completed. Also, the state of the Get Agents Details instance changes to Completed.

   Notes:

   • You can reset the details in the datasets and can rerun the SRF Get Agents details to obtain a new set of details for the agents. All the details in the datasets that are related to the pre-upgrade content in the Core Content and Output folder are cleared. To repopulate the details in the datasets, follow these steps:
     1. Manually delete the details from all the datasets that are related to the pre-upgrade content in the Core Content and Output folder
     2. Change the Totalnumberofinactiveagents field to 0.
     3. Rerun the SRF Get Agents details to populate the details in the datasets.
   • During the pre-upgrade content execution, the operators can cause an Echo Off error.

     Symptom:

     During operator execution in CA Process Automation, when the operator is unable to find the c2oHome location of the agent or the orchestrator, the Echo Off error displays in the Operator Runtime dataset.

     Solution:

     To mitigate the issue, follow these steps:

   1. Select My Computer > System Properties > Advanced > Environment Variables.
   2. Add the c2oHome variable.
      • For the CA Process Automation agent, provide the location where the agent is installed.
      • For the domain orchestrator, provide the location for c2oHome. For example, C:\Program Files\CA\PAM\server\c2o.