Deploy the Surveyor 6 Windows Agent Using Group Policy

This process involves two separate procedures: create the transform file from the client installer package (.msi); then add the transform and package to a Group Policy object (GPO). This procedure applies to the Windows agent only.

To create the transform file, you need a transform editor. The procedure provided here uses Orca, although you can use any transform editor.

Orca is a database table editor for creating and editing Windows Installer packages and merge modules. It is available in the Windows Installer SDK, and also available in the Verdiem installer folder under the Extras\Orca.

  1. Start Orca, and in the client agent folder of your Surveyor distribution, open Surveyor Agent.msi.
  2. From the Transform menu, choose New Transform.
  3. In the Tables column, select Property.
    Right-click in the Property/Value columns and select Add Row.

  4. Create the following properties and values:
    • PMP_URL: The address of the power management web server that hosts the PMP service.
      Note: You must add this property.
      Specifies the web address to the PMP service on the Surveyor server. For example:http://<servername>/PMPService/PMPService.svc/PMP.

    • SERVER_PORT: the port number you will use for the deployment (http port 80 by default).
  5. From the Transform menu choose Generate Transform.
  6. Enter a name for the transform file (.mst), save it, and then exit Orca.

Create the Group Policy object for Surveyor Windows client installation

After you create a transform file from the Surveyor client installer package, you can add it and the package to a Group Policy object to install the Windows client software.

Before you can perform this procedure, use the steps on the previous page to create the transform file that you'll use in this procedure.

NOTE: This procedure is from the Group Policy Object Editor Help and modified to include the information specific to Surveyor.

  1. Open the Group Policy Object Editor by choosing Start menu / Run, and typing gpedit.msc.
  2. Navigate to and select Computer Configuration / Software Settings / Software Installation.
  3. Right-click in the details pane and click New / Package. Ensure Domain Computers are added to Security Filtering.
  4. In the Open dialog box, type the UNC to Surveyor Agent.msi and then click Open. Do not browse to locate the file. Surveyor Agent.msi is typically located in the Surveyor Agent folder in the Surveyor distribution folder.
  5. In the Deploy Software dialog box, click Advanced, and then click OK.
  6. In the Properties dialog box for the package, on the Modifications tab, click Add.
  7. In the Open dialog box, navigate to the transform file you created for the Surveyor client installer, and then click Open.
  8. Make sure you are done configuring modifications, and then in the Surveyor Client Agent Properties window, click OK.

NOTE: The package is assigned or published immediately when you click OK. If the modifications are not properly configured, you will have to uninstall the package or upgrade the package with a correctly configured version.

  1. Close the Group Policy Object Editor.
  2. To put the Group Policy updates into effect, either restart the computers or run the command gpupdate /force to refresh the Group Policy settings.

NOTE: Computers must either be restarted in order to obtain Group Policy Updates or you can run the commandgpupdate /force. In either case, the computer must be restarted once more before the new group policy takes effect.

NOTE: If you get an error that validation of the installer package has failed, try editing the default language properties of the package. To do this, right-click the package and choose Properties. On the Deployment tab, click Advanced, and then select the Ignore language option when deploying this package.



Please sign in to leave a comment.