mirror of
				https://github.com/xcat2/xcat-core.git
				synced 2025-10-31 11:22:27 +00:00 
			
		
		
		
	modify confluent doc based on verification
This commit is contained in:
		| @@ -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 | ||||
|  | ||||
|   | ||||
|   | ||||
| @@ -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 | ||||
| ================== | ||||
| @@ -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 | ||||
|     <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.  | ||||
|   | ||||
		Reference in New Issue
	
	Block a user