Novell is now a part of Micro Focus

Installing GroupWise 7 on OES Linux

Novell Cool Solutions: AppNote
By Dave Simons

Digg This - Slashdot This

Posted: 28 Nov 2006


This AppNote explains how to set up a GroupWise system on a default OES Linux server. This document assumes that you have done a basic installation of an OES Linux server, with eDirectory installed on it.

Before you begin, make sure you have installed ConsoleOne on your OES Linux server. For instructions on how to do that, refer to TID 2972250 in the Novell Knowledge base.

Preparing for Database Installation

1. After you have installed ConsoleOne you need to create an OU where you will later install the GroupWise object. I Created a GroupWise OU under "Disney".

Figure 1 - Creating the OU for the GroupWise object

After you done this, one of the first things you need to think about is where to install the GroupWise database. The database will contain the Domain, Post Office, and the Software Distribution Directory (SDD). In my example, I will show you how to make a 5GB ReiserFS file system to accomplish this.

2. Make the ReiserFS file system, ensuring that you have adequate disk space for it.

To create a filesystem, you will need to use the YaST Partitioner.

3. Open YaST from the main menu.

4. In Yast, open the system sub-menu where you find the Partitioner.

Figure 2 - YaST Partitioner

5. Click Partitioner and then click Apply when the warning message appears. In my case I have a 5GB Disk that appears in the Partitioner as "/dev/sdb", as shown below.

Figure 3 - Partitioner Disk

6. Click Create to create a partition where the GroupWise database will reside.

Figure 4 - Creating the partition for the GroupWise database

7. Select the second disk and continue by clicking OK.

Figure 5 - Selecting the second disk

8. To create a Primary partition, click OK in the next screen also.

9. In this screen, edit the items as necessary to control who will access the disk later (see the screen shot below).

Figure 6 - Editing the access details

In my example, the disk is formatted as an ReiserFS File System (default). I will change the size of the disk to 5GB and the mountpoint to "/mail".

10. Click OK to save these settings.

11. To create the disk, click Apply in the main Partitioner screen. You are then asked if you are sure you would like to create the partition.

12. Click Finish to create the disk for your GroupWise database.

The next thing to do is create your GroupWise system, so let's continue.

Creating Your GroupWise System

First, be sure that you load the GroupWise Administration CD on your OES system. To begin the installation, you need to start the file in the root if the GroupWise Administration CD.

1. Open the file browser and browse to the /media/cdrom directory.

Figure 7 - /media/cdrom directory

2. Click Install. The first GroupWise installation screen appears.

Figure 8 - GroupWise installation screen

3. Click OK. We a making a simple GroupWise system here, so clustering is not an issue.

4. Click Create or click Upgrade an GroupWise system, depending on whether this is a new install or upgrade.

5. Click Next.

Figure 9 - Intyroduction screen

6. Read and check the license agreement, then click Next.

Now you can give the path where the Software Distribution Directory should be placed. I always copy it near the Domain and Post Office database, so at this point we'll use the filesystem we just created.

7. Change the path from "/opt/novell/groupwise/software" to "/mail/groupwise/software" as shown below.

Figure 10 - Pointing to the new filesystem

8. Click Next to continue.

9. Select the agents you would like to copy in the SSD (I always select them all):

Figure 11 - Copying agents

10. Click Next.

All the files needed for the GroupWise installation are copied to the SDD. This can take a while - time to get a cup of coffee, I'd say.

Figure 12 - Copying GroupWise installation files

11. When the screen says the copy is complete, click Next.

12. Pay close attention to this next screen! Click Install New GroupWise System here; this is the second option.

Figure 13 - Install New GroupWise system

13. Click Next.

14. In the window that appears, click Run.

This will start ConsoleOne, and now you are ready to configure the GroupWise system. This screen will appear normally if you are not authenticated to the tree.

Figure 14 - Setup instructions

15. Make a note to follow the instructions to configure the GroupWise system when it comes up; then click OK.

