Installation

The following steps describe how to install the system manually. For the impatient the quickstart guide will skip this step for direct testing.

Prerequisites:

  • JDK 1.7.xy (http://www.oracle.com/technetwork/java/javase/downloads/index.html)
  • Apache Tomcat 6.0.xy (http://tomcat.apache.org/download-60.cgi)
  • (optional) Maven 2.2.1 (http://maven.apache.org/download.html)
  • idenpa-suite sources located at IDENPA_SUITE
  • Apache Tomcat 6 available at TOMCAT_HOME
  • Port 8080/5555 (tomcat) and 8888 (client) available

Build (optional)

If for some reason you want to build from the sources, run in the idenpa directory IDENPA_SUITE:

# mvn clean package

Tomcat configuration

  1. Create a new JKS keystore in TOMCAT_HOME/conf:
    # keytool -genkey -v -keystore localhost.jks -keyalg RSA -alias tomcat -keypass changeit -storepass changeit -dname "CN=localhost OU=-, O=-, L=-, C="
  2. Self-sign the generated keys:
    # keytool -selfcert -v -keystore localhost.jks -alias tomcat -storepass changeit
  3. Edit TOMCAT_HOME/conf/server.xml and add another connector under Server ... Service ...
       <Connector port="5555" maxHttpHeaderSize="8192"
          maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
          enableLookups="false" disableUploadTimeout="true"
          acceptCount="100" scheme="https" secure="true" SSLEnabled="true"
          clientAuth="false" sslProtocol="TLS" 
          keystoreFile="conf/localhost.jks" keystorePass="changeit"/>

Issuer/Verifier installation:

  1. stop your tomcat instance if running
  2. create the directory TOMCAT_HOME/conf/
  3. copy IDENPA_SUITE/issuer/target/idenpa-issuer.war to TOMCAT_HOME/webapps
  4. copy IDENPA_SUITE/libissuer/etc/*.xml to TOMCAT_HOME/conf/idemix
  5. copy IDENPA_SUITE/verifier/target/idenpa-verifier.war to TOMCAT_HOME/webapps
  6. copy IDENPA_SUITE/libverifier/etc/*.xml to TOMCAT_HOME/conf/idemix
  7. start your tomcat instance

Client:

  1. run java -jar IDENPA_SUITE/client/target/idenpa-client-0.0.1.jar