Skip to content
Snippets Groups Projects
index.html 92.1 KiB
Newer Older

<!doctype html>
<html lang="en" class="no-js">
  <head>
    
      <meta charset="utf-8">
      <meta name="viewport" content="width=device-width,initial-scale=1">
      
        <meta name="description" content="ETSI SDG OSL Documentation page">
      
      
        <meta name="author" content="OpenSlice by ETSI">
      
      
        <link rel="canonical" href="https://osl.etsi.org/develop/deploymentCompose/">
      
      
        <link rel="prev" href="../deployment/">
      
      
        <link rel="next" href="../deploymentK8s/">
      
      
      <link rel="icon" href="../images/favicon.png">
      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.28">
    
    
      
        <title>Docker Compose - ETSI SDG OSL Documentation</title>
      
    
    
      <link rel="stylesheet" href="../assets/stylesheets/main.6543a935.min.css">
      
        
        <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
      
      


    
    
      
    
    
      
        
        
        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
      
    
    
    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
    
      

    
    
    
  </head>
  
  
    
    
    
    
    
    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="cyan" data-md-color-accent="blue">
  
    
    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
    <label class="md-overlay" for="__drawer"></label>
    <div data-md-component="skip">
      
        
        <a href="#openslice-deployment-guide-with-docker-compose" class="md-skip">
          Skip to content
        </a>
      
    </div>
    <div data-md-component="announce">
      
    </div>
    
      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
        
      </div>
    
    
      

  

<header class="md-header md-header--shadow" data-md-component="header">
  <nav class="md-header__inner md-grid" aria-label="Header">
    <a href=".." title="ETSI SDG OSL Documentation" class="md-header__button md-logo" aria-label="ETSI SDG OSL Documentation" data-md-component="logo">
      
  <img src="../images/logo_osl.png" alt="logo">

    </a>
    <label class="md-header__button md-icon" for="__drawer">
      
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
    </label>
    <div class="md-header__title" data-md-component="header-title">
      <div class="md-header__ellipsis">
        <div class="md-header__topic">
          <span class="md-ellipsis">
            ETSI SDG OSL Documentation
          </span>
        </div>
        <div class="md-header__topic" data-md-component="header-topic">
          <span class="md-ellipsis">
            
              Docker Compose
            
          </span>
        </div>
      </div>
    </div>
    
      
    
    
    
    
      <label class="md-header__button md-icon" for="__search">
        
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
      </label>
      <div class="md-search" data-md-component="search" role="dialog">
  <label class="md-search__overlay" for="__search"></label>
  <div class="md-search__inner" role="search">
    <form class="md-search__form" name="search">
      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
      <label class="md-search__icon md-icon" for="__search">
        
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
        
        <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>
      </label>
      <nav class="md-search__options" aria-label="Search">
        
        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
          
          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
        </button>
      </nav>
      
    </form>
    <div class="md-search__output">
      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
        <div class="md-search-result" data-md-component="search-result">
          <div class="md-search-result__meta">
            Initializing search
          </div>
          <ol class="md-search-result__list" role="presentation"></ol>
        </div>
      </div>
    </div>
  </div>
</div>
    
    
      <div class="md-header__source">
        <a href="https://labs.etsi.org/rep/osl" title="Go to repository" class="md-source" data-md-component="source">
  <div class="md-source__icon md-icon">
    
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.5.2 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>
  </div>
  <div class="md-source__repository">
    OSL GitLab
  </div>
</a>
      </div>
    
  </nav>
  
</header>
    
    <div class="md-container" data-md-component="container">
      
      
        
          
        
      
      <main class="md-main" data-md-component="main">
        <div class="md-main__inner md-grid">
          
            
              
              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
                <div class="md-sidebar__scrollwrap">
                  <div class="md-sidebar__inner">
                    



<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  <label class="md-nav__title" for="__drawer">
    <a href=".." title="ETSI SDG OSL Documentation" class="md-nav__button md-logo" aria-label="ETSI SDG OSL Documentation" data-md-component="logo">
      
  <img src="../images/logo_osl.png" alt="logo">

    </a>
    ETSI SDG OSL Documentation
  </label>
  
    <div class="md-nav__source">
      <a href="https://labs.etsi.org/rep/osl" title="Go to repository" class="md-source" data-md-component="source">
  <div class="md-source__icon md-icon">
    
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.5.2 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>
  </div>
  <div class="md-source__repository">
    OSL GitLab
  </div>
