Novell GROUPWISE 8 - MONITOR User manual

Calendar Publishing Host
XIII
983
novdocx (en) 22 June 2009
XIII
Calendar Publishing Host
Chapter 58, “Configuring the Calendar Publishing Host,” on page 985
Chapter 59, “Monitoring Calendar Publishing,” on page 993
Chapter 60, “Creating a Corporate Calendar Browse List,” on page 995
Chapter 61, “Managing Your Calendar Publishing Host,” on page 997

984 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009

Configuring the Calendar Publishing Host
58
985
novdocx (en) 22 June 2009
58
Configuring the Calendar
Publishing Host
For detailed instructions about installing and setting up the GroupWise®Calendar Publishing Host
for the first time, see “Installing the GroupWise Calendar Publishing Host” in the GroupWise 8
Installation Guide. The default configuration of the Calendar Publishing Host is adequate to begin
publishing calendars. As your GroupWise system grows and evolves, you might need to modify its
configuration to meet the changing needs of the users it services.
Section 58.1, “Logging In to the Administration Web Console,” on page 985
Section 58.2, “Changing Post Office Settings,” on page 985
Section 58.3, “Adjusting Log Settings,” on page 986
Section 58.4, “Configuring LDAP Authentication,” on page 988
Section 58.5, “Customizing the Calendar Publishing Host Logo,” on page 989
Section 58.6, “Logging Out of the Administration Web Console,” on page 990
Section 58.7, “Changing the SSL Trusted Root Certificate,” on page 990
58.1 Logging In to the Administration Web
Console
The Calendar Publishing Host Administration Web console is a browser-based administration tool
that enables you to easily change the configuration of the Calendar Publishing Host.
1Display the Calendar Publishing Host Administration Web console login page:
http://network_address/gwcal/admin
2Provide the administrative user and password you set up in “Setting Up a Calendar Publishing
Host” in the GroupWise 8 Installation Guide, then click Login.
58.2 Changing Post Office Settings
1Log in to the Calendar Publishing Host Administration Web console.

986 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
The Post Office page provides the information that the Calendar Publishing Host needs in order
to communicate with a POA to obtain calendar and free/busy information. The initial
information was provided during installation, as described in “Configuring a POA for Calendar
Publishing” in “Installing the GroupWise Calendar Publishing Host” in the GroupWise 8
Installation Guide.
2Change the post office settings as needed.
Post office network address: Specify the IP address or DNS hostname of the POA that is
configured for calendar publishing.
Post office TCP port: Specify the calendar publishing port that the POA uses to communicate
with the Calendar Publishing Host.
3If you make changes, click Save.
58.3 Adjusting Log Settings
1Log in to the Calendar Publishing Host Administration Web console, then click Logging to
define log settings for the Calendar Publishing Host:

Configuring the Calendar Publishing Host 987
novdocx (en) 22 June 2009
Logging is enabled by default. Default settings are provided for the rest of the fields.
2Change the Calendar Publishing Host log settings as needed:
Enable Logging: Deselect this option to turn off Calendar Publishing Host logging.
Log File Path: The default log file location varies by Web server platform:
Change the log file settings as needed:
Max Size for Log Files: Specify in kilobytes the maximum size for log files. When the
combined size of log files reaches this size the oldest log files are deleted.
Max Log File Age: Specify the number of days for the maximum age for a log file. When a log
file reaches this age, it is deleted.
Log Level: Select the level of detail that you want recorded in the log file.
Use Tomcat Log File: Select this option if you want the same information logged to the
Tomcat log file as is logged to the Calendar Publish Host log file.
NetWare: sys:\Novell\GroupWise\calhost\logs
OES Linux: /var/opt/novell/groupwise/calhost/logs
SLES: /var/opt/novell/groupwise/calhost/logs
Windows: c:\Novell\GroupWise\calhost\logs

988 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
3If you make changes, click Save.
58.4 Configuring LDAP Authentication
1Log in to the Calendar Publishing Host Administration Web console, then click Authentication.
The Authentication page provides the information that the Calendar Publishing Host needs in
order to log into eDirectory. The Calendar Publishing Host uses LDAP authentication to log in.
The initial information was provided during installation, as described in “Setting Up Calendar
Publishing Administration” in “Installing the GroupWise Calendar Publishing Host” in the
GroupWise 8 Installation Guide.
2Change the authentication information as needed:
LDAP Authority Network Address: Specify the IP address or DNS hostname of an LDAP
server where users of the Calendar Publishing Host Administration Web console have
accounts. Include the port number (typically 389 for non-secure connections and 636 for secure
SSL connections).
LDAP Context. Specify the context in which the User objects for Calendar Publishing Host
administrators are located. The variable {0} represents whatever username is provided on the
Administration Web console login page. The User object for the administrator must be located
in the specified context. By providing the context here, administrators do not need to provide
the context when they log in to the Administration Web console.
NetWare: sys:\tomcat\4\logs
OES Linux: /var/opt/novell/tomcat5/logs
SLES: /srv/www/tomcat5/base/logs
Windows: c:\Novell\GroupWise\tomcat5.5\logs

