Migration Steps

If you are not setting up a new relay but rather migrating an existing one you can follow the steps below.

• make sure you installed ansible and the this role on your host

ansible-galaxy install nusenu.relayor

see also ansible best practices

• backup your relay's keys
• create your playbook (see examples)
• make sure your playbook contains the ORPort configuration you want to use (see custom ORPorts)
• fill your ansible inventory with your relay hostnames
• ensure SSH authentication to these servers is configured (i.e. pubkey authentication)
• instruct ansible to create the local DataDir folders where we will store all keys:

ansible-playbook yourplaybook -t createdir

This will create an empty folder on the host running ansible for every tor instance, located under

~/.tor/offlinemasterkeys/instance_identifier

instance identifiers/folders are named: servername-ipaddress_orport

• copy your datadirs into these places, in the end every folder should have a keys subfolder (after you copied your datadirs into these locations). Example:

~/.tor/offlinemasterkeys/server1-1.1.1.1_443/keys

• test by running the complete role for a single server, i.e.:

ansible-playbook yourplaybook.yml -l server1