Reinitializing the Mobility XE Warehouse

Technical Note 2222

Last Reviewed 08-Dec-2009
Applies to:
Mobility XE Warehouse

Summary

Under certain conditions the Mobility XE primary warehouse will need to be reinitialized. Refer to the list below to see if your primary warehouse meets any of these conditions.

If your warehouse was installed with Mobility version 9.0 or higher (i.e. is already version 6.3.1 of the Sun Directory Server), skip directly to Section 2 below for information and instructions on reinitializing your primary warehouse.

Brand-new installations of the Mobility XE System (Mobility server and Mobility warehouse) do not need reinitializing.

Standby Warehouse Note: This procedure does not apply to standby warehouses. It applies only to the primary warehouse. If you need to resynchronize your standby warehouse(s) with the contents of the primary, contact technical support.

Determining if reinitialization is required

If your primary warehouse meets any of these conditions it should be reinitialized. Follow the instructions in the Reinitializing the Mobility XE warehouse section below.

• If you are upgrading your Mobility XE server(s) you may receive a popup message directing you to this tech note. You should reinitialize your primary warehouse after you have upgraded the first Mobility XE server in your pool, as follows:

  • After the first server upgrade is complete, reboot the server machine as instructed. After the server machine has rebooted, reinitialize your primary warehouse according to the instructions in this tech note.

  • If you are upgrading an SDS (Small Deployment Server) installation, all system components will be upgraded first. You will be able to reinitialize the warehouse after the entire upgrade has completed. Note: If you are upgrading your SDS to Mobility version 9.0, then after the upgrade has completed you will be running the new version of the warehouse (version 6.3.1). Skip to Section 2 below for reinitialization instructions.

  • You should also check that the Mobility XE server has restarted by opening the Services control panel (Start->Settings->Control Panel->Administrative Tools->Services) and verifying that the NetMotion Control service is running and has been set to Automatic.

• If a Mobility XE server reports it is unable to connect to the warehouse, open the Startup Settings utility and click on the Mobility Warehouse tab. If you see a message similar to "NM_LDAP_DIRECTORY_MISMATCH", your primary warehouse should be reinitialized.

  Exception: If you are running Mobility version 8.5, and you upgrade the warehouse to version 9.0 (Sun Directory Server 6.3.1) but you do not also upgrade the Mobility server(s) to version 9.0, you will not resolve this error by reinitializing your primary warehouse. See http://www.netmotionwireless.com/support/technotes/2196.aspx for instructions.

• If the Mobility console is not displaying all the correct information about your servers, devices, and/or users, reinitialize your primary warehouse.

• If you have promoted a standby warehouse to be a primary warehouse, it must be reinitialized after it has been restarted.

When restoring an LDIF file from a Sun 5.2 warehouse into a Sun 6.3 warehouse. Attach a new Mobility server 9.0 first to this restored warehouse, then reinitialize the new warehouse immediately. 

Section 1: Reinitializing the Mobility XE Warehouse - Applies to Sun Directory Server 5.2.4

There are three parts to reinitializing the Mobility XE warehouse. The first part involves making a backup copy of the warehouse data. The second part involves stopping the Directory Server and exporting the data. The third part involves reinitializing and importing the data and then restarting the Directory Server.

Part 1 describes how to back up your warehouse data. Part 2 describes how to perform reinitialization by downloading and running a script (the recommended method). If you need to perform reinitialization manually, Part 3 describes how to do so.

Section 2 is for version 9.0 only; it describes how to use the Warehouse Management Tool to perform the reinistialization.

Part 1: Backing up the warehouse

NetMotion recommends always backing up the Mobility warehouse before performing any operation on it. See Tech Note 2129 for instructions on how to back up your warehouse.

Part 2: Performing reinitialization via a script

1. Click here to download the reinitialization script (reinit.zip).

2. Unzip the reinit.zip file into reinit.bat and copy or move it into the directory where your Mobility warehouse resides. The default location is C:\Program Files\Sun\MPS\slapd-[servername]. If you have installed the Mobility warehouse into a non-default location you must find the location of the Sun\MPS\slapd-[servername] directory and move the file there.

3. Open a command prompt window and change directory to this directory location.

4. Run the file by typing "reinit" at the command prompt (do not type the quotation marks).

The command prompt window will display the progress of the script.

If you performed the steps in Section 2 above to run the reinitialization script, the process is complete. Do not go on to Section 3 or 4.

Part 3: Performing reinitialization manually

Only perform these steps if you did not choose to run the reinitialization script (Section 2 above).

Step 1: Manual reinitialization: Exporting the warehouse data

Perform these steps to stop the Directory Server and then export the warehouse data to an ldif file.

1. Log into the machine where the warehouse is installed.

2. Open a command prompt window and navigate to the warehouse directory. The default location is C:\Program Files\Sun\MPS\slapd-[servername]. If you have installed the Mobility warehouse into a non-default location you must find the location of the Sun\MPS\slapd-[servername] directory and navigate there.

3. Enter the following two commands:

   • stop-slapd

   • db2ldif -n userroot -r -a c:\nmbackup.ldif

Step 2: Manual reinitialization: Importing the warehouse data

Perform these steps to reinitialize and import the nmbackup.ldif file you created in Step 1 and then restart the Directory Server.

1. Important: The path to the nmbackup.ldif file must be an absolute path with no spaces in it. The path must also be in quotes.

   From the same directory, run the following two commands:

   • ldif2db -n userroot -i "c:\nmbackup.ldif"

   • start-slapd

2. Close the command window.

Section 2: Reinitializing via the Warehouse Management Tool - Applies to Sun Directory Server 6.3.1 (Mobility version 9.0)

If you have upgraded your Mobility XE installation to version 9.0 and you have migrated your primary warehouse to version 6.3.1, you can use the Warehouse Management Tool to perform reinitialization.

1. On the machine hosting your version 6.3.1 warehouse, go to Start->NetMotion->Warehouse Management Tool.

2. Select Reinitialize Warehouse from the tree view.

3. Click the Reinitialize Warehouse button.

Note: This action will also resynchronize your standby warehouse(s) with the primary.