index.html

    <li class="md-nav__item">
      <a href="../terminology/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Terminology
  </span>
  

      </a>
    </li>
  

    
  </ul>
</nav>
                  </div>
                </div>
              </div>
            
            
              
              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
                <div class="md-sidebar__scrollwrap">
                  <div class="md-sidebar__inner">
                    

<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  
  
  
    
  
  
    <label class="md-nav__title" for="__toc">
      <span class="md-nav__icon md-icon"></span>
      Table of contents
    </label>
    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
      
        <li class="md-nav__item">
  <a href="#intended-audience-openslice-administrators" class="md-nav__link">
    <span class="md-ellipsis">
      Intended Audience: OpenSlice administrators
    </span>
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#requirements" class="md-nav__link">
    <span class="md-ellipsis">
      Requirements
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Requirements">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#hardware-requirements" class="md-nav__link">
    <span class="md-ellipsis">
      Hardware requirements:
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#software-requirements" class="md-nav__link">
    <span class="md-ellipsis">
      Software Requirements:
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#additional-configuration" class="md-nav__link">
    <span class="md-ellipsis">
      Additional Configuration
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#preparing-the-environment" class="md-nav__link">
    <span class="md-ellipsis">
      Preparing the environment
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Preparing the environment">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#1-setting-up-a-kubernetes-cluster" class="md-nav__link">
    <span class="md-ellipsis">
      1. Setting Up A Kubernetes Cluster
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-installing-helm" class="md-nav__link">
    <span class="md-ellipsis">
      2. Installing Helm
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#downloading-the-project" class="md-nav__link">
    <span class="md-ellipsis">
      Downloading the project
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Downloading the project">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#1-create-a-new-folder-to-download-the-project" class="md-nav__link">
    <span class="md-ellipsis">
      1. Create a new folder to download the project
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-download-the-project-code" class="md-nav__link">
    <span class="md-ellipsis">
      2. Download the project code
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-prerequisites-before-deployment" class="md-nav__link">
    <span class="md-ellipsis">
      3. Prerequisites before deployment
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#configure-helm-chart-services" class="md-nav__link">
    <span class="md-ellipsis">
      Configure Helm Chart Services
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Configure Helm Chart Services">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#configuring-services" class="md-nav__link">
    <span class="md-ellipsis">
      Configuring Services
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Configuring Services">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#1-database-configuration" class="md-nav__link">
    <span class="md-ellipsis">
      1. Database Configuration
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-keycloak-configuration" class="md-nav__link">
    <span class="md-ellipsis">
      2. Keycloak Configuration
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-cridge-configuration" class="md-nav__link">
    <span class="md-ellipsis">
      3. CRIDGE Configuration
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#4-external-services-configuration" class="md-nav__link">
    <span class="md-ellipsis">
      4. External Services Configuration
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#5-application-and-logging-configuration" class="md-nav__link">
    <span class="md-ellipsis">
      5. Application and Logging Configuration
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#6-ingress-and-root-url" class="md-nav__link">
    <span class="md-ellipsis">
      6. Ingress and Root URL
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#7-persistent-volume-for-mysql" class="md-nav__link">
    <span class="md-ellipsis">
      7. Persistent Volume for MySQL
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
        
          <li class="md-nav__item">
  <a href="#configure-web-ui" class="md-nav__link">
    <span class="md-ellipsis">
      Configure Web UI
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#configure-tmf-web-ui" class="md-nav__link">
    <span class="md-ellipsis">
      Configure TMF Web UI
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#deploy-the-helm-chart" class="md-nav__link">
    <span class="md-ellipsis">
      Deploy the Helm Chart
    </span>
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#validating-deployments-and-container-monitoring" class="md-nav__link">
    <span class="md-ellipsis">
      Validating deployments and container monitoring
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Validating deployments and container monitoring">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#checking-the-status-of-your-applications-deployment" class="md-nav__link">
    <span class="md-ellipsis">
      Checking the Status of your application's deployment
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#accessing-logs-for-troubleshooting" class="md-nav__link">
    <span class="md-ellipsis">
      Accessing Logs for Troubleshooting
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#post-installation-steps" class="md-nav__link">
    <span class="md-ellipsis">
      Post installation steps
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Post installation steps">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#configure-keycloak-server" class="md-nav__link">
    <span class="md-ellipsis">
      Configure Keycloak server
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Configure Keycloak server">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#1-configure-email" class="md-nav__link">
    <span class="md-ellipsis">
      1. Configure email
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-add-an-openslice-admin-user" class="md-nav__link">
    <span class="md-ellipsis">
      2. Add an OpenSlice admin user
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
        
          <li class="md-nav__item">
  <a href="#nfv-orchestrator-configuration" class="md-nav__link">
    <span class="md-ellipsis">
      NFV Orchestrator Configuration
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
    </ul>
  
