Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Tip

Step - by - step guide on how to Install Insights Enterprise - Business logic


Expand
titleStep1: INSIGHTS_HOME environment variable

Ensure that the INSIGHTS_HOME environment variable is set. If not, set it using the following commands(for Linux)

Code Block
languagebash
themeConfluence
export INSIGHTS_HOME=/usr/INSIGHTS_HOME


Warning

change the directory accordingly

or

Code Block
languagebash
themeConfluence
vi /etc/environment
  1. Add the line: 

    Div

    INSIGHTS_HOME=/usr/INSIGHTS_HOME


    Warning

    change the directory accordingly


  2. Save the file  and run the command:

    Code Block
    languagebash
    themeConfluence
    source /etc/environment



Expand
titleStep2: Configuration

Copy the blockchainConfig.json from PlatformAuditing/src/main/resources/  into $INSIGHTS_HOME/.InSights/ and make the necessary changes

SampleblockchainConfig.json

  • The CA, peer, and user should be from the same org
  • The Eventhub is not available as a separate container but obtained by using the peer instance and so it can use the peer url
  • The user private key (ends with "sk") can be found in ledger/ca/msp/keystore
  • The public key (pem) can be found in ledger/ca/msp/signcerts
  • Copy the private and public key into any suitable directory (when moving between different machines/servers ensure these files are not corrupted) and provide their path
  • The USER_SER_PATH is a path for storing the serialized format of the user context
  • Place the datamodel.json and Process.json files in any directory suitable and provide the path in blockchainConfig.json



Expand
titleStep3: Run PlatformAuditEngine
  • Download the PlatformAuditEngine jar from (Nexus link here)
  • Run the downloaded jar using the command:
Code Block
languagebash
themeConfluence
java -jar PlatformAuditEngine-0.1.jar
  • If you want to run the jar as a background service instead, use the below command:
Code Block
languagebash
themeConfluence
nohup java -jar PlatformAuditEngine-0.1.jar &
  • The logs will be available at $INSIGHTS_HOME/logs/PlatformAuditEngine
Note
titleNote

The server running PlatformAuditEngine must have the blockchainConfig.json file with the dependency files (datamodel.json, Process.json, private and public keys) in appropriate locations



Expand
titleStep4: Run PlatformAuditService
  • Copy the folders keystore, sign and static available under PlatformAuditService/src/main/resources/ into $INSIGHTS_HOME/.InSights/ 
  • Download the PlatformService war from (Nexus link here)
  • Move the war into webapps directory of apache-tomcat and restart tomcat
    • Use the following commands inside the apache-tomcat directory to restart
    • ./bin/shutdown.sh
    • ./bin/startup.sh
Note
titleNote

The server running Apache Tomcat must have the blockchainConfig.json file with the dependency files (datamodel.json, Process.json, private and public keys) in appropriate locations



...