Commit 17757ca1 authored by Sebastien Gardoll's avatar Sebastien Gardoll
Browse files

add some instructions about keytool

parent 2bec869e
Loading
Loading
Loading
Loading
+3 −3
Original line number Diff line number Diff line
.. _docker_swarm_setup_on_linux:

**************************
Docker Swam Setup on Linux
**************************
***************************
Docker Swarm Setup on Linux
***************************

Abstract
========
+3 −3
Original line number Diff line number Diff line
.. _docker_swarm_setup_on_macosx:

***************************
Docker Swam Setup on MacOSX
***************************
****************************
Docker Swarm Setup on MacOSX
****************************

Abstract
========
+9 −5
Original line number Diff line number Diff line
@@ -15,9 +15,13 @@ appropriate metadata tags are set for that node.
Pre-Requisites
==============

A Docker Swarm composed of 1 or more nodes. See specific instructions on
how to set this up on :ref:`a single MacOSX laptop <docker_swarm_setup_on_macosx>`, on the Amazon Cloud, or an
internal Linux cluster.
*  A host system with the latest version of Docker Engine installed (at
   this time, Docker 1.12+).
*  Java SDK (at this time 1.8), keytool is required (add it to the PATH var env).

*  A Docker Swarm composed of 1 or more nodes. See specific instructions on
   how to set this up on :ref:`a single MacOSX laptop <docker_swarm_setup_on_macosx>`, on 
   the Amazon Cloud, or :ref:`a single Linux machine <docker_swarm_setup_on_linux>`.

Setup
=====
@@ -26,7 +30,7 @@ Follow the same setup steps as for the :ref:`single_host_deployment`, namely:

*  Checkout the source code from this GitHub repository, on some
   location on the Swarm manager node. Use the *master* branch.
*  Define the environmental variables $ESGF_HOSTNAME, $ESGF_CONFIG,
*  Define the environmental variables $PATH (for keytool), $ESGF_HOSTNAME, $ESGF_CONFIG,
   $ESGF_VERSION and $ESGF_DATA_DIR. 
*  Initialize the ESGF node configuration: ./esgf_node_init.sh

@@ -56,7 +60,7 @@ Execution
      docker node update --label-add esgf_data_node=true node3

   Or, on a Swarm of 6 nodes, each label can be assigned to a different node 
   (as shown in the :ref:`single MacOSX laptop instructions <docker_swarm_setup_on_macosx>`).
   (as shown in the :ref:`single MacOSX laptop instructions <docker_swarm_setup_on_macosx>` or :ref:`single Linux laptop instructions <docker_swarm_setup_on_linux>`).

*  From the source code directory on the Swarm manager node, issue the
   following command to deploy the stack of ESGF services, then wait for
+5 −1
Original line number Diff line number Diff line
@@ -19,7 +19,7 @@ Pre-Requisites

*  A host system with the latest version of Docker Engine installed (at
   this time, Docker 1.12+). Tested on MacOSX and Linux CentOS.
*  Java SDK (at this time 1.8), keytool is required.
*  Java SDK (at this time 1.8), keytool is required (add it to the PATH var env).
*  Docker-compose (at this time 1.14.0), installation procedure
   `here <https://docs.docker.com/compose/install/#install-compose>`__

@@ -40,6 +40,10 @@ Setup

*  Define your environment:

   * Add the path to the keytool install directory::
   
       export PATH='/path/to/keytool/install/dir':$PATH
   
   *  **ESGF_HOSTNAME** must reference the Fully Qualified Domain Name of the host where the containers will be running:

     * On linux, use the actual server host name::
+8 −8
Original line number Diff line number Diff line
@@ -6,7 +6,7 @@
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>Docker Swam Setup on Linux &#8212; ESGF-Docker Documentation</title>
    <title>Docker Swarm Setup on Linux &#8212; ESGF-Docker Documentation</title>
    
    <link rel="stylesheet" href="_static/nature.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
@@ -27,7 +27,7 @@
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="search.html" />
    <link rel="next" title="Versioning Guideline" href="versioning_guideline.html" />
    <link rel="prev" title="Docker Swam Setup on MacOSX" href="docker_swarm_setup_on_macosx.html" /> 
    <link rel="prev" title="Docker Swarm Setup on MacOSX" href="docker_swarm_setup_on_macosx.html" /> 
  </head>
  <body role="document">
    <div class="related" role="navigation" aria-label="related navigation">
@@ -40,7 +40,7 @@
          <a href="versioning_guideline.html" title="Versioning Guideline"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="docker_swarm_setup_on_macosx.html" title="Docker Swam Setup on MacOSX"
          <a href="docker_swarm_setup_on_macosx.html" title="Docker Swarm Setup on MacOSX"
             accesskey="P">previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">ESGF-Docker Documentation</a> &#187;</li> 
      </ul>
@@ -51,8 +51,8 @@
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <div class="section" id="docker-swam-setup-on-linux">
<span id="docker-swarm-setup-on-linux"></span><h1>Docker Swam Setup on Linux<a class="headerlink" href="#docker-swam-setup-on-linux" title="Permalink to this headline"></a></h1>
  <div class="section" id="docker-swarm-setup-on-linux">
<span id="id1"></span><h1>Docker Swarm Setup on Linux<a class="headerlink" href="#docker-swarm-setup-on-linux" title="Permalink to this headline"></a></h1>
<div class="section" id="abstract">
<h2>Abstract<a class="headerlink" href="#abstract" title="Permalink to this headline"></a></h2>
<p>This page instructs on how to setup a Docker Swarm cluster on a single Linux system,
@@ -243,7 +243,7 @@ of the ESGF services in the stack, no matter on which node they are deployed.</p
        <div class="sphinxsidebarwrapper">
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">Docker Swam Setup on Linux</a><ul>
<li><a class="reference internal" href="#">Docker Swarm Setup on Linux</a><ul>
<li><a class="reference internal" href="#abstract">Abstract</a></li>
<li><a class="reference internal" href="#notes">Notes</a></li>
<li><a class="reference internal" href="#tested-versions">Tested versions</a></li>
@@ -259,7 +259,7 @@ of the ESGF services in the stack, no matter on which node they are deployed.</p

  <h4>Previous topic</h4>
  <p class="topless"><a href="docker_swarm_setup_on_macosx.html"
                        title="previous chapter">Docker Swam Setup on MacOSX</a></p>
                        title="previous chapter">Docker Swarm Setup on MacOSX</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="versioning_guideline.html"
                        title="next chapter">Versioning Guideline</a></p>
@@ -294,7 +294,7 @@ of the ESGF services in the stack, no matter on which node they are deployed.</p
          <a href="versioning_guideline.html" title="Versioning Guideline"
             >next</a> |</li>
        <li class="right" >
          <a href="docker_swarm_setup_on_macosx.html" title="Docker Swam Setup on MacOSX"
          <a href="docker_swarm_setup_on_macosx.html" title="Docker Swarm Setup on MacOSX"
             >previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">ESGF-Docker Documentation</a> &#187;</li> 
      </ul>
Loading