Troubleshooting

If the agent fails to start, ensure that the configuration file is present at %NFAST_DATA_HOME%/keysafe5/conf/config.yaml.

If the configuration file is present but the agent still fails to start, see below for instructions on accessing the log.

If you are using TLS, ensure that the private key and certificate files are present in %NFAST_DATA_HOME%/keysafe5/conf/messagebus/tls.

Logging

Linux

The KeySafe 5 agent log file is located at /opt/nfast/log/keysafe5-agent.log, unless configured otherwise.

Windows

The KeySafe 5 agent log file is located at %NFAST_LOGDIR%\KeySafe5-agent.log, unless configured otherwise.

The KeySafe 5 Windows Service actions are emitted to the Windows event log under the nShieldKeySafe5 source identifier.

You can use the nshieldeventlog utility to extract these log entries and output them to the console or a text file.

nshieldeventlog.exe --source=nShieldKeySafe5

As required, specify the following parameters.

  • -c | --count: The number of records read from the event log.

    The default is 10000

  • -f | --file: The output filename.

See the nShield Security World Software documentation for more information on the nshieldeventlog utility.