SoftSlate Commerce - Java Shopping Cart - Upload and Deploy SoftSlate Commerce

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

Upload and Deploy SoftSlate Commerce

The following example describes in detail how to deploy SoftSlate Commerce on a Linux server running Tomcat. The steps are largely the same for Windows. For other Java application servers, please refer to their documentation for how to install a Web application on their platform.

Example 1.3. Deploying SoftSlate Commerce with Tomcat on Linux

You may either use the softslate-standard-x.x.x.tar.gz file or the softslate-standard-x.x.x.war file to install SoftSlate Commerce on Linux. (For Windows, consider using the .zip file.) In the first case, you will unpack the application manually. In the second case, you can place the .war file in Tomcat's webapps directory and it will unpack the application.

	Note
	For technical reasons, SoftSlate Commerce will not install correctly on BEA WebLogic when using the `.war` file.

Deploying Using the .tar.gz File.

If you are using the .tar.gz file, change into the directory you wish to install SoftSlate Commerce in, and copy the .tar.gz file there. This must be a directory served by Tomcat. For this example, we'll assume we are installing the application in the /usr/local/jakarta-tomcat/webapps directory.
```
[root@server root]# cd /usr/local/jakarta-tomcat/webapps
[root@server webapps]# cp /root/softslate-standard-1.0.5.tar.gz .
							
```
Untar the .tar.gz file. A directory named softslate should appear with the contents of the application.
```
[root@server webapps]# tar -zxf softslate-standard-1.0.5.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. If necessary, use chown and chmod to give the Tomcat user permission.


[root@server webapps]# chown <anyuser>.tomcat softslate/WEB-INF/conf/keys
[root@server webapps]# chown <anyuser>.tomcat softslate/WEB-INF/classes/appSettings.properties
[root@server webapps]# chmod g+w softslate/WEB-INF/conf/keys
[root@server webapps]# chmod g+w softslate/WEB-INF/classes/appSettings.properties

Start the SoftSlate Commerce Web Application. With Tomcat you can use the Manager application to run the start command. For example, if you deployed SoftSlate Commerce under the /softslate context and you have Tomcat running on port 8080, you would use the following URL to start the application:
http://<yourhostname>:8080/manager/start?path=/softslate

Deploying Using the .war File.

If you are using the .war file, first change the name of the .war file to the name you'd like the application to run under. For example if you'd like the application to use the context /softslate, change the name of the .war file to softslate.war.
```
[root@server root]# mv softslate-standard-1.0.5.war softslate.war
							
```
Change into the directory you wish to install SoftSlate Commerce in, and copy the .war file there. This must be a directory served by Tomcat and configured to automatically deploy .war files. For this example, we'll assume we are installing the application in the /usr/local/jakarta-tomcat/webapps directory.
```
[root@server root]# cd /usr/local/jakarta-tomcat/webapps
[root@server webapps]# cp /root/softslate.war .
							
```
Tomcat should automatically unpack and deploy the application, and a directory named softslate should appear. (The directory name will correspond to whatever name you gave to the .war file.)
Since Tomcat has deployed the application, there is no need to adjust the permissions or ownership.

Prev	Up	Next
Create an Empty Database	Home	Run the SoftSlate Commerce Installer