OpenXData Server Installation Guide for Users

Installation overview

In general, there must be tomcat 5 or later version, java 1.5 or later, mysql, and the bluetooth API for the OpenXData server to be successfully installed. You can also download(check-out) the latest openxdata.war file from http://install.openxdata.org . For security reasons,there is username(guest) and password(guest) for to use.

Its assumed that this page will used by people who have some exposure to linux or any unix platform. Such include system administrators and many more!

Step 1

Manual Non-RPM Method

This is the 'generic' variant that also works with Linux clones that do not support RPM. It does not require administrator rights and allows to install multiple java versions on the same computer.

1. Download the JDK from Sun [1].

2. Click on the "Download" link in the JDK 6 section.

3. Accept the license and continue.

4. Under the "Linux Platform", select "self-extracting file".

5. Download this .bin file and save it to your Linux machine.

6. Once it has been downloaded, switch to the directory where you saved the file. You do not need to be a root and only must have the write access to the folder where you wish to install java. If your administrator is not supportive, you may need to place java into your home folder or even better on some shared network location.

7. Type sh name_of_the_downloaded_file, for instance sh jdk-6u2-linux-i586.bin. There is no need to make this file executable.

8. The license agreement should start appear on the screen. Scroll to the end of it with 'Enter' and type yes.

9. This installer will create its installation in the same folder, where the downloaded file was placed and from where you have started the installation script. But the installed java jre is rather independent and can be easily moved into another place just by copying all its files.

10. You can install multiple different jre's this way: they coexist together and can be used if some software requires the older version to run.

11. The java executable you need to launch is located in a subfolder, called 'bin'. This way of installation will not configure a default 'java' command for you: you must do this manually or always include the full path in your startup script.

-the startup script is called “.bashrc”. So you can edit like this;

open up the terminal, you should be in your the home directory e.g.

# vim .bashrc

Click on the screen again, press the “I” button on your keyboard. This engages the INSERT mode to allow editing.

Locate the cursor, move it to bottom of the file.

type the following

export JAVA_HOME=/path/to/your/jdk1.6.0_11

export PATH=$PATH:$ JAVA_HOME

You can visit http://www.wikihow.com/Install-Java-on-Linux for more options on installing java.

Step2: Mysql Installation

-open the command prompt/ terminal

-login as root

-run these commands

# yum install mysql-server

# yum install mysql-devel

#sh /etc/init.d/mysqld start

To confirm that mysql is installed, run the command below

# mysql -p

FYI: the mysql prompt will come forth

asking for the password. This should mark that mysql has been well installed.

Step3: Tomcat Installation

Download tomcat from http://tomcat.apache.org/download-55.cgi

Currently I have tomcat 5 working fine.

So scroll down to the Binary Distributions section. Under Core, choose tar.gz

Download that compressed file to any directory of your choice. unzip it.

Do that by going to the terminal, locate the folder into which the .tar.gz is downloaded. Then run

tar -zxvpf mytomcatfile.tar.gz

run ls to list the directories as below

ls

a directory whose name like apache-tomcat-5.5.2 depending on the version you chose is found.

-There is need to set the user(s) with permissions to use tomcat manager.

->Open up the command prompt( the root password is not required here), navigate to the directory where tomcat has been extracted

->Make a back-up of the tomcat-users.xml file found in conf folder ,

->replace all the content in that file with

<?xml version='1.0' encoding='utf-8'?><tomcat-users> <role rolename="manager"/> <user username="tomcat" password="tomcat" roles="manager"/></tomcat-users>

->Save the file

->Rename the apache-tomcat-5.5.2 directory to tomcat

->Open the terminal and login as root.

->Move the tomcat folder into the /usr/local/ folder as follows

#mv tomcat /usr/local

Define the catalina home, also called tomcat home. This is done in the start-up script found in your home directory.

-open up the terminal, you should be in your the home directory e.g.

# vim .bashrc

Click on the screen again, press the “I” button on your keyboard. This engages the INSERT mode to allow editing.

Locate the cursor, move it to bottom of the file.

type the following

export CATALINA_HOME=/usr/local/tomcat

export PATH=$PATH: CATALINA_HOME

go back to tomcat directory, and go to the bin directory, we are going to start tomcat.

#cd /usr/local/tomcat/bin

# ./startup.sh

go to your browser like mozilla, konqueror or any. type in http://localhost:8080

the tomcat page should be displayed.

Step 4: Creating a user 'test' with password 'test'

-login as 'root'

-create a new user and password with the following command

CREATE USER 'new_username'@'localhost' IDENTIFIED BY 'password_for_new_username';

-Assign privileges to the new user, enter the command:

GRANT ALL ON *.* TO 'new_username'@'localhost'; 

Step 5: Deploying the openxdata.war file

Go to the page where you loaded tomcat, thats http://localhost:8080

On the left part of this page, click on “Tomcat Manager”. This brings on the login form for tomcat.

Enter the details thats username and password for tomcat, that were defined in the tomcat-users.xml file.

On scrolling towards the botton of the new page, there is a section with the words “WAR file to deploy”. Under that section, click on “Browse” to locate the openxdata.war file from where you downloaded it.

Click on the Deploy button.

You will notice that the openxdata application appears under the Applications' table on the same page.

On the same page, under the same row, click on the “Start” link. The application of omevac should start successfully.

Under the “Running” column, it will turned to “true”.

Eureka, you have successfully installed the openxdata server.

FAQs -Frequently Asked Questions

1-How do I go to the commad prompt/terminal?

Click Applications >> Accessories >> Terminal

2-How do I navigate to another folder/directory?

use cd /path/to/the/folder

e.g # cd Desktop,this should take you to theDesktop folder

3-How do I navigate to the previous folder?

use cd ..

e.g # cd .. , this will take you back to the previous folder or directory