2.3 Configuring and Running the SharePoint Driver

You can configure the SharePoint Driver in two ways:

2.3.1 Using the Command Line

  1. Open a command prompt.

  2. Change to the installation directory of the .NET Remote Loader.

  3. Edit the sharepoint-conf.txt sample configuration file from the .NET Remote Loader directory.

    The command line options of .NET Remote Loader are same as the conventional Remote Loader. Detailed options can be seen by running remoteloader.exe without passing any parameters, which opens an HTML help page.

  4. Run the remoteloader.exe -config <configFile> -sp command to set the Remote Loader and the driver passwords.

    The SharePoint driver can be created as an application or service. For creating it as an application or service, you need to set the Remote Loader and the driver passwords.

    Running remoteloader.exe initializes the lcache. It might take a while before the password is requested.

    lcache is required for auditing purpose.

  5. Start this SharePoint instance as an application or service.

    • As an application:

      1. Run the following command:

        remoteloader.exe -config <configFile> 

        The trace is started in the same command window. If you close the command window, the driver stops.

      2. To stop the SharePoint application instance, enter Ctrl + C.

    • As a service:

      1. Run the following command:

        remoteloader.exe -config <configFile> -service

        This starts the .NET Remote Loader service and opens a trace window.

      2. To stop the SharePoint driver service, go to Services, then stop the service.

For more information about Remote Loader, see Configuring the Remote Loader and Drivers in the NetIQ Identity Manager Setup Guide for Linux or Configuring the Remote Loader and Drivers in the NetIQ Identity Manager Setup Guide for Windows.

NOTE:If you run the .Net Remote Loader service with the default user privilege, it does not allow the Sharepoint driver to start and access the Sharepoint site collection. The Remote Loader service must run as User that has Administrator privilege for site collection. This applies for both configuring the SharePoint driver by using the command line as well as the .NET Remote Loader GUI.

2.3.2 Using the .NET Remote Loader Graphical Interface

  1. Browse to the installation directory of the .NET Remote Loader and run rlconsole.exe to open the GUI console. The .NET Remote Loader GUI is similar to the traditional Remote Loader GUI.

  2. Click Add, then specify the parameters in the page that displays.

  3. To configure the SharePoint driver as an application, deselect the Establish a Remote Loader service for this driver instance option.

    The SharePoint driver can be configured as an application or as a service.

  4. Click OK. A prompt appears asking you if you want to start the DirXML Remote Loader. You can start the driver now or later.

    When the driver is started, a trace window opens.