Chapter 6. Study Installation
Prev   Next

Chapter 6. Study Installation

Table of Contents

6.1. A DFdiscover study
6.2. Installing the study

This chapter is optional, and generally will not be executed at the time of DFdiscover installation.

The study installation steps described in this chapter will only apply to DFdiscover installations where a new study is ready to be installed at the same time.

6.1. A DFdiscover study

To DFdiscover, a study definition comprises a parent directory and several sub-directories that hold study specific configuration information. As a result of this structure, a study definition can be easily transported by moving the parent directory to a new location. Everything that is needed by the study is contained within that parent directory.

6.2. Installing the study

[Important]Become super-user

The steps in this section must be executed by super-user.

Studies that are created by DF/Net Research, Inc. are typically distributed via download link, as a UNIX tar file. The procedure described here assumes this structure. Studies that are transported from other vendors or from affiliates within a company may be structured differently. This procedure may need to be modified to fit those specific conventions.

Study Installation

  1. Pre-requisite: Create a parent directory for all studies

    Generally, (but this is not a requirement) all DFdiscover studies exist under a common parent directory on the DFdiscover server. This directory is typically /opt/studies. Create the parent directory, if necessary [SS01]: 

    # mkdir -p /opt/studies

    and update the ownership of the directory so that it is owned by datafax and group studies: 

    # chown -R datafax /opt/studies
# chgrp -R studies /opt/studies

  2. Obtain the study tar image

    The remaining steps assume that the study tar image is available as /tmp/study.tar [SS02].

  3. Create a study folder and extract the contents of the tar image

    A study setup from DF/Net Research, Inc. will be rooted at the study directory and is easily extracted with tar. Create the study folder and extract the tar image contents with commands similar to this [SS03]: 

    # cd /opt/studies
# mkdir newstudy
# cd newstudy
# tar xpf /tmp/study.tar

    Example 6.1. Extracting study proto123

    # cd /opt/studies
# mkdir proto123
# cd proto123
# pwd
/opt/studies/proto123
# tar xpf /tmp/study.tar
bkgd/...
bkgd/...
...
#

  4. Update the file permissions and ownership of the extracted study

    The owner and group permissions of the extracted study must be updated to reflect the ids for user datafax and group studies present on the installed system. Update the permissions with the chown and chgrp commands [SS04].

    Example 6.2. Updating ownership and permissions

    # cd /opt/studies
# chown -R datafax proto123
# chgrp -R studies proto123


  5. Register the study to DFdiscover

    The local DFdiscover installation must now be made aware of the new study. This is accomplished by registering a new study with DFdiscover as described in DFadmin System Administrator Guide, StudyAddingAdding a New Study [SS05].

Prev   Next
Chapter 5. Integration Testing Home Chapter 7.  DFdiscover Acceptance Test Kit (ATK) Installation