6.4 Setting Up a Calendar Publishing Host

As you set up the Calendar Publishing Host, use the GroupWise Calendar Publishing Host Installation Summary Sheet that you filled out in Section 6.3, Planning a Calendar Publishing Host to provide the required information.:

6.4.1 Installing the Calendar Publishing Host

NetWare and Windows: Installing the Calendar Publishing Host Software

  1. Make sure that you have created the Calendar Publishing Host administrative user and group, and that the Calendar Publishing Host server is configured for an SSL LDAP connection, as described in Section 6.3.7, Configuring Authentication to the Administration Web Console.

  2. Select an appropriate location to run the GroupWise Installation program.

    NetWare:

    If you are installing the Calendar Publishing Host on NetWare, you can run the Installation program from any Windows machine that meets the administrator machine requirements listed in Section 2.1, GroupWise Administration Requirements.

    Windows:

    If you are installing the Calendar Publishing Host on Windows, you must run the Installation program at the Windows Web server were you want to install the Calendar Publishing Host. It must meet the administrator machine requirements as well as the server operating system requirements listed in Section 2.1, GroupWise Administration Requirements.

  3. Log in as an Admin equivalent to the eDirectory tree where GroupWise is installed.

  4. Insert the GroupWise 8 DVD into the DVD drive to start the GroupWise Installation program.

    or

    Run setup.exe from the root of the downloaded GroupWise 8 software image.

    or

    If you have already copied the Calendar Publishing Host software to a software distribution directory, run setup.exe from the root of the software distribution directory.

  5. Select the language in which you want to run the GroupWise Installation program, then click OK.

    NOTE:All available languages are included on the GroupWise 8 DVD and the multilanguage version of the downloaded GroupWise 8 software image, but you can select which languages you want to install.

    The main GroupWise System Installation page appears.

    GroupWise Installation program main page
  6. Click More Components, then click Install Calendar Publishing Host to start the Calendar Publishing Host Installation program.

  7. Select the language in which you want to run the Calendar Publishing Host Installation program, then click OK.

  8. Click Yes to accept the License Agreement and start the Calendar Publishing Host installation.

    GroupWise Calendar Publishing Host Installation dialog box
  9. Follow the prompts to provide the information from your GroupWise Calendar Publishing Host Installation Summary Sheet.

  10. When the installation is complete, select from the following options:

    Installation Complete page

    Launch Installation Summary: This option displays a list of the information you provided during installation. You can print it for future reference.

    Restart the Web Server: This option starts the Web server, which loads the Calendar Publishing Host Application.

    NOTE:If you installed the Calendar Publishing Host to the Internet Information Server (IIS) on Windows, the Calendar Publishing Host Installation program automatically installed Tomcat 5.5 to the following directory on your Windows Web server:

    c:\novell\groupwise\tomcat5.5
    

    The Installation program then starts Tomcat as a Windows service for use by the Calendar Publishing Host.

  11. Click Finish to exit the Calendar Publishing Host Installation program.

  12. Click Finish to exit the GroupWise Installation program as well.

    After installing the Calendar Publishing Host, additional configuration in ConsoleOne is still required.

  13. Skip to Section 6.4.2, Configuring the Calendar Publishing Host in ConsoleOne.

Linux: Installing the Calendar Publishing Host Software

  1. Make sure that Apache 2 and Tomcat 5 are installed as your Web server.

    They might not be installed by default on your Linux server.

  2. Make sure that LDAP is running on your eDirectory server.

  3. Make sure that you have created the Calendar Publishing Host administrative user and group, and that the Calendar Publishing Host server is configured for an SSL LDAP connection, as described in Section 6.3.7, Configuring Authentication to the Administration Web Console.

  4. Insert the GroupWise 8 DVD into the DVD drive to start the GroupWise Installation program.

    or

    Run install from the root of the downloaded GroupWise 8 software image.

    or

    If you have already copied the Calendar Publishing Host software to a software distribution directory, run ./install from the root of the software distribution directory.

    The X Window System is required for running the GUI GroupWise Installation program. If you are not using the X Window System, you can install GroupWise components individually, as described in Installing the GroupWise Agents Using the Text-Based Installation Program.

  5. Select the language in which you want to run the GroupWise Installation program, then click OK.

    NOTE:On Linux, all available languages are included in the same RPM, so all languages are always installed.

    The main GroupWise System Installation page appears.

    GroupWise Installation program
  6. Click Install Products > GroupWise Calendar Publishing Host > Install Calendar Publishing Host Application to start the Calendar Publishing Host Installation program.

  7. When the software installation is complete, click OK.

    The Calendar Publishing Host software is installed to the following directories:

    /opt/novell/groupwise/calhost
    /etc/opt/novell/groupwise/calhost
    /var/opt/novell/groupwise/calhost
    

    and is linked into Tomcat.

  8. Click Configure Calendar Publishing Host Application.

    Calendar Publishing Host Installation program
  9. Click Next, accept the License Agreement, then click Next.

  10. Follow the prompts to configure the Calendar Publishing Host, using the following information from the GroupWise Calendar Publishing Host Installation Summary Sheet:

    Configuration Complete page
  11. Click Exit to exit the Calendar Publishing Host Installation program.

  12. Exit the GroupWise Installation program as well.

    After installing the Calendar Publishing Host, additional configuration in ConsoleOne is still required.

  13. Continue with Configuring the Calendar Publishing Host in ConsoleOne.

