index.html

  
  
  
  
    <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="#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>
      
        <li class="md-nav__item">
  <a href="#kubernetes-installation" class="md-nav__link">
    <span class="md-ellipsis">
      Kubernetes installation
    </span>
  </a>
  
</li>
      
    </ul>
  
</nav>
                  </div>
                </div>
              </div>
            
          
          
            <div class="md-content" data-md-component="content">
              <article class="md-content__inner md-typeset">
                
                  


  <h1>Deployment/Installation</h1>

<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>20 GB storage</td>
<td>40 GB storage</td>
</tr>
</tbody>
</table>
<h3 id="software-requirements">Software Requirements:</h3>
<ul>
<li>Docker (Docker Compose installation)</li>
<li>Kubernetes (Kubernetes installation - experimental)</li>
</ul>
<h2 id="preparing-the-environment">Preparing the environment</h2>
<blockquote>
<p>See the <a href="#Kubernetes-installation">Kubernetes section</a>, if you would like to deploy OpenSlice in a Kubernetes cluster.</p>
</blockquote>
<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</p>
<pre><code>{     
  TITLE: &quot;OpenSlice by ETSI&quot;,
  WIKI: &quot;https://openslice.readthedocs.io/en/stable/&quot;,
  BUGZILLA: &quot;ROOTURL/bugzilla/&quot;,
  STATUS: &quot;ROOTURL/status/&quot;,
  APIURL: &quot;http://localost:13000&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> file 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>
<pre><code class="language-bash">sudo cp config.theming.default.json config.theming.json
</code></pre>
<p>E.g. Edit "TITLE" or "WIKI" property with your domain title</p>
<pre><code>{     
  TITLE: &quot;OpenSlice by ETSI&quot;,
  WIKI: &quot;https://osl.etsi.org/documentation/latest/deployment/&quot;,
}
</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 config.theming.json needs to be created in io.openslice.tmf.web/src/assets/config directory, as follows:</p>
<pre><code class="language-bash"># Starting from the root project directory
cd 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>
<blockquote>
<p><strong><em>IMPORTANT NOTE:</em></strong>
If you want to apply changes to the JSON configuration files without the need to rebuild the application, you have to apply the changes at the <code>org.etsi.osl.tmf.web/dist/io-openslice-portal-web/assets/config</code> directory. Although, it is <u>mandatory</u> to also apply these changes to the <code>org.etsi.osl.tmf.web/src/assets/config</code> for <u>persistancy</u>, as after any future rebuild of OpenSlice the <code>/dist</code> directory is being overwritten along with its contents. The OpenSlice team strongly recommends to always apply your changes to the TMF web UI configuration files at <code>org.etsi.osl.tmf.web/src/assets/config</code> and rebuild the application.</p>
</blockquote>
<h2 id="deploy-openslice-via-docker-compose">Deploy OpenSlice via Docker Compose</h2>
<p>After configuring the services, and editing the docker compose file accordingly, the docker compose instantiation command can be performed.</p>
<pre><code class="language-bash"># Starting from the root project directory
cd org.etsi.osl.main/compose/
</code></pre>
<pre><code class="language-bash">sudo docker compose --profile prod down;sudo docker compose --profile prod up -d --build
</code></pre>
<blockquote>
<p>Depending on your machine, this process might take time. if for any reason the deployment fails during first time, please rerun the above before any further measures.</p>
</blockquote>
<h2 id="validating-deployments-and-container-monitoring">Validating deployments and container monitoring</h2>
<p>You can monitor containers' status with portainer at port 9000 (http://your-ip:9000).</p>
<p>Initially, you may monitor the local machine at portainer.</p>
<p>Please check that all containers are in running state.</p>
<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 nginx under http://localhost/auth. </p>
<ul>
<li>
<p>Navigate to http://domain.com/auth/ or https://domain.com/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-configure-keycloak-container-optional">Configure keycloak container</a>. Default values are:</p>
<ul>
<li>user: admin and </li>
<li>password: KEYCLOAK_PASSWORD</li>
</ul>
</li>
</ul>
<blockquote>
<p>if you are running in HTTP you will 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-redirects">1. Configure redirects</h4>
<p>Navigate to realm Openslice &gt; client &gt; osapiWebClientId and change the Root URL to your domain. </p>
<p>Also, insert your domain, e.g. http://example.org/*, at:
* Valid Redirect URIs
* Web Origins</p>
<h4 id="2-configure-email">2. 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>On Tab Login &gt; check User registration, Verify email, Forgot password etc.</p>
<p>Also, enter the details on Realm &gt; Email &gt; Enable Authentication.</p>
<h4 id="3-add-an-openslice-admin-user">3. 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 manage/users and add an OpenSlice admin user, e.g. username=admin. 
- Set a password
- Navigate to Role Mappings and add ADMIN and MENTOR to Assigned Roles.</p>
<blockquote>
<p>That user is different from the Keycloak admin user. It is required to login and browse the OpenSlice Web UI. The Roles ADMIN and MENTOR guarantee full access through the Openslice UI, thus such a user is always required.</p>
</blockquote>
<h3 id="keycloak-at-localhost">Keycloak at localhost</h3>
<blockquote>
<p><strong>This is an important step if you run Keycloak on localhost!</strong></p>
</blockquote>
<p>1 - Edit your Hosts File, adding the line below</p>
<p><code>127.0.0.1 keycloak</code></p>
<p>Hosts File Location:</p>
<ul>
<li>
<p>In Linux/Unix, the file's location is at /etc/hosts </p>
</li>
<li>
<p>In Windows, its location is at c:\Windows\System32\Drivers\etc\hosts</p>
</li>
</ul>
<p>2 - Replace http://localhost/auth/ with http://keycloak:8080/auth/ in your Keycloak config for AngularJS and Angular (see examples below).</p>
<blockquote>
<p>Explanation</p>
</blockquote>
<p>Nginx uses the http://keycloak:8080 URL, which is accessible via the internal docker system's network.
The Front-end (TS/Angular) shall also use the http://keycloak:8080.
This way, you will not get the invalid token error, as the API is acquiring the token from http://keycloak:8080 (internally) and the Front-end is getting verified by an issuer at the same URL, as well.</p>
<p>2.1 - For the Angular configuration (TMF portal UI), navigate to  org.etsi.osl.tmf.web/src/assets/config and edit config.prod.json</p>
<pre><code class="language-bash"># Starting from the root project directory
cd org.etsi.osl.tmf.web/src/assets/config
</code></pre>
<pre><code class="language-bash">nano config.prod.json
</code></pre>
<p>After editing it should look like the example bellow:</p>
<pre><code class="language-yaml">{         
  &quot;TITLE&quot;: &quot;OpenSlice by ETSI&quot;,
  &quot;PORTALVERSION&quot;:&quot;2023-Q3 1.2.0-SNAPSHOT&quot;,
  &quot;WIKI&quot;: &quot;https://openslice.readthedocs.io/en/stable/&quot;,
  &quot;BUGZILLA&quot;: &quot;{BASEURL}/bugzilla/&quot;,
  &quot;STATUS&quot;: &quot;http://status.localhost/&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;http://keycloak:8080/auth/realms/openslice&quot;,
      &quot;loginUrl&quot;: &quot;http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/auth&quot;,
      &quot;tokenEndpoint&quot;: &quot;http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/token&quot;,
      &quot;userinfoEndpoint&quot;: &quot;http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/userinfo&quot;,
      &quot;redirectUri&quot;: &quot;{BASEURL}/redirect&quot;,
      &quot;logoutUrl&quot;: &quot;http://keycloak:8080/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,
        clearHashAfterLogin&quot;: false,

      &quot;showDebugInformation&quot;: true
  }
}
</code></pre>
<blockquote>
<p>Note the difference in changing {BASEURL} -&gt; http://keycloak:8080</p>
<p>If you want the changes to take place immediately without rebuilding the project, then repeat the process for org.etsi.osl.tmf.web/dist/org.etsi.osl.tmf.web/assets/config/config.prod.json</p>
</blockquote>
<p>2.2 - For the AngularJS configuration (NVF portal UI), navigate to org.etsi.osl.portal.web/src/js and edit config.js</p>
<pre><code class="language-bash"># Starting from the root project directory
cd org.etsi.osl.portal.web/src/js
</code></pre>
<pre><code class="language-bash">nano config.js
</code></pre>
<p>after editing it should look like the example bellow:</p>
<pre><code>var appConfig = angular.module('portalwebapp.config',[]);


