title: Shutting down hosts by script
body: <p>I want to use <a href="https://docs.marklogic.com/xdmp:shutdown" rel="nofollow noreferrer"><code>xdmp:shutdown()</code></a></p>
  
  <pre><code>xdmp:shutdown(
     $hostIDs as xs:unsignedLong*,
     $reason as xs:string,
     [$failover as xs:boolean]
  ) as empty-sequence()
  </code></pre>
  
  <p>What value should I pass in the optional parameter? Does setting it to <em>true</em> mean that the master forests in the affected host will failover to its replica forests residing in other hosts? And is it recommended to initiate shutdown from a script? Or we should do it from Admin GUI?</p>