Installation

Installing prerequisites

Before installing JadaSite, you need to make sure you have the following components installed in your environment.
Please try to use the components that are listed as recommended. Although, different versions or even different make of components can be used, it is always better to stick to the recommended versions to avoid confusion and potential problems.

Database requirement


  • currently tested with MySQL 5.0. Recommended.
  • JadaSite should also works with MySQL 4.1 or up although it is not fully tested.
  • the architecture of JadaSite allows it to run on other Database. For example, Microsoft SQL Server, Oracle, PostgreSQL

Application server


  • extensively tested with Tomcat V5.5 and V6. Recommended.
  • we believe JadaSite works with other version of Tomcat as well. However, it is not 100% verified.
  • the architecture of JadaSite allows it to run on other application server including WebLogic, WebSphere and many more.

Preparing prerequisites

Once all prerequisites are installed, you need to ensure the followings are prepared before installing JadaSite

Database

An empty database needs to be created. Database has to be created with UTF-8 encoding especially when foreign characters are required. For example, when using MySql, database should be created with character set utf8 collate utf8_general_ci.

Once an empty database is created, please keep the following information for later use.


  1. Name of the created database.
  2. DNS or IP address of the machine. If the database is installed on the same machine as the application server, 'localhost' can be used.
  3. Port number of the database instance. If MySQL is used, the default port number is 3306 (unless changed during setup).

Download JadaSite installation file

JadaSite installation file is packaged in a zip file format and can be downloaded in the following location.

http://www.jadasite.com/jada/web/fe/jadasite/English/content/Download+JadaSite

Unzip the distribution file and you will find only one file, jada.war. This file is all you need to deploy JadaSite.


Installing JadaSite

Assuming you are using Tomcat as the application server and the tomcat instance is installed in directory /opt/tomcat, please use the following guideline to deploy jada.war to tomcat. This instruction is for Unix installation only, Windows installation can be performed in similar manner.


  1. /opt/tomcat/shutdown.sh
  2. cp jada.war /opt/tomcat/webapps/jada.war
  3. /opt/tomcat/startup.sh

Note: Depending on how Tomcat is installed, location and name of the directories may be slightly different than above.

Once JadaSite is deployed, please use the following URL to perform on-line configuration.

http://www.mydomain.com/jada/install/process/databaseTestAction.do?process=start

Please enter all the required information as described on the screen. Regarding encryption key, please clicks 'Generate key' to generate a new key automatically. This key is used for encrypting user password and credit card information. Ensure this encryption key is written down and kept in a safe place for future reference.

Once the information is entered correctly, JadaSite installation process will perform the following.

  • Load default data into database.
  • Configuration information is written into file jada.properties located in the application directory. If you are deploying to tomcat located at /opt/tomcat, the file will be created as /opt/tomcat/webapps/jada/jada.properties. Please do not make any changes to this file manually.

Upgrade JadaSite

Upgrade JadaSite is done when there is already an existing database and data in the database has to be retained. Please perform step 1 to 3 as described above (Installing JadaSite).

Once JadaSite is deployed, please use the following URL to perform on-line configuration.

http://www.mydomain.com/jada/install/process/databaseTestAction.do?process=start

Please enter all the required information as described on the screen. Regarding encryption key, please enter previous key that was written down during initial installation. Make sure you are not generating a new encryption key sine the new key will not be able to decrypt existing passwords and credit card information in the system.

Once the information is entered correctly, JadaSite installation process will perform the following.


  • Upgrade database structure to the version deployed.
  • Configuration information is written into file jada.properties located in the application directory. If you are deploying to tomcat located at /opt/tomcat, the file will be created as /opt/tomcat/webapps/jada/jada.properties. Please do not make any changes to this file manually.

Change installation parameters

Sometimes you may need to change installation parameters due to a number of different reasons. One reason may be migrating database from one machine to another machine. Other reasons could be changing working directory or logging directory.

Since JadaSite protects further configuration once it has already been done successfully, configuration screen is disabled when done. In case changes are required again, you can reset the installation configuration to allow for changes via the web interface. Once reset is performed, please proceed as soon as possible to perform the changes and to complete the installation. This is very important to ensure no illegal access to the installation configuration steps. To reset installation configurable, please perform the following procedure.


  1. Sign-in to JadaSite admin console.
  2. Select menu Administration ->Reset Installation.
  3. Clicks Reset.
  4. Sign out from JadaSite admin console.
  5. Perform configuration again via http://www.mydomain.com/jada/install/process/databaseTestAction.do?process=start This configuration will not create database if the same database is used.
  6. Restarts your application server.

Access your installation

To access the administration console, use the following URL. Please remmeber to change the password after your first sign-in.

http://www.mydomain.com/jada/admin/login.do

User Id: admin
Password: admin

To access the home page of the sample site, please use the following URL.

http://www.mydomain.com/jada/web/fe/default/English/home






 Copyright © JadaSite.com, 2008 - 2012. All rights reserved.