Upgrading the GroupWise Calendar Publishing Host

Revision for “Upgrading the GroupWise Calendar Publishing Host” created on April 5, 2014 @ 19:22:04

TitleContentExcerpt
Upgrading the GroupWise Calendar Publishing Host
<p class="Body"><span class="char-style-override-2">Upgrading the GroupWise Calendar Publish Host is relatively painless, and can be done as soon as the Post Offices it services are upgraded.</span></p>
<p class="Body"><span class="char-style-override-3">If you are running GroupWise Calendar Publishing Host along with GroupWise WebAccess and/or the GroupWise Monitor Application Host on the same server, all of these must be upgraded in the same upgrade cycle or the other applications will not work until they are upgraded.</span></p>
<p class="Body"><span class="char-style-override-3">There are new administration options for the Calendar Publishing Host though, and you will need to read the section below on </span></p>
<p class="Head1">Preparing for the Upgrade</p>
<p class="Body"><span class="char-style-override-2">There is very little preparation that must be made for the GroupWise Calendar Publishing Host upgrade. It can reside anywhere, and no database adjustments are made when it is installed. You must know the name of your Calendar Publishing Host. To find this information do the following:</span></p>
<ol>
<li class="Number-Step-1"><span class="char-style-override-2">In the Administration Console, click on System|Calendar Publishing.</span></li>
<li class="Number-Step"><span class="char-style-override-2">You will see a list of your Calendar Publishing Hosts.</span><ol><li class="Caption-1">List of Calendar Publishing Hosts<img class="Object-Style-1" width="71%" src="calhost-lulu-web-images/linuxinstall176_fmt.png" alt="linuxinstall176.tif"/></li></ol></li>
<li class="Number-Step">Note the name of the Calendar Publishing Host that you are upgrading. In our case it is CalPubHost.</li>
<li class="Number-Step">Now click on Post Office Agents, and choose the Post Office Agent in question. Ours is for our Caledonia Post Office.</li>
<li class="Number-Step">Click on the Agent Settings Tab.</li>
<li class="Number-Step">Scroll to the bottom of the page to view the Calendar Publishing Host settings. Note the Port Number. The default is 7171<ol><li class="Caption-1"><img class="Object-Style-1" width="74%" src="calhost-lulu-web-images/linuxinstall177_fmt.png" alt="linuxinstall177.tif"/>The Calendar Publishing settings</li></ol></li>
</ol>
<p class="Body"><span class="char-style-override-2"> Close this Window if you choose.</span></p>
<p class="Head1"><a id="Anchor-3"/><a id="Anchor-4"/>Installing the Calendar Publishing Host Software</p>
<p class="Head2">Windows </p>
<p class="Body">To install the Calendar Publishing Host software perform the following:</p>
<ol>
<li class="Number-Step-1"><span class="char-style-override-2">From the Windows server where IIS is installed, go to your</span><span class="Typed-in-Text" style="font-size:0.9em;"> &lt;installationfiles&gt;</span><span class="char-style-override-2"> and run </span><span class="Typed-in-Text" style="font-size:0.9em;">setup.exe</span><span class="char-style-override-2">.</span></li>
<li class="Number-Step"><span class="char-style-override-2">Choose GroupWise Calendar Publishing Host.</span><ol><li class="Caption-1"><img class="Object-Style-1" width="78%" src="calhost-lulu-web-images/linuxinstall179_fmt.png" alt="linuxinstall179.tif"/>Installing the Calendar Publishing Host</li></ol></li>
<li class="Number-Step"><span class="char-style-override-2">Choose your language.</span></li>
<li class="Number-Step"><span class="char-style-override-2">At the prompt, click next</span></li>
<li class="Number-Step"><span class="char-style-override-2">Accept the license agreement.</span></li>
<li class="Number-Step"><span class="char-style-override-2">Enter the Calendar Publishing Host Name. In our case this is CalPubHost</span></li>
<li class="Number-Step"><span class="char-style-override-2">Choose the IIS web server instances for your Calendar Publishing Host</span></li>
<li class="Number-Step"><span class="char-style-override-2">Enter the IP address of the POA for your Calendar Publishing Host. Ours is 192.168.110.192</span></li>
<li class="Number-Step"><span class="char-style-override-2">Enter the Calendar Publishing Port Number that we looked up above. The default is 7171.</span></li>
<li class="Number-Step"><span class="char-style-override-2">At the Summary screen, confirm that everything is configured as you would like it to be. Then click Install.</span></li>
<li class="Number-Step"><span class="char-style-override-2">During the installation, you may be prompted about shutting down the web server and Java and overwriting newer files. You should choose the affirmative answer for all of these questions.</span></li>
<li class="Number-Step"><span class="char-style-override-2">When the installation is complete you will be presented with steps to configure your Calendar Publishing Host. Since this is an upgrade, that should already be completed. Click Next.</span></li>
<li class="Number-Step"><span class="char-style-override-2">You will be prompted to launch the Installation Summary and restart the web server. </span></li>
</ol>
<p class="Head2">Linux </p>
<p class="Body">Here are the quick steps needed to install the Calendar Publishing Host on Linux.</p>
<ol>
<li class="Number-Step"><span class="char-style-override-2">As root, run the </span><span class="Typed-in-Text" style="font-size:0.9em;">install.sh</span><span class="char-style-override-2"> script in your </span><span class="Typed-in-Text" style="font-size:0.9em;">&lt;installationfile&gt; </span><span class="char-style-override-2">folder.</span></li>
<li class="Number-Step"><span class="char-style-override-2">Choose your Language.</span></li>
<li class="Number-Step"><span class="char-style-override-2">Choose Installation.</span></li>
<li class="Number-Step"><span class="char-style-override-2">Accept the License Agreement.</span></li>
<li class="Number-Step"><span class="char-style-override-2">Choose GroupWise Calendar Publishing Host.</span><ol><li class="Caption-1"><span><img class="Object-Style-1" width="82%" src="calhost-lulu-web-images/linuxinstall174_fmt.png" alt="linuxinstall174.tif"/>The Calendar Publishing Host Installation</span></li></ol></li>
<li class="Number-Step"><span class="char-style-override-2">Choose Install</span></li>
<li class="Number-Step"><span class="char-style-override-2">The installation will begin. Tomcat and Apache will be unloaded during the installation. Press Any Key to Continue.</span></li>
<li class="Number-Step"><span class="char-style-override-2">After the files are installed, choose Configure</span></li>
<li class="Number-Step"><span class="char-style-override-2">Press 1 to continue</span></li>
<li class="Number-Step"><span class="char-style-override-2">Enter the Calendar Publishing Host Name. In our case this is CalPubHost</span></li>
<li class="Number-Step"><span class="char-style-override-2">Enter the IP address of the POA for your Calendar Publishing Host. Ours is 192.168.110.192</span></li>
<li class="Number-Step"><span class="char-style-override-2">Enter the Calendar Publishing Port Number that we looked up above. The default is 7171.</span></li>
<li class="Number-Step"><span class="char-style-override-2">At the next screen, unless you have configured custom locations for Apache and/or Tomcat, the defaults should be correct.</span></li>
<li class="Number-Step"><span class="char-style-override-2">After the installation, you will be instructed to restart Apache2 and Tomcat6</span></li>
</ol>
<p class="Body"/>
<p class="Head1">Loading The GroupWise Calendar Publishing Host</p>
<p class="Body">Now we will load the web server and the Tomcat. The instructions for loading the web server or Tomcat are different based upon the platform you are using. </p>
<p class="Head2">Linux</p>
<p class="Body"/>
<p class="Body"><span class="char-style-override-2">Assuming you are using the default Apache2 and Tomcat6 installations on your Linux server, load the components thusly:</span></p>
<p class="Body"/>
<p class="Typed-In-Text">/etc/init.d/apache2 start</p>
<p class="Body">and</p>
<p class="Typed-In-Text">/etc/init.d/novell-tomcat6 start (OES)</p>
<p class="Body">or</p>
<p class="Typed-In-Text">/etc/init.d/tomcat6 start (SLES)</p>
<p class="Body"/>
<p class="Body"><span class="char-style-override-2">You can also check status, stop and restart using these scripts.</span></p>
<p class="Body"/>
<p class="Head2">Microsoft IIS – Web Server</p>
<p class="Body"/>
<p class="Body"><span class="char-style-override-2">The GroupWise Calendar Publishing Host is designed to start when the Microsoft IIS Service and Web Server is started. The Microsoft IIS Web Server is designed to start with the Microsoft Internet Information Server Service is started under Control Panel|Administrative Tools|Services.</span></p>
<p class="Body"/>
<p class="Head1">Checking the GroupWise Calendar Publishing Host</p>
<p class="Body"/>
<p class="Body"><span class="char-style-override-2">Just point your browser to</span></p>
<p class="Body"/>
<p class="Typed-In-Text">http://yourserver.com/gwcal </p>
<p class="Typed-In-Text"/>
<p class="Body"><span class="char-style-override-2">For example:</span></p>
<p class="Typed-In-Text">http://groupwise.caledonia.net/gwcal</p>
<p class="Body"/>
<p class="Body"><span class="char-style-override-2">You will see any published calendars that are available for the System.</span></p>
<ol class="List-1">
<li class="Caption-1"><img class="Object-Style-1" width="86%" src="calhost-lulu-web-images/linuxinstall178_fmt.jpeg" alt="linuxinstall178.tif"/>Published Calendars</li>
</ol>
<p class="Head1">Configuring Calendar Publishing Host Administration</p>
<p class="Body">After you have upgraded your Calendar Publishing Host and have verified that it is working, it’s time to look at the new administration options. Similarly to WebAccess, Calendar Publishing Host now has its own configuration file on the web server.</p>
<p class="Body">Let’s go to look at this file. </p>
<p class="Body">Linux: /var/opt/novell/groupwise/calhost/calhost.cfg</p>
<p class="Body">Windows: c:\novell\groupwise\calhost\calhost.cfg</p>
<p class="Body"><span class="char-style-override-2">This file will look very similar to the webacc.cfg that you are probably familiar with.</span></p>
<p class="Head2">Enable the CalHost Administration Console</p>
<ol>
<li class="Number-Step-1">In your favorite text editor, search for the line that reads</li>
</ol>
<p class="Typed-In-Text"> Admin.WebConsole.enable=false</p>
<ol>
<li class="Number-Step">If this is preceded by a # sign, remove the # to activate this line</li>
<li class="Number-Step">change false to true.</li>
</ol>
<p class="Body"/>
<p class="Body">Now you must restart Tomcat on your server</p>
<p class="Body">For Linux, run</p>
<p class="Typed-In-Text">/etc/init.d/novell-tomcat6 start (OES)</p>
<p class="Body">or</p>
<p class="Typed-In-Text">/etc/init.d/tomcat6 start (SLES)</p>
<p class="Typed-In-Text"/>
<p class="Body">On Windows, click Start &gt; Administrative Tools &gt; Services. Then right-click Tomcat 6, and click Restart.</p>
<p class="Body"/>
<p class="Head2">Load the CalHost Administration Console</p>
<p class="Body">To load the CalHost Administration Console, navigate to your server in a web browser like this:</p>
<p class="Body">http://yourserver.com/gwcal/admin</p>
<p class="Body"><span class="char-style-override-2">You will be prompted to login. Use your gwadmin user credentials you created when we set up the system. Any user who has rights as a Post Office Administrator or higher can log into this console with their own GroupWise credentials.</span></p>
<ol class="List-1">
<li class="Caption-1"><img class="Object-Style-1" width="31%" src="calhost-lulu-web-images/linuxinstall189_fmt.png" alt="linuxinstall189.tif"/>Logging into the Calendar Publishing Host Administration Console</li>
</ol>
<p class="Head2">Post Office Settings</p>
<p class="Body">You will be presented with the following screen:</p>
<p class="Body"/>
<ol class="List-1">
<li class="Caption-1"><img class="Object-Style-1" width="74%" src="calhost-lulu-web-images/linuxinstall190_fmt.png" alt="linuxinstall190.tif"/>The Calendar Publishing Host Administration Console</li>
</ol>
<p class="Body">This screen will show you the settings that were migrated to the new Calendar Publishing Host configuration during upgrade. If the IP address of your POA were to change, you would edit that here.</p>
<p class="Body">We’ll quickly run through the other screens of this administration console.</p>
<p class="Head2">Logging Settings</p>
<p class="Body">On the Logging Screen you can set your logging settings.</p>
<p class="Body"/>
<ol class="List-1">
<li class="Caption-1"><img class="Object-Style-1" width="78%" src="calhost-lulu-web-images/linuxinstall191_fmt.png" alt="linuxinstall191.tif"/>The CalHost Log Settings</li>
</ol>
<p class="Body">These settings are very similar to the logging settings for all of your GroupWise agents. The one addition here is that you can choose to log both to the GroupWise agent logs and the Tomcat logs if you desire.</p>
<p class="Body"/>
<p class="Head2">Authentication Settings</p>
<p class="Body">If you need to change which Administration Service the Calendar Publishing Host Admin authenticates to, you can do so here. </p>
<p class="Body"/>
<ol class="List-1">
<li class="Caption-1"><img class="Object-Style-1" width="82%" src="calhost-lulu-web-images/linuxinstall192_fmt.png" alt="linuxinstall192.tif"/>Calendar Publishing Host Admin Authentication Settings</li>
</ol>
<p class="Body">Please be aware that this can be affected by the settings we described in <span class="Cross-Reference">“Verifying MTA Network Settings”</span> on page <span>12</span>.</p>
<p class="Head2">Customize</p>
<p class="Body">If you click on the Customize tab, you can change the way the published calendars page looks. For example, we’ve added a Caledonia logo, changed the text and placed the changed text at the bottom edge of the logo.</p>
<ol class="List-1">
<li class="Caption-1"><img class="Object-Style-1" width="82%" src="calhost-lulu-web-images/linuxinstall209_fmt.png" alt="linuxinstall209.tif"/>Client Customization Settings</li>
<li class="Caption-1"><img class="Object-Style-1" width="82%" src="calhost-lulu-web-images/linuxinstall193_fmt.jpeg" alt="linuxinstall193.tif"/>CalPub Customizations</li>
</ol>
<p class="Body"/>
<p class="Head2">Updating your Changes</p>
<p class="Body">You will notice that on all of the setup screens above there is a notice that you may need to wait up to 10 minutes for changes to occur. </p>
<p class="Body">There is a setting in the <span class="Typed-in-Text" style="font-size:0.9em;">calhost.cfg</span> that defines this time</p>
<p class="Body">Config.Update.check=10</p>
<p class="Body">While it would be possible to set this for a shorter timeframe, you can also simply restart Tomcat to effect a change immediately. </p>
<p class="Body">For Linux, run</p>
<p class="Typed-In-Text">/etc/init.d/novell-tomcat6 start (OES)</p>
<p class="Body">or</p>
<p class="Typed-In-Text">/etc/init.d/tomcat6 start (SLES)</p>
<p class="Typed-In-Text"/>
<p class="Body">On Windows, click Start &gt; Administrative Tools &gt; Services. Then right-click Tomcat 6, and click Restart.</p>
<p class="Head1">Troubleshooting</p>
<p class="Body">There is little that might go wrong with the actual Calendar Publishing Host upgrade. That said, the addition of the Calendar Publishing Host Administration Console can have its moments!</p>
<p class="Body">There are settings in the <span class="Typed-in-Text" style="font-size:0.9em;">calhost.cfg</span> that pertain to how the new admin console connects to the GroupWise Administration Service.</p>
<p class="Body"/>
<p class="Typed-In-Text"> ######################################################################</p>
<p class="Typed-In-Text"> # Application Administration Tool</p>
<p class="Typed-In-Text"> ######################################################################</p>
<p class="Typed-In-Text"> Admin.WebConsole.enable=true</p>
<p class="Typed-In-Text"> Admin.RestService.host=127.0.0.1</p>
<p class="Typed-In-Text"> Admin.RestService.port=9710</p>
<p class="Body"/>
<p class="Body">There are a couple of reasons why these default settings might not work for you:</p>
<ul class="List-2">
<li class="Bullet">If you are running the Calendar Publishing Host on a server that does not have a GroupWise Administration Service running, the setting of 127.0.0.1 will be invalid. You will need to change it to the proper ID address.</li>
<li class="Bullet">If you have an MTA running on this server, but it is set to bind to a specific IP address, the Admin Service will also not be listening on localhost (127.0.0.1) and you should change this to the specific location. Indeed, if your MTA is set to a host name rather than an IP address, the Admin Service could complain if you enter an IP address here. Test to see which works properly for you.</li>
<li class="Bullet">If you have modified the default port for your Admin Service, you will also need to change the information here.</li>
</ul>
<p class="Body"/>
<p class="Body"><span class="char-style-override-2">Once you are ready to continue, just turn to the next chapter in your upgrade plan.</span></p>
<p class="Typed-In-Text"/>
</div>
</div>
</body>
</html>



Old New Date Created Author Actions
April 5, 2014 @ 19:22:04 Danita