Auto-Update with POA Access Through a Web Server

Revision for “Auto-Update with POA Access Through a Web Server” created on April 5, 2014 @ 19:50:18

Auto-Update with POA Access Through a Web Server
<p class="Body">In the prior section, we saw the following figure:</p>
<ol class="List-1">
<li class="Caption-1"><img class="Object-Style-1" width="787" height="415" src="clientweb-web-images/linuxinstall084_opt.png" alt="linuxinstall084.tif"/>Auto-Update Options</li>
<p class="Body">We promised to explain the Auto-Login URL, and so here we are! In prior versions of GroupWise, the Software Distribution Directory (SDD) was used to distribute software for Auto-Update. While the POA was responsible to “hand off” the update of the software to the client, it was required that the user logged into the Windows workstations have read rights to the Software Distribution Directory in order to run the installation routine.</p>
<p class="Body">GroupWise 2014 has abandoned the SDD, and has instead compressed the installation files at the Post Office server. In order to continue to provide auto-update for even the smallest of sites with very limited server resources and administrative staff, auto-update at the POA was developed, so that out-of-the-box, without too much additional configuration, auto-update could be delivered to users. Thus, if you use the direct access as described above, the POA will actually deliver the installation files to the users for decompressing and installation. </p>
<p class="Body">On an already very busy post office, this can cause some slowdowns first thing Monday morning when all of your users arrive and are presented the auto-update option! To alleviate this, Novell has added a new “web server delivery” method for auto-update. This is very similar to SETUPIP, but requires less configuration, and is still reliant on the auto-update algorithm we described above.</p>
<p class="Head2"><a id="Anchor-6"/>Preparing the Web Server</p>
<p class="Body">The steps will be very similar to the above. The first thing you must do is configure your web server. We will not go through installing and setting up a web server for you. Refer to the documentation of the server on which you wish to install web services. There is no reason why you cannot use your GroupWise WebAccess server for this purpose if you choose, or you could fire up a small server for the dedicated purpose of providing GroupWise client installation functionality.</p>
<p class="Body">The steps are the same for Apache2 on Linux or IIS on Windows. You must simply start at your document root. On SLES/OES, this is <span class="Typed-in-Text" style="font-size:0.9em;">/srv/www/htdocs</span>. On IIS this would be <span class="No-Break" style="font-size:0.9em;">c:\inetpub\wwwroot</span>. We will refer to this from here on out as simply <span class="Typed-in-Text" style="font-size:0.9em;">&lt;documentroot&gt; </span>for both Windows and Linux.</p>
<li class="Number-Step-1">Create a new folder under the document root. You can name it anything you like, but <span class="Typed-in-Text" style="font-size:0.9em;">gwclient </span>seems reasonable!</li>
<li class="Number-Step">The installation routine (see <span class="Cross-Reference">“Installing the GroupWise Administration Service”</span> on page <span>&lt;?&gt;</span>)<span class="Cross-Reference"> </span>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;">&lt;serverfiles&gt;/agents/data/client/setup/win32/</span> directory. Copy the entire <span class="Typed-in-Text" style="font-size:0.9em;">&lt;serverfiles&gt;\agents\data\client\setup\win32</span> into your web server <span class="Typed-in-Text" style="font-size:0.9em;">&lt;documentroot&gt;\gwclient</span> folder that you created above so that you have <span class="Typed-in-Text" style="font-size:0.9em;">&lt;documentroot&gt;/gwclient/win32</span> on the server.</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;">&lt;documentroot&gt;/gwclient/win32/win32</span> (yes, that’s two <span class="Typed-in-Text" style="font-size:0.9em;">win32</span> folders). </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;">&lt;installationfiles&gt;/client/win32/setup.ini </span></li></ul></li>
<p class="Number-Step-Indent">Copy both of these files into <span class="Typed-in-Text" style="font-size:0.9em;">&lt;documentroot&gt;/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="Head3">Apache Specific Settings</p>
<p class="Body">On Apache on Linux, depending on the settings of your server, you may need to give specific access rights to this folder structure before the web server will actually deliver files for you. So perform the following steps for this.</p>
<li class="Number-Step-1">Go to the <span class="Typed-in-Text" style="font-size:0.9em;">/etc/apache2/conf.d</span> folder on your Linux server.</li>
<li class="Number-Step">Create a new text file here and call it something like <span class="Typed-in-Text" style="font-size:0.9em;">gwclient.conf</span>. The name is not really important as long as it has a <span class="Typed-in-Text" style="font-size:0.9em;">.conf</span> extension. Just name it something that will make sense to you later.</li>
<li class="Number-Step">Place the following contents in this file:</li>
<p class="Typed-In-Text">&lt;Directory /srv/www/htdocs/gwclient&gt;</p>
<p class="Typed-In-Text"> Options Indexes</p>
<p class="Typed-In-Text"> AllowOverrides None</p>
<p class="Typed-In-Text"> Order allow,deny</p>
<p class="Typed-In-Text"> Allow from all</p>
<p class="Typed-In-Text">&lt;/Directory&gt;</p>
<li class="Number-Step">Restart Apache2. i.e., type <span class="Typed-in-Text" style="font-size:0.9em;">rcapache2 restart</span></li>
<p class="Head3">IIS Specific Settings</p>
<p class="Body">On Windows Server, you will need to give specific access rights to your GroupWise client files before the web server will actually deliver the files to your users. Here are the steps required to accomplish this:</p>
<li class="Number-Step-1">Click Start &gt; Administrative Tools &gt; Internet Information Services (IIS) Manager.</li>
<li class="Number-Step">Expand the Local Computer object, expand the Sites folder, expand your website, then select the client software directory that you created above under <a href="#Anchor-6"><span class="Cross-Reference">“Preparing the Web Server”</span></a>. Here we will enable directory browsing so that the <span class="Typed-in-Text" style="font-size:0.9em;">gwclient</span> directory can be accessed:<ul><li class="Bullet">In the Features View, double-click Directory Browsing.</li><li class="Bullet">In the Actions pane, click Enable.</li><li class="Bullet">Click the client software directory to return to the Features View.</li></ul></li>
<li class="Number-Step">Next, to configure IIS to allow the download of the client software files:<ul><li class="Bullet">In the Features View, double-click MIME Types.</li><li class="Bullet">In the Actions pane, click Add.</li><li class="Bullet">In the File name extension field, type .* (a period followed by an asterisk).</li><li class="Bullet">In the MIME type field, type application/octet-stream.</li><li class="Bullet">Click OK.</li></ul></li>
<li class="Number-Step">Click the client software directory to return to the Features View.</li>
<p class="Body"/>
<p class="Body">Is is possible that you have configured file filtering at a higher level in this website. Is so, you must also configure IIS to not filter out files in the client software directory:</p>
<li class="Number-Step-1">In the Features View, double-click Request Filtering.</li>
<li class="Number-Step">Click Allow File Name Extension.</li>
<li class="Number-Step">In the File name extension field, type .* (a period followed by an asterisk).</li>
<li class="Number-Step">Click OK.</li>
<p class="Body"/>
<p class="Body">Finally, we will restart IIS. You can do this one of two ways:</p>
<li class="Number-Step-1">In IIS Manager, click on the IIS Server Name</li>
<li class="Number-Step">In the left-hand column choose “Restart Server”</li>
<p class="Body"/>
<p class="Body">Alternately, you can restart the IIS service as follows:</p>
<li class="Number-Step-1">Click Start &gt; Administrative Tools &gt; Services.</li>
<li class="Number-Step">Right-click World Wide Web Publishing Service, and click Restart.</li>
<p class="Head2">Web Server Cleanup</p>
<p class="Body">Both Linux and Windows leave some files around that will cause trouble with the download of the GroupWise files.</p>
<p class="Body">On Windows, specifically, there is a file called <span class="Typed-in-Text" style="font-size:0.9em;">web.config</span> in your document root (typically <span class="Typed-in-Text" style="font-size:0.9em;">c:\inetpub\wwwroot</span>). This file, while important, will trip up the download of your GroupWise files. To avoid issues, right-click on the file, go to Properties and change the file to “hidden”.</p>
<p class="Body">For both servers, look in the <span class="Typed-in-Text" style="font-size:0.9em;">win32\win32</span> directory for any temporary files that might have been created when you were editing the <span class="Typed-in-Text" style="font-size:0.9em;">setup.cfg</span> and <span class="Typed-in-Text" style="font-size:0.9em;">setup.ini</span> files. On Linux, these typically end with a <span class="Typed-in-Text" style="font-size:0.9em;">~</span> – for example, <span class="Typed-in-Text" style="font-size:0.9em;">setup.cfg~</span>. These extraneous files can also cause download issues. Delete them.</p>
<p class="Body"/>
<p class="Note"/>

Old New Date Created Author Actions
April 5, 2014 @ 19:50:18 Danita
April 5, 2014 @ 19:47:59 [Autosave] Danita
April 5, 2014 @ 19:45:03 Danita