6.6 Managing Migrate Client User Activity Log

By default, PlateSpin Migrate Client logs all user activities that are performed in the Client. Actions logged include security, license management, target and workload discovery operations, and workload migration operations.

6.6.1 About the Migrate Client User Activity Log

When User Activity Logging is enabled in PlateSpin Migrate Client, user actions performed in the Migrate Client are written in a User Activity Log file (PlateSpin.UserActivityLogging.log), located on your PlateSpin Server host, in the ..\PlateSpin Migrate Server\logs directory.

The format of an individual log entry is:

date|Category|description|user|details1|details2

The Category element describes the functional area applicable to a particular action:

  • Security

  • LicenseManagement

  • Inventory (discovery operations for workloads and targets)

  • Migration (workload migration operations)

Elements details1 and details2 depend on the category and provide additional information if applicable.

The following is an example log entry that records the login action of a user with the domain account MyDomain\John.Smith. It has no details.

2017-09-02 14:14:47|Security|User logged in|MyDomain\John.Smith

The log file rolls over when the size of a log file reaches a specified maximum file size. The default maximum file size for the PlateSpin.UserActivityLogging.log file is 2 MB.

A sequential number is appended to the log file name for the rollover file. You can specify the maximum number of rollover files to keep. The default is 5.

PlateSpin.UserActivityLogging.log.1
PlateSpin.UserActivityLogging.log.2
PlateSpin.UserActivityLogging.log.3

6.6.2 Configuring Migrate Client User Activity Logging

The PlateSpin Migrate Client enables you to turn off or on (default) the User Activity Logging. You can configure the maximum size allowed for the User Activity Log file and how many rollover files to maintain for user activity logging.

To configure User Activity Logging:

  1. Launch the PlateSpin Migrate Client.

  2. Click Tools > Options.

  3. Click the User Activity Logging tab.

  4. Specify the following options:

    Option

    Description

    Enable Logging

    When this option is selected, PlateSpin Migrate logs all user activities performed using the Migrate Client.

    Maximum file size before rollover (MB)

    When the size of a log file reaches the specified value, it is rolled over to a new file with a sequential number appended to the name.

    Maximum number of files for rollover

    When the number of log files reaches the specified value, the system starts overwriting the oldest file each time a rollover is performed.

  5. Click OK.

6.6.3 Viewing Migrate Client User Activity Log

  1. Log in to the PlateSpin Migrate Server host as the Administrator.

  2. Go to the ..\PlateSpin Migrate Server\logs directory.

  3. Make a copy of the PlateSpin.UserActivityLogging.log file, then open the copy in a text editor.

    You can also open any of its rollover files in a text editor.