Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • <Server-FQDN>

  • smartfacts.<Server-FQDN>

  • camp.<Server-FQDN>

  • identity.<Server-FQDN>

  • oslcgenoslc.<Server-FQDN>

  • genoslc-jama.<Server-FQDN> (if you connect to Jama using OSLC)

  • genoslc-codebeamer.<Server-FQDN> (if you connect to Codebeamer using OSLC)

Create an X.509 Certificate

Create the certificates according to the instructions on Creating and testing the Certificates for Smartfacts.

Get credentials and Smartfacts license

Please contact cops@mid.de. We will send you credentials for accessing our container & chart registry and the license according to your order.

Install Smartfacts

Customize Values File

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

Code Block
global:
  domain: "<your-domain>"
  instance: "smartfacts"
  registry: "repo.mid.de"
  repologin: <login provided by MID>
  cert:
    crtFullChain: "<FULL-CHAIN-CERT-BASE64>"
    key: "<CERT-KEY-BASE64>"
  ingress:
    enabled: true
    # if you use nginx as ingress controller please comment in this line:
    #ingressClassType: "nginx" 
  env:
    genoslc:
      tool:
        type: "" # insert "CB" for Codebeamer or "JA" for Jama
        url: ""
keycloak:
  openldap:
    enabled: false
mailservice:
  enabled: true
  filterEnabled: "false"
  serviceType: "smtp"   # Replace with aws if AWS email service is used
  sender: "noreply@yourdomain"
  smtp:
    host: ""
    port: "25"
    startTLS: true
    SSLOnConnect: false
    username: ""
    password: ""
  aws:
    region: "AWS-Region"
    key: "AWS-Key"
    secret: "AWS-Secret"
  • Replace the value of the domain property with your domain name.

  • Replace the placeholder of the crtFullChain property with the content of the file chain.crt.base64.

  • Replace the placeholder of the key property with the content of the key.base64 file.

  • Fill out the mailservice variables to your needs

  • Save the values.yaml file.

Install Smartfacts

Execute the Installation

Enter the following command to execute the Installation:

Code Block
sudo helm upgrade --install --timeout 20m0s smartfacts mid-smartfacts/smartfacts -f values.yaml -n smartfacts --create-namespace

Watch Deployment (in a new Session)

Open a second session on the server and enter the following command:

Code Block
sudo watch kubectl get deployments -n smartfacts

As soon as all deployments are available, the installation is ready.

Setting-Up the CAMP (Customer Accounts for MID Products)

This section is used to add the users who will be authorized to use the instance and to assign the licenses. When you open https://camp.<yoursmartfactsdomain>, and log in with your credentials, you will be taken to this page:

...

  1. In section 1, upload the license file MID has provided in step 4 by clicking the  upload button in the upper right-hand corner and by selecting the license file.

  2. In section 2, set an account name.

  3. In section 3, synchronize the users from OpenLDAP to CAMP by clicking UPDATE USERS AND GROUPS.

  4. Assign licenses to users and groups in the CAMP.

    Check all users and/or groups that should have a license and assign licenses by clicking ASSIGN LICENSES.

The creation of the account is now complete and licenses are assigned to the users.

Create a Smartfacts Model Warehouse

  1. Open the Smartfacts URL in your browser: https://smartfacts.<yoursmartfactsdomain> and log-in with the account manager credentials (user “acm”, password “acm”).

  2. You will now be asked to create a Model Warehouse.

    1. Click on CREATE A NEW MODEL WAREHOUSE.

    2. In the create dialog, first select the previously created account.

    3. Provide a name for the Model Warehouse.

    4. Optionally, activate the check box Create Demo Models if you want some demo content to be added to the Model Warehouse.

Model Warehouse creation is the final step in the Smartfacts platform set-up process.