78.2 Using the calhost.cfg File

Some aspects of the CalPub Host cannot be configured in the CalPub Admin console, so you must manually edit the calhost.cfg file instead.

78.2.1 Editing the calhost.cfg File

The location of the calhost.cfg file varies by platform:

Linux:	/var/opt/novell/groupwise/calhost
Windows:	c:\Novell\GroupWise\calhost

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.

78.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 CalPub 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.

Edit the calhost.cfg file.
Find the line that starts with:
```
Templates.Content.Refresh=
```
Replace 0 (zero) with the number of seconds after which you want the CalPub Host to refresh the content of published calendars.
Save the calhost.cfg file, then exit the text editor.
Skip to Section 78.1.6, Putting the CalPub Host Configuration Changes into Effect.

78.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.

Edit the calhost.cfg file.
Find the line that starts with:
```
User.Calendar.defaultView=
```
Replace Week with Day or Month as desired.
Save the calhost.cfg file, then exit the text editor.
Skip to Section 78.1.6, Putting the CalPub Host Configuration Changes into Effect.

78.2.4 Controlling Items Displayed

By default, published calendars display appointments, notes, and tasks. You can change what is displayed by following the steps below.

Edit the calhost.cfg file.
Find the following lines:

User.Calendar.Hide.appointment=false

User.Calendar.Hide.note=false

User.Calendar.Hide.task=false
Change the ones you want to hide from false to true.
Save the calhost.cfg file, then exit the text editor.
Skip to Section 78.1.6, Putting the CalPub Host Configuration Changes into Effect.

78.2.5 Configuring an External POA IP Address

If the POAs in your GroupWise system are configured to use an external IP address, you can configure the CalPub Host to always communicate with the POAs in your GroupWise system through that same external IP address. For more information about external POAs, see Section 15.3.1, Securing Client Access through an External Proxy Server.

Edit the calhost.cfg file.
Find the line that starts with:
```
po.1.Is.IPAddress.External=
```
Replace 0 with 1 to enable this functionality.
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.
Save the calhost.cfg file, then exit the text editor.
Skip to Section 78.1.6, Putting the CalPub Host Configuration Changes into Effect.

78.2.6 Providing an SSL Trusted Root Certificate

If you are using an LDAP directory such as NetIQ eDirectory or Microsoft Active Directory for authentication to your GroupWise system, and if you want to protect the CalPub Host console with an SSL connection, you must provide the trusted root certificate for the LDAP server.

Edit the calhost.cfg file.
Find the line that starts with:
```
Admin.Ldap.trustedRoot=
```
Specify the full path to the trusted root certificate file.
Save the calhost.cfg file, then exit the text editor.
Skip to Section 78.1.6, Putting the CalPub Host Configuration Changes into Effect.