org.safs.install

Class SilentInstaller

java.lang.Object

org.safs.install.SilentInstaller

public class SilentInstaller
extends java.lang.Object

Author:

Carl Nagle Original Release, LeiWang JUN 28, 2009 Added arguments "-removestaf" and "-installstafversion" for installing/removing STAF 2.X/3.X., JunwuMa Jun 29, 2009 Update not to overwrite the existing SAFS files unless these SAFS files have new version., Carl Nagle OCt 06, 2009 Update to use the STAF333 NoJVM EXE, if possible., LeiWang OCT 27, 2010 Do some modifications for installation on Linux. (Red Hat Enterprise Linux Server release 5.3 (Tikanga)), Dharmesh4 AUG 17, 2011 Do some modifications for installation on MAC.(Version: Darwin, 10.6.0), Carl Nagle AUG 02, 2012 Support -installstafexe alternate executable for STAF 3 and later., Lei Wang JUL 24, 2013 Add ProgressIndicator, use Console to detect OS, remove redundant code. Move some codes to org.safs.text.FileUtilities

See Also:

ConsumOutStreamProcess

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static Console	console
(package private) static java.lang.String	DEFAULT_LINUX_STAF_3_BIN
static java.lang.String	DEFAULT_MAC_SAFS_DIR "/Library"
(package private) static java.lang.String	DEFAULT_MAC_STAF_3_BIN
static java.lang.String	DEFAULT_MAC_STAF_DIR
static java.lang.String	DEFAULT_UNX_SAFS_DIR "/usr/local"
static java.lang.String	DEFAULT_UNX_STAF_DIR
static java.lang.String	DEFAULT_WIN_SAFS_DIR "C:\SAFS"
(package private) static java.lang.String	DEFAULT_WIN_STAF_3_EXE
static java.lang.String	DEFAULT_WIN_STAF_DIR "C:\STAF"
(package private) static java.lang.String	installedsafsdir
(package private) static java.lang.String	installedstafdir
(package private) static boolean	installsafs
(package private) static boolean	installsilent
(package private) static boolean	installstaf
(package private) static java.lang.String	installstafexe
(package private) static java.lang.String	installstafversion
(package private) static boolean	installtcafs
static java.lang.String	OPTION_ALTSAFS "-safs"
static java.lang.String	OPTION_ALTSTAF "-staf"
static java.lang.String	OPTION_NOSAFS "-nosafs"
static java.lang.String	OPTION_NOSTAF "-nostaf"
static java.lang.String	OPTION_OVERLAY "-overlay"
static java.lang.String	OPTION_REMOVE_SAFS "-removesafs"
static java.lang.String	OPTION_REMOVE_STAF "-removestaf"
static java.lang.String	OPTION_SILENT "-silent"
static java.lang.String	OPTION_STAF_INSTALL_EXE "-installstafexe" Ex: -installstafexe STAF3410-setup-win32-NoJVM.exe
static java.lang.String	OPTION_STAF_TO_INSTALL "-installstafversion" Ex: -installstafversion 2 (or 3)
static java.lang.String	OPTION_VERBOSE "-v"
(package private) static java.lang.String	overlayfile
(package private) static boolean	overlaysafs
(package private) static int	pctCopyEmbedded
(package private) static int	pctPostInstall
(package private) static int	pctPostSTAFInstall
(package private) static int	pctPreSTAFInstall
(package private) static int	pctProgress
(package private) static int	pctSAFSInstall
(package private) static int	pctSAFSOverlay
(package private) static int	pctSAFSUninstall
(package private) static int	pctSTAFUninstall
(package private) static ProgressIndicator	progresser progressbar is a swing panel to show the progress of installation.
(package private) static boolean	removesafs
(package private) static boolean	removestaf
(package private) static java.lang.String	safs_silent
(package private) static java.lang.String	safsdir
static java.lang.String	SAFSEmbeddedJavaExe
(package private) static java.lang.String	staf_3_loginstart_0
(package private) static java.lang.String	staf_3_register_0
(package private) static java.lang.String	staf_3_set_install_dir
(package private) static java.lang.String	staf_3_silent
static java.lang.String	STAF_LAX_VM
(package private) static java.lang.String	STAF_REG_FILE
(package private) static java.lang.String	staf_uninstall_2
(package private) static java.lang.String	staf_uninstall_3
(package private) static java.lang.String	staf_uninstall_3_linux
(package private) static java.lang.String	staf_uninstall_3_mac
(package private) static java.lang.String	stafdir
(package private) static java.lang.String	stafMajorVersionTobeRemoved
(package private) static boolean	verbose
(package private) static java.lang.String	ZIP_INSTALL_FILE "SAFSInstall.zip"
(package private) static java.lang.String	ZIP_OVERLAY_FILE "SAFSSnapshot.zip"

