-
Installation and Administration Guide 6.1 www.esker.
-
VSI-FAX Version 6.1 Issued April 2009 Copyright © 2001-2009 Esker S.A. All rights reserved. Esker, the Esker logo, Esker on Demand, VSI-FAX and LanFax are registered trademarks of Esker, S.A. in the United States, France, and other countries. Microsoft, Windows, Windows Server, Outlook, Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Intel and Pentium are registered trademarks of Intel Corporation in the U.S.
-
Table of Contents What's New in this Version?..................................................................... 5 VSI-FAX Pre-Installation............................................................................ 7 Supported Platforms and Equipment .................................................... 11 Installing VSI-FAX Server on Windows.................................................. 19 Installing VSI-FAX Server on Unix/Linux ...............................................
-
Server Maintenance ............................................................................... 139 Integration Fundamentals ..................................................................... 143 Customization Techniques ................................................................... 153 Troubleshooting .................................................................................... 157 Using vfx Tags .......................................................................................
-
What's New in this Version? Extended OS support New platforms are supported for the server installation including Windows Server 2008 32 or 64 bits and Red Hat Entreprise 5. For the complete list of supported platforms for each VSI-FAX server and client component, refer to Supported Platforms and Equipment (page 11). Extended Brooktrout support VSI-FAX 6.
-
INSTALLATION AND ADMINISTRATION GUIDE VSI-FAX Outlook Client VSI-FAX Windows Client now supports Outlook 2007. New Fax on Demand device for failover VSI-FAX 6.1 now comes with two different devices to send faxes via Fax on Demand: FoDC is the main Fax on Demand device that already existed in the previous version, FoDC2 is a new backup Fax on Demand device used when the FoDC fails to send the faxes.
-
VSI-FAX Pre-Installation VSI-FAX Pre-Installation Read this information before beginning your VSI-FAX installation. What you will need You will need the following: Installation CD VSI-FAX Installation and Administration documentation (available in HTML format or in printed version on the VSI-FAX CD at \docs\vsifax_instadm.pdf) Your VSI-FAX PIN/secret code(s), given to you upon purchase. This is required to register your software on the Web and obtain your Serial Number and Activation Key.
-
INSTALLATION AND ADMINISTRATION GUIDE For Red Hat 5.0, install the compat-libstdc++-33-3.2.3-61.i386.rpm RPM package that you can find on the CD2 or DVD in the Server folder. Next, perform the VSI-FAX Server installation. Other considerations This section describes several other items for you to take into consideration before installing VSI-FAX. Port 2996 and 2539 availability VSI-FAX uses TCP ports 2996 and 2539 to communicate with the fax server.
-
VSI-FAX PRE-INSTALLATION Information Description Country Code Your country code. This is used to dial international fax numbers. In the US, this is typically 1. Long Distance Access # Number you enter to dial long distance telephone numbers. In the US, this is typically 1. Area Code Your local telephone area code Local Number Length Number of digits in a local phone number. In the US, this is typically 7.
-
INSTALLATION AND ADMINISTRATION GUIDE Fax modem properties This information is used to configure supported fax modems for use with VSI-FAX. Information Queue name Description Short name for this fax modem device. Description Short descriptive name for this fax modem device. COM port Serial port this fax modem device will use to communicate with VSI-FAX. Ensure that no other modem is using the same port. Prepare Register your VSI-FAX software to get your Serial Number and Activation Key. 1.
-
Supported Platforms and Equipment Supported Platforms and Equipment This section provides detailed technical information about: Qualified platforms and detailed system requirements for each VSI-FAX application (e.g., fax server, clients, development tools) Supported fax devices (i.e., modems and fax boards) Support for Windows Terminal Services environments Support for other equipment (e.g., Ethernet Terminal Servers, Port Expanders, etc.
-
INSTALLATION AND ADMINISTRATION GUIDE Qualified platforms Sun Solaris SPARC Operating System Version(s) 9 (32-bits or SPARC v8 compatible) Sun Solaris (Intel) 10 IBM AIX 5.1 and 6.1 HP-UX 11iv1 (B.11.11) SCO OpenServer 5.0.7 and 6.0 SCO UnixWare 7.1.3 Red Hat Enterprise 3, 4 and 5 Companion software - TCP/IP TCP/IP must be running on the target host machine and a network card must be installed. Fax on Demand Connector Uses an HTTPs Internet Connection, no proxy server.
-
SUPPORTED PLATFORMS AND EQUIPMENT Companion software - TCP/IP TCP/IP must be running on the target host machine and a network card must be installed. Fax on Demand Connector Uses an HTTPS Internet Connection, no proxy server. Evaluation If you are evaluating VSI-FAX, you do not have to install a physical fax device (modem or fax board). You can use the Demonstration Driver (also called loopback) to evaluate the software.
-
INSTALLATION AND ADMINISTRATION GUIDE Supported Platforms Microsoft Windows Operating System Version(s) XP SP3 (32-bit version only) . Vista SP1 (32-bit and 64-bit versions) .
-
SUPPORTED PLATFORMS AND EQUIPMENT Supported Platforms Microsoft Windows Operating System Version(s) XP SP3 (32-bit version only) . Vista SP1 (32-bit and 64-bit versions) . Server 2003 R2 SP2 (32-bit version only) or Windows Server 2003 SP2 (32-bit Standard Edition, Enterprise Edition, or Datacenter Edition) with Terminal Services or not. Server 2008 SP1 (32-bit and 64-bit Standard Edition, Enterprise Edition, or Datacenter Edition) with Terminal Services or not.
-
INSTALLATION AND ADMINISTRATION GUIDE Hardware Requirements Required Minimum CPU Pentium II 300 MHz RAM 16 MB (32 - 128 MB recommended) Hard Disk Space 3 MB Software Requirements Required Minimum TCP/IP Connectivity (1) As provided by your platform. VSI-FAX Server (1) 6.1 (1) A properly installed and configured VSI-FAX Server must be accessible via a network connection in order to save your fax cover pages on the fax server so that they can be used for faxing.
-
SUPPORTED PLATFORMS AND EQUIPMENT Software Development Kit (SDK) These are the detailed system requirements for installing and using VSI Software Development Kit (SDK). Supported Platforms Microsoft Windows Operating System Version(s) Server 2003 R2 SP2 (32-bit version only) or Windows Server 2003 SP2 (32-bit Standard Edition, Enterprise Edition, or Datacenter Edition) with Terminal Services or not.
-
INSTALLATION AND ADMINISTRATION GUIDE Dialogic Brooktrout fax boards and drivers VSI-FAX supports the following fax solutions from Dialogic Corporation: Dialogic Brooktrout TR1034 and TruFax boards Dialogic Brooktrout SR140™ Fax Software for Fax over IP. Brooktrout TR1034 boards, TruFax boards, and SR140 Fax Software are supported in Windows and Red Hat Linux environments.
-
Installing VSI-FAX Server on Windows Installing VSI-FAX Server on Windows Installing fax board drivers First you should install and configure your board in the VSI-FAX computer. ® For information about installing VSI-FAX with a Dialogic Brooktrout fax board or with Brooktrout SR140™ Fax Software solution, refer to Installing Brooktrout drivers on Windows in the Fax Boards and Fax Drivers Installation documentation.
-
INSTALLATION AND ADMINISTRATION GUIDE To install an imaging server, enter the license provided in Imaging Server Setup and Configuration (page 137). Note If you do not enter a Serial Number and Activation Key, an evaluation license will be installed. This license allows you to test VSI-FAX and see if the product matches your needs. With such a license, you can use VSI-FAX for 30 days. After that, you can reactivate it with another time-limited evaluation license or with a production license. 7.
-
INSTALLING VSI-FAX SERVER ON WINDOWS • If you want to install VSI-FAX Server with the loopback and install the drivers later, click No. For information about installing VSI-FAX Server with Dialogic Brooktrout drivers, refer to Dialogic Brooktrout fax boards and drivers in the Fax Boards and Fax Drivers Installation documentation. 12. You may be warned that the last version of the Dialogic Brooktrout Plug-and-play-driver 6.0.0 is required to use VSI-FAX with a Brooktrout fax board.
-
-
Installing VSI-FAX Server on Unix/Linux Installing VSI-FAX Server on Unix/Linux This section describes how to install a VSI-FAX server on a supported Unix or Linux platform. See also See Supported Platforms and Equipment (page 11) for more information about supported Unix or Linux platforms. Tip Use your completed Fax Server Information Form (page 237) to provide the information required during this installation.
-
INSTALLATION AND ADMINISTRATION GUIDE 4. Mount the CD-ROM drive. Refer to Sample Unix and Linux Mount Commands (page 235) for additional information. 5. Change directory to the CD-ROM mount point by entering: cd /mnt/cdrom 6. Run the installation program by entering: ./install.sh 7. Confirm your platform. 8.
-
INSTALLING VSI-FAX SERVER ON UNIX/LINUX Refer to Internet email servers. Important When setting up your POP3 fax routing email account, do not use an email account that receives normal email. The fax server will try to process all received email on this account as an inbound fax, causing drastically poor fax routing performance or unexpected application behavior. Furthermore, the fax server will remove email messages from this inbox.
-
-
Upgrading to version 6.1 You can upgrade to version 6.1 from the following versions: VSI-FAX 6.0 Direct upgrades to 6.1 from versions prior to 6.0 are not advised. Existing customers running a version of VSI-FAX prior to 6.0 must upgrade to version 6.0 before installing version 6.1.
-
INSTALLATION AND ADMINISTRATION GUIDE 7. Enter your Serial Number, Activation Key and remote server addresses if requested. 8. After the file copy, modify existing fax modem devices configuration, cover page information, telephony information, SMTP server and POP3 server connection settings if needed. 9. Answer yes when prompted to start the VSI-FAX Admin Server and Fax Server tasks. Breaking changes VSI-FAX MailMerge Client The printer port name has been renamed VSI-FAX Port 3.0 in VSI-FAX 6.1.
-
Testing the Fax Server Testing the Fax Server Immediately after installing the fax server, verify proper fax server operation by sending a simple test fax via the vfx command line. You can send this test fax using the loopback feature or you can send it to any fax machine. Sending a test fax using the loopback Sending a test fax using the loopback feature eliminates potential outside problems (e.g., phone lines, modems, etc) that could cause a fax transmission failure.
-
INSTALLATION AND ADMINISTRATION GUIDE 2. Verify that the fax server is running by entering: >vfxstat -s 2 Server status information is displayed. The display will be continually refreshed every two seconds. 3. Open another command shell on your computer. 4. Send your test fax by entering: vfx -n For example, to fax a test file called to (800) 123-4567, you would enter: vfx -n 8001234567 The test fax is sent to the default device queue. 5.
-
Installing VSI-FAX Server Administration MMC snap-in Installing VSI-FAX Server Administration MMC snap-in Important Refer to the VSI-FAX Server Administration help for additional information about loading the snap-in from a Microsoft Management Console (MMC) session. If you do not install VSI-FAX Server Administration on the VSI-FAX Server computer, ensure that the VSI-FAX server that you want to remotely administer is accessible via a network connection and that port 2539 is opened through any firewalls.
-
-
Installing the Outlook Client Installing the Outlook Client Refer to the Supported Platforms and Equipment (page 11) before installing the Outlook Client. Important You must use an administrator account when installing the Outlook Client on Windows Vista. See also Refer to the VSI-FAX Outlook Client help for information about configuring Outlook for Corporate or Workgroup mode.
-
INSTALLATION AND ADMINISTRATION GUIDE After the installation, when launching Outlook, you will have three new buttons: Fax message, Fax Status and Fax Profile settings. Basic installation procedure 1. Load your VSI-FAX CD-ROM into your CD-ROM drive. If the autorun program does not start automatically, run autorun.exe located in the root directory of your VSI-FAX CD-ROM. The VSI-FAX CD browser appears. 2. Select Outlook Client under Desktop Client.
-
INSTALLING THE OUTLOOK CLIENT Windows Terminal Server installation notes This section provides critical information for successfully installing the VSI Outlook Client in a Windows Terminal Server environment. The Outlook Client supports Microsoft Windows Terminal Services. Make sure you have deployed Outlook in a Windows Terminal Services Environment before deploying the Outlook Client.
-
INSTALLATION AND ADMINISTRATION GUIDE Force Outlook to regenerate each cache file Create a registry key Delete all Outlook cache files This method is faster (especially if there are many Terminal Server users) but should only be attempted by experienced system administrators. 1. Ensure that Outlook is not running in any Terminal Server session. 2. Search for and delete all instances of extend.dat file (extension cache) on the Windows Terminal Server machine.
-
INSTALLING THE OUTLOOK CLIENT Troubleshooting problems with the Outlook Client Troubleshooting procedures When there is a problem with the Outlook Client, you can check the following components: Mapi account State of the VSI-FAX server Forms Outlook extension Mapi account In Outlook, under Tools > Email Accounts > View or change e-mail accounts, verify that the VSI-FAX MAPI account has been created. Open its properties and verify that the proper parameters are set.
-
INSTALLATION AND ADMINISTRATION GUIDE If the form was published in the organizational form, you can try copying it locally in the personal forms folder to verify that there is no problem accessing the form on the exchange server. Outlook extension VSI-FAX is an Outlook extension.
-
INSTALLING THE OUTLOOK CLIENT In Outlook, you can define a signature that will be put on all new messages. Depending on which email account is set as default (the mail exchange account or the VSI-FAX MAPI account), you will get this signature when opening a New fax message.
-
-
Installing CoverMaker Note You must have write access to the vsicover directory to be able to save your cover pages. Without correct rights, you can have the "permission denied" or "no such file or directory" errors. Install CoverMaker to design custom fax cover pages. 1. Load your VSI-FAX CD-ROM into your CD-ROM drive. If the autorun does not start automatically, run autorun.exe located in the root directory of your VSI-FAX CD-ROM. 2. Select CoverMaker under Tools. 3. The Welcome screen appears.
-
-
Installing the Software Development Kit Installing the Software Development Kit Note You will find the C/C++ Client API Reference guide (c_api.pdf) in the \docs folder of VSI-FAX CD-ROM. Installing on Unix or Linux 1. On the VSI-FAX CD, select server\\faxapi.tgz, where is the appropriate platform for your system. See below for information on how to work with .tgz files. 2. Follow the on-screen installation instructions to complete installation. Extracting .
-
INSTALLATION AND ADMINISTRATION GUIDE 4. The Software License Agreement appears. Click Yes to agree to the conditions in the license agreement and continue with SDK installation. 5. Click Next if you agree with the default destination directory for the SDK program files. Otherwise, click Browse and follow the on-screen instructions to install the SDK in another directory. 6. The Choose VSI-FAX SDK Components screen appears.
-
Fax on Demand Connector Fax on Demand Connector The Fax on Demand Connector is the link between VSI-FAX and the Esker multi-channel e-document delivery solution, a.k.a. Esker on Demand. This connection allows VSI-FAX to automatically fax business documents directly from your company and desktop applications through outsourced fax service providers. The Fax on Demand Connector for VSI-FAX is easy to implement and easy to use.
-
INSTALLATION AND ADMINISTRATION GUIDE Hostname : The hostname or IP address of the Esker on Demand server you received from your Esker Account Manager. Set it to your main location for the main FoDC device (FoDC) and to the other location for the failover device (FoDC2), according to: • USA server: na.ondemand.esker.com • European server: as1.ondemand.esker.com Account ID : The Esker on Demand ID you received from your Esker Account Manager. Set the same value for both devices.
-
FAX ON DEMAND CONNECTOR Configuring a proxy for the Fax on Demand Connector If you need to use a proxy to connect to the Fax on Demand service, you need to configure VSI-FAX so that it can connect properly. To do so, you need to add keys in the vsisrv.ini file and reload VSI-FAX when done. These keys define the proxy name, its port, the username and the password used to access the proxy.
-
INSTALLATION AND ADMINISTRATION GUIDE • hostname : The hostname or IP address of the Esker on Demand server, from your Esker Account Manager • accountID : The Esker on Demand ID you received from your Esker Account Manager. • dial-convert : When set ON , converts the dialstring according to the rules found in dialcvt.lst. Note The other fields in the section are advanced fields for Technical Support only. Save your changes and close the file. 2.
-
FAX ON DEMAND CONNECTOR Receiving notifications about Fax on Demand fax jobs Jobs sent from VSI-FAX to the Esker on Demand server are logged in the outbound fax log just as other VSI-FAX jobs are. To view the outbound fax log, type vfxolog. For more information on the vfxolog command options, see Command Reference in the Reference Addendum documentation.
-
INSTALLATION AND ADMINISTRATION GUIDE Variable Description Subject Subject of the message Date Date when the message was composed Message Cover page message text Page Current page number in the message Pages Total number of pages in the message CurDate Current date CurTime Current time CurPage Current page number in this transmission CurPages Total number of pages in this transmission Sender/Recipient values* Name Name Company Company name Dept Department Mail Mailing address, incl
-
FAX ON DEMAND CONNECTOR The above 300, 400 and 700 timeout delays should be suitable in most cases. However, if you are using a slow Internet connection and notice that the timeout delays are not long enough, you can choose to adjust these timeout delays. Follow these steps if you wish to change the length of the above timeout delays: 1. Stop the VSIFAX server. 2. Use a text editor to edit the VSIFAX\lib\vsisrv.
-
INSTALLATION AND ADMINISTRATION GUIDE 1. Obtain an Esker on Demand ID and password. For this, contact your Esker Account Manager and ask for an Esker on Demand account to be created for your company. 2. Know the name of the Esker on Demand server you'll be communicating with. This information is provided by Esker when your Esker on Demand account is opened. 3. Have an Internet connection between VSI-FAX at your site and the Esker on Demand server.
-
FAX ON DEMAND CONNECTOR • Check Enabled to enable the Fax on Demand Connector. • Click Apply to apply your modifications and OK to complete. 5. Right-click FoDC2 in the right pane, and select Propertie s: • On the General tab, check the hostname and change it if necessary (see above for available destinations). • Enter your Esker on Demand account ID and password in the AccountID and Password fields respectively. • Leave the device as Disabled (do not check the Enabled otpion).
-
INSTALLATION AND ADMINISTRATION GUIDE ------- ----------- ------------------ --------------1 10/14 14:18 Normal Changing your Fax on Demand Connector information On occasion, you may need to change your Fax on Demand Connector Account ID, password, or hostname. This information is stored in your vsisrv.ini file. You can change the hostname and the Account ID from this file but not the password (which is encrypted in this file): 1. Use a text editor to edit the VSIFAX\lib\vsisrv.ini file.
-
FAX ON DEMAND CONNECTOR can also cancel outgoing faxes from VSI-FAX LanFax Windows Client provided client-side archiving is enabled and you see outgoing faxes in the Outbox. Keep the following in mind when canceling jobs sent using the Fax on Demand Connector: You can cancel a fax job that has not been transferred to Esker on Demand yet, which means that it is still in the FoDC device's queue. However, performing a cancel action on a fax that has already been submitted to Esker on Demand (i.e.
-
INSTALLATION AND ADMINISTRATION GUIDE Note Editing the vsisrv.ini file is the only way to customize the fax header of faxes sent using Fax on Demand. You cannot do it via vfxadmin config command or using VSI-FAX Server Administration. List of supported variables for Fax on Demand faxes' headers The two following sections provide you with reference information on the variables that you can use in the header parameter's value in vsisrv.ini file.
-
FAX ON DEMAND CONNECTOR 1. First of all, the fodcpgm process, which manages the FoDC devices, will wait for a TCP timeout or an acknowledgment of receipt for 300 seconds after having sent the http request. This first delay is the standard timeout delay for all http requests. 2. After this delay, if this process is still waiting for a TCP timeout notification, the FIM management process will wait another 100 seconds before registering the FoDC job as failed. This 400 seconds delay is the execution timeout.
-
INSTALLATION AND ADMINISTRATION GUIDE The failover mechanism is based on a set of scripts: sys-start.tcl: this script is run when VSI-FAX is launched. It sets up the initial state of the FoDC and FoDC2 devices (i.e. the main device enabled and the failover device disabled). sys-devfail.tcl: this scripts called whenever a device fails. It will disable the main device and enable the failover one when the main device fails. Refer to configuring notifications on device failure below to learn more. crontab.
-
FAX ON DEMAND CONNECTOR Configuring FoDC devices localization By default, the main device (i.e. FoDC) points to the USA platform and the failover device (FoDC2) points to the European platform. Invert the two locations if you would rather have the European server as main device destination and the USA server as failover location. Those addresses are: USA: na.ondemand.esker.com European: as1.ondemand.esker.
-
INSTALLATION AND ADMINISTRATION GUIDE # Failover : VSI-FAX Device failure notification and Failover to FODC for Windows #-------------------------------------------------------set VSIFAX $env(VSIFAX) # -----------------------------------------------------------------------# Configurable globals # -----------------------------------------------------------------------set FODC_MAIN_DEVICE "FoDC" set FODC_FAILOVER_DEVICE "FoDC2" set EMAIL "" global argv env set DEVICE [lindex $argv 0] set REASON [lindex $argv
-
FAX ON DEMAND CONNECTOR } exit 0 See also Refer to Fail notify procedures for more samples of such scripts for Windows and Unix/Linux. Refer to Command Reference in the Reference Addendum documentation for information about the VSI-FAX commands used. Automatic overflow to the FODC FIM Overflow automatically switches from local outbound faxing to Esker on Demand outbound faxing when the local outbound faxing delay is too high. This feature provides better handling of fax peaks and un-planned fax-mailings.
-
-
Fax Fundamentals Fax Fundamentals This section introduces and briefly describes various fundamental concepts that should be thoroughly understood before you begin administering your VSI-FAX server. Important terms and concepts This section defines some important terms and concepts that you should understand before you begin administering your fax server. Fax devices Fax devices can be either single-channel modems or multi-channel fax boards.
-
INSTALLATION AND ADMINISTRATION GUIDE Time-limited evaluation license (i.e. "date"): Evaluation license that expires on a given date. Regular production license (i.e. "real"): Time-unlimited production license. Licensed devices The VSI-FAX license controls the numbers ports used by modems and fax board devices on the server. If your license allows you to use a certain number of ports (for example, 24), you cannot exceed this number otherwise the VSI-FAX Fax Server will stop.
-
FAX FUNDAMENTALS To send a single fax request without using your profile settings, include this on your vfx command line: vfx ... -t udf="no" Note If you do not want to use your profile settings to send a fax, you can also omit the udf tag from your fax envelope. Not including it is the same as setting it to false or no. Directories Directories store fax addressing and routing (i.e., fax recipient) information. People People records store fax addressing and routing information for a single individual.
-
INSTALLATION AND ADMINISTRATION GUIDE Outbound fax The outbound fax log maintains a detailed record of each sent fax request. Functional overview This section briefly describes how VSI-FAX sends, receives, and routes faxes and how it send email messages. Sending faxes One of the primary design goals of VSI-FAX is to provide as many reliable ways as possible to send a fax.
-
FAX FUNDAMENTALS Note Starting with version 6.0, VSI-FAX offers a new LanFax™ Windows Client with enhanced usability to replace VSIFAX Windows Client. VSI-FAX Windows Client remains available on the CD-ROM as an unsupported client. The LanFax Windows Client is a front end to the VSI-FAX Server that provides an easy way for you to use VSI-FAX on your desktop.
-
INSTALLATION AND ADMINISTRATION GUIDE Incoming faxes are stored as numbered TIFF files in this directory. You can view these files by going to the vsifax inbox directory and opening them with a multi-page TIFF file viewer. Important You must have a multi-page TIFF viewer installed on your system to view received faxes.
-
FAX FUNDAMENTALS The advantage to this approach is that it is very inexpensive because you do not have to purchase any additional telephone numbers or services from your telephone company. Routing received faxes You can simplify departmental routing scheme to cover individual fax users. This is how it works. Thus far, our discussions have assumed that each fax device can only answer one incoming fax telephone number. This is not exactly true.
-
-
Fax Imaging Fax Imaging Multi-page Tagged Image File Format (TIFF) is the basic underlying file format used to send all faxes with VSI-FAX. However, you do not have to restrict your faxing to just TIFF files. VSI-FAX uses programs called formatters to convert common file types to TIFF files so that they can be faxed. This conversion process is what is referred to as "imaging.
-
INSTALLATION AND ADMINISTRATION GUIDE usually wrappers which rely on third-party tools that actually create the output TIFF file. Internal formatters are supported on all platforms and can process .txt, .pcl, .ep, .ps, .ps2, .pdf, and simple .rtf files. User-defined formatters : these are specified by the user via the%VSI-FAX%\lib\formatters.lst file. The user-defined formatters typically will be used to image specific file types produced by an application installed on the server.
-
FAX IMAGING File extensions Formatter name (type) above Comments process .docx or .xlsx files. Manages the interface to a VSI-FAX imaging server when imaging requests for non-Unix file types are made on a Unix server. Imaging on a Unix fax server Unix fax servers are commonly used in environments where legacy applications and print streams are fax enabled. The tools used in these environments are typically .txt, .pcl, or .ps. The internal formatters can process these file types.
-
INSTALLATION AND ADMINISTRATION GUIDE Setting up add-on formatters For some file types, you must use an add-on formatter to image the document. (For a list of formatter types and the file types they process, see the table on File extensions). To set up add-on formatters to work, you must: 1. Stop the VSI-FAX server. 2. Set the VSI-FAX server service to log in as an existing user. (See VSI-FAX Fax Server service properties if you want to understand why.) 3. Load your VSI-FAX CD-ROM into your CD-ROM drive.
-
FAX IMAGING Option O Description The program can use the option "-o filename" to specify the output file to use. If not specified, it is assumed that the output will be written to stdout Entries in this file take priority over native and internal conversions. A line starting with # sign is ignored. Here is an example associating .pdf files with our pdftotif: pdf:viewers\pdftotif.exe:o: 5. Save and close the formatters.lst file. 6. Restart the VSI-FAX server.
-
INSTALLATION AND ADMINISTRATION GUIDE t][DocClose]] htm 4 HTML Document ["C:\Program Files\Microsoft Office\OFFICE11\msohtmed.exe" /p %1] html 4 HTML Document ["C:\Program Files\Microsoft Office\OFFICE11\msohtmed.exe" /p %1] pdf 4 Adobe Acrobat Document [[FilePrintSilentEx("%1")]] ppt 4 Microsoft PowerPoint Presentation ["C:\Program Files\Microsoft Office\OFFICE11\POWERPNT.EXE" /p "%1"] txt 4 Text Document [%SystemRoot%\system32\NOTEPAD.
-
FAX IMAGING Tip Remember that our formatters may not recognize files with "weird" extensions (.0, .file, .tmp) and the file will end up being considered as plain text which can lead to behaviors such as transforming an image or PDF/Word document into many pages of ASCII. In this case, try changing the input file extension and see if the output is better. Converter specific troubleshooting Internal formatters GSTOTIF This converter relies on Ghostscript to manage Postscript files and PDF files.
-
INSTALLATION AND ADMINISTRATION GUIDE 2: -dBATCH 3: -q 4: -sDEVICE=tiffg3 5: -IC:\Program Files\VSI-FAX\FaxServer\lib\ghostscript\lib;C:\Program Files\VSI-FAX\FaxServer\lib\ghostscript\fonts 6: -sOutputFile=C:\Program Files\VSI-FAX\FaxServer\spool\temp\tmp00564aa.tif 7: GV_TOTALRN_99.pdf So if this command is not working properly, you can try to go into \lib\ghostscript\bin and launch Ghostscript directly (gs.
-
FAX IMAGING Updating Ghostscript on a Unix platform Unfortunately upgrading Ghostscript on Unix is not as easy as on Windows. Indeed no binaries are available for these platforms on the official website, only the sourcecode. So you will either need to retrieve these sources from the website and compile them following Ghostscript instructions or find a binary version for their platform on websites providing "built" versions of this tool (such as Sunfreeware.com).
-
INSTALLATION AND ADMINISTRATION GUIDE Add-on formatters On Windows servers, it is possible to enhance VSI-FAX support for Office file types by deploying add-on formatters (doctotif, htmtotif, pdftotif, ppttotif and xlstotif). They are available as a separate installation on the CD-ROM (in server\w32\fmtrs). This setup will install the converters in \lbin\viewers and modify the formatters.lst in order for them to be active by default on the following pattern: #pdf:viewers\pdftotif.
-
FAX IMAGING server couldn't find it. A workaround consisted of changing the filename to ..\currentpcl.pcl. This trick is no longer useful in versions 5.1 and on (the original problem was solved) but you may find such settings on migrated platforms. If the pcl file is incorrect (margin issues for example), try to change the print settings in the viewer and see if this impacts the output. If it is correct, the next step may be the cause of the conversion. Third step: currentpcl.
-
INSTALLATION AND ADMINISTRATION GUIDE Tip You can also check this association by using the command vinfo -D -v filetypes. If the application linked to a file format is not the one you wish to use (for example if Wordpad is associated with rtf but you want to use Word), you can use the Change button on the folder options to override default setting.
-
FAX IMAGING dde-only=on This will generate a new log file mstotifin \spool\logs containing information related to these conversions. If this appears to be working and the imaging program is launched and closed properly, you can go to Add-on formatters and follow the procedure to confirm the printer setting and the currentpcl.pcl conversion.
-
-
Basic Fax Server Administration Basic Fax Server Administration This section describes the basic tools, techniques, and procedures used to administer a VSI-FAX server. Tools and techniques This section describes the tools and techniques you can use to administer your VSI-FAX server. Many fax administration tasks can be accomplished more than one way (e.g., from the command or via a graphical administration environment such as the Microsoft Management Console).
-
INSTALLATION AND ADMINISTRATION GUIDE Note To start or stop the scheduler, you must be logged on as root or vsifax on Unix. On Windows, you must be logged in as Administrator or have Administrator privileges. To start the fax scheduler, enter: vfxsched start A message displays indicating success or failure. To stop the fax scheduler, enter: vfxsched stop A message displays indicating success or failure.
-
BASIC FAX SERVER ADMINISTRATION To send this same fax but also include a classic cover page, enter: vfx -t tfn=555-1212 -t fll=my_file.txt -t cvr=classic Viewing fax requests A request submitted with vfx is queued for a fax device or class. The scheduler manages the request until it is completed, canceled, or until it expires because the maximum number of retry attempts was reached. You can view the status of all active fax requests with the vfxstat command.
-
INSTALLATION AND ADMINISTRATION GUIDE The email gateway is defined in the $VSIFAX/lib/vsisrv.ini file, under the [VMAIL] section. The two main flags to set are: server : contains the IP address or fully qualified host name of the SMTP server. Default value is set during installation. sender : SMTP user name. This is the name that is shown in the fax recipient's email inbox. Default is VsifaxServer.
-
BASIC FAX SERVER ADMINISTRATION License management A network client is any VSI-FAX application running on a computer with a different IP address than the fax server. Each client must be registered as a licensed user in the VSI-FAX database to be able to connect to the fax server. VSI-FAX licenses specify a maximum number of licensed users.
-
INSTALLATION AND ADMINISTRATION GUIDE Displaying license information Command line 1. Log into the fax server as user vsifax. 2.
-
BASIC FAX SERVER ADMINISTRATION If the fax administrator wants to change user billf's password, he would enter: vfxadmin user -p billf The system will prompt the fax administrator to enter billf's new password.
-
INSTALLATION AND ADMINISTRATION GUIDE For example to add a Class 2 modem device named fax2, in Linux/Unix, enter: vfxadmin device -a -i cx -v /dev/tty01 -n "This is a modem" fax2 In Windows, the command would be: vfxadmin device -a -i cx -v com1 -n "This is a modem" fax2 Note If you want the added device to be the default destination, add the -d option to the vfxadmin device command. At the time a device is added, you must specify the serial port name.
-
BASIC FAX SERVER ADMINISTRATION DTMF-digit-limit is used to set the maximum number of DTMF digits to detect, DTMF-interdigit-timeout is used to set the time to wait between two digits, DTMF-max-collect-time is used to set the time to wait for DTMF events. See also For details on these parameters, refer to Configuration Files in the Reference Addendum documentation. Classes VSI-FAX can use either a single physical device or a group of devices called a class.
-
INSTALLATION AND ADMINISTRATION GUIDE To confirm that the device was successfully deleted, enter: vfxstat -t A message then displays confirming the device was successfully deleted. Enabling and disabling devices and classes Enabling or disabling a device is a very high-level decision. When you disable a device, you are essentially taking it offline; it cannot send or receive any fax submissions until you re-enable it.
-
BASIC FAX SERVER ADMINISTRATION System parameters System parameters allow you to configure SMTP and POP3 connectivity as well as define global default settings for any new devices added to your system. Configuration file System parameters are stored in the $VSIFAX/lib/vsisrv.ini file. Company information Company information provides a simple way to customize the default fax cover page templates so that your company or organization's name and address information automatically appears on your faxes.
-
-
Historical Logs Historical Logs Historical logs store detailed information about inbound and outbound faxes. Important The exact order of historical log tags is subject to change from release to release. Therefore, if you will be evaluating historical logs via a script, it is best that you explicitly search for a particular tag name rather than use a tag's current position in the log file. This will ensure that your scripts continue to work after product upgrades.
-
INSTALLATION AND ADMINISTRATION GUIDE See also For more information, refer to Microsoft Management Console (MMC). If you use the vfxilog command line utility, the following information is displayed for each received fax: Req ID Unique fax request ID number. Orig ID The original ID number for this fax if it was routed from another user. Clientid The current owner of this fax. Unless you have administrative privileges, you will only see your faxes.
-
Retry Strategies Retry Strategies Retry strategies are an important tool for managing the fax load on your server. A retry strategy defines the number of times the fax server will try to re-send a fax and how long it will wait between each retry before the fax request is permanently removed from the active fax queue.
-
INSTALLATION AND ADMINISTRATION GUIDE name>:,, ... Where is a user-defined name for this strategy, and each entry is one retry. The actual number of minutes specified determines how long the fax server will wait before executing that retry. Note If a retry strategy is defined without any entries, the fax server will interpret it as no retries (i.e., initial send only).
-
Fax Routing Fax Routing There are three methods for routing received fax transmissions. Print received faxes on a centrally located printer and manually hand deliver them to the recipients Automatically or manually route received faxes to each user's fax box directory Automatically or manually route received faxes to email addresses Note By default, received faxes are routed to the VSI-FAX administrator's fax queue, $VSIFAX/faxq/vsifax.
-
INSTALLATION AND ADMINISTRATION GUIDE vfxadmin user -d -n "" For example, to create a department called custs for general fax distribution, with the descriptive name Customer Service, enter: vfxadmin user -d -n "Customer Service" custs Note If you omit the -L option from the vfxadmin user command, the department will not be licensed.
-
Dial String Conversion Dial String Conversion "What you see is what you get" is rarely true for telephone numbers. Almost without thinking we include dashes, spaces and parentheses in typed and written telephone numbers. When we manually dial a telephone number, however, we know that we must remove these extra characters.
-
INSTALLATION AND ADMINISTRATION GUIDE Intermediate dial string conversion The next part of dial string conversion involves categorizing it as internal, local, long distance, or international based on the dial string variables stored in the $VSIFAX/lib/vsisrv.ini file. Note By default, the dial string variables are set to normal U.S. telephone requirements. If your local telephone system does not follow U.S. standards, reset these values. Dial string variables are stored in the DEVICE section of the vsisrv.
-
DIAL STRING CONVERSION If LocalNumLen + AreaCode < D, then the dial string is an international telephone number, except if the dial string is in a long distance access format. Once it is determined which type of telephone number the dial string represents, dial string variables are prepended or appended to the dial string as shown on this chart. Long Dist Prefix Dial Prefix Intl Prefix Intl Access LongDist Access Dial String Dial Suffix Intl Suffix Long Dist Suffix Intl. X Loc.
-
INSTALLATION AND ADMINISTRATION GUIDE Custom dial string conversion All dial string conversion can be disabled by setting the DialConvert option off in the vsisrv.ini file. If you prefer not to convert dial strings with any of the functions provided with the VSI-FAX software, you can write your own dial string conversion program. If DialcvtProgram is set to this program name in the vsisrv.ini file, the dial string conversion function, provided by VSI-FAX, will be completely disabled.
-
Event Notify Procedures Event Notify Procedures Event notify procedures are an advanced VSI-FAX customization/integration topic. You may skip this section if you are not interested in customizing event notifications. Event notify procedures are scripts that trigger various system actions whenever certain events take place. This entire notification mechanism is designed to be open and easily customized so that you can optimize each VSI-FAX system to your particular needs.
-
INSTALLATION AND ADMINISTRATION GUIDE User and device notify procedures If they exist, user and device notify procedures provide an additional level of granularity and power. Instead of being limited to customizing a particular notification point for an entire site, you can also customize it on a user-by-user or device-by-device basis for sent and received faxes, respectively.
-
EVENT NOTIFY PROCEDURES Next, the system looks for a site LNP. If it finds one, it runs it. Similarly, the system checks the fax command for a user LNP. If a user LNP was specified, the system runs it. Note User LNPs must be specified on a fax-by-fax basis. This is typically done via the -t lnp= tag. Similar vfx tags are also provided for other user notify procedures.
-
INSTALLATION AND ADMINISTRATION GUIDE The first part of this flow diagram is identical to the normal (non-group) fax send flow diagram. Immediately after a fax is submitted to the system, the system LNP is automatically run and if the system finds site or user LNPs, it runs them in that order. When a group fax reaches the Schedule Fax Attempt block, it is split into individual fax requests, one for each recipient in the group.
-
EVENT NOTIFY PROCEDURES As you can see from the flow diagram, the receive notification mechanism is much simpler than either of the send notification mechanisms. The receive notification mechanism features a single notification point and is not iterative. Note When a fax is routed to a user, any RNP specified in that user's profile will be run.
-
INSTALLATION AND ADMINISTRATION GUIDE Custom notify procedures Event notify procedures are typically Tool Command Language (Tcl) or shell scripts run by the scheduler at a particular notification point. All notify procedures must be located in the $VSIFAX/lib/enp directory. This directory is the only place the fax server looks for notify procedures.
-
EVENT NOTIFY PROCEDURES When an LNP is run, the fax request file will always be available to the procedure. This file is $VSIFAX/spool/temp/f-$REQID.tif for a regular request or $VSIFAX/spool/temp/gf-$GRPID.tif for a group request. Syntax Site and user LNPs are called directly from the system LNP, which passes the following arguments to the site and user LNPs: $1 Unique request-ID for this fax. Value is zero (0) for group fax requests. $2 VSI-FAX user ID who submitted the fax request.
-
INSTALLATION AND ADMINISTRATION GUIDE This shell script limits any group request to a maximum of 100 members: #!/bin/sh # lnp-site.sh GRPID=$6 NUM=$7 if [ $GRPID -ne 0 ] then if [ $NUM -gt 100 ] then MAILADDR=$3 echo "Group job GRPID terminated:" \ "too many members" | mail $MAILADDR exit 1 fi fi exit 0 Transmit notify procedures (TNPs) TNPs are often used for accounting or user notification of fax request status.
-
EVENT NOTIFY PROCEDURES Examples This shell script logs all fax attempts that actually use phone time to an accounting file. The script assumes that all users put an account number in thetg1 user tag. #!/bin/sh # tnp-site.sh REQID=$1 eval `$VSIFAX/lbin/vfaxreq -F eval $REQID` if [ $nat -gt 0 ] # nat is >0 if an attempt was made then ACCFILE=/usr/vsifax/fax.
-
INSTALLATION AND ADMINISTRATION GUIDE SENDTIME="$4" NOTIFY="$5" GRPID="$6" NUM_MEMS="$7" NUM_SENT="$8" NUM_FAIL="$9" shift USER_GNP="$9" # ------------------------------------------------------# generate a status log for the entire group, and write to file "$VSIFAX/bin/vfxstat" g-$GRPID > /tmp/GroupFax.log echo "------------------------- --------------------" >> /tmp/GroupFax.log echo " " >> /tmp/GroupFax.log "$VSIFAX/bin/vfxolog" -t gse=$GRPID >> /tmp/GroupFax.
-
EVENT NOTIFY PROCEDURES $1 is the Numerical Process ID (PID) of the scheduler. Tip If the sys-start script exits with a non-zero exit code, the server will shut down. This allows you to make special checks and ensure that the server will not run unless your criteria are met. Examples for Unix and Linux platforms The following sample scripts run on Unix and Linux platforms only (not on Windows platforms). Below is a sample start Tcl script (sys-start.
-
INSTALLATION AND ADMINISTRATION GUIDE #--------------------------------------------------# # Update log file puts $f "The fax scheduler was stopped" # Email notification to specified mail address catch { [ exec "$VSIFAX/lbin/vmime -t \ -o$VSIFAX/spool/temp/stopwarn \ $VSIFAX/spool/logs/sys-stop.log" ] } catch { [ exec "$VSIFAX/lbin/vmail" "$EMAIL" \ "$VSIFAX/spool/temp/stopwarn" ] } # exit 0 Below is a sample stop shell script (sys-stop.sh) that sends an email message to anon@example.
-
EVENT NOTIFY PROCEDURES puts $f "$TIMESTAMP $ERROR" close $f #------------------------------------------------------# Create email file #------------------------------------------------------set g [ open $VSIFAX\\spool\\temp\\sysstart w+ ] puts $g "$TIMESTAMP $ERROR" close $g #------------------------------------------------------# Email notification to specified mail address #------------------------------------------------------exec "$VSIFAX\\lbin\\vmime" -t -s $ERROR "$VSIFAX\\spool\\temp\\sysstart" | \
-
INSTALLATION AND ADMINISTRATION GUIDE These arguments are passed to sys-devfail : $1 Device name. $2 Reason for the failure. Example for Unix and Linux platforms The following samples run on Unix and Linux platforms only (not on Windows platforms). Below is a sample device fail Tcl script (sys-devfail.tcl) that automatically re-enables any failed device and records the incident to a log file: # Tcl script that runs when a fax device has failed.
-
EVENT NOTIFY PROCEDURES set set set set set set DEVICE [lindex $argv 0] REASON [lindex $argv 1] VSIFAX $env(VSIFAX) TIMESTAMP [ clock format [ clock seconds ] -format {%Y/%m/%d %H:%M:%S} ] ERROR "Device $DEVICE failed: $REASON" EMAIL email@address.
-
INSTALLATION AND ADMINISTRATION GUIDE EOF $VSIFAX/lbin/vmail Example for Windows platforms The script below runs on Windows platforms only (not on Unix and Linux platforms). This sample is called when modifying a user profile setting. It logs the modification in %VSIFAX%/spool/logs/usrschg and sends a notification email to an administrator. #-------------------------------------------------------# sys-usrchg.
-
EVENT NOTIFY PROCEDURES Notification Message User Database Tag Receive notification vtp Routed notification rtp Successful send notification sto Failed send notification stn Group send notification stg 123
-
-
LDAP Setup and Configuration LDAP Setup and Configuration VSI-FAX supports the use of Lightweight Directory Access Protocol (LDAP) directories to retrieve fax recipient (i.e., to) information when sending faxes by placing files in the autosend directory. However, before you can send a fax using LDAP data, you must configure various VSI-FAX settings that control how to connect to the LDAP server and map the information in the LDAP directory so VSI-FAX knows where to find certain essential fax information (e.
-
INSTALLATION AND ADMINISTRATION GUIDE Note The attributes shown in this example are common to most LDAP directories. Attribute names (dn, cn, givenName, etc.) are loosely defined in various RFCs. Although attribute names are defined in RFCs, the standard is very informal. Therefore, each LDAP server may use slightly different attribute names to store data. One of the setup tasks for using an LDAP directory with VSI-FAX will be to map certain essential LDAP attributes (e.g.
-
LDAP SETUP AND CONFIGURATION Subtree: allows the search to descend into any branches that exist below the starting point. Authentication Most LDAP servers allow anonymous read-only access. If an LDAP server requires authentication, your distinguished name (dn) and password can be specified in the Directory Properties User ID and Password fields, respectively. See also See Modifying LDAP directory settings for additional information.
-
INSTALLATION AND ADMINISTRATION GUIDE Important The only required attribute mappings are First name, Last name, and either Fax (number) or Email (address). The first two allow you to locate a specific recipient; either of the remaining two are used to actually send the fax. The remaining mappings are supplied for your convenience; that information will appear on your fax cover pages. 17. Click Finish, and the New External Directory Wizard closes.
-
LDAP SETUP AND CONFIGURATION Modifying LDAP directory settings LDAP directory configuration settings and attribute name mappings can be modified via the directory properties sheet. 1. From VSI-FAX Server Administration, select the Directories\External node. A list of available external directories appears in the list pane. 2. Select the LDAP directory node and choose Action > Properties or right mouse click and select Properties. The external directory properties dialog box appears. 3. Make your changes.
-
-
Least Cost Routing Least Cost Routing Least Cost Routing (LCR) provides an economical way of sending faxes to the fax server closest to the ultimate destination. When a fax is submitted, the system looks in the LCR rules file to find a fax destination that handles faxes for a specific area code and/or country. If no match is found, the fax is sent locally. The LCR function consists of two tables: an LCR rules file and an LCR routes file.
-
INSTALLATION AND ADMINISTRATION GUIDE Each server in the LCR Cluster must be identified with a route name. To do this you must edit the $VSIFAX/lib/vsisrv.ini file and add the name of the server. This name can either be the hostname for the server or a descriptive city/location name. Edit the file by making the following entry in the vsisrv.ini file: [LCR] route-name=NewYork Launch Notify Procedure (LNP) The LNP is a VSI-FAX script when a fax is queued to the system but before it is transmitted.
-
LEAST COST ROUTING LCR rules file The LCR rules file (lcrrules.lst) is used to associate a country code and area code to a route name and is located in the vsifax/lib directory. The following is an example of an LCR rules file. # Sample LCR rules file # # : # # US rules (by area code) # [1]212???????:NewYork 019*:LondonUK In the first entry of the previous example, the presence of a digit between brackets [ ] indicates that the digit is optional.
-
INSTALLATION AND ADMINISTRATION GUIDE Configuring the email-to-fax gateway 1. Edit the $VSIFAX/lib/vsisrv.ini file and add the entries to the [VPOPD] section for the POP3 mail server account. 2. Add a password using the vfxadminconfig command. For syntax see the vsisrv.ini password entry is encrypted, therefore it cannot be directly added via a text editor. You must use the vfxadmin command line utility to add this entry.. 3.
-
LEAST COST ROUTING Tag Definition lcr route fax fhn from hostname thn to hostname tsq to sequence number fsq from sequence number The lcr tag determines whether a fax should be considered a candidate for being routed. It can also be used to override the LCR rules and send a fax locally.
-
-
Imaging Server Setup and Configuration Imaging Server Setup and Configuration An imaging server provides extended imaging services for a Unix/Linux fax server. If you have both a Unix/Linux fax server and a Windows fax server on the same network, you can configure them such that the Windows fax server images the additional file types, not normally available on Unix/Linux, for the Unix/Linux fax server.
-
INSTALLATION AND ADMINISTRATION GUIDE There are two config entries which control this behavior, both are in the $VSIFAX/lib/vsisrv.ini file, in the VSINET section: image-server = Hostname or IP address of the image server. Default is no image server is defined. image-server-delay = The number of seconds between pings of the image server if it is detected to be down. Default is 60 seconds.
-
Server Maintenance Server Maintenance After the installation of a fax server and during its normal use, system resources will be allocated for the various storage and log operations. Over time, the allocation of resources can cause problems such as poor performance, running out of disk space, and data corruption. In conjunction with normal system maintenance, we recommend periodic maintenance on the fax server to ensure smooth and efficient operation.
-
INSTALLATION AND ADMINISTRATION GUIDE Sample scripts for maintaining databases and files Scripts can be used nightly, weekly, or once per month depending on the number of faxes being sent and received by your fax server. These scripts are intended for use on Unix servers or with the MKS Toolkit. Tip If you are running VSI-FAX on a Windows server without the MKS Toolkit, the scripts can be modified to run correctly by changing each $VSIFAX to %VSIFAX%. Important These scripts are examples.
-
SERVER MAINTENANCE Important note Regardless of the platform you are using, you must make sure that the VSI-FAX user has enough rights to access the above directories. If this user is unable to read or write files in these directories, the VSIFAX scheduler will not be able to run. Debug log files Debug files are created each time the scheduler is restarted. These files are self-maintaining, and they will not become unreasonably large if the scheduler is restarted periodically.
-
-
Integration Fundamentals Integration Fundamentals When most people consider integrating VSI-FAX with another application, they usually want to add one or more of the following capabilities to their existing business application: Send a fax : Use VSI-FAX to send faxes directly from another application. Receive a fax : Use VSI-FAX to receive faxes, then hand them to another application for processing. Administration : Implement programmatic control and maintenance of the VSI-FAX server.
-
INSTALLATION AND ADMINISTRATION GUIDE Creating the fax envelope There are two basic underlying methods for creating a fax envelope: vfx tags XML-F It is important to understand that all VSI-FAX integration techniques build on one of these two basic methods. vfx tags vfx tags are the most common way to define a fax envelope. These tags are nothing more than name/value pairs that are passed to the fax server. Let's consider a simple fax envelope; a local fax number (555-1212) and a simple text file (hello.
-
INTEGRATION FUNDAMENTALS Integration techniques When you combine a specific way of creating a fax envelope with a specific delivery mechanism, you have a complete fax integration technique. This figure shows the ways a fax envelope can be created and the delivery mechanisms available for each: Send integration techniques Another way to look at integration solutions is to consider a matrix that lists ways to create fax envelopes as rows and delivery mechanisms are columns.
-
INSTALLATION AND ADMINISTRATION GUIDE Delivery Mechanisms vfx Comman d autosen d Director y Email -toFax xmlf Comman d Fax SD K Outloo k Fax Client LanFax Window s Client WordPerfe ct Macros lp Spoole r X X X X Documen t Email Message X C++ X Visual Basic X Print to Fax X X Each way of creating a fax envelope and each delivery mechanism will be discussed in greater detail elsewhere in the documentation.
-
INTEGRATION FUNDAMENTALS Ways to create fax envelopes Tags Use the vfx -t option to supply a series of tag statements (=) on the vfx command line. This normally requires that some sort of macro or script be run from inside your application. Tag files Create an ASCII text file containing tag statements (=), then pass this "tag file" to the fax server using the vfx -c command. Tag files are processed as if the tag statements were entered directly in a command shell.
-
INSTALLATION AND ADMINISTRATION GUIDE You are limited to creating fax envelopes with tag files, batch files or XML-F. This is a "blind send." Therefore: Fax status and notifications are not available If errors occur, your fax won't be sent and you will not receive any notification whatsoever that this occurred Ways to create fax envelopes Tag files Create an ASCII text file containing tag statements, then copy or move this "tag file" to the fax server autosend directory ($VSIFAX/autosend).
-
INTEGRATION FUNDAMENTALS If you will be including tag or batch files in the body of your email message, see Using vfx Tags. Print-to-fax Print-to-fax is versatile way to either deliver a fax envelope to the fax server or prepare a fax envelope so that it can be delivered by another means. While this integration technique is hard to fully automate, it can be used to fax-enable virtually any application with printing capabilities.
-
INSTALLATION AND ADMINISTRATION GUIDE See also Using XML-F Software Development Kit (SDK) The VSI Software Development Kit (SDK) provides Component Object Model (COM) classes and sample code that can be used by software developers to integrate fax functionality into Windows applications. These applications can be written using Microsoft Visual Basic 6.0 or Microsoft Visual C++ 6.0 and will run on supported Windows platforms. Note With VSI-FAX 5.0, API development has moved to C/C++.
-
INTEGRATION FUNDAMENTALS Fax number Name of the file you want to fax See also lp Spooler (Unix Only).
-
-
Customization Techniques Customization Techniques This section describes ways to customize VSI-FAX. Customizing the fax header Note This section does not apply to the Fax on Demand (or FoDC) device. To learn how to customize the page headers of faxes sent using FoDC, please refer to Customizing the header in outgoing faxes, in the Fax on Demand Connector section. Fax header places information at the top of each faxed page in what would normally be the blank top margin.
-
INSTALLATION AND ADMINISTRATION GUIDE See Customizing notification email messages for additional information about customizing notification email messages. File structure and syntax Template files can be plain ASCII text, PostScript, or PCL files. They typically contain a mixture of plain text and tags. When the fax server processes a template file, it populates any tags it finds in the template file with either the current value for the tag or default value defined in the template file.
-
CUSTOMIZATION TECHNIQUES Customizing email transport (routing) messages When the fax server routes a fax to a user's email inbox, it does so by creating a short email message and including the fax as a TIFF file attachment. The default email transport message shows the sender as VSI-FAX server. The subject line shows the total number of pages in the fax and the originating fax number (i.e., TSI string).
-
-
Troubleshooting Troubleshooting This section describes common problems that you may encounter while installing, configuring or using VSI-FAX. If you do not find your problem described in this section, try to identify it before you contact Esker for help.
-
INSTALLATION AND ADMINISTRATION GUIDE These log files are incremented each time the scheduler is restarted. For example, these files may be used if you are dialing but the faxes fail. You can then put the scheduler in debug mode, try to re-send the fax, and view the default fax log (i.e.,fax1). When you no longer need debug on, edit the $VSIFAX/lib/vsisrv.ini file and change the Debug= setting to off.
-
TROUBLESHOOTING The /cdrom directory is the mount point for the mount command. This error message will occur if the /cdrom directory does not exist. Use the Unix mkdir command to create the directory and try the mount command again. An alternate mount point could be the /mnt directory which should exist. Installation errors Problem With a Dialogic Diva Server fax board (formerly Eicon fax board), all lines can submit, but only one line can receive.
-
INSTALLATION AND ADMINISTRATION GUIDE One of the scheduler's Unix server processes may have stopped servicing requests. Stop and restart the fax scheduler to resolve this problem. vfxsched restart Communications and modem problems Problem Permissions on the port keep changing. Solution This is due to another process attempting to use the port, and this causes failures as the two programs contend for access to the device.
-
TROUBLESHOOTING This could be a compatibility issue with the sending fax machine and the fax modem's firmware. Try isolating the problem to a specific fax machine, which may then require an upgrade of the modem's firmware. Problem Log files display time-out errors even though the full document was received at the remote site. Solution The fax modem will attempt to send the same page up to a total of three times.
-
INSTALLATION AND ADMINISTRATION GUIDE ATE1 This enables echo responses from the modem. The modem should return OK. ATZ This is the modem reset command. The modem should return OK. AT&F&W This is the modem load factory defaults and write to the profile command. The modem should return OK. AT+FCLASS=? This is the modem command to query the supported fax classes. The modem will return 2 for Class 2 support, Class 2.0 for Class 2.0 support and 1 for Class 1 support.
-
TROUBLESHOOTING mimeXXXXXaa.txt: contains information for the SMTP protocol: From, subject, content... mimeXXXXXaa.adr: contains the recipient email address Below is a sample mimeXXXXaa.txt of a fax status notification: From: doc@example.com Subject: VSI-FAX job 1151: status NORMAL Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="PART-BOUNDARY.vsifax.boundary.vsifax" --PART-BOUNDARY.vsifax.boundary.
-
INSTALLATION AND ADMINISTRATION GUIDE Comments: This email submission was successful. Here is the detail of the communication: 1. We can successfully connect to the SMTP server as we get the "220 mail-test.esker.fr..." message. 2. Then, the mail server provides some information in answer to the EHLO command 3. We send the MAIL from command with the sender name specified in the $VSIFAX/lib/vsisrv.ini file and this sender is accepted by the mail server (Sender ok) 4.
-
TROUBLESHOOTING No inbound fax notification for some faxes Problem : When routing the inbound faxes as pdf files (fmt-pdf value for the rfm tag), the conversion from .tif to .pdf can fail for some specific inbound faxes with low resolution. When this conversion fails, no email is sent to the user and the inbound fax does not reach the mail box of the user. In VSI-FAX version 6.0 and on, the received .tif files are pre-processed before being converted to .pdf in order to avoid conversion errors.
-
INSTALLATION AND ADMINISTRATION GUIDE Formatter errors Problem PostScript documents will not fax. Solution The PostScript language is highly standardized, but there is enough deviation from the norm that compatibility problems still arise. The first test is always to send the document to a real PostScript printer. If the document fails to print there, the VSI-FAX PostScript formatter will normally not process it properly.
-
TROUBLESHOOTING pcltotif This application converts PCL or ASCII files into TIFF files. eptotif This application converts Epson format files into TIFF files. gstotif This application converts PDF and PostScript level 1 and 2 files into TIFF files. The following example shows a method of using the conversion application directly to image the input file rather than submitting the input file from the vfx command line or from one of the other fax submittal methods in VSI-FAX. The example filename file.
-
-
Using vfx Tags Using vfx Tags This section discusses using vfx tags to fax-enable your existing business applications. Tags are always three-character mnemonics for the function they accomplish. For example, the tfn tag is used to define the fax number, the tgf tag is used to define a tag file, etc. The vfx command line The easiest way to use tags is to include them with a vfx command by using the -t option. For example, to fax a text file (hello.
-
INSTALLATION AND ADMINISTRATION GUIDE Tag Description fls Server file attachment fnm Custom from name fpg TIFF file attachment page range fpl File attachment page size frs File attachment send resolution ftp File attachment type fvl Local overlay fvn From voice number fvs Server overlay gal Group name gnp Group notify procedure grp Group file icc Internal CC with cover page lcr Allow least cost routing lnd Sent fax page orientation lnp Launch notify procedure mad From ema
-
USING VFX TAGS Tag Description tvn To voice number udf User defaults Issue the following command in the command shell to obtain the compelete list of valid envelope tags: vfx -help tags Tag files Tag files are ASCII text files that contain one vfx tag per line. For example, you could fax the same message as the previous example by saving this information to tag file hello.tag: tfn=555-1212 fll=hello.
-
INSTALLATION AND ADMINISTRATION GUIDE Tag Description fll Local file attachment fls Server file attachment All subsequent file-specific information is assumed to be for that recipient until the next file inclusion tag is encountered. Let's extend our previous example even further by including more than one file and sending this identical fax to more than one recipient. cvr=classic sub=Sample Hello World Fax fll=hello.txt fvl=hello.
-
USING VFX TAGS Tip You are not limited to using End of File (EOF) character strings to define your "here" documents. You can use any character sequence you like, provided that it does not contain spaces and is not used in the body of your "here" document. In fact, you will need to use a different character sequence if your "here" document contains an EOF statement within it.
-
-
Embedded commands Embedded commands You can embed vfx commands in ASCII text, PCL, or PostScript files, then pipe or redirect them to the vfx command as standard input (STDIN). These embedded commands are processed as if you had entered them directly on the command line.
-
INSTALLATION AND ADMINISTRATION GUIDE ax={i|cm}; ay={i|cm}] Where (ax,ay) are absolute coordinates and (x,y) are relative coordinates. If the coordinates are followed by an i, the coordinates are in inches. If the coordinates are followed by a cm, the coordinates are in centimeters. Otherwise, the coordinates are in pixels.
-
EMBEDDED COMMANDS Capabilities and limitations The @+IMAGE and @+INCLUDE embedded commands must be all uppercase. The remainder of the embedded image statement (e.g., file name, position coordinates, options, etc.) is case-insensitive. The @+IMAGE and @+INCLUDE statements can only include single-page TIFF image files. Multi-page TIFF files are not supported, and only the first page will be processed.
-
INSTALLATION AND ADMINISTRATION GUIDE The @+VFX statement must be all uppercase. However, the tag/value statements are case-insensitive. The entire embedded tag sequence must be continuous-it cannot contain any spaces or explicit line breaks (hard returns). If you need to include a space in a tag value, use the tilde (~) character. Any tilde (~) character encountered is replaced by a space unless it is escaped (\~). You can only embed vfx tags that store fax envelope See The fax envelope information.
-
EMBEDDED COMMANDS vfx < sample.txt more sample.txt | vfx $ cat sample.txt | vfx C:\> type sample.txt | vfx Note The first two commands work on any platform, the third command works on Unix/Linux, and the fourth command works on Windows.
-
-
Print-to-fax Print-to-fax Print-to-fax is a versatile way to either deliver a fax envelope to the fax server or prepare a fax envelope so that it can be delivered by other means. You can use the print-to-fax features of VSI-FAX to send faxes from any application where the Print option is available (Microsoft Word, Microsoft Works, Microsoft Excel, Word Perfect, StarOffice, etc.). There are two primary ways to send faxes from any application with print-to-fax: Use one of the VSI-FAX print drivers.
-
INSTALLATION AND ADMINISTRATION GUIDE 1. A document is printed on the VSI-FAX Client printer (VSI-FAX LanFax Windows Client, VSI-FAX Mailmerge Client or VSI-FAX Outlook Client printers). 2. A pcl file is generated by the printer in a temporary directory. The default location of this directory depends on the operating system: • On Windows XP: C:\Documents and Settings\\Local Settings\Temp\ • On Windows Vista: C:\Users\\AppData\Local\Temp\ Where is the current Windows user.
-
PRINT-TO-FAX We strongly recommend that you use the default port parameters.
-
INSTALLATION AND ADMINISTRATION GUIDE The table below contains the port parameters that are set by default for the VSI-FAX Server printer: Field name Default value for the VSI-FAX Server printer Directory C:\Program Files\VSI-FAX\FaxServer\spool\temp File Name currentpcl Extension pcl Application "C:\Program Files\VSI-FAX\FaxServer\lbin\vfxpostprint.
-
PRINT-TO-FAX Terminal Service considerations When troubleshooting print-to-fax issues in a Terminal Service environment, you must remember the following facts: We recommend that you install the latest version of the LanFax client on Terminal Service servers. By default, in Terminal Service servers, the currentpcl.pcl is generated in the C:\Documents and Settings\\Local Settings\Temp\\ folder. This behavior is correctly handled by the vfxptof process.
-
-
Email-to-fax Email-to-fax Email-to-fax is a delivery mechanism ideally suited to remote fax integration because it does not require a direct network connection to the fax server, nor access to the fax server file system. A network connection from the fax server to an incoming (POP3) Internet mail server is necessary, and your application must have emailing capability. Configuration and setup The email to fax feature is normally setup during VSI-FAX installation.
-
INSTALLATION AND ADMINISTRATION GUIDE If you are Modifying vsisrv.ini 2. Do this Go to the VPOPD section and add the host name, domain name or IP address of your incoming (POP3) Internet mail server to the host-name= entry. Enter the name of the POP3 user account you created in step 1. If you are 3. Do this Using the MMC snap-in Go to the Fax Server Email Gateway properties and enter the user name in the User name field. Modifying vsisrv.
-
EMAIL-TO-FAX Refer to Tag files and Batch files for additional information about how to define a fax envelope using these techniques. Message attachments For non-tag email coming in via POP3 or VSMTPD, the first attachment (the body of the email) is scanned for any @+VFX[] lines, and any tags found are added to the job. The rest of the attachment is processed normally.
-
-
SMTP Authentication SMTP Authentication Simple Mail Transfer Protocol (SMTP) is a protocol for sending email messages between servers. VSI-FAX supports the authentication required by some mail servers to receive submitted email messages. Note Because of the specialized authentication MSN uses, it is not supported as an ISP. The following parameters, which support the use of email authentication within VSI-FAX, can be set in $VSIFAX/lib/vsisrv.ini file, [VMAIL]section.
-
INSTALLATION AND ADMINISTRATION GUIDE 9. Enter test:hello when prompted for the auth-rsp and when prompted to re-enter the auth-rsp. 10. Send an email message from VSI-FAX with either of these two commands: • vfx -n • vfx -n -O -C classic 11. If the email message is not received, you can troubleshoot the problem with the following steps: 12. Set debug to On in $VSIFAX/lib/vsisrv.ini file, [VFXSCHED] section. 13. Set debug to 2 in $VSIFAX/lib/vsisrv.
-
SMTP AUTHENTICATION Command Sent to the mail server Answer from the mail server . //a "." Character followed by enter mlarks the end of the body 250-2.0.0 Message accepted for delivery Quit 221-2.0.0 mail.domain.ext closing connection Connection closed by foreign host.
-
-
Advanced Group Faxing Advanced Group Faxing You can send the same fax to a group of recipients using one of our fax clients. You can also do modest amounts of group faxing directly from the vfx command line. However, if you need to send faxes to large groups, send personalized faxes tailored to each recipient or re-use your group faxes, consider one or more of the advanced techniques described in this section.
-
INSTALLATION AND ADMINISTRATION GUIDE Fax Merge Important The Fax Merge feature is designed to be used by integrators. It is not recommended for desktop faxing. Desktop users should use the VSI-FAX Mailmerge client instead. Fax merge is a special kind of print-to-fax operation that uses your word processor's mail merge feature to send individualized faxes to a group of recipients. Refer to Print-to-fax for more information.
-
ADVANCED GROUP FAXING Word form List files content @+TAG[tfn=<>] Name, Location, FaxNumber @+TAG[cvr=classic] Smith, London, 5551212 ---------Page Break ---------- Jones, New York, 5551213 Hello Mr. <> Do you still live in <> Notice that the example form file contains an embedded fax number (@+TAG [tfn=«FaxNumber»]) and an embedded cover page designation (@+TAG [cvr=classic]), followed by a page break.
-
INSTALLATION AND ADMINISTRATION GUIDE If you printed your word processor output to a PCL file, you can pass that file to the fax server using various delivery mechanisms (e.g., vfx commands, autosend, etc.). Two tags are required: tfn="faxmerge" fll="my_attachment.pcl" Where my_attachment.pcl is the mail merge PCL file created by the print driver.
-
ADVANCED GROUP FAXING tnm="Mr. Smith" fll=hello.txt @+END tfn=5551213 tnm="Mr. Jones" fll=goodbye.txt @+END Common entries always appear at the beginning of the file and continue thru the @+COMMON entry. These two entries (fnm=MyName and fco=MyCompany) define the sender's name and company, respectively. A common section is optional. The rest of our sample batch file contains two recipient sections, one for Mr. Smith and one for Mr. Jones.
-
INSTALLATION AND ADMINISTRATION GUIDE Group Files Often, when you are sending a group fax, your recipient information is actually stored in some sort of database. Most databases support some sort of data export to a neutral file format, typically some form of "delimited ASCII." The VSI-FAX group mechanism allows you to pass these delimited ASCII files to the fax server. The fax server will use recipient information in the file to send the group fax.
-
ADVANCED GROUP FAXING Sincerely, ${fnm:VSI-FAX} To send these files to the fax server, enter: > vfx -g groups.txt -t fll=confirm.txt -t fcv=tags This is how each person's fax will look: Dear Smith, A fax was sent to 5551212 concerning your recent order. Sincerely, VSI-FAX Dear Jones, A fax was sent to 5551213 concerning your recent order. Sincerely, VSI-FAX Notice that the actual names and fax numbers were used from the group file. Notice also that because the group file did not specify a subject (i.e.
-
-
VSI-FAX MailMerge Client VSI-FAX MailMerge Client uses the Microsoft Mail Merge function to create and send faxes. The client is made up of a several components: A VSI-FAX MailMerge Client printer that is used to send the faxes to VSI-FAX. A simple program that is used to submit the jobs to the VSI-FAX Server A Microsoft Word document (.doc) and template (.dot). The document and template are the same; they are both provided so you can use whichever one is most common in your environment.
-
INSTALLATION AND ADMINISTRATION GUIDE 2. When creating the document, you must insert the Work Phone field in your document and in your recipients list. This is the fax number to send the document to. The sample document and the XLS file contain the Work Phone field. 3. Use the Mail Merge Wizard to create and send the final documents. If the Mail Merge wizard is not displayed: • In Word XP or 2003, select Tools > Letters and Mailing > Mail Merge.
-
VSI-FAX MAILMERGE CLIENT During this final step, the desktop will be busy, making other processing somewhat slower.
-
-
Forms Overlay Forms Overlay You can specify forms to be overlaid onto selected pages of the resultant fax file. Form files may be of any type. More than one overlay file can be specified. A form file is specified using the tag ovl= or ovs=, depending on whether the overlay form is local or on the server. An optional page range can be specified, which will indicate on which pages of the resultant fax file the form is to be overlaid.
-
INSTALLATION AND ADMINISTRATION GUIDE The result.tif output file is created by entering the following on a single line: vtifftool overlay -E fine -o result.tif form1.tif:2 target.tif:2,4-7 Notice that page 2 of form1.tif has been overlaid onto pages 2, 4, 5, 6, and 7 of target.tif to produce the result.tif output file When this file is faxed, the fax will appear as if the form overlay and the text overlay are one a single image. Multiple overlays To perform multiple overlays from both forms1.
-
FORMS OVERLAY Selective merging Under certain circumstances, you may need to extract selected pages from one received fax file and merge them with a second file to create a new output file that can then be faxed from VSI-FAX. In this instance you would use the merge option of the vtifftool utility, which will allow you to select specific pages from multiple files and merge them into a single document. This example begins with three multi-page files, file1.tif (page F1), file2.tif (page F2) and file3.
-
INSTALLATION AND ADMINISTRATION GUIDE You may need to make small positioning adjustments to the text before it overlays exactly onto your imaged form. You can do this with either PCL (Hewlett Packard LaserJet) or PostScript (Level 1) codes that use both horizontal and vertical positioning. The final step is to remove the fax header that was added to each page during transmission. To do this: 1. Log in as root or vsifax and set the VSI-FAX environment.
-
FORMS OVERLAY Note By default, all received faxes will be stored in user vsifax's inbox ($VSIFAX/faxq/vsifax) in TIFF file format. 3. Open the received TIFF file and measure the x and y coordinates of the upper-left corner of the logo or signature, as well as the image area width and height. 4. Create a faxable signature or logo file using the vtifftool cut command. For example, to create a faxable logo file (logo.
-
-
Virtual Fax Server Virtual Fax Server The virtual fax server is a remote vfx command line client. It includes all the functionality of a full fax server except that you cannot connect fax devices to it or send faxes directly from it. You must connect your virtual fax server to a full fax server, via a network, to complete your integration.
-
INSTALLATION AND ADMINISTRATION GUIDE Note If you are using a WAN, make sure that any gateways or firewalls allow port 2996 to pass through. See also Refer to Sending a test fax to a fax machine for virtual fax server installation instructions. Configuring the Virtual Fax Server To use the VFS software you must install the VFS software and provide its IP address or DNS Name on the full server. Check that the full server license supports Virtual Fax Server.
-
lp Spooler (Unix Only) lp Spooler (Unix Only) The vfx command is modeled after the Unix lp spooler command. The similarities between the two allow you to submit a fax as easily as printing a document. Integration is accomplished by using an lp-compatible printer interface script. All Unix and Linux operating systems, with the exception of IBM AIX, support ASCII text printer interface scripts. IBM AIX systems use a database architecture that requires their printer interface scripts to be compiled.
-
INSTALLATION AND ADMINISTRATION GUIDE lp merge faxing The second method is the lp merge faxing method, which allows you to create a mail merge text stream to personalize information to send to multiple destinations. You can use this script to overlay forms onto selected pages of documents, such as purchase orders or quotes. lp faxing sample interface script This sample interface script replaces the default script used by the fax printer destination.
-
LP SPOOLER (UNIX ONLY) Tag Description fco Sender's company fvn Sender's voice number sub Coversheet subject line limited to a maximum of 63 characters To utilize embedded commands, include them within the text data stream at the appropriate points within the pages. See also Refer to Tag files and Batch files. The power of lp spooler integration is the ability to specify which pages go to which recipients and create multiple fax requests when necessary.
-
-
Using XML-F Using XML-F Note With VSI-FAX 5.0, API development has moved to C/C++. This change will not affect your current SDK development. Java, Visual Basic, XML-F, C and C++ continue to be supported in version 5.1 and on. The C/C++ Client API Reference in c_api.pdf in the \docs folder of the VSI-FAX CD-ROM. Extensible Markup Language (XML) comprises various Data Type Definitions (DTDs). Each DTD is a set of tags for describing a particular collection of data.
-
INSTALLATION AND ADMINISTRATION GUIDE -t {html | text | xml} Response format. The name of the XML file you are sending to the server. The name of a file you want to add. Notes When entering a URL, the following format is required: [transport://] [:port number] Where: transport: vxmld. Name of the fax server. port number Port number that the fax server uses to send faxes.
-
USING XML-F Element Description content The content element contains zero or more body elements. Body elements must contain a filename attribute and may specify associated content-type (RFC 2046) and content-transfer-encoding (base64 or none). application reference An application-reference tag is defined to permit the submitting application to provide an arbitrary application-specific reference to this fax request.
-
INSTALLATION AND ADMINISTRATION GUIDE Good Looking XML... Some people are destined to discover that when they get to the end of time, there they are. VGhpcyB3YXMgYmFzZTY0IGVuY29kZWQgPGludmFsaWQ+PC9pbnZhbGlkPg== PAGE 223
USING XML-F The application can either use the application-reference or the service-reference when referring to this request. This permits the submitting application to issue status requests without having to wait or process a fax-submit-response document prior to asking for status. In the event the fax-submit-response is never received, the application must use the application-reference to get information on the request.
-
INSTALLATION AND ADMINISTRATION GUIDE Fax-cancel document The fax-cancel document is used by a sending application to cancel a previously submitted fax request. This is a sample fax cancel document: Filmore5455 David Filmore filmore@esker.
-
Inbound and Outbound Fax Filter Inbound and Outbound Fax Filter VSI-FAX uses a file called rejects.lst to screen incoming and outgoing faxes. This can be useful as a spam filter for incoming faxes, automatically terminating any call having a pre-listed Transmitting Subscriber ID (TSI) or Caller ID (ANI). Outbound call rejection is based on dialstring. Note ANI rejection is predicated on the ability to collect ANI information, currently available with Dialogic Brooktrout fax boards.
-
-
Font handling Font handling Although most PostScript-generating applications are not dependent on the resolution of the output device, some of these applications will perform better if aware of the output resolution. Since fine fax resolution of 200 x 200 dpi is lower than the typical laser printer's resolution of 300 x 300 dpi or 600 x 600 dpi, some documents will look different when printed by different devices. If your application offers a choice of resolutions, select 200 x 200 dots per inch.
-
INSTALLATION AND ADMINISTRATION GUIDE Typeface Stroke Style Typeface Stroke Style (4148) Medium Bold Bold Italic (4148) Regular Italic Medium Italic Bold Regular Bold Italic CG-Omega (4113) Medium Medium Bold Bold Regular Garamond Italic (4197) Regular Italic Medium Medium Bold Bold Albertus (4362) Bold Regular Coronet Extra Bold Regular (4116) Marigold (4297) Medium Regular Clarindon Condensed Bold (4140) Symbol (16686) Medium Regular Wingdings (31402) Medium Regular Arial (16602)
-
FONT HANDLING ZapfDingbatsTimes Roman Proportional 229
-
-
Ordering DID Service Ordering DID Service To order DID Service in the United States: Determine what your DID requirements are and how many simultaneous calls you are going to support. How many phone numbers will you need to reserve? The minimum block of phone numbers offered by most major regional DID service providers is 20. How many simultaneous inbound calls do you want to support? This will determine the number of DID trunk lines you need to order.
-
INSTALLATION AND ADMINISTRATION GUIDE support from one to sixteen individual DID trunk lines. Some models also come with an out-dial transfer port that allows you to connect a standard dial line for outbound dialing using the same modem.
-
Roxbury fonts Roxbury fonts VSI-FAX provides a mechanism for using and managing the Roxbury family of fonts. VSI-FAX provides the following Roxbury fonts: Roxbury pica (regular) 10 cpi Roxbury bold 10 cpi Roxbury italic 10 cpi Roxbury italic bold 10 cpi Roxbury compressed 16.7 cpi These are fixed-width bit-mapped fonts designed to look good at either standard or fine resolution. These fonts are used in the following places: eptotif uses them to image text files. pcltotif uses them for text mode conversion.
-
INSTALLATION AND ADMINISTRATION GUIDE See also Refer to Command Reference in the Reference Addendum documentation for additional information about the font compiler. The compiled PCL soft-fonts files are located in the $VSIFAX/lib/fxpcl directory: roxypica.sft Roxbury pica soft-font roxybold.sft Roxbury bold soft-font roxyital.sft Roxbury italic soft-font roxybdit.sft Roxbury italic bold soft-font roxycomp.
-
Sample Unix and Linux Mount Commands These CD-ROM mount commands are only examples. Your command arguments may be different depending on the file systems you have installed. In particular, if the /cdrom mount point does not exist, use /mnt in place of /cdrom in these examples. Consult your system administrator for the appropriate command to use for your installation.
-
-
Fax Server Information Form See the Annotated fax server information form for detailed information about filling out this form.
-
INSTALLATION AND ADMINISTRATION GUIDE Licensing Information Is port 2996 dedicated to VSI-FAX? 238
