Dynamically changes the log level for Symphony components.
Use soamlog to dynamically change the level of detail logged for messages and errors. The log-level change becomes effective immediately and remains in effect until the host is restarted or the affected process or application is closed.
Symphony component log files are written to the logs directory in SOAM_HOME on the host where the process runs.
When the client path is in the current user's path environment, application logs are written to the directory where the client executable is run. If the client executable path is not in the current user's path environment, application logs are written to the directory where the client executable resides.
Use the log4j.properties file on the host on which a Symphony component runs to customize the contents of the log files for that component. The log4j.properties file is located in the conf directory in SOAM_HOME.
In Symphony DE, all users can change any log level.
In Symphony, the cluster or consumer administrator must have permission to use this command. The cluster administrator can change the logging options for the Session Director (sd). The consumer administrator can change the log levels for the session manager (ssm), service instance manager (sim) and workload of their applications.
Specifies the name of the log4j.logger you want to change the log level of. For example:
Refer to the appropriate log4j.properties file (in $SOAM_HOME/conf on Linux, %SOAM_HOME%\conf on Windows) for the names of all related loggers. If an invalid logger name is specified, the component log levels are not changed.
Specifies one of the following log levels (listed in order of increasing detail):
Specifies the name of the user to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Specifies the name of the log4j.logger you want to change the log level of. For example:
Refer to the appropriate log4j.properties file (in$SOAM_HOME/conf on Linux, %SOAM_HOME%\conf on Windows) for the names of all related loggers. If an invalid logger name is specified, the component log levels are not changed.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
This application must be registered. Log levels of enabled applications can be changed.
Specifies one of the following log levels (listed in order of increasing detail):
Specifies the name of the user to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Specifies the name of the log4j.logger for which you want to change the log level. For example:
Refer to the appropriate log4j.properties file (in $SOAM_HOME/conf on Linux, %SOAM_HOME%\conf on Windows) for the names of all related loggers. If you specify an invalid logger name, soamlog does not change the log level for any component.
If you specify an invalid logger name, soamlog does not change the log level for any component.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Specifies one of the following log levels (listed in order of increasing detail):
Specifies the name of the user to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Specifies the name of the log4j.logger for which you want to change the log level. For example:
Refer to the appropriate log4j.properties file (in $SOAM_HOME/conf on Linux, %SOAM_HOME%\conf on Windows) for the names of all related loggers. If you specify an invalid logger name, soamlog does not change the log level for any component.
If you specify an invalid logger name, soamlog does not change the log level for any component.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Specifies one of the following log levels (listed in order of increasing detail):
Specifies the name of the user to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.