Windows Collector Admin to Non-admin User Migration

Previously, you could run Windows collectors using administrator (admin) credentials. Later, LogicMonitor extended this support to users with non-administrator (non-admin) credentials to install collectors.

LogicMonitor has enhanced the migration process to enable you to migrate collectors running under admin user to run under non-admin user without uninstalling collectors or losing any data. You can follow the prompt-based migration process to migrate collectors from admin user to run under non-admin user.

Requirements for Migrating Windows Collector to Non-admin User

To migrate Windows collector to non-admin user, you need the following:

• User with admin privileges and valid credentials
• User with non-admin privileges and valid credentials
• PowerShell version 5 or later
• EA Collector 35.400 or later installed on your machine

Migrating Windows Collector from Admin to Non-admin User

1. Log in to the machine where the collector is already installed with admin credentials.
2. Open a new Windows PowerShell with admin privileges and go to the Agent\bin folder in the directory where the Windows collector is installed. The default path is C:\Program Files\LogicMonitor\Agent\bin\.
3. Enter and run the script .\Windows_NonAdmin_Config.ps1 followed by the parameters. The user must be a non-admin user. For example:

.\Windows_NonAdmin_Config -add -UserName LogicMonitor

To access help, enter the parameter -h after the script. The following parameters are displayed.

When you enter the script and the parameters, the migration commences.

When the migration is complete, a success message is displayed.

4. Verify migration. For more information, see the Verifying Migration of Windows Collector section.

Rolling Back Windows Collector Migration from Non-admin to Admin User

You can rollback Windows collector migration from non-admin to admin user in the following two ways:

• Silent Rollback
• Prompt-based Rollback

 Silent Rollback

1. Log in to the machine where the collector is installed under a non-admin user.
2. Open a new Windows PowerShell with admin privileges and go to the Agent\bin folder in the directory where the Windows collector is installed. The default path is C:\Program Files\LogicMonitor\Agent\bin\.
3. Enter and run the script .\rollbackToAdminUser.ps1 followed by the parameters for silent roll back.
   To access help, enter the parameter -h after the script. The following parameters are displayed:

The format and sequence is -q -u [admin username] -p [admin password] -d [custom path, if any]. The user must be an existing admin user. For example,

 .\rollbackToAdminUser.ps1 -q -u Administrator -p password

After you run the script, the Windows collector rolls back to the admin user. 

Prompt-based Rollback

1. Log in to the machine where the collector is installed under a non-admin user.
2. Open a new Windows PowerShell with admin privileges and go to the Agent\bin folder in the directory where the Windows collector is installed. The default path is C:\Program Files\LogicMonitor\Agent\bin\.
3. Enter and run the script .\rollbackToAdminUser.ps1.
4. Enter the credentials of an existing admin user.
5. Enter the directory in which the collector is installed. By default, the collector is located at C:\Program Files\LogicMonitor.
6. Press Enter for the default path. If the collector is located at another directory, then specify the custom path.
   
   
   After you run the script, the Windows collector rolls back to the admin user. 
   

Verifying Migration of Windows Collector

Perform the following steps 10 minutes after the migration is complete.

1. In LogicMonitor, navigate to Settings > Collectors.
2. Under the Collectors tab, search for the collector ID that you migrated to a non-admin user or rolled back to an admin user.
3. Select the More option and then select Collector Status.
4. Verify the role and user under Collector Status.
   Collector Status page indicating successful migration from admin to non-admin user
   
   
   Collector Status page indicating successful migration from non-admin to admin user