Pre-Upgrade Steps
-
Download the new powerconnect-java.war for Data Services
-
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
-
In a web browser go to : http://<tomcathost>:<port>/powerconnect-java/index.html
e.g. http://localhost:8080/powerconnect-java/index.html -
Login
-
Check the version number displayed matches the expected version (clear the browser cache or use incognito mode if its still showing the old version number).
-
Use Test on the output in the Administration → Health to confirm that data is being sent.