Table of Contents

Install Exceed Connection Server on Solaris

Summary: Installation report for Exceed Connection Server software on Solaris.
Date: Around 2019
Refactor: 4 January 2025: Checked links and formatting.

Installation Requirements

The software is easy to install but a bit tricky to configure. Initially it needs a local account which can logon to the solaris box remotely. After a connection is made between the Exceed Connection Server and the Exceed Server Manager (already installed on terminalsrv01) the setup can be changed to authenticate through LDAP.

A local user is created called “exceed”, password is listed in the KeePass database. When the installation is ready the account is blocked from logging in: 

sjoerd@solarisbox02:sudo useradd -d /opt/eod -m -c "Exceed Authentication User" exceed
sjoerd@solarisbox02:/opt$ sudo passwd exceed
New Password:
Re-enter new Password:
passwd: password successfully changed for exceed

Blocking (l) and unblocking (u) the account works like this: 

sjoerd@solarisbox02:~$ sudo passwd -l exceed
passwd: password information changed for exceed
sjoerd@solarisbox02:~$ sudo passwd -u exceed
passwd: password information changed for exceed

An LDAP administrative account is created called ldapexceed, password is listed in the KeePass database. This account is always blocked from logging through LDAP in the sshd_config file: 

# Disallow application-user to use ssh
DenyUsers locuser* exceed ldapexceed
Note: restart ssh afterwards: svcadm restart ssh

Install Software

After downloading run the installation binary and follow the wizard: 

root@solarisbox02:/opt/eod# ./ecs-13.8.1-solaris-x64.bin
Exceed Connection Server 13.8 Self-Extracting Installer

Enter directory to install Exceed Connection Server to
[/opt/eod/Exceed_Connection_Server_13.8_64]: /opt/eod
Installing to "/opt/eod"

Expanding /opt/eod/ecs-13.8.0-solaris-x64.tar
.................................................................................

....<extracting files... cut>....

               *************************************************
               *                                               *
               *    install - Exceed Connection Server 13.8    *
               *                                               *
               *************************************************


Licensing

=========

    Please codess <Enter> to view License Agreement:
OPEN TEXT CORPORATION SOFTWARE LICENSE AGREEMENT

....<license agreement... cut>....

    Please codess [y] to accept, [n] to decline or <Enter> to read again: y

Populating Templates Files

==========================

     Copying files for 'Group' ...
     Copying files for 'User' ...


Exceed Connection Server Migration

==================================

    Would you like to migrate an existing Server installation?
    [y]es or [n]o (<Enter> for no): n


Exceed Connection Server Settings

=================================

    Please enter Server Port         [5500]:
    Please enter Starting Display ID    [1]:

    Selected Settings:
    Server Port:          5500
    Starting Display ID:  1

    Would you like to proceed with these settings?
    [y]es, [r]edo or [q]uit (<Enter> for redo): y


Exceed Connection Server Startup

================================

    /etc/init.d/otecs_13.8_1 init script has been created.

    Would you like to have Server started at system boot time?
    [y]es or [n]o (<Enter> for no): y


Exceed Connection Server Activation

===================================

    Please codess <Enter> to launch keymanager utility:
keymanager - Exceed Connection Server 13.8

Total Licenses: 0

        1. Add Activation Key
        2. Remove Expired Evaluation Keys
        3. List Installed Activation Keys
        4. Save Changes And Quit
        5. Quit Without Saving

Please choose one of the above options [5]: 3

Key                                          Licenses       Days Left

===                                          ========       =========

Total Licenses: 0
codess [ENTER] to continue...
keymanager - Exceed Connection Server 13.8

Total Licenses: 0

        1. Add Activation Key
        2. Remove Expired Evaluation Keys
        3. List Installed Activation Keys
        4. Save Changes And Quit
        5. Quit Without Saving

Please choose one of the above options [5]: 1
Type in Activation Key to add: XXXXXXXXXXXXXXXXXXXXXX
Activation Key  "XXXXXXXXXXXXXXXXXXXXXX"
        successfully installed
codess [ENTER] to continue...
keymanager - Exceed Connection Server 13.8

Total Licenses: 100 Type: Server-based

        1. Add Activation Key
        2. Remove Expired Evaluation Keys
        3. List Installed Activation Keys
        4. Save Changes And Quit
        5. Quit Without Saving

Please choose one of the above options [5]: 3

Key                                          Licenses       Days Left

===                                          ========       =========

XXXXXXXXXXXXXXXXXXXXXX                       100            30

Total Licenses: 100 Type: Server-based
codess [ENTER] to continue...
keymanager - Exceed Connection Server 13.8

Total Licenses: 100 Type: Server-based

        1. Add Activation Key
        2. Remove Expired Evaluation Keys
        3. List Installed Activation Keys
        4. Save Changes And Quit
        5. Quit Without Saving

Please choose one of the above options [5]: 4


Exceed Connection Server Administrator

======================================

    Please enter Server Administrator Account name [root]: exceed

    Setting file permissions .............


Installation Status

===================

    Exceed Connection Server 13.8 installed successfully.

    Check log file for information and warnings:
    /opt/eod/log/install.log

    Before you can use OpenGL server-side rendering features
    you must first configure graphics device permissions by running:
    /opt/eod/bin/ssrconfig


Launching Exceed Connection Server

==================================

    Would you like to start Server now?
    [y]es or [n]o (<Enter> for no): y


