PowerAda: Installation Guide

From OC Systems Wiki!
Jump to: navigation, search

This Installation Guide contains information about how to install PowerAda onto your AIX or Linux system. The following sections are provided:

Introduction

OCS PowerAda is shipped in tar format on CD-ROM. To install PowerAda on disk, all you should have to do is run the install script.

Your PowerAda delivery should consist of the following:

  • the OCS PowerAda license agreement;
  • this Installation Guide;
  • the Release Notes for this version of PowerAda;
  • a CD-ROM

Getting Help

If something is missing, or you need a different media format, or you have any other installation or configuration problems, please contact OC Systems by internet at support -at- ocsystems.com or by telephone at (703)-359-8160.

Requirements

System Requirements for each of the three PowerAda hosts are:

For PowerAda/AIX
- any computer running AIX version 4.2 or later (including AIX version 5.3)
For PowerAda/Linux
- any modern Intel Pentium-based computer running Red Hat Linux 8 or later (with a version 2.4 kernel or later)
For PowerAda/LinuxPPC
- any PowerPC-based computer running Yellow Dog Linux 2.1 or later (with a version 2.4 kernel or later)

Other Linux distributions for Intel or PowerPC compatible computers should also work provided the distribution is relatively recent. Contact OC Systems for help installing PowerAda on these computers. Typically, 500 Megabytes of disk space are required for installation of PowerAda on any of the host platforms.

In addition to the normal software components found installed for a developer version of AIX or Linux, PowerAda requires the following software to be installed for full operation.

For PowerAda/AIX
- X Windows, X11R5 and Motif 1.2
In addition to the runtime libraries needed to support the PowerAda tools, the following X/Motif libraries (may be newer than X11R5) should be installed if you plan to use the bundled SERC Ada/Motif bindings in your Ada applications:
  libX11.a 
  libXt.a 
  libXm.a 
  libXmu.a 
  libMrm.a 
  libXau.a 			
  libXdmcp.a 
  libXext.a 
  libXi.a 			
These libraries can be found in the AIX installation files. Check /usr/lib to verify all these files exist before attempting to bind with the Ada/Motif libraries.
- Common Desktop Environment (CDE) Desktop Korn Shell (/usr/dt/bin/dtksh)
dtksh is the shell used by PowerAda to provide the customized CM and Tools menus items. Without this tool installed, you will get a message about an improper installation when choosing one of the CM or Tools menu items. Check that /usr/dt/bin/dtksh is installed on any computer from which you plan to run the PowerAda graphical user interface.
- The standard Math library (/lib/libm.a)
The Math library is used to implement certain Ada language-defined library packages and must be installed on computers used to bind your Ada applications to these library packages.
For PowerAda/Linux and PowerAda/LinuxPPC
- PDksh A Korn Like Shell (/bin/ksh)
The scripts in PowerAda are written using /bin/ksh. This tool is often not installed by default on many Linux distribution. The tool is part of the "pdksh" package. You must have /bin/ksh installed before installing PowerAda. The install script is a ksh script.
- Open Motif 2.2.2
The PowerAda tools require the OpenMotif 2.2.2 shared libraries to be installed to load (e.g., libXm.so.3). In addition, the SERC Ada/Motif bindings that are bundled with PowerAda require the installation of the developer libraries for OpenMotif 2.2.2. Install both openmotif-2.2.2 and openmotif-devel-2.2.2 RPMs or later before installing PowerAda. Older versions of Motif (lesstif) will not work and are not supported.
- XEmacs editor
PowerAda provides a customization for using the XEmacs editor. If you wish to use this editor for developing Ada code, you should install it in /bin, /usr/bin, or /usr/local/bin in order for PowerAda to find it.
- GTK-Perl package
The GTK-Perl package is used by PowerAda to provide the customized CM and Tools menus items on Linux. Without this package installed, you will get a message about an improper installation when choosing one of the CM or Tools menu items.

Licensing

The software product FLEXlm from Globetrotter Software is used to ensure legal use of the PowerAda software. Thus you will have to contact OC Systems for a password. Without a correctly installed valid password you will not be able to run any of the tools except the hypertext on-line help (ahelp).

PowerAda is generally licensed on a "concurrent use" basis. A concurrent use license requires the installation of FLEXlm license server software, which is available on your PowerAda installation media. Consult FLEXlm documentation for information on installing and configuring license servers, or contact support -at- ocsystems.com for assistance.

PowerAda may also be licensed on a per-CPU basis (especially for an evaluation period). We refer to this type of license as a "nodelock" license. A nodelock license is the simplest type of license and does not require installation of any FLEXlm software.

