Client VM

Using the client VM

The Client Virtual Machine (Client VM) provides an abstracted interface over the OpenShift environment, offering a familiar experience for existing Netezza users. Customers can log in to the Client VM to perform a variety of tasks, including:
  • Running backup and restore operations
  • Executing support scripts
  • Managing custom scripts

SSH access to the client VM

To access the client VM using SSH, use the virtctl utility:
virtctl -n your-namespace ssh nz@your-vm-name --identity-file=<path_to_sshkey>
Tip: The virtctl tool can be downloaded from the Virtualization > Overview tab.

SSH key pairs are generated during nzswsetup and saved as clientvm_rsa and clientvm_rsa.pub.

Cluster authentication

To authenticate with the cluster:

  1. Click on the account dropdown and select Copy login command.
  2. Click Display Token.
  3. Copy the token under Log in with this token.
  4. Paste the token in your terminal to log in.
SSH host key handling
Important: On your first connection to the Client VM, you will be prompted to accept the VM's SSH fingerprint. If host keys are already present in the .ssh/known_hosts file, remove any conflicting entries to proceed. To bypass strict host key checking, you can use the following command:
virtctl -n ibm-nz-sw-clientvm ssh nz@ibm-nz-sw-clientvm-app --local-ssh=true --local-ssh-opts="-o StrictHostKeyChecking=no" --identity-file=<path_to_clientvm_ssh_identity_key>

NPS client packages

NPS client tools are installed in /usr/local/nz. Examples:

  • Check BNR pod status - nzbnrctl nzbnrpod status
  • Check BNR manager status - nzbnrctl nzbnrmgr status
  • Check BNR version - nzbnrver

Using the nzcli tool

To use the nzcli tool:

  1. Get the APISERVER_URL from the Netezza console.
  2. Set environment variables: 
    export NZ_USER=admin
export NZ_PASSWORD=Password~That~Is~Complex123
export APISERVER_URL=https://apiserver_url_from_console.svc.cluster.local:8443
  3. Run CLI tools from /home/nz/nz-tools.
    Example:
    -rwxr-xr-x. 1 nz nz: 62139423 Jun 4 10:55 nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzbackup → /home/nz/nz-tools/nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzbatchbnr -> /home/nz/nz-tools/nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzds -> /home/nz/nz-tools/nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzhw -> /home/nz/nz-tools/nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzrestore -> /home/nz/nz-tools/nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzrev -> /home/nz/nz-tools/nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzsession -> /home/nz/nz-tools/nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzstate -> /home/nz/nz-tools/nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzstats -> /home/nz/nz-tools/nz
Irwxrwxrwx. 1 nz nz 20 Jun 4 10:55 nzsystem -> /home/nz/nz-tools/nz
  4. Displays system state - ./nzstate.
    Example:
    [nz@clientvm nz-tools]$ ./nzstate
System state is 'Online'