Appearance
Installing the Server on Linux
This section describes how to install the Situate server. The server is composed of three package: agent, java and server. Each need to be installed in order.
Before You Begin
Here are some time-saving steps to do before you start.
- Linux Server Requirements. Make sure your server meets the minimum requirements outlined in Server Requirements.
- Get a License. Contact situate support at situate.support@xonasoftware.com and request a license for a new install. Support will send a license ending in .dat. This file will be used in the last steps.
- Decide on a Domain Name. A Situate domain name identifies each Situate instance. It's not the same as a DNS domain or AD domain. Usually, the domain represents your business unit or company and may contain an environment distinction such as "prd" or "dev". Examples are: acmeprd, acmedev.
- Create the sit- Alias. By convention, the UI and other tools will look for the Situate server using a DNS alias sit-yourdomain, (where yourdomain is replaced by your actual domain name). It will be easier for your users to use this alias so setting it up now and pointing it to your Situate server is a good idea.
- Decide on an Admin User. During the install, situate will ask for the login of an admin user. This user will be the only user allowed to perform further setup and configuration of your server. That user must be able to login to your Situate server with a login and password.
- Install SSSD or Winbind (optional). If it is your intention to leverage Active Directory as an authentication mechanism, install and configure sssd or winbind and related tools and add your server to the AD prior to installing situate. Situate will "discover" the security setting of the server when it is installed. Failing to install sssd or winbind prior to installtion will create a lot of work later.
Downloading the Installation Packages
Download the agent, java and server packages. The download page has instructions that describe how to find the correct version. The example below assumes version 2.0.0.0
situate-2.0.0.0-agent-linux-2.6-x86_64-64.shar situate-2.0.0.0-java-linux-2.6-x86_64-64.shar situate-2.0.0.0-server-linux-2.6-x86_64-64.shar
Make each script executable, if it is not already.
bash
> chmod +x situate-2.0.0.0*.sharInstalling the Agent
Execute the agent package.
> ./situate-2.0.0.0-agent-linux-2.6-x86_64-64.shar
Welcome to the Situate Installer
This script installs a basic Situate agent. If you want to install a
situate server, first install this package. Then install the java
support package and the server package.
Continue? [yes|no] yes
Install into: /opt/situate
Install in this location? [yes|no] yes
Installing files...
Completing installation
Failed to execute operation: Too many levels of symbolic links
Starting Situate...default instance
Installation completeWhen the script completes, the agent will be installend and running.
Installing Java Support
The server modules are Java-based. So, support for Java needs to be installed.
> chmod +x ./java-linux-2.6-x86_64-shar
> ./situate-2.0.0.0-java-linux-2.6-x86_64-64.shar
Welcome to the Situate Installer
This script will install Java Support.
Continue? [yes|no] yes
Stopping Situate service...default instance
Installing files...
Completing installation
Starting Situate...default instance
Installation completeThe script shuts down situate, installs the java components and restarts the agent.
Installing the Server Package
The server package installs and configures the server modules. This effectively promotes the agent to a server. The following questions are asked along the way.
Primary or Standby
Always enter "P" for Primary
Domain
The Situate domain name identifies the Situate instance. A Situate domain is not the same as a DNS domain or AD domain. Enter a name that represents your company or business unit and function like acmeprd or acmedev.
Hostname
The UI and other tools will need to be able to connect to the server. The hostname provided should be the hostname everyone in your company can use to connect.
Authenttication Service Name
The name of the authentication service situate will create to authenticate users for this server. Use the default value provided unless you are a power user and wish to use something else.
Admin User
Situate needs to setup a first user who can admin situate. This user will be the only user who can login and setup security for everyone else. The admin user must be a user who can login to the server.
Installing a License
You should contact situate.support@xonasoftware.com before you install to obtain an installation license. This license should be copied into /opt/situate at the correct part of the installation. If you are a pay-as-you-go customer, the license we provide may be a stripped down version to allow you to complete your install. After situate starts and contacts our license server, a proper license will be installed.
A transcript of a successful installation follows:
> chmod +x ./server-linux-2.6-x86_64-shar
> ./situate-2.0.1.0-server-linux-2.6-x86_64-64.shar Welcome to the Situate Installer
This script will install Java Support.
Continue? [yes|no] yes
Stopping Situate service...default instance
Installing files...
Completing installation
Starting Situate...default instance
Installation complete[root@testsitsrv7 situate-2.0.1.0]# ./situate-2.0.1.0-server-linux-2.6-x86_64-64.shar
Welcome to the Situate Installer
This script will install Situate Server.
Continue? [yes|no] yes
Stopping Situate service...default instance
Install a PRIMARY or STANDBY instance of the server?
Enter (p) for PRIMARY, (s) for STANDBY: p
Install a PRIMARY or STANDBY instance of the server?
Current configuration is: PRIMARY
Continue with PRIMARY configuration? [yes|no] yes
Situate uses the concept of a domain or instance name to represent
each instance of situate. A domain must contain no spaces or underscores
Enter the Situate domain: acme
Situate uses the concept of a domain or instance name to represent
each instance of situate. A domain must contain no spaces or underscores
Domain is: acme
Setup this Situate domain? [yes|no] yes
Situate needs to know the fully-qualified hostname or IP address of this computer
This hostname will be used by the UI and other utilities to connect to the server
Hostname is: testsitsrv7
Use this hostname? [yes|no] yes
A Situate server must have an authentication service name defined.
This will become the default authentication service for any agent
connecting to this Situate domain. Other authentication services
can be setup through the administration console after the
installation process is complete
Enter the authentication service name [AD-test.xonasoftware.com]:
An admin user name must be specified. This user will added to the situate
admin's group upon installation. Once started, this user will need to
login to situate and setup the security model.
Additional admin users can be added later.
Enter admin user: xonaadmin
An admin user name must be specified. This user will added to the situate
admin's group upon installation. Once started, this user will need to
login to situate and setup the security model.
Additional admin users can be added later.
Admin user is: xonaadmin
Establish this user as the admin user? [yes|no] yes
Installing files...
Completing installation
You will need a license to run situate. If you do not have one, copy the info
below and send it to XonaSoftware along with you license request.
If you have a license file (license.dat), copy it to the install directory
for example, ...
> cp license.dat /opt/situate
Information for license:
license-version: 2.0
hostname: testsitsrv7
mac: 00:0c:29:70:18:b0
Please install a license and press the key to continue...
Starting Situate...default instance
Installation complete
Congratulations, your server is installed, up and running.You can now use the Situate GUI to login and begin setting up your instance. You should login as the admin user used in the steps above. Once logged in, you can configure situate.