Skip to content

Commit

Permalink
Deploy for ManageIQ/manageiq-documentation#1805
Browse files Browse the repository at this point in the history
  • Loading branch information
ManageIQ Bot committed Aug 20, 2024
1 parent bb55286 commit e6f330b
Show file tree
Hide file tree
Showing 11 changed files with 520 additions and 619 deletions.
2 changes: 1 addition & 1 deletion ...est-c3cdea63fb88ff42afa4701c4a3c9049.json → ...est-a8d8ffae4933498c54e61ec8bc2efcbe.json
View file
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"files":{"font-awesome/fontawesome-webfont-7bfcab6db99d5cfbf1705ca0536ddc78585432cc5fa41bbd7ad0f009033b2979.eot":{"mtime":"2024-08-20T03:07:19+00:00","logical_path":"font-awesome/fontawesome-webfont.eot","integrity":"sha256-e/yrbbmdXPvxcFygU23ceFhUMsxfpBu9etDwCQM7KXk=","digest":"7bfcab6db99d5cfbf1705ca0536ddc78585432cc5fa41bbd7ad0f009033b2979","size":165742},"font-awesome/fontawesome-webfont-2adefcbc041e7d18fcf2d417879dc5a09997aa64d675b7a3c4b6ce33da13f3fe.woff2":{"mtime":"2024-08-20T03:07:19+00:00","logical_path":"font-awesome/fontawesome-webfont.woff2","integrity":"sha256-Kt78vAQefRj88tQXh53FoJmXqmTWdbejxLbOM9oT8/4=","digest":"2adefcbc041e7d18fcf2d417879dc5a09997aa64d675b7a3c4b6ce33da13f3fe","size":77160},"font-awesome/fontawesome-webfont-ba0c59deb5450f5cb41b3f93609ee2d0d995415877ddfa223e8a8a7533474f07.woff":{"mtime":"2024-08-20T03:07:19+00:00","logical_path":"font-awesome/fontawesome-webfont.woff","integrity":"sha256-ugxZ3rVFD1y0Gz+TYJ7i0NmVQVh33foiPoqKdTNHTwc=","digest":"ba0c59deb5450f5cb41b3f93609ee2d0d995415877ddfa223e8a8a7533474f07","size":98024},"font-awesome/fontawesome-webfont-aa58f33f239a0fb02f5c7a6c45c043d7a9ac9a093335806694ecd6d4edc0d6a8.ttf":{"mtime":"2024-08-20T03:07:19+00:00","logical_path":"font-awesome/fontawesome-webfont.ttf","integrity":"sha256-qljzPyOaD7AvXHpsRcBD16msmgkzNYBmlOzW1O3A1qg=","digest":"aa58f33f239a0fb02f5c7a6c45c043d7a9ac9a093335806694ecd6d4edc0d6a8","size":165548},"font-awesome/fontawesome-webfont-ad6157926c1622ba4e1d03d478f1541368524bfc46f51e42fe0d945f7ef323e4.svg":{"mtime":"2024-08-20T03:07:19+00:00","logical_path":"font-awesome/fontawesome-webfont.svg","integrity":"sha256-rWFXkmwWIrpOHQPUePFUE2hSS/xG9R5C/g2UX37zI+Q=","digest":"ad6157926c1622ba4e1d03d478f1541368524bfc46f51e42fe0d945f7ef323e4","size":444379},"main-c62d712a15a5ba4c8ba8ce3af6a80e7ae432d1bd2c83c7d2973c3d72a7371e97.css":{"mtime":"2024-08-20T03:09:05+00:00","logical_path":"main.css","integrity":"sha256-xi1xKhWlukyLqM469qgOeuQy0b0sg8fSlzw9cqc3Hpc=","digest":"c62d712a15a5ba4c8ba8ce3af6a80e7ae432d1bd2c83c7d2973c3d72a7371e97","size":111572}},"assets":{"font-awesome/fontawesome-webfont.eot":"font-awesome/fontawesome-webfont-7bfcab6db99d5cfbf1705ca0536ddc78585432cc5fa41bbd7ad0f009033b2979.eot","font-awesome/fontawesome-webfont.woff2":"font-awesome/fontawesome-webfont-2adefcbc041e7d18fcf2d417879dc5a09997aa64d675b7a3c4b6ce33da13f3fe.woff2","font-awesome/fontawesome-webfont.woff":"font-awesome/fontawesome-webfont-ba0c59deb5450f5cb41b3f93609ee2d0d995415877ddfa223e8a8a7533474f07.woff","font-awesome/fontawesome-webfont.ttf":"font-awesome/fontawesome-webfont-aa58f33f239a0fb02f5c7a6c45c043d7a9ac9a093335806694ecd6d4edc0d6a8.ttf","font-awesome/fontawesome-webfont.svg":"font-awesome/fontawesome-webfont-ad6157926c1622ba4e1d03d478f1541368524bfc46f51e42fe0d945f7ef323e4.svg","main.css":"main-c62d712a15a5ba4c8ba8ce3af6a80e7ae432d1bd2c83c7d2973c3d72a7371e97.css"}}
{"files":{"font-awesome/fontawesome-webfont-7bfcab6db99d5cfbf1705ca0536ddc78585432cc5fa41bbd7ad0f009033b2979.eot":{"mtime":"2024-08-20T14:43:22+00:00","logical_path":"font-awesome/fontawesome-webfont.eot","integrity":"sha256-e/yrbbmdXPvxcFygU23ceFhUMsxfpBu9etDwCQM7KXk=","digest":"7bfcab6db99d5cfbf1705ca0536ddc78585432cc5fa41bbd7ad0f009033b2979","size":165742},"font-awesome/fontawesome-webfont-2adefcbc041e7d18fcf2d417879dc5a09997aa64d675b7a3c4b6ce33da13f3fe.woff2":{"mtime":"2024-08-20T14:43:22+00:00","logical_path":"font-awesome/fontawesome-webfont.woff2","integrity":"sha256-Kt78vAQefRj88tQXh53FoJmXqmTWdbejxLbOM9oT8/4=","digest":"2adefcbc041e7d18fcf2d417879dc5a09997aa64d675b7a3c4b6ce33da13f3fe","size":77160},"font-awesome/fontawesome-webfont-ba0c59deb5450f5cb41b3f93609ee2d0d995415877ddfa223e8a8a7533474f07.woff":{"mtime":"2024-08-20T14:43:22+00:00","logical_path":"font-awesome/fontawesome-webfont.woff","integrity":"sha256-ugxZ3rVFD1y0Gz+TYJ7i0NmVQVh33foiPoqKdTNHTwc=","digest":"ba0c59deb5450f5cb41b3f93609ee2d0d995415877ddfa223e8a8a7533474f07","size":98024},"font-awesome/fontawesome-webfont-aa58f33f239a0fb02f5c7a6c45c043d7a9ac9a093335806694ecd6d4edc0d6a8.ttf":{"mtime":"2024-08-20T14:43:22+00:00","logical_path":"font-awesome/fontawesome-webfont.ttf","integrity":"sha256-qljzPyOaD7AvXHpsRcBD16msmgkzNYBmlOzW1O3A1qg=","digest":"aa58f33f239a0fb02f5c7a6c45c043d7a9ac9a093335806694ecd6d4edc0d6a8","size":165548},"font-awesome/fontawesome-webfont-ad6157926c1622ba4e1d03d478f1541368524bfc46f51e42fe0d945f7ef323e4.svg":{"mtime":"2024-08-20T14:43:22+00:00","logical_path":"font-awesome/fontawesome-webfont.svg","integrity":"sha256-rWFXkmwWIrpOHQPUePFUE2hSS/xG9R5C/g2UX37zI+Q=","digest":"ad6157926c1622ba4e1d03d478f1541368524bfc46f51e42fe0d945f7ef323e4","size":444379},"main-c62d712a15a5ba4c8ba8ce3af6a80e7ae432d1bd2c83c7d2973c3d72a7371e97.css":{"mtime":"2024-08-20T14:45:14+00:00","logical_path":"main.css","integrity":"sha256-xi1xKhWlukyLqM469qgOeuQy0b0sg8fSlzw9cqc3Hpc=","digest":"c62d712a15a5ba4c8ba8ce3af6a80e7ae432d1bd2c83c7d2973c3d72a7371e97","size":111572}},"assets":{"font-awesome/fontawesome-webfont.eot":"font-awesome/fontawesome-webfont-7bfcab6db99d5cfbf1705ca0536ddc78585432cc5fa41bbd7ad0f009033b2979.eot","font-awesome/fontawesome-webfont.woff2":"font-awesome/fontawesome-webfont-2adefcbc041e7d18fcf2d417879dc5a09997aa64d675b7a3c4b6ce33da13f3fe.woff2","font-awesome/fontawesome-webfont.woff":"font-awesome/fontawesome-webfont-ba0c59deb5450f5cb41b3f93609ee2d0d995415877ddfa223e8a8a7533474f07.woff","font-awesome/fontawesome-webfont.ttf":"font-awesome/fontawesome-webfont-aa58f33f239a0fb02f5c7a6c45c043d7a9ac9a093335806694ecd6d4edc0d6a8.ttf","font-awesome/fontawesome-webfont.svg":"font-awesome/fontawesome-webfont-ad6157926c1622ba4e1d03d478f1541368524bfc46f51e42fe0d945f7ef323e4.svg","main.css":"main-c62d712a15a5ba4c8ba8ce3af6a80e7ae432d1bd2c83c7d2973c3d72a7371e97.css"}}
86 changes: 37 additions & 49 deletions docs/reference/latest/installing_on_aws/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1415,7 +1415,7 @@ <h3 id="accessing-the-appliance-console">
<p>Press <code class="language-plaintext highlighter-rouge">Enter</code> to manually configure settings.</p>
</li>
<li>
<p>Press the number for the item you want to change, and press <code class="language-plaintext highlighter-rouge">Enter</code>.
<p>Press the number for the item that you want to change, and press <code class="language-plaintext highlighter-rouge">Enter</code>.
The options for your selection are displayed.</p>
</li>
<li>
Expand All @@ -1426,10 +1426,7 @@ <h3 id="accessing-the-appliance-console">
</li>
</ol>

