Skip to content

Commit

Permalink
Sunray: update document, using meta-package for installation of prere…
Browse files Browse the repository at this point in the history 
…quisites
  • Loading branch information
@cgrzemba
cgrzemba authored Oct 25, 2024
1 parent d0c0f9f commit f793531
Showing 1 changed file with 78 additions and 104 deletions.
182 changes: 78 additions & 104 deletions docs/handbook/sunray.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -17,25 +17,71 @@ All Rights Reserved. (Contributor contact(s):________________[Insert hyperlink/a
-->

# Sun Ray Software
<img src = "../../Openindiana.png">

Some notes for installation of Sun Ray Software on OpenIndiana Hipster.
# Hipster Handbook - Sun Ray Software

<div class="note" markdown="1">
!!! note
This configuration is not supported by OI nor by Oracle.
Some notes for installation of Sun Ray Software on OpenIndiana Hipster. Sun Ray Software is used to drive desktop sessions on SunRay thin clients (desktop unit: DTU).

<i class="fa fa-info-circle fa-lg" aria-hidden="true"></i> **NOTE:**
<div class="well">
This configuration is not supported by OI nor by Oracle.
</div>
<i class="fa fa-info-circle fa-lg" aria-hidden="true"></i> **NOTE:**
<div class="well">
Since GNOME is replaced by Mate in Hipster, installation is a little bit more difficult. For Sun Ray it is still necessary to use GNOME GDM and some other GNOME applications. But it is possible to use Mate desktop with its applications like pluma or atril.

<div class="note" markdown="1">
!!! note
Since GNOME is replaced by Mate in Hipster, installation is a little bit more difficult. For Sun Ray it is still necessary to use GNOME GDM and some other GNOME applications. But it is possible to use also Mate applications like pluma or atril.
</div>

Limitations:
## Install Prerequisites

Multihead is possible but the Display Switcher Applet on GNOME-panel on the second screen won't start. So you can't reopen minimized windows on the second screen because these will terminate on minimazing.
</div>
If you have installed new Hipster, it is necessary to install GNOME packages for GDM and its greeter-session. For user session it is fine to select 'Mate Session', it is no longer necessary to install other packages needed by Gnome Session (only Gnome packages which Mate session still uses).

Be sure to have Mate desktop environment installed:

```
# pkg install mate_install
```

## Install
Latest known working OpenIndiana GNOME packages versions are the following:

```
[email protected]
[email protected]
[email protected]
[email protected]
```

These are still in hipster repo, but are obsoleted empty metapackages.

At <http://pkg.toc.de/sunray/> you can find the old GNOME packages with newer release date, so that these should be able to install it on current Hipster. This publisher is provided and supported by community member Carsten Grzemba not by the OpenIndiana project.
For this to work add this publisher in a way, that it takes precedence over the default openindiana.org publisher:

In order to install packages with other versions such as userland-incorporation, it is necessary to release the version locks

```
# pkg change-facet facet.version-lock.gnome/gnome-session=false
# pkg change-facet facet.version-lock.gnome/gnome-settings-daemon=false
# pkg change-facet facet.version-lock.system/display-manager/gdm=false
# pkg change-facet facet.version-lock.library/gnome/libgnomekbd=false
# pkg change-facet facet.version-lock.gnome/window-manager/metacity=false
# pkg change-facet facet.version-lock.library/desktop/gnome-desktop=false
# pkg change-facet facet.version-lock.cde/cde-runtime=false
# pkg change-facet facet.version-lock.library/motif=false
# pkg change-facet facet.version-lock.library/tooltalk=false
```
configure the publisher
```shell
# pkg set-publisher --search-before=openindiana.org -g http://pkg.toc.de/sunray sunray
# pkg set-publisher --non-sticky openindiana.org
```
and install package sunray-essential from sunray publisher
```
# pkg install sunray-essential

This comment has been minimized.

Sign in to view

Copy link
@WifiRouterYT

WifiRouterYT Nov 5, 2024

This command seems to fail with an obsolete package error.

root@openindiana:/export/home/wifi# pkg install sunray-essential
Creating Plan (Running solver): -
pkg install: No matching version of consolidation/srss/sunray-essential can be installed:
  Reject:  pkg://sunray/consolidation/srss/[email protected]:20241023T101445Z
  Reason:  No version matching 'require' dependency gnome/[email protected] can be installed
    ----------------------------------------
    Reject:  pkg://sunray/gnome/[email protected]:20240123T073615Z
    Reason:  All acceptable versions of 'require' dependency on x11/library/[email protected] are obsolete
    ----------------------------------------

Very glad to see someone still working to get these Sun Ray's up! I'd love to contribute with my own Rays but unfortunately I have 0 experience with any of this.

This comment has been minimized.

Sign in to view

Copy link
@WifiRouterYT

WifiRouterYT Nov 5, 2024

Should mention: I tried to simply skip this part and still couldn't get to the installation due to yet another obsolete package.

root@openindiana:/export/home/wifi/srs_5.4.0.0-Solaris_11plus.i386# pkg install SUNWut-srss SUNWut-srwc SUNWuti
Creating Plan (Running solver): |
pkg install: No matching version of SUNWut-srwc can be installed:
  Reject:  pkg://sunray/[email protected]:20130220T220126Z
  Reason:  No version matching 'require' dependency [email protected] can be installed
    ----------------------------------------
    Reject:  pkg://sunray/[email protected]:20130220T220115Z
    Reason:  No version matching 'require' dependency SUNWkio can be installed
      ----------------------------------------
      Reject:  pkg://sunray/[email protected]:20130220T220654Z
      Reason:  No version matching 'require' dependency SUNWkio-libs can be installed
        ----------------------------------------
        Reject:  pkg://sunray/[email protected]:20130220T220658Z
        Reason:  All acceptable versions of 'require' dependency on compatibility/packages/SUNWxwplt are obsolete
        ----------------------------------------
      ----------------------------------------
    ----------------------------------------
No matching version of SUNWut-srss can be installed:
  Reject:  pkg://sunray/[email protected]:20130220T220731Z
  Reason:  No version matching 'require' dependency [email protected] can be installed
    ----------------------------------------
    Reject:  pkg://sunray/[email protected]:20130220T220611Z
    Reason:  No version matching 'require' dependency SUNWkio can be installed
    ----------------------------------------
  Reason:  No version matching 'require' dependency [email protected] can be installed
    ----------------------------------------
    Reject:  pkg://sunray/[email protected]:20130220T220615Z
    Reason:  No version matching 'require' dependency SUNWkio can be installed
    ----------------------------------------
  Reason:  No version matching 'require' dependency [email protected] can be installed
    ----------------------------------------
    Reject:  pkg://sunray/[email protected]:20130220T220623Z
    Reason:  No version matching 'require' dependency SUNWkio can be installed
    ----------------------------------------
root@openindiana:/export/home/wifi/srs_5.4.0.0-Solaris_11plus.i386#

could it because im using srs 5.4.0.0? (the only one i can get my hands on because of greedy oracle)
```
This will install all necessary packages for using GDM and Sun Ray Software tools on OI Hipster.

## Install Sun Ray Server Software

Sun Ray Software still can be downloaded at http://edelivery.oracle.com (registration required). Download the Software for Solaris x86-64 and for Linux x86-64. From the Linux software we take scripts for configure ISC DHCP server described later.

Expand Down Expand Up @@ -195,7 +241,6 @@ The config file `/etc/dhcp/dhcpd.conf` has to link to `/etc/inet/dhcp4.conf` so
To switch Sun Ray Software to isc-dhcp we take scripts located in path `/opt/SUNWut/lib/dhcp/isc` from the Sun Ray Software package for Linux (SUNWuto-4.5-44.i386.rpm). Extract the package with `rpm2cpio`:
```shell
# pkg install rpm
$ rpm2cpio SUNWuto-4.5-44.i386.rpm | cpio -idv <tmprpmdirectory>
```
Expand Down Expand Up @@ -359,108 +404,19 @@ index cffac27..448c171 100644
```
### Java Runtime Environment
### Note on Java Runtime Environment
The Sun Ray Software needs the Sun/Oracle JRE 1.7 which is shipped with the Sun Ray Software.
## Config
You can run `utconfig` and `utadm` the way described in the [Sun Ray Software](https://docs.oracle.com/cd/E35310_01/index.html) document.
# How to get GNOME on current Hipster
As already mentioned the Sun Ray Software cannot handled by LightDM and we still have to use GDM and some GNOME components necessary for the gnome-greeter session.
Be sure you have installed:
```shell
# pkg install libbonoboui
```
Make sure that they actually install as in the future they may be eventually obsoleted from Hipster
(no empty metapackages or obsoleted packages).
## update older Hipster
If you have Sun Ray running on Hipster with GNOME, you can prevent GNOME components removal by "freezing" them and releasing their version locks:
```shell
# pkg freeze gdm libgnomekbd gnome-session gnome-settings-daemon
```
and release the version locks:
```
# pkg change-facet facet.version-lock.gnome/gnome-session=false
# pkg change-facet facet.version-lock.gnome/gnome-settings-daemon=false
# pkg change-facet facet.version-lock.system/display-manager/gdm=false
# pkg change-facet facet.version-lock.library/gnome/libgnomekbd=false
```
<div class="note" markdown="1">
!!! note
On IPS there are meta-packages which define package dependencies of `type=incorporate`, which means:
If a package will installed, it have to have the version defined in the incorporate dependency.
We want to install an other version of the gnome packages as defined in userland-incorporation meta-package and relaese the version locks like shown above.
</div>
## Install on current Hipster (2022)
If you have installed new Hipster, it is necessary to install GNOME packages for GDM and its greeter-session. For user session it is fine to select 'Mate Session', it is no longer necessary to install other packages needed by Gnome Session (only Gnome packages which Mate session still uses).
Last known working OpenIndiana GNOME packages versions are the following:
```
[email protected]
[email protected]
[email protected]
[email protected]
```
These are still in hipster repo, but are obsoleted empty metapackages.
At <http://pkg.toc.de/sunray/> you can find the old GNOME packages with newer release date, so that these should be able to install it on current Hipster. This publisher is provided and supported by community member Carsten Grzemba not by the OpenIndiana project.
For this to work add this publisher in a way, that it takes precedence over the default openindiana.org publisher:
```shell
# pkg set-publisher --search-before=openindiana.org -g http://pkg.toc.de/sunray sunray
# pkg set-publisher --non-sticky openindiana.org
```
and install all packages from sunray publisher.
<div class="note" markdown="1">
!!! note
The version locks of the gnome packages have to relaese like decribed in [update older Hipster](#update-older-hipster).
</div>
### Install from Hipster (2019)
This is outdated and not necessary anymore. But it is kept here in case someone would still like to run Gnome-Session on Hipster.
If you installed new Hipster, it is necessary to install GNOME packages before they were obsoleted from Hipster.
Last known working OpenIndiana GNOME packages versions are the following:
```
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
desktop/[email protected]
```
## XScreenSaver
Latest Hipster delivers XScreenSaver only in 64-bit. The SunRay PAM module
are shipped as 32-bit only so unlocking works only with 32-bit XScreenSaver.
Newer Xscreensaver has the problem like some other newer Gnome and Mate components, that they expect, there is a main display :0. This isn't true on SunRay. XScreensaver prefer to crash on SunRay.
That's why we need the XScreenSaver package with 32-bit bins from <http://pkg.toc.de/sunray/>.
It is more comfortable to use mate-screensaver. For PAM is only the module mate-screensaver-pam-helper needed. This is not an shared object, instead it is an executable and can be shipped in 32bit independent from the other commands.
Expand Down Expand Up @@ -526,3 +482,21 @@ for sess in sp.Popen(['/opt/SUNWut/sbin/utsession','-px'], stdout=sp.PIPE).stdou
logger.debug("restart display %s" % disp.decode())
sp.Popen(['/opt/SUNWut/lib/gdm/utgdmdynamic','-a', disp])
```
# Multihead configuration
SunRay thin clients can be grouped to a multihead configuration, where multiple monitors can used for a single user session. For two clients this can be done with:
```
$ /opt/SUNWut/bin/utxconfig -m on -R 2x1 -S 0,1
```
Since GTK 3.10 multi screen setup is not supported anymore. The command line option `--display` whith a dot value greate 0 will not work any more (e.g.: earlier the command `firefox --display=:11.1` has started firefox on the second display).
metacity or marco will manage only the default screen. For multihead setup it is now necessary to enable 'xinerama' mode, so that the Window manager expands the screen across all DTU's in a group.
```
$ opt/SUNWut/bin/utxconfig -x on
```
Refer to the original documentation from Oracle for configuration in general: [Multiple Monitor Configurations](https://docs.oracle.com/cd/E35310_01/E35309/html/MultipleMonitor.html)

0 comments on commit f793531

Please sign in to comment.