github.com/whamcloud/lemur@v0.0.0-20190827193804-4655df8a52af/README.md (about)

     1  [![GoDoc](https://godoc.org/github.com/intel-hpdd/lemur/dmplugin?status.svg)](https://godoc.org/github.com/intel-hpdd/lemur/dmplugin)
     2  
     3  # HPDD HSM Agent and Data Movers for Lustre
     4  
     5  Lemur is new, open source implementation of HSM tools for the [Lustre Filesystem](http://lustre.org) based on this
     6  [design](https://wiki.hpdd.intel.com/display/PUB/HSM+Agent+Design). This project
     7  is developed by the Intel High Performance Data Division, one of the main
     8  contributors to the Lustre Filesystem. We welcome community involvement and
     9  contributions. If you would like to raise an issue or file a bug, please use the
    10  LMR project on our community [Jira
    11  server](https://jira.whamcloud.com/projects/LMR) instead of Github issues.
    12  
    13  
    14  ## Build
    15  
    16  We use Docker for building packages, so as long as you have Docker running,
    17  `make rpm` will take care of everything needed to create a clean build
    18  environment and build a set of Lemur RPMs. The results will be stored in
    19  `./output/RPMS`.
    20  
    21  For development and testing, it is generally more convenient to use a Linux host
    22  (or virtual machine) with Lustre installed. We recommend RHEL or CentOS 7.x,
    23  Lustre 2.7 or above, and at least Go 1.6.
    24  
    25  
    26  ## Testing Quickstart
    27  
    28  The unit tests are run with `make test` and do not require a Lustre environment
    29  to be configured.
    30  
    31  The user acceptance test (UAT) automates basic testing with the agent and
    32  datamovers. The harness does not manage Lustre filesystems -- you will need to
    33  create one and mount a client somewhere, and ensue the Coordinator is enabled on
    34  the MDT. The harness must run as root, because the agent must also run as root in
    35  order to fiddle with secure xattrs and do other root-y stuff.
    36  
    37  
    38  1. `make rpm`
    39  1. Copy built RPMs to Lustre client host and install them
    40  1. `sudo /usr/libexec/lemur-testing/lemur-uat-runner`
    41  
    42  Set [uat/README.md](uat/README.md) for more details on running and confgiuring the user acceptance tests.