Compaq: FreePort Express Quick Start

United States

| About AMT

Migration Tools
FX!32
FreePort Express
Download
Quick Start
User's Guide
White Papers
DECmigrate

| Performance Tools
| Documentation & White Papers

Quick Start

Quick Start is an overview of the minimum software and hardware requirements and of the procedures for installing the FreePort Express software kit, for setting up the environment variables, and for translating and running an executable. The same information appears in the file QUICKSTART, which is part of the software kit.

Please read the FreePort Express Release Notes, also part of the software kit, for complete installation and release information. Refer to the FreePort Express User’s Guide for all other information.

Hardware and Software Requirements

The minimum requirements for using FreePort Express are as follows:

Requirements | Software | Hardware
For translation... | Digital UNIX Version 3.0 or later | Alpha system with 128MB recommended, 64MB minimum
At run time... | Digital UNIX Version 3.0 or later | Alpha system; memory requirements depend on translated executable

Installing the Kit

FreePort Express Version 1.1 is distributed free to licensed sites in several compressed files: fpx-base.tar.Z, fpx-lib.tar.Z, and fpx-doc.tar.Z. Note that you must have root privileges to install the FreePort Express kit because the installation script installs files in system directories.

Follow these steps to install the kit:

% mkdir kitpath | Create a directory called kitpath.
% cd kitpath | Move to the empty directory called kitpath.
% cp /somepath/fpx-base.tar.Z fpx-base.tar.Z | Copy the kit to the kitpath directory.
% uncompress fpx-base.tar.Z | Decompress the kit.
% tar xvf fpx-base.tar | Unpack the tar file. Repeat the cp, uncompress, and tar commands for each compressed file.
% su | Make yourself superuser.
# ./INSTALL | Enter ./INSTALL to run the installation script.

The script periodically asks for your input to determine where it should place specific files. If the script encounters problems that prevent it from completing successfully, it issues an error message and exits.

Translating Solaris 1.n SPARC user executables

To translate an eligible user executable for Solaris 1.n SPARC, copy the translated executable and any supporting files, such as shared libraries, to your current directory on the Digital UNIX system. Then follow these steps:

% setenv FPX_LIBSRC_PATH path[:...:path] | If the untranslated shared libraries are not in the current directory, set the FPX_LIBSRC_PATH environment variable to the path where the translator must search for them.
% fpx executable | Enter the command fpx followed by the name of the input executable to translate it and any shared libraries it references. By default, the output file name is a.out.

Running the Translated Executable

To run the translated executable, first make sure all the supporting files are available and then follow these steps:

% mv executable.out original_name | Rename the translated executable to the original name used on the Solaris 1.n SPARC system.
% setenv LD_BIND_NOW 1 | Set the LD_BIND_NOW environment variable to 1.
% setenv LD_LIBRARY_PATH trans-lib-path | Define the library search path.
% original_name | Use the original name to invoke the translated executable on the Digital UNIX system. The FreePort Express run-time environment activates automatically.

If you have questions about FreePort Express, send email to fpx-info@scrugs.lkg.dec.com.

| Click to send feedback

privacy and legal statement