Configuring the Calendar Publishing Host 989
novdocx (en) 22 June 2009
Required LDAP Attribute: By default, the Calendar Publishing Host checks users for
membership in a specific group before it grants access to the Calendar Publishing Host
Administration Web console. This default is typically appropriate.
Required LDAP Value: If you retain the default LDAP attribute of groupMembership, specify
the full context of the group to which Calendar Publishing Host administrator users must
belong in order to log in to the Administration Web console. If you change the default LDAP
attribute, specify the required value for that attribute.
3If you make changes, click Save.
The SSL trusted root certificate that you supplied when you installed the Calendar Publishing Host
cannot be changed from the Administration Web console. If you need to change the certificate
information, see Section 58.7, “Changing the SSL Trusted Root Certificate,” on page 990.
58.5 Customizing the Calendar Publishing Host
Logo
1Log in to the Calendar Publishing Host Administration Web console, then click Customize to
modify the appearance of the main browser page displayed by the Calendar Publishing Host.
The Customize page enables you to use a different logo, perhaps your company logo, on the
main Calendar Publishing Web page.
2Provided the information for your company logo:
Logo Image: Specify the full path and filename of the customized image file.
Logo Text: Specify the text to accompany the customized image.
Logo Text Position: Select Top, Middle, or Bottom, based on the example displayed in the box
below the field.
3Click Save.

990 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009
58.6 Logging Out of the Administration Web
Console
When you close the browser page, you are automatically logged out of the Calendar Publishing Host
Web console.
The Calendar Publishing Host checks its configuration file (
calhost.cfg ) every 10 minutes.
Therefore, it can take up to 10 minutes for the changes you made in the Administration Web console
to take effect in the functionality of the Calendar Publishing Host.
58.6.1 Restarting Tomcat
If you want your changes to take effect immediately, restart Tomcat:
58.7 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 8 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 Calendar Publishing Host”, or you can
edit the
calhost.cfg file, as described below.
1Edit the
calhost.cfg file in a text editor.
The default file location varies by Web server platform:
2Find the line that starts with:
Admin.Ldap.trustedRoot=
3Specify the full path to the trusted root certificate file.
NetWare:
unload java
load tomcat4
Linux: Novell Open Enterprise Server 2 Linux installation of Apache:
/etc/init.d/novell-tomcat5 stop
/etc/init.d/novell-tomcat5 start
SUSE Linux Enterprise Server 10 installation of Apache:
/etc/init.d/tomcat5 stop
/etc/init.d/tomcat5 start
Windows 1. At the Windows server, click Start > Administrative Tools > Services.
2. Right-click Tomcat 5.5, then click Restart.
NetWare:
sys:\Novell\GroupWise\calhost
OES Linux: /var/opt/novell/groupwise/calhost
SLES: /var/opt/novell/groupwise/calhost
Windows: c:\Novell\GroupWise\calhost

Configuring the Calendar Publishing Host 991
novdocx (en) 22 June 2009
4Save the calhost.cfg file, then exit the text editor.
5Restart the Web server:
NetWare:
unload apache2
unload java
tomcat4
apache2
Linux: Novell Open Enterprise Server 2 Linux installation of Apache:
/etc/init.d/apache2 stop
/etc/init.d/novell-tomcat5 stop
/etc/init.d/novell-tomcat5 start
/etc/init.d/apache2 start
SUSE Linux Enterprise Server 10 installation of Apache:
/etc/init.d/apache2 stop
/etc/init.d/tomcat5 stop
/etc/init.d/tomcat5 start
/etc/init.d/apache2 start
Windows 1. At the Windows server, click Start > Administrative Tools > Services.
2. Right-click Tomcat 5.5, then click Restart.
3. Right-click World Wide Web Publishing Service, then click Restart.

992 GroupWise 8 Administration Guide
novdocx (en) 22 June 2009