OpenIndiana Hipster 2025.10 上で Sun Ray サーバーを設定する手順

もう一篇の Sun Ray ブログ記事の時間です！過去数ヶ月の間、Sun Ray サーバーの設定に関するサポートを要請してくださった方が数名メールをくださり、私が尽力しても OpenIndiana Hipster 2025.10 上の SRSS（Sun Ray Server Software）を実行する際の結果はまちまちでした。私の Sun Ray サーバーはまだ以前の OpenIndiana スナップショットを使用しており、改めて最新のガイドに沿って実際に設定を試すべき時が訪れたと判断しました。

Proxmox VM にて OpenIndiana のインストール

最初の壁 – VM の設定

以下は PVE 9.0.11 ホスト上で私にとって有効だった構成ですが、必ずしも全ての方が同様の結果を得られるとは限りません（YMMV）：

• インストールメディア: OpenIndiana ダウンロードページから入手する「OpenIndiana Hipster 2025.10 Live DVD (64-bit x86)」(ファイル名: OI-hipster-gui-20251026.iso)
• ゲスト OS: 「Solaris Kernel」(※古い PVE バージョンではこの選択肢が表示されない場合があります)
• マシン: タイプを q35、ファームウェアを SeaBIOS に設定
• グラフィックカード: Standard VGA
• ディスク: 60GB、バスを「VirtIO Block」に、キャッシュを「write back」に、discard オプションを有効にする
• CPU: モデルは host、ソケット数 1、コア数 4
• メモリ: 8GB
• ネットワーク: モデルを「VirtIO (paravirtualized)」に設定

VM の作成直後に起動しないでください。 いくつか編集を行う必要があるからです！

新規作成された VM の Hardware タブで行う追加設定：

• 新しい「VirtIO RNG」デバイスを追加する
• 「Machine」設定を編集し、「Advanced」というチェックボックスをオンにし、IOMMU を「vIOMMU」に設定する

新しい VM の構成は以下のようになります（[設定スクリーンショットまたは概要]）。

その後、VM を起動し、OpenIndiana インストーラーに入ります。ライブイメージのデスクトップにはショートカットがあり、GUI インストーラーも問題なく動作しました。インストール開始直後にいくつかのエラーダイアログボックスが表示されましたが、それらをクリックして閉じればインストールは問題なく続行されます。 インストール中に離席し、画面ロックされた状態で戻ってきた場合、ライブユーザーのパスワードは

jack

です。

インストールが完了したら、新しい OI インストールに入り直し、通常の非特権ユーザーアカウントでログインします。ターミナルを開くと、何故か黒文字に黒背景と表示されて破損したように見えるでしょう。

• 「Edit」メニュー > 「Profile Preferences」> 「Colors」タブを選択し、「Use colors from system theme」のチェックを外してください。

sudo -i

を実行して root シェルに入ります。

まずシステムを更新しましょう！

このステップを忘れると、システムが非常に奇妙に動作します。また、hipster-encumbered リポジトリの有効化も強くお勧めします：

pkg set-publisher -g https://pkg.openindiana.org/hipster-encumbered/hipster-encumbered
pkg refresh
pkg update

Sun Ray インストールガイドに従う

ここで、OpenIndiana ハンズブックの「Sun Ray Installation」セクションの手順に従っていきます。私がガイドとの異なる指示を出す場合は、以下の形式のブロックで示します。

sunray-essential

パッケージをインストールし、これにより必要な依存関係もすべて解決されます：

pkg install sunray-essential

Sun Ray Server Software パッケージをダウンロードして解凍します。これは Oracle の edelivery サイト（https://edelivery.oracle.com）で会員登録後ダウンロード可能です。また、archive.org には複数の Sun Ray 関連のアーカイブが存在し、必要なファイルも含まれています。目標は

V37038-01.zip

で、これは Solaris 11 i386 用 Sun Ray Server ソフトウェア バージョン 5.4.0.0 です。

要注意！ 私が入手した SRSS 5.4.5.0 のコピーは SPARC アーキテクチャのみのものでした（archive.org にあります）。（OI ハンズブックには「Oracle eDelivery から 5.4.5.0 を入手できる」と記載されていますが、それは完全に誤りであるようです）。もし Oracle eDelivery またはどこからでも SRSS 5.4.5.0 (Solaris 11 i386) を入手できた場合は、是非メールでご連絡ください！

bsdtar -C /root -xf V37038-01.zip

解凍後、IPS にその場所を教え込み、Sun Ray サーバーパッケージをインストールします：

pkg set-publisher -g /root/srs_5.4.0.0-Solaris_11plus.i386/IPS.i386/ sunray
pkg install SUNWut-srss SUNWut-srw

手動で依存関係を調整する

