Versions Compared

Version Old Version 1 New Version 2
Changes made by

Jeyanthi

Varshitha Seralathan (Unlicensed)

Saved on

Key

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


Tip

Step - by - step guide on how to Install Insights Enterprise - Auditing Module.

Step 1

Business logic


Expand
titleStep1: INSIGHTS_HOME environment variable
:

Ensure that the INSIGHTS_HOME environment variable is set. If not,

if not

set it using the following commands(for

RHEL

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:
 INSIGHTS
  1.  
     Div
    INSIGHTS_HOME=/usr/INSIGHTS_HOME
 (

  1.  Warning
    change the directory accordingly
)
  • save the file
    • Run 

    2. Save the file  and run the command:
       Code Block
      languagebash
      themeConfluence
      source /etc/environment
    Step 2 


     Expand
    titleStep2: Configuration
    :
    Copy the blockchainConfig.json from PlatformAuditing/src/main/resources/  into $INSIGHTS_HOME/.InSights/ and make the necessary changes
    Refer here for sample blockchainConfig,json
    Sample: blockchainConfig.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
    Sample: datamodel.json Explanation: datamodelDescription
    Sample: Process.json Explanation




    :  ProcessDescription

     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
    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
    Download the PlatformService war from (Nexus link here)
    Move the war into webapps directory of apache-tomcat and restart tomcat.
     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