Installing on Linux

On the Micro Focus download site, choose the installer that identifies the operating system and version of Host Integrator that you want to install. Install programs are designated with either –prod for the production version or –eval for the evaluation version. Each installer performs the following steps, which cannot be executed individually:

1. Installs the chosen products.
2. Continues with the setup of the installed products.
3. Configures the servers.

Interactive installation

In this example the Linux installer is used to install the production version (-prod) of Host Integrator.

To install Host Integrator components on Linux systems:

1. Log in as root. You can create a new non-root user and group specifically for running Host Integrator, such as vhiuser and vhigroup. To specify the user and group, use the --owner option. See Additional Installation and Configuration Options.

2. Type the following command on the Linux prompt: sudo sh ./vhisrv-7.x.x-prod-<linux> [--owner vhiuser:vhigroup]

3. Use either the y or n command to respond to the license agreement. If you select n, the installation stops.

After selecting Yes, you can navigate the License Agreement using the following commands:

• ENTER - Read the agreement line by line
• SPACE - Read the agreement page by page
• q - Quit reading and return to the menu.

• n - Stop the installation.

• Choose to initiate a Typical (t) or Custom (c) install process.

• Typical - A standalone installation which includes all default components and configurations.

  • The session server and the management server are installed and the session server is automatically registered with the local management server.
  • Supply and verify an administrative password. This password is required for later configurations.
  • The installation continues with the default installation of all VHI components.
  • Installation proceeds with no option to “go back”.

• Custom - In a custom installation you manually select components, join existing servers, and configure other required options from the configuration options menu. Continue customizing your installation, choosing the components you want to install.

• To continue you must specify the following menu category options:

• Components - To select or clear a component enter the corresponding number and press: ENTER. By default all components are selected.

• Options - Installation location and owner. The default location is /opt/microfocus/verastream. To specify the owner:

  • Choose the owner (and optional group) for all files and directories under the base location where the product is being installed.
  • To specify a non-root user and group ownership use one of the following methods: menu option "o" in interactive custom installation, --owner option on the installer command line, or owner= line in the install-input file for an unattended automated installation.
  • Specify user or user:group

  After installation by root is complete, you can directly log in as the specified user to manage the product.

  • Actions - Specify whether to continue, quit or display help.

Depending on what components you selected, there may be further configuration needed:

If the Host Integration Server is selected without a management server, you need to specify the following options to join an existing installation:

Verastream Host Integrator Version 7.x 
Installation
Configurations:
1) Management Server address: 
2) Management Server username: 
3) Management Server password:
Actions:
i)   Install
q)   Quit
h)   Help
Make a selection:

• Server address - Enter 1 - The address is checked for format (Ex: 192.168.1.1:3000), address and port number) and existence of the server.

• Server username - Enter 2 - Either the built-in “admin” user, or another user that has been given administrator rights in the management server.

• Server password - Enter 3 - (The password is neither echoed nor shown)

When prompted to join an existing cluster, if you select yes, specify the configuration options in the screen below. See the previous table for a description of the commands.

Verastream Host Integrator Version 7.x 
Installation
Configurations:
1) Join an existing cluster: Yes
2) Management Cluster address: 
3) Management Cluster username: 
4) Management Cluster password: 
Actions:
i)   Install
q)   Quit
h)   Help
Make a selection:
Run the i) install command to complete the installation.

Installing additional components

If you did not install all the components initially, you can re-start the installer and add components to an existing installation

Additional installation and configuration options

In addition to the traditional installation method you may elect to install from the Linux command prompt where you have full control over the installation using the following commands:

1. For a list of commands, type: sh vhisrv-7.x.x-prod-linux --help
2. Use these commands to perform the following:

In addition to the above commands the following commands are configurable. You can use these options to specify or override the default values as explained in the previous Interactive Installation section.

Examples using commands

sh vhisrv-7.x.x-prod-linux --owner vhi:vhigroup --basepath /opt/vhi

The above command specifies the owner and group used to start all server processes and manually specifies the installation path.

sh vhisrv-7.x.x-prod-linux --join_cluster true --cluster_address cluster_server.com:33000 --cluster_user admin --cluster_password secretpassword

This is used to join an existing cluster by specifying the required credentials and cluster configurations.

Automatically start services

To configure the session server to run as a system daemon and have the services start automatically as system services, you need to add a script to your system init.d or rc.tcpip configuration.

These instructions will start all services, including the management server if it is installed.

Create a file called vhi containing the following and enter in your installation directory.

To start a particular service, replace the parameters with one of the following:

• server —VHI session server
• mgmtserver —VHI management server
• logmgmr —VHI log manager
• hostemul —VHI host emulator

### BEGIN INIT INFO
# Provides: VHI
# Required-Start: $network
# Should-Start: $network
# Required-Stop: $network
# Should-Stop: $network
# Default-Start: 3 5
# Default-Stop: 0 1 2 4 6
# Description: Micro Focus Verastream Host Integrator Services
### END INIT INFO
INSTALL_DIR=<enter installation directory>
BIN_DIR=$INSTALL_DIR/hostintegrator/bin
case "$1" in
start)
echo "Starting Verastream"
$BIN_DIR/atstart -start all
RETVAL=0
;;
stop)
echo "Stopping Verastream"
$BIN_DIR/atstart -stop all
RETVAL=0
;;
status) echo "Current Verastream status"
$BIN_DIR/atstart -status
RETVAL=0
;;
restart) echo "Restart Verastream"
echo "-- stopping all components --"
$BIN_DIR/atstart -stop all
echo "-- starting all components --"
$BIN_DIR/atstart -start all
RETVAL=0
;;
*)
echo "Usage: $0 {start|stop|status|restart}"
RETVAL=1
;;
esac
exit $RETVAL

