pbj23000 / miranda Goto Github PK

WARNING!
This is a non-functional release of Miranda!  Key functionality is (such as replicating information to the cluster)
is missing!  A fully functional release is planned for 9/30 2017.

miranda --- a tool for creating reliable web services

INSTALLATION

You need to have git, maven, keytool, openssl and java on your path to use these instructions.
To install miranda follow these steps:

1) Download the distribution(s)
2) Compile miranda
3) Create a Certificate Authority
4) Create a tuststore
5) Generate keys for the miranda node
6) Generate a certificate signing request
7) Sign the certificate signing request with the certificate authority
8) Import the certificate authority certificate to the keystore
9) Import the node certificate to the keystore
10) Run miranda

Download the distribution(s)

Download miranda from github at

https://github.com/miranda-messaging/miranda

Compile miranda

miranda uses maven for builds.  Compile it with the following command:

mvn assembly:single

Assuming everything went OK, you should have the file

target\miranda-1.0.0-SNAPSHOT-jar-with-dependencies.jar

Create a Certificate Authority

openssl req -newkey rsa:2048 -x509 -keyout ca-key.pem.txt -out ca-certificate.pem.txt -days 365

Create a tuststore

keytool -import -keystore truststore -file ca-certificate.pem.txt -alias ca -keyalg rsa -storepass whatever

Generate keys for the miranda node

keytool -genkeypair -keystore keystore -storepass whatever -alias private -keyalg rsa

Generate a certificate signing request for the Miranda node

keytool -certreq -keystore keystore -storepass whatever -alias private -file private.csr

Sign the certificate signing request for the Miranda node with the certificate authority

openssl x509 -req -CA ca-certificate.pem.txt -CAkey ca-key.pem.txt -in private.csr -out private.cer  -days 365 -CAcreateserial

Import the certificate authority to the keystore

keytool -import -keystore keystore -storepass whatever -file ca-certificate.pem.txt -alias ca

Import the Miranda node certificate to the keystore

keytool -import -keystore keystore -storepass whatever -file private.cer -alias certificate

Run miranda

You should be able to run Miranda with the following command:

java target\miranda-1.0.0-SNAPSHOT-jar-with-dependencies.jar -4 log4j.xml -p whatever -t whatever