CSS Unitec Home Page
      

Virtual CSS Server

 VirtualServer(C)

Name   Platforms   Description   Notes

Name

Virtual CSS Server

Platforms

Unix

Description

CSS is capable of providing several independent print server environments on one system. To operate in such an environment, the CSS_ENV variable must point to the home directory of the Virtual CSS Server. Setting CSS_ENV to the value "/" will cause the CSS programs to run in the standard (main) environment.

Setting CSS_ENV

• Bourne Shell sh(1), Bourne Again Shell bash(1)

.profile   (sh)
.bashrc  (bash)
CSS_ENV=/usr/css1
export CSS_ENV
shell prompt CSS_ENV=/usr/css1
export CSS_ENV
temporarily CSS_ENV=/usr/css1  command [option...]


• C-Shell csh(1)

.login setenv CSS_ENV /usr/css1
shell prompt setenv CSS_ENV /usr/css1
temporarily NA


Virtual CSS Server Directory Stucture

The home directory for each virtual server must contain the following sub-directories:

Directory Contents
etc
File Contents Optional
css.default configuration parameters
css.devices device definitions
css.forms form definitions
css.banner banner message of the day yes
lib Internal CSS control files such as compiled device and form definitions, the report queue and others.
spool Optional directory for intermediate spool files. May be overwritten by setting the CSS_SPOOL_DIR parameter in $CSS_ENV/etc/css.default.


A typical setup session:

# if not registered yet, enter virtual server license (type CVS)
CSS_ENV=/  /etc/ulm
# setup directory structure:
umask 0
mkdir /usr/css2
cd /usr/css2
mkdir etc lib
# register user activation keys (type CSS and WinCss)
CSS_ENV=/usr/css2  /etc/ulm
# copy and modify CSS configuration files
cp /etc/css.*  ./etc
vi ./etc/css.*
# compile device and form definitions, initialize report queue
CSS_ENV=/usr/css2  /etc/csa -d -f -R


Device Sharing

To share devices among several virtual CSS environments, the external lock feature of css.devices (el capability) must be used. It is mandatory that each logical device using a particular physical device has the identical el capability value defined. Devices in use by another virtual server or software package will show the busy status in the css(U) interface program.

Configuration Parameters Needing Special Attention

Setting the CSS_SPOOL_DIR configuration variable of distinct CSS environments to the same directory will result in data loss.

The WINCSS_PORT configuration variable should be set to a distinct port number for each virtual CSS environment. As an alternative, you can use the cssws(U) p-option to set individual port numbers. One cssws(U) windows server must be started for each virtual environment at boot time.

Sample /etc/rc setting:

WINCSS_PORT set in each css.default file

...
CSS_ENV=/  /usr/lib/css/cssws
CSS_ENV=/usr/css2  /usr/lib/css/cssws
...


WINCSS_PORT not set

...
CSS_ENV=/  /usr/lib/css/cssws -p 6851
CSS_ENV=/usr/css2  /usr/lib/css/cssws -p 6852
...

Notes

Each virtual CSS server requires its own license to operate. The Unitec product code of this license type is CVS. FreeCSS cannot operate in virtual mode.
 

 

Back to top