Quick start MCC
This tutorial will guide you through installing Staex (MCC only) in your network. This setup uses user certificate that is signed by Staex and auto-generated node private keys signed by the user certificate. Nodes trust each other only when their keys were signed by trusted user certificate. This setup is your go-to approach for secure deployment of Staex in a real-world scenario. Please, refer to Getting user certificate to learn how to get your user certificate. Please, refer to Generating node certificate to learn how to generate your node's private key and certificate.
All nodes in the network have to have the same user certificate stored under /etc/mcc/user_cert
path to trust each other.
Install MCC
Use a package manager from your Linux distribution to install our software.
Alternatively, unpack the software into /opt/mcc
directory.
- Debian/Ubuntu
- CentOS/Fedora
- OpenWRT
- MacOS X
- Other
apt install ./mcc*.deb
dnf install ./mcc*.rpm
# or yum install ./mcc*.rpm
opkg install ./mcc*.ipk
sudo installer -pkg ./mcc*.pkg -target /
mkdir -p /opt/mcc
tar -C /opt/mcc -xf mcc*.tar.gz
# Please, manually copy files to the respective direcotories in the root file system
# to avoid problems with the permissions.
# install /opt/mcc/bin/* /usr/bin
# install -D /opt/mcc/etc/mcc/mcc.yaml /etc/mcc/mcc.yaml
# install -D /opt/mcc/usr/lib/systemd/system/* /usr/lib/systemd/system
Configure system service
If you are installing Staex on a node in a local area network,
add the address of the bootnode (usually a node with a public IP address) in /etc/mcc/mcc.yaml
file.
boot: IP:9376
# Please, replace IP with the public IP address of the bootnode.
Please, refer to configure bootnodes if you have complex network infrastructure.
Then issue the following commands to start Staex service immediately and on system boot.
- Debian/Ubuntu/CentOS/Fedora
- OpenWRT
- MacOS X
systemctl enable mcc --now
/etc/init.d/mcc enable
/etc/init.d/mcc start
sudo launchctl start io.staex.mcc
- Debian/Ubuntu/CentOS/Fedora
- OpenWRT
- MacOS X
systemctl status mcc
/etc/init.d/mcc status
sudo launchctl list io.staex.mcc
In order to read StaexMCC logs use the following commands.
- Debian/Ubuntu/CentOS/Fedora
- OpenWRT
- MacOS X
journalctl -u mcc -e
logread -l 100 # read the last 100 lines of system log
less -R +G /Library/Logs/mcc.log
Where to go from here
Now that you have installed Staex you can proceed to configure bootnodes if you have complex network infrastructure.