Quick Start for Windows (WSL)
On Windows 11, QUBO++ can be used through WSL (Windows Subsystem for Linux), which allows Linux programs to run natively on Windows.
This document explains how to install WSL, required libraries, and QUBO++, and how to compile and run sample programs.
Install WSL
On Windows 11, WSL can be installed from Windows PowerShell. Open PowerShell as Administrator and execute the following command:
C:\WINDOWS\System32> wsl --install
Provisioning the new WSL instance Ubuntu
This might take a while...
Create a default Unix user account: [user account name]
New password: [your password]
Retype new password: [your password]
passwd: password updated successfully
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.
Enter your [user account name] and [your password] when prompted. This installs WSL 2 and an Ubuntu-based Linux system running on Windows.
After the installation is complete, update and upgrade the system software inside WSL:
sudo apt update
sudo apt upgrade -y
Install C++ compiler
QUBO++ requires a C++ compiler.
Install it using the following command:
sudo apt install -y build-essential
Install QUBO++
Follow the instructions in Installation to install QUBO++.
When using Method 2 (tar.gz), note the following WSL-specific details:
Download one of the following files from the Latest Release page, depending on your Windows PC architecture:
qbpp_amd64_<version>.tar.gz: For Intel- or AMD-based Windows PCsqbpp_arm64_<version>.tar.gz: For ARM-based Windows PCs (e.g., Copilot+ PCs)
If the file is downloaded to your Windows Downloads folder, extract it as follows:
tar xf /mnt/c/Users/<user name>/Downloads/qbpp_<arch>_<version>.tar.gz
It is recommended to create a symbolic link to the extracted directory:
ln -s qbpp_<arch>_<version> qbpp
To upgrade, download the new release and update the symbolic link:
ln -sfn qbpp_<arch>_<new version> qbpp
Execute ABS3 GPU Solver
If your system has a CUDA-enabled GPU, the ABS3 GPU Solver can be executed from WSL.
To enable GPU acceleration in WSL, install the NVIDIA GPU driver for Windows from the following page:
https://www.nvidia.com/Download/index.aspx
NOTE Do not install a Linux GPU driver inside WSL. WSL uses the Windows GPU driver via its integration layer.
After installing the driver, verify that the GPU is available in WSL by executing:
nvidia-smi
If the driver is installed correctly, this command displays information about the installed GPU. You can then execute a sample program using the ABS3 GPU Solver as follows:
./labs_abs3
Windows (WSL) でのクイックスタート
Windows 11 では、WSL (Windows Subsystem for Linux) を通じて QUBO++ を使用できます。WSL により、Linux プログラムを Windows 上でネイティブに実行できます。
このドキュメントでは、WSL、必要なライブラリ、QUBO++ のインストール方法、およびサンプルプログラムのコンパイルと実行方法を説明します。
WSL のインストール
Windows 11 では、WSL は Windows PowerShell からインストールできます。 PowerShell を管理者として開き、以下のコマンドを実行してください：
C:\WINDOWS\System32> wsl --install
Provisioning the new WSL instance Ubuntu
This might take a while...
Create a default Unix user account: [ユーザーアカウント名]
New password: [パスワード]
Retype new password: [パスワード]
passwd: password updated successfully
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.
プロンプトが表示されたら、[ユーザーアカウント名] と [パスワード] を入力してください。 これにより WSL 2 と Windows 上で動作する Ubuntu ベースの Linux システムがインストールされます。
インストールが完了したら、WSL 内でシステムソフトウェアを更新・アップグレードしてください：
sudo apt update
sudo apt upgrade -y
C++ コンパイラのインストール
QUBO++ には C++ コンパイラ が必要です。
以下のコマンドでインストールしてください：
sudo apt install -y build-essential
QUBO++ のインストール
インストール の手順に従って QUBO++ をインストールしてください。
方法2（tar.gz） を使用する場合は、以下の WSL 固有の注意点があります：
Windows PC のアーキテクチャに応じて、Latest Release ページから以下のファイルのいずれかをダウンロードしてください：
qbpp_amd64_<version>.tar.gz: Intel または AMD ベースの Windows PC 用qbpp_arm64_<version>.tar.gz: ARM ベースの Windows PC 用（例：Copilot+ PC）
ファイルが Windows のダウンロードフォルダにダウンロードされた場合、以下のように展開します：
tar xf /mnt/c/Users/<ユーザー名>/Downloads/qbpp_<arch>_<version>.tar.gz
展開したディレクトリへのシンボリックリンクを作成することを推奨します：
ln -s qbpp_<arch>_<version> qbpp
アップグレードする場合は、新しいリリースをダウンロードしてシンボリックリンクを更新してください：
ln -sfn qbpp_<arch>_<new version> qbpp
ABS3 GPU Solver の実行
システムに CUDA 対応 GPU がある場合、WSL から ABS3 GPU Solver を実行できます。
WSL で GPU アクセラレーションを有効にするには、以下のページから NVIDIA GPU ドライバ（Windows 用） をインストールしてください：
https://www.nvidia.com/Download/index.aspx
注意 WSL 内に Linux 用 GPU ドライバをインストールしないでください。 WSL は統合レイヤーを通じて Windows の GPU ドライバを使用します。
ドライバをインストールしたら、以下のコマンドを実行して WSL で GPU が利用可能か確認してください：
nvidia-smi
ドライバが正しくインストールされていれば、インストールされた GPU の情報が表示されます。 その後、以下のようにして ABS3 GPU Solver を使用するサンプルプログラムを実行できます：
./labs_abs3