Sun Java System Access Manager Policy Agent 2.2 Guide for IBM Lotus Domino 7.0

Chapter 7 Uninstalling the IBM Lotus Domino 7.0 Agent

Disabling a Version 2.2 Web Agent

This section applies to Solaris, Linux, and AIX systems.

In certain situations, you might want to temporarily disable a web agent. To disable a web agent, reset the com.sun.am.policy.agents.config.notenforced_list property to an asterisk (*) in the agent's AMAgent.properties configuration file. This property controls the not-enforced URI list for the agent.

ProcedureTo Disable a Version 2.2 Web Agent

  1. In the web agent's AMAgent.properties configuration file, reset the com.sun.am.policy.agents.config.notenforced_list property to an asterisk (*). For example:

    com.sun.am.policy.agents.config.notenforced_list = *
  2. Restart the IBM Lotus Domino 7.0 instance.

Uninstalling the IBM Lotus Domino 7.0 Agent on UNIX and Linux Systems

This section applies to Solaris, Linux, and AIX systems.

You can uninstall a web agent on these systems using a graphical user interface (GUI) or command-line interface (CLI). However, first consider these items:

Unconfiguring the IBM Lotus Domino 7.0 Agent on UNIX and Linux Systems

To remove an instance of the IBM Lotus Domino 7.0 agent that was configured using the config script, you must run the unconfig script.

ProcedureTo Unconfigure the IBM Lotus Domino 7.0 Agent on UNIX and Linux Systems

  1. Run the unconfig script. For example, on Solaris systems:

    # cd PolicyAgent-base/SUNWam/agents/domino/bin
    # ./unconfig LotusDominoData-directory
    Unconfiguring webserver ...
    done.

    where LotusDominoData-directory represents the path to the Lotus Domino Data directory. The default path is /local/notesdata.

Removing the DSAPI Filter for the IBM Lotus Domino 7.0 Agent on UNIX and Linux Systems

Before you uninstall the IBM Lotus Domino 7.0 agent, regardless of which uninstallation method you use (GUI or command line), first remove the DSAPI filter.

ProcedureTo Remove the DSAPI Filter for the IBM Lotus Domino 7.0 on UNIX and Linux Systems

  1. In the Lotus Domino Administrator web console, select the Configuration tab.

  2. In the left pane, under Server, click All Server Documents

    A window appears, presenting a list of servers.

  3. From the listed servers, select the server you want to uninstall.

  4. Click Internet Protocols.

  5. Select the HTTP tab.

  6. Remove the DSAPI filter file name specified for the agent, leaving the DSAPI Filter File Name field blank.

  7. Click the Save and Close button to save the changes.

  8. Open the IBM Lotus Domino 7.0 Quick Console and restart the server by entering the following commands:


    tell http quit
    load http

Uninstalling the IBM Lotus Domino 7.0 Agent on UNIX and Linux Systems Using the GUI

After you have removed the DSAPI filter, you can uninstall the agent.

ProcedureTo Uninstall the IBM Lotus Domino 7.0 Agent on UNIX and Linux Systems Using the GUI

  1. In the PolicyAgent-base directory, enter the following command:


    # ./uninstall_agent
  2. Click Next on Welcome panel.

  3. Click Uninstall Now on Ready to Uninstall panel.

  4. After the uninstallation process is complete, click Close.

  5. Restart the IBM Lotus Domino 7.0 instance.

Uninstalling the IBM Lotus Domino 7.0 Agent on UNIX and Linux Systems Using the Command Line

After you have removed DSAPI Filter, you can uninstall the agent.

ProcedureTo Uninstall the IBM Lotus Domino 7.0 Agent on UNIX and Linux Systems Using the Command Line

  1. In the PolicyAgent-base directory, 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
  2. Enter 1 to uninstall the agent.

  3. 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
  4. To see log information, enter 1. To exit the uninstallation program, enter 2.

  5. When the uninstallation is complete, restart the IBM Lotus Domino 7.0 instance.

Uninstalling the IBM Lotus Domino 7.0 Agent on Windows Systems

On Windows systems, the uninstallation program has only the graphical user interface (GUI). You must have administrator privileges to run the program. First, remove the DSAPI filter and then uninstall the agent.

ProcedureTo Remove the DSAPI Filter for the IBM Lotus Domino 7.0 Agent on Windows Systems

  1. In the Lotus Domino Administrator web console, select the Configuration tab.

  2. In the left pane, under Server, click All Server Documents

    A window appears, presenting a list of servers.

  3. From the listed servers, select the server you want to uninstall.

  4. Click Internet Protocols.

  5. Select the HTTP tab.

  6. Remove the DSAPI filter file name specified for the agent, leaving the DSAPI Filter File Name field blank.

  7. Click the Save and Close button to save the changes.

  8. Open the IBM Lotus Domino 7.0 Quick Console and restart the server by entering the following commands:


    tell http quit
    load http

ProcedureTo Uninstall the IBM Lotus Domino 7.0 Agent on Windows Systems

  1. In the Start menu, choose Settings>Control Panel.

  2. In the Control Panel, double click Add/Remove Programs

  3. In the Add/Remove Programs window, choose Sun Java System Access Manager Policy Agent and click Change/Remove.

  4. In the Welcome Panel, click Next.

  5. In the Ready to Uninstall Panel, click Uninstall Now.

  6. After the uninstallation process is complete, click Exit.

  7. Restart the IBM Lotus Domino 7.0 instance.