</a>
    </div>
  
  <ul class="md-nav__list" data-md-scrollfix>
    
      
      
  
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" >
        
          
          <label class="md-nav__link" for="__nav_1" id="__nav_1_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Overview
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_1">
            <span class="md-nav__icon md-icon"></span>
            Overview
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href=".." class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Introduction
  </span>
  

      </a>
    </li>
  

              
            
      <a href="../OpenSlice_deployment_examples/" class="md-nav__link">
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../history/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    History
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../etsi_osl/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    ETSI OSL
  </span>
  

      </a>
    </li>
  

              
            
          </ul>
        </nav>
      
    </li>
  

    
      
      
  
  
    
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
        
          
          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Getting Started
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
          <label class="md-nav__title" for="__nav_2">
            <span class="md-nav__icon md-icon"></span>
            Getting Started
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
    
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1" checked>
        
          
          <label class="md-nav__link" for="__nav_2_1" id="__nav_2_1_label" tabindex="0">
            
  
  <span class="md-ellipsis">
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_1_label" aria-expanded="true">
          <label class="md-nav__title" for="__nav_2_1">
            <span class="md-nav__icon md-icon"></span>
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../deployment/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
    
  
  
  
    <li class="md-nav__item md-nav__item--active">
      
      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
      
      
        
      
      
        <label class="md-nav__link md-nav__link--active" for="__toc">
          
  
  <span class="md-ellipsis">
    Docker Compose
  </span>
  

          <span class="md-nav__icon md-icon"></span>
        </label>
      
      <a href="./" class="md-nav__link md-nav__link--active">
        
  
  <span class="md-ellipsis">
    Docker Compose
  </span>
  

      </a>
      
        

<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>
        
      </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-backup-your-previous-database-if-necessary" class="md-nav__link">
    <span class="md-ellipsis">
      1. Backup your previous database if necessary:
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-install-docker" class="md-nav__link">
    <span class="md-ellipsis">
      2. Install docker
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-configure-containers-to-properly-resolve-the-dns-of-your-domain-optional" class="md-nav__link">
    <span class="md-ellipsis">
      3. Configure containers to properly resolve the DNS of your domain (optional)
    </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-deployment-script" class="md-nav__link">
    <span class="md-ellipsis">
      2. Download the deployment script
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-run-the-deployment-script" class="md-nav__link">
    <span class="md-ellipsis">
      3. Run the deployment script
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#configure-docker-compose-services" class="md-nav__link">
    <span class="md-ellipsis">
      Configure Docker Compose services
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Configure Docker Compose services">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#1-create-configuration-specific-docker-compose-file-from-the-template" class="md-nav__link">
    <span class="md-ellipsis">
      1. Create configuration specific Docker Compose file from the template
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-configure-mysql-portal-container-optional" class="md-nav__link">
    <span class="md-ellipsis">
      2. Configure mysql-portal container (optional)
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-configure-keycloak-container-optional" class="md-nav__link">
    <span class="md-ellipsis">
      3. Configure keycloak container (optional)
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#4-configure-bugzilla-container-optional" class="md-nav__link">
    <span class="md-ellipsis">
      4. Configure bugzilla container (optional)
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#5-configure-osportalapi-container-nfv-services-conditional" class="md-nav__link">
    <span class="md-ellipsis">
      5. Configure osportalapi container (NFV services) (conditional)
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#6-osscapi-container-tmf-api-service-conditional" class="md-nav__link">
    <span class="md-ellipsis">
      6. osscapi container (TMF API service) (conditional)
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#configure-nginx" class="md-nav__link">
    <span class="md-ellipsis">
      Configure nginx
    </span>
  </a>
  
</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>
      
        <li class="md-nav__item">
  <a href="#deploy-openslice-via-docker-compose" class="md-nav__link">
    <span class="md-ellipsis">
      Deploy OpenSlice via Docker Compose
    </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>
  
