This is the Explorer project for the Ontology blockchain. The project bases on front and back separation framework.The Explorer back-end bases on Spring boot framework ,it synchronizes block and transaction information to the local database and provides Restful API for the Explorer front-end or DApp. The Explorer front-end bases on Vue framework .
- JDK Version: JDK 8 and above
- Database: Mysql5.6 and above
- Nginx: nginx1.11.3 and above
- Node: node v8.9.3 and above
The Explorer back-end Project compilation relies on maven tools. If the system is not configured with maven tools, you can download it on the maven website.
Download URL：
Firstly,cd the Explorer back-end project lib directory , run the following command:
mvn install:install-file -DgroupId=com.github.ontio -DartifactId=javasdk -Dversion=v1.0 -Dpackaging=jar -Dfile=ontology-sdk-java.jar
Then, cd the Explorer back-end project root directory，run the following command:
mvn clean package
After the compilation is successful, you will generate a jar package explorer-1.0.0-SNAPSHOT.jar in the Explorer back-end project target directory to run.
The Explorer front-end Project compilation relies on node tools. If the system is not configured with node tools, you can download it on the node website. Download URL:
Firstly,open the Explorer front-end project config/prod.env.js file , change following attribute:
API_URL:Your API URL
Then, cd the Explorer front-end project root directory，run the following command:
npm install
npm run build
After all these step, you will generate index.html and static folder in Folder dist
The Mysql tables build script and Properties of the Explorer back-end project in the config directory
- tbl_ont_block Storage block information.
- tbl_ont_txn_detail Storage transaction information.
- tbl_ont_ontid_detail Storage transaction information on the ontId operation.
- tbl_ont_current Storage the current block and transaction amount.
- view_ont_transaction Storage the basic transaction information.
In addition to the default spring boot configuration, you only need to modify the following configuration items.
################port#######################
//service startup port
server.port=7575
################database##################
//the type of database
spring.jpa.database = MYSQL
//the driver for database
spring.datasource.driverClassName = com.mysql.jdbc.Driver
//the url for database
spring.datasource.url = jdbc:mysql://localhost:3306/explorer?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull
//the username for database
spring.datasource.username = root
//the password for databse
spring.datasource.password = 1111
################blockchain param##########
//the master node restful api url
node.restful.url = http://127.0.0.1:20555
//the amount of bloickchain node
node.amount=4
//the node restful api url
node.restful.url_0=http://127.0.0.1:20555
node.restful.url_1=http://127.0.0.1:20556
node.restful.url_2=http://127.0.0.1:20557
node.restful.url_3=http://127.0.0.1:20558
//maximum fault tolerance times for each node
interruptTime.max=2
//the interval for block generate
interval=6000
//ontId smart contract codehash（hexadecimal format）
ontId.codeHash = 10e732fc22c24c466f47c7688569cc6e6d6a6f1a
//ONT asset smart contract codehash（hexadecimal format）
asset.ont.codeHash = aa00000000000000000000000000000000000011
//ONG asset smart contract codehash(hexadecimal format)
asset.ong.codeHash = bb00000000000000000000000000000000000012
Put the index.html and static folder into the correct directory according to the Nginx server configuration Example, the Nginx server configuration is
....
server {
listen 80;
server_name localhost;
location / {
root /root/www/;
index index.html index.htm;
}
}
....
So, put the index.html and static folder into your system /root/www directory.
When the above steps are completed, you can run the Explorer project.
Attention:
The Spring boot framework loads the application.properties configuration file from these paths at priority.
- The /config directory in the current directory.
- In the current directory
- The /config directory in the classpath.
- The classpath to the directory
So, you‘d betteer make sure the explorer-1.0.0-SNAPSHOT.jar and the /config directory in the same directory. Then run the following command:
java -jar explorer-1.0.0-SNAPSHOT.jar
To run the project in the background, run the following command:
nohup java -jar explorer-1.0.0-SNAPSHOT.jar
- check the process
In the linux system，use the following command ps -ef|grep java , then check for the following process.
java -jar target/explorer-1.0.0-SNAPSHOT.jar
- check the log
cd the Explorer back-end project log directory，check for the latest log display and ERROR information.
- check by your browser Input the ip and port into your browser according to your Nginx server configuration, you can see the block and transaction information in your browser just like the Ontology Explore