make printable	new:	see also:
	v1.4: - supporting both DFOS and PHOENIX	databases none dfos tools dfosInstall output $DFO_MON_DIR/dfosExplorer.html upload/download download: - .reference.installation from www.eso.org/~qc/dfos/tools if DFOS - .reference.installation_phoenix from www.eso.org/~qc/dfos/tools if PHOENIX

dfosExplorer

Description

This tool is an interactive DFOS GUI. It provides

• a graphical overview of the status of your DFOS installation
• an overview of all relevant configuration files
• options to edit them.

With version 1.4, the tool supports both the standard DFOS installations and the PHOENIX installations (with stripped-off DFOS tool set and added PHOENIX tools). The tool recognizes automatically which reference file to use (from the key THIS_IS_PHOENIX in .dfosrc).

If your browser is configured properly, it offers you an automatic download of the latest tool version if a mismatch between your installation and the standard DFOS installation is discovered. If you have dfosInstall installed (e.g. by using dfosExplorer), the downloaded tar file will be unpacked, and the makefile will be used to update your installation. If not, the unpacking and distribution of the components has to be done by you.

The tool is called once from the command line and creates the web page dfosExplorer.html under $DFO_MON_DIR. That page can be refreshed anytime interactively. The best way of operating it is as cronjob, using the tool dfosCron.

The tool scans all DFOS tools against a reference installation (see below), checks their version, provides links to update if a mismatch is found, links to the documentation pages, and offers editing of the associated configuration files. It also displays some additional information, like workflow steps and comments.

The HTML table is structured into

• tools for infrastructure
• tools for the daily workflow
• tools for the packing workflow.

The HTML page also links to its own configuration file, to a help page which decodes the table columns, and to the DFOS installation site.

Output

dfosExplorer.html under $DFO_MON_DIR, plus some helper scripts under $DFO_GUI_DIR. The helper scripts are refreshed anytime the tool is called.

How to use

Type dfosExplorer -h for on-line help, dfosExplorer -v for the version, and

dfosExplorer

to analyze your DFOS installation.

Installation

1. Setup the initialization file .dfosrc (in your $HOME directory) properly. Check out here for details. Make sure that it is sourced properly.

If no DFOS variable is defined, the tool will stop.

If you have installed dfosInstall , simply call dfosInstall -t dfosExplorer. If not, proceed as follows:

2. Download the tar file into $DFO_INSTALL_DIR/<tool_name>. Go there, and type

tar xvf dfosExplorer.tar

You may want to read the README file first.

3. There is the configuration file config.dfosExplorer, to go to $DFO_CONFIG_DIR. The config file needs no editing.

4. There is an on-line manpage dfosExplorer.h, to go to $DFO_DOC_DIR. There is also dfosExplorer_help.html which is expected under $DFO_MON_DIR.

5. The tool itself goes to $DFO_BIN_DIR.

Tune your browser

Make sure your browser is tuned to work as interactive GUI. If so, you can click on the config file links to open an editor session; on the red ball to download an update. Check here how to achieve browser tuning for dfos.

Configuration file

config.dfosExplorer defines:

Status information

Operational aspects

• You will need to call dfosExplorer from the command line only once. After that you can refresh it anytime using the 'refresh' button.
• Probably the best way of operating it is to wrap it into a cronjob and check the HTML page from time to time.
• The tool is designed to collaborate closely with dfosInstall. Once you detect an installation mismatch, you may want to click on the red button(s) and update your installation.

The tool uses wget to downlad a reference installation file into your system. This reference installation file is called .reference.installation and is available on qc@stargate1 under dfos/tools. Its the central QC memory about the dfos installation. You are not supposed to touch it.

For a PHOENIX installation, the mechanism is the same, except for the fact that the reference file is different, .reference.installation_phoenix.