Core v3 Management Tool - Ark Mainnet

Installation

git clone https://github.com/geopsllc/core-control
cd core-control
./ccontrol.sh arg1 [arg2]

arg1	arg2	Description
install	core	Install Core
update	core/self/check	Update Core / Core-Control / Check
remove	core/self	Remove Core / Core-Control
secret	set/clear	Delegate Secret Set / Clear
start	relay/forger/all	Start Core Services
restart	relay/forger/all/safe	Restart Core Services
stop	relay/forger/all	Stop Core Services
status	relay/forger/all	Show Core Services Status
logs	relay/forger/all	Show Core Logs
system	info/update	System Info / Update
config	reset	Reset Config Files to Defaults
database	clear	Clear the Database
rollback		Rollback to Specified Height
plugin	list/add/remove/update	Manage Core Plugins

General

This is a Streamlined CLI-Based Core v3 Management Tool.

• Installs fail2ban for ssh, and ufw allowing only ssh and the cores ports.
• For start/restart/stop/status/logs you can skip the 'all' argument as it's the default.
• For install/remove you can skip the 'core' argument as it's the default.
• For update you can skip the 'check' argument as it's the default.
• For system you can skip the 'info' argument as it's the default.
• For plugin you can skip the 'list' argument as it's the default.
• Using the 'restart safe' arguments requires the round-monitor core plugin and restarts the core services when safe to do so in order to avoid missing a block.
• When setting a delegate secret just type your secret after the 'set' argument without quotes.
• When doing a rollback just type the desired height after the 'rollback' argument.
• Rollback will stop the running processes, do the rollback and start the processes that were online.
• The script adds an alias named 'ccontrol' on first run. On your next shell login you'll be able to call the script from anywhere using: ccontrol arg1 [arg2]. It also has autocomplete functionality for all possible arguments.
• Using the 'config reset' arguments will stop the core processes, delete your existing configs and replace them with the defaults. If you're running a forger and/or have custom settings, you should add them again.
• Using the 'database clear' arguments will stop the core processes, wipe the database clean, and start the processes that were online before. The end result is that your node will start syncing from 0.
• For plugin management just type the name of the plugin after 'plugin add/remove/update' as it appears in the list.
• On first run the tool exposes the core-cli with the project name, e.g. ark for project Ark. It will be accessible after logout.
• Do not run as root!

Changelog

4.0

• updated for Core 4.0

3.1

• updated for Core 3.1
• removed plugin core-chameleon
• removed plugin productivity-statistics
• added plugin rocket-boot

3.0

• updated for Core 3.0
• fixes for Ubuntu 20.04
• fixes for plugin manager

2.7

• minor fixes for 2.7

2.6.1

• add plugin core-chameleon
• remove plugin block-propagator

2.6

• updated for core 2.6
• updated nodejs to v12
• 'snapshot create' stops the core until done - enforced by ARK code change
• added jemalloc for better memory management

2.5.1

• added restart safe option
• use restart safe on update if all requirements are met
• added plugin manager
• snapshot now uses the core-snapshot interface

2.5

• updated for core 2.5

2.4

• fixed a bug in config reset
• added log level file
• renamed json rpc
• added wallet api
• updated for core 2.4

2.3

• added database clear functionality
• expose the core-cli as the project name
• added rollback functionality
• updated for core 2.3

2.2

• conversion for yarn package and core-cli
• updated for core 2.2

2.1

• made 'update core' a lot smarter
• bump version to match core major version
• added status argument to show process status

0.7

• added a splash of color
• added update check to show update availability
• the ccontrol alias now has autocomplete for all arguments
• refactored some operations for consistency
• core remove is now done with 'remove core'
• added self-remove as an otion with 'remove self'
• moved miscellaneous variables and checks to misc.sh
• core update is now done with 'update core'
• added self-update as an otion with 'update self'
• removed automatic self-update

0.6

• added delegate secret management
• added local snapshot management
• added process restart capability
• automatically adds alias 'ccontrol' on first run
• standardize the script name and alias to 'ccontrol'
• added hostname and IP data to system info
• Made error messages easier to understand
• added config reset capability

0.5

• added system update
• added logs display
• network name is now pulled from .env for simpler commands
• renamed main script to cc.sh
• added devbranch variable to project.conf
• added automatic tool update from git
• renamed uninstall to remove
• added fail2ban (with default ssh protection)
• added ufw with configuration for ssh and the core ports in use
• reconfigure sshd_config with PermitRootLogin prohibit-password
• added pm2 logrotate module
• pm2 now starts on boot and saves process state after start/stop

0.4

• added system information

0.3

• added mainnet and devnet update procedures

0.2

• refactored code with a config file for easy migration to core v2 bridgechains

0.1

• initial release

Security

If you discover a security vulnerability within this package, please open an issue. All security vulnerabilities will be promptly addressed.

Credits

• All Contributors
• Georgi Stoyanov

License

MIT © geopsllc