Streaming non-English-language log files from a remote, internal IBM Tivoli Monitoring Log File Agent

Before you can use a remote instance of the internal IBM® Tivoli® Monitoring Log File Agent that is installed with IBM Operations Analytics Log Analysis to ingest non-English-language log files, you must configure the locale.

About this task

Warning: This feature requires that you install interim fix 4 for IBM Operations Analytics Log Analysis 1.2.

In this case, it is assumed that you used the install.sh command that is in the <HOME>/eif_remote_install_tool/ to create a remote instance of the internal IBM Tivoli Monitoring Log File Agent that is installed with IBM Operations Analytics Log Analysis. Where <HOME> is the directory in which IBM SmartCloud® Analytics - Log Analysis is installed.

The new locale applies to all the logs that are streamed by the internal IBM Tivoli Monitoring Log File Agent, regardless of whether these logs are monitored locally or remotely. If you are monitoring logs that are remote to the agent, ensure that the locale that you specify in these steps matches the locale that is used in the source application. If you are monitoring files that are local to the agent, ensure that the locale that you specify in these steps matches the one that is used by the local agent.

Procedure

To stop the remote instance, use the lfautil.sh command that is in the <USER_HOME_REMOTE>/utilities/ directory on the remote server. <USER_HOME_REMOTE> is the directory on the remote server where the IBM Tivoli Monitoring Log File Agent is deployed.
```
./lfautil.sh -stop
```
To set the locale, go to the <USER_HOME_REMOTE>/LogAnalysis/utilities directory and edit the LFA_LOCALE parameter in the locale.properties file. For example, to enable the ingestion of Chinese, set the locale to zh_CN.UTF-8:
```
LFA_LOCALE=zh_CN.UTF-8
```
To start the remote instance, use the lfautil.sh command that is in the <USER_HOME_REMOTE>IBM/LogAnalysis/utilities/ directory on the remote server.
```
./lfautil.sh -start
```

Results

The new locale is only applied to the IBM Tivoli Monitoring Log File Agent. It is not applied to the other services in IBM Operations Analytics Log Analysis.

After you change the IBM Tivoli Monitoring Log File Agent locale to a value other than the default value, you must ensure that the locale for the console where you run the lfautil.sh script is the same as the changed locale.