-
Notifications
You must be signed in to change notification settings - Fork 168
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
add notes ob how to run IOR against ceph/demo
- Loading branch information
1 parent
fefefa0
commit bdf8e61
Showing
1 changed file
with
35 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
Following are basic notes on how to deploy the 'ceph/demo' docker container. The 'ceph/demo' container bootstraps a complete Ceph cluster with all necessary daemons already running, providing a convenient environment for evaluating the correctness of the RADOS backend for IOR, in our case. | ||
|
||
########################## | ||
# Pull 'ceph/demo' image # | ||
########################## | ||
|
||
Run `docker pull ceph/demo` to download the image to your system. | ||
|
||
################################ | ||
# Deploy 'ceph/demo' conatiner # | ||
################################ | ||
|
||
To deploy the Ceph cluster, execute the following command: | ||
|
||
`docker run -it --net=host -v /etc/ceph:/etc/ceph -e MON_IP=10.0.0.1 -e CEPH_PUBLIC_NETWORK=10.0.0.0/24 ceph/demo` | ||
|
||
The only necessary modification to the above command is to provide the correct network IP address for MON_IP and to provide the corresponding CIDR notation of this IP for CEPH_PUBLIC_NETWORK, as illustrated. | ||
|
||
NOTE: The above command starts the docker container in interactive mode. Replace '-it' with '-d' to run in the background as a daemon. | ||
|
||
############################### | ||
# Run IOR against 'ceph/demo' # | ||
############################### | ||
|
||
With a Ceph cluster now deployed, running IOR against it is straightforward: | ||
|
||
`./ior -a RADOS -- -u admin -c /etc/ceph/cephconf -p cephfs_data` | ||
|
||
All command line arguments following the '--' are required. | ||
|
||
-u is the Ceph username (e.g., admin) | ||
-c is the Ceph config file (typically found in /etc/ceph/ceph.conf) | ||
-p is the Ceph pool to perform I/O to (e.g., cephfs_data) | ||
|
||
NOTE: Permissions of the various config files, keyrings, etc. inside of /etc/ceph may need to be modified to be readable by the user running IOR (e.g., `sudo chmod 644 /etc/ceph/*`). These various files are created internally within the docker container and may not be readable by other users. |