---------------------------------------------------------------------
 

                TRK Billing Customer Management Software   


   Software Version: 2.2
---------------------------------------------------------------------

TRK Billing is commercial software, only users who have purchased a valid license through TRK Billing.com can use this product.

----------------------------------------------------------------------

To install TRK Billing you must have the following perl modules installed 
 
  * CGI  (usually installed as standard)
  * DBI / DBD::MySQL
  * Digest::MD5
  * Text::CSV
  * Net::SSLeay

Please see the bottom of this file for information on installing Perl
Modules.


----------------------------------------------------------------------
Installation
----------------------------------------------------------------------

1. Upload all the TRK Billing files, chmodding all .cgi files to 755 and
   the .tpl files to 777 (only if you want to edit the templates via
   the admin panel)

   The TRK Billing files are split into two directories in the compressed file
  
       cgi-bin and images
   
   You may need to upload the contents of the cgi-bin to the cgi-bin folder
   on your web server.

   The images folder will need to be uploaded outside the cgi-bin due to 
   permissions.
               


2. Temporarily set the permission of the include/lib folder to 777.

                       chmod include/lib 777



3. Create a MySQL Database for TRK Billing, there is no need to populate
   the database with tables as the install script does this for you.
 
   The information needed for the TRK Billing installation is:

       Database Name
       Database Username
       Database Password

         
4. Run the install.cgi from your web browser and set all the server 
   variables and database access settings.

5. Now you can restore the original permission on the include/lib 
   folder.


6. To automate TRK Billing's invoice creation/reminder you need to setup 
   a cron job to run nightly. To do this just add the file below to 
   cron.

                        include/auto_cron.cgi


7. TRK Billing should be installed! Run the admin and begin familiarising 
   yourself with the new software.

                Administration Login: 
 
                   Username: admin
                   Password: demo

   It is highly recommended that you change the admin password after 
   logging in!


8. You MUST use a .htaccess in the include/lib folder to prevent 
   browsing - Please create a .htaccess file in this folder containing
   the following:


    - - - - - - - - - - - - - - -   

       <Limit GET POST>
           order allow,deny
           deny from all
       </Limit>

    - - - - - - - - - - - - - - -       



9. Optional usage of the third party server software integration:

   If you would like to utilize the integration of software such as 
   cPanel - you must follow the additional setup procedures below:

     a) Open up the conf.cgi and enable the setting you wish by changing
        the value to 1.
     b) Then login to the administration area and go to settings, you 
        should be able to view the options for your integrated software.
     c) Simply setup the settings and you should be ready.


 

----------------------------------------------------------------------
Setting up Incoming E-mail
----------------------------------------------------------------------

1. Install the Perl module MIME::Tools

2. Open up the include/lib/email.cgi and edit the path to the include
   folder.

3. You must setup your mail software (e.g. sendmail) so that emails
   sent to the address(es) of your choice are piped through to 
   email.cgi

4. If you are using SENDMAIL you must edit your /etc/aliases file, and
   add a line similar to the following:

             support: "|/path/to/TRK Billing/email.cgi"
  
   Repeat that line for each address you want TRK Billing to control.

   If you are using EXIM, pico /etc/valiases/domain you will need to
   add the following line:

            support@domain.com: |/path/to/TRK Billing/email.cgi

   As with sendmail, repeat that line for each address you want
   TRK Billing to manage. 

5. BEFORE starting to use your email addresses, you need to log in to
   the admin section of TRK Billing and go to 'Settings > Incoming Email'
   you need to assign each address you would like to use.



INSTALLING PERL MODULES
---------------------------------------------------------------------

To install Perl modules at system level you will likely need root 
access to your web server.

- METHOD 1

To install a Perl module from the command line, simple type the command 
below - this example would install the module Crypt::RC4

              perl -MCPAN -e 'install Crypt::RC4'

- METHOD 2

Step A) Download the tar.gz file from search.cpan.org after locating
        the module needed

Step B) Untar the file by typing 'tar zxvf filename'

Step C) Run the installation, first 'cd' to the installation directory
        and run the following steps:
   
           perl Makefile.pl 
           make
           make test
           make install

The above would install the module in the root Perl lib directory, if you
would like to install it elsewhere or don't have access to install it at 
root level simply specify the directory by using the PREFIX option when
running the makefile, example below:

          perl Makefile.pl PREFIX=/home/perl/my_module

If modules are installed in a directory other than the root perl installation
you will need to tell TRK Billing where to look for the modules. To do this, open
the files listed below and insert the line:

use lib '/home/perl/my_modules';

In the following files:

./client.cgi
./admin.cgi
./kb.cgi
./staff.cgi
./include/auto_cron.cgi






              
