Using OS-X as a developement platform - Revision history

Ndp: /* Building and Installing Software */

2007-06-28T02:02:02Z

Building and Installing Software

← Older revision		Revision as of 02:02, 28 June 2007
Line 14:		Line 14:
	# '''Test the software.''' In the same ''terminal'' run the command: <br><font style="font-family:courier">    make check</font>		# '''Test the software.''' In the same ''terminal'' run the command: <br><font style="font-family:courier">    make check</font>
	# '''Install the software.''' In the same ''terminal'' run the command: <br><font style="font-family:courier">    sudo make install</font><br> This command installs the software using the ''root'' or ''superuser'' shell (via the ''sudo'' command). You will be prompted for your password. If you do not have administrator privleges on you OS-X system then, well... Get Them.		# '''Install the software.''' In the same ''terminal'' run the command: <br><font style="font-family:courier">    sudo make install</font><br> This command installs the software using the ''root'' or ''superuser'' shell (via the ''sudo'' command). You will be prompted for your password. If you do not have administrator privleges on you OS-X system then, well... Get Them.
	# '''Adjust Your Path''' Most of these packages install themselves into ''/usr/local'' you will need to modify your ''path'' environment variables to ensure that ''/usr/local/bin'' appears on your path before other things (like ''/usr/bin''). You can do this by modifying the "dot" files for your shell in your home directory (For '''bash''' (the default shell for OS-X) that's ''.profile'') You may also wish to edit the path variable in the OS-X environment plist. This an be accomplished by issuing the command: <br><font style="font-family:courier">     open ~/.MacOSX/environment.plist </font><br>In a ''terminal''. This will open the PlistEditor ~~adnfrom~~ there you're on your own.		# '''Adjust Your Path''' Most of these packages install themselves into ''/usr/local'' you will need to modify your ''path'' environment variables to ensure that ''/usr/local/bin'' appears on your path before other things (like ''/usr/bin''). You can do this by modifying the "dot" files for your shell in your home directory (For '''bash''', the default shell for OS-X, that's ''.profile'') You may also wish to edit the path variable in the OS-X environment plist. This can be accomplished by issuing the command: <br><font style="font-family:courier">     open ~/.MacOSX/environment.plist </font><br>In a ''terminal''. This will open the PlistEditor and from there you're on your own.
	# '''Fini''' At this point the software package should be installed.		# '''Fini''' At this point the software package should be installed.



	=libdap core development=		=libdap core development=

Ndp at 02:00, 28 June 2007

2007-06-28T02:00:49Z

← Older revision		Revision as of 02:00, 28 June 2007
Line 14:		Line 14:
	# '''Test the software.''' In the same ''terminal'' run the command: <br><font style="font-family:courier">    make check</font>		# '''Test the software.''' In the same ''terminal'' run the command: <br><font style="font-family:courier">    make check</font>
	# '''Install the software.''' In the same ''terminal'' run the command: <br><font style="font-family:courier">    sudo make install</font><br> This command installs the software using the ''root'' or ''superuser'' shell (via the ''sudo'' command). You will be prompted for your password. If you do not have administrator privleges on you OS-X system then, well... Get Them.		# '''Install the software.''' In the same ''terminal'' run the command: <br><font style="font-family:courier">    sudo make install</font><br> This command installs the software using the ''root'' or ''superuser'' shell (via the ''sudo'' command). You will be prompted for your password. If you do not have administrator privleges on you OS-X system then, well... Get Them.
			# '''Adjust Your Path''' Most of these packages install themselves into ''/usr/local'' you will need to modify your ''path'' environment variables to ensure that ''/usr/local/bin'' appears on your path before other things (like ''/usr/bin''). You can do this by modifying the "dot" files for your shell in your home directory (For '''bash''' (the default shell for OS-X) that's ''.profile'') You may also wish to edit the path variable in the OS-X environment plist. This an be accomplished by issuing the command: <br><font style="font-family:courier">     open ~/.MacOSX/environment.plist </font><br>In a ''terminal''. This will open the PlistEditor adnfrom there you're on your own.
	# '''Fini''' At this point the software package should be installed.		# '''Fini''' At this point the software package should be installed.

