README-builds.html
changeset 3793 9cc5500d129d
parent 3668 63ba8c868f73
child 4084 ccac5c36a11c
equal deleted inserted replaced
3792:70d5ef4d28c5 3793:9cc5500d129d
    36         <h2><a name="contents">Contents</a></h2>
    36         <h2><a name="contents">Contents</a></h2>
    37         <blockquote>
    37         <blockquote>
    38             <ul>
    38             <ul>
    39                 <li><a href="#introduction">Introduction</a></li>
    39                 <li><a href="#introduction">Introduction</a></li>
    40                 <li><a href="#MBE">Minimum Build Environments</a></li>
    40                 <li><a href="#MBE">Minimum Build Environments</a></li>
    41                 <li><a href="#SDBE">Specific Developer Build Environments</a></li>
    41                 <li><a href="#SDBE">Specific Developer Build Environments</a>
    42                     <ul>
    42                     <ul>
    43                         <li><a href="#fedora">Fedora Linux</a> </li>
    43                         <li><a href="#fedora">Fedora Linux</a> </li>
    44                         <li><a href="#centos">CentOS Linux</a> </li>
    44                         <li><a href="#centos">CentOS Linux</a> </li>
    45                         <li><a href="#ubuntu">Ubuntu Linux</a> </li>
    45 		        <li><a href="#debian">Debian GNU/Linux</a></li>
       
    46 			<li><a href="#ubuntu">Ubuntu Linux</a> </li>
       
    47 		        <li><a href="#opensuse">OpenSUSE</a></li>
       
    48 		        <li><a href="#mandriva">Mandriva</a></li>
       
    49 		        <li><a href="#opensolaris">OpenSolaris</a></li>
    46                     </ul>
    50                     </ul>
       
    51 		</li>
    47                 <li><a href="#directories">Source Directory Structure</a> </li>
    52                 <li><a href="#directories">Source Directory Structure</a> </li>
    48                 <li><a href="#building">Build Information</a>
    53                 <li><a href="#building">Build Information</a>
    49                     <ul>
    54                     <ul>
    50                         <li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li>
    55                         <li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li>
    51                         <li><a href="#linux">Basic Linux System Setup</a> </li>
    56                         <li><a href="#linux">Basic Linux System Setup</a> </li>
   207         <blockquote>
   212         <blockquote>
   208             We won't be listing all the possible environments, but
   213             We won't be listing all the possible environments, but
   209             we will try to provide what information we have available to us.
   214             we will try to provide what information we have available to us.
   210         </blockquote>
   215         </blockquote>
   211         <!-- ------------------------------------------------------ -->
   216         <!-- ------------------------------------------------------ -->
   212         <h3><a name="fedora">Fedora 9</a></h3>
   217         <h3><a name="fedora">Fedora</a></h3>
   213         <blockquote>
   218         <blockquote>
   214             After installing
   219 	  <h4>Fedora 9</h4>
   215             <a href="http://www.fedoraproject.org/">Fedora 9</a>
   220 	  <p>
   216             you need to make sure you have
   221 	    <blockquote>
   217             the "Software Development" bundle installed, plus the
   222               After installing <a href="http://fedoraproject.org">Fedora</a> 9 
   218             following packages:
   223 	      you need to install several build dependencies. The simplest
   219             <blockquote>
   224 	      way to do it is to execute the following commands as user 
   220                 <ul>
   225 	      <tt>root</tt>:
   221                     <li>cups devel: Cups Development Package</li>
   226 	      <p/>
   222                     <li>freetype 2.3+ devel: Freetype 2.3 Development Package</li>
   227 	      <code>yum-builddep java-openjdk</code>
   223                     <li>hg: Mercurial, if you need to clone or manage source repositories</li>
   228 	      <p/>
   224                     <li>ksh: May be needed when using <tt>webrev</tt></li>
   229 	      <code>yum install gcc gcc-c++</code>
   225                 </ul>
   230 	      <p/>
   226             </blockquote>
   231 	      In addition, it's necessary to set a few environment variables for the build:
   227             <p>
   232 
   228             Always a good idea to do a complete Software Update/Refresh
   233 	      <p/>
   229             after you get all the packages installed.
   234 	      <code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-openjdk</code>
       
   235             </blockquote>
       
   236 	  <h4>Fedora 10</h4>
       
   237 	  <p>
       
   238 	    <blockquote>
       
   239               After installing <a href="http://fedoraproject.org">Fedora</a> 10 
       
   240 	      you need to install several build dependencies. The simplest
       
   241 	      way to do it is to execute the following commands as user 
       
   242 	      <tt>root</tt>:
       
   243 	      <p/>
       
   244 	      <code>yum-builddep java-1.6.0-openjdk</code>
       
   245 	      <p/>
       
   246 	      <code>yum install gcc gcc-c++</code>
       
   247 	      <p/>
       
   248 	      In addition, it's necessary to set a few environment variables for the build:
       
   249 
       
   250 	      <p/>
       
   251 	      <code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-openjdk</code>
       
   252             </blockquote>
       
   253 	  <h4>Fedora 11</h4>
       
   254 	  <p>
       
   255 	    <blockquote>
       
   256               After installing <a href="http://fedoraproject.org">Fedora</a> 11 
       
   257 	      you need to install several build dependencies. The simplest
       
   258 	      way to do it is to execute the following commands as user 
       
   259 	      <tt>root</tt>:
       
   260 	      <p/>
       
   261 	      <code>yum-builddep java-1.6.0-openjdk</code>
       
   262 	      <p/>
       
   263 	      <code>yum install gcc gcc-c++</code>
       
   264 	      <p/>
       
   265 	      In addition, it's necessary to set a few environment variables for the build:
       
   266 
       
   267 	      <p/>
       
   268 	      <code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-openjdk</code>
       
   269              </blockquote>
   230         </blockquote>
   270         </blockquote>
   231         <!-- ------------------------------------------------------ -->
   271         <!-- ------------------------------------------------------ -->
   232         <h3><a name="centos">CentOS 5.2</a></h3>
   272         <h3><a name="centos">CentOS 5.2</a></h3>
   233         <blockquote>
   273         <blockquote>
   234             After installing
   274             After installing
   267             Mercurial packages could not be found easily, but a Google
   307             Mercurial packages could not be found easily, but a Google
   268             search should find ones, and they usually include Python if
   308             search should find ones, and they usually include Python if
   269             it's needed.
   309             it's needed.
   270         </blockquote>
   310         </blockquote>
   271         <!-- ------------------------------------------------------ -->
   311         <!-- ------------------------------------------------------ -->
   272         <h3><a name="ubuntu">Ubuntu</a></h3>
   312         <h3><a name="debian">Debian</a></h3>
   273         <blockquote>
   313         <blockquote>
   274             In addition to needing the Bootstrap JDK and the Binary Plugs, 
   314             <h4>Debian 5.0 (Lenny)</h4>
   275             when building on Ubuntu you will need to
   315             <p>
   276             make sure certain packages are installed.
   316 	      <blockquote>
   277             In particular, certain X11 packages, make, m4, gawk, gcc 4, 
   317 		After installing <a href="http://debian.org">Debian</a> 5 
   278             binutils, cups, freetype
   318 		you need to install several build dependencies. 
   279             and alsa.
   319 		The simplest way to install the build dependencies is to 
   280             <!-- ------------------------------------------------------ -->
   320 		execute the following commands as user <tt>root</tt>:
   281             <h4>Ubuntu 6.06</h4>
   321 		<p/>
   282             <p>
   322 		<code>aptitude build-dep openjdk-6</code>
   283             The following list of packages for Ubuntu 6.06 is a working set that
   323 		<p/>
   284             does appear to work. 
   324 		<code>aptitude install openjdk-6-jdk libmotif-dev</code>
   285             <p>
   325 		<p/>
   286             <b>Note that it's quite possible that some of these
   326 		In addition, it's necessary to set a few environment variables for the build:
   287                 packages are not required, so anyone discovering that some of the
   327 		<p/>
   288                 packages listed below are NOT required,
   328 		<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
   289                 please let the
   329 	      </blockquote>
   290                 OpenJDK
   330         </blockquote>
   291             team know.</b>
   331         <!-- ====================================================== -->
   292             <p>
   332 	<h3><a name="ubuntu">Ubuntu</a></h3>
   293             All the packages below can be installed with the
   333         <blockquote>
   294             Synaptic Package manager provided with the base Ubuntu 6.06 release.
   334             <h4>Ubuntu 8.04</h4>
   295             <blockquote>
   335             <p>
   296                 <ul>
   336 	      <blockquote>
   297                     <li>binutils (2.16.1cvs20060117-1ubuntu2.1)</li>
   337 		After installing <a href="http://ubuntu.org">Ubuntu</a> 8.04 
   298                     <li>cpp (4:4.0.3-1)</li>
   338 		you need to install several build dependencies. 
   299                     <li>cpp-4.0 (4.0.3-1ubuntu5)</li>
   339 		<p/>
   300                     <li>libfreetype6-dev</li>
   340 		First, you need to enable the universe repository in the 
   301                     <li>g++ (4:4.0.3-1)</li>
   341 		Software Sources application and reload the repository 
   302                     <li>g++-4.0 (4.0.3-1ubuntu5)</li>
   342 		information. The Software Sources application is available 
   303                     <li>gawk (1:3.1.5-2build1)</li>
   343 		under the System/Administration menu. 
   304                     <li>gcc (4:4.0.3-1)</li>
   344 		<p/>
   305                     <li>gcc-4.0 (4.0.3-1ubuntu5)</li>
   345 		The simplest way to install the build dependencies is to 
   306                     <li>libasound2-dev (1.0.10-2ubuntu4)</li>
   346 		execute the following commands:
   307                     <li>libc6 (2.3.6-0ubuntu20) to 2.3.6-0ubuntu20.4</li>
   347 		<p/>
   308                     <li>libc6-dev (2.3.6-0ubuntu20.4)</li>
   348 		<code>sudo aptitude build-dep openjdk-6</code>
   309                     <li>libc6-i686 (2.3.6-0ubuntu20) to 2.3.6-0ubuntu20.4</li>
   349 		<p/>
   310                     <li>libcupsys2-dev (1.2.2-0ubuntu0.6.06)</li>
   350 		<code>sudo aptitude install openjdk-6-jdk</code>
   311                     <li>libgcrypt11-dev (1.2.2-1)</li>
   351 		<p/>
   312                     <li>libgnutls-dev (1.2.9-2ubuntu1.1)</li>
   352 		In addition, it's necessary to set a few environment variables for the build:
   313                     <li>libgnutls12 (1.2.9-2ubuntu1) to 1.2.9-2ubuntu1.1</li>
   353 		<p/>
   314                     <li>libgpg-error-dev (1.1-4)</li>
   354 		<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
   315                     <li>libice-dev (2:1.0.0-0ubuntu2)</li>
   355               </blockquote>
   316                     <li>liblockfile1 (1.06.1)</li>
   356            <h4>Ubuntu 8.10</h4>
   317                     <li>libopencdk8-dev (0.5.7-2)</li>
   357             <p>
   318                     <li>libpopt-dev (1.7-5)</li>
   358 	      <blockquote>
   319                     <li>libsm-dev (2:1.0.0-0ubuntu2)</li>
   359 		After installing <a href="http://ubuntu.org">Ubuntu</a> 8.10 
   320                     <li>libstdc++6-4.0-dev (4.0.3-1ubuntu5)</li>
   360 		you need to install several build dependencies. The simplest
   321                     <li>libtasn1-2-dev (0.2.17-1ubuntu1)</li>
   361 		way to do it is to execute the following commands:
   322                     <li>libx11-dev (2:1.0.0-0ubuntu9)</li>
   362 		<p/>
   323                     <li>libxau-dev (1:1.0.0-0ubuntu4)</li>
   363 		<code>sudo aptitude build-dep openjdk-6</code>
   324                     <li>libxaw-headers (2:1.0.1-0ubuntu3)</li>
   364 		<p/>
   325                     <li>libxaw7-dev (2:1.0.1-0ubuntu3)</li>
   365 		<code>sudo aptitude install openjdk-6-jdk</code>
   326                     <li>libxdmcp-dev (1:1.0.0-0ubuntu2)</li>
   366 		<p/>
   327                     <li>libxext-dev (2:1.0.0-0ubuntu4)</li>
   367 		In addition, it's necessary to set a few environment variables for the build:
   328                     <li>libxi-dev (2:1.0.0-0ubuntu3) </li>
   368 		<p/>
   329                     <li>libxmu-dev (2:1.0.0-0ubuntu3)</li>
   369 		<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
   330                     <li>libxmu-headers (2:1.0.0-0ubuntu3)</li>
   370              </blockquote>
   331                     <li>libxmuu-dev (2:1.0.0-0ubuntu3)</li>
   371            <h4>Ubuntu 9.04</h4>
   332                     <li>libxp-dev (6.8.2-11ubuntu2)</li>
   372             <p>
   333                     <li>libxpm-dev (1:3.5.4.2-0ubuntu3)</li>
   373 	      <blockquote>
   334                     <li>libxrandr-dev (1:1.1.0.2-0ubuntu4)</li>
   374 		After installing <a href="http://ubuntu.org">Ubuntu</a> 9.04 
   335                     <li>libxt-dev (1:1.0.0-0ubuntu3)</li>
   375 		you need to install several build dependencies. The simplest
   336                     <li>libxtrap-dev (2:1.0.0-0ubuntu2)</li>
   376 		way to do it is to execute the following commands:
   337                     <li>libxtst-dev (2:1.0.1-0ubuntu2)</li>
   377 		<p/>
   338                     <li>libxv-dev (2:1.0.1-0ubuntu3)</li>
   378 		<code>sudo aptitude build-dep openjdk-6</code>
   339                     <li>linux-kernel-headers (2.6.11.2-0ubuntu18)</li>
   379 		<p/>
   340                     <li>m4 (1.4.4-1)</li>
   380 		<code>sudo aptitude install openjdk-6-jdk</code>
   341                     <li>make (3.80+3.81.b4-1)</li>
   381 		<p/>
   342                     <li>ssl-cert (1.0.13)</li>
   382 		In addition, it's necessary to set a few environment variables for the build:
   343                     <li>x-dev (7.0.4-0ubuntu2)</li>
   383 		<p/>
   344                     <li>x11proto-core-dev (7.0.4-0ubuntu2)</li>
   384 		<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
   345                     <li>x11proto-input-dev (1.3.2-0ubuntu2)</li>
   385              </blockquote>
   346                     <li>x11proto-kb-dev (1.0.2-0ubuntu2)</li>
   386         </blockquote>
   347                     <li>x11proto-randr-dev (1.1.2-0ubuntu2)</li>
   387         <!-- ====================================================== -->
   348                     <li>x11proto-record-dev (1.13.2-0ubuntu2)</li>
   388         <h3><a name="opensuse">OpenSUSE</a></h3>
   349                     <li>x11proto-trap-dev (3.4.3-0ubuntu2)</li>
   389         <blockquote>
   350                     <li>x11proto-video-dev (2.2.2-0ubuntu2)</li>
   390             <h4>OpenSUSE 11.1</h4>
   351                     <li>x11proto-xext-dev (7.0.2-0ubuntu2)</li>
   391             <p>
   352                     <li>xlibs-dev (7.0.0-0ubuntu45)</li>
   392 	      <blockquote>
   353                     <li>zlib1g-dev (1:1.2.3-6ubuntu4)</li>
   393 		After installing <a href="http://opensuse.org">OpenSUSE</a> 11.1 
   354                 </ul>
   394 		you need to install several build dependencies. 
   355             </blockquote>
   395 		The simplest way to install the build dependencies is to 
   356             <!-- ------------------------------------------------------ -->
   396 		execute the following commands:
   357             <h4>Ubuntu 7.04</h4>
   397 		<p/>
   358             <p>
   398 		<code>sudo zypper source-install -d java-1_6_0-openjdk</code>
   359             Using the Synaptic Package Manager, download the following
   399 		<p/>
   360             packages (double indented packages are automatically aquired
   400 		<code>sudo zypper install make</code>
   361             due to package dependencies):
   401 		<p/>
   362             <blockquote>
   402 		In addition, it is necessary to set a few environment variables for the build:
   363                 <ul>
   403 		<p/>
   364                     <li>build-essential</li>
   404 		<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-1.6.0-openjdk</code>
   365                     <ul>
   405 		<p/>
   366                         <li>dpkg-dev</li>
   406 		Finally, you need to unset the <code>JAVA_HOME</code> environment variable:
   367                         <li>g++</li>
   407 		<p/>
   368                         <li>g++-4.1</li>
   408 		<code>export -n JAVA_HOME</code>
   369                         <li>libc6-dev</li>
   409 	      </blockquote>
   370                         <li>libstdc++6.4.1-dev</li>
   410 	</blockquote>
   371                         <li>linux-libc-dev</li>
   411         <!-- ====================================================== -->
   372                     </ul>
   412         <h3><a name="mandriva">Mandriva</a></h3>
   373                     <li>gawk</li>
   413         <blockquote>
   374                     <li>m4</li>
   414             <h4>Mandriva Linux One 2009 Spring</h4>
   375                     <li>libasound2-dev</li>
   415             <p>
   376                     <li>libcupsys2-dev</li>
   416 	      <blockquote>
   377                     <ul>
   417 		After installing <a href="http://mandriva.org">Mandriva</a> Linux One 2009 Spring 
   378                         <li>libgcrypt11-dev</li>
   418 		you need to install several build dependencies. 
   379                         <li>lgnutls-dev</li>
   419 		The simplest way to install the build dependencies is to 
   380                         <li>libgpg-error-dev</li>
   420 		execute the following commands as user <tt>root</tt>:
   381                         <li>liblzo-dev</li>
   421 		<p/>
   382                         <li>libopencdk8-dev</li>
   422 		<code>urpmi java-1.6.0-openjdk-devel ant make gcc gcc-c++ freetype-devel zip unzip libcups2-devel libxrender1-devel libalsa2-devel libstc++-static-devel libxtst6-devel libxi-devel</code>
   383                         <li>libpopt-dev</li>
   423                 <p/>
   384                         <li>libtasn1-3-dev</li>
   424 		In addition, it is necessary to set a few environment variables for the build:
   385                         <li>zlib1g-dev</li>
   425 		<p/>
   386                     </ul>
   426 		<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-1.6.0-openjdk</code>
   387                     <li>sun-java6-jdk</li>
   427 	      </blockquote>
   388                     <ul>
   428         </blockquote>
   389                         <li>java-common</li>
   429         <!-- ====================================================== -->
   390                         <li>libltdl3</li>
   430         <h3><a name="opensolaris">OpenSolaris</a></h3>
   391                         <li>odbcinst1debian1</li>
   431         <blockquote>
   392                         <li>sun-java6-bin</li>
   432             <h4>OpenSolaris 2009.06</h4>
   393                         <li>sun-java6-jre</li>
   433             <p>
   394                         <li>unixodbc</li>
   434 	      <blockquote>
   395                     </ul>
   435 		After installing <a href="http://opensolaris.org">OpenSolaris</a> 2009.06 
   396                     <li>xlibs-dev</li>
   436 		you need to install several build dependencies. 
   397                     <ul>
   437 		The simplest way to install the build dependencies is to 
   398                         <li>(many)</li>
   438 		execute the following commands:
   399                     </ul>
   439 		<p/>
   400                     <li>x11proto-print-dev</li>
   440 		<code>pfexec pkg install SUNWgmake SUNWj6dev SUNWant sunstudioexpress SUNWcups SUNWzip SUNWunzip SUNWxwhl SUNWxorg-headers SUNWaudh SUNWfreetype2</code>
   401                     <li>libxaw7-dev</li>
   441                 <p/>
   402                     <ul>
   442 		In addition, it is necessary to set a few environment variables for the build:
   403                         <li>libxaw-headers</li>
   443 		<p/>
   404                     </ul>
   444 		<code>export LANG=C ALT_COMPILER_PATH=/opt/SunStudioExpress/bin/ ALT_CUPS_HEADERS_PATH=/usr/include/</code>
   405                     <li>libxp-dev</li>
   445 		<p/>
   406                     <li>libfreetype6-dev</li>
   446 		Finally, you need to make sure that the build process can find the Sun Studio compilers:
   407                 </ul>
   447 		<p/>
   408             </blockquote>
   448 		<code>export PATH=$PATH:/opt/SunStudioExpress/bin/</code>
   409         </blockquote>
   449 	      </blockquote>
   410         <!-- ------------------------------------------------------ -->
   450         </blockquote>
       
   451         <!-- ------------------------------------------------------ -->  
   411         <hr>
   452         <hr>
   412         <h2><a name="directories">Source Directory Structure</a></h2>
   453         <h2><a name="directories">Source Directory Structure</a></h2>
   413         <blockquote>
   454         <blockquote>
   414             <p>
   455             <p>
   415             The source code for the OpenJDK is delivered in a set of
   456             The source code for the OpenJDK is delivered in a set of