Installing the Bandwidth Manager on the deployment manager

Install the IBM® Sametime® Bandwidth Manager application on the deployment manager.

About this task

This procedure installs the Sametime Bandwidth Manager on the other cluster members, as well as on the deployment manager.

Procedure

  1. On the computer where you will install the Bandwidth Manager, log on as root (Linux™) or as the system administrator (Windows™).
  2. Find the software packages you need to download.
  3. Download the packages.
  4. Extract all downloaded packages.
  5. Install the WebSphere Network Deployment.
  6. On the deployment manager, use a command line terminal or prompt, navigate to the folder where you extracted the installation files.
  7. Run the following command to install the Bandwidth Manager:
    • Linux
      WAS_install_root/profiles/Profile_name/bin/ws_ant.sh -Dinstall.db=true >install.log
      where:
      • Profile_name is the WebSphere Application Server profile name of the deployment manager.
      • WAS_install_root is the root directory where WebSphere Application Server is installed. In Linux it is typically /opt/IBM/WebSphere/AppServer.
      • install.log sends all information from the server to a log file.
      For example:
      /opt/IBM/WebSphere/AppServer/profiles/AppServerProfile/bin/ws_ant.sh -Dinstall.db=true
    • Microsoft® Windows
      WAS_install_root\profiles\Profile_name\bin\ws_ant.bat -Dinstall.db=true >install.log
      where:
      • Profile_name is the WebSphere Application Server profile name where the Bandwidth Manager application will be installed, typically "AppServerProfile".
      • WAS_install_root is the root directory where WebSphere Application Server is installed. In MicrosoftWindows this is typically C:\Program Files\WebSphere\AppServer and in Linux it is typically /opt/IBM/WebSphere/AppServer.
        Attention: In Windows, you must use the DOS-shortened versions of the directory names; for example: C:/PROGRA~1/IBM/WebSphere/AppServer.
      • install.log sends all information from the server to a log file.
      For example:
      C:\PROGRA~1\IBM\WebSphere\AppServer\profiles\AppServerProfile\bin\ws_ant.bat -Dinstall.db=true >install.log
    When -Dinstall.db is set to true, the install script drops any existing Bandwidth Manager tables and then creates clean tables in the database. If -Dinstall.db is set to false or is omitted, the install script does not drop or create Bandwidth Manager tables in the database, and any existing data is retained.
    Note: Do not copy and paste the paths and parameters, because control characters may inadvertently be included in the command. For best results, type the command manually.

Results

The installation process may take up to 10 minutes. When the installation process is complete, the message BUILD SUCCESSFUL is displayed. You may see failures indicated, for example, an indication that a number of SQL commands could not be executed. This is expected behavior, because the installation program script attempts to "drop" (delete) any existing tables in the database without first checking whether the tables actually exist. The output from the command is in the install.log file specified on the command line.