Deploy for ManageIQ/manageiq.org#1220

Author: ManageIQ Bot

docs/get-started/vagrant.html

@@ -308,6 +308,15 @@ <h3 id="step-2-modify-vagrantfile">Step 2: Modify Vagrantfile</h3>
 <span class="k">end</span>
 </code></pre></div></div>
 
+<p>The appliance will also need one or two extra disks, one for the PostgreSQL
+database (required) and one for persisting the message queue (optional). Add
+these like so:</p>
+
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  <span class="n">config</span><span class="p">.</span><span class="nf">vm</span><span class="p">.</span><span class="nf">disk</span> <span class="ss">:disk</span><span class="p">,</span> <span class="ss">name: </span><span class="s2">"miq-pg"</span><span class="p">,</span> <span class="ss">size: </span><span class="s2">"4GB"</span>
+  <span class="c1"># Uncomment this for a persistent message queue:</span>
+  <span class="c1"># config.vm.disk :disk, name: "miq-mq", size: "4GB"</span>
+</code></pre></div></div>
+
 <h3 id="step-3-start-manageiq">Step 3: Start ManageIQ</h3>
 
 <p>Start ManageIQ by executing:</p>
@@ -320,9 +329,79 @@ <h3 id="step-3-start-manageiq">Step 3: Start ManageIQ</h3>
 <div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>vagrant ssh
 </code></pre></div></div>
 
+<p>Now that you’re on the appliance’s shell, it will need a little bit of input
+from you to finish starting:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>appliance_console
+</code></pre></div></div>
+
+<p>This will bring up a menu-driven interface with a list of numbered options.
+The numbers for each option may vary. First, you want <code class="language-plaintext highlighter-rouge">Configure Application</code>,
+so enter that option’s number at the prompt and press enter.</p>
+
+<p>You will be prompted to either create an encryption key or fetch one from a
+remote machine. Select the <code class="language-plaintext highlighter-rouge">Create key</code> option.</p>
+
+<p>The next menu will ask how you want the database to be configured. For a basic
+setup to get started, <code class="language-plaintext highlighter-rouge">Create Internal Database</code> is an appropriate choice.</p>
+
+<p>Then, it will ask about messaging. Choose <code class="language-plaintext highlighter-rouge">Configure this appliance as a
+messaging server</code>.</p>
+
+<p>The console will then go about partitioning the extra disk(s) you added in
+<code class="language-plaintext highlighter-rouge">Vagrantfile</code>. You can choose the defaults here.</p>
+
+<p>When it asks, “Should this appliance run as a standalone database server,”
+choose <code class="language-plaintext highlighter-rouge">N</code> (the default).</p>
+
+<p>The next prompt will be “Enter the database region number.” Any number will do.
+<code class="language-plaintext highlighter-rouge">0</code> and <code class="language-plaintext highlighter-rouge">99</code> are common choices. For a vagrant appliance, this number isn’t 
+especially important. Refer to the <a href="/docs/reference/radjabov/deployment_planning_guide">Deployment Planning
+Guide</a> for information about regions when you’re ready to take ManageIQ to
+production.</p>
+
+<p>Next will be a password prompt for the database. It will ask twice.</p>
+
+<p>You may get a prompt like “Already configured on this Appliance, Un-Configure
+first?” Choose <code class="language-plaintext highlighter-rouge">Y</code> to customize the settings for the Kafka messaging server,
+or <code class="language-plaintext highlighter-rouge">N</code> to go with what’s already set–which may not work.</p>
+
+<p>If you chose <code class="language-plaintext highlighter-rouge">Y</code> above, you’ll be asked whether to “Proceed with Configuration.”
+If you choose <code class="language-plaintext highlighter-rouge">Y</code> again, you will get the following prompts:</p>
+
+<ul>
+  <li>Enter the Message Server Hostname:
+    <ul>
+      <li>The hostname you give here <em>must</em> be resolvable and <em>must</em> not be a
+link-local or loopback address. The default value will come from DHCP and
+will vary with your local network and any network settings you applied in
+<code class="language-plaintext highlighter-rouge">Vagrantfile</code>.</li>
+    </ul>
+  </li>
+  <li>Enter the Message Keystore Username:
+    <ul>
+      <li>Any name works. The default is “admin.”</li>
+    </ul>
+  </li>
+  <li>Enter the Message Keystore Password
+    <ul>
+      <li>Again, you will be prompted twice</li>
+    </ul>
+  </li>
+  <li>Configure a new persistent disk volume?
+    <ul>
+      <li>If you added a third disk in <code class="language-plaintext highlighter-rouge">Vagrantfile</code>, you may choose <code class="language-plaintext highlighter-rouge">Y</code> here.
+Otherwise, choose <code class="language-plaintext highlighter-rouge">N</code>.</li>
+    </ul>
+  </li>
+</ul>
+
+<p>You’ll be given a review-and-confirm dialog. Choose <code class="language-plaintext highlighter-rouge">Y</code> if everything looks
+correct. After a moment, you should be prompted to “press any key.”</p>
+
 <p>ManageIQ is now up and running.</p>
 
-<p>Next step is to perform some <a href="/docs/get-started/basic-configuration">basic
+<p>The next step is to perform some <a href="/docs/get-started/basic-configuration">basic
 configuration</a>.</p>
 
       </div>

feed.xml

@@ -5,8 +5,8 @@
     <description></description>
     <link>http://manageiq.org/</link>
     <atom:link href="http://manageiq.org/feed.xml" rel="self" type="application/rss+xml"/>
-    <pubDate>Thu, 04 Sep 2025 03:16:07 +0000</pubDate>
-    <lastBuildDate>Thu, 04 Sep 2025 03:16:07 +0000</lastBuildDate>
+    <pubDate>Thu, 04 Sep 2025 21:13:54 +0000</pubDate>
+    <lastBuildDate>Thu, 04 Sep 2025 21:13:54 +0000</lastBuildDate>
     <generator>Jekyll v4.4.1</generator>
 
       <item>