README.md

RHWSL (Red hat UBI on WSL)

Red hat redistributable Standard UBI on WSL (Windows 10 Windows 10 FCU or later) based on wsldl

Download

Requirements

• Windows 10 Fall Creators Update x64 or later.
• Windows Subsystem for Linux feature is enabled.

Install

1. Download installer zip

2. Extract all files in zip file to same directory

3.Run RHWSL.exe to Extract rootfs and Register to WSL

Exe filename is using to the instance name to register. If you rename it you can register with a diffrent name and have multiple installs.

(Option)

• If you want to use WSL2, convert it with the following command.

wsl --set-version RHWSL 2

Subscription Manager

• The rootfs included in the release file is the redistributable Standard "Universal Base Image".
  However, you can register as usual using subscription-manager and use the RHEL repositories.

[root@<yourhost> RHWSL]# subscription-manager register
You are attempting to use a locale that is not installed.
Registering to: subscription.rhsm.redhat.com:443/subscription
Username: <yourusername>
Password: <yourpassword>
The system has been registered with ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
The registered system name is: <yourhost>
[root@<yourhost> RHWSL]# subscription-manager attach
You are attempting to use a locale that is not installed.
Installed Product Current Status:
Product Name: Red Hat Enterprise Linux for x86_64
Status:       Subscribed

How-to-Use(for Installed Instance)

exe Usage

Usage :
    <no args>
      - Open a new shell with your default settings.

    run <command line>
      - Run the given command line in that distro. Inherit current directory.

    runp <command line (includes windows path)>
      - Run the path translated command line in that distro.

    config [setting [value]]
      - `--default-user <user>`: Set the default user for this distro to <user>
      - `--default-uid <uid>`: Set the default user uid for this distro to <uid>
      - `--append-path <on|off>`: Switch of Append Windows PATH to $PATH
      - `--mount-drive <on|off>`: Switch of Mount drives
      - `--default-term <default|wt|flute>`: Set default terminal window

    get [setting]
      - `--default-uid`: Get the default user uid in this distro
      - `--append-path`: Get on/off status of Append Windows PATH to $PATH
      - `--mount-drive`: Get on/off status of Mount drives
      - `--wsl-version`: Get WSL Version 1/2 for this distro
      - `--default-term`: Get Default Terminal for this distro launcher
      - `--lxguid`: Get WSL GUID key for this distro

    backup [contents]
      - `--tgz`: Output backup.tar.gz to the current directory using tar command
      - `--reg`: Output settings registry file to the current directory

    clean
      - Uninstall the distro.

    help
      - Print this usage message.

Just Run exe

>RHWSL.exe
[root@PC-NAME user]#

Run with command line

>RHWSL.exe run uname -r
4.4.0-43-Microsoft

Run with command line with path translation

>RHWSL.exe runp echo C:\Windows\System32\cmd.exe
/mnt/c/Windows/System32/cmd.exe

Change Default User(id command required)

The following is an example of adding a user to the "users" and "wheel" groups and setting it as the default user

Note: Replace user with your chosen user name.

>RHWSL.exe run useradd -m -g users -G wheel -s /bin/bash user

>RHWSL.exe config --default-user user

>RHWSL.exe
[user@PC-NAME dir]$

Set "Windows Terminal" as default terminal

>RHWSL.exe config --default-term wt

How to uninstall instance

>RHWSL.exe clean