4.1 Upgrading from the NIS Driver

Topics in this section include

4.1.1 Upgrading the Driver Shim

  1. Uninstall the NIS driver shim:

    1. Stop the NIS driver shim.

    2. Run the NIS driver shim uninstall program (/usr/sbin/nis-drv-uninstall in version 2.0.1) on the connected Linux or UNIX system. Remove both the driver files and the PAM or LAM module.

    3. Remove any system startup items related to the NIS driver shim.

  2. Install the driver shim on the connected system.

    For details, see Section 3.7, Installing the Driver Shim on the Connected System.

  3. Install the Linux and UNIX driver PAM or LAM module.

    For details, see Section 3.8, Installing the PAM or LAM Module.

4.1.2 Upgrading the Driver

  1. Make a copy of any non-standard policy customizations you have made to your driver rules:

    1. In iManager, navigate to the Driver Overview for the driver.

    2. Click the arrow icon for a policy you want to save.

    3. Select a new or customized policy in the list, then click Edit.

    4. Click Save As, specify a filename, then click Finish.

    5. Repeat Step 1.b through Step 1.d for each custom policy.

  2. Import the Linux and UNIX driver over the existing NIS driver:

    1. In the Driver Set Overview in iManager, click Add Driver.

    2. Select the appropriate existing driver set, then click Next.

    3. Import the driver rules file.

      Select Import a driver configuration from the server (.XML file), select LinuxUnix-IDM3_5_0-V2.xml, then click Next.

    4. Select the existing NIS driver to update in the Existing Drivers box on the Create Driver page.

    5. Select an installation method, then click Next.

      For details about choosing an installation method, see Section 2.5, Choosing between the Basic and the Advanced Installation Methods.

    6. Specify the configuration settings as described in Section 3.6, Setting Up the Driver on the Metadirectory Server, then click Next.

    7. Select Update everything about that driver, then click Next.

    8. Click Finish to complete the driver installation.

  3. Export the newly created policies to an XML file:

    1. In iManager, navigate to the Driver Overview for the driver.

    2. Click Export, then click Next.

    3. Accept the default export settings to export all policies, and then click Next.

    4. Leave the Prompt field blank, then click Next.

    5. Click Save As, specify a filename, then click Finish.

  4. Integrate your customizations into the policies that you saved in Step 1.

    Compare the newly-created policies with the policies that you saved in Step 1, and determine how to integrate your customizations into the standard policies for the Linux and UNIX driver. Ensure that you do not delete required functionality from the standard policies. When you have finished, save your changes for each policy to a new file.

  5. Update the policies for the driver:

    1. In iManager, navigate to the Driver Overview for the driver.

    2. Click the arrow icon for a policy you want to update.

    3. Select a policy in the list, then click Edit.

    4. Click Insert, then select Import an XML File containing Identity Manager Script.

    5. Append to or replace the policy.

      • If the policy was new, select Append the rules from the imported policy.

      • If the policy was customized from a standard policy, select Replace the policy with the imported policy.

    6. Enter or browse for the appropriate XML file that you saved in Step 4, then click OK.

    7. Repeat Step 5.b through Step 5.f for each custom policy.

  6. Start the Linux and UNIX driver.

    Click the upper right corner of the driver icon, then click Start driver.

Customizing policies is an advanced task that is beyond the scope of this document. For complete information on policy customization, see the Policy Builder and Driver Customization Guide on the Identity Manager 3.6.1 Documentation Web site.

4.1.3 Post-Migration Tasks

Perform the steps listed in Section 3.9, Post-Installation Tasks.