GetLog

The Axidian Access GetLog application is designed to collect software logs of the following components locally and remotely:

• IIS Extension
• Radius Extension
• RDP Windows Logon
• Windows Logon
• Enterprise Single Sign-On

Connect to a computer

To connect to the computer whose logs you need to get:

1. Run the GetLog utility as a local administrator. The executable file is located at Axidian Access <version number>\logging\AxidianAccess.GetLog.exe.

2. In the Computer field, enter the name or IP address of the remote computer. To connect to a local computer, enter localhost or 127.0.0.1.

3. Click Connect. After the connection is established, the following options become available:

   • The Enable Log/Disable Log button for enabling and disabling logs
   • The Get Log button for getting logs
   • The Advanced Settings button for switching to the advanced settings
   • The Disconnect button

Tip

To connect to a remote computer running Windows 7 or higher, make sure that the Windows Management Instrumentation (WMI) service is running and is not disabled on the remote computer.

Enable/disable and collect logs

Using the utility

To enable or disable logging and get the logs:

1. Connect to the computer.
2. To enable logging, click Enable Log.
3. If logging is required to reveal the root cause of a problem, perform the actions required to reproduce the problem.
4. To disable logging, click Disable Log.
5. To get the logs, click Get Log....
6. Specify the folder to save the ZIP archive to and click Save.
7. To disconnect from the computer, click Disconnect and close the application.

Using the registry

In some cases, you may need to enable or disable logging manually. To do this:

1. Open Registry Editor.
2. Go to the HKEY_LOCAL_MACHINE\SOFTWARE\Axidian-ID\Logging directory.
3. Set the value of the Enabled parameter:
   • 0 to disable logging
   • 1 to enable logging

Note

By default, the logs are written to the \WINDOWS\System32\LogFiles\Axidian-Id directory. To access the logs of a remote computer, the ADMIN$\System32\LogFiles\Axidian-Id network directory is used by default. You can specify the directory for writing logs in Advanced Settings > Use alternative location.

If the error The system cannot find the file specified appears when you try to save the logs, make sure that the C:\Windows\System32\LogFiles\Axidian-ID folder exists. Create the folder manually if it is missing.

Advanced settings

Settings in the utility

To switch to the advanced settings, click Advanced Settings in the main window of Axidian Access GetLog. The following settings are available in the Advanced Settings window:

• Max. log size (bytes) — the maximum size of all files in the directory, in bytes. The default value is 1 GB. When the specified value is reached, all files in the directory whose modification date is older than the value of the Max. log file age field are deleted.

• Max. log file age (s) — the log file age in seconds. If the log size in the directory exceeds the Max. log size value, all files in the directory whose modification date is older than the value of this field are deleted.

• Cleaner interval (s) — the interval of the log directory size check, in seconds. The default value is 1 hour (3600 seconds).

• Activity checking period (ms) — the interval of the logging activity check, in milliseconds. Before starting to write logs, the Axidian Access component checks whether logging is enabled at the workstation. By default, the check interval is 1 minute (60,000 milliseconds).

• Enable log cycling — the cyclic log writing mode. If the option is enabled, the logs of each process are written according to the specified settings for the file number and size.

  • Max. size of a log file (bytes) — the maximum log size in bytes. The default value is 10 MB (1000000 bytes). When the specified size is reached, the file contents is overwritten with new data.
  • Max. number of saved log files — the maximum number of saved logs. The default value is 5, not counting the file currently being written. If the specified number of files is exceeded, the oldest one is deleted and writing continues to a newly created file.

• Use alternative location — an alternative directory for writing logs. If the option is disabled, the logs are written to the default directories:

  • ADMIN$\System32\LogFiles\Axidian-Id — the network path

  • \WINDOWS\System32\LogFiles\Axidian-Id — the local path

Settings in the registry

To switch to the advanced settings in the registry, open Registry Editor and go to the HKEY_LOCAL_MACHINE\SOFTWARE\Axidian-ID\Logging directory. The following parameters are available in the registry:

• CycleLogsFileCountMax — the maximum number of saved logs. The default value is 5, not counting the file currently being written. If the specified number of files is exceeded, the oldest one is deleted and writing continues to a newly created file.

• CycleLogsFileSizeMaxBytes — the maximum log size in bytes. The default value is 10 MB (1000000 bytes). When the specified size is reached, the file contents is overwritten with new data.

• EnabledRecheckPeriodMs — the interval of the logging activity check, in milliseconds. Before starting to write logs, the Axidian Access component checks whether logging is enabled at the workstation. By default, the check interval is 1 minute (60,000 milliseconds).

• MaxLogFileAge — the log file age in seconds. If the log size in the directory exceeds the MaxLogSize value, all files in the directory whose modification date is older than the value of this parameter are deleted.

• MaxLogSize — the maximum size of all files in the directory, in bytes. The default value is 1 GB. When the specified value is reached, all files in the directory whose modification date is older than the value of the MaxLogFileAge parameter are deleted.

• RootLogPath — an alternative directory for writing logs. If the parameter is disabled, the logs are written to the default directories:

  • ADMIN$\System32\LogFiles\Axidian-Id — the network path
  • \WINDOWS\System32\LogFiles\Axidian-Id — the local path