Upgrading Users with ZENworks Configuration Management

Revision for “Upgrading Users with ZENworks Configuration Management” created on April 5, 2014 @ 20:07:34

TitleContentExcerpt
Upgrading Users with ZENworks Configuration Management
<p class="Body">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.</p>
<p class="Body">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 <span class="Typed-in-Text" style="font-size:0.9em;">gwtuner.exe</span> file that is supplied with GroupWise 2014. The <span class="Typed-in-Text" style="font-size:0.9em;">gwtuner.exe</span> file is found in both the Linux and Windows distributions in <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt;</span><span class="Typed-in-Text" style="font-size:0.9em;">\admin\utility\tools.</span><span> </span></p>
<p class="Body">As you can probably see, <span class="Typed-in-Text" style="font-size:0.9em;">gwtuner.exe</span> is a Windows application, and it needs access to files from the <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt;\client</span> folders. The Zenworks Control Center needs access to both the <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installation files&gt; </span>and the <span class="Typed-in-Text" style="font-size:0.9em;">&lt;serverfiles&gt;</span> 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:</p>
<ul class="List-1">
<li class="Bullet">If this is an OES server, place the <span class="Typed-in-Text" style="font-size:0.9em;">&lt;serverfiles&gt;/agents/client</span> directory and your <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt;</span> on a NCP accessible drive.</li>
<li class="Bullet">Configure SAMBA for shares to the <span class="Typed-in-Text" style="font-size:0.9em;">&lt;serverfiles&gt;</span> and <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt;</span> and map drives from Windows to these SAMBA shares.</li>
<li class="Bullet">Download the Windows GroupWise full distribution and extract the files by doing the following:<ul><li class="Bullet-Level-2">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 <span class="No-Break" style="font-size:0.9em;">c:\temp\gwinstall</span>. This would then serve as your <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt;</span> directory for the rest of this ZCM section.</li><li class="Bullet-Level-2">change to this new <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt;\server\win64</span> directory</li><li class="Bullet-Level-2">run <span class="Typed-in-Text" style="font-size:0.9em;">setup.exe /extract c:\temp\gwserver</span> (or any location you choose). Use this location as your <span class="Typed-in-Text" style="font-size:0.9em;">&lt;serverfiles&gt;</span> location for accessing the required client files.</li></ul></li>
</ul>
<p class="Body">Our preference is actually the latter. In any event, you must have access from Windows for this process!</p>
<p class="Body"/>
<ol>
<li class="Number-Step-1"><span>Run the </span><span class="Typed-in-Text" style="font-size:0.9em;">gwtuner.exe</span><span> file. You will see the information in </span><a href="#Anchor-18"><span class="Internet-Link">Figure 11-11</span></a><span>.</span></li>
</ol>
<p class="Body"/>
<ol class="List-2">
<li class="Caption-1"><a id="Anchor-18"/><img class="Basic-Graphics-Frame" width="506" height="381" src="clientzcm-web-images/gwtuner1_opt.jpeg" alt="gwtuner1.tiff"/>The GWTuner Client Directory Window</li>
<li class="Number-Step">At this screen, enter the location of your client directory in <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt; </span>folder<span>.</span></li>
<li class="Number-Step">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:</li>
</ol>
<ul class="List-1">
<li class="Bullet"><span class="char-style-override-1">Install path</span>: Enter your installation path. The default is shown in the figure below.</li>
<li class="Bullet"><span class="char-style-override-1">Program folder:</span> 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).</li>
<li class="Bullet"><span class="char-style-override-1">Add GroupWise to the Desktop:</span> 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</li>
<li class="Bullet"><span class="char-style-override-1">Add GroupWise to the Quick Launch: </span> We can also add an icon to the Quick Launch. We are leaving this unchecked.</li>
<li class="Bullet"><span class="char-style-override-1">Add Notify to the Startup folder:</span> We wish to control this with ZCM, so we are leaving this unchecked.</li>
<li class="Bullet"><span class="char-style-override-1">Install Internet Browser Mail Integration:</span> This adds “mail to” functionality to your browsers to launch GroupWise when a “mail to” link is clicked.</li>
<li class="Bullet"><span class="char-style-override-1">Add icons to the Start Menu:</span> If we leave this checked, the Program folder listed above will be created for the Start Menu.<ol><li class="Caption-1"><img class="Basic-Graphics-Frame" width="506" height="381" src="clientzcm-web-images/gwtuner2_opt.jpeg" alt="gwtuner2.tiff"/>The GWTuner General Settings</li></ol></li>
<li class="Number-Step">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.</li>
<li class="Number-Step">When you click Finish, your <span class="Typed-in-Text" style="font-size:0.9em;">groupwise.mst</span> file will be created in the <span class="Typed-in-Text" style="font-size:0.9em;">win32</span> directory under the <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt;\client\win32</span> folder.</li>
</ul>
<p class="Body">Now that our <span class="Typed-in-Text" style="font-size:0.9em;">groupwise.mst</span> 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 <span class="Cross-Reference">“Upgrading the GroupWise Client with SETUPIP”</span> 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 <span class="Typed-in-Text" style="font-size:0.9em;">&lt;serverfiles&gt;/agents/data/client/setup/win32</span> 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 <span class="Typed-in-Text" style="font-size:0.9em;">setupip.fil</span>, <span class="Typed-in-Text" style="font-size:0.9em;">extract_setupip_packs.cmd</span> 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 <span class="Typed-in-Text" style="font-size:0.9em;">setupip.en</span> and <span class="Typed-in-Text" style="font-size:0.9em;">setupip.de</span> for our bundle. We will walk through those steps now.</p>
<ol>
<li class="Number-Step-1">Launch your Zenworks Control Center in your browser, and choose Bundles.</li>
<li class="Number-Step">Create a new bundle by clicking on “New” and then choosing “Bundle” and then indicating it is a Windows Bundle and click Next.</li>
</ol>
<p class="Body"/>
<ol class="List-2">
<li class="Caption-1"><span class="Typed-in-Text" style="font-size:1.29em;"><img class="Basic-Graphics-Frame" width="715" height="350" src="clientzcm-web-images/zen1_opt.jpeg" alt="zen1.tiff"/></span>Creating a new ZCM Windows Bundle</li>
<li class="Number-Step">Create this as an empty bundle so that we can configure the actions as necessary.</li>
<li class="Number-Step">On the next screen we will need to fill in a number of values:</li>
</ol>
<ul class="List-1">
<li class="Bullet"><span class="Bold">Bundle Name</span>: Give your bundle a name such as “<span class="Typed-in-Text" style="font-size:0.9em;">GW2014</span>”</li>
<li class="Bullet"><span class="Bold">Folder</span>: The default is <span class="Typed-in-Text" style="font-size:0.9em;">/Bundles</span>. </li>
<li class="Bullet"><span class="Bold">Icon</span>: GroupWise 2014 has specified an icon for this use. Browse to your <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt;/client/win32</span> directory and choose <span class="Typed-in-Text" style="font-size:0.9em;">grpwise2014.ico</span> as your icon file.</li>
<li class="Bullet"><span class="Bold">Description</span>: Enter your description for GroupWise 2014 Client here.<ol><li class="Caption-1">Creating the new GroupWise Bundle<img class="Object-Style-1" width="441" height="353" src="clientzcm-web-images/bundle-detail-gw2014_opt.png" alt="bundle-detail-gw2014.png"/></li></ol></li>
<li class="Number-Step">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.<ol><li class="Caption-1"><img class="Object-Style-1" width="446" height="275" src="clientzcm-web-images/groupwise-2014-bundle-p_opt.png" alt="groupwise-2014-bundle-page.png"/>The GroupWise Bundle Page</li></ol></li>
</ul>
<p class="Body">Next we will create some installation actions for our bundle.</p>
<ol>
<li class="Number-Step-1">Click on the Actions Tab, and then the Install tab to create some new actions.</li>
<li class="Number-Step">For the first Action, choose a Prompt User action. For this action we will use the following values:<ul><li class="Bullet">Name the action something such as “Prompt User that the Client will be installed”</li><li class="Bullet">User Cancels Allowed: If you wish to force the installation immediately, leave this at 0</li><li class="Bullet">Seconds to be Displayed: Choose how long the prompt should stay on the screen – perhaps 30 seconds.</li><li class="Bullet">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”.</li><li class="Bullet">Scroll down and select OK to save the action</li></ul></li>
</ol>
<p class="Body"/>
<p class="Body">We’ll now create a second action</p>
<ol>
<li class="Number-Step-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 <span class="No-Break" style="font-size:0.9em;">extract_setupip_packs.cmd</span> can perform the extraction. Name this action something that will make sense to you. For example “Install files to temporary installation folder”.<ul><li class="Bullet">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 <span class="Typed-in-Text" style="font-size:0.9em;">&lt;serverfiles&gt;\agents\data\client\setup\win32</span> folder and select the <span class="Typed-in-Text" style="font-size:0.9em;">extract_setupip_packs.cmd</span>, <span class="Typed-in-Text" style="font-size:0.9em;">setupip.fil</span>, and our language files (for example,<span class="Typed-in-Text" style="font-size:0.9em;"> setupip.en</span> and <span class="Typed-in-Text" style="font-size:0.9em;">setupip.de</span>). Click “Open” to include these files in the Select Files dialog.</li><li class="Bullet">The <span class="Typed-in-Text" style="font-size:0.9em;">setupip.fil</span> 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”.</li></ul></li>
</ol>
<p class="Number-Step-Indent">When you click Okay, you will see a confirmation screen to show you the files that will be uploaded to your repository.</p>
<ol>
<li class="Number-Step">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 <span class="Typed-in-Text" style="font-size:0.9em;">c:\gwclient</span>. Select Okay.<ol><li class="Caption-1"><img class="Basic-Graphics-Frame" width="518" height="340" src="clientzcm-web-images/install-files-destinati_opt.png" alt="install-files-destination-directory-2014.png"/>The completed Select Files dialog</li></ol></li>
<li class="Number-Step">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.</li>
</ol>
<p class="Body"/>
<p class="Body">The next action we need to create is one to extract the files from the <span class="Typed-in-Text" style="font-size:0.9em;">setupip.fil</span> file for GroupWise.</p>
<ol>
<li class="Number-Step-1">Back on the Install Tab, click Add to create a new action, and choose Run Script as the action.</li>
<li class="Number-Step">In our first action, we copied <span class="Typed-in-Text" style="font-size:0.9em;">extract_setupip_files.cmd</span> to<span class="Typed-in-Text" style="font-size:0.9em;"> c:\gwclient</span>, so we can enter <span class="Typed-in-Text" style="font-size:0.9em;">c:\gwclient\extract_setupip_packs.cmd</span> as the Script File Name. The <span class="Typed-in-Text" style="font-size:0.9em;">extract_setupip_packs.cmd</span> file will then extract all of the files under this directory into <span class="Typed-in-Text" style="font-size:0.9em;">c:\gwclient\win3</span>2. This is important for our final installation step.</li>
<li class="Number-Step">Click the radio button next to “When Action is Complete” for the wait parameter for this script.<ol><li class="Caption-1"><img class="Basic-Graphics-Frame" width="692" height="454" src="clientzcm-web-images/zen3_opt.jpeg" alt="zen3.tiff"/> Creating the Run Script Command</li></ol></li>
<li class="Number-Step">Before you leave this screen, you should give the Action Name a more specific name, such as “Run Script to extract GW2014 files”.</li>
<li class="Number-Step">Choose to run the script as dynamic administrator to avoid problems during the extraction.</li>
<li class="Number-Step">Click OK and you will now see two actions in your Install tab.</li>
</ol>
<p class="Body"/>
<p class="Body">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:</p>
<ol>
<li class="Number-Step-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 <span class="Typed-in-Text" style="font-size:0.9em;">groupwise.mst</span> to local directory”.</li>
<li class="Number-Step">Click Add to show the Select Files screen, and click Add again to show the add dialog.</li>
<li class="Number-Step">Browse to your <span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfiles&gt;/client/win32</span> directory and choose the <span class="Typed-in-Text" style="font-size:0.9em;">groupwise.mst</span> file that we created above. Click OK. The file will be uploaded to the ZCM repository. </li>
<li class="Number-Step">Next you will be asked where this file should be copied. The <span class="Typed-in-Text" style="font-size:0.9em;">extract_setupip_packs.cmd</span> process created <span class="Typed-in-Text" style="font-size:0.9em;">c:\gwclient\win32</span> (if you used <span class="Typed-in-Text" style="font-size:0.9em;">c:\gwclien</span>t as your temp directory). This is where the <span class="Typed-in-Text" style="font-size:0.9em;">groupwise.mst</span> file must reside.</li>
<li class="Number-Step">Leave the copy option as Copy Always.</li>
<li class="Number-Step">Change to the Requirements tab and run the process as Dynamic Administrator.</li>
</ol>
<p class="Body"/>
<p class="Body">Our final action will be to actually install GroupWise using the <span class="Typed-in-Text" style="font-size:0.9em;">groupwise.mst</span> file.</p>
<ol>
<li class="Number-Step-1">Again, at the Install Tab, add a new action of “Launch Executable”. Name this Action “Launch install.bat for GroupWise 2014”.</li>
<li class="Number-Step">The command name in our case will be <span class="Typed-in-Text" style="font-size:0.9em;">c:\gwclient\win32\install.bat</span>.</li>
<li class="Number-Step">For command line parameters you can choose:<ul><li class="Bullet">/unattended – this will show the typical GroupWise progress statuses for the installation</li><li class="Bullet">/silent – the user will not see anything while GroupWise installs</li></ul></li>
<li class="Number-Step">Click on Add under Environment Variables and add the following:<ul><li class="Bullet"><span class="Bold">Name</span>: GW_INST_TRANSFORM_FILE</li><li class="Bullet"><span class="Bold">Value</span>: <span class="Typed-in-Text" style="font-size:0.9em;">groupwise.mst</span> – note that this assumes the same folder as the <span class="Typed-in-Text" style="font-size:0.9em;">install.bat</span> file, which in our case is correct.</li></ul></li>
</ol>
<p class="Number-Step-Indent">Click Ok.</p>
<ol>
<li class="Number-Step">Click on Add under Environment Variables for a second variable to update existing GroupWise installations to match our current installation msi:<ul><li class="Bullet"><span class="Bold">Name</span>: GW_INST_REMOVE_MSI</li><li class="Bullet"><span class="Bold">Value</span>: True</li></ul></li>
</ol>
<p class="Number-Step-Indent">Click OK</p>
<ol class="List-2">
<li class="Caption-1"><img class="Basic-Graphics-Frame" width="515" height="511" src="clientzcm-web-images/install-launch-exe-inst_opt.png" alt="install-launch-exe-install.png"/>Our action for running install.bat</li>
<li class="Number-Step">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.</li>
</ol>
<p class="Body"/>
<p class="Body">Next we will create a launch action for the GroupWise 2014 bundle.</p>
<ol>
<li class="Number-Step-1"> Click on the Launch Tab, then click on the Add button and choose “Launch Executable” as the type.</li>
<li class="Number-Step">For the command, you will have “<span class="Typed-in-Text" style="font-size:0.9em;">${ProgramFiles32}\Novell\Groupwise\grpwise.exe</span>”.</li>
<li class="Number-Step">For command line parameters you can choose any parameters you typically use. </li>
<li class="Number-Step">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.</li>
<li class="Number-Step">Apply your changes.</li>
</ol>
<p class="Body">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.</p>
<ol class="List-2">
<li class="Caption-1"><img class="Object-Style-1" width="589" height="440" src="clientzcm-web-images/bundle-summary-2014_opt.png" alt="bundle-summary-2014.png"/>Change Show Bundle Activity to Yes</li>
</ol>
<p class="Body">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.</p>
<p class="Body">To complete your installation, add your relationships, requirements, icon choices and schedule.</p>
<p class="Body"/>



Old New Date Created Author Actions
April 5, 2014 @ 20:07:34 Danita