6.4.2 Configuring the Calendar Publishing Host in ConsoleOne

Use the information under Calendar Publishing Host Configuration and Calendar Browse List on your GroupWise Calendar Publishing Host Installation Summary Sheet as you configure the Calendar Publishing Host.

  1. In ConsoleOne, select the GroupWise System object, then click Tools > GroupWise System Operations > Web Calendar Publishing Hosts.

  2. Click Add.

    Add Web Calendar Publish Host dialog box
  3. Specify a unique name by which the Calendar Publishing Host will be known in your GroupWise system.

    IMPORTANT:This must be the same name that you used during installation, as described in Section 6.3.3, Determining the Configuration of the Calendar Publishing Host. If you decide that you want to use a different name after you have already installed the Calendar Publishing Host software, you must reinstall the software, then specify the same name that you provided during installation when you configure the Calendar Publishing Host in ConsoleOne.

  4. Specify the base URL for the Calendar Publishing Host in the following format:

    http://web_server_address:port/gwcal
    

    where web_server_address is the IP address or DNS hostname of the Web server where you installed the Calendar Publishing Host software and port is the port number on which the Calendar Publishing Host communicates with the Web server. The default port number is 80 and does not need to be specified if your Web server uses that default.

    The base URL does not point to information that is displayable in your browser. Displayable URLs are listed in Section 6.3.3, Determining the Configuration of the Calendar Publishing Host.

  5. Specify the IP address of the server where the Calendar Publishing Host is running.

    This information enables the POA to communicate with the Calendar Publishing Host.

  6. Specify the TCP port number on which the Calendar Publishing Host is configured to communicate with the POA.

    The default is 7171.

  7. Click OK to save the Calendar Publishing Host configuration information.

    Configure Web Calendar Publishing Host dialog box
  8. If you want to allow users to add their published calendars to the calendar browse list as the default for your GroupWise system, select Enable Publishing of Calendars to the Browse List.

    or

    If you want to set up a corporate calendar browse list or provide no calendar browse list, leave Enable Publishing of Calendars to the Browse List deselected.

  9. Click OK when you are finished.

  10. Restart the POA so that it picks up the configuration information for the new Calendar Publishing Host.

  11. Continue with Enabling Calendar Publishing.

6.4.3 Enabling Calendar Publishing

Use the information under Calendar Publishing Options on your GroupWise Calendar Publishing Host Installation Summary Sheet as you enable calendar publishing.

  1. In ConsoleOne, browse to and select post office where you want to enable calendar publishing.

    For convenience in testing your Calendar Publishing Host setup, you might want to start with your post office.

  2. Click Tools > GroupWise Utilities.

  3. Click Client Options > Environment > Calendar.

    Environment Options: Calendar dialog box

    The calendar publishing options are disabled by default. As you roll out calendar publishing, you can use Client Options to enable it at the domain, post office, and user level.

  4. Select a Calendar Publishing Host from the drop-down list.

  5. Set the Calendar options as you planned under Calendar Publishing Options on your GroupWise Calendar Publishing Host Installation Summary Sheet.

  6. Click OK to save the calendar publishing settings, then click Close.

  7. Continue with Restarting the Web Server and Tomcat

6.4.4 Restarting the Web Server and Tomcat

To put the ConsoleOne settings into effect, you must restart the Web server and Tomcat.

NetWare:

NetWare 6.5:

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.

This loads the Calendar Publishing Host into your Web server so that it is available for use.

Continue with Configuring a POA for Calendar Publishing.

6.4.5 Configuring a POA for Calendar Publishing

After calendar publishing is enabled, the POA can look up calendar information and return it to the Calendar Publishing Host in the form of ICS (Internet Calendaring and Scheduling) or IFB (Internet Free Busy) files. Internet users can import these files into GroupWise, Outlook, and Mac iCal calendaring applications.

