SoftSlate Commerce
Home » Documentation » HTML Documentation

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

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

Deploying Using the .zip File. 

  1. If you are using the .zip file, change into the directory you wish to install SoftSlate Commerce in, and copy the .zip 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/apache-tomcat/webapps directory.

    
    [root@server root]# cd /usr/local/apache-tomcat/webapps
    [root@server webapps]# cp /root/softslate-enterprise-x.x.x.zip .
    							

  2. Unzip the .zip file. A directory named softslate should appear with the contents of the application.

    
    [root@server webapps]# gunzip softslate-enterprise-x.x.x.zip
    							

  3. For the Installer tool to run successfully, the owner of the Tomcat process must have writable access to the /WEB-INF/conf/keys directory, the /WEB-INF/classes/appSettings.properties file, and the /WEB-INF/classes/hibernate.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]# 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.properties
    							

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

  1. 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-enterprise-x.x.x.war softslate.war
    							

  2. 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/apache-tomcat/webapps directory.

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

Copyright © 2009-2017 SoftSlate, LLC. All Rights Reserved.

Powered by SoftSlate Commerce

Foraker Design