appConfig.factory('APIEndPointService', function() {
   return {       
      TITLE: &quot;OpenSlice by ETSI&quot;,
      WIKI: &quot;https://openslice.readthedocs.io/en/stable/&quot;,
      BUGZILLA: &quot;ROOTURL/bugzilla/&quot;,
      STATUS: &quot;ROOTURL/status/&quot;,
      APIURL: &quot;http://localost:13000&quot;,
      WEBURL: &quot;ROOTURL/nfvportal&quot;,
      APIOAUTHURL: &quot;ROOTURL/auth/realms/openslice&quot;,
      APITMFURL: &quot;ROOTURL/tmf-api/serviceCatalogManagement/v4&quot;
   };
});
</code></pre>
<blockquote>
<p>Note the difference in "APIOAUTHURL" property</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>
<p><br></p>
<h2 id="kubernetes-installation">Kubernetes installation</h2>
<p>Openslice can be installed in a Kubernetes cluster. </p>
<p>The related scripts are inside the kubernetes folder. Follow these steps along the lines. You need to configure the ingress properly depending on how you want to expose Openslice. </p>
<p>1 - Create an openslice namespace</p>
<pre><code class="language-bash">kubectl create namespace openslice
</code></pre>
<p>2 - Apply or create an ingress. 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.
You may need to deploy an Ingress controller such as ingress-nginx.</p>
<p>You can also adapt it to connect to public cloud load balancers depending on your needs.</p>
<p>The following will expose an ingress resource from one of your a k8s nodes on port 80.</p>
<pre><code class="language-bash"> kubectl apply -f openslice-ingress.yaml
</code></pre>
<p>Finding the ingress IP:</p>
<pre><code class="language-bash">
kubectl describe -f openslice-ingress.yaml


