From 5f6b94db45542c5eebdabc5e1daecfe87e65264f Mon Sep 17 00:00:00 2001 From: Julia Kreger Date: Thu, 15 Oct 2015 08:20:15 -0400 Subject: [PATCH] Update troubleshooting text for custom IPA images Additional text to help users understand how to gain access to a running IPA image for troubleshooting purposes. Change-Id: I337f02f7fa496312893bff8bb2bfb67dadb67cd9 --- troubleshooting.rst | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/troubleshooting.rst b/troubleshooting.rst index 6472bd419..6b7228ee2 100644 --- a/troubleshooting.rst +++ b/troubleshooting.rst @@ -106,8 +106,8 @@ Obtaining IPA logs via the console You will want to view the system console occurring. If possible, you may wish to use ``ipmitool`` and write the output to a log file. -Gaining access via SSH to the node running IPA -============================================== +Gaining access via SSH to the node running IPA on CoreOS based images +===================================================================== If you wish to SSH into the node in order to perform any sort of post-mortem, you will need to do the following: @@ -124,6 +124,22 @@ you will need to do the following: 3) ``ssh -l core `` +Gaining access via SSH to the node running IPA for custom images +================================================================ + +Custom built images will require a user to be burned into the image. +Typically a user would use the diskimage-builder devuser element +to achieve this. More detail on this can be located at:: + + https://github.com/openstack/diskimage-builder/tree/master/elements/devuser + +Example:: + + export DIB_DEV_USER_USERNAME=customuser + export DIB_DEV_USER_PWDLESS_SUDO=yes + export DIB_DEV_USER_AUTHORIZED_KEYS=$HOME/.ssh/id_rsa.pub + disk-image-create -o /path/to/custom-ipa debian ironic-agent devuser + ************************************ ``ssh_public_key_path is not valid`` ************************************