The purpose of this document is to dig deep into the SetupIP functionality, showing the reader how to use this most effectively in their environment. Some information found in here, is even undocumented.
The stuff revealed in this document, is based on a session I did at the Open Horizons Summit 2008 named "Digesting the GroupWise 8 Windows Client", where I was digesting the different ways to install a GroupWise Client.
Since then, I've been working even more with SetupIP, and by using FileMon and RegMon etc, I came across additional information, which I believe could be useful for the community.
SetupIP is a utility provided with GroupWise, which allows you to install a GroupWise Client on a workstation without the need to access a fileserver. All that is needed is a web server.
The way it works is the Administrator generates a file named setupip.exe using a tool named writeip.exe, that can be found in the <Software Distribution Directory>\admin\utility\setupip.
After being generated, SetupIP.exe is a launcher for the install with embedded information about how the setup should take place.
Setupip.exe will, when executed on the workstation, launch an http connection with the web server and start the install.
The files that are needed to install the GroupWise Client are:
The best part about SetupIP is, if it is aborted some how, it can continue where it stopped.
The details are like this:
When SetupIP.exe is launched, it'll download files from the webserver and extract them. After that is done, setup.exe will be launched.
In short, SetupIP is a frontend to Setup.exe.
Setup.exe is controlled by the file setup.cfg and setup.ini files, that needs to be present in the win32 directory.
Setup.exe is also, funny enough, a frontend for the GroupWise.msi file.
As said, make sure that Fancy Indexing is enabled for the directory. In this example I'll use a directory named "gwclient". This is where you are going to put the needed files.
Files layout is as follows:
<Document Root Directory (htdocs)>
<win32> This directory is optional, but handy. I'll talk about this later.
Above is all that is needed on the web server.
If you place a directory named win32 in the gwclient directory, setupip will detect it. Any files placed in the win32 directory will override the files embedded into the setupip.fil and setupip.<language code>
As such, if you get an FTF file from Novell, you simply put it into the win32 directory, and it will be installed when running setupip.
However, most of the time this is used to make the installation unattended, by applying a setup.cfg file and a setup.ini file.
Writeip.exe is the utility used to create the setupip.exe file.
Simply launch it, and fill in the GUI with the relevant info.
After this is done, two files are created in the same directory as the writeip.exe file.
Now try and open the writeip.ini file with a text editor like Notepad.exe.
It might look something like this, with the exception of the lines in bold:
; EnableLogging =Yes
The entries in bold (above) are undocumented configuration options, which you can use. So let's take them one by one.
; EnableLogging =Yes
This will enable logging, and is by default not enabled, but might be useful during troubleshooting.
The logfile will be located in the root of the windows directory, and is called SetupIP.log.
This will allow SetupIP to reboot the workstation if a file that needs to be updated is locked.
After the restart, SetupIP will continue.
This determines whether or not you will be able to select among the languages that are present on the webserver.
If this is set to no, all languages available on the webserver will be downloaded to the workstation and made available to setup.exe.
So….Wanna put some undocumented stuff into action?
If so, then know, that they are undocumented for a reason……They haven't yet received the official blue print, so use at your own risk….
How to do this?
Launch WriteIP.exe, and fill out the stuff you need, and save it.
After that, open up WriteIP.ini, and using notepad or siml. Tool, add the stuff you need.
Now run WriteIP.exe again, and save the stuff…..
Your new undocumented switches are now part of the SetupIP.exe file.
So, if you have users, that aren't members of the Administrator group on your XP workstation, and they still need to install or update the GroupWise client, I've written a small utility, that might help you with this….
Besides that, I'm currently digging futher into the gems of the SetupIP tool, and if I find anything futher, I'll be back….
Take care, and hope that this article has made you GroupWiseR