Upgrading Users with ZENworks Configuration Management

The following information is applicable to ZENworks Configuration Management (ZCM) 10.3 through 11.3. If you have earlier versions of ZCM, these instructions may not work in your environment. We will not cover any other ZCM versions for this guide. Also, we will not cover every permutation of ZCM that you might need for installing GroupWise. If you are using ZCM, we assume you are familiar with the ZCC dialogs, and that you know how to assign your own relationships and requirements to your application bundles. The steps below are only intended to show the part of the ZCM setup that is specific to the GroupWise 2014 client installation.

The first thing that we do when preparing the GroupWise client for ZCM is to generate the GroupWise MST file required for the installation. This is done by using the gwtuner.exe file that is supplied with GroupWise 2014. The gwtuner.exe file is found in both the Linux and Windows distributions in <installationfiles>\admin\utility\tools.

As you can probably see, gwtuner.exe is a Windows application, and it needs access to files from the <installationfiles>\client folders. The Zenworks Control Center needs access to both the <installation files> and the <serverfiles> folders. If your GroupWise server is on Linux, this presents a bit of a complication, because you have not “installed” server files on Windows in order to extract these files. There are a couple of ways to get access to these files for our purposes. A few ideas are:

  • If this is an OES server, place the <serverfiles>/agents/client directory and your <installationfiles> on a NCP accessible drive.
  • Configure SAMBA for shares to the <serverfiles> and <installationfiles> and map drives from Windows to these SAMBA shares.
  • Download the Windows GroupWise full distribution and extract the files by doing the following:
    • After downloading the full Windows distribution zip file, right-click on the file and choose “Extract All” and place it in a directory of your choice. For example c:\temp\gwinstall. This would then serve as your <installationfiles> directory for the rest of this ZCM section.
    • change to this new <installationfiles>\server\win64 directory
    • run setup.exe /extract c:\temp\gwserver (or any location you choose). Use this location as your <serverfiles> location for accessing the required client files.

Our preference is actually the latter. In any event, you must have access from Windows for this process!

  1. Run the gwtuner.exe file. You will see the information in Figure 11-11.

  1. gwtuner1.tiffThe GWTuner Client Directory Window
  2. At this screen, enter the location of your client directory in <installationfiles> folder.
  3. The next screen shows the options for the installation. For our purposes, we wish to have ZCM control the client entirely, so we will go over the options here. In order to allow ZCM to control these options, we are unchecking most of the boxes in the dialog:
  • Install path: Enter your installation path. The default is shown in the figure below.
  • Program folder: This is the name of the Program folder, should you choose to create one (as you will see later, we will not be creating a program folder during our setup).
  • Add GroupWise to the Desktop: If you choose, you can add a GroupWise icon to the desktop during installation. For our purposes this is unchecked, as we will allow ZCM to control this
  • Add GroupWise to the Quick Launch: We can also add an icon to the Quick Launch. We are leaving this unchecked.
  • Add Notify to the Startup folder: We wish to control this with ZCM, so we are leaving this unchecked.
  • Install Internet Browser Mail Integration: This adds “mail to” functionality to your browsers to launch GroupWise when a “mail to” link is clicked.
  • Add icons to the Start Menu: If we leave this checked, the Program folder listed above will be created for the Start Menu.
    1. gwtuner2.tiffThe GWTuner General Settings
  • The next screen will allow you to choose the languages you wish to install. You can, of course, choose as many languages here as you require. If you choose more than one language, the next screen will prompt you for the default language for the installation.
  • When you click Finish, your groupwise.mst file will be created in the win32 directory under the <installationfiles>\client\win32 folder.

Now that our groupwise.mst file has been created, we can configure the ZCM routine to deliver this client to the workstation. Novell has made some modifications to the GroupWise and ZCM settings that allow this to happen with much less work that in past versions. As we saw in the “Upgrading the GroupWise Client with SETUPIP” section above, the GroupWise client for SETUPIP is packaged in a file called setupip.fil that contains the complete GroupWise client for distribution. This is found in your <serverfiles>/agents/data/client/setup/win32 folder. ZCM will be able to use this file, and a few other files to manage the GroupWise installation, rather than thousands of individual files as in the past. The only files we will need for our ZCM repository are setupip.fil, extract_setupip_packs.cmd and the language files we chose in the GroupWise Install Tuner. So, if we had chosen English and German as our languages to install above, we would need to also have setupip.en and setupip.de for our bundle. We will walk through those steps now.

  1. Launch your Zenworks Control Center in your browser, and choose Bundles.
  2. Create a new bundle by clicking on “New” and then choosing “Bundle” and then indicating it is a Windows Bundle and click Next.

  1. zen1.tiffCreating a new ZCM Windows Bundle
  2. Create this as an empty bundle so that we can configure the actions as necessary.
  3. On the next screen we will need to fill in a number of values:
  • Bundle Name: Give your bundle a name such as “GW2014
  • Folder: The default is /Bundles.
  • Icon: GroupWise 2014 has specified an icon for this use. Browse to your <installationfiles>/client/win32 directory and choose grpwise2014.ico as your icon file.
  • Description: Enter your description for GroupWise 2014 Client here.
    1. Creating the new GroupWise Bundlebundle-detail-gw2014.png
  • On the next screen ZCM 11 will allow you to create your bundle as a “Sandbox” version if you choose to do so until you are ready to publish the bundle for installation. Leave “Define Additional Properties” checked here so that we can further customize the application.
    1. groupwise-2014-bundle-page.pngThe GroupWise Bundle Page

