Installing Sametime Community on Linux

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

Before you begin

Note:
  • All commands provided require running as ROOT or SUDO access. If not running as root user, preface all commands with ‘sudo'.
  • Ensure that you have installed the Linux OS in the ‘en_US’ locale.

About this task

Prerequisite steps

Procedure

  1. Extract the Sametime_11.5_CommunityServer_Linux64 archive to your disk.
  2. Change directories where the installer was extracted to the server subdirectory. Change permissions on the install.bin to allow the root user to execute 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.


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


  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”.


  6. At the Pre-Installation summary screen review the selections and confirm they are correct. Press enter to continue.


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


  8. Now that 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 then execute the ‘install.bin’ located in the Server subdirectory.

About this task

If you do not have a desktop environment, it is possible to use VNC to access the graphical install – steps would be

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].
  3. HCL Sametime v11 do not support the console-based install in this release.
    Note: 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.
  4. Installing HCL Sametime version 11 on SUSE Linux 15.
    https://hclpnpsupport.hcltech.com/kb_view.do?sysparm_article=KB0076004

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.


  2. The license agreement screen displays. Click Next.


  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.


  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.


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


  6. The installation begins.






  7. Confirm the installation is performed without error.
    Note: You must restart the system to complete the installation. Select the radio button Yes, restart my system and then click Done.


  8. The installation is complete.


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

Results

The Domino_data_directory\stsetup_exit_status.txt file contains a zero (0) if the installation is successful. If the installation was not successful, look at the installation logs for more information. Fix the problem, then try installing again. The installation logs are stored in the following locations.

Domino data directory


SametimeInstall.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

Windows

The default Domino data directory is c:\program files\hcl\lotus\domino\data\and the Domino program directory isc:\program files\hcl\lotus\domino.

Domino data directory 


 SametimeInstall.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