Linux Desktop Client 10g Installation

1. Pre-Install Requirements

Initiating Your Account

Important: Please review the information at http://www1.umn.edu/umcal/forms/UMCalSignUp.html before trying to use UMCal.

2. UMCal Linux Desktop Client Requirements

The UMCal desktop client for Windows requires:

• Linux x86 with kernel 2.4.9 or later
• X Window system, such as XFree or X.org
• X Desktop system, such as KDE or Gnome
• Java 1.4.2
• 40 MB disk space
• 128 MB RAM

3. Installing UMCal Linux Desktop Client

Downloading the Client

To download the latest version of the software, go to: http://www.umn.edu/umcal/download

Extracting Files

Extract the installation files using your system's built-in handler or from the command line.

• User Input: Extract Downloaded File from Command Line

  cd /path/to/download tar zxvf umcal_linux_<version>.tar.gz

Installing the Client

1. Locate the file you downloaded to your computer and uncompressed.
2. Change directory to the installer folder.
   

   User Input: Change Directories

   cd OracleCalendar_inst

   Alternatively, navigate to this directory in your window manager.
3. To execute an install method, double-click the appropriate script or, in a shell, type the following command:

   User Input: Enter install method

   ./gui_install.sh ./text_install.sh ./silent_install.sh

   The remainder of these instructions assume usage of the GUI installer.
4. After the installer has launched, click Next at the Introduction screen.
   
   


5. At the Choose Install Folder screen, enter your desired installation path. The default location is a folder named OracleCalendar within the current user's home directory. Change the default if desired and click Next.
   
   


6. At the Choose Link Folder screen, set the desired placement, if any, for a symbolic link to the Oracle Calendar application. Click Next.
   
   


7. At the Pre-Installation Summary screen, verify your installation preferences and click Install.
   
   


8. Wait while the installation proceeds.
   
   


9. When the installation is finished, click Done at the Installation Complete screen.
   
   

4. Launching the UMCal Linux Desktop Client

Command Line Method

To start the client simply type ./ocal in a shell. This assumes you created a link in your home directory, /usr/bin, or another directory in your path. Alternatively, navigate to the link or application in your desktop environment and launch the client.

5. Configuring the Client

Creating a Profile

1. At the Sign-In screen, click the Other button.
   
   


2. At the Connection Manager screen, click New.
   
   


3. At the Connection Editor screen, enter the following information.
   Enter the following information:

   User Input: UMCal Settings

   Connection Name: UMCal Server: umcal.umn.edu

   
   
4. While still at the Connection Editor screen, click Lookup.
   



5. Select the Configure at login from user name radio button. Click Configure.
   
   


6. Click OK to return to the Connection Manager screen.
   


7. Click on UMCal within the window and then click Make Default.
   
   


8. Click Ok to return to the Sign-In screen. Log in with your Internet ID and Internet password.
   
   

6. Uninstalling UMCal Linux Desktop Client

Uninstall

If you later want to remove the client for linux use the following command:

User Input: Uninstall UMCal

rm -rf <install directory>/OracleCalendar # Remove any symbolic links rm ocal

7. Common Errors

Errors During Installation

SELinux may prevent installation of the client. When running an installation script, if you receive a java.lang.UnsatisfiedLinkError error referencing libawt.so, you may need to adjust your SELinux configuration, or temporarily disable SELinux.

Errors Starting the Client

If you receive an error loading shared libraries, referencing libstdc++.so.5, you will need to install a package containing the appropriate version of the shared library, compat-libstdc++.