4.6 Post-Installation Tasks

This section outlines tasks you need to complete after a local or remote installation.

4.6.1 Installation on NetWare

If you installed the driver on the a NetWare server, you need to modify the autoexec.ncf file. Open the file and locate the following line:

SEARCH ADD SYS:\GRPWISE\AGENTS

The \GRPWISE\AGENTS directory specifies where the GroupWise agents are installed. Immediately below this line, you should see the following:

  PROTECT SYS:\GRPWISE\AGENTS\GRPWISE.NCF

This SYS line might already exist. If it does, do not add it again, but ensure that PROTECT precedes the command. This loads the grpwise.ncf file into protected memory. The grpwise.ncf needs to run in protected memory.

You should replace \GRPWISE\AGENTS with the path to where the GroupWise agents are installed on your server.

NOTE:If the GroupWise agents are installed in SYS:\SYSTEM, Novell recommends moving the agents to another directory and modifying the autoexec.ncf file accordingly.

4.6.2 Modifying Policies

Before you start the driver and use it to synchronize data between eDirectory and GroupWise, you must modify the driver’s policies and filters for your specific business rules. See Section 6.0, Customizing the Driver by Using Policies and Filters for complete information.

4.6.3 Modifying Global Configuration Values

Before starting the driver, you need to review and make necessary changes to the Global Configuration Values for your environment. For more information Section C.2, Global Configuration Values.

4.6.4 Starting the Driver

In order for the driver to synchronize information, is must be started. To start the driver, see Section 7.10, Starting, Stopping, or Restarting the Driver.

4.6.5 Verifying That the Driver is Working Properly

After the driver is installed, the driver configuration is imported, and the policies have been customized, you should test the driver to see that it is working properly. (For more information on customizing policies, see Section 6.0, Customizing the Driver by Using Policies and Filters.)

Use the following steps to verify that the driver is working properly. When properly installed and configured, the driver synchronizes the changes to GroupWise.

  1. In Novell iManager, click Identity Manager > Identity Manager Overview.

  2. Do one of the following:

    • Click Search Entire Tree to search your entire tree for the Driver set that contains the driver, then click Search.

    • Click Search in Container, enter or browse for and select the container that holds the driver, then click Search.

  3. Click the Identity Manager Driver for GroupWise driver status button, then click Start Driver.

  4. Add a new user to eDirectory.

    You need to specify only the Name and Surname attributes for this user.

  5. Open ConsoleOne with the GroupWise snap-ins.

  6. Verify that a new GroupWise account was created in the correct post office.

  7. Using Novell iManager, delete the user from eDirectory.

    The default driver import file converts eDirectory deletes to GroupWise Disable events. This results in a disabled external user in GroupWise. This can be changed through the global configuration values.

  8. Using ConsoleOne with the GroupWise snap-ins, verify that the GroupWise account is external and disabled (assuming you are using the default configuration).

  9. Use ConsoleOne with the GroupWise snap-ins to verify that the changes have been synchronized with GroupWise.

WARNING:If you create eDirectory users with ConsoleOne, be sure to use ConsoleOne with GroupWise 6.5 or above snap-ins installed. If you are using GroupWise 6.0 or older versions, do not use ConsoleOne with the GroupWise snap-ins to create eDirectory users. The ConsoleOne snap-ins for the older GroupWise version operate after the driver and remove some vital data from eDirectory.

4.6.6 Migrating eDirectory Users to GroupWise

Under most circumstances, eDirectory and GroupWise already contain information prior to the installation of Identity Manager. The Migrate function in Novell iManager lets you select the users in eDirectory, then perform a migration to GroupWise. You can use the migration function to establish the initial association between eDirectory and the GroupWise driver. The driver does not work properly unless you do this. You should also complete a migrate operation if the driver or driver set name changes.

The migration option in iManager lets you select individual users to migrate from eDirectory into GroupWise. For more information about the synchronization process, see Section 8.0, Synchronizing Objects. The Metadirectory engine applies all Matching, Placement, and Creation policies and the filter to the objects that you choose to migrate.

To migrate eDirectory users to GroupWise:

  1. In Novell iManager, click Identity Manager > Identity Manager Overview.

  2. Browse to and select the driver object to which you will be migrating data.

  3. Click Migrate > Migrate from Identity Vault.

  4. Click Add, then select the container or user objects you want to migrate.

  5. Click OK.

When using this functionality, take into consideration any global configuration setting that controls whether or not GroupWise accounts are created for selected users who don’t already have an account.