7.10 Adding New Servers to the Driver Set

When you want to add a new server to upgrade, migrate, or run the drivers on those servers, add the new server to the driver set and then prepare that server to run the drivers.

Before you add the new server to the driver set, you must install the server to the Identity Vault and then install and configure Identity Manager on the new server. You can either add the new server to a new driver set or to an existing driver set. If you are adding the server to an existing driver set, select the Custom Configuration and then select Add to an Identity Vault existing on local machine or Add to an Identity Vault existing on remote machine.

When you add the replica of a driver set partition to a new server, there are some server specific information that are not copied to the new server. The server-specific information stores information about the driver set and individual drivers running on the Identity Manager server such as:

  • Global configuration values

  • Engine control values

  • Named passwords

  • Driver authentication information

  • Driver startup options

  • Driver parameters

  • Driver set data

7.10.1 Using iManager to Add the New Server to the Driver Set

You can add a new server to the driver set using iManager.

Adding a New Server to the Driver Set

  1. In iManager, click to display the Identity Manager Administration page.

  2. Click Identity Manager Overview.

  3. Browse to and select the container that holds the driver set.

  4. Click the driver set name to access the Driver Set Overview page.

  5. Click Servers > Add Server.

  6. Browse to and select the new Identity Manager server, then click OK.

Copying the Server Specific Information to the New Server

You must copy the server-specific information to the new server. For more information, see the NetIQ Identity Manager Driver Administration Guide.

7.10.2 Using Designer to Add the New Server to the Driver Set

Designer allows you to add a new server to the driver set using the server migration tool or manually.

Adding a New Server to the Driver Set Using the Migration Tool

  1. Add the new server to the Identity Vault.

    1. Log in to Designer.

    2. Right-click the Identity Vault and then select Properties.

    3. Click the Server List option.

    4. Click Add to browse the server you want to add.

    5. Click OK.

  2. From the Outline view, select the original server, right-click, and then select Migrate.

  3. Click Next.

  4. Select the target server.

  5. Select the Keep the source server active option.

    This option disables all the drivers on the new server and copies the server-specific information of the driver set to the new driver.

  6. Click Migrate.

  7. Click Close.

Adding a New Server to the Driver Set Manually

  1. Add the new server to the Identity Vault.

    1. Log in to Designer.

    2. Right-click the Identity Vault and then select Properties.

    3. Click the Server List option.

    4. Click Add to browse the server you want to add.

    5. Specify the server details.

    6. Click OK.

  2. Copy the driver set GCVs to the new server.

    1. Right-click the driver set and then select Copy > Global Configuration Values.

    2. From the list of available servers, select the new server.

    3. Click OK.

    4. Click Yes to merge or overwrite the server-specific information on the new server.

      NetIQ recommends you to select No.

  3. Copy the driver-specific information to the new server.

    1. Right-click the driver set and then select Copy > Server-specific settings.

    2. From the list of available servers, select the new server.

    3. Click OK.

    4. Click Yes to merge or overwrite the server-specific information on the new server.

      NetIQ recommends you to select No.

  4. Click Next.

Copying the Required Driver files and Configuration to the New Server

Depending on the drivers you are copying over to the new server, you may want to copy some jar files or perform some steps to start and run the driver on the new server. For more information, see the individual driver documentation for specific requirements of each drivers.

Deploying the Changes to the Identity Vault

After copying the server-specific information to the new server, you must deploy all the changes to the server. Use the following procedure to deploy an Identity Manager Driver Set object into an existing Identity Manager system in an eDirectory tree.

  1. Log in to Designer.

  2. Right-click the driver set icon in the Modeler view and then click Live > Deploy.

7.10.3 Removing the Old Server from the Driver Set

After the new server is running all of the drivers, you can remove the old server from the driver set.

Using Designer to Remove the Old Server from the Driver Set

  1. In Designer, open your project.

  2. In the Modeler, right-click the driver set, then select Properties.

  3. Select Server List.

  4. Select the old Identity Manager server in the Selected Servers list, then click the < to remove the server from the Selected Servers list.

  5. Click OK to save the changes.

  6. Deploy the change to the Identity Vault.

    For more information, see Deploying a Driver Set to an Identity Vault in the NetIQ Designer for Identity Manager Administration Guide.

Using iManager to Remove the Old Server from the Driver Set

  1. In iManager, click to display the Identity Manager Administration page.

  2. Click Identity Manager Overview.

  3. Browse to and select the container that holds the driver set.

  4. Click the driver set name to access the Driver Set Overview page.

  5. Click Servers > Remove Server.

  6. Select the old Identity Manager server, then click OK.

Decommissioning the Old Server

At this point, the old server is not hosting any drivers. If you no longer need this server, you must complete additional steps to decommission it:

  1. Remove the eDirectory replicas from this server.

    For more information, see “Deleting Replicas” in the NetIQ eDirectory Administration Guide.

  2. Remove eDirectory from this server.