Installing the Sametime Video MCU

Install prerequisite Red Hat Package Manager (RPM) files and then install IBM® Sametime® Video MCU. Remember that the Sametime Video MCU is available only on Linux, and only with the Sametime Conference and Sametime Complete offerings. The Sametime Video MCU must be installed on a dedicated server.

Before you begin

You must have completed a deployment plan for the Sametime Video MCU before attempting to install it.
The following directories at the top level are reserved for product installation and are removed if you uninstall the product. Before you install the Sametime Video MCU, rename any folders at the top level that use these reserved directory names:
  • /config
  • /cs
  • /cs/cfg
  • /data
  • /EMA
  • /EMACfg
  • ../../lib/libz.so.1.2.3
  • /mcms
  • /mrmx
  • /output
Note: The Sametime Video MCU is designed to use the network interface adapter eth0. If you want to use a different adapter (for example, eth1), complete the following steps to configure the adapter before installing the Video MCU application.
  1. Create a directory named mcu_custom_config under the root directory.
  2. Open the directory and create a file named custom.cfg.
  3. Copy the following contents to the custom.cfg file (In this example, eth1 is being configured.). 
    <SYSTEM_CFG> 
<CFG_SECTION> 
<NAME>CUSTOM_CONFIG_PARAMETERS</NAME> 
<CFG_PAIR> 
<KEY>DEFAULT_NETWORK_INTERFACE</KEY> 
<DATA>eth1</DATA> 
</CFG_PAIR> 
</CFG_SECTION> 
</SYSTEM_CFG>
  4. Save the custom.cfg file.

The installation script checks for SELinux being enabled, and for any Apache processes that are running. Disable SELinux and remove any preexisting versions of Apache Server before running the Video MCU installation script.

Procedure

  1. On the computer where you will install the Sametime Video MCU, and log on as root.
  2. Install the dialog package:
    1. Open a command window.
    2. Install the dialog package by running the following command: For example, in Red Hat Linux, run these commands:
      yum install dialog
    3. Install the java package by running the following command: 
      yum install java

      If you are running on SLES, use YaST to install Java.

  3. Find the software packages you need to download.
  4. Download the packages.
  5. Extract all downloaded packages.
  6. Change to the directory where you extracted the Sametime Video MCU package.
  7. Open a terminal into the Sametime Video MCU server. Find the Java path by entering this command:

    which java

    Make a note of the path, such as /usr/bin/java.

  8. Edit the console.properties file and fill in all settings before saving and closing the file.

    Comments embedded in the file explain what information to provide for each setting. Use the following settings as an example:

    Fully qualified domain name: SSCHostName=Sametime90Lab01.renovations.com

    HTTP port: SSCHTTPPort=9080

    HTTP port if SSL is enabled: SSCHTTPSPort=9443

    Enable SSL between this host and Sametime System Console: SSCSSLEnabled=true

    Sametime System Console administrator: SSCUserName=wasadmin

    Sametime System Console administrator password: SSCPassword=password

    Unique deployment plan name: depName=VMCU_Sametime90Lab04

    Fully qualified domain name (no IP addresses): localHostName=Sametime90Lab04.renovations.com

    Java home: JAVA_HOME=/usr

    Note: For the JAVA_HOME setting, the value /bin/java is automatically appended to the path you provide. For example, if you installed Java at /usr/bin/java, then you should type /usr for the JAVA_HOME value.
  9. Download and install the following prerequisite RPMs if they are not already installed.

    For the list of RPMs to install, see the IBM Technote, List of RPMs to install on the Sametime Video MCU.

    Attention: Each RPM's file name includes a version number in the format X.X.X.Y, where X is a mandatory level that cannot be changed, and Y is a minimum level. If your RPM has a higher level for the value in the Y position, you can use it.
  10. Run the following command to install the Sametime Video MCU:
    RHEL 5
    ./installvideomcu_RHEL5.sh
    Note: The command ./installvideomcu_RHEL5.sh installs the "gold version" of the product. If you are installing a hotfix or cumulative fix, the command is install.sh.
    RHEL 6
    ./installvideomcu_RHEL6.sh
    Note: The command ./installvideomcu_RHEL6.sh installs the "gold version" of the product. If you are installing a hotfix or cumulative fix, the command is install.sh.
    SLES 11
    sh install.sh
    Note: Be sure to specify the correct full path to the console.properties file in the installvideomcu_platform.sh script. If the correct full path is not specified, this error is generated:

    installvideomcu_platform.sh line 29 console.properties: file not found

  11. Enter the following command:

    stop tmpwatch

    The stop tmpwatch command prevents the tmpwatch cron job from running. The tmpwatch cron job deletes all files and folders in the \tmp directory that have not been accessed in more than 7 days. Video MCU stores important files in the \tmp directory.

Results

If your installation does not complete successfully, uninstall the Sametime Video MCU, delete the deployment plan. Create a new deployment plan, and then install the RPMs and the product again.

When the installation has successfully finished, start the Sametime Video MCU by running the following command:
service soft_mcu start
When the Video MCU is running, check its status by running the following command:
service soft_mcu status

The following table lists possible response codes and their meanings.

Table 1. Video MCU status codes and descriptions. The Video MCU status is returned as a code; the following table explains the meaning of each status code.
Status code Description
0 Sametime Video MCU is running
3 Sametime Video MCU is not running
4 Sametime Video MCU is unavailable
5 Sametime Video MCU has start-up issues
SoftMcu service is up Sametime Video MCU gold build is running
service: no such service soft_mcu Sametime Video MCU is not installed
soft_mcu: unrecognized service Sametime Video MCU is not installed