Name:             openslice-ingress
Namespace:        openslice
Address:          10.10.10.35
Default backend:  default-http-backend:80 (&lt;error: endpoints &quot;default-http-backend&quot; not found&gt;)
Rules:
  Host        Path  Backends
  ----        ----  --------
  *
              /services   tmfweb:80 (&lt;error: endpoints &quot;tmfweb&quot; not found&gt;)
              /tmf-api    osscapi:13082 (&lt;error: endpoints &quot;osscapi&quot; not found&gt;)
              /auth       keycloak:8080 (&lt;error: endpoints &quot;keycloak&quot; not found&gt;)
              /osapi      osportalapi:13000 (&lt;error: endpoints &quot;osportalapi&quot; not found&gt;)
              /           portalweb:80 (&lt;error: endpoints &quot;portalweb&quot; not found&gt;)
Annotations:  kubernetes.io/ingress.class: nginx
Events:
  Type    Reason  Age                    From                      Message
  ----    ------  ----                   ----                      -------
  Normal  Sync    9m29s (x2 over 9m58s)  nginx-ingress-controller  Scheduled for sync

</code></pre>
<p>From the above example, our exposed ingress is at Address: 10.10.10.35</p>
<p>3 - We need to configure the expose address and deploy openslice (IP or URL e.g. http://myopenslice.xxx)</p>
<pre><code class="language-bash">./k8sdeploy.sh 10.10.10.35
</code></pre>
<p>4 - Check the status of Openslice  in the cluster. Should be similar to the following:</p>
<pre><code class="language-bash">
kubectl get pods --namespace=openslice  -o wide

NAME                               READY   STATUS    RESTARTS   AGE    IP               NODE     NOMINATED NODE   READINESS GATES
activemq-59d4bfdb4b-bvjqr          1/1     Running   0          109s   192.168.43.97    kc-2     &lt;none&gt;           &lt;none&gt;
bugzilla-client-7dd7cb47cb-8qb8m   1/1     Running   0          100s   192.168.12.114   kc-3     &lt;none&gt;           &lt;none&gt;
centrallog-95bbf7867-k8fpt         1/1     Running   0          100s   192.168.12.107   kc-3     &lt;none&gt;           &lt;none&gt;
consul-b5dd76b76-64dzk             1/1     Running   0          107s   192.168.43.90    kc-2     &lt;none&gt;           &lt;none&gt;
keycloak-7c5b6bbc95-k2qfl          1/1     Running   0          105s   192.168.12.106   kc-3     &lt;none&gt;           &lt;none&gt;
manoclient-95f68f4c9-c9t6r         1/1     Running   0          104s   192.168.12.113   kc-3     &lt;none&gt;           &lt;none&gt;
mysql-portal-0                     1/1     Running   0          107s   192.168.43.99    kc-2     &lt;none&gt;           &lt;none&gt;
osom-6d548cf555-q8ptj              1/1     Running   0          104s   192.168.43.93    kc-2     &lt;none&gt;           &lt;none&gt;
osportalapi-5fff744db8-5g4zs       1/1     Running   0          103s   192.168.43.98    kc-2     &lt;none&gt;           &lt;none&gt;
osscapi-6d68b54d97-jn8tz           0/1     Running   0          102s   192.168.12.104   kc-3     &lt;none&gt;           &lt;none&gt;
portalweb-8469d57df4-94tfj         1/1     Running   0          101s   192.168.48.44    kc-nfs   &lt;none&gt;           &lt;none&gt;
tmfweb-868f7bb9c5-x4lfh            1/1     Running   0          102s   192.168.48.43    kc-nfs   &lt;none&gt;           &lt;none&gt;
</code></pre>
<pre><code class="language-bash">kubectl get deployments  --namespace=openslice  -o wide

NAME              READY   UP-TO-DATE   AVAILABLE   AGE     CONTAINERS            IMAGES                                      SELECTOR
activemq          1/1     1            1           2m15s   anactivemq            webcenter/activemq:5.14.3                   org.etsi.osl.service=activemq
bugzilla-client   1/1     1            1           2m6s    bugzilla-client       openslice/org.etsi.osl.bugzilla:latest      org.etsi.osl.service=bugzilla-client
centrallog        1/1     1            1           2m6s    centrallog            openslice/org.etsi.osl.centrallog.service   org.etsi.osl.service=centrallog
consul            1/1     1            1           2m13s   aconsul               consul                                      org.etsi.osl.service=consul
keycloak          1/1     1            1           2m11s   keycloak              quay.io/keycloak/keycloak:11.0.3            org.etsi.osl.service=keycloak
manoclient        1/1     1            1           2m10s   manoclient            openslice/org.etsi.osl.mano:latest          org.etsi.osl.service=manoclient
osom              1/1     1            1           2m10s   openslice-osom        openslice/org.etsi.osl.osom:latest          org.etsi.osl.service=osom
osportalapi       1/1     1            1           2m9s    openslice-portalapi   openslice/org.etsi.osl.portal.api:latest    org.etsi.osl.service=osportalapi
osscapi           1/1     1            1           2m8s    openslice-scapi       openslice/org.etsi.osl.tmf.api:latest       org.etsi.osl.service=osscapi
portalweb         1/1     1            1           2m7s    openslice-portalweb   openslice/org.etsi.osl.portal.web:latest    org.etsi.osl.service=portalweb
tmfweb            1/1     1            1           2m8s    openslice-tmfweb      openslice/org.etsi.osl.tmf.web:latest       org.etsi.osl.service=tmfweb
</code></pre>