-
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.
- Loading branch information
Dmitri Popov
committed
Jan 30, 2025
1 parent
81e8b71
commit d956cfa
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 powered by 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 containerized. A &k8s; based deployment of &t.server; is meant to be | ||
| cloud native and OS agnostic. It can be done 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 proper, production ready &k8s; based deployment of &t.server; requires &k8s; | ||
| knowledge. The Helm chart is meant to be used by customers lacking such knowledge | ||
| or who want to get started quickly. 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> Trento requires unique machine identifiers (ids) on the hosts to be registered. Therefore, if any host in your environment is built as a clone of another one, | ||
| ensure that you change the machine identifier as part of the cloning process before starting the &t.agent; on it. </para> | ||
| <para> Similarly, Trento requires unique authkeys on the clusters to be registered.</para> | ||
| </section> | ||
| <section xml:id="sec-trento-network-requirements"> | ||
| <title>Network requirements</title> | ||
| <itemizedlist> | ||
| <listitem> | ||
| <para> | ||
| <remark>toms 2021-12-06: do we have UDP here too?</remark> | ||
| From any &t.agent; host, the Web component of the &t.server; must be reachable via HTTP (port TCP/80) or via HTTPS (port TCP/443) if SSL is enabled. | ||
| </para> | ||
| </listitem> | ||
| <listitem> | ||
| <para> | ||
| From any &t.agent; host, the checks engine component of the &t.server;, called Wanda, must be reachable 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 needs 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>Access to &suse; public registry for the deployment of &t.server; containers, if we choose a &k8s; based deployment. | ||
| A registered &sles4sap; 15 (SP3 or higher) distribution, if we choose a systemd deployment. Both in the case of 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> |