NAME

INSTALL - How to install Business::Shipping

NOTES

Getting Started

Be sure to read the ``GETTING STARTED'' section of the README, because some services (e.g. online rate requests) require that the user signup for a username and password.

Forcing installation

As of Sept 16, 2004, the following CPAN modules in Bundle::Business::Shipping did not pass their own tests on the author's system:

Even so, they seem to work fine after installation, but CPAN will not install them unless the ``force'' command prefix is used.

Forcing version 2.x of Class::MethodMaker

Class::MethodMaker::Engine is used as a prerequisite because it forces CPAN to retreive version 2.x of Class::MethodMaker.

Choosing your bundle

If you are planning on using all of the shipping methods, install Bundle::Business::Shipping. However, if you would only like to install the required modules for one shipper, you can select it individually:

CPAN INSTALLATION

All shippers:

 perl -MCPAN -e 'force install DBD::CSV XML::DOM'
 perl -MCPAN -e 'install Bundle::Business::Shipping'

UPS_Online only:

 perl -MCPAN -e 'force install XML::DOM'
 perl -MCPAN -e 'install Bundle::Business::Shipping::UPS_Offline'

UPS_Offline only:

 perl -MCPAN -e 'force install DBD::CSV'
 perl -MCPAN -e 'install Bundle::Business::Shipping::UPS_Offline'

USPS_Online only:

 perl -MCPAN -e 'force install XML::DOM'
 perl -MCPAN -e 'install Bundle::Business::Shipping::USPS_Online'

MANUAL INSTALLATION

Be sure to install all required modules before installing. After unpacking the tarball, execute this command:

 perl Makefile.PL && make && make test && make install

Or, expressed as separate commands:

 perl Makefile.PL
 make
 make test
 make install

All required modules

Each Bundle lists the required modules for each shipper type. Here is the combined list:

 Bundle::DBD::CSV (any)
 Business::Shipping::DataFiles (any)
 Cache::FileCache (any)
 Class::MethodMaker::Engine (any)
 Clone (any)
 Config::IniFiles (any)
 Crypt::SSLeay (any)
 Getopt::Mixed (any)
 Log::Log4perl (any)
 LWP::UserAgent (any)
 Math::BaseCnv (any)
 Scalar::Util (1.10)
 XML::DOM (any)
 XML::Simple (2.05)