Main Content

Check Pod Status

Check the status of the Kubernetes® cluster pods. Before you can check the pods, you must have kubectl installed and configured to access the MATLAB® Online Server™ Kubernetes cluster and have helm installed on the same nodes as kubectl.

Get Pod List

MATLAB Online Server microservices run on Kubernetes cluster pods. To display a list of these pods, run the kubectl command with get pods.

Syntax

Issue the following command, replacing the variable <namespace-name> with the namespace you used to deploy MATLAB Online Server:

kubectl --namespace <namespace-name> get pods

Example Output

This command results in a display of running pods and statuses for the namespace mathworks:

NAME                                                  READY   STATUS    RESTARTS   AGE
mathworks-authnz-85f7d8f586-56rff                     1/1     Running   0          27m
mathworks-core-ui-5d44d459c6-cvphp                    1/1     Running   0          27m
mathworks-gateway-6c7bcf4566-vgfhs                    1/1     Running   0          27m
mathworks-gateway-proxy-5c4f5bf6d9-brmvp              1/1     Running   0          27m
mathworks-gateway-proxy-5c4f5bf6d9-dhbb7              1/1     Running   0          27m
mathworks-ingress-nginx-controller-8646d94799-9zkwb   1/1     Running   0          61m
mathworks-license-77c9dc5f44-22hnr                    1/1     Running   0          27m
mathworks-matlab-pool-apparmor-loader-kqlhh           1/1     Running   0          27m
mathworks-matlab-pool-c7bbd4dbc-g7xbm                 2/2     Running   0          27m
mathworks-matlab-pool-c7bbd4dbc-gf9ld                 2/2     Running   0          23m
mathworks-matlab-pool-helpsearch-664f5c56d4-tlg4s     1/1     Running   0          27m
mathworks-matlab-pool-ui-679d7c5b8d-w9fs7             1/1     Running   0          27m
mathworks-resource-6bc6f9d576-bfnnt                   1/1     Running   0          27m

The information returned can be broken down as follows:

  • The following services are MATLAB Online Server core services:

    • authnz

    • core-ui

    • gateway

    • license

    • helpsearch

    • ui

    • resource

All these services are expected to have the value 1/1 under the READY column.

  • The MATLAB Pool pod hosts the MATLAB process and it is expected to have the value 2/2 under the READY column. MATLAB Online Server assigns a separate pod for each MATLAB Online Server user.

  • matlab-pool-apparmor-loader is a specific pod that MATLAB Online Server deploys for each Kubernetes node. The display shown in the previous example lists two pods of this type because its Kubernetes cluster has two nodes.

The name of each pod has suffix at the end as a unique identifier. As an example, the authnz pod name ends with the suffix 5bd9867d69-2trk2. If a new pod is created, then you get a new suffix identifier at the end of its name.

Get List of Other Required Services

While the command kubectl lists the main MATLAB Online Server services, running that command does not make visible other required services, such as namespace. Instead, check the deployment status of other required services by running the helm list command.

Syntax

In this example, replace <namespace-name> with the namespace you used for MATLAB Online Server:

helm list --namespace <namespace-name> | egrep "<namespace-name>|nginx"

Example Output

This command results in a display of both core and additional services and their status for the namespace mathworks.

mathworks-authnz       	mathworks	1	YYYY-MM-DD HH:MM:SS +0000 UTC	deployed	opi-authnz-x.x.x        x.x.x      
mathworks-core-ui      	mathworks	1	YYYY-MM-DD HH:MM:SS +0000 UTC	deployed	mos-core-ui-x.x.x       x.x.x      
mathworks-gateway      	mathworks	1	YYYY-MM-DD HH:MM:SS +0000 UTC	deployed	mos-gateway-x.x.x       x.x.x      
mathworks-ingress-nginx	mathworks	1	YYYY-MM-DD HH:MM:SS +0000 UTC	deployed	ingress-nginx-x.x.x     x.x.x     
mathworks-license      	mathworks	1	YYYY-MM-DD HH:MM:SS +0000 UTC	deployed	mos-license-x.x.x       x.x.x      
mathworks-matlab-pool  	mathworks	1	YYYY-MM-DD HH:MM:SS +0000 UTC	deployed	mos-matlab-pool-x.x.x   x.x.x      
mathworks-namespace    	mathworks	1	YYYY-MM-DD HH:MM:SS +0000 UTC	deployed	mos-namespace-x.x.x     x.x.x      
mathworks-resource     	mathworks	1	YYYY-MM-DD HH:MM:SS +0000 UTC	deployed	mos-resource-x.x.x      x.x.x

