add renumbering procedure for openstack VMs

howto/openstack.md

@@ -32,7 +32,7 @@ notes:
     we could also have used existing flavor size if we needed a larger
     disk
  7. click "Next" to go to the "Networks" tab
- 8. click on the arrow on the "iaas.torproject.org" line
+ 8. click on the arrow on the `sunet.se-public` line
  9. go to the "Security groups" tab and pick "anything"
  10. add the anarcat keypair, create a new one for you if missing, but
      add it too
@@ -214,6 +214,42 @@ allocate a floating IP and route it to the instance.
 
         openstack server add floating ip build-arm-10.torproject.org 213.146.141.28
 
+## Renumbering a server
+
+To renumber a server in Openstack, you need to first create a port,
+associate it with the server, remove the old port, and renumber IP
+elsewhere.
+
+Those steps were followed for `ns5`:
+
+ 0. Make sure you have access to the server through the web console first.
+
+ 1. add the new port:
+
+        openstack port create --network sunet.se-public ns5.torproject.org
+
+ 2. assign it in the right security group:
+
+        openstack port set --security-group anything ns5.torproject.org
+
+ 3. attach the port to the instance:
+
+        openstack server add port ns5.torproject.org ns5.torproject.org
+
+ 4. remove the old port from the instance:
+
+        openstack server remove port ns5.torproject.org dcae4137-03cd-47ae-9b58-de49fb8eecea
+
+ 5. in the console, change the IP in `/etc/network/interfaces`...
+
+ 6. up the new interface:
+
+        ifup -a
+
+ 7. renumber the instance, see the `ganeti.renumber-instance` fabric
+    job for tips, typically it involves grepping around in all git
+    repositories and changing LDAP
+
 # References
 
  * [How to launch an instance](https://docs.openstack.org/install-guide/launch-instance.html)