Installing the Sametime Media Manager's Video MCU

Install prerequisite Red Hat Package Manager (RPM) files and then install IBM® Sametime Media Manager's Video MCU. Remember that the Sametime Media Manager's 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 the following 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 the following 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.

Restriction: Do not change the installation path for the Video MCU. By default, the Video MCU is installed in the /opt directory; this location is required for proper operation of the server.

Procedure

  1. On the computer where you will install the Sametime Video MCU, and log on as root.
    Restriction: Using sudo with users other than root will result in functional failure even though the installation completes successfully.
  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=Sametime901Lab01.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_Sametime901Lab04

    Fully qualified domain name (no IP addresses): localHostName=Sametime901Lab04.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 HCL article, https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0029625List 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: sh install.sh

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 descriptionsThe 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