Technical information

INSTALLATION AND ADMINISTRATION GUIDE

Displaying license information

Command line

1. Log into the fax server as user vsifax.

2. Display the settings of the current license by entering the following:

vfxadmin license -l

This displays the license table with the following information: the serial number and the activation key, the

license type (real, date, demo or eval), the platforms the license is compatible with (none for all platforms,

linux for Linux platforms and intel for Linux and Windows), the maximum number of licensed users, of ports

used and of virtual fax servers configured, the license expiration date if any, and the version number.

User administration

You must register each user who will be sending or receiving faxes with VSI-FAX as a licensed user in the VSI-FAX

database. The VSI-FAX license installed must allow enough licensed users otherwise you have to reactivate license

to increase the number of licensed users.

Registering users

When a user is registered on the fax server, an account for that user is created in the user database, which is located

in the $VSIFAX/spool/dbs directory. Every individual who uses VSI-FAX to send or receive faxes must be

registered on the fax server, and each user must have a unique VSI-FAX user ID. The VSI-FAX user ID does not

have to be the same as any other login name used by that individual.

Note

Administrators do not have to explicitly register new VSI-FAX users because new users are automatically

registered the first time they connect to the fax server. Outlook and web fax client users are also licensed the first

time they connect to the fax server.

Command line

For example, to register fax user Bill Franks with the user ID billf, enter:

vfxadmin user -n "Bill Franks" billf

The vfxadmin user command can also used to register and license a user at the same time. For example, to

vfxadmin user -L -n "Bill Franks" billf

Changing a user's name and password

A user's VSI-FAX logon information is stored in the fax server user database. Two different command line utilities can

be used to change a user's name or password:

Use vreguser if you want to change your name or password.

Use vfxadmin user if you are a fax administrator and want to change another user's name or password.

Command line

If user billf wants to change his user name from Bill Franks to William Franks, he would enter:

vreguser -n "William Franks"

If the fax administrator wants to change user billf's name from Bill Franks to William Franks, he would enter:

vfxadmin user -n "William Franks" billf

If user billf wants to change his password, he would enter:

vreguser -p

The system will prompt user billf to enter his new password.