Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1614095

Summary: [DOCS] Several pages still use removed services like atomic-openshift-master-controllers
Product: OpenShift Container Platform Reporter: Takayoshi Kimura <tkimura>
Component: DocumentationAssignee: Michael Burke <mburke>
Status: CLOSED CURRENTRELEASE QA Contact: Hongan Li <hongli>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: high    
Version: 3.10.0CC: aos-bugs, cshereme, gpei, jokerman, mmccomas, shlao, tkimura, wsun
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-10-15 14:51:34 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 Takayoshi Kimura 2018-08-09 02:16:39 UTC
Need to update all docs referring to removed services in 3.10 release:

- atomic-openshift-master-api
- atomic-openshift-master-controllers
- etcd (in context mentioned with systemctl command)

We need to grep the doc with "systemctl" keyword and check if they need fix.

For example, Configuring SDN section needs major update:

https://docs.openshift.com/container-platform/3.10/install_config/configuring_sdn.html#migrating-between-sdn-plugins

To restart master:

  # /usr/local/bin/master-restart api
  # /usr/local/bin/master-restart controllers

To restart openvswitch:

  $ oc delete pod --all -n openshift-sdn

To edit node-config.yaml

  $ oc edit cm -n openshift-node

Comment 1 Vikram Goyal 2018-08-09 03:38:15 UTC
*** Bug 1612024 has been marked as a duplicate of this bug. ***

Comment 2 Vikram Goyal 2018-08-09 03:38:51 UTC
Michael - also see: https://bugzilla.redhat.com/show_bug.cgi?id=1612024

Comment 3 Michael Burke 2018-08-09 19:43:44 UTC
Takayoshi --

Thank you for filing this BZ. It seems that when I did the initial replacement for restarting the API and controller services, I did not look for the service names or file locations. 

Can you help with:

* The new name for the services
atomic-openshift-master-api
atomic-openshift-master-controller

* The new file path that replaces 
`/etc/sysconfig/atomic-openshift-master-api`, and
`/etc/sysconfig/atomic-openshift-master-controllers` directories.

* How to disable the API and controller services:
$ sudo systemctl disable --now atomic-openshift-master-api
$ sudo systemctl disable --now atomic-openshift-master-controllers

* How to shut down old master API and controller services:
+
----
# systemctl stop atomic-openshift-master-api
----

* The new file path that replaces 
/usr/lib/systemd/system/atomic-openshift-master-api.service
/usr/lib/systemd/system/atomic-openshift-master-controllers.service


Also, what needs to be changed related to etcd? For example, I was told that `systemctl restart etcd` is still correct in 3.10

Comment 5 Takayoshi Kimura 2018-08-10 05:46:24 UTC
> * The new name for the services
> atomic-openshift-master-api
> atomic-openshift-master-controller

No they are no longer systemd service. They are static pods kicked by atomic-openshift-node service (hyperkube process), running as a container.

See relese notes https://docs.openshift.com/container-platform/3.10/release_notes/ocp_3_10_release_notes.html#ocp-310-control-plane-changes

> * The new file path that replaces 
> `/etc/sysconfig/atomic-openshift-master-api`, and
> `/etc/sysconfig/atomic-openshift-master-controllers` directories.

/etc/origin/master/master.env , see release notes:

https://docs.openshift.com/container-platform/3.10/release_notes/ocp_3_10_release_notes.html#ocp-310-important-installation-changes

> * How to disable the API and controller services:
> $ sudo systemctl disable --now atomic-openshift-master-api
> $ sudo systemctl disable --now atomic-openshift-master-controllers
> 
> * How to shut down old master API and controller services:
> +
> ----
> # systemctl stop atomic-openshift-master-api
> ----

No way to disable like systemd does.  Static pods can be stopped and disabled by moving definition files out of the static pods dir /etc/origin/node/pods:

# mkdir -p /etc/origin/node/pods/disabled
# mv /etc/origin/node/pods/controller.yaml /etc/origin/node/pods/disabled/

> Also, what needs to be changed related to etcd? For example, I was told that `systemctl restart etcd` is still correct in 3.10

No it's not correct, etcd is converted static pod as well. There is no systemd etcd service.

Comment 6 Michael Burke 2018-08-13 17:49:58 UTC
*** Bug 1615199 has been marked as a duplicate of this bug. ***