Constructor Summary

Constructors

Constructor and Description
SilentInstaller()

Method Summary

Modifier and Type	Method and Description
(package private) static int	copyEmbeddedJRE(java.lang.String jrepath) Must be called AFTER a SAFS Install or Overlay.
(package private) static int	copyInstallDir(java.lang.String installpath) Must be called AFTER a SAFS Install or Overlay.
(package private) static int	copyUninstallDir(java.lang.String uninstallpath) Must be called AFTER a SAFS Install or Overlay.
(package private) static boolean	createSAFSProgramGroup(java.lang.String safsdir)
(package private) static int	deleteAllDirectory(java.lang.String directory) If the uninstaller can not delete directory completely, we need to clean the remain files.
(package private) static int	doSAFSInstall() Perform SAFS install.
(package private) static int	doSAFSInstallers() Runs AFTER SAFS has been laid down, or uninstalled.
(package private) static int	doSAFSOverlay() Perform SAFS Overlay.
(package private) static int	doSAFSUnInstall()
(package private) static int	doSTAFInstall(java.lang.String version) Perform STAF install.
(package private) static int	doSTAFUnInstall(java.lang.String version) Perform uninstall STAF.
static void	main(java.lang.String[] args) This SilentInstaller provides no GUI, but will accept some configuration parameters.
(package private) static void	parseArgs(java.lang.String[] args)
(package private) static void	printArgs(java.lang.String[] args)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ZIP_INSTALL_FILE

static final java.lang.String ZIP_INSTALL_FILE

"SAFSInstall.zip"

See Also:

Constant Field Values

ZIP_OVERLAY_FILE

static final java.lang.String ZIP_OVERLAY_FILE

"SAFSSnapshot.zip"

See Also:

Constant Field Values

DEFAULT_WIN_SAFS_DIR

public static final java.lang.String DEFAULT_WIN_SAFS_DIR

"C:\SAFS"

See Also:

Constant Field Values

DEFAULT_WIN_STAF_DIR

public static final java.lang.String DEFAULT_WIN_STAF_DIR

"C:\STAF"

See Also:

Constant Field Values

DEFAULT_UNX_SAFS_DIR

public static final java.lang.String DEFAULT_UNX_SAFS_DIR

"/usr/local"

See Also:

Constant Field Values

DEFAULT_UNX_STAF_DIR

public static final java.lang.String DEFAULT_UNX_STAF_DIR

See Also:

Constant Field Values

DEFAULT_MAC_SAFS_DIR

public static final java.lang.String DEFAULT_MAC_SAFS_DIR

"/Library"

See Also:

Constant Field Values

DEFAULT_MAC_STAF_DIR

public static final java.lang.String DEFAULT_MAC_STAF_DIR

See Also:

Constant Field Values

DEFAULT_WIN_STAF_3_EXE

static final java.lang.String DEFAULT_WIN_STAF_3_EXE

See Also:

Constant Field Values

DEFAULT_LINUX_STAF_3_BIN

static final java.lang.String DEFAULT_LINUX_STAF_3_BIN

See Also:

Constant Field Values

DEFAULT_MAC_STAF_3_BIN

static final java.lang.String DEFAULT_MAC_STAF_3_BIN

See Also:

Constant Field Values

STAF_REG_FILE

static final java.lang.String STAF_REG_FILE

See Also:

Constant Field Values

OPTION_NOSAFS

public static final java.lang.String OPTION_NOSAFS

"-nosafs"

See Also:

Constant Field Values

OPTION_NOSTAF

public static final java.lang.String OPTION_NOSTAF

"-nostaf"

See Also:

Constant Field Values

OPTION_REMOVE_STAF

public static final java.lang.String OPTION_REMOVE_STAF

"-removestaf"

See Also:

Constant Field Values

OPTION_REMOVE_SAFS

public static final java.lang.String OPTION_REMOVE_SAFS

"-removesafs"

See Also:

Constant Field Values

OPTION_STAF_TO_INSTALL

public static final java.lang.String OPTION_STAF_TO_INSTALL

