Sign In with your
Trend Micro Account
Need Help?
Need More Help?

Create a technical support case if you need further support.

Migrating agents using the Agent Migration Tool in Endpoint Sensor (TMES) 1.6

    • Updated:
    • 14 Aug 2018
    • Product/Version:
    • Trend Micro Endpoint Sensor 1.6
    • Platform:
    • N/A N/A
Summary

This article provides the procedure on how to prepare an agent migration environment and how to use the Agent Migration Tool.

You will need contact Trend Micro Technical Support to request for the Agent Migration Tool.

Details
Public
 

To ensure security, Trend Micro observes the following:

First is API token authentication: Trend Micro requires the API tokens of both old and new servers, and generates a tool based on the API tokens to allow successful authentication. This also ensures that the tool is unique and works only for the servers with the matching API tokens. For example, an admin needs to migrate agents from Server A to Server B, and then migrate the agents from Server B to Server C. The admin must request for two tools – one tool for the Server A to Server B migration, and another tool for the Server B to Server C migration.

Second is Self-deletion: After users deploy the tool to the agents to be migrated, the tool runs and then automatically deletes itself. This is to avoid improper use of the tool.

  1. Install a new TMES server.
  2. Provide the proxy settings of the old and new servers to Trend Micro.

    Skip this step if the servers do not use a proxy.

  3. Provide the API token of the old server to Trend Micro:

    1. On the old TMES server, go to: C:\Program Files\Trend Micro\Trend Micro Endpoint Sensor\Download\Package\
    2. Create a new copy of the following file: AgentSetupLauncher.ini
    3. Rename the new file to: old_AgentSetupLauncher.ini
    4. Send the renamed file to Trend Micro.
  4. Provide the API token of the new server to Trend Micro:

    1. On the new TMES server, go to: C:\Program Files\Trend Micro\Trend Micro Endpoint Sensor\Download\Package\
    2. Create a new copy of the following file: AgentSetupLauncher.ini
    3. Rename the new file to: new_AgentSetupLauncher.ini
    4. Send the renamed file to Trend Micro.
  5. Trend Micro generates a tool based on the provided API tokens and proxy settings.

    generated tool

  1. Export the client table data on the old TMES server.

    1. Use SQL Server Management Studio to connect to SQL server.

      connect to SQL server

    2. Navigate to the TMES DB. Right-click on SmartSensor then click Tasks > Generate Scripts. The Generate and Publish Script window appears.

      Generate Scripts

    3. Click on the Introduction tab then click Next.

      Introduction screen

    4. On the Choose Objects tab, under Select the database objects to script, choose Select specific database objects.  Expand Tables, select dbo.Client and then click Next.

      Select specific database objects

    5. On the Set Scripting Options tab, select Save scripts to a specific location as the Output type. Go to Advanced then select Data only as the Types of data to script then click OK.

      Set Scripting Options

    6. Select Save to file, specify the full path for the File name then click Next.

      specify the full path

    7. On the Summary tab, click Next.

      Summary tab

    8. Go to the Save or Publish Scripts tab then click Finish.

      Save or Publish Script

  2. Import the client table data on the new TMES server.

     
    The tool requires that data on the new and old servers are consistent. Before running the tool on the agents, ensure that the client data of the old server has already been transferred to the new server.
    1. Copy the exported file from the old server to the new SQL server machine.
    2. Log in to the SQL server for the new Trend Micro Endpoint Sensor server.
    3. Click File > Open > File…  then navigate to the location of the exported file.

      select File...

      exported file location

    4. Click Execute.

      click Execute

  3. Clear all agents shown on console before migration. This is to avoid any confusion after migration that the agents went offline or were not migrated successfully.

    1. On the new server, type and run the following SQL statement to update the Client Status to 3:

      Update      [SmartSensor].[dbo].[Client]  SET      Status = 3  

      new server

    2. Open the web console of the new server and verify that there are no agents shown on console.

      verify that no agents shown on console

  4. Deploy the tool to the agent. The tool deletes itself after execution.

     
    After deployment, the tool runs and then automatically deletes itself. This is to avoid improper use of the tool.
  5. Open the web console of the new server and verify that all agents were moved successfully.

    verify all agents were moved successfully

Premium
Internal
Rating:
Category:
Migrate
Solution Id:
1120724
Feedback
Did this article help you?

Thank you for your feedback!

To help us improve the quality of this article, please leave your email here so we can clarify further your feedback, if neccessary:
We will not send you spam or share your email address.

*This form is automated system. General questions, technical, sales, and product-related issues submitted through this form will not be answered.

If you need additional help, you may try to contact the support team. Contact Support

To help us improve the quality of this article, please leave your email here so we can clarify further your feedback, if neccessary:
We will not send you spam or share your email address.

*This form is automated system. General questions, technical, sales, and product-related issues submitted through this form will not be answered.