Views:
 

This version of Apex One supports the following migrations:

For a complete list of the settings that the Apex One Settings Export Tool migrates, see The Apex One Settings Export Tool.

Older OfficeScan versions may not contain all the settings available in the latest Apex One version. Apex One automatically applies the default settings for any feature not migrated from the previous OfficeScan server version.

 
  1. Locate the Server Migration Tool package.
    • From the Apex One as a Service web console, go to Administration > Settings > Server Migration and click the Download Apex One Settings Export Tool link.
    • On the Apex One On-premise server, navigate to <Server installation folder>\PCCSRV\Admin\Utility\PolicyExportTool.
  2. Copy the Apex One Settings Export Tool to the source OfficeScan server computer.
     
    You must use the Apex One Settings Export Tool on the source OfficeScan server version to ensure that all data is properly formatted for the new target server. Apex One 2019 is not compatible with older versions of the Server Migration Tool.
     
  3. Double-click ApexOneSettingsExportTool.exe to start the Apex One Settings Export Tool. The Apex One Settings Export Tool will start.
     
    The default names of the export packages are:
    • ApexOne_Agent_DLP_Policies.zip (used to import DLP policy settings into Apex Central)
    • ApexOne_Agent_Policies.zip (used to import all other Security Agent policy settings into Apex Central)
    • Server_Settings_Migration.zip (used to import all Security Agent policy settings and OfficeScan server settings to another Apex One server)
     
  4. Copy the export package(s) to a location that the destination Apex One or Apex Central server can access.
  5. Import the settings. Click on the options below:
    1. From the Apex One web console, go to Administration > Settings > Server Migration and click the Import Settings... button.
    2. Locate the Server_Settings_Migration.zip package and click Open.
    3. Verify that the server contains all the previous OfficeScan version settings.
     
    This section is only applicable to customers with Apex Central.
     
    1. From the Apex Central web console, go to Policies > Policy Management.
    2. In the Product drop-down, select Apex One Security Agent.
    3. Click Import Settings.
    4. Locate the ApexOne_Agent_Policies.zip package and click Open.
     
    This section is only applicable to customers with Apex Central.
     
    1. From the Apex Central web console, go to Policies > Policy Management.
    2. In the Product drop-down, select Apex One Data Loss Prevention.
    3. Click Import Settings.
    4. Locate the ApexOne_Agent_DLP_Policies.zip package and click Open.
  6. Move the old Security Agents to the new Apex One server.

For details about moving Security Agents, see Moving Security Agents to Another Domain or Server or Agent Mover.


Issue #1

  • Issue: After clicking the Apex One Policy Export tool, the "Trend Micro Apex One Policy Export Tool has stopped working" or an application error appears when trying to copy the OfficeScan settings.
  • Root Cause: OfficeScan server information is incorrect
  • ofcdebug.log
            [][ServerMigrationTool.exe]CExportOsceSettings::ExportConfigToFile - ExportConfigToFile(.\Server_Settings_Migration.zip), 
                ServerVer(12.000000), ServicePackVer(0), PatchVer(0), ServerPath(C:\Program Files (x86)\Trend Micro\OfficeScan\PCCSRV\), 
                BuildVer(5427) - [servermigrationtoolexport.cpp(42)]
            
            [][ServerMigrationTool.exe]CExportOsceSettings::ExportConfigToFile - Server is OSCE 12 - 
                [servermigrationtoolexport.cpp(113)]
            
            [][ApexOneSettingsExportTool.exe]ParseScanConfigs - =>ParseScanConfigs() - [policyexporttool.cpp(864)]
            [][ApexOneSettingsExportTool.exe]ParseScanConfigs - Original OSCE version = 12.000000, SP version = 0, 
                Patch version = 0 - [policyexporttool.cpp(865)]
            
  • Solution: Update the registry information of the OfficeScan Server. Do the following:
    1. Open Registry Editor.
       
      Always back up the whole registry before making any modifications. Incorrect changes to the registry can cause serious system problems.
       
    2. Go to the following registry hive:
      • For 32-bit: HKEY_LOCAL_MACHINE\SOFTWARE\TrendMicro\OfficeScan\service\Information
      • For 64-bit: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\TrendMicro\OfficeScan\service\Information
    3. Modify the value of the following keys:
              "ServicePack_VersionNumber"=dword:00000001 (REG_DWORD)
              "ServicePack_Build"="6040" (REG_SZ) (You may go to OSCE web console > Help > About to verify the build version)
              "ServicePack_Description"="OfficeScan 12.0 Service Pack 1" (REG_SZ) (Only applicable to OSCE XG SP1)
              
    4. Execute ApexOneSettingsExportTool.exe and check if the issue will persists.

If the issue persists, contact Trend Micro Technical Support.


Issue #2

  • Issue: "Unable To Import Settings. An internal Error has occurred....." error encountered when using Apex One Settings Migration Tool in importing settings to another Apex One Server
  • Root Cause: Invalid file in the zip
    ofcdebug.log
        [][ServerMigrationTool.exe]CImportOsceSettings::VerifyImportZip - File = [Private\PFW\OscePfwPolicy_10_bak.dat] verify failed. - [ServerMigrationToolImport.cpp(353)]
        
  • Solution: Backup and delete the invalid file.
    1. Back up and delete the invalid file based on the folder indicated on the logs.
    2. Execute ApexOneSettingsExportTool.exe and check if the issue will persist.

If the issue persists, contact Trend Micro Technical Support.