1.1 Installing the SCIM Driver Files and Packages

To start with installing the driver, you must first download and install the driver files and packages to set up the SCIM driver. This section explains procedures to install the driver files and the required driver packages.

1.1.1 Installing the Driver Files

You can install the SCIM driver files as a root user or as a non root user in your system. The procedure to install the driver files is similar for any connected application.

You must ensure that you have the required SCIM drivers files such as,.zip,.rpm, and.jar etc,. handy to install the SCIM driver in your system.

For example:

  • .zip file: NIdm_Driver_SCIM.zip

  • .rpm file: <netiq-DXMLscim.rpm>

  • .jar file: <SCIMUtils.jar>

This section explains the procedure to install the driver files.

  1. Download and unzip the contents of the NIdM_Driver_SCIM.zip file to a temporary location on your computer.

  2. To install the driver files as a root user, for IDM 4.7.4 and above:

    1. On the server where you want apply the driver jar file, log in as root.

    2. Navigate to the extracted NIdM_Driver_SCIM.zip directory and perform one of the following actions for your platform:

      • Linux: Install the new netiq-DXMLscim.rpm in your driver installation directory by running one of the following command in a terminal window:

        • If you are installing the binary, run the command: rpm -Ivh (binaries-path)/netiq-DXMLscim.rpm

      • Windows: Copy the SCIMShim.jar file to the driver’s installation folder. For example, \NetIQ\IdentityManager\NDS(local installation) or \Novell\RemoteLoader\64bit (remote installation).

  3. (Conditional) To update the driver files as a non-root user:

    1. Verify that the /rpmdirectory exists and contains the _db.000 file.

      The_db.000 file is created during a non-root installation of the Identity Manager engine. The absence of this file indicates that the Identity Manager is not installed properly. In such a case, reinstall the Identity Manager to correctly place the file in the mentioned directory.

    2. To set the root directory to the location of non-root Identity Vault, enter the following command in the command prompt:

      ROOTDIR=<non-root eDirectory location>

      This command sets the environmental variables to the directory to the location where the Identity Vault is installed as a non-root user.

    3. To install the driver files, enter the following command:

      For example, to install the SCIM driver rpm, use this command:

      rpm --dbpath $ROOTDIR/rpm -Ivh --relocate=/usr=$ROOTDIR/opt/novell/eDirectory --relocate=/etc=$ROOTDIR/etc --relocate=/opt/novell/eDirectory=$ROOTDIR/opt/novell/eDirectory --relocate=/opt/novell/dirxml=$ROOTDIR/opt/novell/dirxml --relocate=/var=$ROOTDIR/var --badreloc --nodeps --replacefiles /home/user/netiq-DXMLscim.rpm

      NOTE:In the above command /opt/novell/eDirectory is the location where non-root Identity Vault is installed, and /home/user/ is the home directory of the non-root user.

  4. (Conditional) If the driver is running locally, start the Identity Vault and the driver instance.

  5. (Conditional) If the driver is running with a Remote Loader instance, start the Remote Loader instance and the driver instance.

1.1.2 Extending eDirectory (Identity Vault) Schema

You can upload new attributes through the Identity Vault to extend the SCIM schema.

  1. Copy the following schema file to the system where Identity Manager is installed.

    For example, /root/schema/scim-schema.sch

  2. Run the following ndssch command.

    ndssch [-h hostname[:port]] [-t tree_name] [-d] admin_FDN schemafile [schema_description]

    For example, ndssch -h 10.71.131.123:524 -t SLES12SP3_Quality_131123_TREE -d admin.sa.system /root/schema/scim-schema.sch scim-Group

  3. The log file is created in the default location, i.e /root/schema.log for troubleshooting.

    NOTE:You must restart the Identity Vault to see the schema changes.

1.1.3 Installing the Driver Packages in Designer

You must install the SCIM Base and SCIM Default and the configuration packages of the Keeper application mandatorily. The required packages and the versions to be installed are as follows:

  • SCIM Base Package:

    • Package Name: NETQSCIMBASE

    • Version: 1.0.0

    • Build Date: 20200812

    • Build Number: 172426

  • SCIM Default Package:

    • Package Name: NETQSCIMDCFG

    • Version: 1.0.0

    • Build Date: 20200806

    • Build Number: 185236

  • SCIM JSON Package (Optional):

    • Package Name: NETQSCIMJSON

    • Version: 1.0.0

    • Build Date: 20200721

    • Build Number: 184051

  • SCIM KeeperSecurity Configuration Package (Mandatory):

    • Package Name: NETQSCIMKSCG

    • Version: 1.0.0

    • Build Date: 20200806

    • Build Number: 185253

For more information to install the SCIM driver packages in the Designer, see SCIM Driver Packages in NetIQ SCIM Driver Implementation Guide.