System Administrator's Guide |
![]() |
||||||||||||||
Installing Automatically with a Script | |||||||||||||||
The Perl script that automatically installs Zelerate AllCommerce is configure.pl. At this time, configure.pl works with the MySQL database (running locally) and with the Apache Web Server. If you are not using MySQL as your database for AllCommerce, you will need to install and configure AllCommerce manually. See Installing Manually. Executing the Script If you are ready to run configure.pl and begin the installation process, you will need to be in the os_allcommerce directory. From a shell prompt, type: ./configure.plto execute the script and begin the installation process. The Installation Process configure.pl performs several dependency checks; it then allows you to perform a step-by-step installation of Zelerate AllCommerce. The configure.pl script makes sure that the prerequisites are installed and working properly. Checking for Perl and Perl Modules This step will perform a check to see if Perl is installed and will check to see if the libraries needed for cookieless shopping are present. ##### # # Zelerate AllCommerce Version 1.0.4 # ##### Welcome to the Install Script for Zelerate AllCommerce. This script will guide you through the installation process. Do you wish to continue with this installation? (y/n) ##### # # Perl Setup # ##### Checking Perl version ... using Version 5.00503 ... ok. libwww-perl and other needed libraries from CPAN are not installed for cookieless shopping, please refer to the install notes for more details.If you are missing Perl or the needed Perl library for cookieless shopping, a message is displayed on the screen explaining which is missing. For more information on the prerequisites needed to run AllCommerce, see Preparing for Installation. Checking for DBI and DBD Drivers This step performs a check to make sure that DBI (including the needed DBD drivers) are installed and working properly. ##### # # DBI Queries # ##### Checking for available DBI drivers ... done. Listing each DBI driver with recognized data sources (databases) ... Driver: mysql (1)Data Source is DBI:mysql:mysql (2)Data Source is DBI:mysql:testIf DBI and DBD are installed and working properly, you will see a list of data sources that can be used with AllCommerce. Checking for the Correct Database This step allows you to create a new database table or use an existing database. If you have multiple databases installed, AllCommerce prompts you to select the appropriate data driver for use with AllCommerce. ##### # # Database Driver # ##### Which database driver will you be using? [mysql]If you are using MySQL as your database, press the return key. If you are using one of the other stable supported databases, enter the name of the data driver and press return. ##### # # Database Table Setup # ##### Do you wish to create a new database table? (y/n)Type [y] to Continue and create a new database table. See Create New Database Table. Type [n] to Continue and use an existing database table. See section Use Existing Database Table). Create New Database Table This step will walk you through the creation of a new database table for use with AllCommerce. Default values are shown in brackets. Which database driver will you be using? [mysql]This step is asking for the name of the database driver you are using for AllCommerce. For example, if you are using MySQL as your database driver, you would enter mysql. What is the name of the database? [osallcommerce]This step is asking for the name of the database table you wish to create to use with AllCommerce. Suppose you are setting up a store to sell shoes; you may want to call the database table shoes or even bigfeet. What is the database username? [root]This step is asking for the database account user name. If you have not set up an account for the database user in MySQL, the default user will be root. What is the database password? []This step is asking for the database account user name's password. If you have not set up a password for the database user in MySQL, the default password for the database user should be left empty. What is the database servername? []This step is asking for the server name of the machine which is hosting your database. This machine can be either a separate server or the same server on which you have AllCommerce installed. If you are running AllCommerce and the database server on the same machine, this setting can either left blank or set to localhost. What is the database port? [3306]This step is asking for the communications port is used to communicate with the database server. In the case of MySQL, if you are using a separate database server, the default communications port should be 3306. Use Existing Database Table This step will walk you through the recreation of a new database table for use with AllCommerce. Do you wish to recreate the database (i.e. drop and create) (y/n)?Type [y] to Continue and select an existing database table. Type [n] to abort the installation. Driver: mysql (1) Data Source is DBI:mysql:mysql (2) Data Source is DBI:mysql:osallcommerce (3) Data Source is DBI:mysql:test Which database ( e.g. 2 for (2) ) do you want to recreate?This step is asking for the number of the database that you wish to drop and have recreated. Use the number that is listed next to the name you desire. What is the username? [root]This step is asking for the database account user name. If you have not set up an account for the database user in MySQL, the default user will be root. What is the password? []This step is asking for the database account user name's password. If you have not set up a password for the database user in MySQL, the default password for the database user should be left empty. What is the servername? [localhost]This step is asking for the server name of the machine which is hosting your database. This machine can be either a separate server or the same server on which you have AllCommerce installed. If you are running AllCommerce and the database server on the same machine, this setting can either be left blank or set to localhost. What is the port? [3306]This step is asking for the communications port which is used to communicate with the database server. In the case of MySQL, if you are using a separate database server, the default communications port should be 3306. Are you sure you want to recreate the database osallcommerce (recreating the database will destroy any existing information in the database)? (y/n)Type [y] to continue the installation. Type [n] to abort the installation. Attention! If you answer "y" to this step, all data in the database you are recreating will be dropped and overwritten and all information stored in this table will be lost. Setting up the AllCommerce Data Structure A data structure for AllCommerce will need to be imported into the database table that you have just created. If the database table was created successfully, this step will create the AllCommerce data structure without any prompting. ##### # # AllCommerce Data Structure # ##### Creating tables ... done.If this step was not automated or displayed error messages, please refer to database creation in a manual installation (section 2.4.2.2). Configuring a Web Server A Web server will need to be configured for use with AllCommerce. At this time, configure.pl only supports the Apache Web server. Apache Virtual Host This section will walk you through the configuration of a Virtual Host for the Apache Web server. Attention! Due to the variations of Apache and SSL, you may need to edit your httpd.conf file in order for the system to work properly. The Apache configuration part of this configure script can be bypassed at the appropriate prompt, if necessary (this allows AllCommerce to be run with other Web servers). ##### # # Apache Virtual Host Setup # ##### Do you want to add virtual host entries into your Apache httpd.conf (httpsd.conf) file? (y/n)Type [n] to skip automated configuration of the Apache Web Server and go to section 2.3.2.4 (AllCommerce Configuration Files). Type [y] to continue with the configuration of the Apache Web Server. Please give the directory where your Apache file is located.This step is asking for the directory in which your Apache Web server keeps the configuration files on your server. In a default Apache installation, this will be either /etc/httpd/conf or /usr/local/httpd. Will you be running ssl? (y/n)If you wish to run AllCommerce through a secure Web server, so user information is encrypted, you will want to enable ssl. This setting is used in various areas of AllCommerce which run in a secure mode. ServerName?This is the server name for the virtual host which you are configuring. Remember, this server name must either have a DNS record or an entry in your /etc/hosts file for Apache to work properly. Server Name Example: www.mydomain.com Port?This is the port the Apache Web server uses to communicate. The default port for the Apache Web server is 80. Server Admin?This is an email address the Web Server can contact if a problem occurs. Document Root?This Document Root setting should be set to the directory which holds your AllCommerce file tree. In the case of a default AllCommerce installation, this will be /home/httpd/os_allcommerce. Error Log?The Error Log is the error log file name. Transfer Log?The Transfer Log is the transfer (access) log file name. cgi-bin Directory?The cgi-bin Directory should be set to the directory that contains your AllCommerce cgi-bin scripts. In the case of a default AllCommerce installation, this will be /home/httpd/os_allcommerce/cgi-bin. configure.pl will now show you a preview of the entry it wishes to make in the httpd.conf or httpsd.conf file. Write this output to Apache httpd (httpsd) conf file? [n]Type [n] to skip saving the configuration for your Apache Web Server. Type [y] to continue and save the configuration for your Apache Web server. AllCommerce Configuration Files AllCommerce has three configuration files that need to be configured in order to run the product. These configuration files contain almost all of the business rules for your site. The three configuration files which are set up with configure.pl are: site.conf, machine.conf, and database.conf. These files are opened automatically and will prompt you for the answers to various configuration parameters. ##### # # Configuration Files Setup # ##### Configuration file settings ... Initial Data Load An initial data load needs to be primed into AllCommerce in order for the platform to take on its personality as a commerce application. The initial data load is performed automatically if the database was created successfully and the import of the AllCommerce data structure was completed. ##### # # Initial Data Load # ##### Adding initial data load ... done.If this step was not automated or displayed error messages, see Importing the Initial Data Load in a Manual Installation. Shipping Methods and Rates Data Load The shipping methods and rates data load allows you to use the download information from United Parcel Service (UPS), the U.S. Postal Service (USPS), and Federal Express (FedEx) to calculate shipping costs for a customer transaction. Using information that you download from the shippers you want to use, this step translates these files into SQL insert statements that can be imported into your database. ##### # # Shipping Tables Data Load # ##### Running import_shipping_tables.pl ... done. Adding shipping entries (This may take a few minutes) ... No shipping entries to add.If this step was not automated or displayed error messages, please refer to "shipping methods and rates data load in a manual installation" (section 2.4.2.6). Successful Automatic Installation After configure.pl has been successfully executed, you should be able to proceed to login to the AllCommerce admin screen and start creating your site. https://sitename.sitedomain/cgi-bin/om/admin/login.cgi username: admin password: allcommerce Using configure.pl Options configure.pl also has several command-line options that can be used while invoking the script, as: ./configure.pl help Attention! If no keyword is provided after the script name, the entire installation process above is invoked. The options supported in configure.pl are included in the table below:
|
|||||||||||||||
|
|||||||||||||||
All Commerce User's Guide Table of Contents |