</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-redirects" class="md-nav__link">
    <span class="md-ellipsis">
      1. Configure redirects
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-configure-email" class="md-nav__link">
    <span class="md-ellipsis">
      2. Configure email
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-add-an-openslice-admin-user" class="md-nav__link">
    <span class="md-ellipsis">
      3. Add an OpenSlice admin user
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
        
          <li class="md-nav__item">
  <a href="#keycloak-at-localhost" class="md-nav__link">
    <span class="md-ellipsis">
      Keycloak at localhost
    </span>
  </a>
  
</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>
      
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2" >
        
          
          <label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
            
  
  <span class="md-ellipsis">
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_2_2">
            <span class="md-nav__icon md-icon"></span>
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../config_intro/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Introduction
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
      <a href="../role_keycloak_management.md" class="md-nav__link">
    <li class="md-nav__item">
      <a href="../nfvoconfig/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    NFV Orchestrator Configuration
  </span>
  

      </a>
    </li>
  

              
            
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_4" >
        
          
          <label class="md-nav__link" for="__nav_2_2_4" id="__nav_2_2_4_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Advanced topics
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_2_4_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_2_2_4">
            <span class="md-nav__icon md-icon"></span>
            Advanced topics
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/consumingServicesFromExternalPartners/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Consuming Services From External OSS
  </span>
  

      </a>
    </li>
  

              
            
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_3">
            <span class="md-nav__icon md-icon"></span>
      <a href="../naas/introduction/" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2" >
          <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_3_2">
            <span class="md-nav__icon md-icon"></span>
            Services
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
      <a href="../naas/service_catalog/" class="md-nav__link">
      <a href="../naas/service_spec/" class="md-nav__link">
      <a href="../naas/service_inventory/" class="md-nav__link">
      <a href="../naas/gst_to_tmf.md" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_3" >
          <label class="md-nav__link" for="__nav_3_3" id="__nav_3_3_label" tabindex="0">
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_3_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_3_3">
            <span class="md-nav__icon md-icon"></span>
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
      <a href="../naas/resource_catalog/" class="md-nav__link">
      <a href="../naas/resource_spec/" class="md-nav__link">
      <a href="../naas/resource_inventory/" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_4" >
          <label class="md-nav__link" for="__nav_3_4" id="__nav_3_4_label" tabindex="0">
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_4_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_3_4">
            <span class="md-nav__icon md-icon"></span>
      <a href="../naas/so_intro/" class="md-nav__link">
      <a href="../naas/lcm_intro/" class="md-nav__link">
      <a href="../naas/lcm_rules_intro/" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_4_4" >
          <label class="md-nav__link" for="__nav_3_4_4" id="__nav_3_4_4_label" tabindex="0">
    From Service order to services/resources
            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_4_4_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_3_4_4">
            <span class="md-nav__icon md-icon"></span>
            From Service order to services/resources
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
      <a href="../naas/so_servicespec_to_services_kubernetes/" class="md-nav__link">
      <a href="../naas/so_servicespec_to_services_nfv/" class="md-nav__link">
      <a href="../naas/exposed_apis/" class="md-nav__link">
              
                
  
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_6" >
        
          
          <label class="md-nav__link" for="__nav_3_6" id="__nav_3_6_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    NFV support
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_6_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_3_6">
            <span class="md-nav__icon md-icon"></span>
            NFV support
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../naas/nfv/intro/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Introduction
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../naas/nfv/nfvcatalogs/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    NFV Catalogs
  </span>
  

      </a>
    </li>
  

              
            
          </ul>
        </nav>
      
    </li>
  

              
            
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_4">
            <span class="md-nav__icon md-icon"></span>
            Service design
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
      <a href="../service_design/intro/" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_2" >
          <label class="md-nav__link" for="__nav_4_2" id="__nav_4_2_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Support for Kubernetes
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_2_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_4_2">
            <span class="md-nav__icon md-icon"></span>
            Support for Kubernetes
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../service_design/kubernetes/intro/" class="md-nav__link">
      <a href="../service_design/kubernetes/ExposingKubernetesResources/" class="md-nav__link">
      <a href="../service_design/kubernetes/helm/design_helmaas/" class="md-nav__link">
          </ul>
        </nav>
      
    </li>
  

              
            
              
                
  
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_3" >
        
          
          <label class="md-nav__link" for="__nav_4_3" id="__nav_4_3_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Support for NFV
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_3_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_4_3">
            <span class="md-nav__icon md-icon"></span>
            Support for NFV
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
      <a href="../service_design/nfv/design_nfv_services/" class="md-nav__link">
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_4" >
        
          
          <label class="md-nav__link" for="__nav_4_4" id="__nav_4_4_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    LCM Rules
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_4_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_4_4">
            <span class="md-nav__icon md-icon"></span>
            LCM Rules
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../service_design/lcmrules/intro.md" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Introduction
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
      <a href="../service_design/lcmrules/specification.md" class="md-nav__link">
      <a href="../service_design/lcmrules/examples.md" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_5" >
          <label class="md-nav__link" for="__nav_4_5" id="__nav_4_5_label" tabindex="0">
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_5_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_4_5">
            <span class="md-nav__icon md-icon"></span>
      <a href="../service_design/examples/open5gs_nfv.md" class="md-nav__link">
      <a href="../service_design/examples/open5gs_kubernetes.md" class="md-nav__link">
      <a href="../service_design/examples/ExposingCRDs_aaS_Example_Calculator/ExposingCRDs_aaS_Example_Calculator/" class="md-nav__link">
      <a href="../service_design/kubernetes/helm/HELM_Installation_aaS_Jenkins_Example/" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Service Ordering
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_5">
            <span class="md-nav__icon md-icon"></span>
            Service Ordering
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../service_ordering/ordering_services.md" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Testing services
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_6">
            <span class="md-nav__icon md-icon"></span>
            Testing services
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../testing_services/test_spec.md" class="md-nav__link">
      <a href="../testing_services/test_catalogs.md" class="md-nav__link">
      <a href="../testing_services/test_inventory.md" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Service as a Product
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_7">
            <span class="md-nav__icon md-icon"></span>
            Service as a Product
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../product_model/product_spec.md" class="md-nav__link">
      <a href="../product_model/product_catalogs.md" class="md-nav__link">
      <a href="../product_model/product_inventory.md" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Assurance services
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_8">
            <span class="md-nav__icon md-icon"></span>
            Assurance services
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../assurance_services/intro.md" class="md-nav__link">
      <a href="../assurance_services/alarms_actions.md" class="md-nav__link">
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Design & Architecture
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_9">
            <span class="md-nav__icon md-icon"></span>
            Design & Architecture
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/architecture/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Architecture
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >
          <label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    Cloud native support
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_9_2">
            <span class="md-nav__icon md-icon"></span>
            Cloud native support
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/CRIDGE_cloud_native_intro.md" class="md-nav__link">
      <a href="../architecture/CRIDGE/CRIDGEforDevelopers/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    CRIDGE for Developers
  </span>
  

      </a>
    </li>
  

              
            
          </ul>
        </nav>
      
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/messagebus/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Message bus
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/osom/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    OSOM
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/oauth/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Authentication
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_6" >
          <label class="md-nav__link" for="__nav_9_6" id="__nav_9_6_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    APIs
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_6_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_9_6">
            <span class="md-nav__icon md-icon"></span>
            APIs
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/tmfapi/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    TMF API
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/nfvapi/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    NFV API
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/tmfweb/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    TMF WEB
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/nfvweb/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    NFV WEB
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/issuemgt/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Issue management
  </span>
  

      </a>
    </li>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../architecture/centrallog/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Central logging
  </span>
  

      </a>
    </li>
  

              
            
          </ul>
        </nav>
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_10" >
          <label class="md-nav__link" for="__nav_10" id="__nav_10_label" tabindex="0">
        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_10_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_10">
            <span class="md-nav__icon md-icon"></span>
          </label>
          <ul class="md-nav__list" data-md-scrollfix>
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../contributing/developing/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Developing
  </span>
  

      </a>
    </li>
  

              
            
          </ul>
        </nav>
      
    </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>
      
