The ObsidianXXL (XXL) is a modular dashboard for MasterNodes (MN) on the Obsidian Blockchain. With a straight forward setup, anyone running a node on the Obsidian Blockchain will be able to easily view their server, node, and network information in a beautiful and clean interface. The ObsidianXXL includes an internal API layer, XXL-API, which works as a proxy between this Webapp and your running Obsidian Blockchain.
A more streamlined installation process is still being sorted out as we are growing to understand our user-base and which platforms will need support. Currently, installation has been verified on MacOS and Ubuntu 16.04. In order of importance, the XXL-API should be installed first.
Important project dependencies such as NodeJS are installed after going through the entire XXL-API README
!
If you have not yet installed either the Obsidian-QT Wallet or the obsidiand
binary file from source. For more information, please view our Github Wiki for the Obsidian-QT wallet.
The XXL-API is an interface layer separating the ObsidianXXL Webapp and your running Obsidian Blockchain. The XXL-API has it's own prerequisites/guide and must be installed prior to ObsidianXXL. Please refer to the XXL-API README
for installation details.
Forever is a Process Manager to run the ObsidianXXL Webapp in production, essentially a high-level container for ObsidianXXL to run. We have opted for Forever due to the simplicity of use. The following command will install it in your environment.
npm install forever -g
Running the below command from within the ObsidianXXL project folder will look at the package.json
manifest and install the required dependencies. If you do not have the ObsidianXXL project folder then you have not read through and setup the XXL-API README
and must do that first!
npm install
Please ensure the following steps are done:
- The Obsidian Blockchain is running in the background, either as a Wallet App or via the
obsidiand
process. - You have modified the
obsidian.conf
file with specific settings outlined from the XXL-APIREADME
.
- If you have modified your Obsidian Blockchain config file you must reset your application/process first!
If using the GUI, you will simply need to start the Obsidian-QT application.
If you built the obsidiand
binary file you will need to start the process back up again. To run obsidiand
in the background, you can pass the daemon
flag to daemonize the program: obsidiand -daemon
.
Run the following command from the ObsidianXXL project root:
npm run start
If no issues arise you should see a message in your shell that the server is running on port :80
, this means you should be able to see your dashboard running by entering the IP address of your machine.
If you're feeling up for it, you could also buy a specialized website hostname and route it to whatever IP your Obsidian Node server is running on. This way, you could just type in a url to access it wherever you are versus using an IP address!
All of these commands are run using npm
from the ObsidianXXL project root.
Starts the ObsidianXXL and ObsidianXXL-API services.
npm run start
Stops the ObsidianXXL service if it was running.
npm run stop
Pulls the latest updates from the ObsidianXXL Github repository and installs any updated information.
npm run update