Auto-Update through Direct POA Access

Revision for “Auto-Update through Direct POA Access” created on April 5, 2014 @ 20:18:24

TitleContentExcerpt
Auto-Update through Direct POA Access
<p class="Body">Follow these steps to set up your post office for Auto-Update through the direct POA access method:</p>

<ol>
<li class="Number-Step">The installation routine (see <span class="Cross-Reference">“Installing the GroupWise Administration Service”</span> on page 25) copies the client files into the server directories.</li>
<li class="Number-Step">The client software is copied to <span class="Typed-in-Text" style="font-size: 0.9em;">/opt/novell/groupwise/agents/data/client/setup/win32/</span> directory.</li>
<li class="Number-Step">In order to better control the client software installation, we need a new directory under here, also called <span class="Typed-in-Text" style="font-size: 0.9em;">win32</span>. So you will need to create a directory so that you have <span class="Typed-in-Text" style="font-size: 0.9em;">/opt/novell/groupwise/agents/data/client/setup/win32/win32</span>, and yes that is <span class="Typed-in-Text" style="font-size: 0.9em;">/client/setup/win32/win32</span>. You are not seeing double.</li>
<li class="Number-Step">There are a couple of files in the installation directory that do not get copied to the GroupWise server directories, and we will need them in this <span class="Typed-in-Text" style="font-size: 0.9em;">win32</span> directory.
<ul>
<li class="Bullet"><span class="Typed-in-Text" style="font-size: 0.9em;">&lt;installationfiles&gt;/client/setup.cfg</span></li>
<li class="Bullet"><span class="Typed-in-Text" style="font-size: 0.9em;">/client/win32/setup.ini </span></li>
</ul>
</li>
</ol>
<p class="Number-Step-Indent">Copy both of these files into <span class="Typed-in-Text" style="font-size: 0.9em;">/gwclient/win32/win32</span>.</p>
<p class="Number-Step-Indent">You should then change them to reflect your wishes upon installation. We have samples of these files later in this chapter.</p>
<p class="Body">In prior versions of GroupWise, the <span class="Typed-in-Text" style="font-size: 0.9em;">setup.cfg</span> file contained settings for enabling auto-update and controlling its use. This has been removed from the <span class="Typed-in-Text" style="font-size: 0.9em;">setup.cfg</span>, and is now control in the Client Options in the GroupWise Administrative Console. Like all client options, these can be set by user, post office or domain. Let’s do an example of this for a specific post office.</p>

<ol>
<li class="Number-Step-1">Log into the GroupWise Administration Console.</li>
<li class="Number-Step">Click on Post Offices.</li>
<li class="Number-Step">Choose your Post Office from the list of available Post Offices.</li>
<li class="Number-Step">Click on the Client Options tab.</li>
<li class="Number-Step">At the bottom left of the Client Options is Client Auto-Update. Click on that setting.</li>
<li class="Number-Step">In the Client Auto-Update settings you have some options here, which we will discuss:</li>
</ol>
<ul class="List-2">
<li class="Caption-1"><img class="Object-Style-1" alt="linuxinstall084.tif" src="client-poa1-web-images/linuxinstall084_opt.png" width="787" height="415" />Auto-Update Options</li>
<li class="Bullet">Enable: check this box to enable the auto-update.</li>
<li class="Bullet">Auto-Update URL: We will discuss this in the next section. For this particular purpose, we will leave this blank.</li>
<li class="Bullet">Force Update: This setting was formerly in the <span class="Typed-in-Text" style="font-size: 0.9em;">setup.cfg</span> file. If you wish to require your users to update check this. This works in conjunction with:
<ul>
<li class="Bullet-Level-2">Grace Logins: How many times should a user be able to cancel out of the update before being forced to allow the auto-update to occur.</li>
</ul>
</li>
<li class="Bullet">Prompt Until Updated: If the user chooses to cancel the update, will s/he be nagged about it until the update is completed.</li>
</ul>
<p class="Body">Finally, before anything will really happen, the administrator must increment Bump Number. The administrator cannot choose the Bump Number, only increment it. To better understand this, let’s look at the Bump Number (also known as the “Software Number”).</p>

