Novell is now a part of Micro Focus

Distributing the GroupWise Client via SETUPIP

Novell Cool Solutions: Feature
By Tay Kratzer

Digg This - Slashdot This

Posted: 5 Jul 2006

In light of the recent interest that customers have had in updating the GroupWise client, I thought I would offer a solution for installing the GroupWise client that I find many administrators are not aware of. This method of installing the GroupWise client is called SETUPIP. I configured SETUPIP at one customer site just this week, and have my notes fresh for this article. My notes are based up GroupWise 7 Support Pack #1; however, they most likely apply to GroupWise 6.5.x also, however I have not tested them with that environment.

Many customers (such as those using ZENworks), already have an automated solution for distributing the GroupWise client. However a discussion of SETUPIP is relevant to any GroupWise customer, even if it is only used as a niche installation solution.

Let me explain how this one particular customer uses SETUPIP in their environment. Many desktops are managed by ZENworks, which is a great solution for rolling out the GroupWise client. However, at this organization a pretty large subset of users just work from home or on the road and have the GroupWise client on their laptops or home computers. These computers are not managed by ZENworks. When these users need to upgrade, the administrator sends them a URL to an *.exe file. The users click the URL and run the file, and the GroupWise client is installed via SETUPIP.

If this idea sounds attractive to you, then read on!

Making a GroupWise SETUPIP installation set requires the following infrastructure:

  • The SETUPIP Server
  • The SETUPIP Client

This may sound like something complicated, but it's not; you are generally just leverage your existing architecture to configure SETUPIP. Below are the complete instructions for doing this. For a more complete discussion of SETUPIP, you can reference Chapter 12 of the Novell GroupWise 7 Administrator Solutions Guide.

Configuring the SETUPIP Server

1. Choose a web server that will act as the SETUPIP Server.
a. The web server must support port 80 access.
b. The web server can support other web server functions.
c. In this example we will demonstrate using a NetWare 6.5 server.

2. From the web server's root document directory, make a directory that will host the SETUPIP service. For example, on our NetWare 6.5 server that runs Apache 2.x, the directory will be created in the "htdocs" directory:

\\<The NetWare Server>\sys\Apache2\htdocs

For example, we might call the directory "gw701", so the path we created to host the SETUPIP service is:


3. Create a Win32 directory under the path mentioned above - for example:

\\<The NetWare Server>\sys\Apache2\htdocs\gw701\win32

4. In your GroupWise Software Distribution Directory, locate the following two files:

(in my customer's example, this was called

We located these files in the following location:

<Path to the GroupWise 7 SP1 SDD>\admin\UTILITY\SETUPIP

5. Copy the setupip.fil and setupip. file to the "gw701" directory. So now we have the following contents in the directory:

\\<The NetWare Server>\sys\Apache2\htdocs\gw701


6. In your GroupWise Software Distribution Directory, locate the following two files:

  • setup.cfg
  • setup.ini

We located these files in the following location:

<Path to the GroupWise 7 SP1 SDD>\client - This is where the setup.cfg file is.
<Path to the GroupWise 7 SP1 SDD>\client\win32 - This is where the setup.ini file is.

7. Copy the setup.cfg and setup.ini file to the "..\gw701\win32" directory on the web server. So now we have the following contents in the directory:

\\<The NetWare Server>\sys\Apache2\htdocs\gw701\win32


8. Modify the setup.ini file to specify the default language as needed.

9. Modify the setup.cfg file to specify installation preferences as needed. For example, I like to modify the setting:
ShowDialogs=Yes to read ShowDialogs=No

Configuring the SETUPIP Client

1. Browse to your GroupWise Software Distribution Directory's SETUPIP directory. In our example this was located at:

<Path to the GroupWise 7 SP1 SDD>\admin\utility\setupip

2. Run the utility "writeip.exe"

3. Specify in the IP address field the DNS or IP address of the server that is hosting the SETUPIP service. Include the root path of the SETUPIP service directory. In our example, this is what we specified:

All other options in the WriteIP utility are generally kept the same, unless you are doing more advanced things.

4. Click OK to save your changes. When you do this, a new file will be created in the ..\utility\setupip directory. It's a self-executing file called: setupip.exe

The setupip.exe is the SETUPIP Client. If you run this utility, it should download and install the GroupWise client from the SETUPIP Server. The setupip.exe file can be renamed to anything you would like. You can then e-mail it to users, or distribute it from a web site.

Given our example environment, if the SETUPIP Client "setupip.exe" file were placed in:

\\<The NetWare Server>\sys\Apache2\htdocs

The URL to the file would be:

You could then make a web page link to the URL, or send the URL in an e-mail message to your GroupWise users.

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

© Copyright Micro Focus or one of its affiliates