Revision as of 18:52, 11 July 2025

⚠️ This Documentation only applies to Shards to be added to Ryzom network. ⚠️

So no require Database and some ports must be opened to Ryzom Servers.

Up a fully independent shard can probably be done using https://wiki.ryzom.dev/ doc

Requirements to install a shard (for a comfortable use):

• Choose a name for the shard (Arme/Atys, Yubo, Gingo, Rendor are already used). We call it on this doc the SHARDNAME
• Have a hardware with at least 8 cores with +3Ghz and 16Go of ram
• Have at least 100Go of disk space (no matter SSD or not)
• Have a domain name
  • ⚠️ Please check the file /etc/hosts. The domain name must be linked to outgoing address like :

    37.187.139.90 gingo.ryzom.com gingo

STEP 1 : Install Salt Minion

• run as root:

# Ensure keyrings dir exists
mkdir -p /etc/apt/keyrings
# Download public key
curl -fsSL https://packages.broadcom.com/artifactory/api/security/keypair/SaltProjectKey/public | sudo tee /etc/apt/keyrings/salt-archive-keyring.pgp
# Create apt repo target configuration
curl -fsSL https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.sources | sudo tee /etc/apt/sources.list.d/salt.sources
apt install salt-minion
echo "master: cloud.ryzom.com" > /etc/salt/minion

• Edit /etc/salt/minion_id and change the name of Minion to SHARDNAME
• Restart the service:

systemctl restart salt-minion

• On ports 4505 and 4506 to cloud.ryzom.com server

• On cloud.ryzom.com server, as root:

salt-key -A
# If all works correctly, You will show you minion and can accept it

• Test it with (on cloud.ryzom.com):

salt '*' test.version

STEP 2 : Run salt init

The salt master are installed in cloud.ryzom.com, so all commands must be run on this server. To init the shard, run:

sudo sh /home/data/monitoring/salt/files/init_minions.sh SHARDNAME