Installing GWIA on OES Linux
Novell Cool Solutions: AppNote
By Dave Simons
Digg This -
Posted: 19 Dec 2006
In this AppNote I will explain how to install GroupWise Internet Agent (GWIA) on an OES Linux Server. Before you can install GWIA, you must have an fully operational GroupWise system. For instructions on how to install a GroupWise system on OES Linux, see my earlier AppNote: http://www.novell.com/coolsolutions/appnote/18153.html
Before we discuss GWIA, let me first tell you this: just as with the GroupWise Webaccess Agent, it srongly recommended to install the GroupWise Internet Agent on a server that also has a GroupWise Domain installed on it. GWIA strongly depends on the wpdomain.db file. If you have the Domain installed on a different server than where you install the GWIA, and the network connection is broken, the GWIA will not function properly any more.
So if you decide to install the GWIA on a dedicated server, is strongly recommend to install a domain on that server as well.
Now it's time to install the group Wise Internet Agent.
1. Insert the GroupWise media CD and browse to the root of the CD.
2. Click Install.
Figure 1 - Language selection
3. Click OK to accept the Default language.
4. Click Install Products.
Figure 2 - Install Products dialog
5. Select "GroupWise Internet Agent".
Figure 3 - GWIA selection
6. Click Install Agent. After a while, the completion screen appears.
Figure 4 - Installation complete
7. Close this screen and then click Configure Internet Agent.
Figure 5 - GWIA configuration
8. Click Next to continue.
9. Click to accept the license agreement, then click Next.
10. Enter the IP address and DNS name of the server that holds the GWIA.
Figure 6 - Server configuration
In my case, I use port 7102. This port is used for a new GroupWise feature that allows the GWIA outbound failover to function.
11. Click Next to save the settings and continue.
The Relay Host dialog appears.
Figure 7 - Relay Host settings
12. Configure settings here to determine how GWIA handles outbound mail - whether it should be sent directly to the Internet or to a relay server.
If you use some kind of content scanner for your mail, then you can supply the IP address or DNS name here. I just send mail directly to the Internet, so I leave the default settings intact.
13. Click Next to save the settings and continue.
14. Enter the Internet Domain name you use.
Figure 8 - Internet Mail Domain Name settings
15. If you have an Internet Domain name (such as "oes.nl"), you can enter it in here. Then your mail address will be something like "firstname.lastname@example.org".
16. Click Next.
17. Provide the Domain directory. In this Directory an Internet Agent directory will be created to spool all the mail that will be handled by the GWIA. In my case, this is the /mail/groupwise/dom1 directory.
Figure 9 - Domain Directory settings
18. Click Next.
19. Enter the LDAP IP address and the FDN of the admin user (in LDAP format). The GroupWise Internet Agent requires access to an LDAP server to authenticate to the eDirectory where the GroupWise system is installed.
Figure 10 - LDAP Authentication settings
20. Click Next.
When your eDirectory login is successful, the following screen appears.
Figure 11 - Gateway Object settings
21. Provide the context where the Internet Agent object will be created.
Normally the GWAI object will be created under the Domain object, so i specify the context of the domain "dom1".
22. Click Next to create the object (this can take a couple of seconds). The following screen appears.
Figure 12 - Configuration Complete dialogYou are prompted whether you would like the GroupWise Internet Agent to start when the system is started. I like this option, so I leave it as default.
23. Click Exit to complete the GroupWise Internet Agent installation and configuration.
Checking the GWIA Object
Now it's time to have a look at the eDirectory object that you created.
1. Open ConsoleOne and browse to the Domain object.
Figure 13 - Domain object in ConsoleOne
You will see that the GroupWise Internet installation has created a GWIA object.
2. Double-click "Up" to see the properties.
If you're not connected to the GroupWise System, you will see this message:
Figure 14 - GroupWise Connection warning
2a. In this case, click next and you will be connected.
The Properties dialog appears, indicating that the installation was successful.
Figure 15 - GWIA Properties dialog
3. Click Cancel to close the dialog.
You need to complete one more task before you can send you mail over the Internet.
4. From the GroupWise view, select the Domain object.
5. Go to Tools > GroupWise System Operations and click Internet Addressing.
Figure 16 - Internet Addressing
6. Configure how GWIA handles your Internet addressing.
You can set how your mail address will be displayed, etc. Just read the Help and you will know what to choose. I would prefer to select only one, so there is no confusion as to what your real mail address is. I select "UserID@Inetnet Domain Name".
One very important field is the Internet Domain Names field. Here you must supply the Internet Domain name that you have given previously when you installed the GWIA. In my case this was "oes.nl".
Figure 17 - Internet Addressing settings
7. When you're done, click OK to save the settings.
Now it's time to start the GWIA.
Starting the GWIA
Just like all other GroupWise Agents, the GWIA runs in the background by default. You can't see what is happening; you can only check if it is running.
To check whether the GWIA is running,
1. Open a terminal window as the Root user.
2. Go to the /etc/ini.d directory and enter "?./grpwise status?"
Figure 18 - Querying GroupWise status
In my case, you see that only the "po1.dom1" and the "dom1" are running.
To start all the other agents as well, you can stop and start the whole GroupWise System, or just start the agents that are not running right now. I will restart the whole GroupWise System to make sure all the agent are properly connected the first time GWIA starts.
3. To restart, enter "./grpwise stop" and then "./grpwise start"
Figure 19 - Restarting GroupWise status
Now all the agents are running perfectly, so I should be able to some mail over the Internet. I only want to see the Agent screen of the GWIA to see what is happening.
4. To start the GWIA with the agent screen, change the directory to ?/opt/novell/groupwise/agents/bin?
Figure 20 - Startiong GWIA
5. Enter "./gwia -show @../share/gwia.cfg &"
The GroupWise Internet Agent will be loaded, and the Agent screen will appear:
Figure 21 - GWIA Agent screen
I always do a brief test to see if the GWIA will accept SMTP connections.
6. Open a terminal window from the server that runs the GWIA and enter:
"telnet 127.0.0.1 25"
Figure 22 - Telnet test command
If the result of the telnet command looks similar to the above example, you know the GWIA is accepting SMTP traffic. Now you should be able to send and receive email from and to the Internet.
Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions. www.webwiseone.com