• Installing the Software

    The pkgadd installable datastreams making up the Non-Stop Open Source E-Commerce package are not yet available. Availability will be announced on the Skunkware Announce mailing list.

    This software should be installed and maintained by someone with a good background in UNIX®, and who is aware of current technical issues in network security, web server administration, Perl script maintenance, and database management. That is, this is a highly sophisticated set of very powerful software packages intended for use on a UNIX® server and, as such, may require sophisticated technical setup and maintenance.

    That being said, we have tried to simplify the process as much as possible. Please let us know where and how the installation, configuration and maintenance of this package can be further improved. Please read the extensive documentation for the various components you wish to deploy. We have provided links to the documentation for each component.

    The installation of all the components will require approximately 250 Megabytes of free space on the root partition (/usr/local).

    After mounting the CD (mount -r -f cdfs /dev/cdrom/c1b0t0l0 /mnt), run the command (as root):

        # /mnt/INSTALL
    
    The INSTALL script will allow you to select from a menu of "software sets". The INSTALL script acts as a front-end for a non-interactive installation using the Software Manager (pkgadd).

    NOTE: A full installation will require approximately 250 Megabytes of disk space.

    To install an individual package, execute the command:

        # pkgadd -d /mnt Package
    
    where "Package" is the name of the desired component and /mnt is the mount point of the CDROM. If the CDROM is not mounted, execute the command:
        # pkgadd -d /dev/cdrom/cdrom1 Package
    
    See the file /mount-point/CONTENTS for the list of available components.

  • Configuring your system for use with the Non-Stop Open Source E-Commerce Pack

    After completing the installation of the components you desire, you may wish to add /usr/local/bin to your PATH and /usr/local/man to your MANPATH. You may also wish to add /usr/local/java to your CLASSPATH. It should not be necessary to add /usr/local/lib to your LD_LIBRARY_PATH as the shared libraries have been built with the appropriate flags.

    Once installed, you will need to decide which system services to enable. This release includes the following daemons which can be enabled:

    • Enhydra - Java/XML application server
    • MiniVend - shopping cart application
    • MySQL - database engine
    • PostgreSQL - database engine
    • eEMU - event management utility
    • Webmin - web based system administration interface
    • Squid - caching proxy server
    • Apache - web server

    All of the E-Commerce configurations in this software bundle utilize the Apache web server so this should be enabled as follows:

        # /etc/apache enable
        # /etc/apache start
    

    Decide which database back-end, if any, you wish to use. Included in this release are MySQL and PostgreSQL. A comparison of the two is available. You may decide to run both. Enable and start the database engine as follows:

    • MySQL
          # /etc/mysqlrc enable
          # /etc/mysqlrc start
      
    • PostgreSQL
          # /etc/pgsqlrc enable
          # /etc/pgsqlrc start
      

    Next decide which shopping cart application you wish to deploy. We have included two excellent Internet Commerce applications - Enhydra and MiniVend. A third, OpenMerchant, is available from the SCO Skunkware web site. Enable and start the shopping cart application as follows:

    • Enhydra
          # /etc/enhydra enable
          # /etc/enhydra start
      
    • MiniVend
          # /etc/mvendrc enable
          # /etc/mvendrc start
      

    You may also wish to enable and start the Squid caching proxy server. To do so, issue the commands:

        # /etc/squidrc enable
        # /etc/squidrc start
    

    Once these services are enabled and started, you should be able to view your demonstration shopping cart.

  • Removing the software

    All of the software can be removed by issuing the command:

        # /mount-point/REMOVE
    
    where mount-point indicates the directory on which the CDROM is mounted. Individual components can be removed with the command:
        # pkgrm Component
    
    where Component is the individual component name.

    A list of all installed components can be retrieved with:

        # pkginfo -c skunkware
    

    Note that the MiniVend and PostgreSQL users (minivend and postgres) will not be removed as part of the package removal. To delete these users and their associated groups (minivend and postgres) from the system, use the userdel and groupdel commands.