PowerConnect for SAP Solutions
Auto Light Dark
Auto Light Dark

PowerConnect for Business Objects Agent Upgrade

Pre-Upgrade Steps

  • Download the new powerconnect-java.war for Business Objects

  • Make a backup copy of these files:

    • <tomcat>/conf/Catalina/localhost/powerconnect-java.xml

    • the PowerConnect configuration file e.g. <tomcat>/conf/powerconnect.properties

    • the PowerConnect user store e.g. <tomcat>/conf/powerconnect-users.xml

Steps

  • Stop the Tomcat server (Note - Tomcat must be stopped before you delete the WAR file. If it's still running, it undeploys the application and can delete powerconnect-java.xml.)

  • Remove the old version.

    • In <tomcat>/webapps, delete:

      • powerconnect-java.war

      • the powerconnect-java folder

  • Copy the new powerconnect-java.war into <tomcat>/webapps.

  • Upgrading from 9.2.0 or earlier only:

    • Ensure the powerconnect-java.xml file has the following contents:

      <Context>
          <Environment name="configurationPath" value="${catalina.home}/conf/powerconnect.properties" type="java.lang.String"/>
          <Realm className="org.apache.catalina.realm.MemoryRealm" pathname="conf/powerconnect-users.xml"/>
      </Context>
      
    • Create the powerconnect-users.xml file at the location given in pathname, with a user that has the powerconnect role:
      <tomcat-users>
      <role rolename="powerconnect"/>
      <user username="powerconnect" password="choose-a-password" roles="powerconnect"/> </tomcat-users>

    • Note - This file is used by Tomcat to point to the location of the PowerConnect Agent configuration file and user store. In the above example we are storing the files in <tomcat>/conf/powerconnect.properties and <tomcat>/conf/powerconnect-users.xml but you can change this to wherever is suitable for your system as long as the Tomcat user can access this file.

  • Start the Tomcat server

  • Repeat the above steps for each Tomcat server if running a cluster

Verify