Line 66:		Line 67:


			=Additional Software Packages=
			There are several addtional software packages that you will need if you wish to work with different OPeNDAP componets. Since the Hyrax server has handlers for HDF4, HDF5, and NetCDF datatypes you will need to install those libraries in order to work with the handlers.

	=HDF4=		==[http://hdf.ncsa.uiuc.edu/hdf4.html HDF4]==
	''(This discussion is based on the HDF4.2r1 release)''		''(This discussion is based on the HDF4.2r1 release)''

Line 90:		Line 93:


	=NetCDF=		==[http://www.unidata.ucar.edu/software/netcdf/ NetCDF]==

	In order to build and use the [http://scm.opendap.org:8090/svn/trunk/netcdf_handler/ netcdf_handler] package used by the BES you will need to download and install the NetCDF libraries from our friends at [http://www.unidata.ucar.edu/software/netcdf/ Unidata NetCDF project]		In order to build and use the [http://scm.opendap.org:8090/svn/trunk/netcdf_handler/ netcdf_handler] package used by the BES you will need to download and install the NetCDF libraries from our friends at [http://www.unidata.ucar.edu/software/netcdf/ Unidata NetCDF project]
Line 98:		Line 101:
	'''''Recommended''''': NetCDF 3.6.2		'''''Recommended''''': NetCDF 3.6.2

			==[http://hdf.ncsa.uiuc.edu/HDF5/ HDF5]==
			In order to build and use the [http://scm.opendap.org:8090/svn/trunk/hdf5_handler/ hdf5_handler] package used by the BES you will need to download and install the HDF5 libraries from the [http://hdf.ncsa.uiuc.edu/HDF5/ HDF5 project].

	=GNU tar=		'''''Minimum''''': HDF5 1.6.5

			'''''Recommended''''': HDF5 1.6.5

			If you have '''already''' installed the HDF4 package then the installation is straight forward.

			Otherwise you will need to:
			# '''szip''': Download, unpack, configure, build, test, and install the szip package.<br><br>
			# '''zlib''': Download, unpack, configure, build, test, and install the zlib package.<br><br>
			# '''HDF5''': Download, unpack, configure, build, test, and install the HDF 5 package.<br><br>


			==[http://www.gnu.org/software/tar/ GNU tar]==

			You may or may not find that there are issues with the ''tar'' program supplied with OS-X. IF you suspect that there is a problem go get the latest from GNU: http://www.gnu.org/software/tar/ build and install it. (Make sure it's on your path before the old one!!)

Ndp: /* NetCDF */

2007-06-28T01:10:06Z

NetCDF

← Older revision		Revision as of 01:10, 28 June 2007
Line 92:		Line 92:
	=NetCDF=		=NetCDF=

	In order to build and use the [http://scm.opendap.org:8090/svn/trunk/netcdf_handler/ netcdf_handler] package used by the BES you will need to download and install the ~~NEtCDF~~ libraries from or friends at [http://www.unidata.ucar.edu/software/netcdf/ Unidata NetCDF project]		In order to build and use the [http://scm.opendap.org:8090/svn/trunk/netcdf_handler/ netcdf_handler] package used by the BES you will need to download and install the NetCDF libraries from our friends at [http://www.unidata.ucar.edu/software/netcdf/ Unidata NetCDF project]

	'''''Minimum''''': NetCDF 3.6.0-p1		'''''Minimum''''': NetCDF 3.6.0-p1

	'''''Recommended''''': NetCDF 3.6.2		'''''Recommended''''': NetCDF 3.6.2


			=GNU tar=

Ndp at 01:07, 28 June 2007

2007-06-28T01:07:18Z

← Older revision		Revision as of 01:07, 28 June 2007
Line 87:		Line 87:
	## Test it using the command:<br><font style="font-family:courier">    make check</font>		## Test it using the command:<br><font style="font-family:courier">    make check</font>
	## Install it using the command:<br><font style="font-family:courier">    sudo make install</font>		## Install it using the command:<br><font style="font-family:courier">    sudo make install</font>



	=NetCDF=		=NetCDF=

	In order to build and use the [http://scm.opendap.org:8090/svn/trunk/netcdf_handler/ netcdf_handler] package used by the BES you will need to download and install the NEtCDF libraries from or friends at [http://www.unidata.ucar.edu/software/netcdf/ Unidata NetCDF project]		In order to build and use the [http://scm.opendap.org:8090/svn/trunk/netcdf_handler/ netcdf_handler] package used by the BES you will need to download and install the NEtCDF libraries from or friends at [http://www.unidata.ucar.edu/software/netcdf/ Unidata NetCDF project]

			'''''Minimum''''': NetCDF 3.6.0-p1

			'''''Recommended''''': NetCDF 3.6.2

Ndp: /* NetCDF */

2007-06-28T01:05:24Z

NetCDF

← Older revision		Revision as of 01:05, 28 June 2007
Line 89:		Line 89:

	=NetCDF=		=NetCDF=
	~~In order to work with the netcdf_handler~~

	http://www.unidata.ucar.edu/software/netcdf/		In order to build and use the [http://scm.opendap.org:8090/svn/trunk/netcdf_handler/ netcdf_handler] package used by the BES you will need to download and install the NEtCDF libraries from or friends at [http://www.unidata.ucar.edu/software/netcdf/ Unidata NetCDF project]

Ndp: /* NetCDF */

2007-06-28T01:02:31Z

NetCDF

← Older revision		Revision as of 01:02, 28 June 2007
Line 89:		Line 89:

	=NetCDF=		=NetCDF=
			In order to work with the netcdf_handler

			http://www.unidata.ucar.edu/software/netcdf/

Ndp: /* HDF4 */

2007-06-28T00:57:07Z

HDF4

← Older revision		Revision as of 00:57, 28 June 2007
Line 76:		Line 76:
	You will need to Unpack, configure, build, test, and install each software component as described above.		You will need to Unpack, configure, build, test, and install each software component as described above.

	# '''szip''': Download, unpack, configure, build, test, and install the szip package.		# '''szip''': Download, unpack, configure, build, test, and install the szip package.<br><br>
	# '''zlib''': Download, unpack, configure, build, test, and install the zlib package.		# '''zlib''': Download, unpack, configure, build, test, and install the zlib package.<br><br>
	# '''jpeg''': Download, unpack, configure, build, test, and install the jpeg package. <br>Once it's installed you will need to perform the following additional steps:		# '''jpeg''': Download, unpack, configure, build, test, and install the jpeg package. <br>Once it's installed you will need to perform the following additional steps:
	## Copy the jpeg library to ''/usr/local/lib'' with the command:<br><font style="font-family:courier">    sudo cp libjpeg.a /usr/local/lib</font>		## Copy the jpeg library to ''/usr/local/lib'' with the command:<br><font style="font-family:courier">    sudo cp libjpeg.a /usr/local/lib</font>

Ndp: /* HDF4 */

2007-06-28T00:56:35Z

HDF4

← Older revision		Revision as of 00:56, 28 June 2007
Line 81:		Line 81:
	## Copy the jpeg library to ''/usr/local/lib'' with the command:<br><font style="font-family:courier">    sudo cp libjpeg.a /usr/local/lib</font>		## Copy the jpeg library to ''/usr/local/lib'' with the command:<br><font style="font-family:courier">    sudo cp libjpeg.a /usr/local/lib</font>
	## Update the table of contents of archive libraries (to add the new library) with the command:<br><font style="font-family:courier">     sudo ranlib /usr/local/lib/libjpeg.a </font>		## Update the table of contents of archive libraries (to add the new library) with the command:<br><font style="font-family:courier">     sudo ranlib /usr/local/lib/libjpeg.a </font>
	## Copy the required include files to ''/usr/local/include'' with the command:<br><font style="font-family:courier">    sudo cp jerror.h jpeglib.h jconfig.h jmorecfg.h /usr/local/include</font><br>		## Copy the required include files to ''/usr/local/include'' with the command:<br><font style="font-family:courier">    sudo cp jerror.h jpeglib.h jconfig.h jmorecfg.h /usr/local/include</font><br><br>
	# '''HDF4''': After downloading and unpacking the HDF4 software do the following:		# '''HDF4''': After downloading and unpacking the HDF4 software do the following:
	## Configure it using the command:<br><font style="font-family:courier">    ./configure --prefix=/usr/local --disable-fortran</font>		## Configure it using the command:<br><font style="font-family:courier">    ./configure --prefix=/usr/local --disable-fortran</font>

Ndp: /* HDF4 */

2007-06-28T00:56:16Z

HDF4

← Older revision		Revision as of 00:56, 28 June 2007
Line 81:		Line 81:
	## Copy the jpeg library to ''/usr/local/lib'' with the command:<br><font style="font-family:courier">    sudo cp libjpeg.a /usr/local/lib</font>		## Copy the jpeg library to ''/usr/local/lib'' with the command:<br><font style="font-family:courier">    sudo cp libjpeg.a /usr/local/lib</font>
	## Update the table of contents of archive libraries (to add the new library) with the command:<br><font style="font-family:courier">     sudo ranlib /usr/local/lib/libjpeg.a </font>		## Update the table of contents of archive libraries (to add the new library) with the command:<br><font style="font-family:courier">     sudo ranlib /usr/local/lib/libjpeg.a </font>
	## Copy the required include files to ''/usr/local/include'' with the command:<br><font style="font-family:courier">    sudo cp jerror.h jpeglib.h jconfig.h jmorecfg.h /usr/local/include</font>		## Copy the required include files to ''/usr/local/include'' with the command:<br><font style="font-family:courier">    sudo cp jerror.h jpeglib.h jconfig.h jmorecfg.h /usr/local/include</font><br>
	# '''HDF4''': After downloading and unpacking the HDF4 software do the following:		# '''HDF4''': After downloading and unpacking the HDF4 software do the following:
	## Configure it using the command:<br><font style="font-family:courier">    ./configure --prefix=/usr/local --disable-fortran</font>		## Configure it using the command:<br><font style="font-family:courier">    ./configure --prefix=/usr/local --disable-fortran</font>
Line 87:		Line 87:
	## Test it using the command:<br><font style="font-family:courier">    make check</font>		## Test it using the command:<br><font style="font-family:courier">    make check</font>
	## Install it using the command:<br><font style="font-family:courier">    sudo make install</font>		## Install it using the command:<br><font style="font-family:courier">    sudo make install</font>

			=NetCDF=

Ndp: /* HDF4 */

2007-06-28T00:55:12Z

HDF4

← Older revision		Revision as of 00:55, 28 June 2007
Line 83:		Line 83:
	## Copy the required include files to ''/usr/local/include'' with the command:<br><font style="font-family:courier">    sudo cp jerror.h jpeglib.h jconfig.h jmorecfg.h /usr/local/include</font>		## Copy the required include files to ''/usr/local/include'' with the command:<br><font style="font-family:courier">    sudo cp jerror.h jpeglib.h jconfig.h jmorecfg.h /usr/local/include</font>
	# '''HDF4''': After downloading and unpacking the HDF4 software do the following:		# '''HDF4''': After downloading and unpacking the HDF4 software do the following:
	## Configure it using the command:<br><font style="font-family:courier">    ./configure -prefix=/usr/local --disable-fortran</font>		## Configure it using the command:<br><font style="font-family:courier">    ./configure --prefix=/usr/local --disable-fortran</font>
	## Build it using the command:<br><font style="font-family:courier">    make</font>		## Build it using the command:<br><font style="font-family:courier">    make</font>
	## Test it using the command:<br><font style="font-family:courier">    make check</font>		## Test it using the command:<br><font style="font-family:courier">    make check</font>
	## Install it using the command:<br><font style="font-family:courier">    sudo make install</font>		## Install it using the command:<br><font style="font-family:courier">    sudo make install</font>