Use the information under Calendar Publishing Post Office on your GroupWise Calendar Publishing Host Installation Summary Sheet as you configure the POA.

  1. In ConsoleOne, browse to and select the post office where calendar publishing is enabled, right-click the POA object for the post office, then click Properties.

  2. Click GroupWise > Agent Settings.

  3. Select Enable Calendar Publishing.

  4. Adjust the number in the Max Calendar Publishing Threads field as needed.

    The default maximum number of calendar publishing threads is 4. By default, the POA creates 2 calendar publishing threads and automatically creates additional threads as needed until the maximum number is reached. You cannot set the maximum higher than 4, but you can reduce the number of threads to conserve POA resources for other activities.

  5. Click OK to save the calendar publishing configuration settings.

  6. As you roll out calendar publishing to your GroupWise users, enable calendar publishing on the POA for each post office where users will publish calendars and free/busy information.

    To determine which POAs have been enabled for calendar publishing, see Viewing Calendar Publishing Status at the POA Web Console in Calendar Publishing Host in the GroupWise 8 Administration Guide.

6.4.6 Setting Up Calendar Publishing Administration

After calendar publishing has been enabled and the POA is communicating with the Calendar Publishing Host, you use the Calendar Publishing Host Administration Web console to monitor the Calendar Publishing Host and to make configuration changes as needed.

Use the information under Authentication Information on your GroupWise Calendar Publishing Host Installation Summary Sheet as you set up Calendar Publishing Host administration. You now set up the objects in ConsoleOne that correspond to the objects you specified during installation.

  1. In ConsoleOne, browse to and select the container where you want to have the calendar publishing administrator User and Group objects.

  2. If you want to create a new User object:

    1. Right-click the container, then click New > User.

    2. Fill in the required fields, including a password

    3. Click OK to create the new User object.

  3. Create the new administrative group.

    1. Right-click the container where the administrator User object is located, then click New > Group.

    2. Fill in the required fields.

    3. Click OK to create the new Group object.

  4. Right-click the new User object or an existing User object, then click Properties.

  5. Click Memberships > Group Membership.

  6. Click Add, select the new administrative group you created in Step 3, then click OK to assign the administrator user to the group.

  7. Click OK to close the Group Membership page.

  8. Continue with Using the Published Calendar Browse List.

6.4.7 Using the Published Calendar Browse List

If you selected Enable Publishing of Calendars to the Browse List as your GroupWise system default in Step 8 in Section 6.4.2, Configuring the Calendar Publishing Host in ConsoleOne, skip to Section 6.4.8, Testing Calendar Publishing.

If you are planning to implement a corporate calendar browse list, you can enable publishing of calendars to the browse list for yourself for testing purposes.

  1. Browse to and right-click your User object, then click Properties.

  2. Click GroupWise > Calendar Publishing.

  3. Select Override, then select Enable Publishing of Calendars to the Browse List.

    This give you the right to add your calendars to the calendar browse list so that you can test the setup of the Calendar Publishing Host.

  4. Continue with Testing Calendar Publishing.

6.4.8 Testing Calendar Publishing

Now that you have set up a Calendar Publishing Host, you can test it by:

Publishing a Personal Calendar

  1. In the GroupWise Windows client, create and populate a personal calendar, as described in Creating a Personal Calendar in Calendar in the GroupWise 8 Windows Client User Guide.

  2. Right-click the personal calendar, then click Publish.

    Department Calendar Properties dialog box
  3. Select Publish This Calendar.

    For more information, see Publishing Personal Calendars on the Internet in Calendar in the GroupWise 8 Windows Client User Guide.

    This feature is also available in the GroupWise WebAccess Client, as described in Publishing Personal Calendars on the Internet in the GroupWise 8 WebAccess Client User Guide.

    For more information, see the GroupWise 8 Calendar Publishing Host User Quick Start.

  4. Click Send Publish Location, then address and send the resulting message, which provides the URL from which Internet colleagues can obtain your calendar information.

  5. Click OK to publish the selected personal calendar.

  6. Check your mailbox for the notification sent by the Calendar Publishing Host.

  7. Continue with Displaying the Browse List of Calendars.

Displaying the Browse List of Calendars

  1. Display the following URL:

    http://web_server_address/gwcal/calendar
    
    Calendar Publishing Host browse list

    Your newly published personal calendar should appear on the list.

  2. Click your calendar to view it in its published format.

This assures you that your calendar is available for access by users across the Internet.

Publishing Free/Busy Information

  1. In the GroupWise Windows client, click Tools > Options.

  2. Click Calendar > Free/Busy.

    Calendar Properties dialog box
  3. Click Send Free/Busy Publish Location, then address and send the resulting message, which provides the URL from which Internet colleagues can obtain your free/busy information.

  4. Click OK, then click Close.

  5. Check your mailbox for the notification sent by the Calendar Publishing Host.