Reading the CD

The CD-ROM is mounted as a file system, and once mounted is read just like a hard disk. Depending on the configuration of your system, you may need root (superuser) privileges to access or change your CD device.

The steps in the process are:

1. Determine if the drive is mounted:

$ df | grep cd

If nothing shows up, you'll have to find a system administrator and determine where there's a CD drive, what the device is called, and if there's already a CD mounted. If you've found a machine where a CD is mounted:

/dev/cd0    600000000    0    100%    10000   20%   /cd0

you can move to the next step. If you've identified a CD device on which nothing is currently mounted, move to step 4.

2. Unmount the existing CD filesystem:

$ umount /cd0

3. Pop out the existing CD.

4. Put in the PowerAda CD.

5. Mount the CD as a filesystem. If the mount is already defined (it probably is) then you can just remount it:

$ mount /cd0

Otherwise you'll have to create a directory and mount it there:

$ mkdir /cd0

On AIX:

$ mount -r -v cdrfs /dev/cd0 /cd0

On Linux:

$ mount -r /dev/cd0 /cd0

You should now be able to see the files:

$ ls /cd0   
EVALUATION   README      LICENSE     powerada   
MANIFEST     VERSION     install     tarfiles

If you do not see any files, or get an error, the CD is not mounted properly or you've got the wrong name under which it's mounted. If you do see the files, you're ready for the next step.

Installing PowerAda

Once you can read the CD, the next step is to install its contents on disk:

1. Determine where on disk you want to install PowerAda.

It may be installed anywhere, but of course it should be somewhere which will be visible to all potential users, and which has sufficient disk space. For the full installation, you will need 500 Megabytes of space, and this includes the AdaMotif bindings (these are licensed separately from PowerAda. Contact OC Systems if you require further details). If space is a problem, the installation script allows you to choose what you wish to install using the custom installation option.

2. Set your current directory to a directory on this disk to which you have write access.

You do not need to have root privileges to do the installation unless you need those privileges to write into the current directory.

There is only a single root directory created by the installation: powerada.

Thus your current directory should be the one you intend to be the parent.

For example, /usr/lpp or /huge_disk1.

3. Run the installation script:

$ /cd0/install

Your installation directory will be confirmed, and you will be given some choices as to what parts to install. Once those choices have been made, you can start the installation process and walk away. There will be no additional prompting until the process is complete or an error (e.g, disk full) occurs.

4. The installation script should have updated the powerada/setup script to point to your installation directory. However, this setup script is a good place for defining other aspects of the user's work environment. You should take a moment to read the comments in it and see what the script does.

That's it. To test the installation of the product, proceed to the next step.

Note that on AIX version 5.1, if you run the installation script as a normal user (not as superuser), then the XEmacs editor will not be installed as part of the PowerAda development environment. If you wish to install XEmacs on AIX version 5.1, login as superuser, and then run the installation script. This does not apply to AIX version 4.x. On AIX 4.x, XEmacs is installed with PowerAda, irrespective of the user performing the installation.

Testing the Installation

To confirm that PowerAda has been installed correctly on disk and has appropriate permissions:

1. Log in as a normal user.

2. Execute the PowerAda setup script in your shell.

$ . /huge_disk1/powerada/setup

or if you are using C-Shell use

$ source /huge_disk1/powerada/setup.csh

This script:

  • Defines the POWERADA environment variable; and
  • Defines an alias to define which compiler mode to use. On AIX, this alias is mode95, on Linux (Intel), the alias is modelinux, and on Linux (PowerPC), the alias is modelinuxppc. The only mode supported is Ada95.

3. Start the hypertext help system:

$ ahelp

If your DISPLAY variable is set (so that you can run X Windows applications) this will start a hypertext browser. Otherwise, ahelp starts the Lynx hypertext browser if it is available on your platform. If ahelp, Lynx, or Mosaic are not in your path, or the hypertext browser reports that it cannot find the initial help document, the installation or setup was not done correctly. Reread the above description or contact OC Systems for assistance.

You cannot run any of the tools other than the on-line help system until you get a license for PowerAda. An evaluation license may be obtained by contacting OC Systems by phone or e-mail as described above.

Once you have a license, you are encouraged to try the Demos and Tutorials section of the on-line help. There are a number of demos designed to give a broad introduction to the PowerAda development environment and tool set.

Have fun!

Copying PowerAda after Installation

The powerada directory has many symbolic (soft) links under it, including recursive ones. Because of this, you should be sure to use the "-h" flag on the cp command.