Recent changes to OpenIndianaBuild

OpenIndianaBuild modified by Jon Trulson

Jon Trulson — Sun, 04 Jul 2021 03:54:17 -0000

--- v10
+++ v11
@@ -4,7 +4,7 @@

 **WARNING: THIS GUIDE IS FOR ADVANCED USERS FOR USE IN BUILDING AND PORTING.**

-**Note: This has not been tested with CDE versions 2.4.0a+ (autoconf) and may not work.
+**Note: This has not been tested with CDE versions 2.4.0a+ (autoconf) and may not work.**

 **Note: This port has been tested on OpenSolaris snv_134 and OpenIndiana 151a8/Hipster.
 It may also work on other Illumos derived systems.**

OpenIndianaBuild modified by Jon Trulson

Jon Trulson — Sun, 04 Jul 2021 03:52:58 -0000

--- v9
+++ v10
@@ -3,6 +3,8 @@
 

 **WARNING: THIS GUIDE IS FOR ADVANCED USERS FOR USE IN BUILDING AND PORTING.**
+
+**Note: This has not been tested with CDE versions 2.4.0a+ (autoconf) and may not work.

 **Note: This port has been tested on OpenSolaris snv_134 and OpenIndiana 151a8/Hipster.
 It may also work on other Illumos derived systems.**

OpenIndianaBuild modified by Matthew Trower

Matthew Trower — Wed, 31 Oct 2018 02:13:31 -0000

--- v8
+++ v9
@@ -149,6 +149,32 @@

 


+# Building Old Releases
+
+Some additional steps are required to build older releases of CDE.
+
+

+## CDE Versions Prior to 2.3
+
+### Hostname
+Add your hostname to the localhost line in /etc/hosts.
+
+

+### Link in X11/Motif headers
+
+The X11 library headers need to be symlinked into the build tree.
+
+**Be careful of capitalisation of 'x' and 'X' here.**
+
+(Replace /path/to/ with the path to the location of your source tree.)
+
+cd /path/to/cdesktopenv-code/cde
+mkdir -p imports/x11/include
+cd imports/x11/include
+ln -s /usr/include/X11 .
+ln -s /usr/X11/include/Xm .
+
+

 # Known Issues

 The screen freezes when a user clicks in an inactive window. It can be avoided by using

OpenIndianaBuild modified by Matthew Trower

Matthew Trower — Tue, 30 Oct 2018 06:33:04 -0000

--- v7
+++ v8
@@ -4,8 +4,8 @@

 **WARNING: THIS GUIDE IS FOR ADVANCED USERS FOR USE IN BUILDING AND PORTING.**

-**Note: This port has been tested on OpenIndiana 151a8. It may also work on other Illumos
-derived systems.**
+**Note: This port has been tested on OpenSolaris snv_134 and OpenIndiana 151a8/Hipster.
+It may also work on other Illumos derived systems.**
 


 Table of Contents
@@ -16,10 +16,14 @@

 ## Supported Platforms

-The initial OpenIndiana port only supports 64-bit x86 systems.
+This port currently supports SPARC and 64-bit x86 systems.
 


 ## Install Dependencies
+
+**Note: These instructions are appropriate for a standard desktop installation of OI 1518a .
+Additional packages are required for minimal or server installation envirionments. 
+Hipster is a moving target, and some packages may differ.**

 Add additional publisher:

@@ -60,14 +64,14 @@

 Create symlinks:

-    ln -s /usr/gnu/bin/gcc /usr/gnu/bin/cc
-    ln -s /opt/solarisstudio12.3 /opt/solarisstudio  (optional)
+    ln -s /usr/gnu/bin/gcc /usr/gnu/bin/cc           (if using GCC)
+    ln -s /opt/solarisstudio12.3 /opt/solarisstudio  (if using Sun/Solaris Studio)
     ln -s /usr/bin/automake-1.10 /usr/bin/automake
     ln -s /usr/bin/aclocal-1.10 /usr/bin/aclocal

 Configure runtime linking environment:

-    crle -u -l /usr/gnu/lib
+    crle -u -l /usr/gnu/lib   (if using GCC)
     crle -u -l /usr/X11/lib

 change a line in /etc/default/init to:
