Wiki code for Installation (from source) Quickstart

Hide Line numbers
1: {{{
2: [begin README tag - do not delete]
3: 
4: Once you have downloaded the tarballs that you need, here are the
5: steps to build the sources.
6: 
7: Suppose you are using /export/testws as your workspace.
8: 
9: 1. cd to /export/testws and unpack the sources and encumbered
10:    binaries, e.g.,
11: 
12:     $ bzcat on-src-DATE.tar.bz2 | tar xf -
13:     $ bzcat on-closed-bins-DATE.PLATFORM.tar.bz2 | tar xf -
14: 
15:    The sources will unpack into "usr/src" and the binaries will unpack
16:    into "closed/root_PLATFORM" (i.e., closed/root_i386 or
17:    closed/root_sparc).
18: 
19: 2. Install the compiler according to the instructions at the download
20:    site.  (Of course, if the compilers have not changed since you last
21:    installed them, there is no need to install them again.)  The result
22:    should have the compilers installed in /opt/SUNWspro.
23: 
24:    Please note that the compiler that comes with the Solaris Developer
25:    Express release is Studio 12, which is not the standard compiler
26:    for OpenSolaris code.  If you use Studio 12, you will need to set
27:    __SSNEXT to the null string in your environment file.  Please do
28:    report problems with Studio 12, particularly if the problem goes
29:    away when you use Studio 11 (the current standard compiler).
30: 
31:    If you already have the Studio 11 compiler installed, you can use
32:    it, provided you have the following patches installed:
33: 
34:      SPARC:
35:      120760-07 Sun Studio 11: Compiler Common patch for Sun C C++ F77 F95
36:      121017-02 Sun Studio 11: Patch for Sun C++ 5.8 compiler
37:      121021-02 Sun Studio 11: Patch for Fortran 95 Dynamic Libraries
38:      121019-02 Sun Studio 11: Patch for Fortran 95 8.2 Compiler
39:      121015-02 Sun Studio 11: Patch for Sun C 5.8 compiler
40: 
41:      x86:
42:      120759-06 Sun Studio 11_x86: Sun Compiler Common patch for x86 backend
43:      121016-02 Sun Studio 11_x86: Patch for Sun C_x86 5.8 Compiler
44:      121018-02 Sun Studio 11_x86: Patch for Sun C++ 5.8 compiler
45: 
46:    You may find it easier to install the Studio 11 compilers using the
47:    tarballs, rather than installing them as packages.
48: 
49: 3a. Remove the existing onbld tools, if any.
50: 
51:    - If this is the first time you are installing build tools, skip ahead
52:      to step 3b.
53: 
54:    - Otherwise, use pkgrm(1M) to remove the old package.
55: 
56: 3b. Install the current onbld tools.
57: 
58:    - The SUNWonbld package is a pkgadd-format directory that has been
59:      archived using tar and bzip2.  Unpack it in a temporary directory and
60:      use pkgadd(1M) to install it.  For example:
61: 
62:         # cd /var/tmp
63:         # bzip2 -dc /path/to/SUNWonbld-DATE.PLATFORM.tar.bz2 | tar xf -
64:         # pkgadd -d onbld SUNWonbld
65: 
66: 4. Update your environment and login dot-files if this is the first
67:    time you have installed the compiler and/or build tools.
68: 
69:    - Add /opt/SUNWspro/bin and /opt/onbld/bin to your $PATH. 
70:    - Either remove /usr/ucb from your $PATH, or put it at the end.
71: 
72: 5. Create an environment file to guide tools like nightly(1) and
73:    bldenv(1).  
74: 
75:    - copy /export/testws/usr/src/tools/env/opensolaris.sh to
76:      /export/testws.  It doesn’t have to go in /export/testws, but
77:      that’s a convenient place to put it.  Nor do you have to keep the
78:      name opensolaris.sh, but that’s the name we’ll use in these notes.
79: 
80:      Then make the following changes in your opensolaris.sh:
81: 
82:    - change GATE to the name of the top-level directory (e.g.,
83:      "testws").
84: 
85:    - change CODEMGR_WS to the top-level path (e.g., "/export/testws").
86: 
87:    - change STAFFER to your login.
88: 
89:    - (optional) customize VERSION.  This is the string that "uname -v"
90:      will print.
91: 
92: 6. To build a complete set of archives, cd to /export/testws, utter
93: 
94:     nightly ./opensolaris.sh &
95: 
96:    and find something else to work on for a few hours.  You can
97:    monitor the build’s progress using ptree(1).  nightly(1) will send
98:    mail to $MAILTO when it has finished.  
99: 
100:    The results mail from nightly(1) will have an overview of the build
101:    results.  A copy of the mail text and a more detailed log file will
102:    be available in the workspace (/export/testws/log/log.YYYY-MM-DD.HH:MM).
103:    Pieces of the detailed log are also available under usr/src.  For
104:    example, usr/src/install-i386.out will have the log from the x86
105:    "make install" part of the build.
106: 
107:    By default nightly(1) will do a "clobber" build, which includes a
108:    "make clobber" and blowing away any files that earlier builds
109:    installed into $ROOT (/export/testws/proto/root_PLATFORM).  To
110:    bypass these steps, do an incremental build with "nightly -i
111:    ./opensolaris.sh &".
112: 
113: 7. To build a specific component, first use bldenv(1) to set up
114:    various environment variables, then cd to the subtree that you want
115:    to build.  For example:
116: 
117:     $ cd /export/testws
118:     $ bldenv -d ./opensolaris.sh
119:     [status information from bldenv]
120:     $ cd usr/src/cmd/vi
121:     $ dmake all
122: 
123:    To build the kernel, run dmake(1) from usr/src/uts.
124: 
125: If you encounter errors, try running with a clean environment:
126: $ env - HOME=$HOME SHELL=$SHELL DISPLAY=$DISPLAY XAUTHORITY=$XAUTHORITY TERM=$TERM LOGNAME=$LOGNAME LANG=C LC_ALL=C PAGER=less MANPATH=$MANPATH /opt/onbld/bin/bldenv ./opensolaris.sh
127: 
128: Please see the Developer’s Reference for information on how to install
129: kernels (using Install(1)) and archives (using BFU).
130: 
131: [end README tag - do not delete]
132: }}}
OpenSolaris

Top Menu

Wiki code for Installation (from source) Quickstart

Search

Collectives

Community Group

Project

User Group

Subsites

Community Group on Pages
