Troubleshooting JEE agents

This following topics provide instruction for manually removing a JEE agent from BMC Atrium Single Sign-On. These steps only involve BMC Atrium Single Sign-On configuration. Additional steps might be required for full removal.

To remove a JEE agent from BMC Atrium Single Sign-On

1. On the BMC Atrium SSO Admin Console, click Agent Details.
2. Select the agent you want to delete.
3. Click Delete.

To remove a JEE agent from WebSphere

1. Stop IBM WebSphere Application Server (WAS).
2. Delete <installationDirectory>/AppServer/atssoAgents.
3. Delete <installationDirectory>/AppServer/.amAgentLocator.
4. Edit <WASHome> \AppServer\profiles\AppSrv01\config\cells\<cell>\nodes\<node>\servers\server1\server.xml
   1. Navigate to process:Server > processDefinitions > jvmEntries.
   2. Remove from attribute genericJvmArguments the system property declarations (for example, -Dcom.iplanet.services.debug.level=on ).
   3. A sub tag of jvmEntries, classpath, contains the classpath for the JVM. Remove the BMC Atrium Single Sign-On entries.
5. Restart WAS.

To remove a JEE agent from Tomcat

1. Stop Tomcat.
2. Delete <catalinaHome>/atssoAgents.
   The following steps may not be applicable, depending on the agent used by the web application:
3. Delete <catalinaHome>/.amAgentLocator.

4. Edit <catalinaHome>conf/server.xml/and remove the realm definition. For example:

   <Realm className>="com.sun.identity.agents.tomcat.v6.AmTomcatRealm" debug="99"/
   

5. Edit <catalinaHome>bin/setclasspath.sh (or catalinaHomebin/setclasspath.bat).
   1. Delete the inclusion of setAgentclasspath.sh (or setAgentclasspath.bat ).
   2. Delete <catalinaHome>bin/setAgentclasspath.bat.
6. Restart Tomcat.

To remove a JEE agent from JBoss or WebLogic

1. Stop the relevant application server.
2. Delete <directory>/atssoAgents.
3. Restart the relevant application server.