4.1 Select Domain

By default, ConsoleOne must be connected to a GroupWise domain in order for you to administer your GroupWise system. Being connected to a GroupWise domain ensures that information is replicated not only in Novell eDirectory but also in the GroupWise domain and post office databases.

4.1.1 Selecting a Domain to Connect To

You can be connected to any domain in the GroupWise system. Being connected to a domain means that ConsoleOne has write access to the domain database (wpdomain.db).

As shown in the following example, the domain to which you are currently connected is indicated by a plug on the domain’s icon. In addition, the connected domain is listed at the bottom of the ConsoleOne window.

ConsoleOne Window Showing the Domain You Are Connected To

To change the domain to which you are connected:

  1. In ConsoleOne, click Tools > GroupWise System Operations > Select Domain.

    GroupWise Administrator dialog box
  2. Browse to and select the domain directory, then click OK to connect to the domain.

    You can also connect to a domain by right-clicking the domain in the GroupWise View and clicking Connect. However, in certain cross-platform situations, the Select Domain feature must be used to create the connection.

4.1.2 Understanding the Need for Domain Connections

Some administrative tasks require you to be connected to a specific domain but others do not. In general, operations that create new GroupWise container objects or delete GroupWise container objects require you to be connected to the domain where the object resides. Operations that add or delete leaf objects or modify the properties of an existing object do not require you to be connected to the object’s domain.

In addition to eDirectory considerations, administrative tasks that require file system access to domain directories require direct connections.

  • Create Domain: When you create a new domain, you must be attached to the primary domain and have direct access to the server where you want to create the new secondary domain so that ConsoleOne can create the new secondary domain database.

  • Rebuild Domain Database: When you rebuild a secondary domain database, ConsoleOne needs direct access to the primary domain in order to rebuild the secondary domain database.

  • Sync Primary with Secondary: If your primary domain becomes out of date for some reason, ConsoleOne requires direct access to the primary domain and a secondary domain in order to update the data in the primary domain database based on the data available in the secondary domain database.

  • Replace Primary with Secondary: If you have structural problems with your primary domain database, ConsoleOne requires direct access to the primary domain and a secondary domain in order to reconstruct the primary domain database from the data available in the secondary domain database.

  • Merge/Release: If you are combining or separating GroupWise systems, ConsoleOne requires direct access to the primary domain and a secondary domain that is being merged or released.

4.1.3 Handling Cross-Platform Domain Connections

How the write access between ConsoleOne and a domain database is achieved depends on the platform where you are running ConsoleOne and the platform where the domain is located.

ConsoleOne Platform

Domain Platform

Connection Options

Linux ConsoleOne

Linux server

Local directory

Mounted file system where the mount point directory matches the domain directory on the mounted file system

 

Windows server

Mounted file system where the mount point directory matches the Windows server hostname and share

Windows ConsoleOne

Linux server

Samba mount where the path to the domain on the Linux server is prefixed by the Linux server hostname from the point of view of ConsoleOne

 

Windows server

Local drive

Mapped drive

Instructions for mounting file systems and setting up Samba shares are provided in Section 2.0, ConsoleOne Administration Tool.

The database location is stored internally in UNC path format (\\server\volume\directory) but is displayed on the Domain object Identification page in ConsoleOne based on the platform of ConsoleOne and the database location.

ConsoleOne Platform

Domain Platform

Database Location

Linux ConsoleOne

Linux server

/domain_directory

 

Windows server

/mnt/windows_server/share/domain_directory

Windows ConsoleOne

Linux server

\\linux_server\domain_directory

 

Windows server

\\windows_server\share\domain_directory

When you click Connect in the GroupWise View, ConsoleOne uses the domain’s UNC path to automatically connect you to the correct domain if possible; otherwise, you must use the Select Domain feature to manually browse to and select the domain database in order to connect to the domain.