# cephtools

## Summary

+ **Module Name:** cephtools
+ **Support Level:** Primary Support
+ **Software Access Level:** Open Access
+ **Home Page:** [https://github.com/umn-msi-lmnp/cephtools](https://github.com/umn-msi-lmnp/cephtools)

## Software Description

cephtools is a software package

## General Linux

To see which modules are available for loading you can run:

`module avail cephtools`

This will provide a list of all versions of the package, shown as cephtools/<version>.

To load a specific module for use in a Linux environment, run the command:

`module load cephtools/<version>`

For example, you can use the command `module load cephtools/4.1.1` to load version 4.1.1 
which is the current version available on our system.

To launch the package and view the help menu after it is loaded, use the command:

`cephtools help`

The `cephtools bucketpolicy` function is available to help MSI PIs to create Tier 2 buckets and set bucket access policies.
A simple example command would be:

```cephtools bucketpolicy -m --bucket "BUCKET-NAME"```

By default, all members of a PI project group will have read and write access to the bucket. 
If you need to update the policy file you can simply rerun to overwrite the current policy file.
For example, we can change the policy to only allow a list of 3 users to have read access to the bucket, by running the following command:

```cephtools bucketpolicy --bucket "BUCKET-NAME" -p LIST_READ --list x5001,x5002,x5003```

You will be able to check the policy files to confirm that only those 3 users have read access to the bucket.