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-enterprise-x.x.x.zip file or the
softslate-enterprise-x.x.x.war file to install
SoftSlate Commerce. 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]](images/note.png) | Note |
|---|---|
For technical reasons, SoftSlate Commerce will not install correctly on BEA
WebLogic when using the |
Deploying Using the .zip File.
If you are using the
.zipfile, change into the directory you wish to install SoftSlate Commerce in, and copy the.zipfile there. This must be a directory served by Tomcat. For this example, we'll assume we are installing the application in the/usr/local/apache-tomcat/webappsdirectory.[root@server root]# cd /usr/local/apache-tomcat/webapps [root@server webapps]# cp /root/softslate-enterprise-x.x.x.zip .
Unzip the
.zipfile. A directory namedsoftslateshould appear with the contents of the application.[root@server webapps]# gunzip softslate-enterprise-x.x.x.zip
For the Installer tool to run successfully, the owner of the Tomcat process must have writable access to the
/WEB-INF/conf/keysdirectory, the/WEB-INF/classes/appSettings.propertiesfile, and the/WEB-INF/classes/hibernate.propertiesfile. 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]# chown <anyuser>.tomcat softslate/WEB-INF/classes/hibernate.properties [root@server webapps]# chmod g+w softslate/WEB-INF/conf/keys [root@server webapps]# chmod g+w softslate/WEB-INF/classes/appSettings.properties [root@server webapps]# chmod g+w softslate/WEB-INF/classes/hibernate.propertiesStart 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
/softslatecontext 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
.warfile, 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.warfile tosoftslate.war.[root@server root]# mv softslate-enterprise-x.x.x.war softslate.war
Change into the directory you wish to install SoftSlate Commerce in, and copy the
.warfile there. This must be a directory served by Tomcat and configured to automatically deploy.warfiles. For this example, we'll assume we are installing the application in the/usr/local/apache-tomcat/webappsdirectory.[root@server root]# cd /usr/local/apache-tomcat/webapps [root@server webapps]# cp /root/softslate.war .
Tomcat should automatically unpack and deploy the application, and a directory named
softslateshould appear. (The directory name will correspond to whatever name you gave to the.warfile.)Since Tomcat has deployed the application, there is no need to adjust the permissions or ownership.