 |
What is Jellingspot Data Server?
Jellingspot Data Server is first and foremost a Java 2 Standard Edition (J2SE) application. However, while it is a J2SE application, it acts more like a Java 2 Enterprise Edition (J2EE) container. What this means is that by itself it performs no noticeable function. Much like the blender in the picture above, without any goodies to put inside, the blender does nothing but make noise and spin; it does not fulfill its nature: to blend drinks, ice cream, misplaced fingers, or other concoctions. It is simply a container waiting for goodies to be put inside of it. Once the goodies have been added, then it can fulfill its god given duty.
How does Jellingspot Data Server work?
In the spirit of “blender-ness,” the server simply needs to have a service dropped into it. In this case, the server requires the addition of a Jellingspot Service Bean (.jsb) (please see the next section for an in-depth discussion of Jellingspot Service Beans). These service beans contain individual and independent services that utilize Bluetooth wireless technology to communicate with local area wireless devices also using Bluetooth wireless technology. For example, the current services for Jellingspot Data Server, the Adpusher and TextBroadcast services, work in this very same manner.
Deployment of Jellingspot Service Beans
To deploy your service beans, you simply drop them into the server's "services" folder, and the sever automatically deploys the services. When a particular service needs to be updated or modified, you can simply copy the new edition of a service into the service folder again and the server will redeploy the updated service.
Server Requirements
Since Jellingspot Data Server is a Java application, it naturally follows that a Java runtime is required for the server to function. In addition, the current version for the Linux platform requires the official Bluetooth stack called BlueZ, which is freely downloadable from sourceforge.net. Once one has installed Linux, with kernel 2.4.22 or better, and installed BlueZ along with the necessary patches for your kernel (you may user an older kernel back to version 2.4.18, but this requires many more patch updates to get BlueZ working properly), and you have installed the Jave runtime (JRE) 1.4 or the Java SDK 1.4 or better, all that will be left to do is install Jellingspot Data Server. You may also read about the system requirements for installing Jellingspot Data Server HERE.
Installing Jellingspot Data Server on Linux
If you have installed all of the previous mentioned requirements, then you simply need to do the following to install Jellingspot Data Server:
Step 1.
Make sure you have set the JAVA_HOME before going any further .. to do so, enter:
export
JAVA_HOME=/path to java dir
Step 2.
Now that the set up is ready, unzip the jdsserver.zip (which you must request
from us) into any folder (we recommend creating a user named "jds" and putting the server into /home/jds -- but it is not necessary)
Step 3.
cd into ../jdsserver/bin -- and then run
startup.sh -- the server will now start.
Step 4.
After the server starts up (5-15 seconds -- depending on hardware), point your browser*** to:
http://localhost:8080/jds/admin
Alternatively, you may access your admin console from any other computer if on the same network by pointing the remote computer's browser to:
http://ip-of-JDS-box:8080/jds/admin
*** Firebird 0.7 has been tested on Linux -- IE 6.0 on Windows (via remote admin) -- results from other browsers may vary.
Step 5.
Once your admin console loads up, you will initially see the "License" screen -- please copy/paste the license key sent to you into this text field and then validate your license key.
Username is always: admin
Please create a password once you validate your license. Should you forget your password, please contact
support@midletsoft.com for information on how to reset your password.
Step 6.
Your sever is now ready to use -- if you click on services, the two provided (TextBroadcast and Adpusher) will be available ... if
your supported
Bluetooth device has been successfully installed, you may immediately begin broadcasting text or graphics to any Jellingspot enabled device.
Quick Review
To quickly review, we now know that Jellingspot Data Server is a
J2SE application that works much like a J2EE container. That services that
run on the Jellingspot Data Server are independent applications called Jellingspot
Service Beans which can be deployed, removed, and redeployed quickly by moving
them in and out of the services folder found with the Jellingspot Data Server
distribution. A structural layer diagram of how Jellingspot Data Server
interacts with an optimized Linux box looks like this:
Copyright Midletsoft, LLC 2001-2004. All rights Reserved.