<p><strong>Note:</strong></p>

<p>The ManageIQ appliance console automatically logs out
after five minutes of inactivity.</p>
<p><strong>Note</strong>: The ManageIQ appliance console automatically logs out after five minutes of inactivity.</p>

<h3 id="configuring-a-database">
<a class="anchor" href="#configuring-a-database" aria-hidden="true"><span class="octicon octicon-link"></span></a>Configuring a Database</h3>
Expand All @@ -1450,8 +1447,6 @@ <h4 id="configuring-an-internal-database">
ManageIQ only supports installing of an internal VMDB on blank
disks; installation will fail if the disks are not blank.</p>

<p>&lt;/div&gt;</p>

<ol>
<li>
<p>Start the appliance and open a terminal console.</p>
Expand Down Expand Up @@ -1480,10 +1475,7 @@ <h4 id="configuring-an-internal-database">
first appliance. For worker and multi-region setups, use this
option to copy key from another appliance.</p>

<p><strong>Note:</strong></p>

<p>All ManageIQ appliances in a multi-region
deployment must use the same key.</p>
<p><strong>Note</strong>: All ManageIQ appliances in a multi-region deployment must use the same key.</p>
</li>
</ul>
</li>
Expand Down Expand Up @@ -1565,8 +1557,8 @@ <h4 id="configuring-an-internal-database">
<h4 id="configuring-an-external-database">
<a class="anchor" href="#configuring-an-external-database" aria-hidden="true"><span class="octicon octicon-link"></span></a>Configuring an External Database</h4>

