Show TOC

 Adding Log Files from a Log DirectoryLocate this document in the navigation structure

Use

Use this procedure to manually add logs from a directory that is different from the default log directory.

Several XML files: <host name>_<system name>_<instance ID>_<dispatcher ID>_lv_.xml for the dispatcher nodes, and several files: <host name>_<system name>_<instance ID>_<node ID>_lv_.xml for each server, are used to persist the added logs.

Logs are added via these XML files on the client machine.

This feature performs a check on the existing log files and only the new logs in that directory are registered/added.

  • By default, an XML file is automatically created for each J2EE Engine node in the log directory. This XML file is specified in the Logviewer_LogDirectoryWriteToFile property in the Log Viewer service .

    By default, this log directory is the /tmp/ directory. Each XML file contains information about each log file that is registered on the J2EE Engine node.

  • The Standalone Log Viewer server reads from the log directory that is specified in the Logviewer_LogDirectoryReadFromFile property in the /usr/sap/<SID>/JC<Instance number>/j2ee/admin/logviewer-standalone/server/LogViewerServer.properties file.

    By default, this log directory is the /tmp/ directory. The Standalone Log Viewer server uses these XML files to display the corresponding log files.

  • If there are log archives on the corresponding J2EE Engine node in the cluster, the XML files contain the directories of the archives, not the individual archives. The name of the XML files is the following: <Host>_<SID>_<Instance number>_<Node ID>_lv_.xml .

In addition, you can use this procedure to save the logs under a sub-node as an XML file to a directory of your choice. Later you can manually add the logs from this directory.

Prerequisites
  • When you start a J2EE Engine node, if an XML file exists for the node, it is automatically deleted and a new file is created. Therefore, if you want to keep the old XML file, before restarting the J2EE Engine node, create a copy of the file in the same directory.

If there is a ServerLogDirectory.xml file in the default log directory, delete it.

  • The paths to all logs that the XML files contain must be specified in the Logviewer_MonitorablePath property.
  • Logviewer_LogDirectoryReadFromFile property must have as a value the absolute path to the directory so that the Standalone Log Viewer can find the files to be read.
Procedure

Adding Logs from a Log Directory

  1. In the Visual Administrator, select Log Viewer service.
  2. From the Runtime toolbar, select the node on which the log directory exists, and choose  Add Files from LogDirectory.
  3. Browse to the XML file you want to add and choose Open.

    The logs are added at the end of the tree.

  4. To refresh the node and sort the logs and display them correctly in the tree structure, choose  Refresh overview of logs.
  5. To display the log records from a log file, double-click the log file.

    The log records are displayed in a table in the pane on the right.

Saving Sub-Nodes as a Log Directory

  1. Right-click on the node, which sub-nodes you want to save, and in the context menu, choose Save sub-nodes as Log Directory.
  2. Save the file as an XML file to a directory of your choice.

    All logs under the selected node are saved to the chosen directory and you can manually add them from this directory later.