index.html

            
              
                
  
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4" >
        
          
          <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_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="2" aria-labelledby="__nav_2_4_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_2_4">
            <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_inventory/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Service Inventory
  </span>
  

      </a>
    </li>
  

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

              
            
              
                
  
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_5" >
        
          
          <label class="md-nav__link" for="__nav_2_5" id="__nav_2_5_label" tabindex="0">
            
  
  <span class="md-ellipsis">
    OpenSlice management
  </span>
  

            <span class="md-nav__icon md-icon"></span>
          </label>
        
        <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_5_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_2_5">
            <span class="md-nav__icon md-icon"></span>
            OpenSlice management
          </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>
  

              
            
              
                
  
  
  
  
    <li class="md-nav__item">
      <a href="../alarms_actions/" class="md-nav__link">
        
  
  <span class="md-ellipsis">
    Alarms and Actions
  </span>
  

      </a>
    </li>
  

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

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

      </a>
    </li>
  

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

    
      
      
  
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <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">
            
  
  <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_3_label" aria-expanded="false">
          <label class="md-nav__title" for="__nav_3">
            <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">
      <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>
  

              
            
              
                
  
  
  
  
    <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>
      
    </li>
  

    
      
      
  
  
  
  
    
    
    
    
    <li class="md-nav__item md-nav__item--nested">
      
        
        
        <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-ellipsis">
    Contributing
  </span>
  

            <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>
            Contributing
          </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>
      
        <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>
<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;,