Installing Sametime Community on Linux

This topic guides you through the steps for installing the Sametime 11.6 Community Server for Linux.

Before you begin

Consider the following before starting the installation process:

About this task

To begin the installation process, download the product onto the computer the install is performed. For Linux, the installation file is Sametime_11.6_CommunityServer_Linux64.tar.

Procedure

  1. Extract the Sametime_11.6_CommunityServer_Linux64 archive file onto your disk.
     tar -xf Sametime_11.6_CommunityServer_Linux64.tar
  2. The following example provides steps on how to extract the Sametime Community installation package and make the installer file executable.

    Example:

    If you place the Sametime_11.6_CommunityServer_Linux64.tar file in $SOFTWARE_DIR (e.g. in the /local/software directory) then:
    1. Extract the Sametime Community installation package
      tar -xf Sametime_11.6_CommunityServer_Linux64.tar
    2. Change directory to the Sametime Community Server installation files
      cd $SOFTWARE_DIR/Sametime_11.6_CommunityServer_Linux64/Server
    3. Make the installer file executable
       chmod +x install.bin
  3. If you plan to use TLS for your LDAP connections, you must also install the GSKit, located in the GSKit subdirectory.
  4. If you installed Domino to alternate directories other than /opt/hcl/domino, or /local/notesdata you must create /opt/hcl/domino and /local/notesdata soft link(s).
    In order to install, there are 3 options

Console Install Procedure

Use this method if graphical installers are not supported by your Linux VM.

About this task

Procedure

  1. Before you install the HCL Sametime server program files on a Linux system, do the following:
    • Temporarily disable any screen savers and turn off any virus-detection software.
    • Complete any pending reboot actions.
    • Make sure that all other applications are closed.
  2. As the root user or sudo, execute the install program ./install available in the software package using the command:
    sudo ./install.bin
  3. At the locale prompt, choose your server locale.

    Graphic showing Locale prompt

  4. At the license agreement screen, review the terms and accept to proceed. 

    Graphic showing command prompt for license agreement

  5. At the License Information screen, select the type of license you are installing. For HCL Sametime, choose Limited. For HCL Sametime Premium choose “Standard.” Do not choose “Dynamic”.

    Grpahic showing command prompt for license type

    Note: If Limited is selected, the Managing Sametime Premium features must be disabled. See Managing Sametime Premium features for additional information.
  6. At the Pre-Installation Summary screen, review the selections and confirm they are correct. Press enter to continue.

    Graphic showing Pre-Installation Summary

  7. At the Installation Complete screen, press enter to exit the installer.

    Graphic showing command prompt to exit the installer

  8. After the installation is complete, start the server using the ./ststart script as the notes user. See the topic Starting and stopping the Community server for details.

Graphical Install

Login to the Desktop of your Linux environment and run install.bin which is located in the Server subdirectory.

About this task

If you do not have a desktop environment, use VNC to access the graphical install.

Procedure

  1. In a Linux SSH session, Run VNCServer (we used TigerVNC for this example).
  2. As root – export DISPLAY=:x – where x is the port you will connect to VNC (eg - :1 == port 5901).
  3. Connect to the VNCServer with VNCViewer.
  4. As root – execute ./install.bin - The installanywhere GUI should display in the VNCViewer window.

Silent Install

This topic guides you through the steps for silently installing the V11 Sametime Community Server for Linux.

About this task

As root:

