How to create a Secondary Domain on Linux

The GroupWise system is in a pure Linux environment. A Secondary Domain needs to be created. According to best practices, each Domain should reside on it's own server. In order to create a Secondary Domain, ConsoleOne needs to be connected to the Primary Domain.

There are different methods that can be used to create the Secondary Domain; using Samba or NCP to connect a Windows workstation, or create the Secondary Domain on the server that has the Primary Domain and use the scp command to copy the database to the other server.

If Samba or NCP are not configured on both servers, the easiest way to get a Secondary Domain created is to create it on the Primary Domain server, then copy the domain database to the other server using the scp command. To accomplish this, use the following steps:

Create the Domain Database

1. Log in to the server with the Primary Domain as root (either at the console, using VNC or ssh -x).
2. Create a temporary directory for the Secondary Domain. For example, if you have a partition named /gw create a new subdirectory called /gw/newdom.
   
3. Start ConsoleOne (/usr/ConsoleOne/bin/ConsoleOne).
4. Make sure you are connected to the Primary Domain.
5. In the eDirectory View, browse to and right click on the container where you want to create the domain.
6. Click New Object, and in the new object dialog box, select GroupWise Domain.
   
7. Fill in the fields in the Create GroupWise Domain dialog box. For domain database location, select the directory created in the step above.
   
8. Follow the on-screen instructions to configure the links to existing domains. Make sure to use the IP address of the server that will hold the Secondary Domain after it is copied.
   
9. Close ConsoleOne.

Copy the database to the other server.

1. Start a terminal session.
2. Use the scp command to copy the file to the other server. In this example, the current location of the database file is /gw/newdom, the location on the new server will be the same (gw/newdom), and  the address of the secondary server is 10.1.1.20. The syntax would be:
   scp /gw/newdom/wpdomain.db root@10.1.1.20:/gw/newdom/wpdomain.db
3. You may get a message that says the authenticity of the host cannot be established, answer yes to continue.
4. When prompted, enter the password for root on the secondary server.
5. The copy process will show the filename, amount copied, the size of the file, etc.
   

Verify the configuration of the new Domain Database.

1. Log in to the secondary server as root (either at the console, using VNC or ssh -x).
2. Copy the *.dc files from the domain directory under the software distribution directory to the directory with the new domain database.
   
3. Start ConsoleOne and authenticate to NDS as admin.
4. Select the GroupWise System, the click on Tools | GroupWise System Operations |Select Domain.
5. Browse to the domain database that was just copied over, and click OK.
6. Right click on the new domain and select Properties .
   
7. On the GroupWise tab, select Identification and change the unc path to reflect the local path.

Clean up the old database files (so ConsoleOne cannot accidentally connect to it).

1. Log in to the server with the primary domain as root.
2. Delete the directory (and all it's contents) that was used to create the secondary domain.
   

If Samba is installed or NCP enabled on both servers, a windows workstation could be used to create the secondary domain.

1. Before using a Windows workstation to connect ConsoleOne to a Domain on a Linux Server, follow the instructions in KB 3777653.
2. From the Windows workstation, map a drive to the server and directory that has the Primary Domain.
   
3. Map another drive to the server and directory that will hold the new Secondary Domain.
4. Start ConsoleOne and connect to the Primary Domain.
5. In the eDirectory View, browse to and right click on the container where you want to create the domain.
6. Click New Object, and in the new object dialog box, select GroupWise Domain.
   
7. Fill in the fields in the Create GroupWise Domain dialog box. For the database location, select the drive mapped to the Secondary Domain server, and the proper subdirectory.
8. Follow the on-screen instructions to configure the links to existing domains.  Make sure you use the IP address of the server that holds the Secondary Domain.
   
9. Verify the configuration of the new Domain Database.
10. 1. Log in to the secondary server as root (either at the console, using VNC or ssh -x).
    2. Start ConsoleOne and authenticate to NDS as admin.
    3. Select the GroupWise System, the click on Tools | GroupWise System Operations |Select Domain.
    4. Browse to the domain database that was just installed, and click OK.
    5. Right click on the new domain and select Properties .
       
    6. On the GroupWise tab, select Identification and change the unc path to reflect the local path.

For creating a domain when there is a mixed environment (Windows, or NetWare with Linux) see TID 10101011
For more information on supported methods for administering GroupWise on Linux, see KB 7002459