make printable	new:	see also:
	v1.0.2: dataclient removed v1.1: - supporting DFOS and PHOENIX	databases none dfos tools dfosExplorer output none upload/download download: - .reference.installation from www.eso.org/~qc/dfos/tools (dfos), or .reference.installation_phoenix (for phoenix) - tar ball of selected tool installation

dfosInstall

Description

The DFOS installation tool retrieves a DFOS tool package(s) from a server, unpacks the tar ball(s), and executes a makefile to install the DFOS tool.

The tool uses $DFO_INSTALL_DIR to create a subdirectory <tool_name>, under which the tar file is deposited and unpacked. From there the following components are distributed using the makefile:

• the tool itself (and maybe some other associated software) goes to $DFO_BIN_DIR
• its associated documentation (usually the .h = help file) goes to $DFO_DOC_DIR
• the associated config files (with prefix config or extensions .cfg or .rules) go to $DFO_CONFIG_DIR/template. That directory will be created (if not existing already).

The tool asks about the installation mode: upgrade (an older installation exists already) or full. For 'upgrade', the existing config files are not touched, the delivered config files go into the template directory where they are available for comparison. In mode 'full', the delivered config files are written into $DFO_CONFIG_DIR where they are expected and read by the tool. Any pre-existing config file is saved under $DFO_CONFIG_DIR/save.

All other information (including the README file and the makefile) remains in $DFO_INSTALL_DIR/<tool_name>. A pre-existing tar file is saved as tar.old (to have some sort of backup just in case).

The tool is designed to cooperate with dfosExplorer. Whenever that tool discovers a missing, or outdated, installation, it offers an upgrade for which it will use dfosInstall. It is, however, also possible to use the tool from the command line.

How to use

dfosInstall -v|--version     gives the version number
dfosInstall -h|--help        gives a short help text

dfosInstall -t|--tool {name} installs the specified tool

Installation

If you have installed dfosExplorer, use that tool to download the tar file for you.

Otherwise download dfosInstall.tar into $DFO_INSTALL_DIR/dfosInstall.

1. Go there, and type

tar xvf dfosInstall.tar

You may want to read the README file first.

2. Put dfosInstall to $DFO_BIN_DIR.

3. Put config.dfosInstall to $DFO_CONFIG_DIR.

4. Put dfosInstall.h to $DFO_DOC_DIR.

Configuration file

config.dfosInstall has the following content (which you normally don't need to touch):

Operational considerations

• Once you have installed the tool 'by hand', you can call it afterwards to do other installations for you, including a self-installation:
  dfosInstall -t dfosInstall.
• If the tool to install has a makefile in its tar file (which is now the standard case), this will be executed and do most (if not all) installation work for you. Typically an incremental installation (new version of a tool without changes of associated config files) can be handled completely by dfosInstall.
• If there is no makefile, the tool will stop and you are requested to process along the README file.
• The tool is designed to collaborate with dfosExplorer, the tool to monitor your DFOS installation and detect new versions or tools automatically. If you click on an installation button, the incremental installation will execute as described above.
• After you have installed dfosInstall and dfosExplorer, you will no longer need to run either of these tool from the command-line (but you could of course).