Sun Java System Access Manager Policy Agent 2.2 Guide for Sun Java System Web Proxy Server 4.0

Chapter 7 Uninstalling Policy Agent 2.2 for Sun Java System Web Proxy Server 4.0

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 as follows:

All Systems: Disabling a Web Agent in Policy Agent 2.2

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.

ProcedureTo Disable a Web Agent in Policy Agent 2.2

This task requires that you reset the following property:


com.sun.am.policy.agents.config.notenforced_list
  1. Reset the value of this property to the asterisk, “*,” as follows:

    com.sun.am.policy.agents.config.notenforced_list = *
  2. Restart Sun Java System Web Proxy Server 4.0.

Solaris Systems: Agent Uninstallation for Sun Java System Web Proxy Server 4.0

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:

Unconfiguring Agent for Sun Java System Web Proxy Server 4.0 on Solaris Systems

To remove a web agent that was configured using the config script, use the script unconfig. The unconfig script is located in the following directory:

PolicyAgent-base/SUNWam/agents/proxy4/bin

The following is an example run of the unconfig script.


# ./unconfig WebProxy-base/web-proxy-instance-name
Unconfiguring Proxy Server ...
done.
WebProxy-base

Represents the installation directory for Sun Java System Web Proxy Server 4.0. The following is an example of a conceivable Sun Java System Web Proxy Server 4.0 installation directory:

/opt/SUNWproxy/
web-server-instance-name

Represents the installation directory for Sun Java System Web Proxy Server 4.0. The following is an example of a conceivable Sun Java System Web Proxy Server 4.0 installation directory:

proxy-server1

Therefore, the following is an example of a full path to the proxy server instance directory:

/opt/SUNWproxy/proxy-server1

GUI Uninstallation of Agent for Sun Java System Web Proxy Server 4.0 on Solaris Systems

To uninstall the web agent, you must run the uninstallation program.

ProcedureTo Uninstall Agent for Sun Java System Web Proxy Server 4.0 on Solaris Systems Using the GUI

  1. In the Policy Agent base directory (PolicyAgent-base), enter the following command:


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

  3. Click Uninstall Now on Ready to Uninstall panel.

  4. Click Close after uninstallation is complete.

  5. Restart the Sun Java System Web Proxy Server 4.0 instance from which you just uninstalled the agent.

Command-Line Uninstallation of Agent for Sun Java System Web Proxy Server 4.0 on Solaris Systems

To uninstall an agent, you must run the uninstallation program.

ProcedureTo Uninstall Agent for Sun Java System Web Proxy Server 4.0 on Solaris Systems Using the Command Line

  1. In the Policy Agent base directory (PolicyAgent-base), enter the following command:

    # ./uninstall_agent_proxy4 -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 Sun Java System Web Proxy Server 4.0 instance from which you just uninstalled the agent.

Windows Systems: Agent Uninstallation for Sun Java System Web Proxy Server 4.0

You can uninstall a web agent on a Windows system using the graphical user interface (GUI).

GUI Uninstallation of Agent for Sun Java System Web Proxy Server 4.0 on Windows Systems

To uninstall a web agent, you must run the uninstallation program.

ProcedureTo Uninstall Agent for Sun Java System Web Proxy Server 4.0 on Windows Systems Using the GUI

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

  2. In the Control Panel, open Add/Remove Programs.

  3. In the Add/Remove Programs window, choose Sun Java(tm) System Access Manager Policy Agent.

  4. Click Change/Remove.

  5. Click Next on Welcome panel.

  6. Click Uninstall Now.

  7. Click Exit after uninstallation is complete.

  8. Restart the Sun Java System Web Proxy Server 4.0 instance from which you just uninstalled the agent.

Linux Systems: Agent Uninstallation for Sun Java System Web Proxy Server 4.0

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.

Unconfiguring Agent for Sun Java System Web Proxy Server 4.0 on Linux Systems

To remove a web agent 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/proxy4/bin

The following is an example run of the unconfig_linux script.


# ./unconfig_linux WebProxy-base/web-proxy-instance-name
Unconfiguring Proxy Server ...
done.
WebProxy-base

Represents the installation directory for Sun Java System Web Proxy Server 4.0. The following is an example of a conceivable Sun Java System Web Proxy Server 4.0 installation directory:

/opt/SUNWproxy/
web-proxy-instance-name

Represents the installation directory for Sun Java System Web Proxy Server 4.0. The following is an example of a conceivable Sun Java System Web Proxy Server 4.0 installation directory:

proxy-server1

Therefore, the following is an example of a full path to the proxy server instance directory:

/opt/SUNWproxy/proxy-server1

GUI Uninstallation of Agent for Sun Java System Web Proxy Server 4.0 on Linux Systems

To uninstall a web agent, you must run the uninstallation program.

ProcedureTo Uninstall Agent for Sun Java System Web Proxy Server 4.0 on Linux Systems Using the GUI

  1. In the Policy Agent base directory (PolicyAgent-base), enter the following command:


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

  3. Click Uninstall Now.

  4. Click Close after uninstallation is complete.

  5. Restart the Sun Java System Web Proxy Server 4.0 instance from which you just uninstalled the agent.

Command-Line Uninstallation of Agent for Sun Java System Web Proxy Server 4.0 on Linux Systems

To uninstall a web agent, you must run the uninstallation program.

ProcedureTo Uninstall Agent for Sun Java System Web Proxy Server 4.0 on Linux Systems Using the Command Line

  1. In the Policy Agent base directory (PolicyAgent-base), enter the following command:


    # ./uninstall_linux_agent_proxy4 -nodisplay

    The uninstallation program displays the following text:


    Ready to Uninstall
    
    1. Uninstall Now
    2. Start Over
    3. Exit Uninstallation
    
                   
  2. Enter 1 to remove the product.

  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 on the agent, enter 1. To exit the uninstallation program, enter 2.

  5. Restart the Sun Java System Web Proxy Server 4.0 instance from which you just uninstalled the agent.