This chapter first presents you with a method for disabling a web agent. The task is the same for all web agents on all platforms. Then the chapter leads you through the uninstallation process on the available platforms. This chapter consists of the following sections:
Solaris Systems: Agent Uninstallation for IBM Lotus Domino 6.5.4
Windows Systems: Agent Uninstallation for IBM Lotus Domino 6.5.4
Linux Systems: Agent Uninstallation for IBM Lotus Domino 6.5.4
In certain situations, you might want to disable a web agent temporarily. You can disable any web agent by resetting the property that controls the not-enforced URI list in the web agent AMAgent.properties configuration file.
This task requires that you reset the following property:
com.sun.am.policy.agents.config.notenforced_list |
Reset the value of this property to the asterisk, “*,” as follows:
com.sun.am.policy.agents.config.notenforced_list = *
Restart IBM Lotus Domino 6.5.4.
You can uninstall a web agent on a Solaris system using a graphical user interface (GUI) or using the command line. However, keep the following in mind:
Be sure to use the unconfig script to uninstall any web agent that was installed using the config script. The uninstallation program must be executed only after unconfiguring all the existing web agents using the command-line unconfig script.
If you want to uninstall the deployment container, make sure that you uninstall the web agent before you uninstall the deployment container.
To remove an instance of Agent for IBM Lotus Domino 6.5.4 that was configured using the config script, use the script unconfig. The unconfig script is located in the following directory:
PolicyAgent-base/SUNWam/agents/domino/bin
The following is an example run of the unconfig script.
# ./unconfig LotusDominoData-directory Unconfiguring webserver ... done. |
where LotusDominoData-directory represents the path to the Lotus Domino Data directory. The following is the default location of the Lotus Domino Data directory:
/local/notesdata
Before you uninstall this web agent, regardless of which uninstallation method you use (GUI or command line), first remove the DSAPI filter. Then remove the agent.
In the Lotus Domino Administrator web console, select the Configuration tab.
In the left pane, under Server, click All Server Documents
A window appears, presenting a list of servers.
From the listed servers, select the server you want to uninstall.
Click Internet Protocols.
Select the HTTP tab.
Remove the DSAPI filter file name specified for the agent, leaving the DSAPI Filter File Name field blank.
Click the Save and Close button to save the changes.
Open the IBM Lotus Domino 6.5.4 Quick Console and restart the server by entering the following commands:
tell http quit load http |
After you have removed DSAPI Filter, you can uninstall the agent. To uninstall this web agent using the GUI, you must use the uninstallation program as explained in the following task description.
In the Policy Agent base directory (PolicyAgent-base), enter the following command:
# ./uninstall_agent |
Click Next on Welcome panel.
Click Uninstall Now on Ready to Uninstall panel.
After the uninstallation process is complete, click Close.
Restart the IBM Lotus Domino 6.5.4 instance from which you just uninstalled the agent.
After you have removed DSAPI Filter, you can uninstall the agent. To uninstall this web agent using the command line, you must run the uninstallation program as explained in the following task description.
In the Policy Agent base directory (PolicyAgent-base), enter the following command:
# ./uninstall_agent -nodisplay
The uninstallation program detects the agent that was previously installed using the setup program and displays the following text:
Ready to Uninstall 1. Uninstall Now 2. Start Over 3. Exit Uninstallation |
Enter 1 to uninstall the agent.
When prompted, What next? enter 1 to begin uninstallation.
The uninstallation program displays the following text:
Product Result More Information 1. Sun Java(tm) System Access Manager Policy Agent Full Available 2. Done |
To see log information, enter 1. To exit the uninstallation program, enter 2.
When the uninstallation is complete, restart the IBM Lotus Domino 6.5.4 instance from which you just uninstalled the agent.
You can uninstall a web agent on a Windows system using the graphical user interface (GUI).
To uninstall this web agent, you must first remove the DSAPI filter. Then remove the agent. These two procedures are explained separately in the following task descriptions.
In the Lotus Domino Administrator web console, select the Configuration tab.
In the left pane, under Server, click All Server Documents
A window appears, presenting a list of servers.
From the listed servers, select the server you want to uninstall.
Click Internet Protocols.
Select the HTTP tab.
Remove the DSAPI filter file name specified for the agent, leaving the DSAPI Filter File Name field blank.
Click the Save and Close button to save the changes.
Open the IBM Lotus Domino 6.5.4 Quick Console and restart the server by entering the following commands:
tell http quit load http |
In the Start menu, choose Settings>Control Panel.
In the Control Panel, double click Add/Remove Programs
In the Add/Remove Programs window, choose Sun Java System Access Manager Policy Agent and click Change/Remove.
In the Welcome Panel, click Next.
In the Ready to Uninstall Panel, click Uninstall Now.
After the uninstallation process is complete, click Exit.
You can uninstall a web agent on a Linux system using a graphical user interface (GUI) or using the command line. If you used the config_linux script to install the agent, use the unconfig_linux script to uninstall the agent.
To remove an instance of Agent for IBM Lotus Domino 6.5.4 that was installed in the command line using the config_linux script, use the script unconfig_linux. The unconfig_linux script is located in the following directory:
PolicyAgent-base/agents/domino6/bin
The following is an example run of the unconfig_linux script.
# ./unconfig_linux LotusDominoData-directory Unconfiguring webserver ... done. |
where LotusDominoData-directory represents the path to the Lotus Domino Data directory. The following is the default location of the Lotus Domino Data directory:
/local/notesdata
Before you uninstall this web agent, regardless of which uninstallation method you use (GUI or command line), first remove the DSAPI filter. Then remove the agent.
In the Lotus Domino Administrator web console, select the Configuration tab.
In the left pane, under Server, click All Server Documents
A window appears, presenting a list of servers.
From the listed servers, select the server you want to uninstall.
Click Internet Protocols.
Select the HTTP tab.
Remove the DSAPI filter file name specified for the agent, leaving the DSAPI Filter File Name field blank.
Click the Save and Close button to save the changes.
Open the IBM Lotus Domino 6.5.4 Quick Console and restart the server by entering the following commands:
tell http quit load http |
After you have removed DSAPI Filter, you can uninstall the agent. To uninstall this web agent using the GUI you must use the uninstallation program as explained in the following task description.
In the Policy Agent base directory (PolicyAgent-base), enter the following command:
# ./uninstall_linux_agent_domino6 |
Click Next on Welcome panel.
Click Uninstall Now.
Click Close after uninstallation is complete.
Restart the IBM Lotus Domino 6.5.4 instance from which you just uninstalled the agent.
After you have removed DSAPI Filter, you can uninstall the agent. To uninstall this web agent using the command line, you must run the uninstallation program as explained in the following task description.
In the Policy Agent base directory (PolicyAgent-base), enter the following command:
# ./uninstall_linux_agent_domino6 -nodisplay |
The uninstallation program displays the following text:
Ready to Uninstall 1. Uninstall Now 2. Start Over 3. Exit Uninstallation |
Enter 1 to remove the product.
When prompted, What next? enter 1 to begin uninstallation.
The uninstallation program displays the following text:
Product Result More Information 1. Sun Java(tm) System Access Manager Policy Agent Full Available 2. Done |
To see log information on the agent, enter 1. To exit the uninstallation program, enter 2.
Restart the IBM Lotus Domino 6.5.4 instance from which you just uninstalled the agent.