RSK Core is a core app to control multiple stuff. Includes default web app and admin control panel for administrative tasks. This version is designed in mind to take care of PLS Admin tasks.
- Suggested: A Linux server (Ubuntu 20.04 LTS is recommended)
- A bit of Linux knowledge
- Docker fully configured
- Docker Compose as application or Docker plugin. (This document assumes you have Compose as plugin)
- User with privileges to run Docker commands
- Docker network strategy defined, it could be host, macvlan or bridge. (This document assumes you have a bridge network strategy)
- A DB instance, Postgres is recommended. (The app and dashboard were designed and tested with Postgres)
- A Redis instance. The example assumes you don't have one so it will setup for you as well.
In config folder, copy prod.sample.py as prod.py and set SQLALCHEMY_DATABASE_URI and SECRET_KEY values.
In project's root folder (eg. /home/username/Dev/pls_admin) make the directory called migrations. This is needed for managing future database model changes discussed below.
Also set the following variables:
- APP_TIMEZONE: This is to set the time zone for the application widely, default is
America/New_York. - CHAIN_URI:
https://scan.pulsechain.com/apiis the default. - PLS_PRICE_URI: This is the API from CoinMarketCap. You need to setup an account and get a token. Default:
https://pro-api.coinmarketcap.com/v2/cryptocurrency/quotes/latest?id=11145 - PLS_PRICE_API_KEY: is the token mentioned above
- PLS_PRICE_FX: defines the FX currency to use, default is
USD. - WEB3_PROVIDER_URI: Default is
https://rpc.pulsechain.com. - ADMIN_GRAFANA_URL: This is the URL for your grafana installation. This is designed solely to have a button on the Admin's dashboard to redirect to your site.
- MAX_HEIGHT_CHECK: This is designed for the first time sync. It's to prevent the sync operation to look too far up to the moment of the creation of the chain (block #0). Default is 17530000, but you can set it to your first block height where you had your first PLS transaction.
- REDIS_HOST: This is the host for our Redis instance, default is
redis. - REDIS_BROKER_URL: This is used by Celery, default is
redis://{REDIS_HOST}:6379. - REDIS_RESULT_BACKEND: This is used by Celery. It can be the same as the Broker, default is
redis://{REDIS_HOST}:6379. - CELERY_TASK_RESULT_EXPIRES: Timeout for Celery tasks, default
30. - CELERY_TIMEZONE: This is the timezone for the scheduler, default is the same as the App or
APP_TIMEZONE.
Also set a correct docker-compose.yml file, you can use(copy) docker-compose.sample.yml. Set TZ to your current server's timezone, APP_SETTINGS_MODULE as config.prod. It is also necessary to include a volumes directive, with an example of the syntax required for this directive shown in the docker-compose.sample.yml file.
There's a special section inside the sample docker-compose file to configure the network. You can set this at the end of the compose file as follows:
networks:
master_network:
external: TrueThis network must be configured previously with the proper subnet and gateway. Assuming you are using a bridge network, you can do it with
docker network create -d bridge master_network. More details here
Once you have a network created and the network declaration inside the compose file, you need to setup the network inside each container definition as follows:
version: "3"
services:
container:
image: image/name
restart: always
networks: # This is the network configuration
- master_network # Name is the same as the one you set at the end
# - Other_network
# - A_macvlan_network:
# ipv4_address: 192.168.0.100
environment:
- ENV_VAR1=VALUE1
ports:
- 80:80
redis: # this is optional, you can use an external redis instance, just be sure to set the correct variables on the config as mentioned above.
image: redis:latest
container_name: redis
hostname: redis
restart: always
ports:
- 6379:6379
networks: # or the same network as the other containers
- master_network
# ...
# Other containers, volume configurations, etc
# ...
networks: # The network declaration as described above.
master_network:
external: TrueNote that this is a sample and it's assuming you're using a bridged network. There are diverse network configurations. The important thing is that you must set the network mode just to allow intercommunication between all containers, your DB instance and other services as well.
There's a Grafana dashboard, you can import it from the extras folder. It's designed to work with the PLS grabber, so you need to setup the datasource and the variables as well.
You can find it here.
Assuming you have a proper Docker and Docker Compose installation, and your user has privileges to run them, you can start the application with:
docker compose upOnce up, you need to run some commands to initialize the database, admin user, scheduler and other stuff.
Next, if you have all running on default settings, you can access the web app at:
http://server:5000/adminIt's not the same as first-sync. This is to initialize the database and create the admin user.
Once up, initialize the database with:
docker exec -it adminpls python3 -m flask first-run
docker exec -it adminpls python3 -m flask db initIt will ask you to input Proceed! to continue and y to confirm. It will create the admin user(
admin@rskcore.io) with default password admin, and populate the tasks definition table with the default tasks so you can be able to setup the scheduler.
IMPORTANT: Right now there's no way to change the admin password, your best option to change it is using the Admin Password Reset option below.
Once you have the first run done, you must setup your schedules as follows:
- Enter the application and go to
System > Scheduler. Once ther, click onCreate. You will see the following form:
- You need to select a Task(currently 3 available) from the list, set a cron (Go to crontab.guru for help) and set the
Activecheckbox if you want that schedule to be active. Suggested Cron examples for the 3 tasks above:
*/10 * * * * # This is for the Price Update task, it will run every 10 minutes.
*/15 * * * * # This is for the Wallet Review task, it will run every 15 minutes.
15,45 * * * * # This is for the Validator Update task, it will run every hour at minutes 15 and 45.If there's no tasks available from the Task Name dropdown, you need to run the Scheduler Reset Task and restart the containers.
- Once you're done, click on
Saveand you will see the task in the list as follows:
By default, the form will show the
Activecheckbox as unchecked. This is to allow you to create the task and then activate it later.
Available Tasks
Right now there are only 3 tasks avaliable: pls_pu(Price Update, suggestion: each 10 minutes), pls_wr(Wallet Review, updates wallets balances, suggestion: each 15 minutes) and pls_vu(Validator Updates, updates validators info, suggestion: every hour at minutes 15 and 45)
IMPORTANT: Rembember to restart the containers each time you edit a task. I will change this some day.
For the first time, you need to run the first sync. Do it with:
docker exec -it adminpls python3 -m flask first-syncThis operation could take a while to finishs, it depends on the number of blocks to sync.
Once you're done with the first sync operation, you have to enable all the tasks in the scheduler to keep the sync up to date.
If you forgot your admin password, just run:
docker exec -it adminpls -m flask update-adminFollow the prompts and confirmation for new password.
If for some reason you need to reset the scheduler, you can do it with:
docker exec -it adminpls python3 -m flask scheduler-resetTake note that this will delete any configured schedules. This is also useful if you need to add new functions in the future.
For core upgrades, you can run:
./restart_core.shThis is viable assuming you had the project already cloned with git and correct permissions. The script will pull the latest changes, build the new image and restart the container. It could be also necessary to update the DB Model.
Every other update could require model changes. If you have not initialized the database, run the following command docker exec -it adminpls python3 -m flask db init, otherwise run:
docker exec -it adminpls python3 -m flask db migrateOnce you review the changes, run:
docker exec -it adminpls python3 -m flask db upgradeCheck any error output for possible issue tracking.
If for any reason this project adds a new periodic task, it will be necessary to run the Scheduler Reset command. This will delete all the current scheduled task, so you'll need to backup and recreate them.
wip - raskitoma.io