Skip to content

Latest commit

 

History

History
101 lines (69 loc) · 4.05 KB

build-dmt-linux-ubuntu.md

File metadata and controls

101 lines (69 loc) · 4.05 KB

Building the Dash Masternode Tool executable on Ubuntu Linux

Method based on physical or virtual linux machine

An Ubuntu distribution with Python 3.6 is required to build DMT. This example uses Ubuntu 17.10, which comes with an appropriate version installed by default. You can verify the Python version by typing:

python3 --version

You should see a response similar to the following:

Python 3.6.4

After making sure that you have the correct Python version, execute the following commands from the terminal:

[dmt@ubuntu /]# sudo apt-get update
[dmt@ubuntu /]# sudo apt-get -y upgrade
[dmt@ubuntu /]# sudo apt-get -y install libudev-dev libusb-1.0-0-dev libfox-1.6-dev autotools-dev autoconf automake libtool libpython3-all-dev python3.6-dev python3-pip git cmake
[dmt@ubuntu /]# sudo pip3 install virtualenv
[dmt@ubuntu /]# sudo pip3 install --upgrade pip
[dmt@ubuntu /]# cd ~
[dmt@ubuntu /]# mkdir dmt && cd dmt
[dmt@ubuntu /]# virtualenv -p python3.6 venv
[dmt@ubuntu /]# . venv/bin/activate
[dmt@ubuntu /]# pip install --upgrade setuptools
[dmt@ubuntu /]# git clone https://github.com/Bertrand256/dash-masternode-tool
[dmt@ubuntu /]# cd dash-masternode-tool/
[dmt@ubuntu /]# pip install -r requirements.txt
[dmt@ubuntu /]# pyinstaller --distpath=../dist/linux --workpath=../dist/linux/build dash_masternode_tool.spec

The following files will be created once the build has completed successfully:

  • Executable: ~/dmt/dist/linux/DashMasternodeTool
  • Compressed executable: ~/dmt/dist/all/DashMasternodeTool_<verion_string>.linux.tar.gz

Method based on Docker

This method uses a dedicated docker image configured to carry out an automated build process for Dash Masternode Tool. The advantage of this method is its simplicity and the fact that it does not make any changes in the list of installed apps/libraries on your physical/virtual machine. All necessary dependencies are installed inside the Docker container. The second important advantage is that compilation can also be carried out on Windows or macOS (if Docker is installed), but keep in mind that the result of the build will be a Linux executable.

Note: Skip steps 3 and 4 if you are not performing this procedure for the first time (building a newer version of DMT, for example)

1. Create a new directory

We will refer to this as the working directory in the remainder of this documentation.

2. Open the terminal app and cd to the working directory

cd <working_directory>

3. Install the bertrand256/build-dmt:ubuntu Docker image

Skip this step if you have done this before. At any time, you can check whether the required image exists in your local machine by issuing following command:

docker images bertrand256/build-dmt:ubuntu

The required image can be obtained in one of two ways:

Download from Docker Hub

Execute the following command:

docker pull bertrand256/build-dmt:ubuntu

Build the image yourself, using the Dockerfile file from the DMT project repository.

docker build -t bertrand256/build-dmt:ubuntu .

4. Create a Docker container

A Docker container is an instance of an image (similar to how an object is an instance of a class in the software development world), and it exists until you delete it. You can therefore skip this step if you have created the container before. To easily identify the container, we give it a specific name (dmtbuild) when it is created so you can easily check if it exists in your system.

docker ps -a --filter name=dmtbuild --filter ancestor=bertrand256/build-dmt:ubuntu

Create the container:

mkdir -p build
docker create --name dmtbuild -v $(pwd)/build:/root/dmt/dist -it bertrand256/build-dmt:ubuntu

5. Build the Dash Masternode Tool executable

docker start -ai dmtbuild

When the command completes, compiled binary can be found in the 'build' subdirectory of your current directory.