<p>Based on your setup, you will choose to configure the appliance to use
an external PostgreSQL database. For example, we can only have one
<p>Based on your setup, you need to configure the appliance to use
an external PostgreSQL database. For example, you can only have one
database in a single region. However, a region can be segmented into
multiple zones, such as database zone, user interface zone, and
reporting zone, where each zone provides a specific function. The
Expand All @@ -1584,28 +1576,24 @@ <h4 id="configuring-an-external-database">
system. For example, customize the <code class="language-plaintext highlighter-rouge">shared_buffers</code> setting according to
the amount of real storage available in the external system hosting the
PostgreSQL instance. In addition, depending on the aggregate number of
appliances expected to connect to the PostgreSQL instance, it may be
appliances that are expected to connect to the PostgreSQL instance, it might be
necessary to alter the <code class="language-plaintext highlighter-rouge">max_connections</code> setting.</p>

<p><strong>Note:</strong></p>

<ul>
<li>
<p>ManageIQ requires PostgreSQL version 13.</p>
</li>
<li>
<p><code class="language-plaintext highlighter-rouge">postgresql.conf</code> controls the operation of all databases managed by the
PostgreSQL instance, therefore it is not recommended to run other databases
on this PostgreSQL instance.</p>
</li>
</ul>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>- ManageIQ requires PostgreSQL version 13.

- `postgresql.conf` controls the operation of all databases managed by the PostgreSQL instance, therefore it is not recommended to run other databases on this PostgreSQL instance.
</code></pre></div></div>

<p>Use the following steps to configure an external PostgreSQL database:</p>

<ol>
<li>
<p>Start the appliance and open a terminal console.</p>
</li>
<li>
<p>Enter the <code class="language-plaintext highlighter-rouge">appliance_console</code> command. The appliance console summary screen will be displayed.</p>
<p>Enter the <code class="language-plaintext highlighter-rouge">appliance_console</code> command. The appliance console summary screen is displayed.</p>
</li>
<li>
<p>Press <strong>Enter</strong> to manually configure settings.</p>
Expand Down Expand Up @@ -1634,33 +1622,35 @@ <h4 id="configuring-an-external-database">
</li>
</ol>