Procedure

  1. Use VI to create a file named “installer.properties” in the same directory as the ‘install.bin’ executable, with the following contents
    # This file was built by the Replay feature of InstallAnywhere.
    # It contains variables that were set by Panels, Consoles or Custom Code.
    DataInstallDir=/local/notesdata
    UNIX_UserName=notes
    UNIX_GroupName=notes
    UNIX_ServerName= host name of the server you are installing on>
    #Directory Selection
    #-------------------
    DIRECTORY_TYPE_DOMINO=1
    DIRECTORY_TYPE_LDAP=0
    LDAP_SERVER=
    LDAP_PORT=
    ADVANCED_LDAP_CONFIG=0
    ST_BRANDING_INFO=(standard) or (entry)
    #Install
    #-------
    -fileOverwrite_/tmp/156305.tmp/stnotesinstallutilities_linux64=Yes
    -fileOverwrite_/tmp/156305.tmp/stnotesinstallutilities.jar=Yes
    -fileOverwrite_/tmp/156305.tmp/stnotesinstallutilities.dll=Yes
    -fileOverwrite_/tmp/156305.tmp/stinstallutilities.dll=Yes
    -fileOverwrite_/tmp/156305.tmp/vcredist_x64.exe=Yes
    -fileOverwrite_/tmp/156305.tmp/UnixSetNotesFieldValue.sh=Yes
    -fileOverwrite_/local/notesdata/_HCL Sametime Server 11.0.0_installation/Change HCL Sametime Server 11.0.0 Installation.lax=Yes to All
    Note:
    • DIRECTORY_TYPE should be set as applicable to your environment. If you set LDAP to 1, be sure to set DOMINO to 0 and add the appropriate LDAP_SERVER and LDAP_PORT information.
    • ST_BRANDING_INFO should be ‘entry’ or ‘standard’ as applicable to your environment.
    • All these entries are on a single line, so be sure that copy/paste does not break them.
    • If you copy/paste - be sure there are no spaces at the end of the line(s).
    LDAP_PORT=
  2. In the Server subdirectory, execute ‘./install.bin -i silent’
    Note:
    • If needing to specify the properties file location, use -f [filename_and_path].
    • If you are attempting to do the Graphical install using VNC and you see the console option start, this means that you were not successful in exporting the display – most common reason would be that you are not running as root.
  3. Installing HCL Sametime version 11 on SUSE Linux 15.

Installation Steps

This topic guides you through the steps for installing the HCL Sametime Community Server.

About this task

To install HCL Sametime Community Server:

Procedure

  1. On the computer where you will install the HCL Sametime Community Server, the InstallAnywhere install shield will guide you through the installation process. Click Next.
    Note: Screen shots are taken from Windows, but they be similar for Linux.

    Install program introduction screen

  2. The license agreement screen displays. Click Next.

    License agreement screen

  3. Select the Directory type you wish to use,
    • If using the local Domino directory, click Next.
    • If you select the LDAP Directory radio button.
      • In the LDAP Server Name text box, enter the hostname of your LDAP server.
      • In the Port Number for LDAP text box, enter the appropriate port for your LDAP server
    • Click Next.

    Directory selection screen

  4. Select the radio button option in the License Information screen to configure the license. Click Next.
    Note: You can choose either Standard or Limited depending on your license. Currently the Dynamic model option, where you can enter the flex net url is not supported for this release.

    License information screen

  5. The Pre-Installation Summary displays. Click Install.

    Pre-installation summary screen

  6. The installation begins.

    Progress status screen


    Progress indicator screen JRE installing


    Progess indicator 100 percent complete

  7. Verify that there are no installation errors.
    Note: You must restart the system to complete the installation. Select the radio button Yes, restart my system and then click Done.

    Install complete screen

  8. The installation is complete.

    Screen indicating wait for configuration

    Note: To start the server as the Notes user, use the ststart script located in the Domino Data directory.

    For more information, see To start the Sametime Community server.

Results

The DominoDomino_data_directory*/*stsetup_exit_status.txt file contains a zero (0) if the installation is successful. If the installation was not successful, review the installation logs for more information. Fix the problem and try installing again. The installation logs are stored in the following locations.

Domino data directory


HCL_Sametime_Premium_Install_MM_DD_YYYY_HH_MM_SS.log
stsetup.log
stsetup_exit_status.txt

SametimeIniParser.log

This log can be in /tmp or in the Domino data directory.

Console connection log

/tmp/SSCLogs/ConsoleUtility0.log

Domino data directory


 HCL_Sametime_Premium_Install_MM_DD_YYYY_HH_MM_SS.log
 stsetup.log
 stsetup_exit_status.txt

Domino program directory

stsetup_exit_code_windows.txt

SametimeIniParser.log

This log can be in %TEMP%or in the Domino data directory.

Console connection log

Documents and Settings\username\Local Settings\Temp\SSCLogs\ConsoleUtility0.log

What to do next

Configuring Sametime Community Chat Logging with MongoDB