AWS Specific features

Resetting Passwords via User Data

Occasionally the username/password to a VNS3 controller gets lost and users need a way to recover access to the controller.

The recommended/best practice way is:

  1. Always have current VNS3 snapshot configuration files available. (This is not to be confused with what virtual machine snapshots). These are created via VNS3 Web UI or API.
  2. Launch a new instance, change the username/password on the new instance to known items.
  3. Now migrate from the instance which is unavailable to the new instance. See Migration Guide for more.

VNS3 now has an alternative, Amazon-only approach for customers without snapshot files, using Amazon instance “userdata”:

  1. Stop the instance (this will create an outage!)
  2. Modify the userdata by adding (as appropriate)
reset_api_password=mynewpassword
reset_ui_password=theapipassword
  1. Restart the instance and login using the newly provided password.
  2. An additional STOP / START of the instance will be required to remove the userdata, otherwise future password changes could be re-written by a future stop/start event.

VNS3 Admin AWS Userdata PS Reset 1

VNS3 Admin AWS Userdata PS Reset 2

Reseting Firewall via User Data

Occasionally access to the VNS3 Controller is lost due to an incorrect firewall entry blocking access. The recommended/best practice way is:

  1. Always have current VNS3 snapshot configuration files available. (This is not to be confused with what virtual machine snapshots). These are created via VNS3 Web UI or API
  2. Launch a new instance, change the username/password on the new instance to known items.
  3. Now migrate from the instance which is unavailable to the new instance. See Migration Guide for more.

VNS3 now has an alternative, Amazon-only approach for customers without snapshot files, using Amazon instance “userdata”.

  1. Stop the instance (this will create an outage!)
  2. Modify the userdata by adding (as appropriate): reset_firewall=true. This will comment out all rules. They will not be deleted.
  3. Restart the instance.
  4. An additional STOP / START of the instance will be required to remove the userdata, otherwise future stop/start events could disable the firewall rules.