Next we will create some installation actions for our bundle.

  1. Click on the Actions Tab, and then the Install tab to create some new actions.
  2. For the first Action, choose a Prompt User action. For this action we will use the following values:
    • Name the action something such as “Prompt User that the Client will be installed”
    • User Cancels Allowed: If you wish to force the installation immediately, leave this at 0
    • Seconds to be Displayed: Choose how long the prompt should stay on the screen – perhaps 30 seconds.
    • Click “Add” in the Define Prompts box to type in the text to be displayed. For example “The GroupWise Client will now be installed. Please be patient”.
    • Scroll down and select OK to save the action

We’ll now create a second action

  1. Now, choose “Install File(s)” as a second action. In this action we are essentially having ZCM put the installation files in a temporary location on the workstation so that the extract_setupip_packs.cmd can perform the extraction. Name this action something that will make sense to you. For example “Install files to temporary installation folder”.
    • Click on Add to get to the Select Files dialog, and click Add again to find the files. This time we need to go to the <serverfiles>\agents\data\client\setup\win32 folder and select the extract_setupip_packs.cmd, setupip.fil, and our language files (for example, setupip.en and setupip.de). Click “Open” to include these files in the Select Files dialog.
    • The setupip.fil file is already a compressed file, so it not necessary to compress these files further. Thus, check the box that says “do not compress or encrypt uploaded content”.

When you click Okay, you will see a confirmation screen to show you the files that will be uploaded to your repository.

  1. Once the files are uploaded, you will be returned to the Select Files dialog. Now you will need to specify where these files should be placed on the local machine. Remember this is a temporary installation directory, so you can choose any location you like. An example would be c:\gwclient. Select Okay.
    1. install-files-destination-directory-2014.pngThe completed Select Files dialog
  2. At the next screen, you can select to run this installation as a dynamic administrator user to avoid any rights problems during the copy. Select okay to save this action.

The next action we need to create is one to extract the files from the setupip.fil file for GroupWise.

  1. Back on the Install Tab, click Add to create a new action, and choose Run Script as the action.
  2. In our first action, we copied extract_setupip_files.cmd to c:\gwclient, so we can enter c:\gwclient\extract_setupip_packs.cmd as the Script File Name. The extract_setupip_packs.cmd file will then extract all of the files under this directory into c:\gwclient\win32. This is important for our final installation step.
  3. Click the radio button next to “When Action is Complete” for the wait parameter for this script.
    1. zen3.tiff Creating the Run Script Command
  4. Before you leave this screen, you should give the Action Name a more specific name, such as “Run Script to extract GW2014 files”.
  5. Choose to run the script as dynamic administrator to avoid problems during the extraction.
  6. Click OK and you will now see two actions in your Install tab.

The next step is to copy the MST file that we created with the GroupWise Install Tuner to the local temporary installation directory. The following steps will do this:

  1. Click Add again to create a new action. Choose “Install File(s)”, and give the action a name that designates that you wish to “Copy groupwise.mst to local directory”.
  2. Click Add to show the Select Files screen, and click Add again to show the add dialog.
  3. Browse to your <installationfiles>/client/win32 directory and choose the groupwise.mst file that we created above. Click OK. The file will be uploaded to the ZCM repository.
  4. Next you will be asked where this file should be copied. The extract_setupip_packs.cmd process created c:\gwclient\win32 (if you used c:\gwclient as your temp directory). This is where the groupwise.mst file must reside.
  5. Leave the copy option as Copy Always.
  6. Change to the Requirements tab and run the process as Dynamic Administrator.

Our final action will be to actually install GroupWise using the groupwise.mst file.

  1. Again, at the Install Tab, add a new action of “Launch Executable”. Name this Action “Launch install.bat for GroupWise 2014”.
  2. The command name in our case will be c:\gwclient\win32\install.bat.
  3. For command line parameters you can choose:
    • /unattended – this will show the typical GroupWise progress statuses for the installation
    • /silent – the user will not see anything while GroupWise installs
  4. Click on Add under Environment Variables and add the following:
    • Name: GW_INST_TRANSFORM_FILE
    • Value: groupwise.mst – note that this assumes the same folder as the install.bat file, which in our case is correct.

Click Ok.

  1. Click on Add under Environment Variables for a second variable to update existing GroupWise installations to match our current installation msi:
    • Name: GW_INST_REMOVE_MSI
    • Value: True

Click OK

  1. install-launch-exe-install.pngOur action for running install.bat
  2. Next click on the Advanced tab and select “When action is complete” for the wait time. Also choose to run as dynamic administrator. Click OK.

Next we will create a launch action for the GroupWise 2014 bundle.

  1. Click on the Launch Tab, then click on the Add button and choose “Launch Executable” as the type.
  2. For the command, you will have “${ProgramFiles32}\Novell\Groupwise\grpwise.exe”.
  3. For command line parameters you can choose any parameters you typically use.
  4. Click on the Advance Tab. Since this is for the launch of the client, you should choose “no wait” and “Run as logged in user”. Click OK.
  5. Apply your changes.

Back at the script parameters for the installation, we had the choice of running the installation in “unattended” or “silent” mode. If you chose silent, you might wish to allow ZCM to control the dialog that users see. To do so, go back to the Summary page of your new bundle, and scroll down until you see “Show Bundle Activity”. If you change this to “Yes”, ZCM will provide the status information to the user as the application installs.

  1. bundle-summary-2014.pngChange Show Bundle Activity to Yes

Next, change the “Displayed Version” at the top of the Summary from Sandbox to Published. To do so, click on the “Publish” button, publish as a new version.

To complete your installation, add your relationships, requirements, icon choices and schedule.