SoftSlate Commerce - Java Shopping Cart - Installation Procedure for Ensim Servers

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
	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

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

	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.

Log on to the server through ssh.

Change to the Tomcat site policies configuration directory:


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

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;
									
```
Log in to Ensim's Appliance Administrator control panel.
Click on the "Site Manager" link and find the site you are installing SoftSlate Commerce on.
Click the pencil icon next to the site name.
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.
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".

Create an Empty Database for SoftSlate Commerce.

Log in to Ensim's Appliance Administrator control panel.
Click on the "Site Manager" link and find the site you are installing SoftSlate Commerce on.
Click the pencil icon next to the site name.
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.
Click "Save" to record your changes.
Navigate back to the "Site Manager" list.
Click on the name of the site you are setting up, and click yes to become the Site Administrator.
From the Site Administrator control panel, click on Services.
Click on the pencil icon next to MySQL.
Click on the "Create Database" link.
Create a database with "softslate" as the suffix. E.g. www_sitename_com_-_softslate .
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.

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

	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.

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]# 
									
```
Log in to Ensim's Appliance Administrator control panel.
Navigate to "Services" and click on the pencil icon next to MySQL
Click the link to "MySQL Administration Tool"
Log into MySQL with the root username and password.
In phpMyAdmin, select mysql under the "Databases..." menu.
Click on the link to the user table.
Click on the "Insert" tab to add a record to the user table.
For Host use the hostname of your server from step 1.
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.)
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.
Leave all the radio buttons marked as "N" for No.
Click the Go button at the bottom of the page to add the record.
Navigate back to the Ensim control panel home, and go back to the "Services" menu.
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

Add Mappings to the Site's Apache Configuration.

	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.

Log on to the server through ssh.
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
									
```

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>

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.)

Restart Apache for the new configuration to take effect:


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

Upload and Unpack SoftSlate Commerce.

Upload the SoftSlate Commerce .tar.gz file to the server.
Log on to the server through ssh.
Change into the Site's html directory, and copy the .tar.gz file there. (Replace "site15" with the Site ID of the site you are setting up.)
```
[root@server root]# cd /home/virtual/site15/fst/var/www/html/
[root@server html]# cp /root/softslate-enterprise-x.x.x.tar.gz .
									
```

Untar the .tar.gz file:


[root@server html]# tar -zxf softslate-enterprise-x.x.x.tar.gz

For the Installer tool to run successfully, the owner of the Tomcat process must have writable access to the /WEB-INF/conf/keys directory and the /WEB-INF/classes/appSettings.properties file. Use chown and chmod to give the tomcat4 user permission. (Replace "admin15" with the Site ID of the site you are setting up.)


[root@server html]# chown admin15.tomcat4 softslate/WEB-INF/conf/keys
[root@server html]# chown admin15.tomcat4 softslate/WEB-INF/classes/appSettings.properties
[root@server html]# chown admin15.tomcat4 softslate/WEB-INF/classes/hibernate.properties
[root@server html]# chmod g+w softslate/WEB-INF/conf/keys
[root@server html]# chmod g+w softslate/WEB-INF/classes/appSettings.properties
[root@server html]# chmod g+w softslate/WEB-INF/classes/hibernate.properties

Run the SoftSlate Commerce Installer.

SoftSlate Commerce - User Guide
Prev	Chapter 1. Installing SoftSlate Commerce	Next

Prev	Up	Next
Provisioning SoftSlate Commerce with Tomcat on RedHat Linux	Home	Chapter 2. Getting Started