|
The installation process of WinCss follows
the common Windows standards. The first time the new program is started, it will prompt
for the IP address of the CSS print server and the TCP/IP port number
with the default value of 6801. If this port number is already used in
your network, the network administrator has to assign another number which has to be
entered here. Additional manual server configurations have to be done in this very unlike
situation. The following sections describe the necessary actions:
1. TCP/IP Ports and Services
To establish a TCP/IP Client-Server connection, the client (WinCss) must know the IP
address of the system providing the server functionality. In addition, each connection
type (e.g. cssws to WinCss) is identified through a
unique port number. The TCP/IP services file defines symbolic names for
most of the ports used in a network environment. Using these symbolic service names
requires the services file to be present on each network nodes, i.e. on the host and on
all client systems. On Unix systems, the file is located in the /etc directory. On
Windows systems the location varies depending on OS type and version. Each line in the services
file holds the service name, a port number and a port type (for CSS the
type should always be tcp). To avoid conflicts with standard TCP/IP ports,
these numbers should have values > 5000 assigned by convention. Unitec
products use port numbers in the range from 6800 to 6999.
Since in heterogeneous environments the administration of the services
files requires considerable work, there has recently emerged the trend to define so called
well known ports for each connection type. For the WinCss
connection the port 6801 has been defined as the default. To avoid
conflicts with other software packages another port number may be assigned during setup of
WinCss. This value is then stored string variable CssPort
located in the Windows registry under
HKEY_LOCAL_MACHINE\SOFTWARE\Unitec\WinCss\CurrentVersion
For all CSS servers (Unix and Windows NT) the port number is defined
in the WINCSS_PORT parameter of the configuration file css.default.
In addition, the programs cssws(U) and WinCss
allow to specify TCP/IP configuration settings as command line arguments. Example:
| cssws -p 7001 |
the Unix WinCss server should use port number 7001 to
provide its services |
| WinCss -h 128.41.1.1 -p
7001 |
the WinCss client connects itself with the CSS
server located on the host with the IP address 128.41.1.1 using the port number 7001 |
2. CSS Server Configuration (Unix)
As with any server process, the program /usr/lib/css/cssws has to be spawned at
system startup. Several system services (e.g. /etc/rc(4) or /etc/inittab(4))
allow to configure automatic server invocation.
/etc/rc
| /usr/lib/css/cssws 2>/dev/null 1>&2 |
Unix System V only
The same service can be established on System V by inserting the following line
in /etc/inittab(4):
| cssws:1:respawn:/usr/lib/css/cssws 2>/dev/null 1>&2 |
Internet Super Server (inetd)
Since the Internet Superserver inetd(1) requires to use symbolic
service names, you must first edit your /etc/services file and add the
line:
| cssws 6801/tcp # WinCss server |
Then edit your /etc/inetd.conf file and add the lines:
# CSS Service
cssws stream tcp nowait root /usr/lib/css/cssws -i |
The inetd(1) process reads configuration file /etc/inetd.conf at startup
to initialize itself. This will make the cssws(U) services
available for connections through WinCss.exe on the Windows client.
Unless started by the init(1) program, cssws(U) will detach automatically
from the calling process.
3. CssNT Server Configuration (Windows NT)
The WinCss services are provided from the program CssNTSrv.
This program is installed as NT service by Setup and will be started
automatically at system startup.
4. CSS Client Configuration (Win32)
The WinCss program is designed to operate in two different modes. In standard
operation, the tool buttons of the small toolbar window are added to the Report Queue
window which then acts as the main window. You may however choose to use the small toolbar
window (documented in the Windows Help file) as main window. The command line flag -m
or /m can be used to turn tool window mode on. This flag can be preset after each
installation in the properties of WinCss.exe in the WinCss program folder.
In addition, the -h or /h option may be used to
specify the IP address of the server and -p or /p to use
a specific port number. This feature makes it possible to connect to several different CSS
servers concurrently.
The CssNT server uses the NT Security Model to determine user access
rights.
In order to provide access security, the WinCss software needs to know the Unix
user name or UID. On 32 bit systems, this information will by default be read through the GetUserName
API function and on 16 bit systems from the environment variable USER. If a
different variable is used (e.g. UNIXUSER), it has to be defined in the registry (Windows
95 and NT) or in the file css.ini (Windows 3.1x) located in the Windows directory:
WinCss-Registry-Key, Value UserEnv
or
...
[Environment]
UserEnv=UNIXUSER
...
Unix user information may also be obtained from another .ini file. The following
css.ini definitions will cause css.exe to get the user information from the
entry USERNAME in the section Network in file system.ini:
...
[Environment]
UserIniFile=system.ini
UserIniSection=Network
UserIniKeyWord=USERNAME
...
If WinCss is unable to obtain user information by the above rules, login is done
as guest.
If an css.ini file is created in the target directory of a file server
installation, the host name or address will be proposed as the default selection in
further workstation installations and propagated into the registry or css.ini of
the Windows directory (Win 3.1x). The registry location of all WinCss parameters is
HKEY_LOCAL_MACHINE\SOFTWARE\Unitec\WinCss\CurrentVersion
Running WinCss / Troubleshooting
Make sure that you have followed the steps described above and that the setup.exe
program has completed without any errors. You are now ready to start WinCss. If the
program fails to start or an error message is shown, please double check your TCP/IP
system files. After you have done the necessary corrections, you will have to shut down
the Unitec Communication Manager Ucm.exe. This process has
been started automatically and is running invisible on your system. To stop it, type Ctrl-Alt-U
and you will see its icon on the Windows task bar. Click the right mouse button on the
icon and select Close in the pop up menu. If a warning window is shown, select the Close
button and ignore the warning. You may now retry to run WinCss.
The utility CssVerCk.exe may be used to resolve version conflicts with installed
Windows components.
5. Automating the WinCss setup procedure
The installation program (e.g. WinCss400.exe) accepts the following
command line options:
| /S |
Silent mode, automatic mode with no user choices. All
actions and installation errors are logged in the file INSTALL.LOG
located in the target folder. |
| /M=filename |
Specifies a value file for installation. The value file is a simple text file with variables listed, one per line, in NAME="VALUE" format.
The double quotes are required only if the VALUE field includes
embedded spaces. The NAME field is case insensitive. The following
values may be set:
| Name |
Value |
| CssHost |
Specifies the IP address or the host name of the
CSS server. The value does not overwrite already
existing registry entries, i.e. has no effect on upgrade
installs. |
| CssPort |
Specifies the port number or service name to be
used for connections to the CSS server. The value does
not overwrite already existing registry entries. It defaults
to port number 6801. |
|
|
