Install the Collaboration FlexLM License (new licenses)
Install the Collaboration FlexLM License (existing licenses)
Copy the Oracle driver into the Collaboration Server (Only for Oracle Database)
Each of these steps has been elaborated in the following sections.
Before installing Collaboration Server, stop the iPlanet (Sun ONE) server instance.
Using a web browser, navigate to http://<CCS SERVER>:8888, assuming that the Sun ONE Admin server is installed on port 8888.
Login to the Sun ONE Administration web page using your administration username and password.
Select the iPlanet (Sun ONE) server instance on which you are going to install CCS and in the "Select a Server" pull-down menu, then click "Manage"
Click the "Server Off" button.
The iPlanet (Sun ONE) server instance is stopped.
Cisco recommends to install Collaboration Server as the root user.
The installation script reconfigures an existing Sun ONE server instance for the Collaboration Server to run successfully. Although Sun ONE allows for multiple product installations under a single server instance, Cisco does not recommend installing any other products on the same instance that contains the Collaboration server.
1. |
Insert the CCS 5.0 CD into the CCS machine's CD drive. Ensure that you copy the contents of your CD to a directory where you want to install the CCS. |
2. |
The Cisco Collaboration Server installation files are in the CCS 5.0 CD in the folder 'Cisco_CS'. |
3. |
Change the directory to <CCS Install Directory> if you are not already in that directory. That is: cd Cisco_CS |
4. |
Run the CCS install script with the command: ./install |
5. |
The install script prompts for the root directory of the Sun ONE server installation. The script detects the directory and displays it on the screen. That is, it might display: /usr/iplanet/servers. If this is the correct directory then press <Enter> to continue, otherwise enter the correct path for the root directory of the Sun ONE server installation, then press <Enter> to continue. |
6. |
The install script prompts you to enter the iPlanet (Sun ONE) server instance you would use for the CCS installation. The available iPlanet (Sun ONE) server instances are listed. Choose the instance on which you want to run CCS by typing 'Y' for that instance and then press <Enter>. |
7. |
The install script asks you to specify the root directory for your new CCS installation (<CCS Root Directory>). Press <Enter> to accept the default location. |
8. |
Change the user and group ownership of the CCS files. Note that you will not be able to change user and group permissions if you do not have root privileges yourself. Press <Enter> to continue. For default configuration, type 'nobody' for both CCS owner and CCS group. |
9. |
Install script prompts for a JDBC driver location. Note: CCS for Solaris has been tested with Oracle 8.1.7 using the Oracle JDBC driver. If you have already installed the JDBC drivers for the database and know the location of your Oracle JDBC drivers, specify them here. If you do not have any JDBC drivers installed on your system, then choose the default location for the JDBC driver of the database you are going to use, then refer the "Installing Database Drivers" information in the next section of this document after the install program has exited. Press <Enter> to continue. |
10. |
The install script extracts and installs CCS and the CCS directory structure is put in <CCS Root Directory>. |
Note: The install script generates a log file 'install_log.txt' which is located in the Cisco_CS/log directory. The log file records all the steps taken by the install script. If you encounter errors you can review this file to help you track down any problems.
Note: Ensure that you give write-permissions to the following directories:
Cisco_CS/log
Cisco_CS/licence and
Cisco_CS/pageCompile
The directory permissions for user and group must be the same as those that the Sun ONE (iPlanet) instances run on.
Caution: Do not reboot the server or restart iPlanet before installing the FLEXlm license key.
Your CCS installation is not considered complete until you complete the following steps:
Install the License file
Copy the database driver to the CCS under Cisco_CS/servlet location.
Configure CCS to the Oracle Database
Configure the Agents.
Stop the iPlanet server instance if it is running.
Locate the Product Authorization Key (software serial number) on the back of your Collaboration CD.
In a Web browser, open
the Cisco Software Registration Web page.
Registered Cisco Connection Online users:
http://www.cisco.com/cgi-bin/Software/FormManager/formgenerator.pl
Non-registered users:
http://www.cisco.com/pcgi-bin/Software/FormManager/formgenerator.pl
On the Software Registration page, select Cisco Collaboration Server from the list of software forms.
Follow the instructions on the Collaboration Server registration page. When you have completed the form and entered your Product Authorization Key, a license file with the extension .lic will be sent to your email address.
Copy the <CCS
license>.lic file to the <CCS
install dir>/license directory.
Note: Do
not restrict write access to the <CCS
install dir>/license
directory. Collaboration
writes a temporary file to that directory while reading the license file.
Restart the iPlanet server instance.
To install a pre-existing or additional FLEXlm license file:
Rename the the license file if necessary to avoid overwriting an existing file in the license directory.
Copy the license file (.lic) into the <CCS install dir>/license directory.
Restart the iPlanet server instance.
Do not overwrite .lic files in the license directory. Collaboration will calculate your licensed seats based on all .lic files in the license directory.
Note:
Renaming
and copying the same license file within the <CCS
install dir>/license
directory does not add seats to your existing license(s). Collaboration
ignores duplicate files.
Caution: Do
not modify license files. Collaboration
will not recognize INCREMENT lines that have been altered or added to
the file. Collaboration may not recognize the .lic file at all if you
have opened the .lic file in an editor and re-saved the file.
To connect to the database, copy the Oracle JDBC-Thin Driver v8.1.7 (classes12.zip) to the <CCS install dir>/servlet directory.
To locate the Oracle JDBC-Thin Driver v8.1.7 driver (Oracle8i 8.1.7 JDBC Drivers for use with JDK 1.2.x):
Search your Oracle installation CDs for the file classes12.zip, or
Go to the Oracle download site (http://technet.oracle.com/software/download.htm). If you are not already a member of the Oracle Technology Network, click on the membership link at the top of the page to join. Membership is free.
Note: If you are already a member of the Oracle Technology Network, you can find the classes12.zip file at:
http://otn.oracle.com/software/tech/java/sqlj_jdbc/htdocs/winsoft.html
From the Oracle installation CD or the Oracle download site, copy the file classes12.zip to <CCS install dir>/servlet.
Note: If iPlanet is running then you need to restart the server before Collaboration can detects the newly installed drivers.
Important: Do not unzip the classes12.zip file.
Before installing Collaboration Server, stop the iPlanet (Sun ONE) server instance.
Using a web browser, navigate to http://<CCS SERVER>:8888, assuming that the Sun ONE Admin server is installed on port 8888.
Login to the Sun ONE Administration web page using your administration username and password.
Select the Sun ONE server instance on which you are going to install CCS and in the "Select a Server" pull-down menu, then click "Manage"
Click the "Server On" button.
The iPlanet (Sun ONE) server instance is started.
Only after you have started the iPlanet (Sun ONE) Server Instance, you can begin with configuring the database.