Installation Operations

Create an Installation (installationCreate)

The installationCreate command defines a TimesTen installation in the model.

ttGridAdmin installationCreate hostname[.installname]
                               -location path
                               [-source where]
                               [-comment comment]

Options

The installationCreate command has the options:

Option	Description
`hostname[.installname]`	The `hostname` is the name of the host where the installation is to be created, optionally with a specified `installname` for the name of the installation in the model. The default is `installation1`.
`-location` `path`	Path, on the specified host, to the directory where the installation is to be created. The specified directory does not have to exist, but if it exists it must be empty.
`-source` `where`	Location that the installation will be copied from. The location does not have to be on a system that is part of the grid. You can specify it in any of the following formats, as applicable: /path address:/path address!/path [address]:/path If `path` is a directory, it must be the top-level tt22.1.1.21.0 directory of an existing TimesTen installation. If it is a file, it must be a `.zip` file that expands into a TimesTen installation. The `address` is a DNS name or IP address. If `address` is specified, passwordless SSH is used to fetch the installation source from the system with that address. You must use the fourth format if there is a colon in the address itself, such as for IPv6 addresses. The default is the location of the installation associated with the active management instance, from which `ttGridAdmin` is run. Also see Address Formats.
`-comment` `comment`	Associates a comment with the installation object. Put the comment in quotes if there are any spaces. The comment is stored and included in output of the `installationList` command.

Examples

Create an installation for host mysys4host, using the default source location. (This example was run from mysys1.)

% ttGridAdmin installationCreate mysys4host.installcreate 
-location /sw/tten/grid/ttinstls/installcreate
Installation installcreate on Host mysys4host created in Model

This time, specify a source location:

% ttGridAdmin installationCreate mysys4host.installcreate2
-location /sw/tten/grid/ttinstls/installcreate2 -source 
mysys1:/sw/tten/grid/ttinstls/myinstl/tt22.1.1.21.0
Installation installcreate2 on Host mysys4host created in Model

Notes

This command does not create a physical installation. It defines an installation object in the model. (The modelApply command creates the installation.)
Multiple installation objects for the same TimesTen release can point to the same physical installation; however, you cannot specify the same location on the same host for installations from different releases.

Delete an Installation (installationDelete)

The installationDelete command deletes an installation from the model. It deletes the specified installation (or the only installation, as applicable) on the specified host.

ttGridAdmin installationDelete hostname[.installname]

Options

The installationDelete command has the option:

Option	Description
`hostname[.installname]`	The `hostname` is the name of the host where the installation is to be deleted. The `installname` is the name of the installation to be deleted and is required only if there is more than one installation on the host.

Examples

In this example, installcreate2 is the only installation on the host.

% ttGridAdmin installationDelete mysys4host
Installation installcreate2 on Host mysys4host deleted from Model

Notes

You cannot remove an installation that is still used by instances on the specified host.
This command removes the installation object from the model but does not remove the physical installation. Remove the files manually when you are certain they are no longer used.

Execute a Command or Script on Grid Installations (installationExec)

The installationExec command runs a command (such as a system command or TimesTen command) or a script on installations in the grid, as specified.

ttGridAdmin installationExec [-only hostname[.installname]]
                             [-exclude hostname[.installname]]
                             [-parallel n]
                             command | -script filepath

As the command or script runs, the TIMESTEN_INSTALL environment variable is set to contain the fully qualified path name of the installation as defined in the model.

Options

The installationExec command has the options:

Option	Description
`-only` `hostname[.installname]`	The command or script is run only on the specified installations. Specify just one installation with `-only`, but you can use `-only` multiple times on the command line. Use host names and installation names as defined in the model. You do not have to include the installation name if it is the only installation on the host.
`-exclude` `hostname[.installname]`	The command or script is run on all installations in the grid except for those specified. Specify just one installation with `-exclude`, but you can use `-exclude` multiple times on the command line. Use host names and installation names as defined in the model. You do not have to include the installation name if it is the only installation on the host.
`-parallel` `n`	Specifies that the command or script runs on no more than `n` installations simultaneously. The default is 10. A value of 1 results in serial execution.
`command` `\| -script` `filepath`	`command` specifies a command to run. Or: `-script` `filepath` specifies the path and name of a shell script to run. The script must be on the local system, then is copied to each installation.

