Intended Audience:
Technical staff of all levels should be able to configure this web application.
Administration experience with Tomcat/MySQL is assumed.
Prerequisites:
Java: JDK 1.5 +
Recommend: /opt/java
App Server: Tomcat 5.5+
Recommend: /opt/tomcat
Database: MySQL5+
Recommend: /opt/mysql
PSL Modules Overview
* SPIN Tools
* ETL
* Leaf
* Query Interface
$ unzip vsl-dist-1.3.4.1-dist.zip
DEPLOY SPIN TOOLS
dist$ chmod +x *.sh
dist$ ./deploy-spin-tools.sh
DEPLOY LEAF NODE
dist $ ./deploy-vsl-leaf.sh
Defaults
peerName = dns of your machine
queryType = VSLQueryAction
className = org.spin.node.leaf.VSLQueryAction
QUERYTOOL SETUP
dist$ ./deploy-vsl-querytool.sh
DEFAULTS
tools$ ./ConfigWizard.sh agent
Configuring module 'agent'
peergroup (default 'Local')
= vsl
broadcaster: (default 'https://localhost:8080/vsl-leaf/services/Broadcaster')
=
cache callback: (default 'https://localhost:8080/querytool/services/Aggregator')
=
max wait time (ttl) (default '20000')
=
number of expected nodes (0=any) (default '0')
=
use remote cache? (default 'true')
= false
Writing file /opt/spin/main/conf/agent.xml
SUPERNODE SETUP
dist$ ./deploy-vsl-supernode.sh
Cache Defaults
tools$ ./ConfigWizard.sh cache
Configuring module 'cache'
TTL: (default '15000')
=
Threshold: (default '3')
=
Writing file /opt/spin/main/conf/cache.xml
Routing Table Defaults
tools$ ./ConfigWizard.sh routingtable
Add a Peer Group? (default 'false')
= true
Peer Group Name = vsl
Add a Peer to Peer Group 'vsl'? (default 'true')
= true
URL: = https://localhost/vsl-leaf/services/QueryHandler
Add a Peer to Peer Group 'vsl'? (default 'true')
= false
Add a Peer Group? (default 'false')
= false
Writing file /opt/spin/main/conf/routingtable.xml
ETL Setup
dist$ ./deploy-vsl-etl.sh
Defaults See VSL-ETL-User-Guide.doc
SSL Certificates
All SPIN Communication is done via SSL. Each peer has its own certificate, and each peer sending a message to another peer (submission or query or reply) needs to have imported that end peer's certificate.
The certificates are self-generated using the script SPINCertificate[.sh|.bat] which should be edited for each peer's local settings.
To generate a peer's private and public keys and import other peers' certificates:
- Edit the SPINCertificate script and set the following variables to your local settings:
SERVERNAME (fully qualified machine name or IP address)
INSTITUTION (e.g. Brigham And Women's Hospital)
- You may also change the variables KEYSTORE and PASSWORD.
- Run the script with:
SPINCertificate -generate
This will generate a file named spin.keystore, which holds your private key, and your certificate in a file named your.server.name.edu.cer. - To import the certificate from another peer (e.g. vsl-bwh.partners.org), run the script with:
SPINCertificate.sh -import vsl-bwh-partners.org
Run the ConfigWizard to setup the global properties for the keystore
$./ConfigWizard.sh keystore