diff options
Diffstat (limited to 'src/ceph/doc/start/quick-cephfs.rst')
| -rw-r--r-- | src/ceph/doc/start/quick-cephfs.rst | 119 |
1 files changed, 0 insertions, 119 deletions
diff --git a/src/ceph/doc/start/quick-cephfs.rst b/src/ceph/doc/start/quick-cephfs.rst deleted file mode 100644 index da4d84e..0000000 --- a/src/ceph/doc/start/quick-cephfs.rst +++ /dev/null @@ -1,119 +0,0 @@ -===================== - Ceph FS Quick Start -===================== - -To use the :term:`Ceph FS` Quick Start guide, you must have executed the -procedures in the `Storage Cluster Quick Start`_ guide first. Execute this quick -start on the Admin Host. - -Prerequisites -============= - -#. Verify that you have an appropriate version of the Linux kernel. - See `OS Recommendations`_ for details. :: - - lsb_release -a - uname -r - -#. On the admin node, use ``ceph-deploy`` to install Ceph on your - ``ceph-client`` node. :: - - ceph-deploy install ceph-client - - -#. Ensure that the :term:`Ceph Storage Cluster` is running and in an ``active + - clean`` state. Also, ensure that you have at least one :term:`Ceph Metadata - Server` running. :: - - ceph -s [-m {monitor-ip-address}] [-k {path/to/ceph.client.admin.keyring}] - - -Create a Filesystem -=================== - -You have already created an MDS (`Storage Cluster Quick Start`_) but it will not -become active until you create some pools and a filesystem. See :doc:`/cephfs/createfs`. - -:: - - ceph osd pool create cephfs_data <pg_num> - ceph osd pool create cephfs_metadata <pg_num> - ceph fs new <fs_name> cephfs_metadata cephfs_data - - -Create a Secret File -==================== - -The Ceph Storage Cluster runs with authentication turned on by default. -You should have a file containing the secret key (i.e., not the keyring -itself). To obtain the secret key for a particular user, perform the -following procedure: - -#. Identify a key for a user within a keyring file. For example:: - - cat ceph.client.admin.keyring - -#. Copy the key of the user who will be using the mounted Ceph FS filesystem. - It should look something like this:: - - [client.admin] - key = AQCj2YpRiAe6CxAA7/ETt7Hcl9IyxyYciVs47w== - -#. Open a text editor. - -#. Paste the key into an empty file. It should look something like this:: - - AQCj2YpRiAe6CxAA7/ETt7Hcl9IyxyYciVs47w== - -#. Save the file with the user ``name`` as an attribute - (e.g., ``admin.secret``). - -#. Ensure the file permissions are appropriate for the user, but not - visible to other users. - - -Kernel Driver -============= - -Mount Ceph FS as a kernel driver. :: - - sudo mkdir /mnt/mycephfs - sudo mount -t ceph {ip-address-of-monitor}:6789:/ /mnt/mycephfs - -The Ceph Storage Cluster uses authentication by default. Specify a user ``name`` -and the ``secretfile`` you created in the `Create a Secret File`_ section. For -example:: - - sudo mount -t ceph 192.168.0.1:6789:/ /mnt/mycephfs -o name=admin,secretfile=admin.secret - - -.. note:: Mount the Ceph FS filesystem on the admin node, - not the server node. See `FAQ`_ for details. - - -Filesystem in User Space (FUSE) -=============================== - -Mount Ceph FS as a Filesystem in User Space (FUSE). :: - - sudo mkdir ~/mycephfs - sudo ceph-fuse -m {ip-address-of-monitor}:6789 ~/mycephfs - -The Ceph Storage Cluster uses authentication by default. Specify a keyring if it -is not in the default location (i.e., ``/etc/ceph``):: - - sudo ceph-fuse -k ./ceph.client.admin.keyring -m 192.168.0.1:6789 ~/mycephfs - - -Additional Information -====================== - -See `Ceph FS`_ for additional information. Ceph FS is not quite as stable -as the Ceph Block Device and Ceph Object Storage. See `Troubleshooting`_ -if you encounter trouble. - -.. _Storage Cluster Quick Start: ../quick-ceph-deploy -.. _Ceph FS: ../../cephfs/ -.. _FAQ: http://wiki.ceph.com/How_Can_I_Give_Ceph_a_Try -.. _Troubleshooting: ../../cephfs/troubleshooting -.. _OS Recommendations: ../os-recommendations |