64.2 Using the calhost.cfg File

Some aspects of the Calendar Publishing Host cannot be configured in the Administration Web console, so you must manually edit the calhost.cfg file instead.

64.2.1 Editing the calhost.cfg File

You can use any ASCII text edit that you prefer to edit the calhost.cfg file.

IMPORTANT:It is strongly recommended that you do not modify any settings that are not documented in the following sections.

64.2.2 Setting the Published Calendar Auto-Refresh Interval

By default, when users view a published calendar, the calendar view in the user’s browser is not refreshed while users are viewing the calendar. You can configure the Calendar Publishing Host to automatically refresh the information that displays in a published calendar. This is especially helpful when calendars for resources such as conference rooms are published and displayed outside of the rooms.

  1. Edit the calhost.cfg file.

  2. Find the line that starts with:

    Templates.Content.Refresh=
    
  3. Replace 0 (zero) with the number of seconds after which you want the Calendar Publishing Host to refresh the content of published calendars.

  4. Save the calhost.cfg file, then exit the text editor.

  5. Skip to Section 64.2.6, Restarting the Web Server.

64.2.3 Setting the Default Published Calendar View

By default, published calendars are displayed in the Week view. A Day view and a Month view are also available.

  1. Edit the calhost.cfg file.

  2. Find the line that starts with:

    User.Calendar.defaultView=
    
  3. Replace Week with Day or Month as desired.

  4. Save the calhost.cfg file, then exit the text editor.

  5. Skip to Section 64.2.6, Restarting the Web Server.

64.2.4 Configuring an External POA IP Address

If the POAs in your GroupWise system are configured to use an external IP address, as described in Section 36.3.1, Securing Client/Server Access through an External Proxy Server, you can configure the Calendar Publishing Host to always communicate with the POAs in your GroupWise system through that same external IP address.

  1. Edit the calhost.cfg file.

  2. Find the line that starts with:

    po.1.Is.IPAddress.External=
    
  3. Replace 0 with 1 to enable this functionality.

  4. Add the following lines to the calhost.cfg file to define the external POA:

    po.1.IPAddress=ip_address
    po.1.port=calendar_publishing_port
    
    1. Replace ip_address with the external IP address used by the POAs in your GroupWise system.

    2. Replace calendar_publishing_port with the calendar publishing port number for the POAs.

      The default calendar publishing port number is 80.

  5. Save the calhost.cfg file, then exit the text editor.

  6. Skip to Section 64.2.6, Restarting the Web Server.

64.2.5 Changing the SSL Trusted Root Certificate

LDAP authentication using SSL was originally set up during installation, as described in Configuring Authentication to the Administration Web Console in Installing the GroupWise Calendar Publishing Host in the GroupWise 2012 Installation Guide. If you need to change the SSL trusted root certificate information, you can rerun the Calendar Publishing Host Installation program and specify new information, as described in Installing the GroupWise Calendar Publishing Host in Installation in the GroupWise 2012 Installation Guide, or you can edit the calhost.cfg file, as described below.

  1. Edit the calhost.cfg file.

  2. Find the line that starts with:

    Admin.Ldap.trustedRoot=
    
  3. Specify the full path to the trusted root certificate file.

  4. Save the calhost.cfg file, then exit the text editor.

  5. Skip to Section 64.2.6, Restarting the Web Server.

64.2.6 Restarting the Web Server

After you edit the calhost.cfg file, you must restart Apache and Tomcat in order to put the changes into effect.

OES 11:

rcnovell-tomcat6 stop
rcapache2 stop
rcapache2 start
rcnovell-tomcat6 start

OES 2 Linux:

rcnovell-tomcat5 stop
rcapache2 stop
rcapache2 start
rcnovell-tomcat5 start

SLES 11:

rctomcat6 stop
rcapache2 stop
rcapache2 start
rctomcat6 start

SLES 10:

rctomcat5 stop
rcapache2 stop
rcapache2 start
rctomcat5 start

Windows:

  1. At the Windows server, click Start > Administrative Tools > Services.

  2. Right-click Tomcat 6, then click Restart.

  3. Right-click World Wide Web Publishing Service, then click Restart.