Child pages
  • User Guide
Skip to end of metadata
Go to start of metadata

Data Management system offers user interfaces that allow users to start, manage, and consume experiments.

Users with a Manager or Principal Investigator role will access DM Experiment Gui UI to start an experiment, or will access the DM Web Portal to maintain an experiment.

A user that only consumes the data can access the DM Web Portal to view experiments, and will access Globus.org site to download the experiment data.

The user interfaces are described in more details in the following sections. Specifically we address how to access the UI, and the functions.

1. DM Experiment Gui

2. DM Web Portal

3. Globus

1. DM Experiment Gui

  • Configuration

The Data Acquisition (DAQ) service may be configured in different ways. In the simplest configuration the DAQ transfers data to the Storage. In another configuration the DAQ service can transfer data to another DAQ (receiving), and the receiving DAQ would transfer the data to storage. The second configuration will be used by beamlines that wish to run additional processing on the data, and store the processed data as well.

During the Gui installation user is prompted to enter configuration data, such as the Data Acquisition Service machine, and the root data directory where the data is collected for each DAQ machine that will be used in DM system deployed on the beamline.

If any of the information are to change, the configuration file located at <installationDir>/ExperimentSynchronizer/resources/config.properties can be modified accordingly.

  • Access

The DM Experiment Gui will be accessible through desktop application launcher.

If there is no launcher available (for example running remotely) the gui can be accessed by typing:

sh <installationDir>/ExperimentSynchronizer/run_expSync.sh

  • Functions

The first window will take user credentials and the sector number.

Temporary the username/password are not required.

Authenticated and authorized for the sector user will access next gui window that has an input in calendar form for a date range. The “Retrieve experiments” button action will bring a list of experiments scheduled for the given sector that the start date falls within the date range.

The selected experiments can be transferred to the DM system, can be transferred and started, started, or stopped.

The transferred experiments will be added to the DM database, including the start and end dates, and the participating users. In addition, a user group named as experiment name is being created that includes all experiment users.

The start of experiments means that a new directory <data root dir>/yyyy-mm/<experiment name> is created on a DAQ machine and observed for any files. The <data root dir> is specified in the config.properties configuration file, as described under “installation and configuration” paragraph. An experiment that has started will have the directory monitored and any new file in the directory tree is transferred to the storage. The started experiment is observed until it is stopped.

2. DM Web Portal

  • Access

https://xstor-devel.xray.aps.anl.gov:8181/dm

  • Functions

User can log in to the portal with the DM System credentials, i.e. "d" letter followed by a badge number as username, and the APS password. After successful login the portal allows to select next page from the top menu. Typically user will access "Users" tab or "Experiments" tab.

The "Users" tab will bring a list of all registered user. The list can be searched, and a user can be selected through “info” action button. The info displays additional information for the selected user including a list of experiments the user has a role in.

The “Experiment” tab will bring a list of experiments the user has a role in. Likewise, the list can be searched. Any experiment from the list can be viewed in more details by selecting “info” action button. The experiment page contains information about the experiment, the policies that apply to this experiment, and shows all users and their roles in this experiment.

[More functions will be added in second release.

3. Globus

  • Access
    globus.org
    Globus is a public web application that provides research data management. It allows a user to transfer data from one end point to another. The DM system leverages the functionality to provide secure data access.
  • Usage
    To access Data Management storage the user will login with the Globus account credentials, and select “Transfer Files”. 
    Enter DM system Endpoint, which is aps#dtn01.
    The root path to the Experiments data is /data/ESAF/. From this root directory the user can access the experiment directories trees. The directory tree mirrors the directory structure on DAQ machine. User can access and transfer only the files that are in a experiment directory tree in which the user has a role.
  • No labels