NSEP Ping implementation
From HiWiki
PING Discovery: Pilot implementasjon og utforskning av PING -> NSEP Ping implementation If you are a student at NTNU or have access to mobelix.idi.ntnu.no, then you can check out our implementation of the Ping. We have also created a simple test client. When we started working this summer we got our own work folder at /usr/local/ping/. There should be some README files lying around "here and there" which simplifies browsing.
Contents |
How we worked
Hopefully the picture speaks for itself. We found that it was not possible to update directly from the original Ping repository to our repository at mobelix using svn. Hence we had to manually copy any changes from ping.chip.org and commit them to our repository as shown in the picture. Cumbersome? Absolutely... :) Warning: Newer versions of PING/Indivo may not work without modifications on the NSEP version.
Tomcat
It really not much to say about our configuration. We started our own instance as described here. Server.xml was edited to enable SSL, and we used java keytool to create our keystore with a self signed certificate.
The Ping Servlet
To get our modified PING version, check out the following repository from mobelix.idi.ntnu.no (using SVN):
/usr/local/ping/svn/ping/trunk
With TortoiseSVN:
svn+ssh://<username>@mobelix.idi.ntnu.no/usr/local/ping/svn/ping/trunk
In order to get the PingServlet up and running follow the steps from our installation guide.
The Test Client & The Demo Client
To get our test client, check out the following repository from mobelix.idi.ntnu.no (using CVS):
/usr/local/ping/cvsand select the PING client.
There are currently two clients available. On is for testing purposes only (PING-client), the other is a more user friendly demo application with a text-based interface (PING-demo-client). For both clients be sure to have the right libraries in the build path. These libraries are located in the folder lib/ in each project.
How to use The Demo Client
Note: To be able to use the demo you have to be part of the ping UNIX user group on the mobelix server.
1) Start by checking out the demo from the repository as described above. Make sure the libraries are set, and that there are no compilation errors.
2) Next you have to start the PING store server at mobelix. A script to start the store is located at
/usr/local/ping/ping_conf/start_store.sh
Note that you need a dedicated window for this.
3) Next you have to start the Tomcat server. A script for this is located at
/usr/local/ping/tomcat/startup_tomcat.sh
4) Start the Demo Client. Note that the first communication with the servlet can be a bit slow because of the initialization of the server.
5) When you are done playing around, stop the store by aborting the command (Ctrl+c), and stop the Tomcat server with the script
shutdown_tomcat.sh
How to use any of the two clients when a change has been made to the server
If you are working on the source code for the server and have made changes to this you will have to follow the following steps to activate the changes.
1) Commit your changes to the repository from your client.
2) Now you have to update the changes on the server. The source code is located at
/usr/local/ping/ping/
From this location run this command to update from the repository:
svn update
3) You will now have to rebuild the project with the command:
mvn install
Make sure it is a successful build.
4) Next step is to deploy the new library files to the Tomcat server. For this we have made the following script:
/usr/local/ping/tomcat/copy_to_tomcat.sh
The new libraries are now ready for deployment on the Tomcat server. Continue by starting the server as described above.
Logs
There are three different logs available, all called ping.log:
- Client log located in the workspace
- Server log located in /tomcat/target
- Store log located in /ping_conf/target
These give varying information.
