![]()
This file was last modified 2002-08-12
Thank you for choosing CorporateTime Server. This file contains installation instructions only. Please see the CorporateTime Server Administrator's Guide and Reference Manual for information about configuring, administering and maintaining your calendar server. PDF versions of these manuals are also available (Administrator's Guide | Reference Manual). Please see the release notes for supported platforms, system requirements, a list of included features and a description of known problems.
This product can be used with an internal directory or an external LDAP directory server. Support for the Lightweight Directory Access Protocol (LDAP) is offered through separate connectors: LDAP Connector 1.5 for Critical Path InJoin Directory Server (formerly ISOCOR Global Directory Server), LDAP Connector 1.5 for Syntegra Global Directory Server (formerly Control Data Systems Global Directory Server), LDAP Connector 1.5 for Netscape Directory Server, and LDAP Connector 1.5 for iPlanet Directory Server. If you already use an LDAP Connector of version 1.3, no manual upgrade procedure is necessary.
Contents of this README file
CorporateTime Server with internal directory
- Installing CorporateTime Server with internal directory
- Uninstalling CorporateTime Server with internal directory
CorporateTime Server with external LDAP directory server
- Preparing your directory server
- Installing CorporateTime Server with LDAP Connector
- Directory Server terminology
- Uninstalling CorporateTime Server with LDAP Connector
If your demo license has expired
CorporateTime Server Administrator (Windows NT Administration GUI)
Calendar Administrator (Web administration interface)
How to report problems
Please contact Oracle's technical support department at support@steltor.com or call (514) 733-8500.
Before you install CorporateTime Server
Before you install your calendar server, ensure that:
- You have your server's root password or you have root privileges.
- Your server has at least 64 MB of RAM.
- Your server has at least 150 MB of free space on the hard drive during installation.
- You have removed any extraneous files and subdirectories from the
/users/unison/bindirectory and any modified reminder files from/users/unison/etc/reminder, as these directories will be overwritten during the installation.NOTE: Refer to Chapter 2, "Deployment," and Appendices A ("Disk Space and Memory") and B ("Sizing Guidelines") in the CorporateTime Server Administrator's Guide for more detailed instructions on estimating the anticipated calendar server usage within your organization.
NOTE: CorporateTime Server must run as root or unison.
Installing CorporateTime Server with internal directory
Setup:
UNIX
- Login as
rootor as a user with root privileges.- Create a UNIX group account called
dxoffice.- Create a UNIX user account called
unisonin the groupdxoffice.- Edit
/etc/servicesto include the following entries:- Run the installation script:
- If you are upgrading from a previous version of CorporateTime Server, the presence of a
/users/unisondirectory will be detected. Your old configuration settings (those in/users/unison/misc/unison.ini) will be merged with the newunison.iniand/users/unison/dbarchived and restored upon installation of the new server. Obsolete parameters will be removed. Other rarely used parameters may also be removed if their values have been left unchanged. This is done in order to simplify theunison.inifile and make it easier to maintain by displaying only those parameters you may need to tune.- For a fresh install you will be prompted to:
- Consult the release notes for any additional patches or enhancement packs that may be required.
- Refer to the Administrator's Guide for more information concerning the configuration of the calendar server (time zone, logged-on user limit, mail notification, etc.).
See the on-line Administrator's Guide for full configuration, use and maintenance instructions.
NT
- Run the CorporateTime Server self-extracting executable and follow the instructions on the screen.
- If you are upgrading from a previous version of CorporateTime Server, the presence of a
\users\unisondirectory will be detected. Your old configuration settings (those in\users\unison\misc\unison.ini) will be merged with the newunison.iniand\users\unison\dbarchived and restored upon installation of the new server. Obsolete parameters will be removed. Other rarely used parameters may also be removed if their values have been left unchanged. This is done in order to simplify theunison.inifile and make it easier to maintain by displaying only those parameters you may need to tune.- For a fresh install you will be prompted to:
- Consult the release notes for any additional patches or enhancement packs that may be required.
- Refer to the Administrator's Guide for more information concerning the configuration of the calendar server (time zone, logged-on user limit, mail notification, etc.).
See the on-line Administrator's Guide for full configuration, use and maintenance instructions.
Uninstalling CorporateTime Server with internal directory
UNIX
- Stop the calendar server using the
unistoputility.- Delete the <calendar server path>.
- Delete the
/usersdirectory.- Remove the UNIX user account
unison.- Remove the UNIX group account
dxoffice.- Remove the
uniengandunisncentries from/etc/services.NT
Select Start | Settings | Control Panel | Add/Remove Programs, select CorporateTime Server, and follow the operating system instructions.
If you are unable to remove your calendar server using the method above, complete the following
- Stop the calendar server using one of the following methods:
- Remove the
\users\unisondirectory.- Using regedit, find and remove the entry under
- Reboot.
Preparing your directory server
Critical Path InJoin Directory Server (formerly ISOCOR Global Directory Server)
Note: the home directory of the InJoin Directory Server is assumed to be
/usr/x500dsin the following instructions. If you have installed the product to another directory, adjust the absolute path for the InJoin files accordingly.
- Unpack the contents of the LDAP Connector package file in a staging directory. The directory should contain the following files:
- Copy the following calendar server configuration files to the targeted directories:
- Append
ct-oidnames.cfgto/usr/x500ds/scripts/db/oidnames.cfg. Insert"CorporateTime"immediately before"MISCELLANEOUS"in theOidOrderkey[Settings]section. Also, if this file is duplicated under/usr/x500ds/ldap/etcand the~/dibdirectory, these files should also be updated.- Make the calendar server attributes known to odsadmin & odsdua:
- Make the calendar server prefixes known to the Directory Server:
- Make the calendar server attributes known to the Directory Server:
- Make the calendar server object classes known to the Directory Server:
- Make the calendar server attributes known to the ISOCOR web interface:
- Bring the Directory Server down and back up again. (During InJoin DS installation, a default DSA is generated in
~/dibdirectory, seedib/odsgen.inffor pertinent information. If your DSA is indib0, then adjust the commands below accordingly.)- Ensure that no errors occurred:
- Copy the following calendar server command files to your DSA directory (
~/dib)- Add the calendar server schema to the Directory Server:
- Start the ISOCOR GDS command line shell:
- Bind as the Directory Server manager
- Apply the calendar server schema definition to the Directory Server. Note that the '
~' causes the command file to be processed without prompting.- Initialize the Directory Server (OPTIONAL - some steps may be skipped if your site is already set up)
- Create an Entry Starting Point (ESP) if none has been initialized. An Access Control Specific Point (ACSP) will also be created:
- If an ESP exists without an ACSP, create an ACSP only:
- If the default Access Control Information (ACI) has not been initialized, this command file will set ACI to permit anonymous read only access and to allow authenticated users the right to modify their own entry. Be aware of how this will modify your Directory Server's security. For more information on the default ACIs used by the calendar server, please see the Calendar Server Access Control Requirements.
- Create the CorporateTime SYSOPs ACIs
- Type "
." (a period) to quit the GDS command line shell- To verify your success, enter the following URL in a browser to display the entries under the BaseDN:
Upgrading from pre-1.3 versions of the LDAP connector:
- Copy the new
ct-oidnames.cfgto <Installation directory>/scripts/db- Copy the new
ct-oidnames.cfgto every working directory of the directory server instance (DIB,DIB0,DIB1, ...) and to <Installation directory>/ldap/etc- Copy the new
ct-oidslocalto <Installation directory>/scripts- Copy the new
ct-oidtable.atto <Installation directory>/ldap/etc- Copy the new
ct-oidtable.octo <Installation directory>/ldap/etc- Copy the new
ct-x500web.atto <Installation directory>/wg- Copy the file
corptime_schemato every working directory of the directory server instance (DIB,DIB0,DIB1, ...). For each instance:
- Run
odsadmin- Bind as directory manager by typing
bman, or if the manager and password is not the default, by typingbind -n N(rcn(<SuperUserDN>)) -p<password>- Run
corptime_schema ~- Type "
." alone to quit. Some errors will be reported. This is expected; the errors are caused by adding existing atttibutes to the directory server- Run
odsstopandodsstartto restart the directory server.- Apply the schema changes through the navigator. The following steps must be completed for each instance of the directory server.
- Login as the directory server manager.
- Select the Administration | Schema menu.
- Select the "Defined Attributes" tab and make sure that
ctCalPublishedTypeis in the list of attributes.- Select the "Object Classes" tab.
- Double click the "ctCalUser" object class.You should be in the "Configure Object Class" window.
- Select the right pane: "May Contain these attributes".
- Click the Add button.
- Select "ctCalPublishedType" and "ctCalSMSTimeRange" from the list of attributes.
- Click OK repeatedly until you see the "Configure Schema" window.
- Select the check box "Synchronize local schema on OK".
- Click OK repeatedly until all dialog boxes are closed.
- Exit the navigator application (critical step).
- Run the navigator application and follow the above steps for other instances.
Syntegra Directory Server (formerly Control Data Global Directory Server)
UNIX
- Login as
rootor as a user with root privileges.- Create a UNIX group account called
dxofficewith an ID of less than 60000.- Create a UNIX user account called
unisonwith an ID of more than 100 and less than 60000 in the groupdxoffice.- Edit
/etc/servicesto include the following entries:- Untar the contents of the LDAP Connector package file to a temporary directory (hereafter referred to as <Temp Directory>).
- The directory should contain:
- To prepare the directory server, you will need to install files to configure ctCal directory objects.
- Restart the directory server to allow the configuration changes to take effect.
NT
- Login as a user with administrator privileges.
- Extract the contents of the LDAP Connector package file to a temporary directory (hereafter referred to as <Temp Directory>).
- The directory should contain:
- To prepare the directory server, you will need to install files to configure ctCal directory objects.
- Restart the Directory Server to allow the configuration changes to take effect.
Upgrading from pre-1.3 versions of the LDAP connector
- Copy the new
oidtable.oc_cstto <Installation directory>/var/osi- Copy the new
oidtable.at_cstto <Installation directory>/var/osi- Open the file
oidtable.oc_cst- Edit the file <Installation directory>
/var/osi. Replace the calendar server section with the content ofoidtable.oc_cst.- Follow the same step for the file
oidtable.at_cst- Restart the directory server
Netscape Directory Server
UNIX
- Login as
rootor as a user with root privileges.- Create a UNIX group account called
dxofficewith an ID of less than 60000.- Create a UNIX user account called
unisonwith an ID of more than 100 and less than 60000 in the groupdxoffice.- Edit
/etc/servicesto include the following entries:- Extract the contents of the LDAP Connector package file to a temporary directory (hereafter referred to as <Temp Directory>).
- The directory should contain:
- To prepare the directory server, you will need to install files to configure ctCal directory objects.
- Copy the files:
- For Netscape Directory Server 3.x:
- Edit the <Directory Server Root>
/slapd-<Server Name>/config/slapd.conffile to include the following files in the indicated sequence:: include <Directory Server Root>/slapd-<Server Name>/config/ns-schema.conf include <Directory Server Root>/slapd-<ServerName>/config/oracle-calendar-schema.conf : include <Directory Server Root>/slapd-<Server Name>/config/ns-globopt.conf include <Directory Server Root>/slapd-<ServerName>/config/oracle-calendar-globopt.conf :- For Netscape Directory Server 4.x:
- Edit the <Directory Server Root>
/slapd-<Server Name>/config/slapd.conffile to include the following file in the indicated sequence:: include <Directory Server Root>/slapd-<Server Name>/config/ns-schema.conf include <Directory Server Root>/slapd-<ServerName>/config/oracle-calendar-schema.conf :- Edit the <Directory Server Root>
/slapd-<Server Name>/config/slapd.ldbm.conffile to include the following file at the bottom of the file:include <Directory Server Root>/slapd-<ServerName>/config/oracle-calendar-globopt.conf- Restart the directory server to allow the configuration changes to take effect.
NT
- Login as a user with administrator privileges.
- Extract the contents of the LDAP Connector package file to a temporary directory (hereafter referred to as <Temp Directory>).
- The directory should contain:
- To prepare the directory server, you will need to install files to configure ctCal directory objects.
- Copy the files:
- For Netscape Directory Server 3.x:
- Edit the <Directory Server Root>
\slapd-<Server Name>\config\slapd.conffile to include the following files in the indicated sequence:: include <Directory Server Root>\slapd-<Server Name>\config\ns-schema.conf include <Directory Server Root>\slapd-<ServerName>\config\oracle-calendar-schema.conf : include <Directory Server Root>\slapd-<Server Name>\config\ns-globopt.conf include <Directory Server Root>\slapd-<ServerName>\config\oracle-calendar-globopt.conf :- For Netscape Directory Server 4.x:
- Edit the <Directory Server Root>
\slapd-<Server Name>\config\slapd.conffile to include the following files in the indicated sequence:: include <Directory Server Root>\slapd-<Server Name>\config\ns-schema.conf include <Directory Server Root>\slapd-<ServerName>\config\oracle-calendar-schema.conf :- Edit the <Directory Server Root>
\slapd-<Server Name>\config\slapd-ldbm.conffile to include the following file at the bottom of the file:: include <Directory Server Root>\slapd-<ServerName>\config\oracle-calendar-globopt.conf :- Restart the directory server to allow the configuration changes to take effect.
Upgrading from pre-1.3 versions of the LDAP connector
iPlanet Directory Server
- Extract the contents of the LDAP Connector package file to a temporary staging directory. The directory should contain:
- Apply the schema by running:
Installing CorporateTime Server with LDAP Connector
UNIX
- Ensure that your directory server is installed and configured correctly, and that you have followed the steps outlined above to prepare your directory server.
- Open the calendar server package in a staging directory.
- Place your LDAP Connector package file in the same directory.
- Run
unisetup. For a first-time install, this script will create a/users/unisontree, install the CorporateTime Server package, and create an initial node.
- For an upgrade from a previous installation, this script will install the new version, restore the archived databases and will add the existing nodes to the directory server. The presence of a
/users/unisondirectory will be detected. Your old configuration settings (those in/users/unison/misc/unison.ini) will be merged with the newunison.iniand/users/unison/dbarchived and restored upon installation of the new server. Obsolete parameters will be removed. Other rarely used parameters may also be removed if their values have been left unchanged. This is done in order to simplify theunison.inifile and make it easier to maintain by displaying only those parameters you may need to tune.- Follow the installation script instructions:
- When prompted to specify the URL to access the LDAP-based Directory Server, enter:
- The
unisetupscript will ask for a DN to group the SYSOP users under. This DN will be appended to the previously specified root DN, and will be used as the calendar server administrators' Parent DN. For example:
- If you specify a DN other than the default (none), you must ensure that this DN exists before running
unisetup.- The
unisetupscript will ask for a calendar server administrators' Group DN. This DN will be appended to the previously specified base DN. For example:- Run
/users/unison/bin/unidsacisetupto create the directory server access control information (ACI). For more information on the default ACIs used by the calendar server, please see the Calendar Server Access Control Requirements.- Consult the release notes for any additional patches or enhancement packs that may be required.
See the on-line Administrator's Guide for full configuration, use and maintenance instructions.
NT
- Ensure that your directory server is installed and configured correctly, and that you have followed the steps outlined above to prepare your directory server.
- Run the CorporateTime Server self-extracting executable. Follow the instructions displayed and refer to the Directory Server terminology table to ensure that you enter the correct values where required.
- If you are upgrading from a previous version of CorporateTime Server, the presence of a
\users\unisondirectory will be detected. Your old configuration settings (those in\users\unison\misc\unison.ini) will be merged with the newunison.iniand\users\unison\dbarchived and restored upon installation of the new server. Obsolete parameters will be removed. Other rarely used parameters may also be removed if their values have been left unchanged. This is done in order to simplify theunison.inifile and make it easier to maintain by displaying only those parameters you may need to tune.- If using Netscape Directory Server or Control Data Global Directory Server, run
\users\unison\bin\unidsacisetupto create the directory server access control information (ACI).- Consult the release notes for any additional patches or enhancement packs that may be required.
See the on-line Administrator's Guide for full configuration, use and maintenance instructions.
Directory Server terminology
Use the following table to determine the correlation between the directory server parameters required during installation and the terminology used for each separate product.
Uninstalling CorporateTime Server with LDAP Connector
UNIX
- Stop the calendar server using the
unistopcommand.- In the Directory Server, remove the calendar server attributes from your calendar users. This is done by using LDIF update commands.
- In the Directory Server, remove all ctCal objects for the calendar server nodes that were on this server.
- In the Directory Server remove all the relevant calendar server administrative groups and ACLs from the database.
- Delete the <calendar server path>.
- Delete the
/usersdirectory.- Remove the UNIX user account
unison.- Remove the UNIX group account
dxoffice.- Remove the
unieng,unisnc, andunidasentries from/etc/services.NT
Select Start | Settings | Control Panel | Add/Remove Programs and follow the operating system instructions to remove the calendar server.
If you are unable to remove the calendar server using the method above:
- Stop the calendar server using one of the following methods:
- In the Directory Server, remove the calendar server attributes from your calendar users. This is done by using LDIF update commands.
- In the Directory Server, remove all ctCal objects for the calendar server nodes that were on this server.
- In the Directory Server remove all the relevant calendar server administrative groups and ACLs from the database.
- Remove the
\users\unisondirectory.- Using
regedit, find and remove the entry under- Reboot the machine.
If your demo license has expired
- Contact Oracle support at (514) 733-8500 and request a new license key.
- Stop your calendar server using the
unistoputility.- Open the
/users/unison/misc/unison.inifile and replace the value of the[LIC] licenseparameter with the key supplied to you.- Restart your calendar server using the
unistartutility.
CorporateTime Server Administrator
The CorporateTime Server Administrator is an NT-based GUI used to manage the CorporateTime Server. Many administrative tasks and procedures may be performed using this tool, although some functionality is available only through command-line utilities. See the Administrator's Guide for a more complete description of when and how the Admin GUI can be used. The CorporateTime Server Administrator is included as part of the installed package for the NT version of CorporateTime Server.
Calendar Administrator
The Calendar Administrator is a CGI- or FastCGI-based Web administration tool for your calendar server. Use it to manage users, resources, holidays, and event calendars. The Calendar Administrator requires a Web server and a Web browser compatible with HTML 3.2 (Microsoft Internet Explorer 4.0 or greater, Netscape Navigator 4.0 or greater). For installation instructions, see the Calendar Administrator readme file.