Upgrade a Spectrum Cloud Integration

To upgrade an existing Spectrum Cloud integration, perform the following tasks:

A. Upgrade the Loftware Spectrum OIC Adapter

B. Upgrade the Spectrum Cloud Integration Agent

A. Upgrade the Loftware Spectrum OIC Adapter

1. Contact Loftware for the most recent version of the cloudIntegration.zip package.
2. Unzip the cloudIntegration.zip package and use the oicAdapter.jar file.
3. Remove the old adapter file oicAdapter.jar from <OIC Connectivity Agent location>/agenthome/thirdparty/adapters.
4. Copy the adapter jar file to the following location for your environment:
   • Windows Server: <OIC Connectivity Agent location>\agenthome\thirdparty\adapters
   • Linux: <OIC Connectivity Agent location>/agenthome/thirdparty/adapters
5. Stop the Connectivity Agent.
6. Wait 1 minute, then restart the Connectivity Agent. You may need to log out of your OIC instance and log back in.

B. Upgrade the Spectrum Cloud Integration Agent

1. Stop any Spectrum Cloud integrations that are connected to the Spectrum Cloud Integration Agent.
2. Use the cloud-integration.war file from the cloudintegration.zip package.
3. Stop the Tomcat instance.
4. If you have made changes to logging configuration in <TOMCAT HOME>/webapps/cloud-integration/WEB-INF/classes/log4j2.xml, save a copy of that file to another directory outside of Tomcat.
5. Delete the cloud-integration directory under <TOMCAT HOME>/webapps.
6. Delete the existing cloud-integration.war file from <TOMCAT HOME>/webapps.
7. Copy the cloud-integration.war file from the new release to <TOMCAT HOME>/webapps.
8. Restart Tomcat.
9. If you saved a log4j2.xml file, do the following:
   1. Navigate to <TOMCAT HOME>/webapps/cloud-integration/WEB-INF/classes/.
   2. Rename the existing log4j2.xml file in order to retain the file.
   3. Copy the new log4j2.xml file into the directory.
10. Restart Tomcat again for the logging changes to take effect.
11. Restart the Spectrum Cloud integrations that connect to this agent.