Oracle® Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1) for hp Tru64 UNIX Part Number B12232-02 |
|
|
View PDF |
This chapter describes requirements and procedures for installing the components of Oracle Calendar standalone, including:
Oracle Calendar server: Required in order to run the remaining components of Oracle Calendar. Complemented by the Oracle Calendar Administrator.
Oracle Calendar application system: The application framework that controls the following components:
Oracle Calendar Web client
Oracle Calendar Web services
Oracle Sync Server
Instructions in this chapter apply to UNIX-based systems.
You can install Oracle Calendar server and the Oracle Calendar application system on the same host or on multiple, separate hosts across a network.
This appendix contains these topics:
Since you can install Oracle Calendar server and the application system together or separately, the following sections list requirements common to both components and separate to each.
This section contains the following topics:
Operating system: UNIX-based systems, as described in the requirements for Oracle Collaboration Suite
Colors: A minimum of 256 display colors
Disk space: Up to 150 MB free disk space may be necessary for installation
Patches: The same patches apply as are listed in the requirements for Oracle Collaboration Suite
Privileges: During installation, the Oracle Universal Installer may require you to run some scripts with root privileges. For more information, see the documentation included with Oracle Universal Installer.
RAM: An estimated 512 MB of RAM or more is needed for computers handling a large number of users or services. To calculate your exact requirements, see Table 2-12, "Kernel Parameter Settings for hp Tru64 UNIX for Oracle Collaboration Suite" in this guide for details on kernel parameters needed to run Oracle Calendar server on UNIX-based systems.
Disk space: 400 MB of disk space, plus space for the Oracle Calendar database and log files
Messaging server: An SMTP messaging server for mail notifications
Web browser: One of the following Web browsers, in order to use the Oracle Calendar Administrator:
Internet Explorer 5.5 or 6.0 (Windows only)
Netscape 7.0
Mozilla 1.2
Kernel parameters: See Table 2-12, "Kernel Parameter Settings for hp Tru64 UNIX for Oracle Collaboration Suite" for details on the kernel parameters needed to run Oracle Calendar server on UNIX-based systems.
Note: Make sure you set theshmsys:shminfo_shmmin parameter to 1. This is different from other parameters, whose values are generally a maximum or sum of the host's existing value and the Calendar requirement. If you do not set shmsys:shminfo_shmmin to 1, you will not be able to start the Calendar server after installation. |
Web server: Oracle HTTP Server or Apache Web server. On Apache Web servers, you must have Apache 1.3.27 with mod-fastcgi 2.2.12. Find the latter through FTP access, as it is not readily available from the Apache Web site. Oracle Calendar standalone does not work with Apache 2.x and mod-fastcgi 2.4.x.
RAM: 256 MB RAM or more is recommended for computers handling a large number of users.
Disk space: 100 MB of disk space for installation, plus 200 MB for operation (linkdb and sessiondb disk space; more space may be required for heavy deployments).
Oracle Calendar Web client browsers: Users must have one of the following browsers in order to use the Oracle Calendar Web client component of the Oracle Calendar application system:
Internet Explorer 5.x, 6.x (Windows)
Internet Explorer 5.x (Macintosh OS 9 only)
Netscape 6.x, 7.x (Linux x86, Macintosh, Windows)
Mozilla (Linux x86, Macintosh, Windows)
Safari (Macintosh OS X only)
Lynx 2.8.4 Pre5 (for Accessible mode, standalone only)
This section contains important information you need to know before installing Oracle Calendar server and the Oracle Calendar application system, including:
Planning Separate Installations of the Oracle Calendar Application System and Server
Oracle Calendar Application System Considerations.
Note: If you have a previous version of Oracle Calendar installed, please see "Upgrades", for information on working with other versions. |
When installed in standalone mode, the Oracle Calendar server can be used with a third party external directory server. Support for the Lightweight Directory Access Protocol (LDAP) is offered through separate connectors:
LDAP Connector 9.0.4 for Sun ONE Directory Server
LDAP Connector 9.0.4 for OpenLDAP
LDAP Connector 9.0.4 for Syntegra Aphelion Directory Server
LDAP Connector 9.0.4 for Critical Path InJoin Directory Server
Before installing Oracle Calendar server, you must use your LDAP connector to extend the directory schema. Directory servers have schemas that define the information they store. These schemas consist, amongst other things, of objects and attributes. The directory server schema needs to be extended to include objects and attributes needed by the Calendar server. For a list of the extensions to the Oracle Calendar server schema, see Appendix H, "Calendar Extensions to Directory Server Schema," of the Oracle Calendar Reference Manual.
This section contains the following topics:
These steps apply to the Sun ONE and iPlanet 5.x Directory Servers.
Extract the files from the tar file ldapc0904000_SunOne_unix_en_rtm1.tar
included in the Oracle Calendar server package.
Find the file SunOne/calendar-schema.ldif
.
Use this file with the ldapmodify
utility to modify the directory entries:
% ldapmodify -h host -p port -D Directory_Manager_DN -w Directory_Manager _Password -f "calendar-schema.ldif"
Verify that no error is reported.
These steps apply to the OpenLDAP Directory Servers version 2.x, and later.
Extract the files from the tar file ldapc0904000_openldap_unix_en_rtm1.tar
included in the Oracle Calendar server package.
Find the file openldap/calendar.schema
.
Locate the OpenLDAP configuration directory. On UNIX, it is usually set to /usr/local/etc/openldap
. This directory will be used in the next examples.
Copy the file calendar.schema
to /usr/local/etc/openldap/schema
, assuming that the configuration directory is in /usr/local/etc/openldap
.
Edit the file /usr/local/etc/openldap/slapd.conf
.
Locate the line that contains
include /usr/local/etc/openldap/schema/cosine.schema
If it has not been already been added, add the line:
include /usr/local/etc/openldap/schema/inetorgperson.schema
Add the line:
include /usr/local/etc/openldap/schema/calendar.schema
In the database section, add the line
index ctcalxitemid pres,eq
Restart the slapd
server.
These steps apply to the Syntegra Aphelion Directory Server.
Extract the files from the tar file ldapc0904000_syntegra_unix_en_rtm1.tar
, included in the Oracle Calendar server package, to a temporary directory.
The temporary directory should contain the following three files:
syntegra/oidtable.gen_cst syntegra/oidtable.oc_cst syntegra/oidtable.at_cst
To prepare the directory server, you will need to install these files to configure ctCal
directory objects. Append the content of these files (containing the Oracle Calendar server schema's object identifier numbers, the object classes, and the attributes) to the corresponding Syntegra Aphelion (object identifier) table files:
/usr/var/osi/oidtable.gen /usr/var/osi/oidtable.oc /usr/var/osi/oidtable.at
Restart the directory server to allow the configuration changes to take effect.
These steps apply to the Critical Path InJoin Directory Server version 4.x and include:
Extending the Schema
Extract the files from the tar file ldapc0904000_injoin_unix_en_rtm1.tar
, included in the Oracle Calendar server package, in a staging directory. The directory should contain the following files:
injoin/calendar_acsp injoin/calendar_admin_aci injoin/calendar_anonymous_aci injoin/calendar-attribute.schema injoin/calendar_local injoin/calendar-objc.schema
Type http://
iCon_host
:
iCon_port
in the location field to go to the iCon administration page. The iCon port is set to 1500 by default.
On the left tab, click the Schema navigational tab.
On the right windows, click Schema Import.
Copy the content of the file calendar-attribute.schema
to the New attributes in LDAPv3 format text area.
Click Schema Import.
On the left tab, click the Schema navigational tab and on the right window, click Schema Import.
Copy the content of the file calendar-objc.schema
to the New object classes in LDAPv3 format text area.
Click Schema Import.
Creating Name Bindings
The Oracle Calendar server introduces two types of structural object classes, ctCalAdmin
and ctCalResource
. The name binding registry must be updated to allow these types of entries to exist under an organizationalUnit
entry.
To create a name binding for ctCalAdmin
:
Type http://
iCon_host
:
iCon_port
in the location field to go to the iCon administration page. The iCon port is set to 1500 by default.
On the left tab, click the Schema navigational tab.
Click Create a new name binding.
Select organizationalUnit from the Superior list box.
Select ctCalAdmin from the Subordinate list box.
Select ctCalXItemId from the Naming attributes list box.
Click Create Name Binding.
Creating a name binding for ctCalResource
:
Type http://
iCon_host
:
iCon_port
in the location field to go to the iCon administration page. The iCon port is set to 1500 by default.
On the left tab, click the Schema navigational tab.
Click Create a new name binding.
Select organizationalUnit from the Superior list box.
Select ctCalResource from the Subordinate list box.
Select commonName from the Naming attributes list box.
Click Create Name Binding.
Setting the Oracle Calendar Base DN
The subtree where the Oracle Calendar server will be installed must be set as an Access Control Specific Point (ACSP) subtree. In most installations, this is already the case. The following procedure shows how to do this.
Copy the files calendar_acsp
, calendar_anonymous_aci
, calendar_local
and calendar_admin_aci
to the working directory of your dsa.
Edit the calendar_local
to match your deployment.
Set the value of the macro ctBaseDN
to the location where the Oracle Calendar server will be installed (BASEDN). For example:
BASEDN: o=acme,c=us =ctBaseDN Rc("us") Ro("acme") BASEDN: ou=School of Law, o=ABC University,c=us =ctBASEDN Rc("us") Ro("ABC University") Rou("Shool of Law")
Go to the dsa
working directory. For example: /opt/ids/ICon/dsa1
Start the odsadmin
directory access tool by typing odsadmin
at the command prompt.
Type bman
to bind as the directory manager:
odsadmin> bman
Enter the directory manager password when prompted.
Make the Oracle Calendar BASEDN an ACSP (unless it is already set up).
odsadmin> run calendar_acsp ~
Granting Anonymous Read Access (optional)
The Oracle Calendar server binds anonymously or as a "bind user" when performing a search operation. If your directory server does not allow anonymous read access, you need to create an entry that has read access to the subtree where the Oracle Calendar server will be installed. You will need to supply the distinguished name (DN) of this entry and its password during the Oracle Calendar server installation. The following procedure shows how to grant read access for anonymous searches.
If you have already closed the odsadmin
session, open it again by typing odsadmin
from the dsa
working directory.
Type bman
to bind as the directory manager:
odsadmin> bman
Enter the directory manager password when prompted.
Run the command file which will set the ACI to permit anonymous read-only access. This will modify your directory server's security.
odsadmin> run calendar_anonymous_aci ~
Use the following table to determine the correlation between the directory server parameters required during installation and the terminology used for each separate product.
Table F-1 Calendar server / directory server concordance
Definition of concept | Oracle Calendar Server | Sun ONE Directory Server | Syntegra Aphelion Directory Server | Critical Path InJoin Directory Server |
---|---|---|---|---|
Computer on which Directory Server is installed | LDAP Host | Directory Server host | Directory Server host | |
Port number for Directory Server (LDAP) connections | LDAP Port | Directory Server port number | LDAP daemon port | Directory Server address port number |
The point in the directory hierarchy from which searches are performed | Base DN | BaseDN / Directory suffix / search root | DN located beneath context prefix | Entry Starting Point / context prefix |
"Superuser" for the directory (user with unrestricted access) | SuperUserDN | RootDN or Unrestricted user | Manager DN | Directory Administrator's DN |
Password for unrestricted access | SuperUserDN Password | RootDN or Unrestricted user password | Manager DN Password | Directory Administrator's Password |
The "parent" entry, offset from the baseDN, for the 6 reserved Oracle Calendar users | Oracle Calendar server Administrators' Parent DN | n/a | n/a | n/a |
A new group, offset from the baseDN, for the 6 reserved Oracle Calendar users | Oracle Calendar server Administrators' Group DN | n/a | n/a | n/a |
The Oracle Universal Installer allows you to install and configure the Oracle Calendar application system and server on the same host. Both components are configured to see one another's host and port. However, for large deployments, it is best to install the server and application system on separate hosts. You can do this by running the Installer on each host and selecting which component or components you want to install.
Generally, you should start by installing the server. You will need to enter a temporary value when prompted for the application system's host name and port. When you install the application system, you will need to enter information on the server you've just installed. Afterwards, you should edit the server's configuration file to enable resource approval, as described in "Installation".
For more information on editing Oracle Calendar configuration files, see the Oracle Calendar Reference Manual.
For security reasons, it is best that the Sync Server component only be accessible through SSL (https
) connections. You may also want to install Oracle Sync Server on a separate host for easier accessibility from phones. Keep in mind that some phones support VPN access through a firewall, while others do not.
It is also best to only use Web services through SSL connections.
This section explains how to install Oracle Calendar standalone components on UNIX-based systems. This section contains the following topics:
Installing Oracle Calendar Server and Oracle Calendar Application System
Manually Running the Oracle Calendar Configuration Assistant
Extract or copy the Oracle Calendar installation files to a temporary directory.
In your temporary directory, go to the ./Disk1
subdirectory.
Start the Oracle Universal Installer with the following command:
./runInstaller
Click Next on the Welcome screen.
Unmount Disk 1.
Eject Disk 1.
Mount Disk 6.
Select the following when prompted by the Specify File Locations screen:
/Source_Path/calendar_standalone/stage/products.jar
Enter an ORACLE_HOME
name and path in the Specify File Locations screen, then click Next. The path you enter can be up to 74 characters long. If you have a previous version of Oracle Calendar installed and you want to upgrade it, do not overwrite it.
Select the directory server you will be using. (Select Internal if you do not have a directory server.) Click Next. You will be prompted for directory server configuration information such as Host, Port and Base DN, as described in "Setting up your Directory Server".
Notes: If you select Critical Path InJoin Directory Server:
|
After entering your directory server information, enter a password in the fields of the Oracle Calendar Administrative Password screen.
In the Oracle Calendar Node-ID screen, enter a Node-ID. This must be a unique value between 1 and 4999.
If this is your first installation of the Oracle Calendar server, select Yes in the Oracle Calendar Master Node screen to make the current installation the master node. You must have one master node on your network in order for Web services and Sync Server to work.
Click Next and follow the remaining instructions to complete the installation.
If you want to upgrade data from a previous version of Oracle Calendar, go to "Upgrades". Otherwise, go to "Postinstallation Configuration".
The procedure for installing just the Oracle Calendar server is similar to that described in "Installing Oracle Calendar Server and Oracle Calendar Application System", with the differences being:
In step 10, you must select the Oracle Calendar server and not the Oracle Calendar application system.
You will be prompted for the application system's host and port. If you do not know these yet, you can enter temporary values and, later, edit the unison.ini
file server with the correct values. For example:
[RESOURCE_APPROVAL] url=http://server:port/ocas-bin/ocas.fcgi
The procedure for installing just the Oracle Calendar application system and its components is similar to that described in "Installing Oracle Calendar Server and Oracle Calendar Application System", with the differences being:
In step 10, you must select Oracle Calendar application system (and any of its components), not Oracle Calendar server or the Oracle Calendar Administrator.
After step 10, you will only be prompted to enter the Host, Port and Node-ID for the Oracle Calendar server. If you do not know these values, you can enter temporary values and, later, edit the ocas.conf
file in the application system with the correct values. For example:
[CONNECTION] mnode=Host:Engine_Port,node
If you install two instances of Oracle Calendar (two instances each of the Oracle Calendar server and the Oracle Calendar application system) on the same infrastructure, the orclguest
account may not be provisioned for the second instance. If this happens, you must point the second instance of the Oracle Calendar application system to the first instance of the Oracle Calendar server.
To do this, edit the Oracle Calendar application system configuration file on the second instance ($ORACLE_HOME/ocas/conf/ocas.conf
) as follows:
[CONNECTION] mnode=host_name:engine_port,node
Where host_name
is the first instance of the Oracle Calendar server and node
is the master node.
The Oracle Collaboration Suite installation program runs an Oracle Calendar server configuration assistant, a tool that configures Oracle Calendar standalone to work with your system. If you encounter an error during installation due to a problem with your setup (for example, if a host URL you specified could not be read) you should manually run this configuration assistant once you have fixed the problem.
To manually run the configuration assistant:
Set your ORACLE_HOME
environment variable to the directory where Oracle Calendar is installed.
Set your library path. On hp Tru64 UNIX, set LD_LIBRARY_PATH to
$ORACLE_HOME/lib:$ORACLE_HOME/ocal/sbin
Open the following log file:
$ORACLE_HOME/cfgtoollogs/configtoolsDATE_TIME.log
Locate the configuration assistant header; for example:
------------------------------------------------Launched configuration assistant 'Calendar Server Configuration Assistant'------------------------------------------------
Underneath the header, copy the command that was created during installation. The command will start with something similar to:
/home/myuser/oracle_home/jre...
And end with something similar to:
... -epw -DSDS OID -portDAS 5736 -DSmgrdn cn=orcladmin -emgrp -mnme -ePIM -eimt -eclient -tzkey MEZ-1MESZ -silent
Run the command line you copied, making sure to replace the following parameters:
Parameter | Replace With |
---|---|
-epw |
-nodepw <ias_admin_password> |
-emgrp |
-DSmgrp <DSMgrdn_user_password>
(The |
-ecsm |
-csmid <password_for_new_csm> |
This section explains how to upgrade your data for Oracle Calendar and the Oracle Calendar application system. Make sure you read and follow these directions before removing your previous installation of Oracle Calendar.
This section includes these topics:
Oracle Calendar Application System Upgrade
Note: Before performing an upgrade, you are advised to re-evaluate your sizing calculations based on the requirements provided for the new software. See Appendix A, "Disk Space and Memory" in the Oracle Calendar Administrator's Guide to calculate disk space and memory requirements. For CPU usage, the hardware requirements have changed as a result of added functionality. If in your current Oracle Calendar installation you track regular peaks in CPU usage at 60%, or greater, several times a day, you may require additional CPU for a new installation. You will also notice increased CPU usage if your deployment contains previous versions of the Oracle Calendar application system working against a new Oracle Calendar server. |
You can upgrade to Oracle Calendar server Release 2 (9.0.4) from CorporateTime Server 5.2. This supported upgrade path involves the following steps:
Notes:
|
Stop CorporateTime Server 5.2.
Install Oracle Calendar server standalone as described in "Installation". Do not overwrite the installation of CorporateTime Server 5.2.
Stop Oracle Calendar server release 9.0.4.
Copy the CorporateTime database nodes to the Oracle Calendar standalone installation using the following procedure:
Copy the directories Nn from /users/unison/db/nodes
to $ORACLE_HOME/ocal/db/nodes
. In the preceding, the variable n represents the numbers 0, 1, 2, and so on.
Rename the CorporateTime unison
directory to another name.
Create a symbolic link from the source directory $ORACLE_HOME/ocal
to the target directory /users/unison
using the following command:
ln -s $ORACLE_HOME/ocal users/unison
Change the ownership of the nodes copied in Step 4 to the account used to install Oracle Calendar server release 2 (9.0.4).
Create a directory named new
in $ORACLE_HOME/ocal
.
Create a file named state.ini
in $ORACLE_HOME/ocal/misc
. This file should contain the following lines:
[SETUP] state=TO_6.0_TMP
Make the following changes to the unison.ini
file in $ORACLE_HOME/ocal/misc
:
Change the dbversion from A.06.00
to A.02.62
.
Change the node information to that of the old configuration files, such as the following:
[NODEDID] name=Nn version=A.02.62 aliases=node_aliases timezone=your_timezone
If there are multiple nodes, then make sure to include the necessary information for all of the nodes.
Change daemon port numbers to the default numbers, as shown in the following:
[ENG] port = 5730 [SNC] port = 5731 [DAS] port = 5732 [CSM] port = 5734
Copy all other option parameters, if necessary, from the old unison.ini
file to the $ORACLE_HOME/ocal/misc/unison.ini
file.
Set the environment variables as follows:
ORACLE_HOME=Your_Oracle_home LD_LIBRARY_PATH=$ORACLE_HOME/ocal/sbin:$ORACLE_HOME/lib:$ORACLEPHOME/bin
Run the following command from $ORACLE_HOME/ocal/bin
to convert the database:
unidbconv -n all -pathsrc /users/unison/
Run uniclean
from $ORACLE_HOME/ocal/bin
after the database has been converted successfully.
Remove the /users/unison
symbolic link.
You can automatically upgrade CorporateTime/Oracle Calendar 3.x data to the new version of the Oracle Calendar application system.
See Also: "General Issues and Workarounds" for known issues related to upgrading the application system |
This section contains the following topics:
Check for known upgrade issues in "General Issues and Workarounds"
Ensure that the following files have the appropriate permissions for the new version's ORACLE_HOME
user:
Ensure the Oracle Calendar Web server and version 3.x FastCGI processes are stopped
Install the Oracle Calendar application system in standalone mode as described in "Installation".
Set the ORACLE_HOME
and LD_LIBRARY_PATH
environment variables for hp Tru64 UNIX.
Stop the CorporateTime and Oracle Calendar Web servers.
From the new installation directory $ORACLE_HOME/ocas/upgrade/
, run the upgrade assistant with the command ocasua.sh
, using the following optional syntax:
./ocasua.sh [ -appdir appdir ] [ -resdir resdir ] [ -confdir confdir ]
In the preceding command the following variables are used:
-appdir
is the CorporateTime binary directory, such as:
/Apache_home/fcgi-bin/owc
-resdir
is the CorporateTime base directory, such as:
/Apache_home/fcgi-bin/lexacal-private
-confdir
is the Web server configuration directory, such as:
/Apache_home/conf
A log of the process is generated in:
$ORACLE_HOME/ocas/upgrade/log/
Remove the FastCGI Server directives in the old version found in httpd.conf
. They have been replaced by directives inserted in
$ORACLE_HOME/ocas/conf/ocal.conf
Some sections and keys are not migrated from webcal.ini
into ocas.conf
and ocwc.conf
. You will need to migrate these manually. For more information see "Upgrades".
This section describes procedures necessary to configure your standalone installation of Oracle Calendar.
This section contains the following topics:
If you are using an Apache server or Oracle HTTP Server, add the following to the Web server's httpd.conf
file in order to recognize the Oracle Calendar Administrator:
include $ORACLE_HOME/ocad/config/ocad.conf
(Ensure there is read access to ocad.conf
)
In addition, make the following changes to your httpd.conf
file so that you can use the Oracle Calendar application system:
Include $ORACLE_HOME/ocas/conf/ocal.conf
Set the system library search path to include $ORACLE_HOME/lib
on hp Tru64 UNIX
Set the ORACLE_HOME
environment variable to the directory where Oracle Calendar is installed
Keep in mind that you may have to resolve conflicting settings if you customized your original in a similar manner.
Restart the Web server after you make the changes.
If, during installation, you selected a directory server to use with Oracle Calendar server, the Oracle Calendar Administrator must be granted certain access rights.
This section contains the following topics:
To grant access rights to the Oracle Calendar Administrator, run the unidsacisetup
utility with the -w
option. For more details on this utility, see Appendix E, "Calendar Server Utilities," in the Oracle Calendar Reference Manual.
Use the base DN (example: "dc=acme,dc=com
") and the Oracle Calendar Administrator parent DN (example: "ou=OracleCalendarAdministrator
"). For example:
Use the Syntegra Aphelion Web application and sign in as a directory manager.
Click the LDE where the Oracle Calendar server is installed.
Click Manage.
Expand the Access Control folder.
Click Advance Access Control.
On the right pane, click Add New Access Control Policy.
In the Modify Access Control Policy text area, type the following:
to dn=.*BASEDN by dn=.*,ADMINDN,BASEDN write
where the BASEDN
is the value of the [LDAP]basedn
parameter and ADMINDN
is the value of the [LDAP]admin
parameter in the $ORACLE_HOME/ocal/misc/unison.ini
configuration file. For more details on these parameters see Appendix C, "Calendar Server Parameters," in the Oracle Calendar Reference Manual.
Click Apply for the change to take effect.
If you have already closed the odsadmin
session, open it again by running odsadmin
from the dsa
working directory.
Type bman
to bind as the directory manager.
odsadmin> bman
Enter the directory manager password when prompted.
Run the command file to set the ACI to grant access rights to the Oracle Calendar Administrator.
odsadmin> run calendar_admin_aci ~
Exit the odsadmin
session.
This section describes configuration changes you might need to make to the Oracle Calendar server after installing and, as the case may be, after upgrading.
This section contains the following topics:
Start the Oracle Calendar server with the following command:
$ORACLE_HOME/ocal/bin/unistart
Stop the Oracle Calendar server with the following command:
$ORACLE_HOME/ocal/bin/unistop -y
The default ports used by the Oracle Calendar server are:
Port | Function |
---|---|
5730 | Oracle Calendar Engine |
5731 | Synchronous network connector |
5732 | Directory access server |
5734 | Oracle Calendar server manager |
If these ports are already in use, the installation will use the next available port. Please verify unison.ini
for the values used by the Oracle Calendar server.
Use the Oracle Calendar Administrator to manage users, events, resources, and public agendas, as well as perform administrative tasks. By default, open it at the following URL:
https://Web_server_host:https_port/ocad-bin/ocad.cgi?object=nodeadm
To log on to the Oracle Calendar Administrator, enter the Oracle Calendar administrative password you chose during installation. Do not enter a user name with this password.
In some cases, you may want to run the Oracle Calendar Administrator on a non-Apache Web server. If so, you should make the following changes to your Web server:
Set the system library search path to include $ORACLE_HOME/lib
(lib32 for other platforms such as hp-ux PA-RISC (64-bit)) and $ORACLE_HOME>/ocad/bin
.
Set the ORACLE_HOME
environment variable to the directory where Oracle Calendar is installed.
Configure a script alias, such as ocad-bin
, to $ORACLE_HOME/ocad/bin/ocad.cgi
. This alias must have the permissions to run ocad.cgi
.
Configure the ocad-templates
script alias to $ORACLE_HOME>/ocad/templates
. This alias must be named ocad-templates
, and must have the permissions to read HTML, .js, and .css files.
The Web server identity must have access to server directories as follows:
Folder | Permissions |
---|---|
$ORACLE_HOME/ocad/bin/ |
Read, Write, Execute |
$ORACLE_HOME/ocad/sessions/ |
Read, Write |
$ORACLE_HOME/ocad/temp/ |
Read |
The $ORACLE_HOME/ocad/bin/ocad.cgi
program must have the permissions needed to read or write files in $ORACLE_HOME/ocad/sessions
(this can be configured in $ORACLE_HOME/ocad/bin/ocad.ini
).
You can find required settings for your server in $ORACLE_HOME/ocad/config/ocad.conf
.
If you intend to use the resource approval feature (on any Web server), you must set it up as follows:
Create or modify a resource with NOTIFY-APPROVER
set to TRUE and APPROVER-EMAIL
set to e-mail of the approver. For example, in ocal/bin
:
uniuser -resource -add R=Resource _Approval/NOTIFY-APPROVER=TRUE/APPROVER-EMAIL=approver.email@oracle.com /psw=password -n 4313 -p test1
Assign Resource designate rights; for example, in ocal/bin
:
uniaccessrights -mod -designate ALL=TRUE -grantee S=Designate/NODE-ID=4313 -grantor R=Resource_Approval -n 4313 -p test1
Also make sure that the RESOURCE_APPROVAL
section exists in unison.ini
(located in ocal/misc
) with the URL parameter; for example:
[RESOURCE_APPROVAL] url=http://server:port/ocas-bin/ocas.fcgi
If you changed the resource approval URL, restart the Oracle Calendar server.
Any values added to the LD_LIBRARY_PATH
environment variable, for example to configure security mechanisms, are cleared by the Oracle Calendar server. Instead, add the values to OCAL_ADDITIONAL_LIBPATH
.
Some security mechanisms require that you set the OCAL_ADDITIONAL_LIBPATH
environment variable to include the paths to their libraries.
If you are using GSSAPI/Kerberos 5, you must include the path to the five shared libraries required by libaut_gssapi.so
.
If you are using SASL/Kerberos 4 or SASL/GSSAPI, you must include the paths to:
The same libraries as GSSAPI/Kerberos 5
The Kerberos and SASL shared libraries required by libaut_sasl.so
, libsasl.so
and the SASL plug-in.
Each path must be separated by a colon (:
). For example:
setenv OCAL_ADDITIONAL_LIBPATH /usr/local/kerberos/krb5/lib:/usr/local/sasl/sasl-1.5.27/lib
Generally, the Oracle Calendar application system successfully starts when you start the Web server, using the default installation settings. This section explains how to check the status of the application system and make configuration changes to it, if necessary.
This section contains the following topics:
To see if the application system and its components are running, open the system page at http://
server
:
port
/ocas-bin/ocas.fcgi?sub=sys
. If a component is not running, it will not appear in the system page.
To connect to a component with an appropriate client, use the following URLs:
Component | URL |
---|---|
Sync Server |
http://host:port/ocst-bin/ocas.fcgi |
Web services |
http://host:port/ocws-bin/ocas.fcgi |
Oracle Calendar Web client |
http://host:port/ocas-bin/ocas.fcgi?sub=web |
The Oracle Calendar application system and its components are controlled with the following configuration files under $ORACLE_HOME/ocas/conf
:
ocas.conf
: Oracle Calendar application system
ocws.conf
: Web services
ocst.conf
: Sync Server
ocwc.conf
: Oracle Calendar Web client
ocal.conf
: Web server FastCGI directives, included from httpd.conf
Consider the following configuration options, depending on your environment:
Run several instances of ocas.fcgi
(the number of instances depends on setup and load). You can configure this in ocal.conf
.
You must run one instance of ochecklet.fcgi
per installation or host. This is also configured in ocal.conf
.
To redirect the Web client from a custom URL, add the following statement to ocal.conf
:
<Location /calendar> Redirect permanent /calendar \ http://<host>:<port>/ocas-bin/ocas.fcgi?sub=web </Location>
In order to use the Sync Server, set your KeepAlive
parameter in httpd.conf
or apache.conf
to 300 seconds, or turn it off. This is done to correspond to the idle-timeout value of 300 seconds in ocal.conf
.
Make sure that the linkdb
and sessiondb
variables in all hosts' ocas files refer to the same path; for example, the same NFS mount.
Set Authentication, Compression and Encryption (ACE) values in each component's conf
file. AUTH Web settings for all products should be configured in the [ACE_PLUGINS_CLIENT]
section of ocas.conf
.
If you experience any problems, check for error messages in:
$ORACLE_HOME/ocas/logs/ocas_log
Make sure you restart Oracle HTTP Server or Apache after any changes to the conf
files.
If e-mail sent by the Oracle Calendar server appears to come from the server's name rather than the desired domain name, make the following change to sendmail.cf
file, located in the /var/adm/sendmail
directory on hp Tru64 UNIX systems.
# who I masquerade as (null for no masquerading) (see also $=M)DMdomainname
Where domainname
is the mail domain name from which to send e-mail.
The following steps describe how to deinstall the Oracle Calendar server and application system from a host.
Stop the Oracle Calendar server using the unistop
command.
Stop the Web server.
In the directory server, remove the Oracle Calendar server attributes from your Oracle Calendar users. This is done by using LDIF update commands.
In the directory server, remove all ctCal
objects for the Oracle Calendar server nodes that were on this server. Use the ldapsearch
and ldapdelete
commands and refer to your directory server administrator's guide for proper syntax.
In the directory server remove all the relevant Oracle Calendar server administrative groups and ACLs from the database. Clean up your LDIF
file with a manual edit LDIF or use LDIF update statements.
Remove Oracle Calendar components using the Oracle Universal Installer. Start the Oracle Universal Installer with the command:
./runInstaller
Delete your calendar_server_path
.
Delete your client_path
.
This section describes general issues and their workarounds for Oracle Calendar server and the Oracle Calendar application system. Issues are broken down into the following sections:
This section includes the following topics:
Blank sections in unison.ini: Blank [LCK] and [LIC] sections will be added to the unison.ini
file of a fresh installation of a standalone Oracle Calendar server and/or upgraded standalone server. Do not remove these sections.
When reinstalling components of Oracle Calendar, make sure to install the Oracle Calendar server component in a fresh directory. Other components can be installed or added to their existing paths.
Clients: Versions of the Oracle Calendar application system that work with the Oracle Calendar server 9.0.4 include:
Oracle Calendar desktop client for Windows 6.0.5
Oracle Calendar desktop client for Mac version 5.2.3
Oracle Calendar desktop client for Linux x86/Solaris Operating Environment (SPARC 32-bit) version 5.0.2
Oracle Connector for Outlook version 3.3 and up
Note: Users of older clients should upgrade to the latest versions, available athttp://metalink.oracle.com |
The preceding clients only support passwords of 15 characters or less. If a password longer than 15 characters is assigned by the administrator, the user will not be able to sign in.
If you only wish to support new clients, set cs-standard_coexistence
in unison.ini
to false
.
Servers:
Coexistence may cause odd error messages on an old Oracle Calendar server (5.x). This is due to the fact that the old server may not understand the features introduced by the new server.
There is no event Oracle Calendar coexistence between Oracle Calendar server versions. Release 1 (9.0.3) users will only see Release 1 (9.0.3) event calendars and Release 2 (9.0.4.1) users will only see Release 2 (9.0.4.1) event calendars.
Node networks:
Node networks can only be created with version 5.3 and up of Oracle Calendar server.
If you need to create a node network, the nodes.ini
and the use of uninode
commands must be done on the most recent version (9.0.4) of the server within the network.
Administration utilities:
Do not use 9.0.4 utilities to administer a 5.x Oracle Calendar server. The only exception to this is when moving users; the moveuser
utility must be from the latest server version (9.0.4), even if moving a user between two nodes that are both on old server nodes (5.x).
Do not use 5.x utilities to administer a 9.0.4 Oracle Calendar server.
Mapping parameters: Mapping parameters have been added to the 9.0.4 server unison.ini
for coexistence and upgrades. 5.x servers map O
for EMAIL
and P
for UID
. However, 9.0.4 servers do not need this mapping anymore. Parameters added to a 9.0.4 server do not affect it.
The new parameters include:
[ENG] usermailmap = O itemuidmap = P resourcemailmap = O usersmscprefmap = OU3 usermobiletypemap = N usermobilemap = R
For version coexistence, these parameters should be added manually to the 9.0.4 unison.ini
file. They are added automatically during an upgrade.
Listing designates: Windows clients cannot list designates of remote resources
Creating events as a designate: Users may get an error when creating an event while working as a Designate. However, the event will be properly created.
Remote Designate: The Remote Designate feature can only be used with the Oracle Calendar Web client and the Oracle Calendar SDK
Moving users: Do not move users that have at some point used the Oracle Calendar Web client. Trying to move such a user may fail and cause some events to be duplicated.
UIDs: A numeric UID will be created by the system for a user without an existing UID.
Remote users: When a remote user is invited to meeting, the meeting owner's status is not correctly displayed to the remote user. The owner's status will be shown as will confirm later
instead of will attend
. This is a server issue. (2892129)
This section includes the following topics:
No prompt for server information: When installing the standalone package of the application system on a computer where Oracle Calendar server is already installed, you will not be prompted to enter server information during the installation. Once the application system is installed, you must open the [connection]
section of ocas.conf
and replace
mnode=,
with
mnode=host:engine_port,node
(2844399)
Multiple upgrades: When the application system upgrade assistant is run more than once, multiple include
lines may be inserted in httpd.conf
, causing the Web server to not start properly. (#2978880). Suggested work-around: Remove the duplicated include
lines from the conf
file. Typically, the lines look like this:
include full_path_of_install_home/ocas/conf/ocal.conf
Blank lines in ocas.conf and ocwc.conf: Blank lines in ocas.conf
and ocwc.conf
in your R2 installation will be removed by the upgrade assistant. To preserve them, replace them with #
prior to running the assistant.
Missing keys: The upgrade assistant only migrates the following keys. Your installation will still work, but you may need to make changes to the new parameters to get the look and feel you want. For information on editing parameters, see the Oracle Calendar Reference Manual.
[system] connection [servers] (All keys migrated to "connection" section of ocas.conf. If the old installation was a masternode, 'mnode' will be the only entry.) [ACE_PLUGINS_CLIENT] (All keys into ocas.conf) [admin] ssn_timeout sso_user_env_key max_login_attempts login_fail_timeout secure_login cache [ADA] enable hide_toggle_link [modules] logout prefs chgpwd accrights userlist_login hide_eventcal hide_global hide_taskview hide_managegroups hide_suggesttime hide_show_unconfirmed hide_updateall enable_designate hide_viewpub [file_attachment] download_enable upload_enable [taskview] quickCreateStartTime quickCreateEndTime showQCCompletion [calendar_view] default_view default_dayview_mode default_weekview_mode hide_dayview_toggle hide_weekview_toggle pdv_notes_top_task_bottom default_color_mgt_by [cookies] domain [sms] enable [sched] userlist_login (becomes same key in "modules" section of ocwc.conf) serverlist_login (becomes same key in "modules" section of ocwc.conf). enable_autologin (becomes same key in "modules" section of ocwc.conf). modify_emailadd (becomes same key in "modules" section of ocwc.conf). showicalvcal (becomes same key in "modules" section of ocwc.conf). [ACE] authentication (becomes 'Authentication' of ocwc.conf).