Bug 1535214

Summary: baremetal commands that were deprecated in Ocata have been removed in Queens
Product: Red Hat OpenStack Reporter: Bob Fournier <bfournie>
Component: documentationAssignee: Charelle Collett <ccollett>
Status: CLOSED CURRENTRELEASE QA Contact: Dan Macpherson <dmacpher>
Severity: high Docs Contact:
Priority: unspecified    
Version: 13.0 (Queens)CC: ccollett, dmacpher, panbalag, srevivo
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-02-09 03:33:29 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Bob Fournier 2018-01-16 20:44:28 UTC
Description of problem:

In Ocata, the openstack baremetal commands were deprecated with this release note in python-tripleoclient

cat deprecate-baremetal-commands-d24279b6a7cf97d6.yaml 
---
deprecations:
  - The ``openstack baremetal import``, ``openstack baremetal
    introspect bulk start`` and ``openstack baremetal configure`` are
    now deprecated in favour of ``openstack overcloud node import``,
    ``openstack overcloud node introspect`` and ``openstack overcloud
    node configure`` respectively. See `bug 1649541
    <https://bugs.launchpad.net/tripleo/+bug/1649541>`__.

In Queens, these commands have been officially removed, which can cause problems with scripts that are still using the old commands.

The following command substitutions are suggested:

1. 
Instead of:
openstack baremetal import <file>
Use:
openstack overcloud node import <file>

Note that the --json parameter is no longer needed as the file type is detected by the extension

2.
Instead of:
openstack baremetal configure boot
Use:
openstack overcloud node configure <node>

Note that this command is now per-node

Note also, all of the parameters used for the baremetal command such as --deploy-kernel and --deploy-ramdisk can also be used with the overcloud command

3.
Instead of:
openstack baremetal introspection bulk start
Use:
openstack overcloud node introspect --all-manageable
Note, that the nodes must be in manageable state

Comment 1 Bob Fournier 2018-01-16 21:14:25 UTC
See https://review.openstack.org/#/c/416526/ which has the doc changes when the commands were initially deprecated.

Comment 2 Bob Fournier 2018-01-22 14:23:58 UTC
Note - item 2 has been updated below

2.
Instead of:
openstack baremetal configure boot
Use:
openstack overcloud node configure

Note that this command can also be run per-node.

Comment 3 Dmitry Tantsur 2018-01-24 15:35:20 UTC
*** Bug 1538175 has been marked as a duplicate of this bug. ***

Comment 5 Dan Macpherson 2018-02-09 03:25:48 UTC
LGTM!

Comment 6 Dan Macpherson 2018-02-09 03:33:29 UTC
All guides republished except for Red Hat Ceph Storage for the Overcloud guide, which is deprecated in favor of a new container-based guide.