What You'll Need to Run CCVS

To run CCVS, you'll need a modem and a merchant account. You'll also need to follow a few guidelines so that CCVS will run correctly.

Modems

You need at least one modem dedicated to CCVS use. Credit card protocols do not support compression or error correction during modem connects, so compression and error correction cannot be used. We can provide you with information about how to turn off such features on the following modems:

Hayes Optima
US Robotics Courier
US Robotics Sportster
Chase Research PCI-RAS

	Please Note
	Please use a modem or modems from the above list. If you use a non-supported modem (anything besides the four modems listed above), it can be difficult to get the unsupported modem to work with `CCVS`. You should also check the Red Hat Linux Hardware Compatibility Lists at http://www.redhat.com/support/hardware/ to make sure that your modem will work with Red Hat Linux.

If your modem does not appear on this list, look through your modem manual to find the string which turns off all compression and error correction, and the string which resets your modem for normal use. You'll need to provide these two strings when you configure CCVS.

Merchant Accounts

If you're just setting up a merchant account or you're modifying an existing merchant account in order to use CCVS, your merchant account provider may want to see proof that CCVS can work with the protocol it uses. Certification letters for specific protocols are available at http://www.redhat.com/certifications.html. Print all pages of the letter corresponding to the protocol you will be using and show the letter to your merchant account provider.

Your merchant account provider must use one of the protocols supported by CCVS:

First Data Corporation's ETC PLUS protocol (also known as FDR7, ETC+, ETC7, "Omaha")
First Data Corporation's South Platform protocol (also known as "Nabanco")
Global Payment Systems' MAPP protocol (also known as "St. Louis")
Global Payment Systems' NDC protocol (also known as "Atlanta")
Visa International's VITAL protocol (also known as VisaNet, Visa 2nd generation, "K format")
Paymentech's UTF protocol (also known as GENSAR)
NOVA Information Systems protocol

If your merchant account provider uses one of these protocols, you will be able to use CCVS.

Once you've identified which protocol you will be using, review the information applicable to that protocol at http://www.redhat.com/CCVS3.3docs/protocol-specific.html before you start the CCVS configuration process.

Guidelines for Using CCVS On Your System

The following requirements allow CCVS to run smoothly and efficiently. Please make sure you are following all these guidelines before attempting to run CCVS.

Exclusive Use of the Modem(s) While CCVS is Running

Do not run other software applications that need to access the modem while you are running CCVS; they can interfere with CCVS's operations.

Permissions, Privileges and Access to the Modem

Most of the permissions needed for CCVS are set up for you during the installation process through the creation of a special group called ccvs. However, there are issues involving system permissions of which you'll need to be aware.

All operations for a particular CCVS configuration must be performed from a single user account. One account is required so that all file ownerships and permissions are correctly set and protected. This user account must be added to the ccvs group (by you or by your system administrator) before you run the configuration program.

After the user has been added to the ccvs group, run the CCVS configuration program as that user. After you've run the configuration program, the same user must run the CCVS commands for that configuration.

If you want CCVS to run with a modem, the users in the ccvs group must also be added to the uucp group. Membership in the uucp group may not be sufficient for running the modems; if it isn't on your system, be sure that the ccvs group members also have access to the serial port for the modems that CCVS needs to use.

If you're using PHP with CCVS, you'll need to enable the Web server to run CCVS commands. To accomplish this, you must make the Web server user a member of the ccvs group. Usually, the Web server user will also need to be a member of the uucp group.

If you're not using PHP, but you want to enable your Web server to run CCVS, you have other options (e.g., suexec, setuid) besides making the Web server user a member of the ccvs group. You can set it up any way you like, unless you're using PHP.

Software Versions

CCVS requires Tcl version 7.6 or greater to run the included GUI or to use the included Tcl/Tk APIs to develop your own graphical front end. Tcl version 8.0.5 is included in Red Hat Linux 6.2.

CCVS requires Perl version 5.0 or greater to use the included Perl APIs. Perl version 5.00503 is included in Red Hat Linux 6.2.