Patch 2 (#101)

* Fixed the code block formating * Fixing formatting errors * Fixing formatting errors * Fixing formatting errors * Fixing formatting errors * Fixing formatting errors * Fixing formatting errors * Fixing Formatting
cvmfs · Mar 19, 2019 · cc6c5ae · cc6c5ae
1 parent 7ff9c24
commit cc6c5ae
Showing 1 changed file with 42 additions and 33 deletions.
diff --git a/cpt-quickstart.rst b/cpt-quickstart.rst
@@ -16,73 +16,82 @@ On macOS, mounting and un-mounting of the CernVM-FS is done by the user with ``s
 
 Getting the Software
 --------------------
-
 The CernVM-FS source code and binary packages are available from the `CernVM website <https://cernvm.cern.ch/portal/filesystem/downloads>`_.
 However it is recommended to use the available package repositories that are also provided for the supported operating systems.
 
 Scientific Linux/CentOS
-~~~~~~~~~~~~~~~~
-    ::
-	sudo yum install https://ecsft.cern.ch/dist/cvmfs/cvmfs-release/cvmfs-release-latest.noarch.rpm
-	sudo yum install -y cvmfs
+-----------------------
+To add the CVMFS repository and install CVMFS run
+::
+    sudo yum install https://ecsft.cern.ch/dist/cvmfs/cvmfs-release/cvmfs-release-latest.noarch.rpm
+    sudo yum install -y cvmfs
 
 Debian/Ubuntu
-~~~~~~~~~~~~~
-    ::
-	wget https://ecsft.cern.ch/dist/cvmfs/cvmfs-release/cvmfs-release-latest_all.deb
-	sudo dpkg -i cvmfs-release-latest_all.deb
-	rm -f cvmfs-release-latest_all.deb
-	sudo apt-get update
-	sudo apt-get install cvmfs
+-------------
+To add the CVMFS repository and install CVMFS run
+::
+    wget https://ecsft.cern.ch/dist/cvmfs/cvmfs-release/cvmfs-release-latest_all.deb
+    sudo dpkg -i cvmfs-release-latest_all.deb
+    rm -f cvmfs-release-latest_all.deb
+    sudo apt-get update
+    sudo apt-get install cvmfs
 
 Fedora
-~~~~~~
-    ::
-	sudo dnf install https://ecsft.cern.ch/dist/cvmfs/cvmfs-2.5.2/cvmfs-2.5.2-1.fc29.x86_64.rpm https://ecsft.cern.ch/dist/cvmfs/cvmfs-config/cvmfs-config-default-latest.noarch.rpm
+------
+To install the CVMFS package run
+::
+    sudo dnf install https://ecsft.cern.ch/dist/cvmfs/cvmfs-2.5.2/cvmfs-2.5.2-1.fc29.x86_64.rpm https://ecsft.cern.ch/dist/cvmfs/cvmfs-config/cvmfs-config-default-latest.noarch.rpm
 
 Mac OS X
-~~~~~~~~
+--------
+
 Install the CernVM-FS package by opening the .pkg file.
 
 
 Seting up the Software
 ----------------------
+
 Configure AutoFS
-~~~~~~~~~~~~~~~~
+----------------
+
 For the basic setup, run ``cvmfs_config setup``. 
 This ensures that ``/cvmfs /etc/auto.cvmfs`` is set in /etc/auto.master and that the autofs service is running.
 Reload the autofs service in order to apply an updated configuration.
 
 Mac OS X
-~~~~~~~~
+--------
+
 On Mac OS X, CernVM-FS is based on `OSXFuse <http://osxfuse.github.io>`_.
 It is not integrated with autofs hence mount the individual repositories using
-    ::
-	sudo mkdir -p /cvmfs/cms.cern.ch
-        sudo mount -t cvmfs cms.cern.ch /cvmfs/cms.cern.ch
+::
+    sudo mkdir -p /cvmfs/cms.cern.ch
+    sudo mount -t cvmfs cms.cern.ch /cvmfs/cms.cern.ch
 
 Create default.local
-~~~~~~~~~~~~~~~~~~~~
-Create ``/etc/cvmfs/default.local` and open the file for editing.
+--------------------
+
+Create ``/etc/cvmfs/default.local`` and open the file for editing.
 Select the desired repositories by setting ``CVMFS_REPOSITORIES=repo1,repo2,...``. For ATLAS, for instance, set
-    ::
-	CVMFS_REPOSITORIES=atlas.cern.ch,atlas-condb.cern.ch,grid.cern.ch
-    Specify the HTTP proxy servers on your site with
-    ::
-        CVMFS_HTTP_PROXY="http://myproxy1:port|http://myproxy2:port"
+::
+    CVMFS_REPOSITORIES=atlas.cern.ch,atlas-condb.cern.ch,grid.cern.ch
+Specify the HTTP proxy servers on your site with
+::
+    CVMFS_HTTP_PROXY="http://myproxy1:port|http://myproxy2:port"
 If you're unsure about the proxy names, set ``CVMFS_HTTP_PROXY=DIRECT``.
 This should *only* be done for a small number of clients (< 5), because large numbers can put a heavy load on the Stratum 1 servers and result, amongst others, in poorer performance for the client.
 For the syntax of more complex HTTP proxy settings, see :ref:`sct_network`. 
 
 Verify the file system
-~~~~~~~~~~~~~~~~~~~~~~
+----------------------
+
 Check if CernVM-FS mounts the specified repositories by ``cvmfs_config probe``.
 If the probe fails, try to restart autofs with ``sudo systemctl restart autofs``.
 
 Building From Source
-~~~~~~~~~~~~~~~~~~~~
+--------------------
+
 The CernVM-FS client is not relocatable and needs to be installed under /usr.
-On Intel architectures, it needs a gcc :math:`\geq 4.2` compiler, on ARMv7 a gcc :math:`\geq 4.7` compiler. In order to compile and install from sources, use the following commands:
+On Intel architectures, it needs a gcc :math:`\geq 4.2` compiler, on ARMv7 a gcc :math:`\geq 4.7` compiler. In order to compile and install from sources, use the following commands
 ::
       cd <source directory>
       mkdir build && cd build
@@ -92,13 +101,13 @@ On Intel architectures, it needs a gcc :math:`\geq 4.2` compiler, on ARMv7 a gcc
 
 Troubleshooting
 ---------------
+
 In order to check for common misconfigurations in the base setup, run
 ::
       cvmfs_config chksetup
 
 CernVM-FS gathers its configuration parameter from various configuration files that can overwrite each others settings (default configuration, domain specific configuration, local setup, ...).
-To show the effective configuration for *repository*.cern.ch, run
-::
+To show the effective configuration for *repository*.cern.ch, run::
       cvmfs_config showconfig repository.cern.ch
 
 In order to exclude autofs/automounter as a source of problems, you can try to mount *repository*.cern.ch manually with the following