</nav>
                  </div>
                </div>
              </div>
            
          
          
            <div class="md-content" data-md-component="content">
              <article class="md-content__inner md-typeset">
                
                  


<h1 id="openslice-deployment-guide-with-kubernetes">OpenSlice Deployment Guide with Kubernetes</h1>
<h2 id="intended-audience-openslice-administrators">Intended Audience: OpenSlice administrators</h2>
<h2 id="requirements">Requirements</h2>
<h3 id="hardware-requirements">Hardware requirements:</h3>
<table>
<thead>
<tr>
<th><strong>Minimum Hardware Requirements</strong></th>
<th><strong>Recommended Hardware Requirements</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>4 CPU cores</td>
<td>8 CPU cores</td>
</tr>
<tr>
<td>8 GB RAM</td>
<td>16 GB RAM</td>
</tr>
<tr>
<td>30 GB storage</td>
<td>50 GB storage</td>
</tr>
</tbody>
</table>
<h3 id="software-requirements">Software Requirements:</h3>
<ul>
<li><strong>git:</strong> For cloning the project repository.</li>
<li><strong>Kubernetes:</strong> A running cluster where OpenSlice will be deployed. <ul>
<li><strong>Disclaimer:</strong> The current manual setup of Persistent Volumes using <code>hostPath</code> is designed to operate with <strong>only a single worker node</strong>. This setup will not support data persistence if a pod is rescheduled to another node.</li>
</ul>
</li>
<li><strong>Helm:</strong> For managing the deployment of OpenSlice.</li>
<li><strong>Ingress Controller:</strong> Ingress exposes HTTP and HTTPS routes from outside the cluster to services within the cluster. Traffic routing is controlled by rules defined on the Ingress resource. An Ingress may be configured to give Services externally-reachable URLs, load balance traffic, terminate SSL / TLS, and offer name-based virtual hosting. An Ingress controller is responsible for fulfilling the Ingress, usually with a load balancer, though it may also configure your edge router or additional frontends to help handle the traffic. You must have an Ingress controller to satisfy an Ingress.<ul>
<li>An Nginx ingress controller is required, which can be installed using <a href="https://docs.nginx.com/nginx-ingress-controller/installation/installing-nic/installation-with-helm/">this guide</a>. </li>
<li>If you use another type of ingress controller, you'll need to modify <code>[repo-root]/kubernetes/helm/openslice/templates/openslice-ingress.yaml</code> to conform to your ingress controller's requirements.</li>
</ul>
</li>
<li><strong>Network Load Balancer:</strong> Required for exposing the service (e.g., GCP, AWS, Azure, MetalLB).</li>
<li><strong>Domain/IP Address:</strong> Necessary for accessing the application. This should be configured in <code>[repo-root]/kubernetes/helm/openslice/values.yaml</code> under <code>rooturl</code>.</li>
</ul>
<h3 id="additional-configuration">Additional Configuration</h3>
<ul>
<li><strong>Storage Class:</strong> In a production environment, specify your <code>storageClass</code> in <code>[repo-root]/kubernetes/helm/openslice/values.yaml</code> under <code>storageClass</code>. If not defined, PVs will be created and managed manually.<ul>
<li><strong>Disclaimer:</strong> Before deploying, confirm that your storage system supports claims of one 10G and two 1G volumes.</li>
</ul>
</li>
</ul>
<h2 id="preparing-the-environment">Preparing the environment</h2>
<h3 id="1-setting-up-a-kubernetes-cluster">1. Setting Up A Kubernetes Cluster</h3>
<p>Refer to the official Kubernetes documentation for setting up a cluster. Ensure your cluster meets the hardware requirements specified above.</p>
<h3 id="2-installing-helm">2. Installing Helm</h3>
<p>Helm must be installed on your machine to deploy OpenSlice via Helm charts. Follow the <a href="https://helm.sh/docs/intro/install/">official Helm installation guide</a>.</p>
<h2 id="downloading-the-project">Downloading the project</h2>
<h3 id="1-create-a-new-folder-to-download-the-project">1. Create a new folder to download the project</h3>
<pre><code class="language-bash">mkdir openslice
cd openslice
</code></pre>
<h3 id="2-download-the-project-code">2. Download the project code</h3>
<p>Clone the project code from the GitLab repository. 
<strong>Note:</strong> This process will be simplified once the charts are published in the GitLab registry, requiring only the chart to be pulled.</p>
<pre><code class="language-bash">git clone https://labs.etsi.org/rep/osl/code/org.etsi.osl.main.git
cd org.etsi.osl.main/kubernetes/helm/openslice/
</code></pre>
<h3 id="3-prerequisites-before-deployment">3. Prerequisites before deployment</h3>
<p>Before deploying the Helm chart, ensure you have configured the necessary components as detailed in the following section, i.e. <a href="#configure-helm-chart-services">Configure Helm Chart Services</a>. By default, the <code>main</code> branch is selected for deployment.</p>
<p>We recommend:</p>
<ul>
<li>main branch for the most stable experience and</li>
<li>develop branch for an experience with the latest features (for develop branch installation, it is strongly advisable that you may as well follow the <a href="https://osl.etsi.org/documentation/develop/deployment/">develop documentation</a>)</li>
</ul>
<h2 id="configure-helm-chart-services">Configure Helm Chart Services</h2>
<p>When deploying OpenSlice with Helm, service configurations are handled through the <code>values.yaml</code> file. This file allows you to define all necessary configurations for your deployment, including database credentials, service URLs, and logging levels. Below are examples of how to configure your services in Helm based on your provided values.</p>
<h3 id="configuring-services">Configuring Services</h3>
<h4 id="1-database-configuration">1. Database Configuration</h4>
<p>To configure MySQL and other related services, you can directly set the values in your <code>values.yaml</code> file under the <code>oscreds</code> and <code>mysql</code> sections. For example:</p>
<pre><code class="language-yaml">oscreds:
  mysql:
    username: &quot;root&quot;
    password: &quot;letmein&quot;
    openslicedb: &quot;osdb&quot;
    keycloak: 
      database: &quot;keycloak&quot;
      username: &quot;keycloak&quot;
      password: &quot;password&quot;
      adminpassword: &quot;Pa55w0rd&quot;
    portal:
      database: &quot;osdb&quot;
      username: &quot;portaluser&quot;
      password: &quot;12345&quot;
