Main Content

mosadm reset-node

Reset single-node Kubernetes cluster running MATLAB Online Server

Since R2020a

    Description

    mosadm reset-node resets the single-node Kubernetes® cluster that is running MATLAB® Online Server™ and performs these actions:

    • Stop the kubelet program running on the machine.

    • Remove the Kubernetes cluster running locally.

    • Reset the IP tables.

    Run this command for a single-node cluster that was created using the mosadm bootstrap-node command.

    After you run this command, you can rerun mosadm bootstrap-node to redeploy a single-node Kubernetes cluster and continue working with MATLAB Online Server. The reset-node command does not uninstall Linux® packages deployed during the bootstrap-node operation. To reset your environment fully, re-image the operating system or restore it from a backup.

    example

    mosadm reset-node option1 ... optionN resets the node using the specified configuration options.

    Note

    mosadm reset-node requires sudo administration privileges.

    Examples

    collapse all

    sudo ./mosadm reset-node
    [reset] Reading configuration from the cluster...
    [reset] FYI: You can look at this config file with 'kubectl -n kube-system get cm kubeadm-config -o yaml'
    W0125 18:44:12.253437  105006 configset.go:77]
      Warning: No kubeproxy.config.k8s.io/v1alpha1 config is loaded.
      Continuing without it: configmaps "kube-proxy" not found
    [reset] WARNING: Changes made to this host by 'kubeadm init' or 'kubeadm join' will be reverted.
    [reset] Are you sure you want to proceed? [y/N]: y
    [preflight] Running pre-flight checks
    The 'update-cluster-status' phase is deprecated and will be removed in a future release.
      Currently it performs no operation
    [reset] Stopping the kubelet service
    [reset] Unmounting mounted directories in "/var/lib/kubelet"
    [reset] Deleting contents of config directories: [/etc/kubernetes/manifests /etc/kubernetes/pki]
    [reset] Deleting files: [/etc/kubernetes/admin.conf
      /etc/kubernetes/kubelet.conf /etc/kubernetes/bootstrap-kubelet.conf
      /etc/kubernetes/controller-manager.conf /etc/kubernetes/scheduler.conf]
    [reset] Deleting contents of stateful directories: [/var/lib/etcd /var/lib/kubelet
      /var/lib/dockershim /var/run/kubernetes /var/lib/cni]
    
    The reset process does not clean CNI configuration. To do so, you must remove /etc/cni/net.d
    
    The reset process does not reset or clean up iptables rules or IPVS tables.
    If you wish to reset iptables, you must do so manually by using the "iptables" command.
    
    If your cluster was setup to utilize IPVS, run ipvsadm --clear (or similar)
    to reset your system's IPVS tables.
    
    The reset process does not clean your kubeconfig files and you must remove them manually.
    Please, check the contents of the $HOME/.kube/config file. 
     
    

    Input Arguments

    collapse all

    One or more configuration options, specified as strings corresponding to valid configuration options from this table.

    Common to All mosadm Commands

    OptionDescription

    --charts-dir chartsDir

    Name of the MATLAB Online Server charts folder to use. This folder contains the Helm® charts of the server.

    Specify chartsDir as an absolute path or a path relative to the MATLAB Online Server root folder mosRoot.

    Example: matlab_online_server/charts.

    Default: mosRoot/charts

    --data-dir dataDir

    Name of the MATLAB Online Server data folder to use.

    Specify dataDir as an absolute path or a path relative to the MATLAB Online Server root folder mosRoot.

    Example: matlab_online_server/data.

    Default: mosRoot/data

    --dry-run

    Print out the commands that would have run without this option specified but do not run the operation. Specify this option to test that the operation produces the expected results before actually executing it.

    --help, -h, help

    Output help for mosadm reset-node to the command line.

    --kube-config configFilePath

    Path to the Kubernetes cluster configuration file. Specify configFilePath as an absolute path or a path relative to the MATLAB Online Server root folder mosRoot.

    Example: /etc/kubernetes/admin.conf

    By default, configFilePath is empty and Kubernetes obtains the cluster configuration from the KUBECONFIG environment variable (if specified) or the ~/.kube/config file. If you run mosadm reset-node with sudo, then ~/.kube/config is equivalent to /root/.kube/config.

    --mos-root rootDir

    MATLAB Online Server root folder, specified as an absolute path or a path relative to the current folder, that is, the folder in which you can run mosadm commands.

    Default: . (current folder)

    --overrides-dir overridesDir

    Name of the MATLAB Online Server overrides folder to use.

    Specify overridesDir as an absolute path or a path relative to the MATLAB Online Server root folder, mosRoot.

    Example: matlab_online_server/overrides

    Default: mosRoot/overrides

    --quiet, -q

    Print only the most useful or relevant output from the mosadm reset-node command.

    --skip-log-file

    Skip creating the install.log file and logging data about the mosadm reset-node operation to this file.

    --skip-prompt, -y

    Force acceptance of the terms of use for the mosadm reset-node and skip any command-line prompts normally provided when calling this command.

    --tmp-dir tempDirName

    Name of MATLAB Online Server temporary folder to use.

    Specify tempDirName as an absolute path or a path relative to the temporary folder.

    By default, mosadm reset-node generates a new temporary folder every time you run the command.

    --verbose

    Output extra details about the mosadm reset-node operation to the command line.

    Version History

    Introduced in R2020a