Change the log or audit path name

Before you begin

Review View and configure log and audit messages.

By default, the log files are named Controller.log and Agent.log for the Controller and Agent, respectively, and are stored in the logs folder in the installation directories of the Controller and Agent. For example, if you installed the Controller in c:\install_dir\user_projects\controller, the Controller log file is located at: c:\install_dir\user_projects\controller\logs\Controller.log.

To change the log or audit path name:

To change the log or audit path name for the Controller, access the Controller page in one of the following ways:
- Click the Controller tab in the WLOC navigation bar.
- Click the Home tab in the WLOC navigation bar and click Controller under Manage Configuration.
To change the log or audit path name for an Agent, access the Agent page in one of the following ways:
- Click the Inventory tab in the WLOC navigation bar, expand the Agents list in the Inventory pane, and click the name of the Agent.
- Click the Agents tab in the WLOC navigation bar and click the name of the Agent that you want to configure in the Agents table.
- Click the Home tab in the WLOC navigation bar, click Agents under Manage Configuration, and click the name of the Agent that you want to configure in the Agents table.
Click the Logging or Audit tab on the Controller or Agent page to change the log or audit path name, respectively.

Modify the following field.

Field Description

Field	Description
Log File Name	Path name of the log file. The path can be absolute or relative to the Controller or Agent installation directory. When you click Save (in Step 4), WLOC writes all subsequent messages to the new file. To include a time and date stamp in the file name when the log file is rotated, as described in Rotate log or audit files, add `java.text.SimpleDateFormat` variables to the file name and surround each variable with percentage (`%`) characters. For example, if you enter the following value: `myserver_%yyyy%_%MM%_%dd%_%hh%_%mm%.log`, the server log file will be named: `myserver_yyyy_MM_dd_hh_mm.log`. When WLOC rotates the log file, the rotated file name contains the date stamp. For example, if WLOC rotates the Controller's log file on 4 March, 2007 at 10:15 AM, the log file that contains the old log messages will be named: `Controller_2005_03_04_10_15.log`. If you do not include a time and date stamp, the rotated log files are numbered in order of creation `filenamennnnn`, where `filename` is the name configured for the log file. For example: `Controller.log00007`.

Log File Name

Path name of the log file. The path can be absolute or relative to the Controller or Agent installation directory. When you click Save (in Step 4), WLOC writes all subsequent messages to the new file.

To include a time and date stamp in the file name when the log file is rotated, as described in Rotate log or audit files, add java.text.SimpleDateFormat variables to the file name and surround each variable with percentage (%) characters. For example, if you enter the following value: myserver_%yyyy%_%MM%_%dd%_%hh%_%mm%.log, the server log file will be named: myserver_yyyy_MM_dd_hh_mm.log.

When WLOC rotates the log file, the rotated file name contains the date stamp. For example, if WLOC rotates the Controller's log file on 4 March, 2007 at 10:15 AM, the log file that contains the old log messages will be named: Controller_2005_03_04_10_15.log.

If you do not include a time and date stamp, the rotated log files are numbered in order of creation filenamennnnn, where filename is the name configured for the log file. For example: Controller.log00007.

Click Save.
The log configuration is updated and the following confirmation message is displayed:
```
Settings updated successfully
```

WLOC Administration Console Online Help

Change the log or audit path name