Users Guide

Troubleshooting Your Application | Troubleshooting
OMNM 6.5.3 User Guide 713
Logs
You can execute the getlogs script to package relevant logs if you need technical support. Run
this script in a command shell where you have sourced the Oware environment (in Windows
Start
> Run
cmd, then run oware , or in Linux . /etc/.dsienv , and then invoke the getlogs
script). This script creates a
logs.jar file in the root installation directory, and moves any
existing copy of
logs.jar to oware\temp . This jar compresses all logs necessary for
troubleshooting. Read the jar yourself, or forward this file to technical support to help troubleshoot
problems.
NOTE:
Server logs are in oware\jboss-x.x.x\server\oware\log. Also: If you install with an Oracle database,
because the Oracle installation is outside OpenManage Network Manager’s installer, OpenManage
Network Manager does not create db_setup.log.
The getlogs script also gathers the tomcat web server logs for the web portal.
If
getlogs halts, and does not produce a logs.jar file, it may be because someone installed
this software, or a previous version as root, so
getlogs does not have access to directories and
groups owned by root. Change the permissions and/or ownership of those groups and directories to
make
getlogs work.
Increasing Startup Logging
For applications based on Oware 6.2.1 and later (see your versions.txt file or Manage > Show
Versions
for your version), you can add the following line to oware\lib\pmstartup.dat . If
you add this line, this software logs all output from the startappserver script to a file. For example:
server.out.filename=/opt/dorado/pmserver.log
server.out.filename=G:\Program Files\dorado\OpenManage\pmserver.log
The destination you specify can be any valid path and file name. This helps when the server never
starts or errors occur during deployment that would not be in the usual server.log.
Tuning Log Retention
The following properties are in appserver.properties and redcell.properties file for
purging log files. As with all other properties, best practice is to override them in
owareapps/
installprops/installed.properties.
owappserver.properties
# This property defines how many days to retain server log files. All log
files
# older than the specified retention days are purged. Back up older log
files if
# you want to retain them. Set the property to -1 to disable this option.
The
# default is 7.
oware.server.log.files.retention.days=7
redcell.properties
# This property defines where redcell client log files are stored The
# following is also the default:
redcell.log.files.location=oware.user.root/owareapps/redcell/logs