@@ -79,15 +83,16 @@

 ## Installation of Motif

-**Build Motif from source!**
+**OpenSolaris/OpenIndiana systems ship with a historical version of motif, which is unsuitable for building CDE.
+Motif must be built from source, and should be installed in /usr/X11.**

-* Download the latest source package from sourceforge \([motif-2.3.4.src.tgz](https://sourceforge.net/projects/motif/files/latest/download)\).
+* Download the latest source package from sourceforge \([motif-2.3.8.src.tgz](https://sourceforge.net/projects/motif/files/latest/download)\).
 * unpack sources

-        cd motif-2.3.4
-        ./autogen.sh
+        cd motif-2.3.8
+        ./autogen.sh --prefix=/usr/X11
         make
-        sudo make install
+        pfexec make install

 


@@ -100,25 +105,12 @@

 


-## Link in X11 headers
-
-The X11 library headers need to be symlinked into the build tree.
-
-**Be careful of capitalisation of 'x' and 'X' here.**
-
-(Replace /path/to/ with the path to the location of your source tree.)
-
-    cd /path/to/cdesktopenv-code/cde
-    mkdir -p imports/x11/include
-    cd imports/x11/include
-    ln -s /usr/include/X11 .
-    ln -s /usr/X11/include/Xm .
-
-

-
 ## Supported Compiler

-The port supports either gcc or Solaris Studio compiler. gcc is the default and must be installed (see 1.2). 
+**Note: GCC 6+ builds are broken at the moment.
+Either install GCC 4 or 5 (and put it first in your path), or use Solaris Studio.**
+
+The port supports either gcc or Solaris Studio compiler.  gcc is the default and must be installed (see 1.2). 
 But it is also possible to install Solaris Studio and to activate it for CDE by adding the following line
 to /path/to/cdesktopenv-code/cde/config/cf/host.def:

@@ -136,16 +128,14 @@

 # Install CDE

-This has to be done as root:
-
     cd /path/to/cdesktopenv-code/cde/admin/IntegTools/dbTools
-    ./installCDE -s /path/to/cdesktopenv-code/cde
+    pfexec ./installCDE -s /path/to/cdesktopenv-code/cde

 


 # Start CDE

-Disable gdm graphical login as root:
+Disable gdm graphical login:

     svcadm disable svc:/application/graphical-login/gdm

@@ -164,7 +154,15 @@
 The screen freezes when a user clicks in an inactive window. It can be avoided by using
 KEYBOARD_FOCUS_POINTER mode. This mode is default on Solaris based systems.

-(Editor's note 7/3/18: Is this still a problem?)
+*(Editor's note 7/3/18: Is this still a problem?)
+(Editor's reply 10/29/18: This has never been a problem for me on OI Hipster or OpenSolaris.  
+  I don't recall it being a problem for me back when I used OI legacy.  There are some issues surrounding
+  focus modes on Sun systems, but this does not seem to be one of them.  I think this is probably resolved...)*
+  
+Something appears to be wrong with the default CDE focus settings on Solaris based systems.  When logging in
+with a new user for the first time, it behaves as a strange mix of 'Point In Window' and 'Click In Window'.  If this
+happens to you, you need to toggle and apply the Window Behavior setting (found in Style Manager -> Window).
+You can toggle it back afterward, if you like.

OpenIndianaBuild modified by Jon Trulson

Jon Trulson — Wed, 04 Jul 2018 02:40:02 -0000

--- v6
+++ v7
@@ -8,7 +8,8 @@
 derived systems.**
 


-# Table of Contents
+Table of Contents
+
 [TOC]

 # Build Prerequisites

OpenIndianaBuild modified by Jon Trulson

Jon Trulson — Tue, 03 Jul 2018 23:48:31 -0000

--- v5
+++ v6
@@ -95,13 +95,7 @@

 ## Clone the repository or download the source

-Use the git clone command to read the source code from Git repository:
-
-    git clone git://git.code.sf.net/p/cdesktopenv/code cdesktopenv-code
-
-Or download the latest source release:
-
-[[download_button]]
+[[include ref="include_Get source code"]]

OpenIndianaBuild modified by Jon Trulson

Jon Trulson — Tue, 03 Jul 2018 20:59:30 -0000

--- v4
+++ v5
@@ -164,7 +164,7 @@

 


-# 6) Known Issues
+# Known Issues

 The screen freezes when a user clicks in an inactive window. It can be avoided by using
 KEYBOARD_FOCUS_POINTER mode. This mode is default on Solaris based systems.

OpenIndianaBuild modified by Jon Trulson

Jon Trulson — Tue, 03 Jul 2018 20:58:22 -0000

--- v3
+++ v4
@@ -22,7 +22,7 @@

 Add additional publisher:

-    pkg set-publisher -p http://pkg.openindiana.org/sfe/  sfe
+    pkg set-publisher -p http://pkg.openindiana.org/sfe/ sfe

 Install the following packages:

@@ -97,7 +97,7 @@

 Use the git clone command to read the source code from Git repository:

-    git clone git://git.code.sf.net/p/cdesktopenv/code  cdesktopenv-code
+    git clone git://git.code.sf.net/p/cdesktopenv/code cdesktopenv-code

 Or download the latest source release:

@@ -127,7 +127,7 @@
 But it is also possible to install Solaris Studio and to activate it for CDE by adding the following line
 to /path/to/cdesktopenv-code/cde/config/cf/host.def:

-    \#define HasSunC   YES
+    #define HasSunC YES

 


@@ -169,7 +169,7 @@
 The screen freezes when a user clicks in an inactive window. It can be avoided by using
 KEYBOARD_FOCUS_POINTER mode. This mode is default on Solaris based systems.

-(Editor's note: Is this still a problem?)
+(Editor's note 7/3/18: Is this still a problem?)

OpenIndianaBuild modified by Jon Trulson

Jon Trulson — Tue, 03 Jul 2018 20:55:58 -0000

--- v2
+++ v3
@@ -8,19 +8,21 @@
 derived systems.**
 


+# Table of Contents
+[TOC]

-## 1) Build Prerequisites ##
+# Build Prerequisites 

-### 1.1) Supported Platforms ###
+## Supported Platforms

 The initial OpenIndiana port only supports 64-bit x86 systems.
 


-### 1.2) Install Dependencies ###
+## Install Dependencies

 Add additional publisher:

-* pkg set-publisher -p http://pkg.openindiana.org/sfe/  sfe
+    pkg set-publisher -p http://pkg.openindiana.org/sfe/  sfe

 Install the following packages:

@@ -39,133 +41,135 @@
 * developer/build/libtool
 


-### 1.3) Additional Preparations ###
+## Additional Preparations

-* add /usr/gnu/bin to your PATH variable:
+Add /usr/gnu/bin to your PATH variable:
+
     PATH=$PATH:/usr/gnu/bin

-* add /opt/solarisstudio/bin to your PATH variable  (optional):
+Add /opt/solarisstudio/bin to your PATH variable  (optional):
+
     PATH=$PATH:/opt/solarisstudio/bin

 Run the following commands as root:

-* add your hostname to the localhost line in /etc/hosts or add a new line with hostname and ip address
-* create symlinks:
+**NOTE: For CDE versions 2.3 or later, it is no longer necessary to add your hostname to /etc/hosts**
+
+Add your hostname to the localhost line in /etc/hosts (for CDE versions less than 2.3)
+
+Create symlinks:
+
     ln -s /usr/gnu/bin/gcc /usr/gnu/bin/cc
     ln -s /opt/solarisstudio12.3 /opt/solarisstudio  (optional)
     ln -s /usr/bin/automake-1.10 /usr/bin/automake
     ln -s /usr/bin/aclocal-1.10 /usr/bin/aclocal
-* configure runtime linking environment:
+
+Configure runtime linking environment:
+
     crle -u -l /usr/gnu/lib
     crle -u -l /usr/X11/lib
-* change a line in /etc/default/init to:
+
+change a line in /etc/default/init to:
+
     LANG=C
-* reboot the system
+
+Reboot the system
 


-### 1.4) Installation of Motif ###
+## Installation of Motif

 **Build Motif from source!**

 * Download the latest source package from sourceforge \([motif-2.3.4.src.tgz](https://sourceforge.net/projects/motif/files/latest/download)\).
 * unpack sources
-* cd motif-2.3.4
-* ./autogen.sh   (also starts configure)
-* make
-* sudo make install
+
+        cd motif-2.3.4
+        ./autogen.sh
+        make
+        sudo make install
+    
 


-## 2) Compiling ##
+# Compiling

-### 2.1) Get a copy of the repository ###
+## Clone the repository or download the source

 Use the git clone command to read the source code from Git repository:

-* git clone git://git.code.sf.net/p/cdesktopenv/code  cdesktopenv-code
+    git clone git://git.code.sf.net/p/cdesktopenv/code  cdesktopenv-code
+
+Or download the latest source release:
+
+[[download_button]]
+
 


-### 2.2) Record all actions for troubleshooting ###
-
-In case of trouble it is important to have a log file to report problems.
-
-Use the command:
-
-* script /tmp/log.txt
-
-to open a log file that will log everything in your terminal (also all letters and passwords that you might type!)
-into the /tmp/log.txt file.
-

-
-### 2.3) Link in X11 headers ###
+## Link in X11 headers

 The X11 library headers need to be symlinked into the build tree.
+
 **Be careful of capitalisation of 'x' and 'X' here.**

 (Replace /path/to/ with the path to the location of your source tree.)

-- cd /path/to/cdesktopenv-code/cde
-- mkdir -p imports/x11/include
-- cd imports/x11/include
-- ln -s /usr/include/X11 .
-- ln -s /usr/X11/include/Xm .
+    cd /path/to/cdesktopenv-code/cde
+    mkdir -p imports/x11/include
+    cd imports/x11/include
+    ln -s /usr/include/X11 .
+    ln -s /usr/X11/include/Xm .
+
 


-### 2.4) Supported Compiler ###
+## Supported Compiler

 The port supports either gcc or Solaris Studio compiler. gcc is the default and must be installed (see 1.2). 
 But it is also possible to install Solaris Studio and to activate it for CDE by adding the following line
 to /path/to/cdesktopenv-code/cde/config/cf/host.def:

-* \#define HasSunC   YES
+    \#define HasSunC   YES
+
 


-### 2.5) Build CDE ###
+## Build CDE

-* cd /path/to/cdesktopenv-code/cde
-* make World
+    cd /path/to/cdesktopenv-code/cde
+    make World

 The build will terminate with a successfully built message.
 


-## 3) Install CDE ##
+# Install CDE

 This has to be done as root:

-* cd /path/to/cdesktopenv-code/cde/admin/IntegTools/dbTools
-* ./installCDE -s /path/to/cdesktopenv-code/cde
+    cd /path/to/cdesktopenv-code/cde/admin/IntegTools/dbTools
+    ./installCDE -s /path/to/cdesktopenv-code/cde
+
 


-## 4) Close logfile ##
-
-* Type "exit"
-* /tmp/log.txt should contain recording of all actions in the terminal.
-

-
-## 5) Start CDE ##
+# Start CDE

 Disable gdm graphical login as root:

-* svcadm disable svc:/application/graphical-login/gdm
+    svcadm disable svc:/application/graphical-login/gdm

 You can now start CDE login manager:

-* /usr/dt/bin/dtlogin
+    /usr/dt/bin/dtlogin -daemon

 Alternatively, you can start an X session as a normal user:

-* env LANG=C startx /usr/dt/bin/Xsession
+   startx /usr/dt/bin/Xsession
+
 


-## 6) Known Issues ##
+# 6) Known Issues

 The screen freezes when a user clicks in an inactive window. It can be avoided by using
 KEYBOARD_FOCUS_POINTER mode. This mode is default on Solaris based systems.
+
+(Editor's note: Is this still a problem?)
+
 


-## 7) Reporting problems
-
-Please check if your logfile (/tmp/log.txt) does not contain sensitive information and feel free
-to send it to us.
-

-

OpenIndianaBuild modified by Ulrich Wilkens

Ulrich Wilkens — Wed, 29 Oct 2014 01:53:26 -0000