2944 2945 2946 2947 2948 2949 2950 2951 2952 2953 2954 2955 2956 2957 2958 2959 2960 2961 2962 2963 2964 2965 2966 2967 2968 2969 2970 2971 2972 2973 2974 2975 2976 2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989 2990 2991 2992 2993 2994 2995 2996 2997 2998 2999 3000 3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090 3091 3092 3093 3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 3131 3132 3133 3134 3135 3136 3137 3138 3139 3140 3141 3142 3143 3144 3145 3146 3147 3148 3149 3150 3151 3152 3153 3154 3155 3156 3157 3158 3159 3160 3161 3162 3163 3164 3165 3166 3167 3168 3169 3170 3171 3172 3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230 3231 3232 3233 3234 3235 3236 3237 3238 3239 3240 3241 3242 3243 3244 3245 3246 3247 3248 3249 3250
        <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>
        
      </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-backup-your-previous-database-if-necessary" class="md-nav__link">
    <span class="md-ellipsis">
      1. Backup your previous database if necessary:
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-install-docker" class="md-nav__link">
    <span class="md-ellipsis">
      2. Install docker
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-configure-containers-to-properly-resolve-the-dns-of-your-domain-optional" class="md-nav__link">
    <span class="md-ellipsis">
      3. Configure containers to properly resolve the DNS of your domain (optional)
    </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-deployment-script" class="md-nav__link">
    <span class="md-ellipsis">
      2. Download the deployment script
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-run-the-deployment-script" class="md-nav__link">
    <span class="md-ellipsis">
      3. Run the deployment script
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#configure-docker-compose-services" class="md-nav__link">
    <span class="md-ellipsis">
      Configure Docker Compose services
    </span>
  </a>
  
    <nav class="md-nav" aria-label="Configure Docker Compose services">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#1-create-configuration-specific-docker-compose-file-from-the-template" class="md-nav__link">
    <span class="md-ellipsis">
      1. Create configuration specific Docker Compose file from the template
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-configure-mysql-portal-container-optional" class="md-nav__link">
    <span class="md-ellipsis">
      2. Configure mysql-portal container (optional)
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-configure-keycloak-container-optional" class="md-nav__link">
    <span class="md-ellipsis">
      3. Configure keycloak container (optional)
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#4-configure-bugzilla-container-optional" class="md-nav__link">
    <span class="md-ellipsis">
      4. Configure bugzilla container (optional)
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#5-configure-osportalapi-container-nfv-services-conditional" class="md-nav__link">
    <span class="md-ellipsis">
      5. Configure osportalapi container (NFV services) (conditional)
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#6-osscapi-container-tmf-api-service-conditional" class="md-nav__link">
    <span class="md-ellipsis">
      6. osscapi container (TMF API service) (conditional)
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#configure-nginx" class="md-nav__link">
    <span class="md-ellipsis">
      Configure nginx
    </span>
  </a>
  
