Apollo Guide

63 Pages·2009·0.83 MB·English

by  Nanometrics Inc.

Apollo Project
Version 1.4
User Guide
SEISMOLOGICALINSTRUMENTS
Kanata, Ontario • Canada
© 2009 Nanometrics Inc. All Rights Reserved.
Apollo Project User Guide
The information in this document has been carefully reviewed and is believed to be reliable for
Apollo Project version 1.4. Nanometrics Inc. reserves the right to make changes at any time without
notice to improve the reliability and function of the product.
No part of this publication may be reproduced, stored in a retrieval system or transmitted, in any
form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without
the prior written permission of Nanometrics Inc.
Nanometrics Inc.
250 Herzberg Road
Kanata, Ontario, Canada K2K 2A1
Tel [phone]
Fax [phone]
Email [email protected]
www.nanometrics.ca
Part number 16106R5
Release date 2009-03-24
Document Conventions
Essential and Supplementary Information
Explains a risk of irreversible damage to data, software, or equipment
Warning and provides recommendations for preventive action.
Explains a risk of damage to data, software, or equipment where
Caution recovery is likely to be troublesome and provides recommendations for
preventive action.
Provides additional information related to the current text.
Note
Explains a best practice or provides helpful information related to the
Tip current text.
Provides an example related to the current text.
Example
Text Conventions
bold text Identifies referenced elements in the graphical user interface (GUI)
(forexample,“click Cancel to discard the changes”).
italic text Identifies variables such as parameter names and value placeholders
(for example, “select Configuration > Sensor Name”).
courier text Identifies commands that must be entered exactly as shown
(forexample,“type mkdir $APOLLO_LOCATION/config”).
Apollo Project User Guide iii
16106R5 (cid:138) 2009-03-24
Document Conventions
iv Apollo Project User Guide
16106R5 (cid:138) 2009-03-24
Contents
Document Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii
List of Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Chapter 1 Getting Started
1.1 About Apollo Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 Operating Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2.1 Software Licence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2.2 Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2.3 Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Chapter 2 Installing and Starting Apollo Project
2.1 Installing the Apollo Project Web Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1.1 Uninstalling Apollo Project Web Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.2 Installing an Apollo Project Licence File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.3 Starting the Apollo Project Web Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.4 Running Apollo Project Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.4.1 Troubleshooting Running Apollo Project Client. . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.4.2 Stopping the Apollo Project Web Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.5 Upgrading Apollo Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Chapter 3 Retrieving Data
3.1 Creating New Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.2 Creating a Station Table File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3.3 Configuring Apollo Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3.4 Managing Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.4.1 Viewing Existing Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.4.2 Opening a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.4.3 Creating a Desktop Shortcut to a Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.4.4 Closing a Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.4.5 Copying a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.4.6 Deleting a Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.5 Running Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.5.1 Running a Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.5.2 Stopping a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.5.3 Merging Project Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.5.4 Running a Scheduled Archive Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Apollo Project User Guide v
16106R5 (cid:138) 2009-03-24
Contents
3.5.4.1 Cancelling a Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.6 Editing and Viewing the Settings of Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.6.1 Editing Project Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.6.2 Viewing Project Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.7 Monitoring Project Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.7.1 Viewing an Overview of the Status of All Projects . . . . . . . . . . . . . . . . . . . . . . 32
3.7.2 Viewing the Status of an Individual Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.7.3 Monitoring the Status of a Running Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.7.3.1 Status Colours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.7.3.2 Viewing the Retrieval Details for Each Channel Group. . . . . . . . . . 35
Appendix A Reference Information and Examples
A.1 Overview of Running Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
A.2 Example Project Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
A.2.1 Example 1: One Time Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
A.2.2 Example 2: Controlled Source Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
A.3 Example Deployment Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
A.3.1 One Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
A.3.2 Scheduled Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
A.3.3 Manual Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
A.3.4 Field Archive. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
A.3.5 Media Harvesting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
A.3.6 Trigger Downloading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
A.4 Shot File Formats for Controlled Source Projects. . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
A.4.1 Creating a Shot File With Microsoft Office Excel . . . . . . . . . . . . . . . . . . . . . . . 42
A.4.2 Creating a Shot File With OpenOffice.org Calc . . . . . . . . . . . . . . . . . . . . . . . 44
A.4.3 Creating a Comma-Separated Values Shot File. . . . . . . . . . . . . . . . . . . . . . . 45
Appendix B Retrieving SOH Data from a Taurus Version 2.x
B.1 Taurus Version 2.x SOH Data Retrieved by Apollo Project . . . . . . . . . . . . . . . . . . . . 47
B.2 Retrieving SOH Data from a Taurus Version 2.x Streaming to Apollo Server. . . . . . 48
B.2.1 Streaming Data from a Taurus Version 2.x to Apollo Server . . . . . . . . . . . . . . 48
B.2.2 Retrieving Taurus Version 2.x Data from Apollo Server. . . . . . . . . . . . . . . . . . . 49
Appendix C Glossary
C.1 Glossary of Abbreviations and Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
C.2 List of Unit Abbreviations and Symbols. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
About Nanometrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Contacting Nanometrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Contacting Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
vi Apollo Project User Guide
16106R5 (cid:138) 2009-03-24
Contents
Tables
1-1 Requirements for an Apollo Project server running Windows . . . . . . . . . . . . . . . 3
1-2 Requirements for an Apollo Project server running Linux. . . . . . . . . . . . . . . . . . . 3
1-3 Requirements for an Apollo Project server running Mac OS X . . . . . . . . . . . . . . 3
2-1 Installation instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2-2 Uninstalling the Apollo Project Web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2-3 Starting the Apollo Project Web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3-1 Status colours. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
C-1 Unit abbreviations and symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Apollo Project User Guide vii
16106R5 (cid:138) 2009-03-24
Contents
viii Apollo Project User Guide
16106R5 (cid:138) 2009-03-24
Chapter 1
Getting Started
(cid:138) About Apollo Project
(cid:138) Operating Requirements
1.1 About Apollo Project
Apollo Project is a Web application that conveniently retrieves time series and state of
health data from any Nanometrics Store, including those on Nanometrics instruments and
those copied to network computers. Available through any Web browser, the client
application provides options for you to define complex, reusable data retrieval tasks called
projects.
Apollo Project has five project types:
(cid:138) Archive projects retrieve data from sources that are continually updated, such as a
directory on a computer that has new data saved to it periodically, or a multicast
group of Nanometrics instruments that has different instruments active at different
times. You can schedule Archive projects to run automatically.
(cid:138) One Time projects retrieve a single time segment of data.
(cid:138) Controlled Source projects retrieve data specified as a set of shots.
(cid:138) Triggers projects retrieve data specified by a trigger list in comma-separated value
(CSV) format.
(cid:138) Field Archive projects perform recurring data retrievals, storing the time of the current
retrieval on the Nanometrics instrument. Using the time of the last retrieval, Field
Archive projects only retrieve the data accumulated since the last time the project
was run on the instrument.
Data for time series channel groups can be downloaded in MiniSEED, SAC (binary format),
Seisan, or SEGY format, depending on the project type. Data for SOH channel groups is
always downloaded in CSV format.
Apollo Project User Guide 1
16106R5 (cid:138) 2009-03-24
Chapter 1 (cid:138) Getting Started
1.2 Operating Requirements
Apollo Project has licensing, client, and server operating requirements. These requirements
are listed in Section 1.2.1, Section 1.2.2, and Section 1.2.3.
1.2.1 Software Licence
If you have ordered and received an Apollo Project software licence from Nanometrics,
install this file during the Apollo Project Web server installation or later using the
Nanometrics Product Licence Installation Wizard. See Section 2.2 “Installing an Apollo
Project Licence File” on page 7 for licence installation instructions for Microsoft® Windows,
Linux, and Mac OS® X server installations.
Installing a licence file after creating a project in Apollo Project will result in the loss of that
project. It is recommended that you install your licence before running Apollo Project for the
first time.
The licence determines the number of projects you can save, the number of time series
channels you can select, and the number of projects you can run concurrently. Without a
licence, Apollo Project defaults to the unlicensed configuration. This configuration allows
you to save one project definition at a time for up to three time series channels from any
combination of Stores.
Click the About button in the client application to view licence information.
1.2.2 Client
The client requirements for any platform are a Web browser with JavaScript enabled and
IP access to the server. Apollo Project version 1.4 has been tested with Microsoft Internet
Explorer version 7 and Mozilla Firefox versions 2 and 3. Other browsers have not been fully
tested with the client but may be used at your discretion.
1.2.3 Server
Run the Apollo Project Web server on Windows, Linux, or Mac OS X. For the
(cid:138) Windows operating requirements, see Table 1-1 “Requirements for an Apollo Project
server running Windows” on page 3.
(cid:138) Linux operating requirements, see Table 1-2 “Requirements for an Apollo Project server
running Linux” on page 3.
(cid:138) Mac OS X operating requirements, see Table 1-3 “Requirements for an Apollo Project
server running Mac OS X” on page 3.
2 Apollo Project User Guide
16106R5 (cid:138) 2009-03-24