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:

NotePlease 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 may be very 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 the modem you have to use 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 it to your merchant account provider.

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

If your merchant account provider 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. The CCVS Protocol Guide, available from the link stated, describes the functionalities supported by different protocols.

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'll 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 make your Web server capable of running 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.3 is included in Red Hat Linux 7.0.

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