This section describes the configuration required for a remote installation of HVR (also known as HVR remote agent) on Unix/Linux. These configuration steps are required either when:
- connecting from an HVR Hub to an HVR remote agent on the Source (capture) or Target (integrate) server,
- connecting from a PC (using HVR GUI) to an HVR Hub installed on a Unix/Linux server.
For connecting to a HVR remote agent installed on a Unix/Linux server, configure the system process (daemon) available on the remote Unix/Linux server. Also, an HVR listener port must be configured on the server running the HVR remote agent. Pick an arbitrary TCP/IP port number between 1024 and 65535 which is not already in use. We suggest using 4343 as the HVR listener port number and the following examples throughout this section will reference this port number.
Using Unix/Linux Daemon
Depending on the daemon type available, one of the following configuration methods can be used to invoke HVR installed on a remote server:
If the above mentioned daemons are not available then use the alternate configuration method described in section Configuring Init below.
The values used for HVR_HOME, HVR_CONFIG and HVR_TMP are for the current machine.
The following steps should be performed as user root to configure systemd:
- Create the systemd unit files hvr.socket and [email protected] in /etc/systemd/system directory.
hvr.socket should contain the following:
- TriggerLimitIntervalSec is supported since systemd version 230.
- TriggerLimitBurst is supported since systemd version 230.
- MaxConnectionsPerSource is supported since systemd version 232.
When using IPv4 in a IPv4/IPv6 mixed system or if IPv4 based restrictions are defined in the access_conf.xml file (see Hvrremotelistener), set ListenStream=0.0.0.0:4343 to force systemd to use IPv4.
[email protected] should contain the following:
Option –r tells hvr to run as a remote child process. For more options (like encryption, PAM) that can be supplied as the server program arguments (ExecStart), see command Hvr.
To enable and start the service, execute the following commands:
To verify whether the service is active, execute the following command:
The following steps should be performed to configure xinetd:
Create /etc/xinetd.d/hvr file with the following content in it:
Option –r tells hvr to run as a remote child process. For more options (like encryption, PAM) that can be supplied as the server program arguments (server_args), see command Hvr.
The name of the xinetd service for HVR (created in the previous step) and the TCP/IP port number for HVR listener should be added to /etc/services:
- Reload or restart the xinetd service to apply the changes. For information about restarting the xinetd service, refer to the operating system documentation.
The following steps should be performed to configure inetd:
For generic Unix, the following line should be added to /etc/inetd.conf:
Option –r tells hvr to run as a remote child process and -E defines the environment variables. For more options (like encryption, PAM) that can be supplied as the server program arguments, see command Hvr.
For Solaris version 10 and higher, the file /etc/inetd.conf must be imported into System Management Facility (SMF) using the command inetconv.
The name of the inetd service for HVR (created in the previous step) and the TCP/IP port number for HVR listener should be added to /etc/services:
Reload or restart the inetd service to apply the changes. For information about restarting the inetd service, refer to the operating system documentation.
This method requires HVR's script file hvr_boot (available in hvr_home/lib) and a user-defined configuration file hvrtab.
The following steps should be performed as user root to configure init:
Create the configuration file hvrtab in the /etc directory. Each line of this configuration file should contain four or more parameters separated by a space in the following format:
username port_or_hub hvr_home hvr_config [options]
- username: Indicates the Unix/Linux username under which HVR runs.
- port_or_hub: Indicates a TCP/IP port number (for HVR Remote Listener) or the username and password of the hub database (for HVR Scheduler). The DB connection string syntax for the hub database differs for each database. For DB connection string syntax, see Calling HVR on the Command Line.
- hvr_home: Indicates the path for $HVR_HOME.
- hvr_config: Indicates the path for $HVR_CONFIG.
- [options]: Indicates an optional parameter to pass other options to the HVR process. For more information about the options, see hvrremotelistener and hvrscheduler.
Sample configuration file:
Lines starting with a hash (#) are treated as comments.
Copy the script file hvr_boot (available in hvr_home/lib) to the init.d directory and create symlinks to the rc.d directory.
For an Oracle RAC, the script file hvr_boot can be enrolled in the cluster with command crs_profile.
The following example uses start sequence 97 and stop sequence 03 (except HP–UX which uses 997 and 003 because it requires three digits).
On AIX, to start and stop HVR for run level 2:
On HP–UX, to start and stop HVR for run level 3:
On Linux, to start HVR for run levels 3 and 5 and stop for all run levels:
On Solaris 8 or 9, to start and stop HVR for run level 2 (which implies level 3):
On Solaris 10 and higher;
For newer Solaris versions, the script file hvr_boot must be registered in the Solaris's System Management Facility (SMF). Also, the file hvr_boot.xml (available in hvr_home/lib) should be copied to the init.d directory.
On systems where restricted security is configured, it may be necessary to add the following line to file/etc/hosts.allow :
It may be necessary to disable Security Enhanced Linux (SELinux). To disable SELinux, the following line should be available/added into the file /etc/selinux.conf and then reboot the server.
To see the status of SELinux, use the Linux command sestatus.
In this method, for connecting to a remote installation of HVR, the command hvrremotelistener should be executed on the remote server. This method is preferred when:
- the Linux xinetd package is not installed (this is the case for RHEL5) or
- the root privilege is unavailable or
- the password authentication cannot be configured
The following command uses options –d (run as daemon) and -N (skip password authentication) to listen on port 4343.
The following command uses option –i (interactive) and -N (skip password authentication) to listen on port 4343. Note that, in this method exiting the shell will terminate the remote listener.
Disabling password authentication (option -N) is a security hole, but may be useful as a temporary or troubleshooting measure.
Testing Connection to a Remote Installation of HVR
To test the connection, execute the command hvrtestlistener on the server from which you are connecting to a remote installation of HVR:
If authorization (username and password) is required to connect to the remote server then use the command hvrtestlistener with option -L. For example,