On Premise Deployment in OrangeScape

Pre-Requisites

• Download and Setup a webserver like Apache Tomcat, JBOSS or Glassfish
• Download and Install Java 1.6 and above
• Download and setup your preferred RDBMS Database

Note : Once your web server is set up, make sure it works: In case of Tomcat open your browser and go to http://localhost:8080/

After installing the pre-requisites, below are the steps required to setup a OrangeScape Enterprise environment in Apache Tomcat 

Getting the Application War files

You can download the war of your application from the studio. Go to Deploy Dialog >> select tab amazon web services >> select Download and click on deploy button as shown below

Once it has been deployed you will get below dialog from where you can download the Application war file.

Also, Download the supporting war files (os-commons, runtime, static) from the corresponding latest build releasenotes from the community and rename the war files by removing the release number from static-3.94.war to static.war and similarly to os-commons and runtime.

Changes/steps to make it work in Tomcat

1. Hit the tomcat manager page and you have the option to deploy the war files.

2. Select the supporting war files(os-commons.war, runtime.war, static.war)

3. Open the Application war file and go to location

               app.war\WEB-INF\applicationContext.xml

• search for the property <property name="hibernateProperties"> and add the new below said property 

                                 <property name="dataSource">
                                        <ref bean="myDs"/>

                                  </property>

• search for the line <prop key=”hibernate.connection.datastore”>jdbc/{application-id}</prop> and comment the same 
• UnComment the lines <!-- Datasource Config for Testing/Debugging and change the bean id from testDS to myDS which is same as our datasource property <bean id="testDS" to <bean id="myDS"
• Similarly change the properties as specified 

  <property name="url" value="jdbc:mysql://localhost:3306/<db name>"/> - Change the dbname
  <property name="username" value="root"/> - Provide a db username
  <property name="password" value="root"/> - provide the db password

  Once the above changes are done save the file and deploy the war file into tomcat. You can see the screenshot for reference.

  

  That’s it.  Now, access the url http://localhost:8080/{application-id}/1/signin to log in and start using your application.

  Note : If you login into your database you can see the required tables need for the application gets created automatically.