Sun Ray サーバーソフトウエアには、その時代（period-accurate）に即した Java ランタイム環境 (JRE) が不可欠です。また、Sun Ray サーバーの Web 管理には、同様に時代即席的な Apache Tomcat バージョンが必要です。幸いなことに、両方とも Sun Ray Server ソフトウェアパッケージ内の「Supplemental」ディレクトリに含まれていますので、ただ正しい場所へ移動させるだけです：

cd /opt
# JRE を解凍
/root/srs_5.4.0.0-Solaris_11plus.i386/Supplemental/Java_Runtime_Environment/Solaris/jre-6u41-solaris-i586.sh
bsdtar -C /opt -xf /root/srs_5.4.0.0-Solaris_11plus.i386/Supplemental/Apache_Tomcat/apache-tomcat-5.5.36.tar.gz
# Tomcat のシンボリックリンクを作成
ln -s /opt/apache-tomcat /opt/apache-tomcat-5.5.36

要注意！ OI ハンズブックには JRE のリンク設定に関する手順が含まれていますが、Oracle ウェブサイトから入手する必要があるとし、それがパッケージに含まれていることを言及していません。（もしかすると、5.4.5.0 パッケージには含まれていないのでしょうか？）。また、OI ハンズブックは Apache Tomcat のインストールについて一切触れていません。

OpenIndiana パッチツールのインストールと実行

これらがインストールされたら、Sun Ray サーバー用に OpenIndiana のパッチツールをインストール・実行する必要があります。

pkg install sunray/oi-adaptions
/opt/SUNWut/utils/apply_patches

Sun DHCP デーモン（実在しないもの）の代わりに ISC DHCP を Sun Ray サーバーに使用させます：

rm /etc/opt/SUNWut/dhcp
ln -s /opt/SUNWut/lib/dhcp/isc /etc/opt/SUNWut/dhcp

要注意！ 以下の手動パッチ適用ステップは OI ハンズブックには含まれていません。これらは SRSS 5.4.5.0 に対して必ずしも必須ではないかもしれませんが、現状では実行せざるを得ません。

/opt/SUNWut/utils/apply_patches

スクリプトを実行した後、以下のいくつかの手動パッチが必要です：

1. /opt/SUNWut/lib/utprodinfo

   の 322 行目：

   pkg list $2

   を

   pkg info -q $2

   に変更（「pkg」と「info」の間にスペースがある点に注意！）

2. /opt/SUNWut/sbin/utconfig

   の 243 行目：

   LCL_PACKAGE="SUNWlldap"

   を

   LCL_PACKAGE="ldap"

   に変更

3. /opt/SUNWut/sbin/utreplica

   の 77 行目：

   LCL_PACKAGE="SUNWlldap"

   を

   LCL_PACKAGE="ldap"

   に変更

これですべて完了しましたので、SRSS がインストールされました。設定の時間です！

初期設定を行うには：

/opt/SUNWut/sbin/utconfig

• セキュアな管理者パスワードを入力してください。
• Sun Ray Web Administration のセットアップを有効にするか問われたら、Y を選択してください。
• Apache Tomcat のパスを問われた場合は、そのまま Enter キーを押します（デフォルトは

  /opt/apache-tomcat

  で、先ほどシンボリックリンクを設定しました）。
• HTTPS を有効にするか問われたら N とします（現代的なブラウザではデフォルトの SSL 設定が動作せず、HTTPS を有効にすると明文化されたポートから HTTPS ポートへのリダイレクトのみが行われるため、その手間をかける価値はありません）。
• デフォルトのポート 1660 を受け入れます。
• リモートサーバー管理を有効にするか問われたら Y とします（これをしないと Tomcat サーバーは設定されたサブネット以外からのリクエストをブロックしてしまいます。後で直すよりここですぐに"Yes"と答えた方が断然簡単です）。
• Kiosk モードを設定するか問われたら Y とします。
• Kiosk 構成のデフォルト値を受け入れます。
• フェイルオーバーグループを設定するか問われたら N とします。
• これらの設定を確認するか問われたら Y とします。
• Windows Connector のグループ名の入力がある場合は、デフォルト値を受けます。

Sun Ray クライアントを接続できるようにするには、以下のコマンドが必要です：

/opt/SUNWut/sbin/utadm -L on
/opt/SUNWut/sbin/utpolicy -a -z both -m -D

警告： 上記の

utpolicy

の呼び出し方は、SRSS 設定に関する第一回の投稿とは異なります。OpenIndiana Hipster 2025.10 上の SRSS は「ホットデスクセッション（スマートカード非 mobility）」をサポートしないため、

-M

パラメータは渡せず、代わりに追加で

-D