<ol>
<li class="Number-Step-1">In the GroupWise Administration Console, click on Post Offices, and then select the Post Office you wish to modify.</li>
<li class="Number-Step">In the Post Office settings, click on the “Diagnostics” dropdown along the top of the settings and select Display Object.</li>
<li class="Number-Step">Scroll through the listing until you find “Software Version” In our figure, this is version “1”</li>
</ol>
<ol class="List-1">
<li class="Caption-1"><img class="Object-Style-1" width="697" height="640" src="client-poa2-web-images/linuxinstall081_opt.png" alt="linuxinstall081.tif"/>The Internal Software Version Number</li>
</ol>
<p class="Body">To increment the bump number for a post office, follow these instructions:</p>
<ol>
<li class="Number-Step-1">In the GroupWise Administration Console, click on Post Offices, and then select the Post Office you wish to modify.</li>
<li class="Number-Step">In the Post Office settings, click on the “More” dropdown along the top of the settings.</li>
<li class="Number-Step">Choose Client Auto-Update<ol><li class="Caption-1">Choosing Client Auto-Update<img class="Object-Style-1" width="606" height="429" src="client-poa2-web-images/linuxinstall079_opt.png" alt="linuxinstall079.tif"/></li></ol></li>
<li class="Number-Step">When you click the Trigger Update, the Bump Number will change.</li>
<li class="Number-Step"><img class="Object-Style-1" width="528" height="269" src="client-poa2-web-images/linuxinstall082_opt.png" alt="linuxinstall082.tif"/>This increments the Bump Number for the post office by one. If you follow the above instructions again for Display Object, you will see that the Software Version is one higher than before,<ol><li class="Caption-1">Incremented Software Version<img class="Object-Style-1" width="699" height="639" src="client-poa2-web-images/linuxinstall083_opt.png" alt="linuxinstall083.tif"/></li></ol></li>
<li class="Number-Step">As we will explain in a few minutes, if you want your users to upgrade, clicking this button multiple times will not cause problems. However, clicking it just once when you do NOT want to upgrade will cause you some headaches!</li>
</ol>
<p class="Body">The stage is now set to initiate your auto-update. The next time a user logs into the post office, the following exchange will occur.</p>
<ol>
<li class="Number-Step">The client on the user’s PC will query the POA and ask what the Bump Number is.</li>
<li class="Number-Step">The client on the user’s PC then compares this Bump Number to the registry value in <span class="Typed-in-Text" style="font-size:0.9em;">HKEY_LOCAL_MACHINE\SOFTWARE\Novell\GroupWise\Client\5.0\NewSoftwareBump</span>. For 64 bit machines, this is now in <span class="Typed-in-Text" style="font-size:0.9em;">HKLM\software\Wow6432node\novell\groupwise\client\5.0\NewSoftwareBump</span>. If this number is different (higher or lower), then the client continues on to ask for the Build Number.</li>
<li class="Number-Step">The Build Number is found in both the <span class="Typed-in-Text" style="font-size:0.9em;">version.ini</span> file in the Client Software Update Repository, and in the workstation registry. <span class="Typed-in-Text" style="font-size:0.9em;">HKEY_LOCAL_MACHINE\SOFTWARE\Novell\GroupWise\BuildNumber </span>or <span class="Typed-in-Text" style="font-size:0.9em;">HKEY_LOCAL_MACHINE\SOFTWAREWow6432Node\Novell\GroupWise\BuildNumber. </span>The client looks at this value, and if the new value in the <span class="Typed-in-Text" style="font-size:0.9em;">version.ini </span>file is higher, the client then continues the update query process.</li>
<li class="Number-Step">The client then compares the settings in Client Options that affect this user (so user/post office/domain), and if Update has been enabled, the upgrade begins.</li>
</ol>
<p class="Body"/>
<p class="Body">It is important to note that the workstation must have access to write to the registry in order for the auto-update process to work. If the workstation cannot write the new Bump and Build numbers to the registry, it will not upgrade, and it will not give the user any indication that there is new software.</p>
<p class="Body">Once you know these key steps, it’s easy to see where odd messages users receive about software updates come from. Here are a couple that we see frequently:</p>
<p class="Body"/>
<ul class="List-2">
<li class="Bullet">“There is new GroupWise software available; however you can not access it at this time”: This error can occur if the bump number on the post office in question is different than the one in the workstation’s registry, and the Build Number is higher, but the user cannot receive the files. For a standard auto-upgrade through the POA, this should not happen, but if you are using a web server for the auto-update, and the web server is unavailable, you might see this message. </li>
<li class="Bullet">“There may be new GroupWise software available. However, the auto-update process was unable to access the GroupWise Software directory. Please contact your administrator”: This one is interesting, because it means that the bump number is different on the post office than on the workstation, but the <span class="Typed-in-Text" style="font-size:0.9em;">version.ini </span>cannot be accessed to verify that the software is actually newer.</li>
</ul>
<p class="Body">If you have an easy method to change the registry at your workstations, you can also simply change the value in the <span class="Typed-in-Text" style="font-size:0.9em;">HKEY_LOCAL_MACHINE\SOFTWARE\Novell\GroupWise\Client\5.0\NewSoftwareBump</span> or <span class="Typed-in-Text" style="font-size:0.9em;">HKLM\Software\Wow6432Node\Novell\GroupWise\Client\5.0</span> to “0”. This will ensure that the Bump Number in the registry is different than what is in the <span class="Typed-in-Text" style="font-size:0.9em;">wphost.db</span> file, and will restart the upgrade query for all (or a subset if you choose to only change the registry for a group of users) of your workstations.</p>



Old New Date Created Author Actions
April 5, 2014 @ 20:18:24 Danita
April 5, 2014 @ 20:17:03 Danita
April 5, 2014 @ 20:16:54 [Autosave] Danita
April 5, 2014 @ 20:15:47 Danita
April 5, 2014 @ 19:44:26 Danita