= 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. \\
{{tag>solaris}}
= 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
.................................................................................
........
*************************************************
* *
* install - Exceed Connection Server 13.8 *
* *
*************************************************
Licensing
=========
Please codess to view License Agreement:
OPEN TEXT CORPORATION SOFTWARE LICENSE AGREEMENT
........
Please codess [y] to accept, [n] to decline or 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 ( 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 ( 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 ( for no): y
Exceed Connection Server Activation
===================================
Please codess 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 ( 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 =
# Connect to the server from the server manager console, login
# On the NODE tree, expand it and select the Server Node (the Unix server you are connected to)
# On the NODE menu choose Node Settings
# Click on the Libraries button
# You must specify the path to the LDAP libraries on the Unix box (/usr/lib)
# Click okay, the Click okay.
# Click on the Cluster menu and choose, RESTART CLUSTER
# You will be prompted to connect / login again
# From the Cluster Menu, choose Settings
# In the Authentication Section, choose LDAP and then click Settings.
## User DN: cn="Directory Manager"
## Password can be found in KeePass
## Base DN: ou=people,dc=prd,dc=domain
## User Base DN: KEEP EMPTY or authentication will FAIL (bug?!? - in debug mode LDAP errors 34 and 48 will appear)
# Click the Test button, once successfully configured
# Click on the SELECT button to select an LDAP based EOD Connection Server Administrator (ldapexceed)
# Disconnect from the Server from Server Manager
# 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.