Comment 16 for bug 1646255

Reviewed: https://review.openstack.org/580494
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=93854e47e09110ea8fd1b6111813f87d5d8501cc
Submitter: Zuul
Branch: stable/pike

commit 93854e47e09110ea8fd1b6111813f87d5d8501cc
Author: Matt Riedemann <email address hidden>
Date: Thu Mar 15 16:05:46 2018 -0400

    api-ref: add a note in DELETE /os-services about deleting computes

    As seen in I2717274bb1bd370870acbf58c03dc59cee30cc5e, if an
    operator deletes a nova-compute service via the API but fails
    to stop the actual nova-compute process, the API will delete the
    services table and compute_nodes table records, but the nova-compute
    process will hit the 'update_available_resource' periodic task and
    re-create the compute node record, which at that point is orphaned
    since it does not have an associated nova-compute service.

    Restarting the nova-compute service _should_ recreate the service
    table record for that host and then the user could attempt to
    delete the service and compute node record again via this API, but
    it's better to not have to find this out the hard way.

    So this change adds a simple reminder that the nova-compute process
    on the host should be stopped before deleting the compute service.

    While in here, the link to the install guide about the various
    compute services is also fixed.

    Change-Id: I68f2074814c3ae890888a5c75fd2870bb99f0e08
    Related-Bug: #1646255
    (cherry picked from commit e0c43ac7a7b9edbd3eb4921d87f476a33364549b)
    (cherry picked from commit 1b7ba3a200ff3b7d7a26c38de9135f7439caa4eb)