Installing Link

Open a terminal and navigate to the directory where the lnk-product chart was extracted.

Install the Link using the following commands:

helm install lnk-prod lnk-product \
  --set hclImagePullSecret="lnk-hclcr-secret" \
  --set global.storageClass=efs-sc \
  --set mongodb.persistence.existingClaim=link-mongodb-pvc \
  --set mongodb.containerSecurityContext.runAsUser=1000 \
  --set redis.master.persistence.path=/bitnami/redis \
  --set redis.master.persistence.existingClaim=link-redis-pvc \
  --set server.persistence.files.existingClaim=link-files-pvc \
  --set server.persistence.data.existingClaim=link-data-pvc \
  --set server.probes.readiness.enabled=true \
  --set server.probes.readiness.initialDelaySeconds=120 \
  --set server.probes.readiness.periodSeconds=60 \
  --set server.probes.liveness.enabled=false \
  --set rest.persistence.data.existingClaim=link-data-pvc

This installs a release named lnk-prod using the lnk-product Helm chart.

The --set parameters override default values in values.yaml.

Note: The server readiness probe's initialDelaySeconds and periodSeconds values have been increased from their defaults. This adjustment provides the server container/pod sufficient time to complete initialization, resolving an issue where the pod would continuously restart and fail to reach the "Ready" state with the original default values. To prevent conflicts between liveness and readiness probes, the liveness probe was disabled.

Run the following command to disapy the generated admin password, necessary for logging into Link via a web browser.

kubectl get secrets/lnk-prod-lnk-product-login-secret --namespace default --template='{{ .data.password | base64decode }}'

Save the displayed password .

Verify the Installation.

The Link installation typically takes about 10 minutes to complete. During this process, some containers may restart several times. The installation is finished, and the containers are running and in a healthy state, once all necessary resources have been successfully allocated within the cluster.

Run the following command to verify the resources:

helm list

Expected resut:

NAME       NAMESPACE   REVISION  UPDATED                                  STATUS     CHART               APP VERSION
lnk-prod   default     1         2024-07-07 21:08:35.10827824 -0400 EDT   deployed   lnk-product-7.0.6   1.2.0

Run the following command to check the pods:

kubectl get pod

Expected resut:

NAME                                              READY  STATUS     RESTARTS     AGE
lnk-prod-link-mongodb-75b74d7684-xh9n9            1/1    Running    0            9m5s
lnk-prod-link-redis-master-0                      1/1    Running    0            9m5s
lnk-prod-lnk-product-client-758b84d7bf-w627w      1/1    Running    0            9m5s
lnk-prod-lnk-product-executor-558b8bdf48-gjdfh    1/1    Running    0            9m5s
lnk-prod-lnk-product-rest-6f6657c965-m5b7v        1/1    Running    0            9m5s
lnk-prod-lnk-product-server-74bb6657c8-5mzdm      1/1    Running    0            9m5s

Run the following command to check the deployment:

kubectl get deployment

Expected resut:

NAME                             READY  UP-TO-DATE   AVAILABLE    AGE
lnk-prod-link-mongodb            1/1    1            1            9m5s
lnk-prod-lnk-product-client      1/1    1            1            9m5s
lnk-prod-lnk-product-executor    1/1    1            1            9m5s
lnk-prod-lnk-product-rest        1/1    1            1            9m5s
lnk-prod-lnk-product-server      1/1    1            1            9m5s

Run the following command to check the services:

kubectl get svc

Expected resut:

NAME                            TYPE         CLUSTER-IP       EXTERNAL-IP    PORT(S)     AGE
kubernetes                      ClusterIP    10.100.0.1       <none>         443/TCP     31h
lnk-prod-link-mongodb           ClusterIP    10.100.125.50    <none>         27017/TCP   26m
lnk-prod-link-redis-headless    ClusterIP    None             <none>         6379/TCP    26m
lnk-prod-link-redis-master      ClusterIP    10.100.241.48    <none>         6379/TCP    26m
lnk-prod-lnk-product-client     ClusterIP    10.100.192.95    <none>         443/TCP     26m
lnk-prod-lnk-product-rest       ClusterIP    10.100.138.49    <none>         8080/TCP    26m
lnk-prod-lnk-product-server     ClusterIP    10.100.46.190    <none>         8443/TCP    26m

Access the Link UI

Start a local port-forwarding session to forward traffic from the local 4443 port to the port 443 in the lnk-client service:

kubectl port-forward service/lnk-prod-lnk-product-client 4443:443 --address 0.0.0.0

Log in to Link

Open a browser and go to https://localhost:4443/login
To log in, use the username admin. The password is the one that was generated when the Link chart was installed.

The Link home page will load.

Click Go to your Workspace to create your first project and begin using Link.

Installing Link

Procedure