Resolving Problems with SAS Environment Manager Agents
Agent Fails to Start
When you try to configure the SAS Environment Manager Agent,
it does not start and you receive the error message
No
token file found, waiting for Agent to initialize
-
Stop the SAS Environment
Manager agent.
-
Verify that the agent
wrapper processes and the agent Java processes have stopped.
-
On the W6X platform,
verify that the directory
%SystemRoot%\TEMP
exists.
Remove the file
%SystemRoot%\TEMP\agent.encrypt.lock
.
On all other UNIX platforms,
search for the java.io.tmpdir environment variable in the agent wrapper
process and the agent Java process. By default, the value of the variable
will be set to the
\tmp
or
\var\tmp
directory.
If the variable exists, remove the file
agent.encrypt.lock
under
the specified directory.
Agent Receives the Error “OutOfMemory GC Overhead Limit
Exceeded”
The agent.log file contains the message
java.lang.OutOfMemoryError:
GC overhead limit exceeded
Include these JVM options
in the startup script for each agent:
-XX:NewRatio=8
-XX:+CMSClassUnloadingEnabled
-XX:+UseTLAB
-XX:+UseCompressedOops
Modify the file
SAS-configuration_directory/LevX/Web/SASEnvironmentManager/agent-5.0.0-EE/bundles/agent-5.0.0/bin/hq-agent.sh
or
hq-agent.bat
and
add these JVM options to the CLIENT_CMD variable:
CLIENT_CMD="${HQ_JAVA} \
-D${AGENT_INSTALL_HOME_PROP}=${AGENT_INSTALL_HOME} \
-D${AGENT_BUNDLE_HOME_PROP}=${AGENT_BUNDLE_HOME} \
-XX:NewRatio=8 \
-XX:+CMSClassUnloadingEnabled \
-XX:+UseTLAB \
-XX:+UseCompressedOops \
-cp ${CLIENT_CLASSPATH} ${CLIENT_CLASS}"
EncryptionOperationNotPossibleException Error Message
After the agent successfully starts, some agent properties
might get encrypted. If the agent cannot read the agent.scu file (which
contains the encryption keys), it cannot decrypt the properties. The
agent will not start and the
agent.log
or
the
wrapper.log
file contains the error
org.jasypt.exceptions.EncryptionOperationNotPossibleException
.
-
Stop the SAS Environment
Manager agent.
-
In the directory
SAS-configuration/Lev2/Web/SASEnvironmentManager/agent-5.0.0-EE
,
delete the
/data
directory.
-
In the directory
SAS-configuration/Lev2/Web/SASEnvironmentManager/agent-5.0.0-EE/conf
,
delete the
agent.scu
file.
-
Modify the encrypted
property to a plain text value. In the file
SAS-configuration/Lev2/Web/SASEnvironmentManager/agent-5.0.0-EE/agent.properties
,
set the property agent.setup.camPword to a plain text value (if it
is encrypted, it will appear as ENC(XXXXXXXXXX)).
-
In the file
SAS-configuration/Lev2/Web/SASEnvironmentManager/agent-5.0.0-EE/auto-approve.properties
,
change all values to True.
-
Cannot Stop EAgent Service Using Windows Services
On Windows, if you use Windows Services to stop the Hyperic
Agent service, you will receive the error message
Windows
could not stop the SAS[SAS94-Lev1] SAS Environment Manager Agent on
Local Computer
. Clicking OK in the error message dialog
box seems to stop the service, but the System Event Log contains the
error
The SAS [SAS94-Lev1] SAS Environment Manager
Agent service terminated with service-specific error Incorrect function.
.
Use the command line,
rather than Windows Services, to stop the agent. The command to stop
the agent is
<sas_configuration_directory>/Lev2/Web/SASEnvironmentManager/agent-5.0.0-EE/bin/hq-agent.bat
stop
.
Copyright © SAS Institute Inc. All rights reserved.