Connect to the JupyterLab Server - 2020.2 English - XD336

Versal Base TRD Documentation (XD336)

Document ID
XD336
Release Date
2025-12-01
Version
2020.2 English

Follow these steps to boot the board into Linux. These steps can be skipped if you are already at the Linux prompt xilinx-vck190-20221

  • Ensure all steps under the section Board Setup are verified.

  • Insert the prepared micro SD card into the Versal SD card slot (refer to the image in Board Setup)

  • Have the UART0 terminal emulator tab connected.

  • Turn ON power switch SW13.

  • On Versal UART0 terminal, you would see the Versal device booting from the micro SD card, starting with the message “Xilinx Versal Platform Loader and Manager”

  • In about 60 seconds boot is complete. Observe the Linux prompt xilinx-vck190-20221 and finish logging in.

  • JupyterLab server is disabled in the systemd services and will not autostart. Users can enable ‘jupyter-setup’ via systemctl to autostart the service.

Follow the steps in the example below to start JupyterLab:

xilinx-vck190-20221:~$ sudo systemctl start jupyter-setup
xilinx-vck190-20221:~$ sudo jupyter-lab  list
Currently running servers:
http://192.168.xx.x:8888/?token=1f69939d70cdedd044adb64c91d26a75c01da7ad34f8ff03 :: /usr/share/notebooks
  • Copy the above URL http://192.168.xx.x:8888/?token=1f69939d70cdedd044adb64c91d26a75c01da7ad34f8ff03 to the chrome browser.

  • Users can check status of the systemd service ‘jupyter-setup’ any time for debug info:

    xilinx-vck190-20221:~$ systemctl status jupyter-setup
    * jupyter-setup.service - jupyter setup scripts
         Loaded: loaded (/lib/systemd/system/jupyter-setup.service; disabled; vendor preset: disabled)
         Active: active (running) since Fri 2021-11-19 10:12:14 PST; 20min ago
       Main PID: 879 (start-jupyter.s)
          Tasks: 3 (limit: 2237)
         Memory: 125.6M
         CGroup: /system.slice/jupyter-setup.service
                 |-879 /bin/bash /sbin/start-jupyter.sh
                 `-884 python3 /usr/bin/jupyter-lab --no-browser --allow-root --ip=192.xxx.xx.xx
    

Note

If you do not see any URL for the Juputer Notebook, you may have to setup a private network. Likely, DHCP is not available to allot the board an IP address. To setup a private network and start the notebook follow the instruction below.