diff --git a/docs/source/advanced/confluent/client/confluent_client.rst b/docs/source/advanced/confluent/client/confluent_client.rst index 1c1bfe5b2..8fdce725f 100644 --- a/docs/source/advanced/confluent/client/confluent_client.rst +++ b/docs/source/advanced/confluent/client/confluent_client.rst @@ -40,13 +40,19 @@ If you want to use the xCAT Keys, you can simple copy them into ``/etc/confluent cp /etc/xcat/cert/server-key.pem /etc/confluent/privkey.pem cp /etc/xcat/cert/server-cert.pem /etc/confluent/srvcert.pem +The user and password may alternatively be provided via environment variables: :: + + CONFLUENT_USER=vhu + CONFLUENT_PASSPHRASE="mynewpassword" + export CONFLUENT_USER CONFLUENT_PASSPHRASE Start confetty, specify the server IP address: :: confetty -s 127.0.0.1 +If you want to run a confluent command against another host, could set the CONFLUENT_HOST variable: :: - -TODO: Add text for exporting user/pass into environment + CONFLUENT_HOST=127.0.0.1 + export CONFLUENT_HOST diff --git a/docs/source/advanced/confluent/server/confluent_server.rst b/docs/source/advanced/confluent/server/confluent_server.rst index 8591055ee..c0634506b 100644 --- a/docs/source/advanced/confluent/server/confluent_server.rst +++ b/docs/source/advanced/confluent/server/confluent_server.rst @@ -2,33 +2,11 @@ Getting Started =============== -For xCAT 2.9.1 and later, confluent is intended to be used in conjunction with xCAT. +Confluent is intended to be used in conjunction with xCAT. The following documentation assumes that xCAT is already installed and configured on the management node. -Download -======== - -confluent ---------- - -rpms -~~~~ - -The latest confluent rpms are built and provided for your convenience: `confluent rpms `_. However, the rpms are not built on a regular release schedule. To use the latest code base, consider building the rpms from :ref:`label_confluent_source`. - -The following example downloads the confluent tar package and creates a local repository on your management node:: - - mkdir ~/confluent - cd ~/confluent - wget https://path-to-confluent/confluent-X.X-repo.tbz2 - tar jxvf confluent-X.X-repo.tbz2 - cd confluent-X.X - ./mklocalrepo.sh - -.. _label_confluent_source: - -source -~~~~~~ +Download confluent +================== To build from source, ensure your machine has the correct development packages to build rpms, then execute the following: @@ -42,33 +20,26 @@ To build from source, ensure your machine has the correct development packages t cd confluent/confluent_client ; ./buildrpm ; cd - -confluent-dep -------------- - -The latest confluent dependency packages are provided for your convenience: `confluent-deps `_ - -The following example describes the steps for **rhels7.1** on **ppc64le**:: - - mkdkir ~/confluent - cd ~/confluent - wget https://path/to/confluent-dep/rh7/ppc64le/confluent-dep-rh7-ppc64le.tar.bz2 - tar -jxvf confluent-dep-rh7-ppc64le.tar.bz2 - cd confluent-dep-rh7-ppc64le/ - ./mklocalrepo.sh - -.. note:: If the OS/architecture you are looking for is not provided under confluent-dep, send an email to the xcat-user mailing list: xcat-user@lists.sourceforge.net - - Install ======= -*confluent and confluent-deps must be downloaded to the management node before installing* +dependency +---------- -xCAT 2.9.1 began shipping a new rpm ``xCAT-confluent``. +The following example describes the steps for **rhels7.5** on **ppc64le**:: -Installing ``xCAT-confluent`` via yum will pull in the confluent dependencies:: + yum install libffi-devel.ppc64le + yum install openssl-devel + pip install crypto pyasn1 pycrypto eventlet pyparsing netifaces scrapy pysnmp paramiko pyghmi pyte - yum install xCAT-confluent + +confluent +--------- + +Installing ``xCAT-confluent`` via rpm:: + + rpm -ivh /root/rpmbuild/RPMS/noarch/confluent_server-*.noarch.rpm + rpm -ivh /root/rpmbuild/RPMS/noarch/confluent_client-*.noarch.rpm You may find it helpful to add the confluent paths into your system path:: @@ -76,6 +47,7 @@ You may find it helpful to add the confluent paths into your system path:: export PATH=$CONFLUENTROOT/bin:$PATH export MANPATH=$CONFLUENTROOT/share/man:$MANPATH + Configuration ============= @@ -92,7 +64,8 @@ To stop confluent:: If you want confluent daemon to start automatically at bootup, add confluent service to ``chkconfig``:: - chkconfig --add confluent + chkconfig confluent on + Replacing conserver with confluent ---------------------------------- @@ -111,11 +84,6 @@ Use ``rcons`` as before to start the console session.:: rcons - # If using confluent, a timestamp will be shown on the - # console title next to the node name - [15:05] - - Web Browser access ================== @@ -136,19 +104,17 @@ It is **highly** recommended that you create a non-root user to access the sessi Rest Explorer ============= -TODO: some intro text - Configure the httpd configuration for confluent-api by creating a ``confluent.conf`` file under ``/etc/httpd/conf.d/`` directory:: The example uses server ip: 10.2.5.3 and port 4005 - cat /etc/httpd/conf.d/confluent.conf + # cat /etc/httpd/conf.d/confluent.conf LoadModule proxy_http_module modules/mod_proxy_http.so ProxyPass http://10.2.5.3:4005 - - #restart httpd + + # restart httpd service httpd restart Now point your browser to: ``http://:`` and log in with the non-root user and password created above.