Linux and zLinux

1. Copy the file to the /etc/init.d directory
2. Set the file permission. Run chmod using the value 755. For example, chmod 755 vhi
3. Run chkconfig to add the initialization script. For example, chkconfig --add vhi

To run the services as a non-root user, create a new script that will run the provided sample script.

Testing changes

You should test manually stopping and starting services while logged in as the non-root user and verify that services are automatically started after you restart the system.

• For more information on manually starting and stopping Host Integrator services, see the online help topic, Starting and Stopping Services.

• To verify services are successfully running, see Technical Note 7021540.

• If services do not start successfully, check the operating system log as described in Technical Note 7021303, Operating System Logs section.

Local authentication requires root privileges

One of the Host Integrator processes may need to run as root, depending on your Host Integrator version and security configuration:

• If you enable local OS groups in Administrative Console (Management > Directories > Properties), then the management server service, along with the other services, must run as root. However, this configuration is typically not necessary as VHI provides the following alternative for authentication security:

  • Secured administrative access using built-in “admin” user name and administrative password (set during installation or in Administrative Console).
  • Improved support for LDAP directory services, such as Microsoft Active Directory. You can add users and groups from your directory server to the Administrator, Developer, and User authorization profiles.

• See Technical Note 7021354 for more information on this topic.

Creating an unattended install file

You may install VHI silently, by specifying all necessary installation and configuration options in a separate file. Assuming this file is called install-input, it is enough to type this command on the command line:

sh vhisrv-7.x.x-prod-linux --input install-input --licenseagreed

Example

File install-input (below) contains all previously described options and is a sample delivered with the installation. In this file all components are selected and all configuration options are commented out.

#Component selection
sessionserver=true
managementserver=true
hostemulator=true
connectors=true
#Specify the action to perform when there is already a VHI installed
#upgrade=false
#add=false
# Installation location
# basepath=/opt/attachmate/verastream
# Owner of installation and startup id servers
# owner=vhiuser:vhigroup
# Management Server values to register Session Server with another Management Server
# vms_address=mgmt_server.attachmate.com:33000
# Does the Management Server join a Management Cluster?
# join_cluster=true
# Management Cluster configuration
# cluster_address=cluster_server.attachmate.com:33000
# Perform an entropy check for the session server?
# entropy_check=true
# General username and password; for new or existing Management # # Server or Management Cluster
# server_username=admin
# server_password=secretpassword

Notes

• If sessionserver, managementserver,hostemulator or connectors are set to true, the component is installed. If you set the value to false, add # in front of the option or leave the component out; the component will not be installed.
• If a line begins with ‘#’, the option is ignored. In the example above all configuration options are commented out in this way.
• If you use the example file above (if the comments are removed), the session server, web server, management server, Host Emulator, and connectors are installed. The management server is registered with cluster server cluster_server.attachmate.com and the session server is registered in the cluster through replication.
• You only need to use the vms_address option when no management server is installed (managementserver=false). When that is the case the vms_address option specifies where to register the session server. Otherwise, this option is ignored. When the Host Emulator is installed along with the session server, it is registered to the same management server.
• No interaction is necessary and no output is given unless an error occurs.

Entropy

WARNING! Available entropy is critically low.

Low entropy will decrease performance and cause the installation to fail.

To override, use the --no_entropy_check flag

• When you install the session server, the installer checks the level of entropy available.
• Low entropy causes performance issues and can lead to the install program failing to register the session server. If there is less than 1000 bytes of entropy available, the install program will exit.
• To override this behavior, you can use the --no_entropy_check flag or set the entropy_check variable to true in the unattended install file.
• See Technical Note 7025092 for more information on viewing and increasing entropy.

Uninstalling Host Integrator

To run the uninstall process follow the steps below:

1. From the base installation directory, type: sh vhi_uninstall.sh --sessionserver --managementserver

2. Confirm the removal:

   • Choose yes to stop all servers and remove all files and directories including the base installation directory. When yes is chosen, all servers are stopped and all known files and directories in the base installation directory are removed. When the base directory is empty, the directory itself is also removed.

You can remove either the session server or the management server. See step 1 above and enter just -–sessionserver or --managementserver. This option only removes files and directories not being used by the remaining component.

Type sh vhi_uninstall.sh --help to display the help screen if needed.

Micro Focus Verastream Host Integrator and/or Management Server uninstall
Remove all files from a prior installation,
including all configuration data that may be present.
Usage: ./vhi_uninstall.sh [options]
Options:
  --basepath path       : Base installation path
  --managementserver    : Remove Management Server
  --sessionserver       : Remove Host Integration Server
  --hostemulator        : Remove Host Emulator
  --connectors          : Remove Connectors
  --all                 : Remove all installed VHI components
  --verbose             : Detailed output 
  --yes                 : Answer yes to all questions
  --help                : Display this message.