Uploaded image for project: 'JBoss Enterprise Application Platform'
  1. JBoss Enterprise Application Platform
  2. JBEAP-21123

[GSS](7.3.z) Use of deprecated command write-local-domain-controller in documentation

    XMLWordPrintable

Details

    • Bug
    • Resolution: Done
    • Major
    • 7.3.x
    • None
    • Documentation
    • None

    Description

      JBoss EAP 7.3 Configuration Guide
      8.5.3. Promote a Host Controller to Act as Domain Controller

      Execute the following command to configure the host controller to act as the new domain controller.
      
      /host=HOST_NAME:write-local-domain-controller
      

      If we run command write-local-domain-controller on JBoss EAP 7.3.5 that is the current latest version, we will get the deprecated message:

      [domain@127.0.0.1:19990 /] /host=backup:write-local-domain-controller
      {
          "outcome" => "success",
          "result" => undefined,
          "response-headers" => {
              "warnings" => [{
                  "warning" => "WFLYCTL0449: Operation write-local-domain-controller against the resource at address /host=backup is deprecated, and it might be removed in future version. See the the outpu
      t of the read-operation-description operation to learn more about the deprecation.",
                  "level" => "WARNING",
                  "operation" => {
                      "address" => [("host" => "backup")],
                      "operation" => "write-local-domain-controller"
                  }
              }],
              "process-state" => "reload-required"
          },
          "server-groups" => undefined
      }
      

      Instead of write-local-domain-controller, I think we should guide the below command in the product document:

      [domain@127.0.0.1:19990 /] /host=backup:write-attribute(name=domain-controller.local, value={})
      {
          "outcome" => "success",
          "result" => undefined,
          "server-groups" => undefined,
          "response-headers" => {"process-state" => "reload-required"}
      }
      

      The results of the write-local-domain-controller and write-attribute(name=domain-controller.local, value={}) commands are the same as below:

      $ diff -u host-slave.xml.org host-slave.xml
      --- host-slave.xml.org	2021-03-05 10:44:55.529909903 +0900
      +++ host-slave.xml	2021-03-05 11:40:15.578969067 +0900
      @@ -62,11 +62,11 @@
               </management-interfaces>
           </management>
           <domain-controller>
      -        <remote security-realm="ManagementRealm">
      +        <local>
                   <discovery-options>
                       <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote+http}" host="${jboss.domain.master.address:127.0.0.1}" port="${jboss.domain.master.port:9990}"/>
                   </discovery-options>
      -        </remote>
      +        </local>
           </domain-controller>
           <interfaces>
               <interface name="management">
      

      Attachments

        Issue Links

          Activity

            People

              rhn-support-smunje Satyajeet Munje
              rhn-support-nagetsum Norito Agetsuma
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: