CONFIGURING THE CLIENT

The uf110c.ini file can be used to configure the client, both standalone and the client included with the server.  Most entries can be overridden by command line options, so these values are only used as defaults.  On Linux, the uf110c.ini file is located in the client install path.  If you aren't sure where that is, view the /usr/bin/uf110c script.  On Windows, it is found in %PROGRAMDATA%\SDSI, typically C:\ProgramData\SDSI.

Alternatively on Windows, if the uf110c.ini file is not found in the standard local path, the client will look instead in the executable path.  This enables configurations where the client is run across a network, and is not installed on local PC's.

The uf110c.ini file looks like this:

[defaults]

server=localhost

port=27502

hostpath=

#logfile=uf110c.log

retry=30

wait=1

ssl=0

authkey=

minavail=1

failhist=1

home=install_folder

perl=perl_executable

perlserver=serverspec

Change the server= line to point to the server host name or IP address, and the port line to the proper listening port configured in the server's uf110d.ini file.  The port default is 27502 and will not normally be changed.  Note that the server and port can also be specified on the uf110c command line with the -server option.  The values entered here serve as defaults.

Note the server= line can be structured as a full URL starting with http:// or  https://, in which case the server, port, hostpath, and authkey can be derived from the URL.  The authkey can be specified as the #fragment portion of the URL, or it will be read from the uf110c.ini file.

Note if using the legacy Perl client, such as on an older Linux or Unix system, the port should be set to 27500.  This is because there are two job submission protocols recognized by the server, legacy on 27500 and http/https on 27502.  The legacy client uses the legacy protocol, while the standard client uses http/https.  The legacy protocol does not support host paths; the legacy client must be able to connect directly to the legacy port on the server.

The hostpath value, if set, is used as the path portion of the http/https URL created from these settings.  This is used in cases where there is a proxy server designed to recognize paths as part of the connection logic, such as with unform.cloud.

The retry and wait lines set the number of times, and delay between tries, that the client will attempt to connect to the server before giving up.  If any retries are needed, and the log file is specified, then a message will be logged.

The ssl setting, if 1, will cause the client to connect to the server using ssl.  The server must be configured to listen using ssl.  Both server and client must have matching settings.

The authkey setting must match whatever the server's authkey setting is, even if null.

The minavail setting is used when specifying multiple servers when submitting a job, in a load balancing environment.  The first server with at least minavail job slots available is chosen.  If this setting is 0, then if all servers have active jobs, the one with the least active jobs as a proportion of their license count is chosen.

The failhist setting sets the number of days that job failures are stored at the client.  This number must be 1 or higher for failures to be stored, and the fail history queue is purged of directories over this many days old.

On Windows, the home= setting is created during installation.  It is used by the uf110c.exe client to locate the uf110cc.exe console client, which performs the actual communication with the UnForm server.

Also on Windows, if you have Perl installed, you can instruct uf110c.exe to run the uf110c.pl perl script as a console client, by creating a perl=path line that points to the perl interpreter executable.  In addition, if you chose to run the compiled uf110cc.exe client with a -perl option, it will use this setting.

You can also specify perl= and perlserver= settings if you use the -perl command line option of the standard client.  The perlserver value should specify the legacy port (default 27500). perlserver=serverNameorIP:legacyPort.

The server argument can contain a semicolon delimited list of server values (be sure to quote it).  If it is a list, then when submitting jobs the client will check each for availability, depending on the uf110c.ini setting for minavail=n.  If n is 0, the client looks for the server with the most availability.  The algorithm is based on the ratio of print licenses to licenses in use.  If n is not 0, then the first  server with at least this many job slots available is chosen.  No matter which method is configured, the first server with no jobs in use is chosen.