Storage Miner

Section Brief:

• Mount the proper disk for storage

• Install cess-nodeadm

• Set up storage node configuration

• Check if the node has been synced

• The most common operations

• Update the old version program

Mining preparation

The OS requirement of the Storage server is as following:

Item	Parameter
Recommended OS and Version	Linux 64-bit Intel/AMD
CPU Core	≥ 4
Memory	≥ 8 GB
Bandwidth	≥ 5 M
Public network IP	required
Linux Kernel Version	5.11 or higher

⚠️ The following commands are executed with root privileges, if the prompt Permission denied appears, you need to switch to root privileges, or add sudo at the top of these commands.

Firewall configuration

By default, cess-bucket uses port 4001 to listen for incoming connections, if your platform blocks the port by default, you may need to enable the access to the port.

ufw allow 4001

Disk mounting

Check the hard disk status using the df -h command:

df -h

The disk is not mounted If the hard drive for storage mining cannot be found. Use the command below to view unmounted hard disks:

fdisk -l

Disk /dev/vdb: 200 GiB, 214748364800 bytes, 419430400 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: dos
Disk identifier: 0x331195d1

The unmounted disk is /dev/vdb in the demonstration above. We will be using /dev/vdb to demonstrate the mounting operation.

Allocate the /dev/vdb disk：

fdisk /dev/vdb
Enter and press Enter:
n
p
1
2048
the value after default
w

Format the newly divided disk into ext4 format：

mkfs.ext4 /dev/vdb

Enter "y" to continue if the system asks to proceed:

Proceed anyway? (y,N) y

Create /cess directory to mount the disk. Using/cess as an example:

mkdir /cess
echo "/dev/vdb /cess ext4 defaults 0 0" >> /etc/fstab

replace /dev/vdb with your own disk name. /cess has to remain the same as created in the previous step. If you are not under root privileges, try :

echo "/dev/vdb /cess ext4 defaults 0 0" | sudo tee -a /etc/fstab

Mount /cess :

mount -a

Check the disk mounting status:

df -h

If the "/cess" appers, the disk has been successfully mounted.

Prepare CESS Account

Miners need to create two wallet accounts.

• 🤑earning account: used for receiving rewards from mining.

• 🏦staking account: used for staking and signing blockchain transactions.

⚠️Please make sure you have sufficient TCESS before you claim bucket space: Staking amount needed: 4000TCESS/ 1000 GB

Please refer to the CESS Account section above for creating a CESS account. Please go to the CESS faucet to get TCESS. Join CESS telegram to get our assistance.

Install cess-nodeadm

⚠️If you have previously deployed nodeadm on your machine, please jump to this and then go to the next section. If you are new, just ignore it.

wget https://github.com/CESSProject/cess-nodeadm/archive/v0.4.4.tar.gz
tar -xvf v0.4.4.tar.gz
cd cess-nodeadm-0.4.4/
./install.sh

⚠️Please make sure the cess-nodeadm version v0.4.4 is correct, check the most updated version.

If Install cess nodeadm success shows up, the installation is successful .

If the installation fails, please refer to Possible issues during installation

Set up Configuration

Set up bucket configuration

cess config set

# cess config set 
Enter cess node mode from 'authority/storage/watcher' (current: authority, press enter to skip): storage
Enter cess storage listener port (current: 15001, press enter to skip): enter
Enter cess storage earnings account: cXiHsw32kT3Fzw6YeXDTECCfFNKjDVg85eg......
Enter cess storage staking signature phrase: shoe ...... creek metal avoid
Enter cess storage disk path (default: /opt/cess/storage/disk): /cess
Enter cess storage space, by GB unit (current: 300, press enter to skip): 1000
Set configurations successfully

Start bucket

cess start

The following should be seen:

[+] Running 3/0
 ✔ Container chain       Running                                                0.0s 
 ✔ Container bucket      Running                                                0.0s 
 ✔ Container watchtower  Running                                                0.0s 

If the Config process fails, please refer to Possible issues during Config

Check Chain Sync Status

View chain node log

docker logs chain

As shown in the figure below, if we see that the height of the block corresponding to "best" is about the latest height in CESS Explorer, it means the local chain node synchronization is completed.

⚠️Only when the chain synchronization is completed, you can operate other functions such as increase the staking, view the status of the node, etc.

Common Operations

View storage node log

docker logs bucket

As shown in the figure below, it is the log information when the storage node starts normally. It shows: the rpc address used by the storage node and the address of the boot node, the connection to the boot node, its own peer id, the chain network and the p2p network, the synchronization information of the currently used chain node, and the workspace.

⚠️The chain network must be consistent with the p2p network.

⚠️Do not delete or change files in the workspace.

View bucket status

cess bucket stat

An example of the returned results is shown below：

see specific explanation of the names above in Appendix

Increase the staking

cess bucket increase <deposit amount>

Withdraw staking

cess bucket withdraw

⚠️You need to exit first.

Query reward information

cess bucket reward

Claim reward

cess bucket claim

Update all service images

cess pullimg

Stop and remove all service

cess down

Update earnings account

cess bucket update earnings [earnings account]

Exit the CESS network

cess bucket exit

⚠️ Please use this command carefully, once you exit, you cannot resume.

New version upgrade

Stop and remove all service

cess stop
cess down

Remove all program data

cess purge

⚠️ Do not perform this operation unless the CESS network has been redeployed and it is confirmed that the data can be cleared.

Update the cess-nodeadm

wget https://github.com/CESSProject/cess-nodeadm/archive/v0.4.4.tar.gz
tar -xvf v0.4.4.tar.gz
cd cess-nodeadm-0.4.4/
./install.sh --skip-dep --retain-config

⚠️ Please make sure the cess-nodeadm version v0.4.4 is correct, check the most updated version.

Pull images

cess pullimg

Set up Configuration

Appendix

peer id	The id for peer communication.
state	Positive: Working fine Frozen: Out of staking Exit: Quiting the network as a storage miners Offline: Being kicked out of the network
staking amount	The amount of TCESS being staked.
validated space	The sapce validated to store user's data.
used space	The space used by storage users.
locked space	The space locked when waiting for users' data being uploaded.
staking account	The account to stake TCESS(>4000).
earnings account	The account to earn space reward.