Update with SetupIP

Revision for “Update with SetupIP” created on April 5, 2014 @ 20:23:42

TitleContentExcerpt
Update with SetupIP
<p class="Head2">Upgrading the GroupWise Client with SETUPIP </p>
<p class="Body">Earlier in this chapter we discussed how you can now trigger auto-update by domain, post office or even user. However, there is no way to multi-select subsets of users and edit their client options, or change the client options of a group.</p>
<p class="Body">This is where SETUPIP really shines, because you can configure a distribution of the GroupWise client, and then you can simply distribute a small executable to multiple users (via email, or placing it on a web server for download) and manage a more controlled rollout of the client.</p>
<p class="Body">SETUPIP requires a web server to serve up the client files. When you deliver the GroupWise client using SETUPIP, it downloads a compressed version of the GroupWise client from a file called <span class="Typed-in-Text" style="font-size:0.9em;">setupip.fil</span>. Any additional languages you wish to include will only add 3-5 MB per language to the download. After everything is downloaded, SETUPIP launches the GroupWise client <span class="No-Break" style="font-size:0.9em;">setup.exe</span> installation program from the users local hard drive and the installation begins. </p>
<p class="Body">Additionally, SETUPIP can be used to install GroupWise fresh on a PC that has never had GroupWise before. This allows you to get the client to remote workers who have never had their laptops in the office!</p>
<p class="Head3">Configuring Your Web Server</p>
<p class="Body">You can use any web server available that allows connections on port 80. Here are the steps to configure your web server. The procedure is almost identical to our previous settings under <a href="#Anchor-16"><span class="Cross-Reference">“Auto-Update with POA Access Through a Web Server”</span></a><span class="Cross-Reference">.</span></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="Typed-in-Text" 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>
<ol>
<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>25</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 contents of <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.</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>. </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>
</ol>
<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>
<ol>
<li class="Number-Step">In the <span class="Typed-in-Text" style="font-size:0.9em;">win32</span> folder you will have all of the available language files (e.g. <span class="Typed-in-Text" style="font-size:0.9em;">setupip.xx</span>, where <span class="Typed-in-Text" style="font-size:0.9em;">xx</span> is an appropriate language designation such as en for English or <span class="Typed-in-Text" style="font-size:0.9em;">fr</span> for French-France. If you have more than one language file the client will be presented with a list of languages that can be downloaded and extracted. If the user selects more than one language, the GroupWise Client will be installed in all of the selected languages. You should remove all language files from this folder for languages that are not needed for your organization. If only one language file exists, users will not be prompted to select languages for the installation. If you require more than one language file for your system, configuring your <span class="Typed-in-Text" style="font-size:0.9em;">setup.cfg</span> file will allow you to set the default language. Also, you must indicate “Yes” for any languages you wish to have installed. Otherwise only the default language will be installed.</li>
</ol>
<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>
<ol>
<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>
</ol>
<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>
<ol>
<li class="Number-Step">Restart Apache2. i.e., type <span class="Typed-in-Text" style="font-size:0.9em;">rcapache2 restart</span></li>
</ol>
<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>
<ol>
<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>
</ol>
<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>
<ol>
<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>
</ol>
<p class="Body"/>
<p class="Body">Finally, we will restart IIS. You can do this one of two ways:</p>
<ol>
<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>
</ol>
<p class="Body"/>
<p class="Body">Alternately, you can restart the IIS service as follows:</p>
<ol>
<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>
</ol>
<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="Head2">Test the Software Availability</p>
<p class="Body">Regardless of your web server platform, you should test to verify that the client software is available from a browser. Follow these instructions to do so:</p>
<ol>
<li class="Number-Step-1">From your browser, navigate to http://web_server_address/gwclient (assuming this is the directory you chose for your installation).</li>
<li class="Number-Step">Verify that you can see files and or directories related to your installation.</li>
</ol>
<p class="Body"/>
<p class="Body">Now that you’ve configured your web server, we can create the <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe</span> that will control the installation of the GroupWise client through the web server. The next section entitled <a href="#Anchor-7"><span class="Cross-Reference">“Configure and Generate the setupip.exe Executable”</span></a> will explain this process. </p>
<p class="Head2"><a id="Anchor-7"/>Configure and Generate the setupip.exe Executable </p>
<p class="Body">The <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe</span> file is used to download and launch the GroupWise client installation over an IP connection to a web server. When executed, the <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe</span> file downloads the compressed GroupWise client and then launches the <span class="Typed-in-Text" style="font-size:0.9em;">setup.exe</span> file. The <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe</span> file contains the location (URL) to your web server(s) where you have hosted the GroupWise client as explained previously. The procedure to create the <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe</span> file is a Windows application (<span class="Typed-in-Text" style="font-size:0.9em;">writeip.exe</span>). 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 SETUPIP 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"/>
<p class="Body">To generate your <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe</span> follow these steps. </p>
<ol>
<li class="Number-Step">From your <span class="Typed-in-Text" style="font-size:0.9em;">&lt;serverfiles&gt;/data/client/setup/win32</span> folder, run the utility called <span class="No-Break" style="font-size:0.9em;">writeip.exe.</span></li>
<li class="Number-Step">In the WRITEIP utility fill in the DNS name or IP address of the web server with the appropriate location to the GroupWise client directory on the web server. Based on the previous section this would be<span class="Typed-in-Text" style="font-size:0.9em;"> http://&lt;your server IP or DNS name&gt;/gwclient </span><ol><li class="Caption-1"><img class="Basic-Graphics-Frame" width="408" height="399" src="client-set-web-images/linuxinstall086_opt.png" alt="linuxinstall086.tif"/>The Write IP interface</li></ol></li>
</ol>
<p class="Note">NOTE: You can define multiple web servers for the GroupWise client download. This allows the client to be downloaded randomly from the sites you define if you check this option. Otherwise, if the first web server is down, the client will be downloaded from the next web server on the list. If you are providing SETUPIP functionality for users both on your network and across the Internet, you might want to provide URLs with both private and public IP addresses to the same web server location. </p>
<p class="Body"/>
<ol>
<li class="Number-Step">After filling in the information in the WRITEIP utility select the OK button, which will generate a new executable in the <span class="Typed-in-Text" style="font-size:0.9em;">&lt;serverfiles&gt;/agents/data/client/setup/win32</span> directory called <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe</span>. </li>
<li class="Number-Step">Copy the <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe</span> file to the into the <span class="Typed-in-Text" style="font-size:0.9em;">&lt;documentroot&gt;/gwclient</span> directory of the web server. </li>
<li class="Number-Step">You can instruct users to set up their GroupWise client by going directly to <span class="Internet-Link">http://yourserver.com/gwclient/setupip.exe</span> – then when they download this file, the installation of the client will begin.</li>
<li class="Number-Step">Alternatively, you can email the <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe </span>to your users. Instruct them to save the attachment locally, close groupwise and run <span class="Typed-in-Text" style="font-size:0.9em;">setupip.exe</span> to upgrade.</li>
</ol>
<p class="Head3">Troubleshooting SETUPIP </p>
<p class="Body">The SETUPIP utility makes a file called <span class="Typed-in-Text" style="font-size:0.9em;">setupip.err</span> in the Windows program directory. The Windows program directory is usually <span class="Typed-in-Text" style="font-size:0.9em;">c:\windows</span>. If you experience problems with SETUPIP, look at this file for some clues.</p>
<p class="Body"> Some of the more common problems with SETUPIP are </p>
<ul class="List-1">
<li class="Bullet">not putting in the entire path to the files in the http: links</li>
<li class="Bullet">not configuring the web server to be able to access the files</li>
<li class="Bullet">having errors in the gwclient.conf on Apache</li>
</ul>



Old New Date Created Author Actions
April 5, 2014 @ 20:23:42 Danita
April 5, 2014 @ 20:04:01 Danita