</code></pre>
<h4 id="2-keycloak-configuration">2. Keycloak Configuration</h4>
<p>Keycloak settings, including the database and admin password, are part of the <code>oscreds.mysql.keycloak</code> section. If you need to adjust Keycloak-specific settings like realms or client configurations, you'll likely need to customize your Helm chart further or manage these settings directly within Keycloak after deployment. The Keycloak realm configuration that is imported by default can be found under <code>kubernetes/helm/openslice/files/keycloak-init/realm-export.json</code>.</p>
<pre><code class="language-yaml">oscreds:
  mysql:
    keycloak: 
      database: &quot;keycloak&quot;
      username: &quot;keycloak&quot;
      password: &quot;password&quot;
      adminpassword: &quot;Pa55w0rd&quot;
</code></pre>
<h4 id="3-cridge-configuration">3. CRIDGE Configuration</h4>
<p>If you want to create and manage Kubernetes Custom Resources (CRs), you will have to provide:</p>
<ul>
<li>a cluster-wide scope kubeconf file (typically located at <code>/home/{user}/.kube</code> directory of the Kubernetes Cluster's host)</li>
</ul>
<p>You will have to copy the kubeconf file to the <code>org.etsi.osl.main/kubernetes/helm/openslice/files/org.etsi.osl.cridge</code> directory, <em>prior to the deployment</em>.</p>
<p>By default, the deployment process copies the <code>org.etsi.osl.main/kubernetes/helm/openslice/files/org.etsi.osl.cridge/config</code> file into the <code>/root/.kube</code> directory of the CRIDGE container.</p>
<blockquote>
<p><strong>The above configuration works for the default kubeconf file names. It explicitly expects a file named <code>config</code> within the <code>org.etsi.osl.main/kubernetes/helm/openslice/files/org.etsi.osl.cridge</code> directory. If you are working with custom kubeconf file names, you will have to rename them.</strong></p>
</blockquote>
<p>OpenSlice also offers management support of <em>multiple Kubernetes Clusters</em> simultaneously. For this, you will have to:</p>
<ul>
<li>add all the respective kubeconf files into the <code>org.etsi.osl.main/compose/kubedir</code> directory. </li>
<li>create a copy of the <code>cridge.yaml</code> and <code>cridge-config.yaml</code> in <code>\org.etsi.osl.main\kubernetes\helm\openslice\templates</code> directory for every Cluster. <em>Mind the need for different naming</em>.</li>
<li>update every <code>cridge-config.yaml</code> file to get the appropriate kubeconf file for every Cluster.</li>
</ul>
<p>Below you may find an indicative example that only references the affected fields of each cridge-config.yaml file:</p>
<pre><code class="language-yaml">data:
  config: |-
    {{- .Files.Get &quot;files/org.etsi.osl.cridge/config-clusterX&quot; | nindent 4 }}
</code></pre>
<h4 id="4-external-services-configuration">4. External Services Configuration</h4>
<p>For configuring optional external services like Bugzilla and CentralLog, specify their URLs and credentials in the <code>values.yaml</code> file:</p>
<pre><code class="language-yaml">bugzillaurl: &quot;example.com:443/bugzilla&quot;
bugzillakey: &quot;VH2Vw0iI5aYgALFFzVDWqhACwt6Hu3bXla9kSC1Z&quot;
main_operations_product: &quot;Main Site Operations&quot; // this is the default product to issue tickets
centrallogurl: &quot;http://elk_ip:elk_port/index_name/_doc&quot;
</code></pre>
<p>Bugzilla should have the following components under the specified product:  </p>
<ul>
<li>NSD Deployment Request: Component used to schedule deployment req  </li>
<li>Onboarding: Issues related to VNF/NSD Onboarding  </li>
<li>Operations Support: Default component for operations support  </li>
<li>Validation: Use to track validation processes of VNFs and NSDs  </li>
<li>VPN Credentials/Access: Used for requesting VPN Credentials/Access   </li>
</ul>
<p>Also in the 'Main Site Operations' product, a version named 'unspecified' must be created.</p>
<h4 id="5-application-and-logging-configuration">5. Application and Logging Configuration</h4>
<p>Application-specific configurations, such as OAuth client secrets, can be set in the <code>spring</code> section:</p>
<pre><code class="language-yaml">spring:
  oauthClientSecret: &quot;secret&quot;
</code></pre>
<h4 id="6-ingress-and-root-url">6. Ingress and Root URL</h4>
<p>To configure the ingress controller and root URL for OpenSlice, update the rooturl field with your ingress load balancer IP or domain. This setting is crucial for external access to your application:</p>
<pre><code class="language-yaml">rooturl: &quot;http://openslice.com&quot; # Example domain
# or
rooturl: &quot;http://3.15.198.35:8080&quot; # Example IP with port
</code></pre>
<h4 id="7-persistent-volume-for-mysql">7. Persistent Volume for MySQL</h4>
<p>For persistent storage, especially for MySQL, define the storage size under the <code>mysql</code> section. This ensures that your database retains data across pod restarts and deployments.</p>
<pre><code class="language-yaml">mysql:
  storage: &quot;10Gi&quot;
</code></pre>
<h3 id="configure-web-ui">Configure Web UI</h3>
<p>In folder <code>kubernetes/helm/openslice/files/org.etsi.osl.portal.web/src/js</code> you must make a copy of <code>config.js.default</code> file and rename it to <code>config.js</code>. </p>
<p>This is <strong>mandatory</strong> for the configuration file to be discoverable.</p>
<p>Edit the <code>config.js</code> configuration file with your static configuration, if needed.</p>
<pre><code>{
  TITLE: &quot;OpenSlice by ETSI&quot;,
  WIKI: &quot;https://osl.etsi.org/documentation/&quot;,
  BUGZILLA: &quot;{{ .Values.rooturl }}/bugzilla&quot;,
  STATUS: &quot;{{ .Values.rooturl }}/status&quot;,
  APIURL: &quot;{{ .Values.rooturl }}&quot;,
  WEBURL: &quot;{{ .Values.rooturl }}/nfvportal&quot;,
  APIOAUTHURL: &quot;{{ .Values.rooturl }}/auth/realms/openslice&quot;,
  APITMFURL: &quot;{{ .Values.rooturl }}/tmf-api/serviceCatalogManagement/v4&quot;
}
</code></pre>
<h3 id="configure-tmf-web-ui">Configure TMF Web UI</h3>
<p>In the folder <code>kubernetes/helm/openslice/files/org.etsi.osl.tmf.web/src/assets/config</code> there are 3 files available for configuration:</p>
<ul>
<li>config.prod.default.json (Basic information + API configuration)</li>
<li>theming.default.scss (CSS color palette theming)</li>
<li>config.theming.default.json (HTML configuration - Logo, Favicon, Footer)</li>
</ul>
<p>You must make a copy of files:</p>
<ul>
<li><code>config.prod.default.json</code> and rename it to <code>config.prod.json</code></li>
<li><code>theming.default.scss</code> and rename it to <code>theming.scss</code></li>
</ul>
<p>The 2 files above (i.e. config.prod.json, theming.scss) are essential for the successful deployment of OpenSlice, and executing the above steps is <strong>mandatory</strong> for the configuration files to be discoverable.</p>
<p>Ensure that you check the <code>config.prod.json</code> and <code>theming.scss</code> files and readjust to your deployment if needed.</p>
<pre><code class="language-bash"># Starting from the root project directory
cd kubernetes/helm/openslice/files/org.etsi.osl.tmf.web/src/assets/config
</code></pre>
<p>E.g. You may edit "TITLE", "WIKI", etc properties with your domain title. Also configure TMF's API and Keycloak's location for the web application, if needed.</p>
<pre><code>{         
    &quot;TITLE&quot;: &quot;OpenSlice by ETSI&quot;,
    &quot;PORTALVERSION&quot;:&quot;2024Q2&quot;,
    &quot;WIKI&quot;: &quot;https://osl.etsi.org/documentation&quot;,
    &quot;BUGZILLA&quot;: &quot;{BASEURL}/bugzilla/&quot;,
    &quot;STATUS&quot;: &quot;{BASEURL}/status/&quot;,
    &quot;WEBURL&quot;: &quot;{BASEURL}&quot;,
    &quot;PORTAL_REPO_APIURL&quot;: &quot;{BASEURL}/osapi&quot;,
    &quot;ASSURANCE_SERVICE_MGMT_APIURL&quot;: &quot;{BASEURL}/oas-api&quot;,
    &quot;APITMFURL&quot;: &quot;{BASEURL}/tmf-api&quot;,
    &quot;OAUTH_CONFIG&quot; : {
        &quot;issuer&quot;: &quot;{BASEURL}/auth/realms/openslice&quot;,
        &quot;loginUrl&quot;: &quot;{BASEURL}/auth/realms/openslice/protocol/openid-connect/auth&quot;,
        &quot;tokenEndpoint&quot;: &quot;{BASEURL}/auth/realms/openslice/protocol/openid-connect/token&quot;,
        &quot;userinfoEndpoint&quot;: &quot;{BASEURL}/auth/realms/openslice/protocol/openid-connect/userinfo&quot;,
        &quot;redirectUri&quot;: &quot;{BASEURL}/redirect&quot;,
        &quot;logoutUrl&quot;: &quot;{BASEURL}/auth/realms/openslice/protocol/openid-connect/logout&quot;, 
        &quot;postLogoutRedirectUri&quot;: &quot;{BASEURL}&quot;,

        &quot;responseType&quot;: &quot;code&quot;,
        &quot;oidc&quot;: false,
        &quot;clientId&quot;: &quot;osapiWebClientId&quot;,
        &quot;dummyClientSecret&quot;: &quot;secret&quot;,

        &quot;requireHttps&quot;: false,
        &quot;useHttpBasicAuth&quot;: true,
        &quot;clearHashAfterLogin&quot;: false,

        &quot;showDebugInformation&quot;: true
    }
}
</code></pre>
<blockquote>
<p>The {BASEURL} placeholder in the file automatically detects the Origin (Protocol://Domain:Port) of the deployment and applies it to every respective property. E.g. If you are attempting a local deployment of OpenSlice, then {BASEURL} is automatically translated to "http://localhost". Similarly, you may use {BASEURL} to translate to a public deployment configuration, e.g. "https://portal.openslice.io".</p>
</blockquote>
<p>If further customization, apart from the default provided, is needed for branding (Logo, Footer) then <code>config.theming.json</code> needs to be created in kubernetes/helm/openslice/files/org.etsi.osl.tmf.web/src/assets/config directory, as follows:</p>
<pre><code class="language-bash"># Starting from the root project directory
cd kubernetes/helm/openslice/files/org.etsi.osl.tmf.web/src/assets/config
</code></pre>
<pre><code class="language-bash">sudo cp config.theming.default.json config.theming.json
</code></pre>
<h2 id="deploy-the-helm-chart">Deploy the Helm Chart</h2>
<p>After configuring the services, and editing the <code>values.yaml</code> file accordingly, the helm install command can be performed.</p>
<pre><code class="language-bash">cd kubernetes/helm/openslice/
helm install myopenslice . --namespace openslice --create-namespace
</code></pre>
<h2 id="validating-deployments-and-container-monitoring">Validating deployments and container monitoring</h2>
<p>In a Kubernetes environment, you can monitor the status of your deployments and containers using <code>kubectl</code>, the Kubernetes command-line tool, which provides powerful capabilities for inspecting the state of resources in your cluster.</p>
<h3 id="checking-the-status-of-your-applications-deployment">Checking the Status of your application's deployment</h3>
<p>To check the status of your deployment, use the following commands. The output should be similar:</p>
<pre><code class="language-bash">
kubectl get pods -n openslice

NAME                      READY   UP-TO-DATE   AVAILABLE   AGE
myopenslice-artemis       1/1     1            1           6m28s
myopenslice-blockdiag     1/1     1            1           6m28s
myopenslice-bugzilla      1/1     1            1           6m28s
myopenslice-centrallog    1/1     1            1           6m28s
myopenslice-cridge        1/1     1            1           6m28s
myopenslice-keycloak      1/1     1            1           6m28s
myopenslice-kroki         1/1     1            1           6m28s
myopenslice-manoclient    1/1     1            1           6m28s
myopenslice-oasapi        1/1     1            1           6m28s
myopenslice-osom          1/1     1            1           6m28s
myopenslice-osportalapi   1/1     1            1           6m28s
myopenslice-osscapi       1/1     1            1           6m28s
myopenslice-portalweb     1/1     1            1           6m28s
myopenslice-tmfweb        1/1     1            1           6m28s
</code></pre>
<pre><code class="language-bash">kubectl get deployments -n openslice

NAME                      READY   UP-TO-DATE   AVAILABLE   AGE
myopenslice-artemis       1/1     1            1           7m17s
myopenslice-blockdiag     1/1     1            1           7m17s
myopenslice-bugzilla      1/1     1            1           7m17s
myopenslice-centrallog    1/1     1            1           7m17s
myopenslice-cridge        1/1     1            1           7m17s
myopenslice-keycloak      1/1     1            1           7m17s
myopenslice-kroki         1/1     1            1           7m17s
myopenslice-manoclient    1/1     1            1           7m17s
myopenslice-oasapi        1/1     1            1           7m17s
myopenslice-osom          1/1     1            1           7m17s
myopenslice-osportalapi   1/1     1            1           7m17s
myopenslice-osscapi       1/1     1            1           7m17s
myopenslice-portalweb     1/1     1            1           7m17s
myopenslice-tmfweb        1/1     1            1           7m17s
</code></pre>
<pre><code class="language-bash">kubectl get services -n openslice

NAME                      TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)                        AGE
myopenslice-artemis       ClusterIP   10.101.128.223   &lt;none&gt;        8161/TCP,61616/TCP,61613/TCP   7m43s
myopenslice-blockdiag     ClusterIP   10.109.196.90    &lt;none&gt;        8001/TCP                       7m43s
myopenslice-bugzilla      ClusterIP   10.107.10.101    &lt;none&gt;        13010/TCP                      7m43s
myopenslice-centrallog    ClusterIP   10.109.84.33     &lt;none&gt;        13013/TCP                      7m43s
myopenslice-keycloak      ClusterIP   10.104.172.73    &lt;none&gt;        8080/TCP,8443/TCP              7m43s
myopenslice-kroki         ClusterIP   10.106.92.111    &lt;none&gt;        8000/TCP                       7m43s
myopenslice-manoclient    ClusterIP   10.100.143.154   &lt;none&gt;        13011/TCP                      7m43s
myopenslice-mysql         ClusterIP   10.108.206.75    &lt;none&gt;        3306/TCP                       7m43s
myopenslice-oasapi        ClusterIP   10.100.107.66    &lt;none&gt;        13101/TCP                      7m43s
myopenslice-osom          ClusterIP   10.97.88.133     &lt;none&gt;        13100/TCP                      7m43s
myopenslice-osportalapi   ClusterIP   10.111.212.76    &lt;none&gt;        13000/TCP                      7m43s
myopenslice-osscapi       ClusterIP   10.101.84.220    &lt;none&gt;        13082/TCP                      7m43s
myopenslice-portalweb     ClusterIP   10.101.16.112    &lt;none&gt;        80/TCP                         7m43s
myopenslice-tmfweb        ClusterIP   10.101.157.185   &lt;none&gt;        80/TCP                         7m43s
</code></pre>
<h3 id="accessing-logs-for-troubleshooting">Accessing Logs for Troubleshooting</h3>
<p>If a pod is not in the expected state, you can access its logs for troubleshooting:</p>
<pre><code class="language-bash">kubectl logs &lt;pod-name&gt; -n openslice
</code></pre>
<h2 id="post-installation-steps">Post installation steps</h2>
<p>After the successful deployment of OpenSlice, to ensure the E2E user experience, <strong>this section is mandatory</strong>. It contains crucial configuration in regard of authentication and user creation.</p>
<h3 id="configure-keycloak-server">Configure Keycloak server</h3>
<p>The Keycloack server is managing authentication and running on a container at port 8080. It is also proxied to your host via the ingress resource under http://your-domain/auth. </p>
<ul>
<li>
<p>Navigate to http://your-domain/auth/ or https://your-domain/auth/, (http://ipaddress:8080/auth/ or https://ipaddress:8443/auth/ which are directly accessible without proxy) </p>
</li>
<li>
<p>Navigate to Administration Console </p>
</li>
<li>
<p>Login with the credentials from section <a href="#3-keycloak-configuration">Keycloak Configuration</a>. Default values are:</p>
<ul>
<li>user: admin </li>
<li>password: Pa55w0rd</li>
</ul>
</li>
</ul>
<blockquote>
<p>This applies only if you are running in HTTP and get a message: HTTPS required.</p>
</blockquote>
<p>To resolve this issue <u>when running in HTTP</u>: </p>
<ul>
<li>Select the master realm from top left corner</li>
<li>Go to login Tab and select "Require SSL": None</li>
<li>Repeat for realm Openslice</li>
</ul>
<blockquote>
<p>If you are running in HTTPS, then "Require SSL" can be left unchanged to external requests.</p>
</blockquote>
<h4 id="1-configure-email">1. Configure email</h4>
<p>Keycloak allows new users to register. Subsequently, this will also allow new users to register to the OpenSlice portal.</p>
<p>Navigate to realm Openslice &gt; Realm Settings &gt; Login Tab &gt; check User registration, Verify email, Forgot password etc.</p>
<p>Finally, enter the details of the mail server at the Email Tab.</p>
<blockquote>
<p>Email configuration is optional for test runs, but if not provided the above functionalities (e.g. external user registration) will not be possible.</p>
</blockquote>
<h4 id="2-add-an-openslice-admin-user">2. Add an OpenSlice admin user</h4>
<p>This step is mandatory so as to access the OpenSlice Web UI. To add an OpenSlice admin user you must:
- Navigate to realm Openslice &gt; Users &gt; Add user 
- Set a password
- Upon creation, navigate to Role Mappings and add ADMIN to Assigned Roles list</p>
<blockquote>
<p>That user is different from the Keycloak admin user. It is required to login and browse the OpenSlice Web UI. The Role ADMIN guarantee full access through the OpenSlice UI, thus such a user is always required.</p>
</blockquote>
<h3 id="nfv-orchestrator-configuration">NFV Orchestrator Configuration</h3>
<p>After successfully deploying and configuring OpenSlice, you may configure its environment (e.g. the NFVO) that will facilitate the deployment of NFV artifacts.</p>
<p>See <a href="../nfvoconfig/">NFV Orchestrator Configuration</a>.</p>












                
              </article>
            </div>
          
          
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
        </div>
        
          <button type="button" class="md-top md-icon" data-md-component="top" hidden>
  
  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg>
  Back to top
</button>
        
      </main>
      
        <footer class="md-footer">
  
    
      
      <nav class="md-footer__inner md-grid" aria-label="Footer" >
        
          
          <a href="../deploymentCompose/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Docker Compose">
            <div class="md-footer__button md-icon">
              
              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
            </div>
            <div class="md-footer__title">
              <span class="md-footer__direction">
                Previous
              </span>
              <div class="md-ellipsis">
                Docker Compose
              </div>
            </div>
          </a>
        
        
          
          <a href="../portals_intro/" class="md-footer__link md-footer__link--next" aria-label="Next: Introduction">
            <div class="md-footer__title">
              <span class="md-footer__direction">
                Next
              </span>
              <div class="md-ellipsis">
                Introduction
              </div>
            </div>
            <div class="md-footer__button md-icon">
              
              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
            </div>
          </a>
        
      </nav>
    
  
  <div class="md-footer-meta md-typeset">
    <div class="md-footer-meta__inner md-grid">
      <div class="md-copyright">
  
    <div class="md-copyright__highlight">
      Copyright &copy; 2024 ETSI OSL
    </div>
  
  
    Made with
    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
      Material for MkDocs
    </a>
  
</div>
      
        <div class="md-social">
  
    
    
    
    
      
      
    
    <a href="https://osl.etsi.org/" target="_blank" rel="noopener" title="osl.etsi.org" class="md-social__link">
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M352 256c0 22.2-1.2 43.6-3.3 64H163.4c-2.2-20.4-3.3-41.8-3.3-64s1.2-43.6 3.3-64h185.3c2.2 20.4 3.3 41.8 3.3 64zm28.8-64h123.1c5.3 20.5 8.1 41.9 8.1 64s-2.8 43.5-8.1 64H380.8c2.1-20.6 3.2-42 3.2-64s-1.1-43.4-3.2-64zm112.6-32H376.7c-10-63.9-29.8-117.4-55.3-151.6 78.3 20.7 142 77.5 171.9 151.6zm-149.1 0H167.7c6.1-36.4 15.5-68.6 27-94.7 10.5-23.6 22.2-40.7 33.5-51.5C239.4 3.2 248.7 0 256 0s16.6 3.2 27.8 13.8c11.3 10.8 23 27.9 33.5 51.5 11.6 26 20.9 58.2 27 94.7zm-209 0H18.6c30-74.1 93.6-130.9 172-151.6-25.5 34.2-45.3 87.7-55.3 151.6zM8.1 192h123.1c-2.1 20.6-3.2 42-3.2 64s1.1 43.4 3.2 64H8.1C2.8 299.5 0 278.1 0 256s2.8-43.5 8.1-64zm186.6 254.6c-11.6-26-20.9-58.2-27-94.6h176.6c-6.1 36.4-15.5 68.6-27 94.6-10.5 23.6-22.2 40.7-33.5 51.5-11.2 10.7-20.5 13.9-27.8 13.9s-16.6-3.2-27.8-13.8c-11.3-10.8-23-27.9-33.5-51.5zM135.3 352c10 63.9 29.8 117.4 55.3 151.6-78.4-20.7-142-77.5-172-151.6h116.7zm358.1 0c-30 74.1-93.6 130.9-171.9 151.6 25.5-34.2 45.2-87.7 55.3-151.6h116.7z"/></svg>
    </a>
  
    
    
    
    
      
      
    
    <a href="https://labs.etsi.org/rep/osl" target="_blank" rel="noopener" title="labs.etsi.org" class="md-social__link">
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="m503.5 204.6-.7-1.8-69.7-181.78c-1.4-3.57-3.9-6.59-7.2-8.64-2.4-1.55-5.1-2.515-8-2.81-2.9-.295-5.7.083-8.4 1.11-2.7 1.02-5.1 2.66-7.1 4.78-1.9 2.12-3.3 4.67-4.1 7.44l-47 144H160.8l-47.1-144c-.8-2.77-2.2-5.31-4.1-7.43-2-2.12-4.4-3.75-7.1-4.77a18.1 18.1 0 0 0-8.38-1.113 18.4 18.4 0 0 0-8.04 2.793 18.09 18.09 0 0 0-7.16 8.64L9.267 202.8l-.724 1.8a129.57 129.57 0 0 0-3.52 82c7.747 26.9 24.047 50.7 46.447 67.6l.27.2.59.4 105.97 79.5 52.6 39.7 32 24.2c3.7 1.9 8.3 4.3 13 4.3 4.7 0 9.3-2.4 13-4.3l32-24.2 52.6-39.7 106.7-79.9.3-.3c22.4-16.9 38.7-40.6 45.6-67.5 8.6-27 7.4-55.8-2.6-82z"/></svg>
    </a>
  
    
    
    
    
      
      
    
    <a href="https://www.linkedin.com/company/openslice/" target="_blank" rel="noopener" title="www.linkedin.com" class="md-social__link">
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M416 32H31.9C14.3 32 0 46.5 0 64.3v383.4C0 465.5 14.3 480 31.9 480H416c17.6 0 32-14.5 32-32.3V64.3c0-17.8-14.4-32.3-32-32.3zM135.4 416H69V202.2h66.5V416zm-33.2-243c-21.3 0-38.5-17.3-38.5-38.5S80.9 96 102.2 96c21.2 0 38.5 17.3 38.5 38.5 0 21.3-17.2 38.5-38.5 38.5zm282.1 243h-66.4V312c0-24.8-.5-56.7-34.5-56.7-34.6 0-39.9 27-39.9 54.9V416h-66.4V202.2h63.7v29.2h.9c8.9-16.8 30.6-34.5 62.9-34.5 67.2 0 79.7 44.3 79.7 101.9V416z"/></svg>
    </a>
  
    
    
    
    
      
      
    
    <a href="https://twitter.com/OpensliceOSS" target="_blank" rel="noopener" title="twitter.com" class="md-social__link">
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M389.2 48h70.6L305.6 224.2 487 464H345L233.7 318.6 106.5 464H35.8l164.9-188.5L26.8 48h145.6l100.5 132.9L389.2 48zm-24.8 373.8h39.1L151.1 88h-42l255.3 333.8z"/></svg>
    </a>
  
</div>
      
    </div>
  </div>
</footer>
      
    </div>
    <div class="md-dialog" data-md-component="dialog">
      <div class="md-dialog__inner md-typeset"></div>
    </div>
    
      <div class="md-progress" data-md-component="progress" role="progressbar"></div>
    
    
    <script id="__config" type="application/json">{"base": "..", "features": ["navigation.instant", "navigation.instant.progress", "navigation.top", "navigation.footer", "navigation.path", "search", "search.highlight"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"provider": "mike"}}</script>
    
    
      <script src="../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
      
    
  </body>
</html>