Make sure each service has the value DEPLOYED.

Get Pod Descriptions

To get more details about each pod, run the following command:

kubectl describe pod <podId>

Syntax

For example, issue the following command, replacing <namespace-name> with the namespace you used for MATLAB Online Server:

kubectl --namespace=<namespace-name> describe pod <namespace-name>-matlab-pool-5858d796b9-lqslb

This command provides details about the MATLAB pool pod identified by <namespace-name>-matlab-pool-5858d796b9-lqslb.

Example Output

Pod Descriptors
Name<namespace-name>-matlab-pool-5858d796b9-lqslb
Namespace<namespace-name>
Nodeprivate-node-3/123.45.67.89
Start TimeFri, 17 Jan YYYY 10:25:20 -0500
StatusRunning
IP987.65.43.21
Containers

matlab:

Container ID: docker://cf5d62aeb248a87ddac5fdd775cae7c94e8df06816ad68c5d1db78b87f903cb4

Port8080/TCP
Events

Type        Reason        Age                        From                                 
Message
   ------        ----------       ------                       ----
---                                            ------------
  Normal   Scheduled  <unknown>          default-scheduler                    
Successfully assigned <namespace-name>/<namespace-name>-matlab-
pool-5858d796b9-lqslb to private-node-3

  Normal   Pulling    19m                kubelet, private-node-3  
Pulling image "containers.mathworks.com/matlab-online-server/
mos-matlab-omnibus-image:1.13.0-bionic"

  Normal   Pulled     19m                kubelet, private-node-3  
Successfully pulled image "containers.mathworks.com/matlab-online-server/
mos-matlab-omnibus-image:1.13.0-bionic"

  Normal   Created    19m                kubelet, private-node-3  
Created container matlab

  Normal   Pulling    19m                kubelet, private-node-3  
Pulling image "containers.mathworks.com/matlab-online-server/
mos-matlab-omnibus-image:1.13.0-bionic"

  

  Normal   Pulling    19m                kubelet, private-node-3  
Pulling image "containers.mathworks.com/matlab-online-server/
mos-matlab-omnibus-image:1.13.0-bionic"

  Normal   Pulled     19m                kubelet, private-node-3  
Successfully pulled image "containers.mathworks.com/matlab-online-server/
mos-matlab-omnibus-image:1.13.0-bionic"

  Normal   Created    19m                kubelet, private-node-3  
Created container resource-proxy

  Normal   Started    19m                kubelet, private-node-3  
Started container resource-proxy

  Normal   Started    19m                kubelet, private-node-3  
Started container matlab

  Normal   Pulled     19m                kubelet, private-node-3  
Successfully pulled image "containers.mathworks.com/matlab-online-server/
mos-matlab-omnibus-image:1.13.0-bionic"

  Normal   Created    19m                kubelet, private-node-3  
Created container display

  Normal   Started    19m                kubelet, private-node-3  
Started container display

  Normal   Pulling    19m                kubelet, private-node-3  
Pulling image "containers.mathworks.com/matlab-online-server/
mos-matlab-omnibus-image:1.13.0-bionic"

  Normal   Pulled     19m                kubelet, private-node-3  
Successfully pulled image "containers.mathworks.com/matlab-online-server/
mos-matlab-omnibus-image:1.13.0-bionic"

  Normal   Created    19m                kubelet, private-node-3  
Created container windowmanager

  Normal   Started    19m                kubelet, private-node-3  
Started container windowmanager

Related Topics

External Websites