<p>ManageIQ will then configure the external database.</p>
<p>ManageIQ configures an external database.</p>

<h3 id="configure-messaging">
<a class="anchor" href="#configure-messaging" aria-hidden="true"><span class="octicon octicon-link"></span></a>Configure Messaging</h3>

<p>Configuring messaging is required for appliance setup. It is recommended to configure the broker on the same appliance where your database is configured</p>
<p>Configuring messaging is required for the appliance setup. It is recommended to configure the broker on the same appliance where your database is configured</p>

<p><strong>Note:</strong> You can only have one kafka broker per region</p>
<p><strong>Note:</strong> You can only have one Kafka broker per region.</p>

<ol>
<li>
<p>You can either configure the current appliance as a kafka broker, or point the
appliance to an existing external kafka broker.</p>
<p>You can either configure the current appliance as a Kafka broker, or point the
appliance to an existing external Kafka broker.</p>

<p>Select the appropriate option either
<strong>Configure this appliance as a messaging server</strong> or
<strong>Connect to an external messaging system</strong>
to connect to an external kafka broker. You will be asked to fill in the
required <strong>Message Client Parameters</strong> like IP address and username/password.</p>
to connect to an external Kafka broker. Fill in the
required <strong>Message Client Parameters</strong>, such as IP address, username and password.</p>
</li>
<li>
<p>Select <strong>Proceed</strong> and appliance_console will apply the configuration that you have
requested then restart evmserverd to pick up the changes.</p>
<p>Select <strong>Proceed</strong>. <code class="language-plaintext highlighter-rouge">appliance_console</code> applies the configuration that you requested.</p>
</li>
<li>
<p>Restart <code class="language-plaintext highlighter-rouge">evmserverd</code> to pick up the changes.</p>
</li>
</ol>

<p><strong>Note:</strong> It is recommended to use your Fully Qualified Domain Name (FQDN) as the messaging hostname rather than <code class="language-plaintext highlighter-rouge">localhost</code>, ensure that a resolvable and reachable non-localhost name entry is present in <code class="language-plaintext highlighter-rouge">/etc/hosts</code></p>
<p><strong>Note:</strong> Use your Fully Qualified Domain Name (FQDN) as the messaging hostname rather than <code class="language-plaintext highlighter-rouge">localhost</code>, ensure that a resolvable and reachable non-localhost name entry is present in <code class="language-plaintext highlighter-rouge">/etc/hosts</code>.</p>

<h3 id="configuring-a-worker-appliance">
<a class="anchor" href="#configuring-a-worker-appliance" aria-hidden="true"><span class="octicon octicon-link"></span></a>Configuring a Worker Appliance</h3>
Expand Down Expand Up @@ -1693,10 +1683,7 @@ <h3 id="configuring-a-worker-appliance">
remote machine</strong>. For worker and multi-region setups, use this
option to copy the security key from another appliance.</p>

<p><strong>Note:</strong></p>

<p>All ManageIQ appliances in a multi-region deployment
must use the same key.</p>
<p><strong>Note</strong>: All ManageIQ appliances in a multi-region deployment must use the same key.</p>
</li>
<li>
<p>Choose <strong>Join Region in External Database</strong> for the database location.</p>
Expand Down Expand Up @@ -1738,20 +1725,21 @@ <h3 id="configuring-a-worker-appliance">
<p>Once ManageIQ is installed, you can log in and perform
administration tasks.</p>

<p>Log in to ManageIQ for the first time after installing by:</p>

<ol>
<li>
<p>Browse to the URL for the login screen. (<a href="https://xx.xx.xx.xx">https://xx.xx.xx.xx</a> on
the virtual machine instance)</p>
<p>Browse to the URL for the login screen. For example, URL should be <code class="language-plaintext highlighter-rouge">https://xx.xx.xx.xx</code></p>
</li>
<li>
<p>Enter the default credentials (Username: <strong>admin</strong> | Password:
<strong>smartvm</strong>) for the initial login.</p>
</li>
<li>
<p>Click <strong>Login</strong>.</p>
<li>Enter the default credentials as listed for the initial login.
<ul>
<li>
<strong>Username</strong>: <strong>admin</strong>
</li>
<li>
<strong>Password</strong>: <strong>smartvm</strong>
</li>
</ul>
</li>
<li>Click <strong>Login</strong>.</li>
</ol>

<h1 id="appendix">
Expand Down
Loading

0 comments on commit e6f330b

Please sign in to comment.