</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>
      
        <li class="md-nav__item">
  <a href="#deploy-openslice-via-docker-compose" class="md-nav__link">
    <span class="md-ellipsis">
      Deploy OpenSlice via Docker Compose
    </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>
  
</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-redirects" class="md-nav__link">
    <span class="md-ellipsis">
      1. Configure redirects
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#2-configure-email" class="md-nav__link">
    <span class="md-ellipsis">
      2. Configure email
    </span>
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#3-add-an-openslice-admin-user" class="md-nav__link">
    <span class="md-ellipsis">
      3. Add an OpenSlice admin user
    </span>
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
        
          <li class="md-nav__item">
  <a href="#keycloak-at-localhost" class="md-nav__link">
    <span class="md-ellipsis">
      Keycloak at localhost
    </span>
  </a>
  
</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-docker-compose">OpenSlice Deployment Guide with Docker Compose</h1>
<h2 id="intended-audience-openslice-administrators">Intended Audience: OpenSlice administrators</h2>
3267 3268 3269 3270 3271 3272 3273 3274 3275 3276 3277 3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296 3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 3312 3313 3314 3315 3316 3317 3318 3319 3320 3321 3322 3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405 3406 3407 3408 3409 3410 3411 3412 3413 3414 3415 3416 3417 3418 3419 3420 3421 3422 3423 3424 3425 3426 3427 3428 3429 3430 3431 3432 3433 3434 3435 3436 3437 3438 3439 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449 3450 3451 3452 3453 3454 3455 3456 3457 3458 3459 3460 3461 3462 3463 3464 3465 3466 3467 3468 3469 3470 3471 3472 3473 3474 3475 3476 3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487 3488 3489 3490 3491 3492 3493 3494 3495 3496 3497 3498 3499 3500 3501 3502 3503 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514 3515 3516 3517 3518 3519 3520 3521 3522 3523 3524 3525 3526 3527 3528 3529 3530 3531 3532 3533 3534 3535 3536 3537 3538 3539 3540 3541 3542 3543 3544 3545 3546 3547 3548 3549 3550 3551 3552 3553 3554 3555 3556 3557 3558 3559 3560 3561 3562 3563 3564 3565 3566 3567 3568 3569 3570 3571
<h2 id="requirements">Requirements</h2>
<h3 id="hardware-requirements">Hardware requirements:</h3>
<table>
<thead>
<tr>
<th><strong>Minimum Hardware Requirements</strong></th>
<th><strong>Recomended 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>Docker:</strong> A running environment for Docker Compose services</li>
</ul>
<h2 id="preparing-the-environment">Preparing the environment</h2>
<h3 id="1-backup-your-previous-database-if-necessary">1. Backup your previous database if necessary:</h3>
<pre><code class="language-bash">sudo docker exec amysql /usr/bin/mysqldump -u root --password=letmein ostmfdb &gt; backup_ostmfdb.sql
</code></pre>
<h3 id="2-install-docker">2. Install docker</h3>
<blockquote>
<p>Since July 2023 Docker Compose V1 stopped receiving updates. OpenSlice fully reverted to Compose V2, which is integrated in the Docker installation.</p>
</blockquote>
<h3 id="3-configure-containers-to-properly-resolve-the-dns-of-your-domain-optional">3. Configure containers to properly resolve the DNS of your domain (optional)</h3>
<pre><code>sudo nano /etc/docker/daemon.json
</code></pre>
<p>and add:</p>
<pre><code>{ 
  &quot;dns&quot;: [&quot;8.8.8.8&quot;, &quot;8.8.4.4&quot;]
}
</code></pre>
<p>After editing daemon.json restart docker daemon for the changes to take place</p>
<pre><code class="language-bash">sudo systemctl restart docker
</code></pre>
<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
</code></pre>
<pre><code class="language-bash">cd openslice
</code></pre>
<h3 id="2-download-the-deployment-script">2. Download the deployment script</h3>
<p>Download the deployment / environment preparation script</p>
<pre><code class="language-bash">wget https://labs.etsi.org/rep/osl/code/org.etsi.osl.main/-/raw/develop/compose/deploy.sh
</code></pre>
<p>Make it executable</p>
<pre><code class="language-bash">sudo chmod +x deploy.sh
</code></pre>
<h3 id="3-run-the-deployment-script">3. Run the deployment script</h3>
<p>OpenSlice is a multi repo project. This script selects the same branch for all repositories of the project to pull from.</p>
<p>After that it builds the respective jar files locally and installs all the npm packages needed for the UI.</p>
<p>If you run the script without selecting a branch the the main branch is going to be selected.</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>
<pre><code class="language-bash">sudo ./deploy.sh develop #[or replace main with other branch name]
</code></pre>
<blockquote>
<p><strong>We recommend running the deploy.sh script with root permissions! In other case, some directories may not be accessible by the project building tools and hinder the smooth installation.</strong></p>
</blockquote>
<h2 id="configure-docker-compose-services">Configure Docker Compose services</h2>
<h3 id="1-create-configuration-specific-docker-compose-file-from-the-template">1. Create configuration specific Docker Compose file from the template</h3>
<pre><code class="language-bash">cd org.etsi.osl.main/compose/
</code></pre>
<pre><code class="language-bash">sudo cp docker-compose.yaml.configure docker-compose.yaml
</code></pre>
<h3 id="2-configure-mysql-portal-container-optional">2. Configure mysql-portal container <em>(optional)</em></h3>
<ol>
<li>In folder <code>org.etsi.osl.main/compose/mysql-init</code> edit the file <code>01-databases.sql</code>.</li>
<li>In the <code>org.etsi.osl.main/compose/docker-compose.yaml</code> edit the credentials of the users that services use to connect to the databases, if you wish.<ul>
<li>portaluser (default is 12345) and</li>
<li>keycloak (default is password)</li>
</ul>
</li>
</ol>
<h3 id="3-configure-keycloak-container-optional">3. Configure keycloak container <em>(optional)</em></h3>
<ol>
<li>
<p>If you made changes to keycloak's mysql credentials:</p>
<p>In folder <code>org.etsi.osl.main/compose/</code> edit the file <code>docker-compose.yaml</code>.</p>
</li>
</ol>
<pre><code>DB_DATABASE: keycloak
DB_USER: keycloak
DB_PASSWORD: password
</code></pre>
<ol>
<li>
<p>If you want to change the keycloak admin password:</p>
<p>In folder <code>org.etsi.osl.main/compose/</code> edit the file <code>docker-compose.yaml</code></p>
</li>
</ol>
<pre><code>KEYCLOAK_PASSWORD: Pa55w0rd
</code></pre>
<h3 id="4-configure-bugzilla-container-optional">4. Configure bugzilla container <em>(optional)</em></h3>
<p>If you want to utilise the Bugzilla connector:</p>
<p>In folder <code>org.etsi.osl.main/compose/</code> edit the file <code>docker-compose.yaml</code></p>
<pre><code>SPRING_APPLICATION_JSON: '{
  &quot;spring.activemq.brokerUrl&quot;: &quot;tcp://anartemis:61616?jms.watchTopicAdvisories=false&quot;,
  &quot;spring.activemq.user&quot;: &quot;artemis&quot;,
  &quot;spring.activemq.password&quot;: &quot;artemis&quot;,
  &quot;bugzillaurl&quot;:&quot;&quot;,
  &quot;bugzillakey&quot;:&quot;&quot;,
  &quot;main_operations_product&quot;:&quot;&quot;
}'
</code></pre>
<p>And add the provided Bugzilla installation information:</p>
<pre><code>&quot;bugzillaurl&quot;:&quot;bugzillaurl.xx:443/bugzilla/&quot;,
&quot;bugzillakey&quot;:&quot;exampleKeyeqNNwxBlgxZgMEIne0Oeq0Bz&quot;,
&quot;main_operations_product&quot;:&quot;Main Site Operations&quot; // this is the default product to issue tickets
</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>
<h3 id="5-configure-osportalapi-container-nfv-services-conditional">5. Configure osportalapi container (NFV services) <em>(conditional)</em></h3>
<p>Change the respective fields: </p>
<ul>
<li>If you made changes to mysql and keycloak credentials.</li>
<li>If you want to change logging level (TRACE / DEBUG / INFO / WARN / ERROR).</li>
</ul>
<blockquote>
<p><strong><em>If you are using a non-local domain, replace everywhere the http://keycloak:8080 with the respective {{protocol://domain.name}}, as well as "spring.portal.main.domain" property.</em></strong></p>
</blockquote>
<p>In folder <code>org.etsi.osl.main/compose/</code> edit the file <code>docker-compose.yaml</code></p>
<pre><code>SPRING_APPLICATION_JSON: '{
  &quot;spring.datasource.username&quot;:&quot;root&quot;,
  &quot;spring.datasource.password&quot;:&quot;letmein&quot;,
  &quot;spring-addons.issuers[0].uri&quot;: &quot;http://keycloak:8080/auth/realms/openslice&quot;,
  &quot;spring.security.oauth2.resourceserver.jwt.issuer-uri&quot;: &quot;http://keycloak:8080/auth/realms/openslice&quot;,
  &quot;springdoc.oAuthFlow.authorizationUrl&quot;: &quot;http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/auth&quot;,
  &quot;springdoc.oAuthFlow.tokenUrl&quot;: &quot;http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/token&quot;,  
  &quot;spring.portal.main.domain&quot;: &quot;http://localhost&quot;,
  &quot;logging.level.org.springframework&quot; : &quot;INFO&quot;
}'
</code></pre>
<h3 id="6-osscapi-container-tmf-api-service-conditional">6. osscapi container (TMF API service) <em>(conditional)</em></h3>
<p>Change the respective fields: </p>
<ul>
<li>If you made changes to mysql and keycloak credentials.</li>
<li>If you want to change logging level (TRACE / DEBUG / INFO / WARN / ERROR).</li>
</ul>
<blockquote>
<p><strong>If you are using a non-local domain, replace everywhere the http://keycloak:8080 with the respective {{protocol://domain.name}}.</strong></p>
</blockquote>
<p>In folder <code>org.etsi.osl.main/compose/</code> edit the file <code>docker-compose.yaml</code></p>
<pre><code>SPRING_APPLICATION_JSON: '{
  &quot;spring.datasource.username&quot;:&quot;root&quot;,
  &quot;spring.datasource.password&quot;:&quot;letmein&quot;,
  &quot;spring-addons.issuers[0].uri&quot;: &quot;http://keycloak:8080/auth/realms/openslice&quot;,
  &quot;spring.security.oauth2.resourceserver.jwt.issuer-uri&quot;: &quot;http://keycloak:8080/auth/realms/openslice&quot;,
  &quot;springdoc.oAuthFlow.authorizationUrl&quot;: &quot;http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/auth&quot;,
  &quot;springdoc.oAuthFlow.tokenUrl&quot;: &quot;http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/token&quot;,  
  &quot;logging.level.org.springframework&quot; : &quot;INFO&quot;
}'
</code></pre>
<h2 id="configure-nginx">Configure nginx</h2>
<p>In folder <code>org.etsi.osl.main/compose/nginx</code> create a configuration specific <code>nginx.conf</code> file.</p>
<pre><code class="language-bash">cd org.etsi.osl.main/compose/nginx/
</code></pre>
<pre><code class="language-bash">sudo cp nginx.conf.default nginx.conf
</code></pre>
<p>If needed, in the nginx.conf file, edit the server_name for an non-local deployment.</p>
<h2 id="configure-web-ui">Configure Web UI</h2>
<p>In folder <code>org.etsi.osl.portal.web/src/js/</code> create a configuration specific <code>config.js</code> file.</p>
<pre><code class="language-bash">cd org.etsi.osl.portal.web/src/js
</code></pre>
<pre><code class="language-bash">sudo cp config.js.default config.js
</code></pre>
<p>Edit the <code>config.js</code> file with the information of your domain. <code>ROOTURL</code> will automatically extract the the Origin (Protocol://Domain:Port) of the deployment, but you must change <code>APIURL</code> property, if you are not aiming for a localhost installation, e.g. "https://portal.openslice.io".</p>
<p>Example file:</p>
<pre><code>{     
  BUGZILLA: &quot;ROOTURL/bugzilla/&quot;,
  STATUS: &quot;ROOTURL/status/&quot;,
  APIURL: &quot;http://localhost&quot;,
  WEBURL: &quot;ROOTURL/nfvportal&quot;,
  APIOAUTHURL: &quot;ROOTURL/auth/realms/openslice&quot;,
  APITMFURL: &quot;ROOTURL/tmf-api/serviceCatalogManagement/v4&quot;
}
</code></pre>
<h2 id="configure-tmf-web-ui">Configure TMF Web UI</h2>
<p>In the folder <code>org.etsi.osl.tmf.web/src/assets/config</code> there are 3 files available for configuration:</p>
<ul>
<li>config.prod.json (Basic information + API configuration)</li>
<li>theming.scss (CSS color palette theming)</li>
<li>config.theming.json (HTML configuration - Logo, Favicon, Footer)</li>
</ul>
<p>The first 2 files above (i.e. config.prod.json, theming.scss) are essential for the successful deployment of OpenSlice, thus created automatically during the initial deployment at <code>org.etsi.osl.tmf.web/src/assets/config</code> directory as a copy of the default ones from the remote repository.</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 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>
<p>Example file:</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
Loading
Loading full blame...