The SPICE server must have WRspice installed, and be served by a license server. As a prerequisite, WRspice should operate on the SPICE server host in the normal way.
In order for the ``SPICE server'' to actually become a server, the wrspiced daemon program must be running. This program is part of the WRspice distribution, and is installed in the same directory as the wrspice executable. The daemon manages the queue of submitted jobs and responses, and maintains the communications port.
The wrspiced daemon will establish itself on port number 3004 by default. If this port is already in use, or can't be used for some other reason, a different port can be specified on the wrspiced command line, or in the system services database as ``spice/tcp''. It is quite rare that operation on other than the default port is necessary.
The system services database is represented by the contents of the file /etc/services in simple installations. If using NIS, then the system will get its services information from elsewhere, in which case adding a service to the database will require more than editing the file. Your system administrator should be consulted in this case. To add the spice/tcp service, assuming the simple case, one must edit the /etc/services file (you must be root to do this) and add a line like the following:
spice 3004/tcp #Whiteley Research Inc
This file probably also has an entry for ``xictools 3010/tcp'', which is the license server. The ``3004'' is the default port number to be used for SPICE communications, and should be replaced by the actual port used. This can be any valid port, but must be the same for all machines wishing to use the service.
Even if the default 3004 port is being used, it might be wise to edit the /etc/services file as above anyway to prevent someone else from using the port for another purpose. In no case is it required that the services database be modified; it is mainly for convenience. An alternate port can be specified when the daemon is started (see below).
The final step in configuring the SPICE server is to start the wrspiced daemon. The wrspiced program command line has the following form
wrspiced [-l logfile] [-p program] [-m maxjobs] [-t port]
There are four optional arguments.
The daemon is started by simply typing the command. If a machine is to operate continuously as a SPICE server, it is recommended that the wrspiced daemon be started in the system initialization scripts. The daemon will run until explicitly killed by a signal, or the machine is halted.
It may be necessary to become root before starting wrspiced, as on some systems connection to the port will otherwise be refused due to permission requirements.