"-installstafversion" Ex: -installstafversion 2 (or 3)

See Also:

Constant Field Values

OPTION_STAF_INSTALL_EXE

public static final java.lang.String OPTION_STAF_INSTALL_EXE

"-installstafexe" Ex: -installstafexe STAF3410-setup-win32-NoJVM.exe

See Also:

Constant Field Values

OPTION_SILENT

public static final java.lang.String OPTION_SILENT

"-silent"

See Also:

Constant Field Values

OPTION_ALTSAFS

public static final java.lang.String OPTION_ALTSAFS

"-safs"

See Also:

Constant Field Values

OPTION_OVERLAY

public static final java.lang.String OPTION_OVERLAY

"-overlay"

See Also:

Constant Field Values

OPTION_ALTSTAF

public static final java.lang.String OPTION_ALTSTAF

"-staf"

See Also:

Constant Field Values

OPTION_VERBOSE

public static final java.lang.String OPTION_VERBOSE

"-v"

See Also:

Constant Field Values

overlaysafs

static boolean overlaysafs

installsafs

static boolean installsafs

removestaf

static boolean removestaf

removesafs

static boolean removesafs

installstaf

static boolean installstaf

installtcafs

static boolean installtcafs

verbose

static boolean verbose

installstafversion

static java.lang.String installstafversion

installedstafdir

static java.lang.String installedstafdir

installedsafsdir

static java.lang.String installedsafsdir

installstafexe

static java.lang.String installstafexe

safsdir

static java.lang.String safsdir

stafdir

static java.lang.String stafdir

overlayfile

static java.lang.String overlayfile

STAF_LAX_VM

public static final java.lang.String STAF_LAX_VM

See Also:

Constant Field Values

SAFSEmbeddedJavaExe

public static final java.lang.String SAFSEmbeddedJavaExe

staf_3_silent

static java.lang.String staf_3_silent

staf_3_set_install_dir

static java.lang.String staf_3_set_install_dir

staf_3_register_0

static java.lang.String staf_3_register_0

staf_3_loginstart_0

static java.lang.String staf_3_loginstart_0

safs_silent

static java.lang.String safs_silent

staf_uninstall_2

static java.lang.String staf_uninstall_2

staf_uninstall_3

static java.lang.String staf_uninstall_3

staf_uninstall_3_linux

static java.lang.String staf_uninstall_3_linux

staf_uninstall_3_mac

static java.lang.String staf_uninstall_3_mac

stafMajorVersionTobeRemoved

static java.lang.String stafMajorVersionTobeRemoved

installsilent

static boolean installsilent

pctProgress

static int pctProgress

pctSTAFUninstall

static int pctSTAFUninstall

pctSAFSUninstall

static int pctSAFSUninstall

pctSAFSInstall

static int pctSAFSInstall

pctSAFSOverlay

static int pctSAFSOverlay

pctCopyEmbedded

static int pctCopyEmbedded

pctPostInstall

static int pctPostInstall

pctPreSTAFInstall

static int pctPreSTAFInstall

pctPostSTAFInstall

static int pctPostSTAFInstall

console

static Console console

progresser

static ProgressIndicator progresser

progressbar is a swing panel to show the progress of installation.

Constructor Detail

SilentInstaller

public SilentInstaller()

Method Detail

printArgs

static void printArgs(java.lang.String[] args)

parseArgs

static void parseArgs(java.lang.String[] args)

doSAFSInstall

static int doSAFSInstall()
                  throws java.io.IOException,
                         java.io.FileNotFoundException

Perform SAFS install. The SAFS install is currently always silent (GUI-less).
If -safs parameter was specified then the install will attempt to use any provided user-specified directory for the install.

Any user-specified directories must exist; or, we must not be denied the ability to create them and write/copy files to them.

Throws:

java.io.IOException

java.io.FileNotFoundException

doSAFSOverlay

static int doSAFSOverlay()
                  throws java.io.IOException,
                         java.io.FileNotFoundException

Perform SAFS Overlay. The SAFS overlay is currently always silent (GUI-less).
If -overlay parameter was specified then the install will attempt to use the provided Snapshot ZIP file for the overlay.

The overlay ZIP file must exist. An overlay can be applied immediately following a SAFSInstall during the same invocation of this installer.

Throws:

java.io.IOException

java.io.FileNotFoundException

doSTAFInstall

static int doSTAFInstall(java.lang.String version)

