Session Server Restarts on IBM AIX

Document ID:7021332
Creation Date:13-Jun-2012
Modified Date:11-Mar-2018
- Micro Focus Products:
  Verastream Host Integrator (VHI)

Environment

Verastream Host Integrator version 7.0 or higher

Situation

When running Verastream Host Integrator (VHI) Server Kit on the IBM AIX UNIX platform with a high session load (more than approximately 100 to 400 concurrent sessions), the session server process may terminate and restart.

This issue is further identified by the following symptoms:

A core file is generated in the /opt/attachmate/verastream/hostintegrator/bin directory (or your equivalent hostintegrator/bin subdirectory, if you installed VHI to a non-default location).
The system log contains a message similar to the following:

daemon:warn|warning VHI[442380]: Host Integrator component 
Verastream Host Integrator Session Server restarting. Reason: Terminated
 by signal = SIGABRT.

Resolution

To resolve this issue, increase the process memory limit before starting the session server by setting the LDR_CNTRL environment variable.

For example, LDR_CNTRL=MAXDATA=0x7000000 configures a 2 GB process memory limit. In the sample startup script below, see the inserted red lines.

INSTALL_DIR=/opt/attachmate/verastream
BIN_DIR=$INSTALL_DIR/hostintegrator/bin

echo "Starting Verastream"
$BIN_DIR/atstart -start logmgr

export LDR_CNTRL=MAXDATA=0X70000000
$BIN_DIR/atstart -start server
unset LDR_CNTRL

$BIN_DIR/atstart -start hostemul
$BIN_DIR/atstart -start mgmtserver

For additional information about the LDR_CNTRL environment variable, see http://publib.boulder.ibm.com/tividd/td/ITAME/GC32-0846-00/en_US/HTML/am39_perftune11.htm.

For more information about VHI memory usage, see KB 7021335.

For information about configuring a system daemon startup script to run VHI services automatically, see http://docs2.attachmate.com/verastream/vhi/7.1sp2/en/topic/com.attachmate.vhi.vmc.help.online/tasks/vhi_mc_session_svr_sys_daemon.xhtml.

Cause

The AIX operating system, by default, severely limits the maximum memory available to applications (typically 256 MB). The VHI session server has higher memory demands when running more concurrent sessions (including active, idle, suspended, and rogue sessions). Depending on the model size and AIX version, you can expect approximately 100 to 400 concurrent sessions with the default process memory limit. When the "sesssrvr" process exceeds the memory limit, the OS terminates and restarts the process.

Additional Information

Legacy KB ID

This article was originally published as Attachmate Technical Note 10134.