gtminstall script
Prev  Chapter 2. Installing GT.M  Next
GT.M Administration and Operations Guide > Installing GT.M > gtminstall script

gtminstall script

gtminstall is an experimental GT.M installation facility that when used stand-alone attempts to download the latest / current production GT.M distribution from sourceforge.net and installs GT.M using reasonable defaults. It is included with the GT.M binary distribution and you can also use it to install GT.M from the temporary directory in which you unpack the GT.M distribution. It allows considerable customization using the following command line switches:

Command line switches * Description

--build-type buildtype

*

Type of GT.M build, default is pro

--copyenv dirname

Copy gtmprofile and gtmcshrc files to dirname; incompatible with linkenv

--copyexec dirname

Copy gtm script to dirname; incompatible with linkexec

--debug -

*

Turn on debugging with set -x

--distrib dirname or URL

Source directory for GT.M distribution tarball, local or remote

--dry-run

Do everything short of installing GT.M, including downloading the distribution

--group group

Group that should own the GT.M installation

--group-restriction

Limit execution to a group; defaults to unlimited if not specified

--help

Print this usage information

--installdir dirname

Directory where GT.M is to be installed; defaults to /usr/lib/fis-gtm/version_platform

--keep-obj

Keep .o files of M routines (normally deleted on platforms with GT.M support for routines in shared libraries). By default, this option is disabled.

--linkenv dirname

Create link in dirname to gtmprofile and gtmcshrc files; incompatible with copyenv

--linkexec dirname

Create link in dirname to gtm script; incompatible with copyexec

--overwrite-existing

Install into an existing directory, overwriting contents; defaults to requiring new directory

--prompt-for-group

*

GT.M installation script will prompt for group; default is yes for production releases V5.4-002 or later, no for all others

--ucaseonly-utils

Install only upper case utility program names; defaults to both if not specified

--user username

User who should own GT.M installation; default is root

--utf8 ICU_version

Install UTF-8 support using specified major.minor ICU version; specify default to use default version

--verbose -

*

Output diagnostic information as the script executes; default is to run quietly

  • options that take a value (e.g, --group) can be specified as either --option=value or --option value

  • options marked with * are likely to be of interest primarily to GT.M developers

  • version is defaulted from the mumps file if one exists in the same directory as the installer

  • This version must run as root.

To run the gtminstall script, unpack and run it a root. For example, on an x86_64 GNU/Linux platform, ./gtminstall installs GT.M with M mode support in /usr/lib/fis-gtm/V6.1-000_x86_64.

Example: 

$ sudo ./gtminstall # installs latest version in M mode only 
$ sudo ./gtminstall --utf8 default # install latest version with UTF-8 mode support 
$ sudo ./gtminstall --distrib /Distrib/GT.M V6.0-003 # install V6.0-0030 from a local directory
Prev  Up  Next
Installation Procedure  Home  Chapter 3. Basic Operations