Rename

Agent > Rename

The Rename page renames any existing machine ID account. You can change the machine ID and/or re-assign it to a different group ID.

Note: See Alert > Change Group to assign multiple machines to a different group ID.

Procedure

1. Select a machine ID in the paging area.
2. Click one of the following radio buttons:
   • Rename Agent at next check-in then rename account on the VSA server - Select this option to dynamically change the machine ID name for an actively checking-in agent. This option guarantees that the agent and KServer remain in sync.
   • Rename account on VSA immediately - Select this option for machine ID accounts you wish to rename prior to deploying the agent.

     Warning: If an account has an actively checking-in agent, renaming an account immediately prevents that agent from successfully checking-in again until the new account name is entered on the managed machine. (Right click the agent icon on the managed machine, select the Set Account... option and enter a new account name.)

     Warning: If a machine ID account is renamed and has an actively checking-in agent and auto account creation is enabled for a group using System > Check-in Policy, a new machine account will be created at the client's next check in using the original machine ID name. 

   • Merge offline account <Offline Machine ID> into <Select Machine ID> - Use merge to combine log data in two different accounts that pertain to the same machine. This could be necessary if an agent was uninstalled and then reinstalled with a different account name. Also, loading a new agent onto a machine that has had an agent before may create a duplicate account for the same machine. Merge combines the accounts as follows:
     • Log data from both accounts are combined.
     • Baseline Audit data from the old offline account replaces any baseline data in the selected account.
     • Alert setting from the selected account are kept.
     • Pending scripts from the selected account are kept. Pending scripts from the old offline account are discarded.
     • The old account is deleted after the merge.

       Note: Since the machine can only be active on a single account, only offline accounts are provided in the drop down list to merge with.

3. Optionally enter in a new name for the machine ID account.
4. Optionally select a different group ID for the machine ID account.
5. Click the Rename button.

Rename

Click Rename to change the name of a selected machine ID account, using the options previously selected.

New Name

Enter the new name for the selected machine ID.

Group ID

Select the group ID to assign to the selected machine ID account. The default leaves the group ID unchanged.

Check-in status

These icons indicate the agent check-in status of each managed machine:

Agent has checked in

Agent has not recently checked in

Agent has never checked in

Online but waiting for first audit to complete

The agent is online but remote control is disabled

Machine ID.Group ID

The list of Machine ID.Group IDs displayed is based on the Machine ID / Group ID filter and the machine groups the administrator is authorized to see using System > Group Access. Click the radio button to the left of the machine account you wish to rename.

New Name at Next Check-in

Lists the new name the account will be renamed to the next time that agent checks in. Only pending renames are displayed here.

Topic 543: Send Feedback