Perform STAF install. If -silent parameter was specified then a silent install will be done.
Currently all installs are silent.
If -staf parameter was specified then the install will attempt to use any provided user-specified directory for the install.

doSTAFUnInstall

static int doSTAFUnInstall(java.lang.String version)

Perform uninstall STAF. Uninstall STAF silently.

doSAFSUnInstall

static int doSAFSUnInstall()

createSAFSProgramGroup

static boolean createSAFSProgramGroup(java.lang.String safsdir)

deleteAllDirectory

static int deleteAllDirectory(java.lang.String directory)

If the uninstaller can not delete directory completely, we need to clean the remain files. Use DOS COMMAND "rmdir /S/Q dir" to delete the whole directory.

Parameters:

directory -

Returns:

copyEmbeddedJRE

static int copyEmbeddedJRE(java.lang.String jrepath)
                    throws java.io.IOException

Must be called AFTER a SAFS Install or Overlay.

Parameters:

jrepath - -- path to JRE root dir to be copied as an embedded JRE. Can be null. If null, we seek it in the user's current working directory. This is presumably where the install was launched from.

Returns:

0 on success or "not needed". Thrown Exception if a problem occurred.

Throws:

java.io.FileNotFoundException

java.io.IOException

copyInstallDir

static int copyInstallDir(java.lang.String installpath)
                   throws java.io.IOException

Must be called AFTER a SAFS Install or Overlay.

Parameters:

installpath - -- path to install root dir to be copied to new install dir. Can be null. If null, we seek it in the user's current working directory. This is presumably where the install was launched from.

Returns:

0 on success or "not needed". Thrown Exception if a problem occurred.

Throws:

java.io.FileNotFoundException

java.io.IOException

copyUninstallDir

static int copyUninstallDir(java.lang.String uninstallpath)
                     throws java.io.IOException

Must be called AFTER a SAFS Install or Overlay.

Parameters:

uninstallpath - -- path to uninstall root dir to be copied to new uninstall dir. Can be null. If null, we seek it in the user's current working directory. This is presumably where the install was launched from.

Returns:

0 on success or "not needed". Thrown Exception if a problem occurred.

Throws:

java.io.FileNotFoundException

java.io.IOException

doSAFSInstallers

static int doSAFSInstallers()

Runs AFTER SAFS has been laid down, or uninstalled.

Parameters:

install -

Returns:

main

public static void main(java.lang.String[] args)

This SilentInstaller provides no GUI, but will accept some configuration parameters. Any user-specified directories must exist; or, we must not be denied the ability to create them and write/copy files to them.

Parameters:

args[] - The following parameters or arguments can be specified:

• -silent
  A silent STAF install with provided parameters. At this time, a STAF silent install is performed with or without this parameter.
  Currently, the install for SAFS is always silent (GUI-less).

• -nosafs
  Skip the installation of SAFS files and associated services.

• -nostaf
  Skip the installation of STAF.

• -notcafs
  Skip the installation of TCAFS support registration.

• -safs "alternate SAFS directory"
  Install SAFS files and services to the user specified directory instead of the default install directory.
  The -safs argument does not have to be specified to install to the default directory (root\SAFS).

• -staf "alternate STAF directory"
  Install STAF files and services to the user specified directory instead of the default install directory.
  The -staf argument does not have to be specified to install to the default directory (root\STAF).

• -overlay SAFSSnapshot.ZIP
  Overlay SAFS files over an existing SAFS installation.
  The -safs argument does not have to be specified to overlay the default directory (root\SAFS).
  The overlay can occur immediately following a new installation during the same class invocation.

• -removestaf installedstafdir stafMajorVersionTobeRemoved
  Remove the installed STAF. installedstafdir indicates the directory where staf is installed, like "C:\STAF\" or "/usr/local/staf" stafMajorVersionTobeRemoved indicates the major version of STAF, like 2 or 3

• -installstafversion installstafversion
  Indicate the major version of STAF you want to install. The default is 3. You can specify it to 2 for STAF 2.6.11 etc. You can specify it to 3 for STAF 3.3.3 etc. This option take effect only option "-nostaf" does NOT present

• -installstafexe alternateSTAFexecutable
  Indicate an alternate (newer) STAF installation executable to use.
  This will override the STAF 3 or later default executable.

• -removesafs installedsafs
  Remove the installed SAFS. installedsafs indicates the directory where SAFS is installed, like "C:\SAFS\" or "/usr/local/safs"

• -v
  Verbose to see the detail installation or un-installation information