Service Manager

Home 

Installing and Uninstalling the Service Manager Gateway

The Service Manager gateway can be installed on Windows 7 and later operating systems. See Standard Gateway System Prerequisites for the other requirements for the gateway computer.

If you are migrating from Discovery Release 9.x to Discovery, we recommend that you install a gateway before you run the migration tool. If you create a gateway after running the migration tool, you may need to rerun the migration tool or manually relink the data to the gateway.

To install the gateway on a server that does not belong to a domain, you must specify a valid local administrator user and . (dot) for the domain name. If you are using that gateway to deploy an agent to another computer in the same workgroup, the Active Directory scan does not work. It works only if the administrator user is common for the domain; however, in a work group, although the users might have the same login credentials, they are still considered as two different users. To deploy an agent in this instance, use the client agent installer. See Installer Downloads for installation options.

Before starting the installation, specify a default organizational unit to associate with your gateway. All clients deployed by the gateway are associated with that organizational unit by default, although this can be changed later.

When you specify a default organizational unit during installation, ensure that the computer you are using to install the gateway does not already have a configuration item record in Service Manager. If one exists you can delete it if needed.

After installation, the gateway runs the Discovery client to generate a unique client ID. A registration message is then sent to the Service Manager server.

When the registration message has been received and processed by the server, the gateway computer appears in the Gateway workspace. Once the gateway is listed, you can configure it and begin to audit machines, create records, and upload the data.

The ADScan function is run on a gateway and does the following:

1.Calls the Windows ADsOpenObject API with the credentials specified during installation to get an IDirectorySearch COM object for the Active Directory domain (for example, LDAP://DC=EMEA, DC=FRS).

2.Calls IDirectorySearch.ExecuteSearch with the filter (objectCategory = computer). This uses LDAP to return all computer objects in the domain.

To perform the search, the user must be assigned permission to list content.

For more information on how to run an active directory scan, see Running an Active Directory Scan.

To uninstall the gateway, do one of the following:

Rerun the gateway installer and follow the wizard instructions to uninstall it.

From the Windows control panel, select Uninstall.

On uninstalling the gateway, the Service Manager Cloud gateway and the Service Manager agent are removed from the local computer. The Service Manager Cloud gateway is unable to inform the Service Manager server that it has been uninstalled.


Was this article useful?