IBM Streams 4.2

Changing the default location of log and trace files

The default root directory for the log and trace files that are generated by IBM® Streams is the /tmp directory. To configure a different root directory, update the domainLog.path domain property by using the streamtool setdomainproperty command or the Domain Manager.

To change the default location for the log and trace files that are generated by the web management service, update the domain.fileStoragePath domain property.

About this task

You might need to change the default location of log and trace files to a location other than the /tmp directory for the following reasons:

To increase the maximum log file size from the default size
To keep IBM Streams logs and trace files in a secure location
System maintenance utilities, such as tmpwatch, remove logs from the /tmp directory. For more information, see Instance log files deleted by the system maintenance utilities.

If you change or remove the root directory while a domain is running, you must stop and restart the domain for the update to take effect. You might have to manually remove some log and trace files. IBM Streams issues messages that identify the files that you must manually remove.

If you are running the domain controller as a registered system service or unregistered service running as user root and you change the default log file location of /tmp to another location, you must restart the service and the domain for the change to take effect. To restart the service, use streamtool stopdomainhost and streamtool startdomainhost. If the controller is running as an unregistered service, specify --unregistered on the startdomainhost command. These commands must be run as user root.

Important: If you remove a configured directory while a domain is running, IBM Streams services and applications continue running normally. However, IBM Streams stops writing data to the directory that is removed.

If you attempt to start a domain and the directories that are specified in the domainLog.path domain property do not exist, IBM Streams uses the /tmp directory.

Restrictions:

You can change the root directory for some log and trace files for the IBM Streams services and applications. The directory for other IBM Streams logs, such as installation logs, cannot be changed.
Log and trace file names cannot be changed.
The names of any subdirectories under the default /tmp directory or a configured directory cannot be changed. You can configure a different root directory for the location, but IBM Streams creates the names of the subdirectories under your configured root directory.

Procedure

To change the default location of log and trace files:

Use the streamtool setdomainproperty command.

For example:

streamtool setdomainproperty -d StreamsDomain domainLog.path=/tmp/logs

Select your domain in the Domain Manager, open the list of general properties, and edit the path value for the domainLog option.