Versions Compared

Key

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

Step 1 - PSKnowHOW System Requirements

...

Step 2 - Release Notes

Please read the release notes before starting the upgrade.

...

Replace "/location/PSKnowhow" with your preferred location. This command will create the "PSKnowhow" folder in the specified location. Make sure to choose a directory path that you have appropriate permissions to create folders in and have available space and is permanent storage.

Step 4 - Download PSKnowHOW docker-compose.yaml

Step 4.b - Download auth service docker-compose.yaml file

Step 5 - Edit the docker compose file with appropriate values

  • Update Credentials of DB and other Environmental variable as specified hereDocker Environmental variables

  • Create readWrite Privileged user which adds extra layer of data protection from accidentally deleting collections and use this in application . follow this steps to create

    Code Block
    docker exec -it mongodb /bin/bash
    mongo admin -u ${MONGO_INITDB_ROOT_USERNAME} -p ${MONGO_INITDB_ROOT_PASSWORD}
    use kpidashboard
    db.createUser({user: '${MONGODB<MONGODB_APPLICATION_USER}USER>', pwd: '${MONGODB<MONGODB_APPLICATION_PASS}PASS>', roles:[{role:'readWrite', db:'kpidashboard'}]})
    exit
  • To begin with PSKnowhow, it is essential to have three mandatory containers: i) UI, ii) CustomAPI, and iii) MongoDB. Additionally, there are other optional containers, such as jira-processor, devops-processor (including Jenkins, GitHub, GitLab, Bamboo, Bitbucket, Zephyr, Sonar, and TeamCity collectors), azure-board-processor (for Azure Board), and azure-pipeline-repo (for Azure Pipeline and Azure Repo).
    Based on specific requirements, you can bring up these respective containers as needed.

Step 6 - Pull the PSKnowHOW docker images and Run the Containers

  • Open terminal/command prompt in PSKnowhow folder .

  • Pull the images by

    Code Block
    docker-compose pull
  • Run the container by

  • Code Block
    docker-compose up -d

Step 7 - Run the Auth service docker container

  • Now pull the Docker image by running:

    Code Block
    docker-compose pull
  • After successfully pulling the Docker image, run the container by executing:

    Code Block
    docker-compose up -d
  • Now connect the Knowhow container with auth containers

    Code Block
    docker network connect <auth container network> <knowhow ui container name>
  • Your auth application will now be running and can be accessed from a browser using the DNS.

Step 8 - Run DB Backup Script

  • Download the dbbackup.sh shell script to the server in /var/knh location.

...