を指定する必要があります。ホットデスク用の必要なライブラリを第一回のブログ記事で使用した同じリポジトリ（https://pkg.toc.de/sunray/）を追加することでインストールできるかもしれませんが、私は試していません。

この時点では、OpenIndiana VM 上でグラフカルセッション（GUI）から追い出されることを想定し、ターミナル以外のプログラムをすべて閉じます。その後、以下を実行します：

svcadm disable graphical-login/lightdm

コンソールでユーザーアカウントにログインし、再度

sudo -i

を実行して、以下を実行します：

svcadm enable graphical-login/gdm

これによりグラフカルログイン画面が再表示されます（今回は Sun Ray セッションに必要な GDM です）。ユーザー名を入力しますが、パスワードを入力する前に、画面下部のセッションタイプが MATE に設定されているか確認してください。GNOME に残してしまいますと、何らかの理由で素敵な黒い画面に遭遇し、何もできなくなってしまいます！

再びログインできた後、ターミナルを開き

sudo -i

などを실행し、Sun Ray サービスを開始できます：

/opt/SUNWut/sbin/utstart -c

クライアントへの接続

Sun Ray サービスが起動した後、DTU（Desktop Terminal Unit）をサーバーに接続する準備ができます！

ネットワーク上のすべての Sun Ray クライアントに対してサーバーを設定する最も簡単な方法は、ルーター（またはネットワークで使用している DNS サーバー）に静的 DNS エントリを追加することです。

sunray-servers

と

sunray-config-servers

を SRSS ホストを指し示せば、クライアントは自動的に設定され、指定した DNS 名に対応するサーバーへ接続します。

Sun Ray DTU のファームウェアが内蔵メニューへの入力をサポートしている場合、Sun キーボードでは Stop+M または標準の PC キーボードでは Ctrl+Alt+Meta+Shift+M でアクセスできます。「Servers」メニュー項目を選択すると、接続先の Sun Ray サーバー（IP/ホスト名）の入力を促されます。メインサーバーとファームウェアサーバーともに新しい SRSS サーバーの IP を入力し、ログサーバーは空白のままにします。変更を保存する確認後、Escape キーでメニューから退出すると DTU が再起動します。

すべて適切に設定され、クライアントが Sun Ray サーバーに到達できれば、Sun Ray クライアントでは GDM ログイン画面が表示されるはずです！

Sun Ray DTU ファームウェアの入手

前回同様、別の Sun Ray Server ソフトウェアパッケージからファームウェアを抽出する必要があります。

要注意！ これも OI ハンズブックには記載されていません。DTU が既に適切なファームウェアを実行していると想定されているのでしょうか？

前回と同様、Linux SRSS パッケージセットを取得し、

rpm2cpio

を使用して必要な RPM 内のファームウェアファイルを抽出しました。Oracle 配布物アーカイブ

V26331-01.zip

内の

srs_5.2/Components/10-SRSS/Content/Sun_Ray_Core_Services_4.3/Linux/Packages

の位置にある

SUNWutfw-4.3-50.i386.rpm

を使用しました（これは archive.org のアップロードから取得した

sunray-server-5.x.tar.gz

内の

Sun_Ray_Software_5.2/Linux_x86_(32bit_and_64bit)/V26331-01.zip

に含まれています）。

rpm2cpio SUNWutfw-4.3-50.i386.rpm | bsdtar -C /tmp -xf -
mv /tmp/opt/SUNWut /opt/SUNWutdfw
rmdir /tmp/opt

次に、DTU がファームウェアを引き下げるための TFTP ルートを設定し、Sun Ray サーバーにファームウェアを配置します：

mkdir /tftpboot
cd /tftpboot
ln -f -s . tftpboot
/opt/SUNWut/sbin/utfwadm -AaV -G force

ノート：

utfwadm

パラメータの簡単な説明：

-Aa

はファームウェアをすべての DTU に適用し、

-V

はツールに TFTP サーバーへのクライアント指向 DHCP オプションの設定を試さないようにさせ、

-G force

は上記で述べたクライアントの設定メニューを強制的に有効にします。

Sun Ray Web 管理

Web ブラウザを開き

http://<SUN_RAY_SERVER_IP>:1660

にアクセスすると、Sun Ray ウェブ管理画面が表示されます。ユーザー名は

admin

、先ほど設定した管理者パスワードでログインしてください。DTU が接続されている場合、「Desktop Units」タブで表示されるはずです（スクリーンショット参照）。

おわりに

これでほぼ完了です！メールでお問い合わせいただいた方々にお詫び申し上げます。私の情報が OpenIndiana Hipster 2025.10 やそれ以上の環境での設定については未確認であり、誤った情報をお伝えしてしまったことに反省しています。どうかこれで皆様のお役に立ちますことを願っております。