Novell Doc: Conferencing 1.0 Server Installation Guide - Installing the Conferencing Server

2.5 Installing the Conferencing Server

NOTE:If you plan on using VoIP with Conferencing, you must install and configure the NMS board and associated software before running the main installation. For more information, see Installing and Configuring the NMS Boards.

Perform this procedure after you extract the sitescape-conferencing-version.tar.gzConferencing server distribution file on an installation-staging host.

To install or upgrade the Conferencing System Components:

Verify that the Installation Prerequisites are in place and that you have performed all pre-installation steps, see Preparing for Installation.
Unpack the files.
Back up the sitescape-conferencing directory (if applicable).
Open the sitescape-conferencing directory.
Run ./install.sh, which prompts you for the configuration information, license key and then installs the software, see Running the Installer on SLES::
- Initialization of the database server
- Installation and configuration of the XML router services
- Installation and configuration of the Web portal services
- Installation and configuration of the application/desktop sharing
- Installation and configuration of e-mail configuration
- Installation and configuration of backup, meeting archive, logging and port forwarding
- Modification of the template files

During the installation process, you are asked whether you want to modify the associated templates. For more information, see Section 4.0, Modifying Template Files.

This section contains the following topics:

2.5.1 Running the Installer on SLES:

Unpack the distribution compressed tar archive (sitescape-conferencing-<version>.tar.gz):
```
# tar -zxf filename.tar.gz
```
Copy the license key to the sitescape-conferencing directory that contains install.sh (the directory files exist after you unpack the compressed tar archive):
```
# cp license_key.xml
```
Change directories to the sitescape-conferencing directory that contains install.sh:
```
# cd sitescape-conferencing
```
(Optional) If you plan on running Active Directory* LDAP Synchronization, edit the ldap.xml.in file in the cluster-prototype directory. (For more information, see Section E.0, LDAP User Authentication):
1. Open the ldap.xml.in file.
2. Comment out the eDirectory attributes section and uncomment out the ActiveDirectory attributes section.
3. Save the file.
Run the installer:
```
# ./install.sh
```
When the installer prompts you to accept the license agreement (the default is N), enter Y:
```
Accept License (Y/N): Y
```
When the installer prompts you to proceed, enter Y:
```
Ready to proceed (Y/N): Y
```
When the installer prompts you to select whether this is a new install or an upgrade (the default is N), enter Y to run a new installation:
```
New Install or upgrade (Y/N): Y
```
When the installer prompts you to enter a name for the install (the default is ourzon), enter the name you want to use for the install:
```
Choose a name for Install: <enter_install_name>
```
The name of the installation cannot contain spaces, but can contain any combination of ASCII and alphanumeric characters.
When the installer prompts you to initialize the database for a new install (the default is Y), you must enter Y here for a new installation or the database service does not start:
```
Initialize Database for new install (Y/N): Y
```
Ensure that you have installed the PostgreSQL database prior to installation. For more information, see Installation Prerequisites.

