blockchain-explorer
    |
    ├── app                     Application backend root, Explorer configuration
    |    ├── rest               REST API
    |    ├── persistence        Persistence layer
    |    ├── fabric             Persistence API (Hyperledger Fabric)
    |    └── platform           Platforms
    |    |    └── fabric        Explorer API (Hyperledger Fabric)
    |    └── test               Application backend test
    |
    └── client         	        Web UI
         ├── public             Assets
         └── src                Front end source code
              ├── components    React framework
              ├── services      Request library for API calls
              ├── state         Redux framework
              └── static        Custom and Assets

# 3.0 Dependencies Following are the software dependencies required to install and run hyperledger explorer: * Nodejs 8.11.x (Note that v9.x is not yet supported) * PostgreSQL 9.5 or greater * [jq](https://stedolan.github.io/jq) * Linux-based operating system, such as Ubuntu or MacOS Verified Docker versions supported: * [Docker CE 18.09.2 or later](https://hub.docker.com/search/?type=edition&offering=community&operating_system=linux) * [Docker Compose 1.14.0](https://docs.docker.com/compose) # 4.0 Clone GIT Repository Clone this repository to get the latest using the following command. - `git clone https://github.com/hyperledger/blockchain-explorer.git` - `cd blockchain-explorer` # 5.0 Database Setup - `cd blockchain-explorer/app` - Modify explorerconfig.json to update PostgreSQL database settings.

"postgreSQL": {
    "host": "127.0.0.1",
    "port": "5432",
    "database": "fabricexplorer",
    "username": "hppoc",
    "passwd": "password"
}

Another alternative to configure database settings is to use environment variables, example of settings:

	export DATABASE_HOST=127.0.0.1
	export DATABASE_PORT=5432
	export DATABASE_DATABASE=fabricexplorer
	export DATABASE_USERNAME=hppoc
	export DATABASE_PASSWD=pass12345

**Important repeat after every git pull (in some case you may need to apply permission to db/ directory, from blockchain-explorer/app/persistence/fabric/postgreSQL run: `chmod -R 775 db/` Run create database script: Ubuntu - `cd blockchain-explorer/app/persistence/fabric/postgreSQL/db` - `sudo -u postgres ./createdb.sh` MacOS - `cd blockchain-explorer/app/persistence/fabric/postgreSQL/db` - `./createdb.sh` Connect to the PostgreSQL database and run DB status commands: - `\l` View created fabricexplorer database. - `\d` View created tables. If your Postgresql configured with TLS, read link [how to configure connection to Postgresql with TLS](./app/persistence/postgreSQL/CONFIGURE-TLS-CONNECTION-TO-POSTGRESQL.md) # 5.1 Authorization Configuration - `cd blockchain-explorer/app` - Modify explorerconfig.json to update Authorization (JWT) settings.

"jwt": {
    "secret" : "a secret phrase!!",
    "expiresIn": "2 days"
}

`jwt`: * `secret`: secret string to sign the payload. * `expiresIn`: expressed in seconds or a string describing a time span [zeit/ms](https://github.com/zeit/ms). > Eg: `60`, `"2 days"`, `"10h"`, `"7d"`. A numeric value is interpreted as a seconds count. If you use a string be sure you provide the time units (days, hours, etc), otherwise milliseconds unit is used by default (`"120"` is equal to `"120ms"`). # 6.0 Fabric Network Setup - Note: This section will take some time to complete. - Setup your own network using the [Building Your First Network](http://hyperledger-fabric.readthedocs.io/en/latest/build_network.html) tutorial from Hyperledger. Once you setup the network, please modify the values in `/blockchain-explorer/app/platform/fabric/config.json` accordingly. - Hyperledger Explorer defaults to utilize [fabric-samples/first-network](https://github.com/hyperledger/fabric-samples). - Make sure to set the environment variables `CORE_PEER_GOSSIP_BOOTSTRAP` and `CORE_PEER_GOSSIP_EXTERNALENDPOINT` for each peer in the docker-compose.yaml file. These settings enable the Fabric discovery service, which is used by Hyperledger Explorer to discover the network topology. # 6.1 Configure operations service Config-Operations-Service-Hyperledger-Explorer - Please visit the [CONFIG-OPERATIONS-SERVICE-HLEXPLORER.md](CONFIG-OPERATIONS-SERVICE-HLEXPLORER.md) to configure operations service # 7.0 Configure Hyperledger Fabric On another terminal: - `cd blockchain-explorer/app/platform/fabric` - Modify config.json to define your fabric network connection profile:

{
    "network-configs": {
        "first-network": {
            "name": "firstnetwork",
            "profile": "./connection-profile/first-network.json",
            "enableAuthentication": false
        }
    },
    "license": "Apache-2.0"
}