Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Install kLWC on Ubuntu 22.04 LTS

Use this topic to understand how to deploy the kLWC VM in an Ubuntu 22.04 LTS environment.

Note:

These steps are specific to Ubuntu 22.04 LTS. Commands and behavior may differ for other Linux distributions. Refer to the Linux documentation for distribution-specific variations.

To install the kLWC VM in your Ubuntu 22.04 LTS environment:

  1. Log in to the Ubuntu host system using your username and password.
  2. Create a working directory for the kLWC Manager script.
    Note:

    The kLWC Manager can be placed in any directory. In this example, the file is placed in /opt/klwc.
  3. Run the kLWC Manager setup.
    During setup, the required dependencies and missing packages are installed, user permissions configured, required commands verified, and directory structure is created.
    Note:

    • Run this step as the root user or with sudo.

    • If KVM is installed during setup, reboot the host system before proceeding.

    After setup is complete, your directory should look like:

  4. Switch to the kLWC user.

    If setup was performed as root, switch to the user that will manage kLWC:

  5. Upload the kLWC package.

    Copy the kLWC .tgz package you received from HPE into the packages directory.

    Use this command to copy:

    To verify:

    Note:

    Ensure correct ownership and read permissions for the user running kLWC Manager.
  6. Create a kLWC instance.

    Run the following command to create a new kLWC instance:

    Then, enter an instance name.

    Note:

    Instance names cannot be changed directly after creation.

    Use -rename option to rename the instance. Do not manually rename instance directories.

    The kLWC Manager prompts you to configure the following: package file, linux bridge interface names(int, ext, cap), IP configuration, proxy settings (if required).

    Note:

    Ensure that the specified Linux bridge interfaces already exist.

    Sample configuration:

  7. Confirm configuration.

    After entering values, type confirm to proceed with deployment.

    Trouble:

    You may run into the following error on this step or any of the subsequent steps: ERROR: Unable to run command using sudo: find. Please fix sudo permissions and try again.

    To resolve, verify sudo permissions for the user and ensure required commands are allowed for the user.
  8. Deploy and Start the VM.

    After confirmation, the package is extracted, .qcow2 image is prepared, params image is created, and the VM is launched using KVM.

    Sample output:

  9. Verify the installation.
    The kLWC VM should now be up and running.
    Issue this command to check the VM status:
  10. Manage kLWC instances.

    Use the kLWC Manager for ongoing operations: ./klwc-manager.sh

    Now that the instance is up and running, additional instances can be created with other package files.
    Other options in the kLWC manager can be used to stop, start, update, clean, and restart the VM.

    Common commands:

    • -list — List instances
    • -start — Start VM
    • -stop — Stop VM
    • -status — Check status
    • -logs — View logs
    • -restart — Restart VM
  11. (Optional) Verify instance files.

    After deployment, the instance directory should contain the following files:

    Trouble: If there are any issues with this installation process,

    • Review the logs using:

    • Verify system requirements
    • Check network bridge configuration
    • Validate permissions and sudo access

    For further assistance, contact Juniper TAC.