When the Web Tier Collectors have been installed, post-installation action items may be required. There might be additional action items not listed below, that are required in each installation. Upon finishing your installation, verify that all action items have been completed by checking the list generated on the Action Items screen.
Post-installation tasks for WebLogic, WebSphere, Tomcat, and Sun One (J2EE stack)
To monitor the application(s), you need to register the Precise for Web agent(s) as Web application filters. This section describes how to add Precise for Web technology to the Web application(s) Web descriptor files.
If you installed a cluster, this is the only documented post-installation action item. Verify that no additional action items are needed by checking the list Action Items screen.
- To automatically modify the
web.xmlfile(s) of the monitored application(s), you are required to login as the user that has permissions to change the application files and run a script that adds the Precise for Web agents to your application.
As an input to that script, you need to provide the location of the .EAR, .WAR orweb.xmlfile(s) of the application(s).
Note that if you change a locally deployed application, then any application redeployment may override this action item, so you will need to do it again. If you do not want to do this after every redeployment, you have 2 options: - Best practice: To add this script to your application redeployment script, so it will be done automatically.
Change the central application file (if the application is clustered and there is a central location as opposed to a local location). This way the Precise filters will stay in the application in each redeployment.
If you do so, you will need to redeploy the application instead of performing a mere JVM restart.
If you are installing Precise for Web on a cluster (WebLogic or WebSphere) the option to change the central application file is the only option.
- Examples of application locations:
- The WebLogic 10.3 console shows the .EAR file location under “deployments”. Then click on your application name to see the path.
- The WebSphere 6.1 console displays the names of .EAR files, but not their location. The typical location of and .EAR file is:
<install-dir>\profiles\[profile-name]\config\cells\[cell-name]\applications\PlantsByWebSphere.ear\PlantsByWebSphere.ear - For Tomcat 5.x & 6.x:
<tomcat-dir>\webapps\<app-name>\web-inf\web.xml - For Sun One 6.x:
<sunone-dir>\WebServer6.1\<domain-name>\webappsWeb.xmlappears inside each application.