This section includes various problems you might encounter on Windows systems. The explanation of the problem is followed by possible solutions.
Symptom: Cannot install the web agent after a previous installation has been removed.
Possible Causes:
You might have an existing installation of the web agent.
You might have a previously-installed web agent and did not use the web agent’s uninstallation program to uninstall the agent.
The installation program’s productregistry file might be corrupted.
Possible Solution: To resolve the issue, manually remove the web agent as explained in the following task description.
Stop all of the web sites.
Stop the web server instance.
Remove Agent for Sun Java System Web Server 6.1.
Remove the PolicyAgent-base directory from the server.
where PolicyAgent-base represents the directory in which the web agent was originally installed.
Remove the following entries from the PATH variable:
PolicyAgent-base\bin
PolicyAgent-base\es6\bin
Restart the server.
Symptom: Unable to uninstall the agent from a Windows system using the Add/Remove Program option in the Control Panel.
Possible Causes: Java’s class path might not be set correctly on the machine.
Possible Solution: Perform the following task.
Open Command Prompt Window.
Change directories to PolicyAgent-base
Execute the following command:
java uninstall_Sun_Java_tm_System_Access_Manager_Policy_Agent
Symptom: Instances of Agent for Sun Java System Web Server 6.1 are not effective after modification of the Sun Java System Web Server 6.1 configuration using the Administration Console
Possible Causes: The changes made by the agent installation to the server configuration files are overwritten by saving the changes in Administration Console.
Possible Solution: The right procedure when using the Administration Console is to load the configuration first (from disk file to memory), then to make modifications and save the changes (from memory to disk) by clicking the Apply button.
Symptom:When a user attempts to access a resource using Internet Explorer as the browser, access is denied.
Possible Cause: Internet Explorer overrides the port number of the web agent with the Access Manager port number. In such cases, the agent log file lists the URL that is being evaluated. The port number for that URL is incorrect.
Possible Solution: You can ensure this problem does not occur by setting the following property in the web agent AMAgent.properties configuration file to true as shown:
com.sun.am.policy.agents.config.override_port = true
Symptom: The agent issues a message stating that the web server is not recognized. This problem is specific to Agent for Sun Java System Web Server 6.1.
Possible Cause: Agent for Sun Java System Web Server 6.1 searches for the file WebServer.inf to verify the web server version number, but the file does not exist.
Possible Solution: Enable Agent for Sun Java System Web Server 6.1 to recognize the Sun Java System Web Server 6.1 instance by creating a file and adding text to that file that includes the version number of the Sun Java System Web Server instance as demonstrated in the task description that follows.
Create a directory named WebServer in the following directory of the Sun Java System Web Server 6.1 instance:
WebServer-base/setup/
After you perform this step, the full path to this directory is as follows:
WebServer-base/setup/WebServer/
Create a filed named WebServer.inf in the WebServer directory.
After you perform this step, the full path to this file is as follows:
WebServer-base/setup/WebServer/WebServer.inf
Add the version information of Sun Java System Web Server 6.1 to the WebServer.inf file.
After you perform this step, the WebServer.inf file includes the following type of information:
[webcore] Version=6.1 |
Save the file.
Once you have properly created the WebServer.inf file, install Agent for Sun Java System Web Server 6.1.
Symptom: After the agent is installed, the web server fails to start.
Possible Cause: Libraries that agents depend on for Windows systems are missing. Ensuring that the libraries msvcp70.dll and msvcr70.dll are available is a pre-installation step in this guide. If the libraries were not properly added, the web server might not start.
Possible Solution: Obtain the appropriate libraries as described in Preparing to Install Agent for Sun Java System Web Server 6.1 on Windows Systems.