![]() |
![]() |
![]() |
![]() |
Chapter 1 System Prerequisites Release 7.0
This chapter supplies system prerequisite information for UNIX and Windows platforms, including memory, graphics adapters, swap space, operating system features, the windowing system, compilers, and graphics libraries.
You must ensure that all supporting hardware and software are in place and that all necessary vendor-supplied system revisions are present on your workstation before you install and try to run AVS/Express, otherwise AVS/Express may not work on your system.
This chapter includes the following sections:
- Supported Platforms
- Windows Platform Prerequisites
- Mac OS X/ Darwin Platform Prerequisites
- Linux Prerequisites
- Sun Platforms Prerequisites
- SGI Platforms Prerequisites
- HP Platforms Prerequisites
- IBM RISC System/6000 Prerequisites on page 1-xxi
- HP/Compaq Tru64 UNIX Prerequisites
- Database Kit Requirements
Of these sections, you must read and complete Supported Platforms and the section pertaining to your operating system. Once you meet the listed prerequisites, continue to Chapter 2, Installing and Licensing AVS/Express.
1.1 Supported Platforms
The table below outlines the platforms that are supported in this AVS/Express release (Release 7.0). Requirements for operating systems, graphics libraries and compilers are also listed
Release 7.0 of AVS/Express is available for the following platforms:
- Note: On all UNIX platforms, gzip must be present in order to install AVS/Express. If gzip is not installed on your UNIX machine, downloads the gzip source and compile/install it before you run the installation script install.xp. Linux and Darwin machines will typically have gzip preinstalled. For more information about gzip go to www.gzip.org.
- Note: AVS/Express for Tru64 Alpha and Windows MSVC++ 6.0 will not be available on the CD. They are available for download. Please contact support@avs.com for more information.
1.2 Windows Platform Prerequisites
This section contains the prerequisites for various Windows platforms.
1.3 Mac OS X/ Darwin Platform Prerequisites
The Mac OS X version of AVS/Express is really a port to Darwin, the Unix core underneath Mac OS X. See (http://www.apple.com/macosx/features/unix). To install and run AVS/Express, some basic familiarity with the Unix comand line is needed. The User Interface is based on X11 and Motif, not Aqua.
X11
You must have X11 installed on your Macintosh. If you are running 10.3, X11 can be found on your OS installer CDs. Make sure you are running the X11 server before starting AVS/Express. If you are using X11 on the Mac for the first time and you have a one button mouse, you need to remember to hold down the control key while clicking the mouse to emulate a right mouse button click.
Motif
AVS/Express 7.0 for Mac OS X / Darwin uses Open Motif 2.2. You can not use Open Motif 2.1.x. Open Motif is available from a variety of sources, including the Open Group (http://www.opengroup.org/openmotif/).
AVS/Express will not run on Darwin without Motif libraries. The libraries must be accessible via the DYLD_LIBRARY_PATH variable (see below) or within a standard location such as /usr/X11R6/lib. There is an exception to the previous rule to assist customers who want to use AVS/Express with installing Motif. The Darwin version of AVS/Express comes with a special executable, bin/darwin/express.static, that has been statically linked with Motif. You may use this executable without installing Motif. If you want to re-link AVS/Express in the course of compiling a project or generating a runtime, you must install the Motif libraries.
gcc/g77
In order for develop new C/C++/Fortran modules for AVS/Express, you must install compilers. AVS/Express uses GCC version 3.3 for C and C++. Compilers for C and C++ can be downloaded from the Apple Developer's Connection. ADC does not distribute g77, but precompiled versions can be downloaded from several places on the net. AVS/Express was compiled using g77 3.4 from http://hpc.sourceforce.net.
DYLD_LIBRARY_PATH
If AVS/Express cannot find its libraries on startup, you must set the DYLD_LIBRARY_PATH environment variable.
If you are using the tcsh shell, the command to set the variable would be similar to the following.
setenv DYLD_LIBRARY_PATH <express_install_dir>/lib/darwinThe same command using the bash shell would be
export DYLD_LIBRARY_PATH=<express_install_dir>/lib/darwinstacksize
On Mac OS X / Darwin, the default stacksize limits are too small. If AVS/Express crashes on startup with a segmentation fault, try increasing the stacksize.
If you are using the tcsh shell, you can increase the stacksize by using the 'unlimit' command.
For details on this command consult the tcsh man page.% unlimit stacksizeIf you are using the bash shell you can increase the stacksize by using the 'ulimit command. For details on this command consult the bash man page.
% ulimit -s 20481.4 Linux Prerequisites
Non Red Hat distributions
In deciding which version of AVS/Express to install for a non-Red Hat Linux distribution, the most important criterion is the compiler revision level.
If the result is "3.2", then you should be able to use the Red Hat 8 version of AVS/Express. If you have a different compiler version, you may run into difficulties especially when compiling or relinking a project. It may be possible to install the 3.2 compilers on your machine because the source is available from Red Hat.
X11/Motif
AVS/Express 7.0 for Red Hat Linux 8.0, 9 uses Open Motif version 2.2. You can not use Open Motif 2.1.x. Open Motif is available from a variety of sources, including the Open Group (http://www.opengroup.org/openmotif/).
AVS/Express will not run on Linux without Motif libraries, which must be accessible via the LD_LIBRARY_PATH or within a standard location such as /usr/X11R6/lib. It also works to put the Motif shared library in <install_dir>/lib/linux, because AVS/Express will look there to find its own shared libraries. There is an exception to the previous rule to assist customers who want to use AVS/Express with installing Motif. The Red Hat 8.0, 9 version of AVS/Express comes with a special executable, bin/linux/express.static, that has been statically linked with Motif. You may use this executable without installing Motif. If you want to re-link AVS/Express in the course of compiling a project or generating a runtime, then you must install the Motif libraries.
Mesa
The x86 version of AVS/Express 7.0 for Linux is built with Mesa 3.4.2, an OpenGL emulator. The Mesa libraries are freely available directly from the Mesa web site (http://www.mesa3d.org). We recommend that you install the patched versions of these libraries prepared by AVS, which are available on the AVS ftp site (ftp://ftp.avs.com/pub/express/linux/). Generally, you should use the most recent version available, which was 3.4.2 (Mesa3d_342.tar.gz) at the time AVS/Express 7.0 was released. This tar file contains a README file outlining the changes made to the original Mesa distribution.
Fortran Libraries
AVS/Express requires a Fortran library in order to compile new projects. If you did not install the Fortran support that came with your Linux distribution, you should do so before compiling a new AVS/Express project. Alternatively, you can copy the required file from <install-dir>/lib/linux/missing to <install-dir>/lib/linux. If you do not do so you may see an error about missing "libg2c."
In Red Hat 8 and later, the libg2c library has been moved to the libf2c-3.2-7 package, instead being a part of the Fortran compiler (g77). So you can install libf2c without needing to install the entire Fortran compiler.
1.5 Sun Platforms Prerequisites
This section provides system prerequisites that are specific to the Solaris platform. There are two different versions of AVS/Express for the s8 platform: s8 is a 32-bit application, s8_64 is a 64-bit application and requires a 64-bit processor.
1.6 SGI Platforms Prerequisites
This section provides system prerequisites that are specific to the SGI platform. There are two different versions of AVS/Express for the SGI platform: sgN32 supports the SGI 32-bit processors and sg6 supports the SGI 64-bit processors.
Compilers and Language Libraries
C/C++
You need the C and C++ compilers, together with their runtime libraries, to relink your application.
You must also have the C and C++ compilers' runtime libraries (libc.so and libC.so) in order to run the express executable. These are supplied on the IRIX CD, and are included in the standard installation, so they should already exist in /usr/lib on your system. If they do not, you can install them from the c_eoe.sw.lib and c++_eoe.sw.lib packages on the CD.
The C compiler is supplied on the IRIS Development Option CD, which is a separately purchased product.
- For version sgN32, the C compiler version must be 7.3or higher.
- For version sg6, the C compiler version must be 7.3 or higher.
The C++ compiler is also a separately purchased product.
- For version sgN32, the C++ compiler version must be 7.3 or higher.
- For version sg6, the C++ compiler version must be 7.3 or higher.
FORTRAN
You need the FORTRAN runtime library (libftn.so) to run AVS/Express with the Annotation and Graphing Kit and the PrintViewer present or to relink applications that contain them.
The libftn.so library is supplied on the IRIX CD. It is part of the standard installation, so it should already exist in /usr/lib on your system. If it does not, you can install it from the ftn_eoe.sw.lib package on the CD.
To remove these FORTRAN dependencies, you must relink AVS/Express without the Annotation and Graphing Kit and the PrintViewer. See Removing Fortran Dependencies, for information on how to remove these dependencies.
Table 0-5
1.7 HP Platforms Prerequisites
This section provides system prerequisites specific to the HP platform.
HP distributes a patch which corrects a memory leak in the libcl.2 system library. The patch number is PHSS_21950. You should install PHSS_21950 and PHSS_21959 before running AVS/Express. These patches can be obtained from the HP web site (requires proper ID and password):
http://us-support2.external.hp.com/wpsl/bin/doc.pl/screen=wpslDisplayPatch
Compilers and Language Libraries Required
AVS/Express was compiled with the HP ANSI C compiler (c89 -D_HPUX_SOURCE) and the HP ANSI C++ compiler (aCC -D_HPUX_SOURCE). It is linked dynamically with the HP C++ compiler's libraries.
C++
- You must have the C++ libC.sl library present on your system to run the express executable.
- If libC.sl is not present on your system, you can copy a version of libC.sl that is included in the AVS/Express HP distribution. Copy <install-dir>/express/lib/$MACHINE/missing/libC.sl to /usr/lib. This will allow you to run the express executable, but you will not be able to relink the express executable.
- You must have the C++ development environment to relink both the express and user process.
To determine what compilers are available on your system, select "General" from the "Toolboxes" pop-up menu on the HP VUE panel, and then select "System Info".
FORTRAN
You must have the FORTRAN runtime libraries that form part of the standard HP-UX installation to relink the express process with the Annotation and Graphing Kit and the PrintViewer present.
To remove this FORTRAN dependency, you must relink AVS/Express without the Annotation and Graphing Kit and the PrintViewer. See Removing Fortran Dependencies, for information on removing this dependency.
Table 0-6
1.8 HP/Compaq Tru64 UNIX Prerequisites
This section provides system prerequisites specific to the HP/Compaq UNIX platform (formerly DEC Alpha OSF) platform.
Table 0-7
AVS/Express supports an OpenGL hardware renderer for DEC graphics options. It can be used by any DEC graphics options that have 8 or 24 color planes and a Z-buffer and that support OpenGL in RGB mode. (See Appendix B, Hardware and Software Renderers.) The xglinfo inquiry utility, installed in /usr/examples/GL/tools/xglinfo, is part of the Open3D OpenGL Examples software subset. In general, all current DEC products except the HX entry level graphics option on the Alpha AXP 3000 series have the necessary support for hardware rendering.
Your window system must provide consistent placement of AVS/Express Viewer windows on the screen. You can do this in either of the following ways:
- Set the XP_WIN_PLACEMENT environment variable, which determines window placement, to None as follows:
AVS/Express is dynamically linked to all system libraries that are available in shareable form, including C, C++ and FORTRAN-77. The C runtime environment is a mandatory part of the operating system, so this will already be part of your base system. However, you need to install the C++ and Fortran-77 runtime environments (from the Digital UNIX operating system CD).
AVS/Express was linked with the C++ linker, so you need this linker to rebuild the AVS/Express executable.You do not need the C++ development option to build projects with C source modules in the user process, or to run applications in the user or express processes. You need to install the C++ development option to relink any AVS/Express project that runs in the express process.
To remove FORTRAN dependencies, you must relink AVS/Express without the Annotation and Graphing Kit and the PrintViewer. See Removing Fortran Dependencies, for information on removing these dependencies.
The OpenGL runtime environment is loaded from the Layered Products CD #1, product #11, product name Open3D. Three sets of software are required from Open3D:
- Base support in subsets O3DDWSBASE and O3DDWSCOMMON.
- Hardware driver support, for instance, subset O3DDWSZLXM if you have a ZLX-M graphics option.
- OpenGL libraries (GL, GL utilities and GLX protocol interface) in subset O3DDWSGLBASE. Select the runtime environment when prompted by the installation script.
It is possible to remove the dependency on OpenGL. To do this, you relink the express process without the OpenGL renderer using the C++ linker from the C++ development option. See Appendix B, Hardware and Software Renderers.
Compaq Tru64 UNIX supplies individual locales packaged into software subsets on the operating system CD-ROM. There are no licenses to buy or configure, but you must unpack the relevant subsets using the wwinstall tool before you can successfully use these nondefault locales. See your Tru64 UNIX installation guide for details.
1.9 Database Kit Requirements
After you install AVS/Express Release 7.0, you can link it with the Database Kit. Read this requirements section only if you intend to link AVS/Express with the Database Kit.
- Note: The Database Kit is available in the AVS/Express Developer Edition only; it is not available in the Visualization Edition.
Supported Platforms
The table below lists the operating platforms and the databases that are supported in this release of AVS/Express. Note that the Open Database Connectivity (ODBC) database is supported only on Windows platforms.
Requirements
You must meet the following requirements in order to use the Database Kit with a supported database.
- If you will be using an Oracle database, the database server software must be available either locally or on a networked host.
- If you are using the ODBC Data Option, Visual C++ release 6.0 must be installed on the local machine where you are installing AVS/Express.
- Note: Microsoft Visual C++ 6.0 is required if you plan on creating modules in AVS/Express.
- The Database Kit includes object code from the various database client libraries. These libraries are used to link to AVS/Express, therefore the libraries must be accessible to the machine where you are installing AVS/Express.
- Your database administrator must set up local configuration files and environment variables so you can access a database on the server. Refer to the ODBC or Oracle documentation for details and configuring your system.
![]() |
![]() |
![]() |
![]() |