SoftSlate Commerce
Home » Get Support » Documentation » HTML Documentation

Installation Procedure for Ensim Servers

The following steps are provided if you need to install SoftSlate Commerce on a server running Ensim. These instructions were tested specifically on a server running Ensim Pro for Linux, version 4.0. It may work for other versions as well.

[Warning]Warning

As of this writing, version 2.x of SoftSlate Commerce has not been tested on Ensim. The following documentation was taken from the installation steps for 1.x. It should apply to version 2.x, but there are no guarantees.

Example 1.4. Installing SoftSlate Commerce on an Ensim Server

  1. Provision the Tomcat Service for the Site You're Setting Up. 

    [Note]Note

    You must set up the site .policy.custom file before provisioning Tomcat for the site. Otherwise, the site's .policy.custom file will not take effect.

    1. Log on to the server through ssh.

    2. Change to the Tomcat site policies configuration directory:

      
      [root@server root]# cd /var/tomcat4/conf/sites.policies.d
      									

    3. Create a file in this directory named site15.policy.custom , whose contents are the following. (Replace "site15" with the Site ID of the site you are setting up.)

      
      permission java.security.AllPermission;
      									

    4. Log in to Ensim's Appliance Administrator control panel.

    5. Click on the "Site Manager" link and find the site you are installing SoftSlate Commerce on.

    6. Click the pencil icon next to the site name.

    7. The site must have Tomcat 4 provisioned for it. If it is not already checked, mark the checkbox next to Tomcat 4, which is under the "Web Server" heading.

    8. Tomcat 4 will not be assigned to the site if its "Security Level" is set to "High". If the security level is set to "High", you must change it to "3.1 Compatibility".

  2. Create an Empty Database for SoftSlate Commerce. 

    1. Log in to Ensim's Appliance Administrator control panel.

    2. Click on the "Site Manager" link and find the site you are installing SoftSlate Commerce on.

    3. Click the pencil icon next to the site name.

    4. The site must have at least one available MySQL database. Under the "Database Server" heading, make sure the checkbox next to "MySQL" is checked and that the site has at least one database.

    5. Click "Save" to record your changes.

    6. Navigate back to the "Site Manager" list.

    7. Click on the name of the site you are setting up, and click yes to become the Site Administrator.

    8. From the Site Administrator control panel, click on Services.

    9. Click on the pencil icon next to MySQL.

    10. Click on the "Create Database" link.

    11. Create a database with "softslate" as the suffix. E.g. www_sitename_com_-_softslate .

    12. If you have made a change to the site's database password, you may need to log back into Ensim's Appliance Administrator control panel and restart MySQL from the Services menu for the changes to take effect.

  3. In MySQL, Associate the Database User with the Proper Host. 

    [Note]Note

    On some servers, this step may not be necessary. If SoftSlate Commerce's Installer is having trouble making a connection to the database, you may need to perform these steps. MySQL must have an entry in the user table that associates the user of the site's database with the host name of your server. In some cases, this is taken care of when you set up a site.

    1. Log on to the server through ssh and look up the hostname of your server by running the hostname command:

      
      [root@server root]# hostname
      server.domainname.com
      [root@server root]# 
      									

    2. Log in to Ensim's Appliance Administrator control panel.

    3. Navigate to "Services" and click on the pencil icon next to MySQL

    4. Click the link to "MySQL Administration Tool"

    5. Log into MySQL with the root username and password.

    6. In phpMyAdmin, select mysql under the "Databases..." menu.

    7. Click on the link to the user table.

    8. Click on the "Insert" tab to add a record to the user table.

    9. For Host use the hostname of your server from step 1.

    10. For User use the MySQL user corresponding to the site you are setting up. (Click on the Browse tab if you need to find it.)

    11. For Password, select "PASSWORD" in the drop down menu under the Function column. Enter in the user's password for database access in the Password field.

    12. Leave all the radio buttons marked as "N" for No.

    13. Click the Go button at the bottom of the page to add the record.

    14. Navigate back to the Ensim control panel home, and go back to the "Services" menu.

    15. Click the restart icon next to MySQL to restart the database and load your changes.

    Alternatively, you may add the user record through the MySQL command line administration interface, and restart MySQL from the command line:

    
    [root@server root]# mysql -u root -p
    Enter password: 
    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Your MySQL connection id is 978 to server version: 3.23.58
    
    Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
    
    mysql> use mysql;
    Reading table information for completion of table and column names
    You can turn off this feature to get a quicker startup with -A
    
    Database changed
    mysql> insert into user values('server.domainname.com', 'sitedbusername', 
    password('sitedbuserpassword'), 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 
    'N', 'N', 'N', 'N');
    mysql> \q
    Bye
    [root@server root]# /etc/init.d/mysqld restart
    							

  4. Add Mappings to the Site's Apache Configuration. 

    [Note]Note

    By default, Ensim will redirect URL's that match *.jsp to Tomcat to process. Since SoftSlate Commerce uses *.do and /do/* as well, you must add these mappings to the Site's Apache configuration.

    1. Log on to the server through ssh.

    2. Change to the Site's Apache configuration directory. Assuming the Site's ID is 15, change to the following directory:

      
      [root@server root]# cd /etc/httpd/conf/site15
      									

    3. Create a file in this directory named softslate , whose contents are the following. (Replace "site15" with the Site ID of the site you are setting up.)

      
      <Directory /home/virtual/site15/fst/var/www/html/softslate/WEB-INF/>
        AllowOverride None
        Deny from all
      </Directory>
      
      <IfModule mod_jk.c>
        JkMount /*.do  ajp13
        JkMount /softslate/do/*  ajp13
      </IfModule>
      									

    4. Make sure to remove any extraneous files in the directory. (E.g., if you used Emacs, be sure to remove the softslate~ file, if it exists. Apache will attempt to load all the files in the directory.)

    5. Restart Apache for the new configuration to take effect:

      
      [root@server root]# /etc/init.d/httpd restart
      									

  5. Upload and Unpack SoftSlate Commerce. 

  6. Run the SoftSlate Commerce Installer. 

Copyright © 2008 SoftSlate, LLC. All Rights Reserved.

Powered by SoftSlate Commerce

Foraker Design