Setting Up a Connection between Windows and Linux

If you are migrating from Exchange to GroupWise on Linux, you must create the proper connection between the Exchange server and a Linux server where a GroupWise domain directory is located before you start the Migration Utility. Linux provides a configuration called a Samba share that allows a Linux file system to appear like a Windows disk drive from the point of view of your Exchange server.


Configuring the Samba Share for Your GroupWise Domain Location

Windows workstations use the Server Message Block (SMB) and NetBIOS protocols for sharing drives. By configuring your Linux server to support these protocols, your Windows workstation can access your Linux server as if it is a shared drive.

  1. On the Linux server, add the user that you plan to log in as when you run the Migration Utility.

    You set up this user on the Windows side in Designating a Service Account Administrator on Exchange 5.5 or Ensuring Administrative Rights on Exchange 2000/2003. Now you are setting up the user on the Linux side. Use the same username on Linux as you used on Windows. The steps below provide an example.

    1. In a terminal window, log in as root.

    2. Enter the following command to create the user:

      useradd -mg root username

    3. Enter the following command to assign a password to the user:

      passwd username

      Use the same password on Linux as you used on Windows.

    4. Enter the password, then enter it again for verification.

  2. Add the user and password to the list of users that can authenticate to the Samba server, for example:

    1. Enter the following command:

      smbpasswd -a username

    2. Enter the password, then enter it again for verification.

  3. Start the Samba server, for example:

    1. Change to the /etc/rc.d directory.

    2. Start the NetBIOS daemon:

      ./nmb start

    3. Start the Samba daemon:

      ./smb start

      If a message notifies you that the daemon is already running, stop and then start it to pick up the new username and password information.


Testing the Samba Share Access from Windows

After you have configured the Samba share on the Linux server, you should test it on the Windows workstation or server where you plan to run the Migration Utility.

  1. Map a drive to the Linux server, for example:

    1. Right-click My Network Places, then click Map Network Drive.

      IMPORTANT:  Do not use Novell Map Network Drive. The Samba share is set up to work with Windows, not with the Novell ClientTM.

    2. Select a drive letter.

    3. In the Folder field, specify the IP address of the Linux server and the Linux username you created in Step 1.b in Configuring the Samba Share for Your GroupWise Domain Location, for example:

      \\172.16.5.18\gwmigrate

    4. Click Finish.

    5. When prompted, provide the username and password established in Step 1.b and Step 1.c in Configuring the Samba Share for Your GroupWise Domain Location.

    This shows that the Samba share is working correctly from the Windows operating system level.

  2. Start ConsoleOne and authenticate to the eDirectory tree where your GroupWise system is located.

  3. Connect to the GroupWise domain on the Linux server.

    1. Click Tools > GroupWise System Operations > Select Domain.

    2. Browse to and select the domain database (wpdomain.db) on the Linux server, then click Open.

    3. Click OK to connect to the domain.

If you connect to the domain successfully, then the Migration Utility can successfully migrate users from your Exchange system to GroupWise on Linux. If you cannot connect to the domain successfully, the migration from Exchange to GroupWise on Linux cannot succeed. Some Linux Samba servers require more stringent authentication than others. You can find assistance with setting up the connection between Windows and your Linux server from the following resources:

The connection must be set up correctly before you start the migration process.