Examples

This example checks the disk space usage on the file system of each installation.

% ttGridAdmin installationExec df '$TIMESTEN_INSTALL'
Commands executed on:
  mysys2host.installation1 rc 0
  mysys4host.installadc rc 0
  mysys1host.installation1 rc 0
  mysys3host.installslc rc 0
Return code from mysys2host.installation1: 0
Output from mysys2host.installation1:
Filesystem           1K-blocks      Used Available Use% Mounted on
/dev/xvda2           117144964  42660228  68534120  39% /
Return code from mysys4host.installadc: 0
Output from mysys4host.installadc:
Filesystem           1K-blocks      Used Available Use% Mounted on
/dev/xvda2           117144964  42660228  68534120  39% /
Return code from mysys1host1.installation1: 0
Output from mysys1host.installation1:
Filesystem           1K-blocks      Used Available Use% Mounted on
/dev/xvda2           173483816  57971304 106700020  36% /
Return code from mysys3host.installslc: 0
Output from mysys3host.installslc:
Filesystem           1K-blocks      Used Available Use% Mounted on
/dev/xvda2           173483816  57971312 106700012  36% /

Notes

The command or script is run as the instance administrator on each installation, through passwordless SSH.
The command returns 2000 if execution did not complete prior to the timeout.
During execution, stdout and stderr output is displayed as part of the stdout and stderr output from the installationExec command. Because output is buffered, the output from different commands is not intermingled.

List Installations (installationList)

The installationList command lists all TimesTen installations in the model.

ttGridAdmin installationList [-latest|-current|-version n]
                             [-instance]

Options

The installationList command has the options:

Option	Description
`-latest`	List the installations in the latest (in progress) model, which has not yet been applied to the grid. This is the default.
`-current`	List the installations in the current model—the model currently applied to the grid.
`-version` `n`	List the installations in the specified version number of the model.
`-instance`	Show the instances that are using each installation. Installations not yet associated with an instance are not displayed.

Examples

This example lists the installations in the latest (in progress) model.

% ttGridAdmin installationList
Host        Install        Location                                      Comment
----------- -------------  -------------------------------------------   -------
mysys1host  installation1  /sw/tten/grid/ttinstls/myinstl/tt22.1.1.21.0/
mysys2host  installation1  /sw/tten/grid/ttinstls/myinstl/tt22.1.1.21.0/
mysys3host  installcreate1 /sw/tten/grid/ttinstls/installcreate1/
mysys4host  installcreate1 /sw/tten/grid/ttinstls/installcreate1/

This example lists installations in the latest model that are associated with an instance.

% ttGridAdmin installationList -instance
Host        Install       Instance  Location                                     Comment
----------- ------------- --------  -------------------------------------------- -------
mysys1host  installation1 gridmgmt1 /sw/tten/grid/ttinstls/myinstl/tt22.1.1.21.0/
mysys2host  installation1 gridmgmt1 /sw/tten/grid/ttinstls/myinstl/tt22.1.1.21.0/

Display Status of Installations (installationStatus)

The installationStatus command shows the status of all installations that are associated with the grid. This is status of the physical installations, not status of installations in the model.

ttGridAdmin installationStatus

Examples

% ttGridAdmin installationStatus
Host        Install           Usable DelPend Message When
----------- ----------------- ----   ------- ------- -------------------
mysys1host  installation1     Yes    N               2016-11-01 14:49:31
mysys2host  installation1     Yes    N               2016-11-01 14:49:31
mysys3host  installcreate2slc Yes    N               2016-11-01 14:49:31
mysys4host  installcreate2adc Yes    N               2016-11-01 14:49:31

The DelPend entry indicates whether a deletion is pending, where installationDelete was run but the updated model has not yet been applied to remove the physical installation.