Review the following notes and make sure you are aware of the various issues involved before beginning the installation.
Although A-Shell itself can exist in any directories, for system administration purposes it 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:
|
The core A-Shell installation consists of a single directory tree, normally named /vm/miame or \vm\miame. The top level contains the main configuration file, miame.ini. Below that is a bin directory containing the binaries—i.e., A-Shell's main programs and libraries—and a DSK0 directory tree with multiple sub-directories for system commands and general shell variables and control file. Depending on the size and complexity of your application, you may create one more more additional pseudo-device directory trees adjacent to DSK0 or anywhere. That is something you would set up manually after finishing the basic system installation; see DEVICE. |
After installation, it is necessary to install the security key that was supplied at the time of purchase. This process is described in the After Installation notes. If you don’t have a security key, the software will run in demo mode, which is fully functional except for nag messages and being limited to a the single user. |
u Updating
For Windows, updates are most easily accomplished via the Help > Check For Updates menu, which checks for the existence of an update, and if found, gives you the option to proceed. he update routine is identical to the install except that it doesn't give you the option of a target location. For Linux, use the same process as for the 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. |
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. |