Please enable JavaScript to view this site.

ASQL Reference

Navigation: » No topics above this level «

Before Installation

Scroll Prev Top Next More

Review the following notes and make sure you are aware of the various issues involved before beginning the installation.

u File System Setup

Although A-Shell itself can exist in any directories, for system administration purposes is may be wise to try to separate it from other application and operating system directories, if possible. This is less of an issue under Windows, where you typically have only one file system (or partition) available, and thus the best separation you can achieve is to give A-Shell its own directory tree, and possibly its own share name. Under Unix on the other hand, it is normal to have multiple file systems, and there are some particularly good reasons for defining one or more individual file systems to keep A-Shell separate from the rest of the operating system:

Individual file systems can be separately backed up and restored.
Separate file systems are naturally insulated from each other, so that any corruption that occurs in one will not spill over to another. This will not only protect A-Shell from problems caused by some other application but also protect you from being accused by your system administrator of allowing your application to corrupt the system.
Since different file systems can be mounted at the same mount point (though not at the same time), you have the ability to easily switch to another version of your data or application (backup, test, archive, etc.) temporarily without making any changes to A-Shell or your application. (This works best when you have "extra" scratch file systems available which you can restore a tape to.)
Putting your A-Shell application in a separate file system will eliminate the possibility that you can bring the system down by filling up the disk. You may still cause your application to halt when it runs out of space, but the operating system will not be affected.

 

u Installation Overview

In essence, there are two separate sets of files which are installed: the A-Shell runtime system, consisting of the AMOS emulation command programs and the A-Shell module itself, and the development system, consisting of the object modules and source to a user-defined subroutine module, enabling subroutines to be developed. Since the second set of files is usually offered as an added-cost option, most users will only need to concern themselves with the first set.

 

u Security Key

After installation, it is necessary to install the security key that was supplied at the time of purchase. This process is described later in this section. If you don’t have a security key, the software will run in demo mode, which is fully functional except for nag messages (which will eventually drive you crazy) and the single user limitation.

 

u Updating

If you are updating an existing A-Shell installation, you should follow the same process as for an original installation. Under all operating systems, the installation process will detect that (or ask if) an update is being performed and will not overwrite any existing configuration files. Any configuration files that might have new fields added, or differing formats, are stored in example form with .new extensions. If the function key translation tables are updated, the original ones will be saved with .ifs (.ifx) and .vus (.vux) extensions.

The ash_install script used for installing and updating A-Shell under Unix will execute two special customization scripts—pre_ash_install and post_ash_install—if they exist in the custom subdirectory of the specified target 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.

 

u Multiple Installations

It is possible to install A-Shell several times on a single machine, in different paths, which enables entirely separate A-Shell environments. While this is generally not recommended for end-users, who are typically running A-Shell as a single-purpose application, multiple environments can be very useful for developers and resellers for a variety of purposes: development versus production systems, duplicating customers' systems, etc. The recommended directory structure is to have all virtual machines located in the \VM or /vm directory. Each A-Shell installation would live one directory level below this identified by its machine name and the MIAME environment variable pointing to this subdirectory. It is recommended that the first A-Shell installation on a machine be made in the default directory \VM\MIAME or /vm/miame.

 

u Hardware and Performance