Configuring vsrvtcp

Configuring the vsrvtcp.ini File on the Host

The vsrvtcp.ini file contains the user profile definitions for your Visimage3 users. Many CUs create two or three profiles for their users to share: one each for live, eom and test. Others prefer to setup individual (password protected) profiles for their users. These CUs generally enforce password aging as well.

This article describes the recommended way to setup your vsrvtcp.ini file to support individual profiles for all users. This system required vsrvtcp version 4.9.2.x or higher. Using this approach, you will have both regular and admin users. You will need at least one admin user who can create and delete users and also reset user passwords. Admin users are identified by the "Admin=Y" key in their profile. In the example below we are using the convention "first.last" for our user names. You can choose to use any convention that you like.

Sample INI file

[jane.doe]
  Admin=y                        << Note 1 >>
  profile=summit_$VSVAR1         << Note 2 >>
  password=Iamyouradmin!         << Note 3 >>

[summit_live]
  login=bolive                   << Note 4 >>
  fipath=LIVE                    << Note 5 >>
  EQ_DBSERVER=localhost:eloqdb   << Note 6 >>
  profile=summit_common

[summit_eom]
  login=bolive
  fipath=LIVE
  EQ_DBSERVER=localhost:eloqdb
  profile=summit_common

[summit_test]
  login=botest
  fipath=TEST
  EQ_DBSERVER=localhost:eloq-TEST
  profile=summit_common

[summit_common]                   << Note 7 >>
  directory=/var/summit/spectrum/$fipath/FI/VISIMAGE
  temp=./temp
  batchdir=$SPX_HOME/FI/VISIMAGE
  vmgr=/ASKPLUS/visimage/vmgr_$VSVAR1
  profile=default_settings
  profile=askplus

[default_settings]                << Note 8 >>
  ASKCHAR=ROM8
  IEEE=1
  ASKODX=1
  ASKJOINS=1
  VMGRLIST=1
  DBCLOSEMODE2=1
  ASK_OLDDATE=1
  HPSPLITYEAR=50
  ASKERR=1
  GAUGE=1
  CISAM=Y
  DISABLE_STREAM_CMD=Y
  ALLOW_EDIT_HOST_FILE=N

[askplus]                         << Note 9 >>
  askplus=/usr/bin/nice -20 /ASKPLUS/askplus $VSVAR3

Connection Setup in Visimage3

When a user creates a connection in Visimage3, the "Host Profile Name" that they specify will be their username followed by "!live", "!eom" or "!test".

Notes:

1. Indicates that Jane is an Admin user.
2. When Jane connects using "jane.doe!live" the variable $VSVAR1 will have the value live and therefore the profile used will be "summit_live". This simple "switch" allows Jane to connect to live, eom or test data all from a single user profile.
3. When Jane changes her password, the new password will be stored encrypted in the INI file.