README.md

Bitmark Node Documentation

[ English | 中文 | [Tiếng Việt](#Giới thiệu)]

Introduction

The Bitmark node software enables any computer on the Internet to join the Bitmark network as a fully-validating peer. Unlike conventional property systems that rely on a handful of trusted government officials to act as centralized gatekeepers, the Bitmark blockchain is an open and transparent property system that is strengthened through the active participation of anyone on the Internet. The integrity of Bitmark’s open-source blockchain is ensured by a peer-to-peer network of voluntary participants running the Bitmark node software. These participants are incentivized to participate in verifying Bitmark property transactions through the possibility of winning monetary and property rewards.

The Bitmark blockchain is an independent chain, optimized for storing property titles, or bitmarks, and does not have its own internal currency (transaction fees are in bitcoin or litecoin). The peer-to-peer network is written in Go and uses the ZeroMQ distributed messaging library. The consensus is secured using the Argon2 hashing algorithm as proof-of-work.

*Read our Governance policy to learn how to contribute to this project

Supported Platforms

The Bitmark node software is distributed as a standalone Docker container, which supports easy installation on all major platforms including:

• Desktop devices, such as Mac and Windows
• Linux servers, such as CentOS, Debian, Fedora, and Ubuntu
• Cloud providers, such as AWS and Azure

Contents

The Bitmark node consists of the following software programs:

• bitmarkd — the main program for verifying and recording transactions in the Bitmark blockchain (view source code on GitHub)
• recorderd — an auxillary application for computing the Bitmark proof-of-work algorithm that allows nodes to compete to win blocks on the Bitmark blockchain (view source code on GitHub)
• bitmark-wallet — an integrated cryptocurrency wallet for receiving Bitcoin and Litecoin payments for won blocks (view source code on GitHub)
• bitmark-cli — a command line interface to bitmarkd (view source code on GitHub)
• bitmark-webui — a web-based user interface to monitor and configure the Bitmark node via a web browser

Installation

To install the Bitmark node software, please complete the following 4 steps:

1. Install Docker

The Bitmark node software is distributed as a standalone Docker container which requires you to first install Docker for your operating system:

• Get Docker CE for Mac
• Get Docker Toolbox for Windows 10 Home and Windows 8
• Get Docker CE for Windows 10 Pro, Education, and Enterprise
• Get Docker CE for CentOS
• Get Docker CE for Debian
• Get Docker CE for Fedora
• Get Docker CE for Ubuntu
• Get Docker CE for AWS
• Get Docker CE for Azure

2. Download the Bitmark Node

After successfully installing Docker, you can download the Bitmark node software. To do so, first open a command-line terminal or shell application, such as Terminal on the MacOS or Linux, or cmd.exe on Windows. Then enter the following command to download the Bitmark node software:

docker pull bitmark/bitmark-node-docker

After entering the pull command, the download sequence should begin in the terminal. You will receive the following message after the download is completed successfully:

Status: Downloaded newer image for bitmark/bitmark-node-docker:latest

3. Run the Bitmark Node

Prepare Public IP

Public IP is the IP which people in Internet can reach your bitmark-node-docker. Our script will automatically find your public IP for you. However, network configurations are various, we can not guarentee that the auto-generated IP is acurate or not. To get your accurate public IP, please consult your ISP.

Prepare Network Environment

• User must ensure the following ports to be accessible from Internet.

  PORT	DESCRIPTION
  2136	Port for connecting to other peer bitmarkd nodes
  2135	Port for publishing blockchain events
  2130	Port for Bitmark node RPC server

  When running bitmark-node-docker, user can make sure ports are opened with the following commands.

  netcat -v [Your Public IP] 2136

  netcat -v [Your Public IP] 2135

  netcat -v [Your Public IP] 2130

• WebUI is an interface to control bitmark-node-docker. User can only access WebUI through local network. Please notice that user can not access the port from internet due to security reason.

  PORT	DESCRIPTION
  9980	Web server port for web UI

Auto Update

Each script contains an option to check for updates every time the script is run. This is enabled by default and can be turned off by opening the script in a text editor and replacing the true text in AUTO_UPDATE=true with false. This can be founded in a section at the top of the script titled User Defined Variables. Be sure to keep quotation as it is currently in the script.

Setup Scripts

• Linux Users

  • Download the setup script bitmarkNode-Linux-MacOS.sh and run it. This can be accomplished by right-clicking on it, selecting open Open With Terminal.

  • execute bash bitmarkNode-Linux-MacOS.sh [Your Public IP]. When run the script without providing [Your Public IP], the script find your IP from Internet

    ie.

    bash bitmarkNode-Linux-MacOS.sh 117.166.111.123
    
    bash bitmarkNode-Linux-MacOS.sh
    

  • If the script does not run, right-click on it, select properties, go to the permissions tab, and click on the box to "Allow this file to run as a program".

• Windows Users Running Docker in Hyper-V (Windows 10 Pro and Enterprise)

  • Ensure that Hyper-V is turned on

  • Download the setup script and run it by right-clicking on it, and selecting Run as administrator. bitmarkNode-HyperV.bat

  • Execute bitmarkNode-HyperV.bat [Your Public IP]. When run the script without providing [Your Public IP], the script find your IP from Internet

    ie.

    bitmarkNode-HyperV.bat 117.166.111.123
    
    bitmarkNode-HyperV.bat
    

• MacOS Users

  • Download the setup script bitmarkNode-Linux-MacOS.sh and run it. You can run the script by opening a Terminal, moving to your download directory within the terminal (if your download directory is Downloads, this can be accomplished by typing cd Downloads)

  • Execute bash bitmarkNode-Linux-MacOS.sh [Your Public IP]. When run the script without providing [Your Public IP], the script find your IP from Internet

    ie.

    bash bitmarkNode-Linux-MacOS.sh 117.166.111.123
    
    bash bitmarkNode-Linux-MacOS.sh
    

Future Setup

The Docker container must be restarted after everytime the computer is turned off. To restart the container, simply re-run the setup script as you did the first time. You can also manually restart the container as described below. Note, if you do have auto-update enabled in the script, manually starting the container will not check for updates.

Manual Setup

All of the following commands will be run in the appropriate command-line interface described below. Before running the bitmark-node-docker container, you should check container status:

1. Run docker ps -a to check if bitmarkNode container exist.

2. Check "Status"

   • Status: Up to [time] : bitmarkNode is running. You may either leave this container running or you can stop it using docker stop bitmarkNode. You may then delete the container using docker rm bitmarkNode.
   • Status: Exit: bitmarkNode is not running but the container exists. In this case, you can start the container by using docker start bitmarkNode, or you can use docker rm bitmarkNode to delete the container. To start the container again, you must re-run the first time setup script for your operating system.

---

General Information

Once the Bitmark node has successfully started, it will return a 64-character hexadecimal string that represents the Bitmark node's Docker container ID, such as:

dc78231837f2d320f24ed70c9f8c431abf52e7556bbdec257546f3acdbda5cd2

When the Bitmark node software is started up for the first time, it will generate a Bitmark account for you, including your public and private key pairs.

Docker Run Command Options

Various Bitmark node environmental settings, such as ports and IP addresses, can be configured using the Docker run command when running the Bitmark node from the command-line terminal:

docker run -d --name bitmarkNode -p 9980:9980 \
-p 2136:2136 -p 2130:2130 \
-e PUBLIC_IP=[YOUR_PUBLIC_IP] \
-e NETWORK=[YOUR_NETWORK] \
-v $HOME/bitmark-node-data/db:/.config/bitmark-node-docker/db \
-v $HOME/bitmark-node-data/data:/.config/bitmark-node-docker/bitmarkd/bitmark/data \
-v $HOME/bitmark-node-data/data-test:/.config/bitmark-node-docker/bitmarkd/testing/data \
bitmark/bitmark-node

Note that YOUR_PUBLIC_IP should be replaced with your own public IP address and ```[YOUR_NETWORK] should be replaced with a network as described here.

The following table describes the various configuration options for the Bitmark node run command:

OPTION	DEFAULT	DESCRIPTION
-name	bitmarkNode	Assigns a name to the Bitmark node Docker container.
-p	9980	Web server port for web UI
-p	2136	Port for connecting to other peer bitmarkd nodes
-p	2135	Port for publishing blockchain events
-p	2130	Port for Bitmark node RPC server
-e	PUBLIC_IP=[YOUR_PUBLIC_IP]	Environment variable for register your public IP address.
-e	NETWORK=[YOUR_NETWORK]	Either bitmark or testing. Learn more about the two networks here

For an explanation of each of the run command options, please enter the following command into the terminal:

docker run --help

Terminals

Each version of Docker will use a different command-line interpreter (CLI) depending on the Operating System. See below to find the correct one for your Operating System and Docker pairing:

Operating System (Docker Version)	CLI
Linux (Docker for Linux)	Terminal
Windows 8 or 10 Home (Docker Toolbox)	Docker Quickstart Toolbox
Windows 10 Pro or Enterprise (Docker for Windows)	cmd.exe
MacOS (Docker for Mac)	Terminal

4. Start Services in Web Interface

The Bitmark node includes a web-based user interface to monitor and control the Bitmark node within a web browser. After running the Bitmark node in step 3, you should launch the web UI to start the bitmarkd and optional recorderd programs.

On most computer systems, the web UI can be accessed on port 9980 of the localhost address (127.0.0.1) by clicking the following link:

http://127.0.0.1:9980.

After loading the web UI, you should use it to start the two main Bitmark node software programs:

1. bitmarkd — responsible for verifying Bitmark transactions and recording them in the Bitmark blockchain (required for all Bitmark nodes)
2. recorderd — required for solving the Bitmark blockchain's proof-of-work algorithm, which qualifies nodes to win blocks and receive monetary compensation (optional)

After starting the bitmarkd node for the first time, the node will go through an initial Resynchronizing phase in which a copy of the current Bitmark blockchain will be downloaded to your Bitmark node. Once the blockchain resynchronization has completed, your Bitmark node will begin verifying and recording transactions for the current block.

User Interface Walkthrough

1. Login Screen

On the login screen, you can either enter your 24-word recovery phrase to log in to an existing account or you're able to create a new account. When you create a new account, you will be assigned a 24-word recovery phrase that will allow you to login to the same account after restarting the Docker container. You will also be prompted to enter a Bitcoin and Litecoin wallet address to allow you to receive any monetary awards for verifying Bitmark property transactions (these address can be changed at any time). If you do not have a bitcoin or litecoin wallet, see here for more information.

2. Startup Screen

On this screen, you can start up the two parts of the Bitmark Node software, bitmarkd and recorderd. By clicking on the person icon on the top of the screen you can: view your blocks won, write down your recovery phrase, and copy down your account address. By clicking on the three bar drop-down menu you can change your language, and view the Bitmark Node documentation. You can also change your cryptocurrency wallet addresses in the Bitmark Wallet section.

3. Running Screen

This full-sized menu appears once you start the bitmarkd software.

• Bitmark Node (bitmarkd):
  • Status: Either Stopped or Running. Describes the state of the bitmarkd software.
  • Connection: When starting up, it displays Checking connection…. After connecting to the network, it will show the number of nodes that it is connected to. A connection of three nodes is required to successfully run the Bitmark Node software.
• Recorder Node (recorderd)
  • Status: Either Stopped or Running. Describes the state of the recorderd software.
• Network ID
  • This is your bitmark-node-docker public key
• Current Block
  • This displays what the current block your system is on. This can either be the latest block, or the block that it is currently downloading.
• Transaction Counter
  • Pending: The pending transcations count
  • Verified: The verified transcations count
• Uptime
  • This describes the total time that the Docker container has been active for.
• Your Blocks
  • Each block in this section is for a block that your account has solved, including the date and time it was solved on, the block number, and the hash, the "solution" for that block.

Configuration Options

Current Blockchain

The Bitmark node allows participants to verify and record transactions on two different Bitmark blockchains:

• bitmark — the official version of the Bitmark blockchain
• testing — a testnet version of the blockchain used solely for development testing

Node participants can select which blockchain they are currently working on via the web UI. Note that switching to a different blockchain will require you to restart the Docker container, selecting the new network.

The Bitmark system offers monetary rewards to block winners for both the bitmark and testing blockchains.

Payment Addresses

Bitmark node participants running both bitmarkd and recorderd are awarded monetary payments for winning blocks on both the bitmark and testing blockchains. These payments are delivered as either bitcoin or litecoin payments (depending on current cryptocurrency prices and confirmation times) and are delivered to a node's designated bitcoin and litecoin payment addresses.

When the Bitmark node software is first started up, it requires the user to provide a bitcoin and litecoin account address. If you do not have a bitcoin or litecoin wallet, there are many ways to easily get one online. A simple, online solution is coinbase, though any wallet will work.

Updates

If you turned off automatic updates in your setup script, you can update the Bitmark node software with the following 3 steps:

1. Download Latest Node Version

To update your version of the Bitmark node software, open a command-line terminal or shell application, such as Terminal on the Mac or Linux, cmd.exe on Windows 10 Pro or Enterprise, or Docker Quickstart Terminal on Windows 8 or 10 Home, then enter the following command to download the software update:

docker pull bitmark/bitmark-node-docker

After entering the pull command, the download sequence should begin in the terminal. You will receive the following message after the download is completed successfully:

Status: Downloaded newer image for bitmark/bitmark-node-docker:latest

2. Run Bitmark Node

After the software update has successfully downloaded, you need to remove the previous container and start a new one via command-line terminal:

docker rm -f bitmarkNode
docker run -d --name bitmarkNode -p 9980:9980 \
-p 2136:2136 -p 2130:2130 \
-e PUBLIC_IP=[YOUR_PUBLIC_IP] \
-e NETWORK=[YOUR_NETWORK]
-v $HOME/bitmark-node-data/db:/.config/bitmark-node-docker/db \
-v $HOME/bitmark-node-data/data:/.config/bitmark-node-docker/bitmarkd/bitmark/data \
-v $HOME/bitmark-node-data/data-test:/.config/bitmark-node-docker/bitmarkd/testing/data \
bitmark/bitmark-node-docker

Please remember to replace [YOUR_PUBLIC_IP] to your node public ip and [YOUR_NETWORK with bitmark or testing.

3. Restart Services in Web Interface

Finally, restart the bitmarkd and optional recorderd programs via the web UI. On most computer systems, the web UI can be accessed on port 9980 of the localhost address (127.0.0.1) by clicking the following link:

http://127.0.0.1:9980.

After loading web UI, you should use it to start the two main Bitmark node software programs:

1. bitmarkd — responsible for verifying Bitmark transactions and recording them in the Bitmark blockchain (required for all Bitmark nodes)
2. recorderd — required for solving the Bitmark blockchain's proof-of-work algorithm, which qualifies nodes to win blocks and receive monetary compensation (optional)

After restarting the bitmarkd node for the first time, the node will go through an initial Resynchronizing phase in which a copy of the current Bitmark blockchain will be downloaded to your Bitmark node. Once the blockchain resynchronization has completed, your Bitmark node will begin verifying and recording transactions for the current block.

Troubleshooting

Listening port (2136) is not accessible.

• If you did not provide your IP address correctly, or your IP address has changed since setup, this issue can arise. You must stop the node through Terminal (MacOS/Linux), cmd.exe (Windows 10 Pro and Enterprise), or through the Docker Quickstart Terminal (Windows 8 or 10 Home) by typing docker stop bitmarkNode. Then you must remove the container by typing docker rm bitmarkNode. Now re-run the setup script (for users using the Docker Toolbox setup script, you must find your public IP address again by visiting ipinfo.io/ip and re-entering your IP address in the setup script).
• This can also be caused by your router's NAT (Network Address Translation) not allowing you to access port 2136, the port used to connect to other bitmarkd nodes. To allow the node software to access this port, you must enable port forwarding on your router and forward port 2136. A good guide on how to do this is linked here.

Using Docker Toolbox in Windows

• Docker Toolbox in Windows is NOT officially supported, but you can try the steps below
• Windows Users Running Docker in Toolbox (Windows 8 and 10 Home)

  • Docker in Toolbox is not official supported but

  • Setup port forwarding in Docker VirtualMachine:

    • Open Oracle VM VirtualBox and navigate to the docker virtual machine titled default. Right-click on the virtual machine and navigate to Settings.

    • Go to Network and select an adapter that is not currently enabled. Click on the checkbox that says Enable Network Adapter and select the drop-down box called '''Attached To:''' and select NAT. Enable Advanced settings by clicking the arrow to the left of the text and click on the box that says Port Forwarding.

    • You're able to add a new rule by selecting the + sign on the right. Add the following 4 ports:

      Name	Protocol	Host IP	Host Port	Guest IP	Guest Port
      Docker #1	TCP		9980		9980
      Docker #2	TCP		2136		2136
      Docker #3	TCP		2135		2135
      Docker #4	TCP		2130		2130

  • Prepare the setup script:

    • Begin by downloading the script. bitmarkNode-Toolbox.bat
    • Open the script in a text editor by right-clicking on the script and selection Open With... and then select notepad or your preferred text editor.
    • Add your public IP Address to line 25 by replacing the text XXX.XX.XX.XX. This can be found on the website ipinfo.io/ip.
    • If you would like to change the directory in which the Bitmark node stores its data, do so on line 26. By default, it is /c/. During setup, it will create a folder bitmark-node-data in this directory. Do not include user directories if the path is changed (i.e. do not use /c/Users/yourname).
    • Save the script and move it to the Docker Toolbox file path (by default this is C:\Program Files\Docker Toolbox). Note that this is not the same path as the one you were given the option to change in the last step, instead it is something chosen during Docker setup.
    • Open Docker Quickstart Terminal and run the setup script by typing sh bitmarkNode-Toolbox.sh.

Current Block Stuck at 1/1

• Once the Bitmark Node software successfully starts, it will remain at 1/1 blocks for a short period of time. If the node is successfully connected to at least 3 other nodes and remains stuck at 1/1 for a long period of time, restart the Docker container. If the issue persists, remove the container by typing docker rm bitmarkNode and re-run the setup script.

HTTP: TLS Handshake Error

• To solve this error, restart the docker container.

Storage Initialise Error

• To solve this error, restart the docker container.

Windows Login failed

• You need to login docker hub at first time to pull images. If you login but still get the below message, the possible cause is that you use email to login but not your username.

  Error response from daemon: Get https://registry-1.docker.io/v2/bitmark/bitmark-node-docker/manifests/latest: unauthorized: incorrect username or password

Bitmark節點說明

簡介

Bitmark 節點是一個讓一台連網的電腦可以加入 Bitmark 網路並且參與驗證的軟體。Bitmark 區塊鏈與傳統的資產系統不同的地方在於，傳統的資產系統是一種由一群被信任的官方人員所運作的集中式管理系統，而 Bitmark 區塊鏈是一個任何人都可以透過網路積極參與驗證強化的開放透明資產系統。Bitmark 開源區塊鏈的健全性是由一群自願參與運行 Bitmark 節點軟體的人們所構成的P2P網路來維繫，而自願參與驗證 Bitmark 資產交易的誘因為可能贏得以金錢或是資產形式的獎勵。

Bitmark 區塊鏈是專門為了資產所有權（稱為 bitmark ）所優化的一條獨立的鏈，其本身並不是一種貨幣（交易手續費是用 bitcoin 或 litecoin 支付）。P2P 網路是用 Go 語言寫成，並且使用 ZeroMQ 分散式訊息庫。共識是使用 Argon2 的雜湊演算法來作為工作量證明。

*請參閱我們的 Governance policy 了解如何參與與貢獻這個計畫

支援平台

Bitmark節點軟體是透過獨立運作的 Docker container 來發布。Docker container 可支援各主要平台的簡易安裝：

• 桌上型電腦，如 Mac或Windows
• Linux伺服器，如 CentOS、 Debian、 Fedora及Ubuntu
• 雲端服務，如 AWS 及 Azure

內容

Bitmark 節點由以下軟體程式所組成：

• bitmarkd - 用於 Bitmark 區塊鏈驗證以及紀錄交易的主程式。(在 GitHub 上檢視原始碼)
• recorderd - 用於計算 Bitmark 工作量證明演算法的附屬程式，使一個節點可以在 Bitmark 區塊鏈上爭取贏得區塊。(在 GitHub 上檢視原始碼)
• bitmark-wallet - 一個加密貨幣錢包，用來收取贏得區塊後以 bitcoin 或 litecoin 形式支付的獎勵。(在 GitHub 上檢視原始碼)
• bitmark-cli - bitmarkd的命令列介面。(在 GitHub上 檢視原始碼)
• bitmark-webui - 透過網頁瀏覽器來檢視及控制 Bitmark 節點的使用者介面網頁。

安裝

請依照以下四個步驟來完成安裝 Bitmark 節點軟體：

一、安裝 Docker

Bitmark 節點軟體是透過獨立運作的 Docker container 來發布。首先請在您的作業系統上安裝 Docker：

• 取得 Docker for MacOS
• 取得 Docker for Windows
• 取得 Docker for CentOS
• 取得 Docker for Debian
• 取得 Docker for Fedora
• 取得 Docker for Ubuntu
• 取得 Docker for AWS
• 取得 Docker for Azure

二、下載 Bitmark 節點

成功安裝 Docker 之後，您就可以下載 Bitmark 節點了。請先開啟命令列終端機或是命令提示字元，例如在 Mac 上的 Terminal 或是在 Windows 上的cmd.exe。然後輸入以下的指令來下載 Bitmark 節點軟體：

docker pull bitmark/bitmark-node-docker

輸入 pull 的指令之後，下載應該就會開始執行。成功下載完成後，您會收到以下訊息：

Status: Downloaded newer image for bitmark/bitmark-node-docker:latest

三、執行 Bitmark 節點

成功下載 Bitmark 節點之後，複製並貼上以下的指令於在命令列終端機上以執行 Bitmark 節點：

docker run -d --name bitmarkNode -p 9980:9980 \
-p 2136:2136 -p 2130:2130 \
-e PUBLIC_IP=[YOUR_PUBLIC_IP] \
-v $HOME/bitmark-node-data/db:/.config/bitmark-node-docker/db \
-v $HOME/bitmark-node-data/data:/.config/bitmark-node-docker/bitmarkd/bitmark/data \
-v $HOME/bitmark-node-data/data-test:/.config/bitmark-node-docker/bitmarkd/testing/data \
bitmark/bitmark-node-docker

請注意將[YOUR_PUBLIC_IP]置換成節點的對外IP。一旦 Bitmark 節點成功的開始執行，它會回傳一個代表 Bitmark 節點的 Docker container ID 的64字的16進位字串，如：

dc78231837f2d320f24ed70c9f8c431abf52e7556bbdec257546f3acdbda5cd2

當 Bitmark 節點軟體第一次運行的時候，它會為您產生一個 Bitmark 帳號，其中包含您的公鑰與密鑰組。

如欲了解run指令的各種選項，請於命令列終端機上輸入以下的指令：

docker run --help

四、在網頁使用者介面上開啟服務

Bitmark節點包含了一個用於檢視及控制的網頁使用者介面。執行了第三步驟並且運行了Bitmark節點之後，您可以開啟網頁使用者介面來啟動bitmarkd及recorderd選項程式。

在多數的電腦系統中，網頁使用者介面可以用localhost位址(127.0.0.1)上的9980連接埠來存取，如下面的鏈結：

http://127.0.0.1:9980

載入網頁使用者介面之後，您可以在上面啟動兩個主要的 Bitmark 節點程式：

1. bitmarkd - 負責驗證 Bitmark 交易並記錄於 Bitmark 區塊鏈上（所有 Bitmark 節點都必須執行此程式）
2. recorderd - 負責運算 Bitmark 區塊鏈的工作量證明演算法，該演算法決定一個節點是否贏得某區塊並獲得獎金（此為選項程式）

第一次開始執行bitmarkd之後，節點會經過一個Resynchronizing的同步階段。此階段會下載目前 Bitmark 區塊鏈上的資訊至您的節點。一旦同步階段完成之後，您的 Bitmark 節點會開始為最新的區塊做驗證並且記錄交易。

設定選項

目前的區塊鏈

Bitmark 節點有兩種 Bitmark 區塊鏈讓參與者選擇：

• bitmark - 正式的 Bitmark 區塊鏈
• testing - 一個專門給開發用的testnet版本區塊鏈

參與節點的使用者可以在網頁使用者介面上面選擇其中一種來作為目前的區塊鏈。要注意的是轉換至不同的鏈時會需要在網頁使用者介面上重啟新鏈的bitmarkd及recorderd程式。

無論是bitmark或testing區塊鏈，Bitmark 系統都會給予贏得區塊的人獎金。

付款地址

Bitmark 節點的參與者在bitmark或testing上運行bitmarkd及recorderd並且贏得區塊之後，會得到獎金作為獎勵。獎金會（依照當時的加密貨幣價格及確認時間）以 bitcoin 或 litecoin 的形式支付至指定的 bitcoin 或 litecoin 付款位址。

當第一次執行 Bitmark 節點軟體時，安裝程式會自動產生一組預設的 bitcoin 及 litecoin 付款地址。這些地址可以從 Bitmark 節點網頁使用者介面上檢視及設定。

Docker執行命令選項

運行 Bitmark 節點時，在命令列終端機中使用 Docker run 指令可以做許多不同的環境設定，如連接埠及 IP 位址：

docker run -d --name bitmarkNode -p 9980:9980 \
-p 2136:2136 -p 2130:2130 \
-e PUBLIC_IP=[YOUR_PUBLIC_IP] \
-v $HOME/bitmark-node-data/db:/.config/bitmark-node-docker/db \
-v $HOME/bitmark-node-data/data:/.config/bitmark-node-docker/bitmarkd/bitmark/data \
-v $HOME/bitmark-node-data/data-test:/.config/bitmark-node-docker/bitmarkd/testing/data \
bitmark/bitmark-node-docker

下表列出了許多run指令可執行的設定選項：

選項	預設值	說明
-name	bitmarkNode	為 Bitmark 節點所在的 Docker container 命名
-p	9980	網頁使用者介面的網頁伺服器連接埠
-p	2136	連接至其他節點的 bitmarkd 的連接埠
-p	2135	連接至其他節點的 bitmarkd 的連接埠
-p	2130	Bitmark 節點 RPC 伺服器的連接埠
-e	PUBLIC_IP=[YOUR_PUBLIC_IP]	註冊節點公有 IP 位址的環境參數

Docker Compose 設定

熟悉 Docker Compose 的參與者可以使用內附的 docker-compose.yml 檔案做為設定 Bitmark 節點服務的範例。

可設定的選項有：

• 環境：
  • PUBLIC_IP: 您的公開 IP 位址
• 連接埠:
  • 2130: RPC 伺服器連接埠
  • 2135 & 2136: Peering 連接埠
  • 9980: 網頁伺服器連接埠 (提示：請確認使用 TCP 設定您的網路的 port forwarding 以確保公共網路可以存取您的節點)
• Volumes:
  • /.config/bitmark-node-docker/bitmarkd/bitmark/data - 用於儲存bitmark的資料
  • /.config/bitmark-node-docker/bitmarkd/testing/data - 用於儲存testing的資料

更新

欲更新 Bitmark 節點軟體，請完成以下三個步驟：

ㄧ、下載最新版本的節點

欲更新 Bitmark 節點軟體至最新版本，開啟命令列終端機或命令提示字元，例如在 Mac 上的 Terminal 或是在 Windows 上的cmd.exe。然後輸入以下的指令來下載 Bitmark 節點軟體更新：

docker pull bitmark/bitmark-node-docker

輸入 pull 指令之後，下載應該就會開始執行。成功下載完成後，您會收到以下訊息：

Status: Downloaded newer image for bitmark/bitmark-node-docker:latest

二、執行 Bitmark 節點

成功下載軟體更新之後，請在命令列終端機利用下列指令，移除舊版節點並重新運行節點：

docker rm -f bitmarkNode
docker run -d --name bitmarkNode -p 9980:9980 \
-p 2136:2136 -p 2130:2130 \
-e PUBLIC_IP=[YOUR_PUBLIC_IP] \
-v $HOME/bitmark-node-data/db:/.config/bitmark-node-docker/db \
-v $HOME/bitmark-node-data/data:/.config/bitmark-node-docker/bitmarkd/bitmark/data \
-v $HOME/bitmark-node-data/data-test:/.config/bitmark-node-docker/bitmarkd/testing/data \
bitmark/bitmark-node-docker

三、在網頁使用者介面重新啟動服務

最後，在網頁使用者介面上重啟bitmarkd及選擇性重啟recorderd程式。在多數的電腦系統中，網頁使用者介面可以用localhost位址(127.0.0.1)上的9980連接埠來存取，如下面的鏈結：

http://127.0.0.1:9980

載入網頁使用者介面之後，您可以在上面啟動兩個主要的 Bitmark 節點程式：

1. bitmarkd - 負責驗證 Bitmark 交易並記錄於 Bitmark 區塊鏈上（所有 Bitmark 節點都必須執行此程式）
2. recorderd - 負責運算 Bitmark 區塊鏈的工作量證明演算法，該演算法決定一個節點是否贏得某區塊並獲得獎金（此為選項程式）

重新執行bitmarkd之後，節點會經過一個Resynchronizing的同步階段。此階段會下載目前 Bitmark 區塊鏈上的資訊至您的節點。一旦同步階段完成之後，您的 Bitmark 節點會開始為最新的區塊做驗證並且記錄交易。

Tài liệu Bitmark Node

Giới thiệu

Phần mềm Bitmark node cho phép bất kỳ máy tính nào trên mạng Internet tham gia vào mạng lưới Bitmark một cách bình đẳng và được xác thực đầy đủ. Thay vì lệ thuộc vào một số tổ chức chính phủ đáng tin cậy để bảo vệ hệ thống tập trung như trong các hệ thống xác thực tài sản thông thường, hệ thống Bitmark blockchain là một hệ thống xác thực tài sản mở và minh bạch được bảo vệ nhờ sự tham gia tích cực của bất kỳ ai trên mạng Internet. Để bảo đảm tính toàn vẹn cho hệ thống mã nguồn mở Bitmark, chúng tôi xây dựng một hệ thống chạy node Bitmark được vận hành bởi một mạng lưới ngang hàng những người tham gia tự nguyện. Họ được khuyến khích tham gia việc xác minh các giao dịch tài sản trên Bitmark và được trả công bằng tiền mặt hoặc hiện vật.

Bitmark Blockchain là một chuỗi độc lập được tối ưu hóa để lưu trữ các chứng nhận sở hữu, hoặc bitmarks, và không có đồng tiền riêng (phí giao dịch được tính bằng bitcoin hoặc litecoin). Mạng ngang hàng được viết trên Go và sử dụng ZeroMQ distributed messaging library. ính đồng thuận giữa các node được đảm bảo bằng các phép tính mã hóa theo thuật toán mã hóa Argon2 hay còn gọi là phép toán chứng thực.

*Mời các bạn tham khảo chính sách Quản trị của chúng tôi để tìm hiểu cách đóng góp cho dự án này

Các Nền tảng được hỗ trợ

Phần mềm Bitmark node được xây dựng dưới dạng một bộ độc lập, Docker container, có thể dễ dàng cài đặt trên tất cả các nền tảng chính, bao gồm:

• Các thiết bị để bàn, như Mac và Windows
• Các máy chủ sử dụng hệ điều hành Linux, như CentOS, Debian, Fedora, và Ubuntu
• Các nhà cung cấp, như AWS và Azure

Nội dung

Hệ thống Bitmark node bao gồm các chương trình phần mềm dưới đây:

• bitmarkd — sử dụng để xác minh và lưu trữ thông tin các giao dịch Bitmark lên hệ thống Bitmark blockchain (view source code on GitHub)
• recorderd — một ứng dụng bổ trợ cho việc thực hiện các phép toán chứng thực của Bitmark cho phép các node cạnh tranh để giành được các khối trên hệ thống Bitmark blockchain (view source code on GitHub)
• bitmark-wallet — một hệ thống ví điện tử tích hợp để nhận các khoản thanh toán Bitcoin và Litecoin cho những người chạy node giành được khối (view source code on GitHub)
• bitmark-cli — giao diện dòng lệnh cho chương trình bitmarkd (view source code on GitHub)
• bitmark-webui — giao diện người dùng dưới dạng trang web dùng để theo dõi và định cấu hình hệ thống Bitmark node thông qua trình duyệt web

Cài đặt

Để cài đặt phần mềm Bitmark node, các bạn hãy làm theo 4 bước sau đây:

1. Cài đặt Docker

Vì phần mềm Bitmark node được xây dựng dưới dạng một bộ độc lập Docker container nên trước tiên bạn cần cài đặt Docker cho hệ điều hành của mình:

• Tải Docker CE cho Mac
• Tải Docker Toolbox cho Windows 10 Home và Windows 8
• Tải Docker CE cho Windows 10 Pro, Education và Enterprise
• Tải Docker CE cho CentOS
• Tải Docker CE cho Debian
• Tải Docker CE cho Fedora
• Tải Docker CE cho Ubuntu
• Tải Docker CE cho AWS
• Tải Docker CE cho Azure

2. Tải phần mềm Bitmark Node

Sau khi cài đặt thành công Docker, bạn có thể tải xuống phần mềm Bitmark node. Để làm như vậy, trước tiên bạn hãy mở một terminal dạng dòng lệnh hoặc ứng dụng shell, chẳng hạn như Terminal trên MacOS hoặc Linux hoặc cmd.exe tr Windows. Sau đó bạn hãy nhập lệnh sau để tải xuống phần mềm Bitmark node:

docker pull bitmark/bitmark-node-docker

Sau khi nhập lệnh pull, quá trình tải xuống sẽ bắt đầu trên terminal. Sau khi quá trình tải xuống hoàn tất, bạn sẽ nhận được thông báo như sau:

Status: Downloaded newer image for bitmark/bitmark-node-docker:latest

3. Chạy Bitmark Node

Chuẩn bị Public IP

IP công khai (Public IP) là một IP mà mọi người trên Internet có thể sử dụng để tiếp cận bitmark-node-docker của bạn. Mã lệnh của chúng tôi sẽ tự động tìm IP công khai cho bạn. Tuy nhiên, do cấu hình mạng rất đa dạng nên chúng tôi sẽ khó có thể đảm bảo tính chính xác cho IP tự động tạo ra. Do đó, để có được mã IP công khai chính xác, vui lòng tham khảo ý kiến từ ISP của bạn.

Chuẩn bị Môi Trường Mạng

• Người dùng cần phải chắc chắn các cổng (port) sau có thể truy cập được qua Internet.

  CỔNG	MÔ TẢ
  2136	Cổng để kết nối với các node bitmarkd ngang hàng khác
  2135	Cổng để công bố các sự kiện blockchain
  2130	Cổng cho server Bitmark node RPC RPC server

  Trong quá trình chạy bitmark-node-docker, người dùng có thể đảm bảo các cổng được mở bằng các lệnh sau.

  netcat -v [Your Public IP] 2136

  netcat -v [Your Public IP] 2135

  netcat -v [Your Public IP] 2130

• WebUI là một giao diện dùng để kiểm soát bitmark-node-docker. Người dùng chỉ có thể truy cập vào WebUI thông qua mạng cục bộ. Xin lưu ý rằng người dùng không thể truy cập cổng từ internet vì lý do bảo mật.

  CỔNG	MÔ TẢ
  9980	Cổng server Web cho webUI

Tự động cập nhật

Hệ thống mặc định rằng mỗi tập lệnh sẽ chứa một tùy chọn để kiểm tra các phiên bản cập nhật mỗi khi chạy tập lệnh. Để có thể tắt chế độ này, bạn cần mở tập lệnh trong một trình chỉnh sửa văn bản và thay chữ true trong câu lệnh AUTO_UPDATE=true thành false. Thao tác này có thể được tìm thấy ở phần đầu của tập lệnh mang tên User Defined Variables. Hãy chắc chắn rằng bạn không làm thay đổi trích dẫn trong tập lệnh gốc.

Thiết lập Tập lệnh

• Người dùng Linux

  • Tải xuống tập lệnh thiết lập bitmarkNode-Linux-MacOS.sh và chạy nó. Bạn có thể nhấp phải chuột và chọn open để để mở nó. Open With Terminal.

  • chạy lệnh bash bitmarkNode-Linux-MacOS.sh [IP công khai của bạn]. Khi chạy tập lệnh mà không cung cấp [IP công khai của bạn] tập lệnh sẽ tìm IP của bạn trên Internet Ví dụ:

    Ví dụ:

    bash bitmarkNode-Linux-MacOS.sh 117.166.111.123
    
    bash bitmarkNode-Linux-MacOS.sh
    

  • Nếu tập lệnh không chạy, nhấp chuột phải vào nó, chọn properties, vào tab permissions và nhấp chuột chọn "Allow this file to run as a program".

• Người dùng Windows chạy Docker trên Hyper-V (Windows 10 Pro and Enterprise)

  • Hãy chắc chắn rằng bạn đã bật Hyper-V

  • Tải xuống thiết lập tập lệnh và nhấp phải chuột để mở nó, và chọn Run as administrator. bitmarkNode-HyperV.bat

  • Thực hiện lệnh bitmarkNode-HyperV.bat [IP công khai của bạn]. Khi chạy tập lệnh mà không cung cấp [IP công khai của bạn], tập lệnh sẽ tìm IP của bạn trên Internet

    Ví dụ:

    bitmarkNode-HyperV.bat 117.166.111.123
    
    bitmarkNode-HyperV.bat
    

• Người dùng MacOS

  • Tải xuống thiết lập tập lệnh bitmarkNode-Linux-MacOS.sh và chạy nó. Bạn có thể chạy tập lệnh bằng cách mở một Terminal, di chuyển đến mục tải xuống (download) trong terminal của bạn (nếu mục tải xuống của bạn là Downloads, bạn có thể nhập cd Downloads)

  • Thực hiện lệnh bash bitmarkNode-Linux-MacOS.sh [IP công khai của bạn]. Khi chạy tập lệnh mà không cung cấp [IP công khai của bạn], tập lệnh sẽ tìm IP của bạn trên Internet

    Ví dụ:

    bash bitmarkNode-Linux-MacOS.sh 117.166.111.123
    
    bash bitmarkNode-Linux-MacOS.sh
    

Các thiết lập trong tương lai

Docker Container phải được khởi động lại mỗi khi tắt máy tính. Để khởi động lại container, bạn chỉ cần chạy lại tập lệnh như lần đầu tiên bạn làm. Bạn còn có thể khởi động lại theo cách thủ công theo các bước dưới đây. Cần chú ý rằng, nếu bạn không bật chế độ tự động cập nhật cho tập lệnh, khi bạn khởi động lại theo cách thủ công thì các cập nhật sẽ không được kiểm tra.

Thiết lập thủ công

Tất cả những dòng lệnh sau sẽ được chạy trên những giao diện dòng lệnh tương ứng theo mô tả dưới đây. Trước khi chạy bộ chứa bitmark-node-docker, bạn nên kiểm tra trạng thái của container:

1. Chạy docker ps -a để kiểm tra đã có bộ chứa bitmarkNode hay chưa.

2. Kiểm tra "Status"

   • Status: Up to [time] : chương trình bitmarkNode đang chạy. Bạn có thể để bộ chứa tiếp tục chạy hoặc tắt nó bằng lệnh docker stop bitmarkNode. Sau đó bạn có thể xóa bộ chứa bằng lệnh docker rm bitmarkNode.
   • Status: Exit: chương trình bitmarkNode đang tạm dừng nhưng vẫn còn bộ chứa. Trong trường hợp này, bạn có thể khởi động bộ chứa bằng lệnh docker start bitmarkNode, hoặc bạn có thể dùng lệnh docker rm bitmarkNode để xóa bộ chứa. Để khởi động lại bộ chứa, bạn phải chạy lại thiết lập tập lệnh như lần đầu tiên bạn làm với hệ điều hành bạn đang sử dụng.

---

Thông tin chung

Khi phần mềm Bitmark node đã khởi động thành công, nó sẽ trả về cho bạn một ID cho bộ chứa Docker của Bitmark node dưới dạng chuỗi thập lục phân gồm 64 ký tự, chẳng hạn như:

dc78231837f2d320f24ed70c9f8c431abf52e7556bbdec257546f3acdbda5cd2

Khi phần mềm Bitmark node được sử dụng lần đầu tiên, nó sẽ tạo cho bạn một tài khoản Bitmark, bao gồm bộ khóa công khai và khóa riêng tư.

Tùy chọn lệnh chạy Docker

Khi đang chạy phần mềm Bitmark node, bạn có thể định cấu hình cho các cài đặt môi trường Bitmark node khác nhau, ví dụ như các cổng và các địa chỉ IP bằng cách sử dụng lệnh run trên Docker từ terminal:

docker run -d --name bitmarkNode -p 9980:9980 \
-p 2136:2136 -p 2130:2130 \
-e PUBLIC_IP=[YOUR_PUBLIC_IP] \
-e NETWORK=[YOUR_NETWORK] \
-v $HOME/bitmark-node-data/db:/.config/bitmark-nod-docker/db \
-v $HOME/bitmark-node-data/data:/.config/bitmark-node-docker/bitmarkd/bitmark/data \
-v $HOME/bitmark-node-data/data-test:/.config/bitmark-node-docker/bitmarkd/testing/data \
bitmark/bitmark-node-docker

Cần lưu ý rằng YOUR_PUBLIC_IP phải được thay thế bằng địa chỉ IP công khai (public IP) của bạn và ```[YOUR_NETWORK] phải được thay thế bằng một lựa chọn được mô tả tại đây.

Bảng dưới đây mô tả những tùy chọn cấu hình khác nhau cho lệnh run của Bitmark node:

OPTION	DEFAULT	DESCRIPTION
-name	bitmarkNode	Assigns a name to the Bitmark node Docker container.
-p	9980	Web server port for web UI
-p	2136	Port for connecting to other peer bitmarkd nodes
-p	2135	Port for publishing blockchain events
-p	2130	Port for Bitmark node RPC server
-e	PUBLIC_IP=[YOUR_PUBLIC_IP]	Environment variable for register your public IP address.
-e	NETWORK=[YOUR_NETWORK]	Either bitmark or testing. Learn more about the two networks here

Để biết thêm về các tuỳ chọn của lệnh run, nhập lệnh sau vào terminal:

docker run --help

Terminals

Mỗi phiên bản Docker sẽ sử dụng trình thông dịch dòng lệnh (CLI) khác nhau tùy thuộc vào Hệ điều hành. Bạn có thể xem bảng dưới đây để tìm CLI phù hợp cho việc đồng bộ Hệ điều hành và Docker của bạn:

Operating System (Docker Version)	CLI
Linux (Docker for Linux)	Terminal
Windows 8 or 10 Home (Docker Toolbox)	Docker Quickstart Toolbox
Windows 10 Pro or Enterprise (Docker for Windows)	cmd.exe
MacOS (Docker for Mac)	Terminal

4. Khởi động dịch vụ trên giao diện Web

Phần mềm Bitmark bao gồm một giao diện người dùng dạng web để theo dõi và kiểm soát Bitmark node trong trình duyệt web. Sau khi thực hiện bước 3 trong các bước chạy Bitmark node, bạn nên chạy web UI để khởi động chương trình bitmarkd và recorderd (không bắt buộc).

Trên phần lớn các máy tính, bạn có thể truy cập vào web UI qua cổng 9980 của địa chỉ localhost (127.0.0.1) bằng cách nhấn vào đường link sau:

http://127.0.0.1:9980.

Sau khi chạy web UI, bạn nên sử dụng nó để khởi động 2 chương trình phần mềm Bitmark node chính:

1. bitmarkd — sử dụng để xác minh và lưu trữ thông tin các giao dịch Bitmark lên hệ thống Bitmark blockchain (cần thiết cho tất cả các Bitmark nodes)
2. recorderd — cần có để giải các thuật toán chứng thực của hệ thống Bitmark blockchain cho phép các node giành các khối trên hệ thống và nhận tiền thưởng (tùy chọn)

Sau khi khởi động lại bitmarkd node lần đầu tiên, Node sẽ thực hiện quá trình Resynchronizing trong đó một bản sao của hệ thống Bitmark blockchain sẽ được tải xuống phần mềm Bitmark node của bạn. Sau khi giai đoạn Đồng bộ hóa đã hoàn tất, phần mềm Bitmark node của bạn sẽ bắt đầu xác minh và lưu trữ thông tin của các giao dịch cho khối hiện tại.

Tổng quan về Giao diện Người dùng

1. Màn hình đăng nhập

Trên màn hình đăng nhập, bạn có thể nhập cụm từ khôi phục gồm 24 từ của mình để đăng nhập vào tài khoản hiện có hoặc bạn có thể lập một tài khoản mới. Khi bạn lập một tài khoản mới, bạn sẽ được cung cấp một cụm từ khôi phục gồm 24 từ để bạn có thể đăng nhập vào tài khoản đó sau khi khởi động lại bộ chứa Docker. Bạn cũng sẽ được yêu cầu nhập địa chỉ ví Bitcoin và Litecoin để có thể nhận tiền thưởng cho việc xác minh giao dịch tài sản Bitmark sau này (bạn có thể thay đổi những địa chỉ đó bất kỳ lúc nào). Nếu bạn không có ví bitcoin hay litecoin, xem thông tintại đây.

2. Màn hình Khởi tạo

Trên màn hình này, bạn có thể khởi động hai phần chính của phần mềm Bitmark Node là bitmarkd và recorderd. Bằng cách nhấp vào biểu tượng hình người ở phía trên cùng màn hình, bạn có thể: xem các khối bạn đã giành được, ghi lại cụm từ khôi phục của bạn hay sao chép địa chỉ tài khỏa của mình. Bằng cách nhấp vào biểu tượng 3 dấu ngang, bạn có thể thay đổi ngôn ngữ sử dụng và xem các tài liệu Bitmark Node. Bạn cũng có thể thay đổi địa chỉ ví tiền ảo của mình trong phầnBitmark Wallet.

3. Màn hình thực thi

Khi bạn khởi động phần mềm bitmarkd một menu với kích thước đầy đủ như trên sẽ xuất hiện.

• Bitmark Node (bitmarkd):
  • Status: Stopped hoặc Running. Mô tả trạng thái của phần mềm bitmarkd.
  • Connection: Trong quá trình khởi tạo, chương trình hiển thị trạng thái Checking connection…. Sau khi đã kết nối mạng, chương trình sẽ hiện số lượng node đã được kết nối. Bạn cần có kết nối giữa ba node để có thể chạy thành công phần mềm Bitmark Node.
• Recorder Node (recorderd)
  • Status: Stopped hoặc Running. Mô tả trạng thái của phần mềm recorderd.
• Network ID
  • Đây là khoá công khai cho tài khoản bitmark của bạn
• Current Block
  • Hiển thị block hiện tại trên hệ thống của bạn. Nó có thể là block cuối cùng trên blockchain, hoặc block mà bạn mới nhất mà bạn đang đồng bộ.
• Transaction Counter
  • Pending: Số lượng giao dịch đang Pending
  • Verified: Số lượng giao dịch đã được Verified
• Uptime
  • Mô tả tổng thời gian chạy của Docker container.
• Your Blocks
  • Mỗi block trong mục này là một block mà bạn đã đào được, bao gồm ngày tháng và thời gian đào được, block number, hash, và "solution" của block đó.

Tuỳ chọn Cấu hình

Blockchain Hiện tại

Phần mềm Bitmark node cho phép người tham gia xác minh và lưu trữ thông tin về các giao dịch giữa hai Bitmark blockchain khác nhau:

• bitmark — phiên bản chính thức của Bitmark blockchain
• testing — Phiên bản testnet của Bitmark blockchain được sử dụng cho mục đích thử nghiệm trong quá trình phát triển

Những người tham gia chạy node có thể chọn blockchain họ đang làm xử lý thông qua web UI. Cần lưu ý rằng bạn sẽ phải khởi động lại bộ chứa Docker và chọn một mạng mới khi muốn chuyển sang một blockchain khác.

Hệ thống Bitmark trao tiền thưởng cho những người giành được khối đối với cả bitmark và testing blockchain.

Địa chỉ Payment

Người dùng phần mềm Bitmark node chạy cả bitmarkd và recorderd đều được nhận tiền thưởng khi giành được khối đối trên cả bitmark và testing blockchains. Tiền thưởng này sẽ được chuyển dưới dạng bitcoin hoặc litecoin (tương ứng theo giá của đồng tiền ảo tại thời điểm đó và thời gian xác nhận) và được chuyển tới địa chỉ tài khoản bitcoin và litecoin mà người chạy node đã cung cấp.

Khi người dùng chạy phần mềm Bitmark node lần đầu tiên, họ sẽ được yêu cầu cung cấp địa chỉ ví bitcoin và litecoin của họ. Nếu bạn chưa có ví bitcoin hay litecoin thì bạn hoàn toàn có thể tạo cho mình một ví trực tuyến hết sức đơn giản. Một giải pháp trực tuyến đơn giản là sử dụng coinbase, nhưng nhìn chung chúng tôi chấp nhận bất kỳ loại ví trực tuyến nào.

Cập nhật

Nếu bạn tắt chế độ tự động cập nhật trong tập lệnh thiết lập của mình, bạn có thể cập nhật phần mềm Bitmark node theo 3 bước dưới đây:

1. Tải Phiên bản Node mới nhất

Để có thể cập nhật phiên bản mới cho phần mềm Bitmark node của mình, bạn cần mở terminal dạng dòng lệnh hoặc ứng dụng shell, chẳng hạn như Terminal trên MacOS hoặc Linux hoặc cmd.exe trên Windows 10 Pro hoặc Enterprise, hoặc Docker Quickstart Terminal trên Windows 8 hoặc 10 Home, sau đó nhập lệnh sau để tải xuống phiên bản cập nhật cho phần mềm:

docker pull bitmark/bitmark-node-docker

Sau khi nhập lệnh pull, quá trình tải xuống sẽ bắt đầu trên terminal. Sau khi quá trình tải xuống hoàn tất, bạn sẽ nhận được thông báo như sau:

Status: Downloaded newer image for bitmark/bitmark-node-docker:latest

2. Chạy Bitmark Node

Sau khi đã tải xong phiên bản cập nhật cho phần mềm, bạn cần xóa bộ chứa trước đó và khởi tạo một bộ chứa mới qua giao diện dòng lệnh:

docker rm -f bitmarkNode
docker run -d --name bitmarkNode -p 9980:9980 \
-p 2136:2136 -p 2130:2130 \
-e PUBLIC_IP=[YOUR_PUBLIC_IP] \
-e NETWORK=[YOUR_NETWORK]
-v $HOME/bitmark-node-data/db:/.config/bitmark-node-docker/db \
-v $HOME/bitmark-node-data/data:/.config/bitmark-node-docker/bitmarkd/bitmark/data \
-v $HOME/bitmark-node-data/data-test:/.config/bitmark-node-docker/bitmarkd/testing/data \
bitmark/bitmark-node-docker

Cần LƯU Ý thay [YOUR_PUBLIC_IP] bằng địa chỉ IP công khai (public IP) của bạn, và [YOUR_NETWORK với bitmark hoặc testing.

3. Restart Services qua Web Interface

Cuối cùng, khởi động lại chương trình bitmarkd và recorderd (không bắt buộc) thông qua web UI. Trên phần lớn các máy tính, bạn có thể truy cập vào web UI qua cổng 9980 với địa chỉ localhost (127.0.0.1) bằng cách nhấp vào đường link sau:

http://127.0.0.1:9980.

Sau khi tải được web UI, bạn nên sử dụng nó để khởi động 2 chương trình phần mềm Bitmark node chính:

1. bitmarkd — sử dụng để xác minh và lưu trữ thông tin các giao dịch Bitmark lên hệ thống Bitmark blockchain (cần thiết cho tất cả các Bitmark nodes)
2. recorderd — cần có để giải các thuật toán chứng thực của hệ thống Bitmark blockchain cho phép các node giành các khối trên hệ thống và nhận tiền thưởng (tùy chọn)

Sau khi khởi động lại bitmarkd node lần đầu tiên, Node sẽ thực hiện quá trình Resynchronizing trong đó một bản sao của hệ thống Bitmark blockchain sẽ được tải xuống phần mềm Bitmark node của bạn. Sau khi giai đoạn Đồng bộ hóa đã hoàn tất, phần mềm Bitmark node của bạn sẽ bắt đầu xác minh và lưu trữ thông tin của các giao dịch cho khối hiện tại.

Xử lý sự cố

Listening port (2136) is not accessible.

• Bạn có thể gặp phải sự cố này nếu bạn cung cấp sai địa chỉ IP, hoặc địa chỉ IP của bạn thay đổi trong quá trình thiết lập. Bạn phải dừng chạy node qua Terminal (MacOS/Linux), cmd.exe (Windows 10 Pro và Enterprise), hoặc thông qua Docker Quickstart Terminal (Windows 8 or 10 Home) bằng cách gõ lệnh docker stop bitmarkNode. Sau đó bạn phải xóa bộ chứa bằng lệnh docker rm bitmarkNode. Giờ bạn cần chạy lại tệp lệnh (nếu bạn sử dụng tập lệnh thiết lập Docker Toolbox, bạn phải tìm lại địa chỉ IP công khai của mình bằng cách truy cập ipinfo.io/ipvà nhập lại địa chỉ IP của bạn và script setup).
• This can also be caused by your router's NAT (Network Address Translation) not allowing you to access port 2136, the port used to connect to other bitmarkd nodes. To allow the node software to access this port, you must enable port forwarding on your router and forward port 2136. A good guide on how to do this is linked here.

Sử dụng Docker Toolbox trên Windows

• Mặc dù Windows không chính thức hỗ trợ Docker Toolbox, bạn có thể thực hiện theo các bước sau
• Người dùng Windows chạy bộ chứa Docker trong Toolbox (Windows 8 và 10 Home)

  • Bộ chứa Docker trong Toolbox không được chính thức hỗ trợ, nhưng

  • Thiết lập port forwarding trong Docker VirtualMachine:

    • Mở Oracle VM VirtualBox và điều hướng đến máy ảo docker có tiêu đề mặc định/default. Nhấp phải chuột vào máy ảo và vào phần Settings.

    • Đi đến phần Network và chọn một adapter chưa được kích hoạt. Tích vào ô có ghi Enable Network Adapter và chọn phần '''Attached To:''' và chọn NAT. Lựa chọn cài đặt Advanced bằng cách nhấp chuột vào mũi tên bên trái phần chữ và nhấn vào ô có ghi Port Forwarding.

    • Bạn có thể thêm quy luật mới bằng cách chọn dấu + ở phía bên phải. Thêm 4 cổng sau:

      Name	Protocol	Host IP	Host Port	Guest IP	Guest Port
      Docker #1	TCP		9980		9980
      Docker #2	TCP		2136		2136
      Docker #3	TCP		2135		2135
      Docker #4	TCP		2130		2130

  • Chuẩn bị script setup:

    • Tải script. bitmarkNode-Toolbox.bat
    • Mở script trên một trình sửa văn bản bằng việc click chuột phải vào file script và chọn Open With..., sau đó chọn notepad hoặc trình sửa văn bản mà bạn muốn.
    • Thêm địa chỉ IP công khai (public IP) của bạn vào dòng 25 bằng cách dán IP của bạn thay cho đoạn XXX.XX.XX.XX. Bạn có thể tìm thấy địa chỉ IP công khai của bạn bằng cách truy cập ipinfo.io/ip trên cùng thiết bị.
    • Bạn có thể thay đổi đường dẫn tới địa chỉ lưu trữ dữ liệu của phần mềm Bitmark node ở dòng 26. Dữ liệu mặc định được lưu ở ổ /c/. Trong quá trình này, phần mềm sẽ tạo ra một thư mục bitmark-node-data trong thư mục mới. Lưu ý không sử dụng các thư mục người dùng khi đường dẫn bị thay đổi (ví dụ: không sử dụng /c/Users/yourname).
    • Lưu tập lệnh và chuyển nó vào đường dẫn của phần mềm Docker Toolbox (mặc định là C:\Program Files\Docker Toolbox). Cần lưu ý rằng đây không phải là đường dẫn mà bạn được phép thay đổi ở bước trên mà là cài đặt mặc định trong quá trình thiết lập Docker..
    • Mở Docker Quickstart Terminal và chạy script setup bằng lệnh sh bitmarkNode-Toolbox.sh.

Current Block Stuck at 1/1

• Khi phần mềm Bitmark Node khởi động thành công, phần mềm sẽ duy trì ở mức 1/1 khối trong một thời gian ngắn. Nếu node được kết nối thành công với ít nhất 3 khối khác mà phần mềm vẫn dừng ở mức 1/1 trong 1 thời gian dài, bạn cần khởi động lại bộ chứa Docker. Nếu vẫn chưa khắc phục được lỗi này, bạn cần xóa bộ chứa bằng lệnh docker rm bitmarkNode và chạy lại script setup.

HTTP: TLS Handshake Error

• Để khắc phục lỗi này, khởi động lại docker container.

Storage Initialise Error

• Để khắc phục lỗi này, khởi động lại docker container.

Windows Login failed

• Bạn cần đăng nhập vào docker hub trong lần đầu tiên để kéo ảnh về. Nếu bạn đăng nhập và vẫn nhận được thông báo dưới đây, có thể bạn đã sử dụng địa chỉ email để đăng nhập, thay vì usernam.

  Error response from daemon: Get https://registry-1.docker.io/v2/bitmark/bitmark-node-docker/manifests/latest: unauthorized: incorrect username or password