mirror of
https://github.com/xcat2/xcat-core.git
synced 2025-05-31 01:56:39 +00:00
Merge pull request #5310 from xuweibj/doc_confluent
modify confluent doc based on verification
This commit is contained in:
zet809
GitHub
commit
7b779e5b44
@ -14,15 +14,15 @@ It's recommenteed to create a non root user to use to connect to confetty
|
||||
|
||||
#. Create a non-root user on the management node: ::
|
||||
|
||||
useradd -m vhu
|
||||
useradd -m xcat
|
||||
|
||||
#. As root, create a non-root user in confetty: ::
|
||||
|
||||
/opt/confluent/bin/confetty create users/vhu
|
||||
/opt/confluent/bin/confetty create users/xcat
|
||||
|
||||
#. Set the password for the non-root user: ::
|
||||
|
||||
/opt/confluent/bin/confetty set users/vhu password="mynewpassword"
|
||||
/opt/confluent/bin/confetty set users/xcat password="mynewpassword"
|
||||
password="********"
|
||||
|
||||
|
||||
@ -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=xcat
|
||||
CONFLUENT_PASSPHRASE="mynewpassword"
|
||||
export CONFLUENT_USER CONFLUENT_PASSPHRASE
|
||||
|
||||
Start confetty, specify the server IP address: ::
|
||||
|
||||
confetty -s 127.0.0.1
|
||||
confetty -s <remote_ip>
|
||||
|
||||
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=<remote_ip>
|
||||
export CONFLUENT_HOST
|
||||
|
||||
|
||||
|
||||
@ -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 <http://xcat.org/files/confluent/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 <http://xcat.org/files/confluent/confluent-dep/>`_
|
||||
|
||||
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 <singlenode>
|
||||
|
||||
# If using confluent, a timestamp will be shown on the
|
||||
# console title next to the node name
|
||||
<singlenode> [15:05]
|
||||
|
||||
|
||||
|
||||
Web Browser access
|
||||
==================
|
||||
@ -124,31 +92,29 @@ Confluent-api and confluent-consoles are able to be accessed from the browser.
|
||||
It is **highly** recommended that you create a non-root user to access the sessions::
|
||||
|
||||
Create the non-root user on the management node
|
||||
# useradd -m vhu
|
||||
# useradd -m xcat
|
||||
|
||||
Create a non-root user in confetty
|
||||
# /opt/confluent/bin/confetty create users/vhu
|
||||
# /opt/confluent/bin/confetty create users/xcat
|
||||
|
||||
Set the password for the non-root user
|
||||
# /opt/confluent/bin/confetty set users/vhu password="mynewpassword"
|
||||
# /opt/confluent/bin/confetty set users/xcat password="mynewpassword"
|
||||
password="********"
|
||||
|
||||
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
|
||||
<Location /confluent-api>
|
||||
ProxyPass http://10.2.5.3:4005
|
||||
</Location>
|
||||
|
||||
#restart httpd
|
||||
|
||||
# restart httpd
|
||||
service httpd restart
|
||||
|
||||
Now point your browser to: ``http://<server ip>:<port>`` and log in with the non-root user and password created above.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user