-
Notifications
You must be signed in to change notification settings - Fork 13
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Trento requirements include --------- Co-authored-by: Dmitri Popov <[email protected]>
- Loading branch information
Showing
3 changed files
with
186 additions
and
92 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,88 @@ | ||
| <?xml version="1.0" encoding="UTF-8" standalone="no"?> | ||
| <!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><title>Revision History: Getting Started with Trento (Getting Started with Trento)</title><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"/><link rel="stylesheet" type="text/css" href="static/css/style.css"/> | ||
| <link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"/><link rel="schema.DCTERMS" href="http://purl.org/dc/terms/"/> | ||
| <meta name="title" content="Revision History"/> | ||
| <meta name="description" content="Initial version"/> | ||
| <meta name="book-title" content="Getting Started with Trento"/> | ||
| <meta name="chapter-title" content="Revision History"/> | ||
| <meta name="tracker-url" content="https://bugzilla.suse.com/enter_bug.cgi"/> | ||
| <meta name="tracker-type" content="bsc"/> | ||
| <meta name="tracker-bsc-assignee" content="[email protected]"/> | ||
| <meta name="tracker-bsc-component" content="Trento"/> | ||
| <meta name="tracker-bsc-product" content="Documentation"/> | ||
| <meta name="publisher" content="SUSE"/><meta property="og:title" content="Getting Started with Trento"/> | ||
| <meta property="og:description" content="Use Trento for SLES for SAP"/> | ||
| <meta property="og:type" content="article"/> | ||
| <meta name="twitter:card" content="summary"/> | ||
| <meta name="twitter:title" content="Getting Started with Trento"/> | ||
| <meta name="twitter:description" content="Use Trento for SLES for SAP"/> | ||
| <script type="application/ld+json">{ | ||
| "@context": "http://schema.org", | ||
| "@type": ["TechArticle"], | ||
| "image": "https://www.suse.com/assets/img/suse-white-logo-green.svg", | ||
|
|
||
| "isPartOf": { | ||
| "@type": "CreativeWorkSeries", | ||
| "name": "Products & Solutions" | ||
| }, | ||
|
|
||
| "inLanguage": "en", | ||
|
|
||
|
|
||
| "headline": "", | ||
|
|
||
| "author": [ | ||
| { | ||
| "@type": "Corporation", | ||
| "name": "SUSE Product & Solution Documentation Team", | ||
| "url": "https://www.suse.com/assets/img/suse-white-logo-green.svg" | ||
| } | ||
| ], | ||
|
|
||
| "dateModified": "2021-12-10T00:00+02:00", | ||
|
|
||
| "datePublished": "2021-12-10T00:00+02:00", | ||
|
|
||
|
|
||
| "about": [ | ||
|
|
||
| ], | ||
|
|
||
| "sameAs": [ | ||
| "https://www.facebook.com/SUSEWorldwide/about", | ||
| "https://www.youtube.com/channel/UCHTfqIzPKz4f_dri36lAQGA", | ||
| "https://twitter.com/SUSE", | ||
| "https://www.linkedin.com/company/suse" | ||
| ], | ||
| "publisher": { | ||
| "@type": "Corporation", | ||
| "name": "SUSE", | ||
| "url": "https://documentation.suse.com", | ||
| "logo": { | ||
| "@type": "ImageObject", | ||
| "url": "https://www.suse.com/assets/img/suse-white-logo-green.svg" | ||
| } | ||
| } | ||
| }</script> | ||
| <script type="text/javascript"> | ||
|
|
||
| if ( window.location.protocol.toLowerCase() != 'file:' ) { | ||
| document.write('<link rel="stylesheet" type="text/css" href="https://documentation.suse.com/docserv/res/fonts/poppins/poppins.css"></link>'); | ||
| }; | ||
|
|
||
| </script><noscript><link rel="stylesheet" type="text/css" href="https://documentation.suse.com/docserv/res/fonts/poppins/poppins.css"/></noscript><script src="static/js/script-purejs.js" type="text/javascript"> </script><script src="static/js/highlight.min.js" type="text/javascript"> </script><script> | ||
|
|
||
| $(document).ready(function() { | ||
| $('.verbatim-wrap.highlight').each(function(i, block) { | ||
| hljs.highlightBlock(block); | ||
| }); | ||
| }); | ||
| hljs.configure({ | ||
| useBR: false | ||
| }); | ||
|
|
||
| </script></head><body><div class="revhistory" id="rh-article-trento"><h1 class="title">Revision History: Getting Started with Trento</h1><section class="revision"><h2><span class="revision date">2021-12-10</span></h2> | ||
| <p> | ||
| Initial version | ||
| </p> | ||
| </section></div></body></html> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,97 @@ | ||
| <?xml version="1.0" encoding="UTF-8"?> | ||
| <?xml-model href="file:/usr/share/xml/geekodoc/rng/geekodoc5-flat.rnc" | ||
| type="application/relax-ng-compact-syntax"?> | ||
| <!DOCTYPE article | ||
| [ | ||
| <!ENTITY % entities SYSTEM "generic-entities.ent"> | ||
| %entities; | ||
| ]> | ||
|
|
||
| <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-trento-requirements"> | ||
| <title>Requirements</title> | ||
| <para> This section describes requirements for the &t.server; and its | ||
| &t.agent;s. </para> | ||
| <section xml:id="sec-trento-server-requirements"> | ||
| <title>&t.server; requirements</title> | ||
| <para> Running all the &t.server; components requires a minimum of | ||
| 4 GB of RAM, two CPU cores and 64 GB of storage. When using K3s, | ||
| such storage should be provided under | ||
| <filename>/var/lib/rancher/k3s</filename>. | ||
| </para> | ||
| <para> | ||
| &trento; is based on an event-driven technology. Registered events are stored in a &postgresql; database with a default retention | ||
| period of 10 days. For each host registered with &trento;, you need to allocate at least 1.5GB of space in the &postgresql; database. | ||
| </para> | ||
| <para> &t.server; supports different deployment scenarios: &k8s;, systemd, and containers. A &k8s;-based deployment of &t.server; is cloud-native and OS-agnostic. It can be performed on the following services: </para> | ||
| <itemizedlist> | ||
| <listitem> | ||
| <para>RKE1 (&rancher.k8s.engine; version 1)</para> | ||
| </listitem> | ||
| <listitem> | ||
| <para>RKE2</para> | ||
| </listitem> | ||
| <listitem> | ||
| <para>a &k8s; service in a cloud provider</para> | ||
| </listitem> | ||
| <listitem> | ||
| <para>any other CNCF-certified &k8s; running on x86_64 architecture</para> | ||
| </listitem> | ||
| </itemizedlist> | ||
| <para> A production-ready &k8s;-based deployment of &t.server; requires | ||
| &k8s; knowledge. The Helm chart is intended to be used by customers without | ||
| in-house &k8s; expertise, or as a way to try &trento; with a minimum of | ||
| effort. However, Helm chart delivers a basic deployment of the &t.server; | ||
| with all the components running on a single node of the cluster.</para> | ||
| </section> | ||
| <section xml:id="sec-trento-agent-requirements"> | ||
| <title>&t.agent; requirements</title> | ||
| <para> The resource footprint of the &t.agent; is designed to not | ||
| impact the performance of the host it runs on. </para> | ||
| <para> The &t.agent; component needs to interact with several | ||
| low-level system components that are part of the &sles4sap; distribution. </para> | ||
| <para>The hosts must have unique machine identifiers (ids) in order to be registered in Trento. This means that if a host in your environment is built as a clone of another one, | ||
| make sure to change the machine's identifier as part of the cloning process before starting the &t.agent; on it. </para> | ||
| <para> Similarly, the clusters must have unique authkeys on the clusters in order to be registered in &trento;.</para> | ||
| </section> | ||
| <section xml:id="sec-trento-network-requirements"> | ||
| <title>Network requirements</title> | ||
| <itemizedlist> | ||
| <listitem> | ||
| <para> | ||
| The Web component of the &t.server; must be reachable from any &t.agent; host via HTTP (port TCP/80) or via HTTPS (port TCP/443) if SSL is enabled. | ||
| </para> | ||
| </listitem> | ||
| <listitem> | ||
| <para> | ||
| The checks engine component of the &t.server; must be reachable from any &t.agent; host via Advanced Message Queuing Protocol or AMQP (port TCP/5672). | ||
| </para> | ||
| </listitem> | ||
| <listitem> | ||
| <para> | ||
| The Prometheus component of the &t.server; must be able to reach the Node Exporter in the &t.agent; hosts (port TCP/9100). | ||
| </para> | ||
| </listitem> | ||
| <listitem> | ||
| <para>The &sap; Basis administrator must access to the Web component of the &t.server; via HTTP (port TCP/80) or via HTTPS (port TCP/443) if SSL is enabled. </para> | ||
| </listitem> | ||
| </itemizedlist> | ||
| </section> | ||
| <section xml:id="sec-trento-installation-prerequisites"> | ||
| <title>Installation prerequisites</title> | ||
| <itemizedlist> | ||
| <listitem> | ||
| <formalpara> | ||
| <title>&t.server;</title> | ||
| <para>For a &k8s;-based deployment, you must have access to &suse; public registry for the deployment of &t.server; containers. | ||
| For a systemd deployment, you must have a registered &sles4sap; 15 (SP3 or higher) distribution. The same applies to a containerized deployment.</para> | ||
| </formalpara> | ||
| </listitem> | ||
| <listitem> | ||
| <formalpara> | ||
| <title>&t.agent;s</title> | ||
| <para>A registered &sles4sap; 15 (SP3 or higher) distribution.</para> | ||
| </formalpara> | ||
| </listitem> | ||
| </itemizedlist> | ||
| </section> | ||
| </section> |