From c9bb65de280341dc5667a593b5572cb4dfe5cdf6 Mon Sep 17 00:00:00 2001 From: Dale Henrichs Date: Sat, 28 Jan 2017 14:54:18 -0800 Subject: [PATCH] Issue #162: update help text for newExtent, plus the primary commands that call newExtent: createStone, smalltalkCI, and upgradeStone --- bin/createStone | 8 +++++++- bin/newExtent | 9 +++++++-- bin/smalltalkCI | 9 ++++++++- bin/upgradeStone | 8 +++++++- 4 files changed, 29 insertions(+), 5 deletions(-) diff --git a/bin/createStone b/bin/createStone index 163dfbec..273bda92 100755 --- a/bin/createStone +++ b/bin/createStone @@ -48,7 +48,13 @@ OPTIONS -n No startStone, no startNetldi. -s - path to snapshot file used to create stone. + Path to snapshot file used to create stone. Path may be a relative file + path. The snapshot file may be an extent file (raw, zipped (.zip) or + gzipped (.gz)) or a backup file. If the file is compressed, it will be + uncompressed into the target extents directory. If the file is a backup + file, a \$GEMSTONE/bin/extent0.dbf will be copied into the target + extents directory and then the backup will be restored without replaying + tranlogs. -t path to snapshot file used to create stone. It is assumed that the snapshot already has tODE installed and the snapshot will be attached to the diff --git a/bin/newExtent b/bin/newExtent index a66d9586..2573d836 100755 --- a/bin/newExtent +++ b/bin/newExtent @@ -41,8 +41,13 @@ OPTIONS (http://downloads.gemtalksystems.com/docs/GemStone64/3.2.x/GS64-SysAdmin-3.2/GS64-SysAdmin-3.2.htm?http://downloads.gemtalksystems.com/docs/GemStone64/3.2.x/GS64-SysAdmin-3.2/9-BackupAndRestore.htm#pgfId-999128) before using the -n option. -s - Path to snapshot file used to create stone. Path may be a relative file - path. + Path to snapshot file used to create stone. Path may be a relative file + path. The snapshot file may be an extent file (raw, zipped (.zip) or + gzipped (.gz)) or a backup file. If the file is compressed, it will be + uncompressed into the target extents directory. If the file is a backup + file, a \$GEMSTONE/bin/extent0.dbf will be copied into the target + extents directory and then the backup will be restored without replaying + tranlogs. -t Attach image to the \$GS_TODE/sys/stones/ directory structure, using the rebuildServerTode client script diff --git a/bin/smalltalkCI b/bin/smalltalkCI index 4ad5c166..940d7f61 100755 --- a/bin/smalltalkCI +++ b/bin/smalltalkCI @@ -30,7 +30,14 @@ OPTIONS already has tODE installed and the snapshot attached to the existing \$GS_TODE/sys/stones/ structure before installing SmalltalkCI -s - Path to snapshot file used to create stone. Extent is used without doing anything other than install SmalltalkCI. + Path to snapshot file used to create stone. Extent is used without doing + anything other than install SmalltalkCI. Path may be a relative file + path. The snapshot file may be an extent file (raw, zipped (.zip) or + gzipped (.gz)) or a backup file. If the file is compressed, it will be + uncompressed into the target extents directory. If the file is a backup + file, a \$GEMSTONE/bin/extent0.dbf will be copied into the target + extents directory and then the backup will be restored without replaying + tranlogs. -z Customize the stone installation according to the attrbutes specified in the file. diff --git a/bin/upgradeStone b/bin/upgradeStone index 2f618298..fc1c4abb 100755 --- a/bin/upgradeStone +++ b/bin/upgradeStone @@ -30,7 +30,13 @@ OPTIONS Default: 100000 -s Path to extent file used as starting point for - upgrade. + upgrade. Path may be a relative file path. The snapshot file may be + an extent file (raw, zipped (.zip) or gzipped (.gz)) or a backup file. + If the file is compressed, it will be uncompressed into the target + extents directory. If the file is a backup file, a + \$GEMSTONE/bin/extent0.dbf will be copied into the target extents + directory and then the backup will be restored without replaying + tranlogs. -u Skip creation of and only run the upgrade step. -U