Starting Exceed Connection Server 13.8
Exceed Connection Server started.

Now the installation is done. You can check the following items to verify the installation:

Installation log: 

root@solarisbox02:/opt/eod# cat /opt/eod/log/install.log

Exceed Connection Server 13.8 Installation Log
##############################################


INFORMATION: install
  Started on Mon Jul 23 14:41:06 CEST 2012 by

INFORMATION: install
  License accepted

INFORMATION: install
  Calling Exceed Connection Server 13.8 install script

INFORMATION: ecsinstall
  EoDSSHCommand=/bin/ssh

INFORMATION: ecsinstall
  ECSSSLLibPath=/opt/eod/bin/sys/libssl.so.0.9.8
  ECSCryptoLibPath=/opt/eod/bin/sys/libcrypto.so.0.9.8

INFORMATION: ecsinstall
  Creating file "node.cfg"
  EoDServerLog=html
  EoDHomeDir=/opt/eod/
  EoDSSLAvailable=1

  EoDDataStoreDir=
  EoDDataStorePassword=eC+rXj+2TrTlInER4yQXMA==

INFORMATION: install
  Calling migration script

INFORMATION: migration
  No migration

INFORMATION: ecsinstall2
  EoDCMPort=5500
  EoDFirstDisplay=1

INFORMATION: install
  Calling server startup script

INFORMATION: boottime
  /etc/init.d/otecs_13.8_1 init script has been created.

INFORMATION: admin
  Added Administrator:  exceed

INFORMATION: install
  Exceed Connection Server 13.8 installed successfully
  Installation finished on Mon Jul 23 14:41:06 CEST 2012

Start script: 

sjoerd@solarisbox02:~$ ls -l /etc/init.d/otecs*
-rwxr-xr-x   1 root     root       14511 Jul 19 14:28 /etc/init.d/otecs_13.8
Note that more installations will create new startscripts like /etc/init.d/otecs_13.8_0.

Running software: 

root@solarisbox02:/tmp# ps -ef | grep eod
    root  4677  2801   0 14:40:24 pts/10      0:00 grep eod
    root  4653     1   0 14:39:39 ?           0:00 /opt/eod/bin/sys/esessionmgr /opt/eod

Now you can login on the Exceed Server Manager (on terminalsrv01) with the local exceed user.

LDAP Configuration

  1. Connect to the server from the server manager console, login
  2. On the NODE tree, expand it and select the Server Node (the Unix server you are connected to)
  3. On the NODE menu choose Node Settings
  4. Click on the Libraries button
  5. You must specify the path to the LDAP libraries on the Unix box (/usr/lib)
  6. Click okay, the Click okay.
  7. Click on the Cluster menu and choose, RESTART CLUSTER
  8. You will be prompted to connect / login again
  9. From the Cluster Menu, choose Settings
  10. In the Authentication Section, choose LDAP and then click Settings.
    1. User DN: cn=“Directory Manager”
    2. Password can be found in KeePass
    3. Base DN: ou=people,dc=prd,dc=domain
    4. User Base DN: KEEP EMPTY or authentication will FAIL (bug?!? - in debug mode LDAP errors 34 and 48 will appear)
  11. Click the Test button, once successfully configured
  12. Click on the SELECT button to select an LDAP based EOD Connection Server Administrator (ldapexceed)
  13. Disconnect from the Server from Server Manager
  14. Reconnect and login as LDAP user from then on, other LDAP user will also be able to connect.

If something goes wrong or fails with the LDAP configuration you can revert back to the local user login by editing the cluster.cfg file: 

sjoerd@solarisbox02:/opt/eod/conf/admin$ sudo vi cluster.cfg

[CLUSTER]

EoDCMPassword=hbmppkVHQh0UmB9+wVoC/w==

EoDCMSSL=0
EoDCMLog=html
EoDCMDefXconfig=Passive.cfg
EoDCMAuth=ldap
EoDCMAuthPAMPwdPrompt=Password:

EoDCMcodeferredPCM=

EoDLoadBalancing=cpu
EoDCMLogLevel=1
EoDCMLogRollSize=0
EoDCMLogRollTime=0
EodShowShareConfirmDialog=0
ECSUseKerberos=0
ECSUseUserCredentials=1
ECSldapHost=solarisbox02
ECSldapSSL=0
ECSldapProxyUserName=cn="Directory manager"
ECSldapProxyPassWord=FBC88518580FBF1E7EB7ED96A82EA117.
ECSldapBase=ou=people,dc=prd,dc=domain

ECSldapUserLogincodefix=

ECSldapAuthOnly=0
UseLicenseServer=0

LicenseServerHost=

LicenseServerAuthKey=
SuspendTimeout=0
ECSEnableFIPS=0
ClusterName=solarisbox02.prd.domain

Change the EoDCMAuth setting to “native”.

Additional Information

Start EOD in debug Mode

In order to run the EOD server in Debug Mode we need to do the following
1.	EDIT the NODE.CFG file /conf/admin added the following section
[UNDOC]
undocdebugmask=0xffffff
2.	Save the file
3.	Stop the EOD Server with
/bin/otecs stop
4.	Restart the EOD Server with
/bin/otecs start -v
EOD server will start in Verbose debug mode, it will start to scroll up the display with log file output. When you attempt to login from the EOD Server Manager we should be able to see some information in there.