A-Shell/UNIX releases are binary specific for a particular machine and architecture. However, the procedure is pretty much the same, regardless of the flavor of Linux / UNIX. Where there are important differences, they will be noted.
Note that the document uses the term "UNIX" to mean "UNIX, AIX, HPUX, Linux and all UNIX-variants." We of course recognize the differences between the operating systems. But because they all work about the same with regard to A-Shell, and the A-Shell commands are the same for the entirely family, we've chosen to use "UNIX" as the family name.
A-Shell/UNIX is downloaded from our web site in the form of one or more "cpio" files, typically named a???###*.bin, where ??? indicates the platform, ### indicates the build number, and * is a suffix which is usually "r" (for runtime package) or a number (for a patch release). The file name "ash-6.2.1421.3-el5.bin," for example, indicates A-Shell version 6.2, build 1421.3, for Enterprise Linux version 5. Often the file will have an additional extension, either Z or tz, in which case it first needs to be uncompressed, using uncompress <file>.Z or tar xvzf <file>.tz.
To install the A-Shell software, copy the cpio file to a convenient location, such as /tmp, and log into UNIX using your normal user id. Do not log in as the superuser (root). Then enter the following:
$ cd /tmp
$ su
[Enter root's password if requested]
In the examples below, we assume you are installing from a cpio file, with an A-Shell build number of 827. For the installation from a file, replace the same filename given below with the actual one you downloaded.
For Linux:
# cd /tmp
# tar xvzf ar7x827r.bin.tz
# cpio -iuB ash_install < /tmp/ar7x827r.bin
For SCO, AIX, HPUX:
# cd /tmp
# uncompress axxx827r.bin.Z
# cpio -icuB ash_install < /tmp/axxx827r.bin
Then, for all platforms:
# chmod +x ash_install
# ./ash_install
# exit
The ash_install script will prompt you for the directory location for the object and runtime files (we suggest /vm/miame for both) and for the name of the file or device you are installing from (which will be the same as the one you extracted the ash_install script from above.)
The ash_install script will execute two special customization scripts (pre_ash_install and post_ash_install) if they exist in the custom subdirectory of the specified target (object) directory tree. These allow you to customize the update process, perhaps saving, renaming, or removing certain commands or files, etc. See the sample scripts included with the release for further notes and examples.
The process will only take a couple of minutes. At the end, it will remind you to set up your MIAME and PATH environment variables and edit the miame.ini file as needed.
History
2006 July, A-Shell 4.9.960: Some improvements were made to the UNIX / Linux installation procedure:
• The installation script now replicates the TERMINFO definitions for am62a to am62cg and am75 to am75g if needed. (This is a convenience when updating older systems with the intent of using ATE. For new installations, you still need to run the tic am62a.tis command to compile the TERMINFO definitions for the am* emulations.)
• ASTART.CMD is no longer overwritten
• ASHLPR components (OPR:ASHLPR.INI, ersatz def ASHLPR:=DSK0[1,24], BAS:ASHLPR.SBX) now installed if not already there.