IMPORTANT:If you are upgrading and have an existing database, you can enter N. For new installations, always enter Y.
Provide a password when the installer prompts you to enter a password for the new administrator account that the installer creates for Conferencing (this should be set for security reasons, because the Administrator account needs to be a controlled environment):
```
Password for Admin User: <enter_password>
```
IMPORTANT:The cursor does NOT advance with each keystroke (no asterics are displayed).
The installer prompts you whether to enable SSL/TLS security (the default is Y):
```
Should System enable SSL/TLS security (Y/N): <enter_value>
```
SSL= Secure Socket Layer and TLS= Transport Layer Security. If you enable SSL/TLS security, the user and password information is encrypted on the network and shows up as hashes in the database table. If you select N, password information is still hashed in the database, but user and password are in the clear on the wire.
The installer prompts you to enter the path and name of the certificate for the XML router (the default is /opt/iic/conf/server.pem), enter the default certificate:
```
Insert path and name of certificate for XML router: 
/opt/iic/conf/server.pem 
```
IMPORTANT:You must use the default XML router certificate for the Conferencing server to function correctly.
Use the following path when the installer prompts you to enter the path and name of the certificate for the Web Server:
```
/opt/iic/conf/webserv.pem
```
IMPORTANT:You must use the default Web Server certificate for the Conferencing server to function correctly.
When the installer prompts you to identify whether you are installing on a Single-Host or a Multiple-Host installation (the default is Y), select N if you have multiple servers, and the installer prompts you to enter the additional information for a Multiple-Host installation:
```
Are you installing on single host (Y/N): <enter_value>
```
When the installer prompts you to enter the IP address for the XML router, enter the address:
```
What is IP address for XML router?: <enter_ip_address>
```
The installer attempts to ping hosts and IP addresses to ensure that they are running and reachable. If an intervening firewall is filtering out ICMP messages or the host is intentionally down, it might not appear to be reachable even though the entered value is valid.
Enter a value when the installer prompts you to enter the hostname of the conferencing server:
```
What is hostname that conferencing clients will use to connect to XML?: <enter_value>
```
When the installer prompts you to enter the IP address for the Web portal, enter the address:
```
What is IP address for Web Portal?: <enter_ip_address>
```
When the installer prompts you to enter the portal name, enter the name:
```
What is Web Portal name URL's?: <enter_portal_name>
```
For example, Renaldo.homedns.org-portal.
When the installer prompts you to enter the IP address for the App-Share, enter the address:
```
What is IP address for App-Share?: <enter_ip_address>
```
Enter a value when the installer prompts you to enter the Hostname for the desktop App-Share:
```
What is Hostname for desktop app-share: <enter_hostname>
```
For example, renaldo.homedns.org-share.
Enter a value when the installer prompts you to select whether you are running Conferencing Bridge (the default is N). If you enter Y, the installer prompts you to enter the bridge information:
```
Are you running Conferencing Bridge? (Y/N): <enter_value>
```
Enter a value when the installer prompts you to select whether you want to change the system administration e-mail configuration (the default is N). If you enter Y, the installer prompts you to enter the new e-mail address configuration information instead of using default configuration:
```
Do you want to change system admin email configuration? (Y/N): <enter_value>
```
For more information on optional configurations you can use, see Section 2.6.2, System Administration E-mail Configuration (Optional).
The installer prompts you to verify what you have entered up to this point. Enter Y if the information is correct or enter N if you need to make any changes:
```
Is this correct (Y/N): <enter_value>
```
The questions from Step 25 through Step 38 all have default values of N. If you select Y, the installer prompts you to enter additional values and information to customize your server configuration. You can customize your configuration for information such as how long a file is archived, with a different header look, the way summaries are viewed, security settings. If you use the defaults and decide to customize your server configuration later, you must rerun the installer to change these values.
Enter a value when the installer prompts you to select whether you want to change the mailer configuration:
```
Do you want to change mailer config? (Y/N): <enter_value>
```
For more information on optional configurations you can use, see Section 2.6.3, Mailer Configuration (Optional).
Enter a value when the installer prompts you to select whether you want to change the database backup configuration:
```
Do you want to change DB backup config (Y/N): 
```
For more information on optional configurations you can use, see Section 2.6.4, Database Backup Configuration (Optional).
Enter a value when the installer prompts you to select whether you want to change the meeting archive maintenance configuration:
```
Do you want to change meeting archive maint? (Y/N): <enter_value>
```
For more information on optional configurations you can use, see Section 2.6.5, Meeting Archive and Document Sharing Repository Configurations (Optional).
Enter a value when the installer prompts you to select whether you want to change the document share repository maintenance configuration:
```
Do you want to change doc share repository maint config? (Y/N): <enter_value>
```
For more information on optional configurations you can use, see Section 2.6.5, Meeting Archive and Document Sharing Repository Configurations (Optional).
Enter a value when the installer prompts you to select whether you want to change the audit logs:
```
Do you want to change Audit logs? (Y/N): <enter_value>
```
For more information on optional configurations you can use, see Section 2.6.6, Chat Audit Log Configuration (Optional).
Enter a value when the installer prompts you to select whether you want to change the logging configuration:
```
Do you want to change logging config? (Y/N): <enter_value>
```
For more information on optional configurations you can use, see Section 2.6.6, Chat Audit Log Configuration (Optional).
Enter a value when the installer prompts you to select whether you want to change the real-time call user-reservations logs:
```
Do you want to change real-time call user-reservations logs? (Y/N): <enter_value>
```
For more information on optional configurations you can use, see Section 2.6.7, Event Logging Configuration (Optional).
Enter a value when the installer prompts you to select whether you want to change the security configuration:
```
Do you want to change security configuration? (Y/N): <enter_value>
```
For more information on configurations you can use, see Section 2.6.9, XML Router Security.
Enter a value when the installer prompts you to select whether you want to change the LDAP configuration:
```
Do you want to change LDAP (Y/N): <enter_value>
```
For more information on optional configurations you can use, see Section 2.6.10, Configuring LDAP Synchronization (Optional). For Active Directory LDAP Synchronization, you need to complete Step 4 first.
Enter a value when the installer prompts you to select whether you want to change the system e-mail header configuration:
```
Do you want to change system email header config? (Y/N): <enter_value>
```
Enter a value when the installer prompts you to select whether you want to change the e-mail template:
```
Do you want to change Email template? (Y/N): <enter_value>
```
Enter a value when the installer prompts you to select whether you want to change the meeting invitation template:
```
Do you want to change Meeting invite template? (Y/N): <enter_value>
```
Enter a value when the installer prompts you to select whether you want to change the summary e-mail template:
```
Do you want to change Summary email template? Y/N): <enter_value>
```
Enter a value when the installer prompts you to select whether you want to change the meeting archive e-mail template:
```
Do you want to change Meeting archive email template? (Y/N): <enter_value>
```
When the installer lists all the services running on the local host, press Enter to continue:
```
All services running on local host
```
When the installer lists all the configuration information, press Enter to continue:
```
View Config
```
Enter a value when the installer prompts you to select whether you are satisfied with the configuration (the default is Y). Enter N to change the configuration:
```
Satisfied with config (Y/N): <enter_value>
```

The installation begins and uses whatever values you entered during the installation setup. The installation completes and displays information stating the services that should be running.

After you have completed the installation script, you are presented with a summary of the choices you selected. If you are not satisfied with the configuration setup, you can either modify the configuration or you can exit the installer and run the script again. If you exit the installer, the current configuration is saved, and when you rerun the install script, it is used for the default values during the reconfiguration.

2.5.2 Initial Address Book Configuration (Synchronization)

If you are using LDAP synchronization, execute /opt/iic/bin/ldap-sync.sh <portal-server-hname> to perform the initial synchronization.

NOTE:After starting the server, wait about 20 seconds before executing this command; if you do not get an XML message in return, you probably did not wait long enough.

This script displays an XML message if it fails (the fault message is clearly visible); if it succeeds, the XML data contains a single number that is the number of users actually synchronized. You can run this script manually as needed, or use cron to configure it to run periodically. The default setting is for it to run daily.