Prerequisites

The following steps should already have been done before you install the OSLC Connector for Codebeamer:

1. Make sure that all necessary proxies are configured to allow the communication from the OSLC Connector to the Codebeamer instance

Prepare the Deployment

Add library Repository for the OSLC Connector for Codebeamer

You will need a username and password to download the helm chart and containers from MID's repository. You will receive username and password from your MID contact or from cops@mid.de.

sudo helm repo add library https://repo.secure.mid.de/chartrepo/library --username <USERNAME> --password <PASSWORD>

sudo helm repo update

Customize Values File

• Change to your user's home directory on the server and create a new text file values-genoslc-codebeamer.yaml with the following content:

  global:
    domain: "<your-domain>"
    instance: "genoslc v2"
    registry: "repo.mid.de"
    repologin: "<login provided by MID>"
    cert:
      # this is a letsencrypt certificate for genoslc-cb-mercedes.gopoc.dev.smartfacts.com, since the Codebeamer instance is not in our VPN
      crtFullChain: "<FULL-CHAIN-CERT-BASE64>"
      key: "<CERT-KEY-BASE64>"
    ingress:
      enabled: true
      # if you use nginx as ingress controller please uncomment in this line:
      #ingressClassType: "nginx"
    oidc:
      clientId: "<OIDC client ID>"
      clientSecret: "<OIDC client secret>"
    hosts:
      genoslc:
        subdomain: "<subdomain where the application is accessible>"
    secrets:
      oauth2:
        wellknown: "</.well-known/openid-configuration URL>"
    identity:
      OIDC_ISSUER: "<OIDC issuer URL>"
  
  env:
    allowedCorsOrigins: "<URLs of apps that can make REST requests to the OSLC Connector"
    globalConfigurationProvider: "<URL of the Global Configuration provider>" # e.g. https://ibm-elm:9443/gc
    linkValidityProvider: "<URL of the Link Validity provider>" # e.g. https://ibm-elm:9443/jts
    authorizationUri: "<OIDC authorization URL"
    tokenUri: "<OIDC token URL>"
    userInfoUri: "<OIDC user info URL>"
    tool:
      type: "codebeamer"
      adaptedToolApiUri: "<URL of the Codebeamer instance>"
      adaptedToolRootUri: "<URL of the Codebeamer API>" # usually the same as the adaptedToolApiUri
      adaptedToolTechnicalUserAuthorizationHeader: "Basic <base64 encoded credentials>"
    oauth10a: #oauth10a configuration
      in:
        inboundRealmName: "genoslc-mb-codebeamer"
        inboundName: "cb-inbound"
        inboundConsumerKey: "<known incoming consumer key>"
        inboundConsumerSecret: "<known incoming consumer secret>"
      out:
        outboundProtectedRoots: "<base URL of oauth10a protected application>" # e.g. base URL of the IBM Jazz instance
        outboundRootservices: "<rootservices URL of the application" # e.g. https://ibm-elm:9443/jts/rootservices
        outboundName: "ibm-elm-outbound"
        outboundConsumerKey: "<already configured consumer key>"
        outboundConsumerSecret: "<already configured consumer secret>"
  mongodb:
    enabled: true
  certtool:
    enabled: true

• Replace the value of the domain property with your domain name.

• Replace the value of the repologin property with the value provided from MID.

• I you are using a nginx as the ingress controller, comment in the “ingressClassType” property.

• Replace the placeholder “<URL of the Codebeamer instance>“ in adaptedToolApiUri, adaptedToolRootUri with the URL of your Codebeamer instance.

• Save the values-genoslc-codebeamer.yaml file.

Install the OSLC Connector for Codebeamer

Execute the Installation

Enter the following command to execute the Installation:

sudo helm upgrade --install genoslc-codebeamer library/genoslc -f values-genoslc-codebeamer.yaml --version 2.1.10-genoslcv2 -n genoslc-codebeamer --create-namespace