6.4 Setting Up a Calendar Publishing Host

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

6.4.1 Linux: Installing the Calendar Publishing Host Application

If you are new to Linux, you might want to review Linux Commands, Directories, and Files for GroupWise Administration in the GroupWise 2012 Administration Guide before you install the GWIA on Linux.

Preparing the Linux Server for the Calendar Publishing Host

  1. Make sure that the Web server where you are installing the Calendar Publishing Host Application meets the system requirements listed in Section 6.2, Calendar Publishing Host System Requirements.

  2. Make sure that the Linux server has a static IP address.

  3. Make sure that the firewall on the server has the ports open that are used by the Web server and the Calendar Publishing Host Application.

    For assistance, see GroupWise Port Numbers in the GroupWise 2012 Administration Guide.

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

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

  6. Continue with Installing the Linux Calendar Publishing Host Software.

Installing the Linux Calendar Publishing Host Software

  1. In a terminal window on the Web server where you want to install the Calendar Publishing Host Application, log in as root, then provide the root password.

  2. Change to the root directory of the downloaded GroupWise 2012 software image.

    or

    If you have already copied the Calendar Publishing Host software to a software distribution directory, change to /opt/novell/groupwise/software.

  3. Run ./install.

    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 GroupWise Components Using the Text-Based Installation Program.

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

    The main GroupWise System Installation page appears.

    GroupWise Installation program

  5. Click Install Products > GroupWise Calendar Publishing Host > Install Calendar Publishing Host to install the Calendar Publishing Host software.

  6. When the installation is complete, click OK.

  7. Click Configure Calendar Publishing Host Application.

    Calendar Publishing Host Installation program

  8. Click Next, accept the License Agreement, then click Next.

  9. Follow the prompts to configure the Calendar Publishing Host, using the following information from the GroupWise Calendar Publishing Host Installation Worksheet:

    Configuration Complete page

  10. On the Configuration Complete page, click Exit to exit the Calendar Publishing Host Installation program.

    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

    It is also integrated with Tomcat.

  11. Exit the GroupWise Installation program.

  12. Restart Apache and Tomcat:

    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

  13. Make sure that Apache and Tomcat restart automatically when the server reboots:

    OES 11:

    		 
    chkconfig apache2 on
chkconfig novell-tomcat6 on

    OES 2 Linux:

    		 
    chkconfig apache2 on
chkconfig novell-tomcat5 on

    SLES 11:

    		 
    chkconfig apache2 on
chkconfig tomcat6 on

    SLES 10:

    		 
    chkconfig apache2 on
chkconfig tomcat5 on

  14. Skip to Configuring the Calendar Publishing Host in ConsoleOne.

6.4.2 Windows: Installing the Calendar Publishing Host Application

Preparing the Windows Server for the Calendar Publishing Host

  1. Make sure that the Web server where you are installing the Calendar Publishing Host Application meets the system requirements listed in Section 6.2, Calendar Publishing Host System Requirements.

  2. Make sure that the Windows server has a static IP address,

  3. Make sure that the firewall on the server has the ports open that are used by the Web server and the Calendar Publishing Host Application.

    For assistance, see GroupWise Port Numbers in the GroupWise 2012 Administration Guide.

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

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

  6. Continue with Installing the Windows Calendar Publishing Host Software.

Installing the Windows Calendar Publishing Host Software

  1. On the Web server where you want to install the Calendar Publishing Host Application, change to the root directory of the downloaded GroupWise 2012 software image.

    or

    If you have already copied the Calendar Publishing Host Application to a software distribution directory, change to that location

  2. Run setup.exe.

  3. (Conditional) If prompted, select the interface language for the GroupWise Installation program, then click OK.

    On Windows, the GroupWise 2012 software image can be downloaded in a multilanguage version or an English-only version. When you install from the multilanguage version, all languages are always installed, regardless of the specific language that you select for running the Installation program.

    The main GroupWise System Installation page appears.

    GroupWise Installation program main page

  4. Click Install More Components > Install Calendar Publishing Host, to start the Calendar Publishing Host Installation program.

    You can also start the Calendar Publishing Host Installation program by running:

    /software_image/internet/calhost/setup.exe

  5. Click Next, then follow the prompts to provide the information from your GroupWise Calendar Publishing Host Installation Worksheet.

    The Calendar Publishing Host Installation program provides diagrams that help you understand how the various components interact with each other. Review the diagrams as you provide the requested information.

  6. Review the Installation Summary page, then click Install.

  7. (Conditional) If prompts appear because your Web server is running, select how you want to stop your Web server.

    The Calendar Publishing Host Setup page explain the additional configuration steps that are required after you are finished running the Calendar Publishing Host Installation program.

    Calendar Publishing Host Setup page

  8. Review the configuration steps, then click Next to continue.

  9. When the installation is complete, click Finish to exit the Calendar Publishing Host Installation program.

    Calendar Publishing Host Installation Complete page

    You can choose to have the WebAccess Installation program restart the Web server for you.

    Along with the Calendar Publishing Host Application, the Installation program also installs Tomcat 6 to c:\novell\tomcat6, integrates it with your Web server, and automatically starts it to support the Calendar Publishing Host Application.

  10. Click Finish to exit the GroupWise Installation program.

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

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

6.4.3 Configuring GroupWise to Support the Calendar Publishing Host

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 Worksheet 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 identical name that you used during installation, including spacing and capitalization, 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 identical 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

    Replace web_server_address with 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.

Enabling Calendar Publishing

Use the information under Calendar Publishing Options on your GroupWise Calendar Publishing Host Installation Worksheet 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 Worksheet.

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

  7. Continue with Restarting the Web Server and Tomcat.

Restarting the Web Server and Tomcat

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

  1. Restart Apache and Tomcat:

    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

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

  2. Make sure that Apache and Tomcat restart automatically when the server reboots:

    OES 11:

    		 
    chkconfig apache2 on
chkconfig novell-tomcat6 on

    OES 2 Linux:

    		 
    chkconfig apache2 on
chkconfig novell-tomcat5 on

    SLES 11:

    		 
    chkconfig apache2 on
chkconfig tomcat6 on

    SLES 10:

    		 
    chkconfig apache2 on
chkconfig tomcat5 on

Continue with Configuring a POA for Calendar Publishing.

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 Macintosh iCal calendaring applications.

Use the information under Calendar Publishing Post Office on your GroupWise Calendar Publishing Host Installation Worksheet 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 2012 Administration Guide.

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 Worksheet 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. (Conditional) 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.

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 Configuring the Calendar Publishing Host in ConsoleOne, skip to Section 6.4.4, 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.4 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 2012 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 2012 Windows Client User Guide.

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

    For more information, see the GroupWise 2012 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.

    The URL has the following format:

    http://calpubhost_server/gwcal/freebusy/user_id@internet_domain

  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.