Install the Sun Identity Manager Gateway

If you plan to set up Windows Active Directory, Novell NetWare, Novell GroupWise, Exchange 5.5, Remedy, or RSA ACE/Server resources, you should install the Sun Identity Manager Gateway.

Prerequisites

If you are using Domino, there are additional steps to perform for Domino gateway configuration. See the chapter titled Resources Reference in Identity Manager Technical Reference.

The Sun Identity Manager Gateway may be installed on Windows 2000 SP3 or above and Windows 2003 platforms.

Installation

Select the Windows machine on which to install the gateway. It must be a member of the domain in which the accounts and other objects will be managed (the managed domain) or a member of a domain that is trusted by the managed domain. The gateway does not need to run on a domain controller.

If you are selecting a system that is not the Identity Manager server, then:

Create a directory called idm on the remote system.

Copy the gateway.zip file from the Identity Manager Installation CD.

Unpack and copy the contents of the gateway.zip file to the idm directory.

From the directory where the gateway files are installed, run the following command to install the gateway as a service:

gateway –i

Run the following command to start the gateway service:

gateway -s

You can stop the gateway service by running the command:

gateway -k

You can also start and stop the gateway by following these steps:

Open the Windows Control Panel.

Open Services. (In Windows, Services is located in Administrative Tools.)

Select Sun Identity Manager Gateway.

Click Start or Stop.

Failure Messages

Two common messages and their likely causes when working with the gateway are as follows:

'Overlapped I/O operation is in progress'

The most common cause of this message is that you have asked for the service to be installed or removed before a prior installation or removal has fully completed. Check the state of the service.

'Input/output error'

The most common cause of this is that you do not have rights to work with this service.

11