16. Click Next.

Figure 15 - GroupWise Setup Progress screen

The next screen shows the path to the earlier created SDD "/mail/groupwise/software" (Software Distribution Directory).

17. Accept the defaults and click Next.

17. Select the TREE to install the GroupWise system in. In my case this is the DISNEY_TREE.

Figure 16 - GroupWise Tree

18. Click Next twice to extend the schema.

19. Enter the name of your GroupWise system and click Next.

Figure 17 - Name of GroupWise system

20. Enter the name of your domain and click Next.

Figure 18 - Domain name

21. Enter the path where the domain database will be installed, then click Next.

Figure 19 - Path to domain database

22. Select the context where all the GroupWise objects will be created, then click Next.

Figure 20 - Context for GroupWise objects

23. Select the languages to be used, then click Next.

Figure 21 - Language selection

24. Select the Time Zone and click Next.

Figure 22 - Time Zone selection

Now you will enter the settings for the Post Office you are going to create.

25. Enter the name of the Post Office and click Next.

Figure 23 - Post Office name

26. Enter the path where the Post Office database will be installed, then click Next.

Figure 24 - Path to Post Office

Dialogs will appear, similar to the ones you saw for the Domain.

27. Click Next until you see the Post Office Link screen.

28. Choose the best setting and click Next.

Figure 25 - Post Office link screen

29. Enter the IP address or DNS name of the server you are installing the system Post Office agents on. In this example, this is the same server we created the mail filesystem on, so it would be

Figure 26 - Location for Post Office agents

30. Click Next. None of the ports that are giving by default are used in a default OES install, so I leave them as they are.

31. Enter the IP address for the MTA Network and click Next.

Figure 27 - MTA Network address

32. Select a user who must have a GroupWise account (normally I select the admin user here), then click Next.

Figure 28 - User account setup

We're almost done!

33. Click Next to create the system.

Figure 29 - Creating the GroupWise system

A summary page appears.

34. Click Next to accept all the settings you made earlier.

Figure 30 - Accepting settings

After a while, the following screen appears:

Figure 31 - "Please Wait" screen

You have now installed your GroupWise system, but there's more ...

35. Click Next to install the agent the system in running on.

Figure 32 - Installing the agent

36. Click Finish in this dialog.

The following screen appears:

Figure 33 - Introduction, Agents Configuration

37. Click Next, and a GroupWise Mobile Server message comes up.

38. Click OK to display this screen:

Figure 34 - Configuration Complete screen

39. Normally you would want to start the GroupWise system when your OES Linux server is being started. Make sure to select this option, then click Exit.

Now you have fully installed a GroupWise system on an OES Linux server. If you're a Netware administrator, you can check the agent screen to check if everything is running fine.

Checking the Status of the GroupWise Agents

1. Log in to a terminal window as "user root" and browse to "/etc/init.d".

2. To check the status of the GroupWise agent enter:
./grpwise status

Figure 35 - GroupWise agent status

Now you see that both the Post Office and the Domain are running perfectly, but still you don't see the agent screen you used to see in NetWare.

3. Shut down the GroupWise system by entering "./grpwise stop" in the "/etc/init.d" directory.

Figure 36 - Stopping GroupWise

As you can see, both the agents are shutting down now. To start the agent, with NetWare Screens, enter the following commands in the Shell console.

5. First, browse to the agent directory:
cd /opt/novell/groupwise/agents/bin/

6. Then enter:
./gwmta ?show @dom1.mta &

Figure 37 - Configuration Complete screen

When you hit Enter, the Agent screen comes up.

Figure 38 - Agent screen

7. To start the Post Office Agent (POA) screen, enter: ./gwpoa -?show @po1.poa &

This will bring up the POA Screen:

Figure 39 - POA screen

Now that the whole system is running, you can connect to the world's best mail system, from a GroupWise client from any operating system you installed it on.

Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions.

© Copyright Micro Focus or one of its affiliates