SylinkDrop or SylinkReplacer fails to assign Symantec Endpoint Protection clients to a new Client Group

Article:TECH103041  |  Created: 2007-01-06  |  Updated: 2011-01-14  |  Article URL http://www.symantec.com/docs/TECH103041
Article Type
Technical Solution


Environment

Issue



Either the SylinkDrop tool or SylinkReplacer tool was used with the intention of moving clients to an existing client group created within a new Symantec Endpoint Protection Manager. The tool moved the client into the Temporary group instead of the preferred group.

Symptoms
The Symantec Endpoint Protection client registers with the new Symantec Endpoint Protection Manager site and is assigned to the My Company/Default Group instead of the group desired.


 


Cause



The SylinkDrop, or SylinkReplacer, tool will not automatically move clients into a specific group unless specific conditions are met. In addition, neither tool will move clients from one group to another when that client is already reporting to that Symantec Endpoint Protection Manager.

For instructions on how to move groups within the same manager via SylinkDrop or SylinkReplacer see the references section of this document.


Solution



The following conditions must be met in order for SylinkDrop or SylinkReplacer to move a client into a new Symantec Endpoint Protection Manager server's group:
 

  • The Sylink.xml file must contain the "PreferredGroup" information which identifies the target client group.
  • The HardwareID key must be deleted from:
    HKEY_LOCAL_MACHINE\SOFTWARE\Symantec\Symantec Endpoint Protection\SMC\SYLINK\SyLink.

     
  • The Symantec Endpoint Protection client is not registered with the Symantec Endpoint Protection Manager site. If there is a record of the Symantec Endpoint Protection client in the new Symantec Endpoint Protection Manager site then the "PreferredGroup key" will not be used during client registration.



The following procedure should be used to move clients into a specific group within a new SEPM site. Otherwise, the Symantec Endpoint Protection clients will be assigned to the temporary group.

 

  1. Create an exported installation package assigned to a client group and copy the associated Sylink.xml to the client.

      1. Within the Symantec Endpoint Protection Manager console, click on Admin.
      2. Click on Install Packages.
      3. Under Tasks, click on Export Client install Packages
      4. Specify an "Export folder" for the exported installation package.
      5. Uncheck the Create a single .EXE file for this package option.
      6. Ensure that the Export packages with policies from the following groups option is checked.
      7. Specify the target client group, you want the clients to move into.
      8. Specify the mode setting (Computer or User mode)
      9. Click OK.
      10. When the Exporting package process is finished, click OK.
      11. Go to the folder specified as the Export folder and open the Global_<Client_Group_Name> folder to retrieve the sylink.xml used in this process.

         
  2. Delete the HardwareID registry key on the client.

    1. Click on Start, then Run...
    2. Type regedit and click OK.
    3. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Symantec\Symantec Endpoint Protection\SMC\SYLINK\SyLink.
    4. Delete the HardwareID registry key.
    5. Close the registry editor.

       
  3. Run the SylinkDrop or SylinkReplacer tool and use the Sylink.xml from step 1


    SylinkDrop
      1. Copy the SylinkDrop tool from the second Symantec Endpoint Protection CD to the client machine. The tool is located in the TOOLS\NOSUPPORT\SYLINKDROP folder.
      2. Double-click the SylinkDrop.exe file to start the tool.
      3. Click Browse then navigate to and select the "Sylink.xml" retrieved in step 1 of these instructions. Click Open.
      4. Click Update Sylink.
      5. This will stop the Smc service, drop the "sylink.xml" file then restart the Smc service and force the client to register with the Symantec Endpoint Protection Manager server.

         
    SylinkReplacer
      1. Obtain the SylinkReplacer tool from Support.
      2. Run the tool and follow the prompts.

        Note: For step-by-step instructions on how to use the SylinkReplacer tool see the PDF file provided with the tool.



References

Please reference the "Exporting installation packages" section of the Administration_guide.pdf. at:
ftp://ftp.symantec.com/public/english_us_canada/products/symantec_endpoint_protection/11.0/manuals/administration_guide.pdf


This document is available in the following languages:




 


Supplemental Materials

Value1176268


Legacy ID



2007120611043048


Article URL http://www.symantec.com/docs/TECH103041


Terms of use for this information are found in Legal Notices