Getting Started
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
To build from source, ensure your machine has the correct development packages to build rpms, then execute the following:
Clone the git repo:
git clone https://github.com/xcat2/confluent.gitBuild the
confluent-server
andconfluent-client
packages:cd confluent/confluent_server ; ./buildrpm ; cd - cd confluent/confluent_client ; ./buildrpm ; cd -
Install
dependency
The following example describes the steps for rhels7.5 on ppc64le:
yum install libffi-devel.ppc64le
yum install openssl-devel
pip install crypto pyasn1 pycrypto eventlet pyparsing netifaces scrapy pysnmp paramiko pyghmi pyte
confluent
Installing xCAT-confluent
via rpm:
rpm -ivh /root/rpmbuild/RPMS/noarch/confluent_server-*.noarch.rpm --nodeps
rpm -ivh /root/rpmbuild/RPMS/noarch/confluent_client-*.noarch.rpm --nodeps
You may find it helpful to add the confluent paths into your system path:
CONFLUENTROOT=/opt/confluent
export PATH=$CONFLUENTROOT/bin:$PATH
export MANPATH=$CONFLUENTROOT/share/man:$MANPATH
Configuration
Starting/Stopping confluent
To start confluent:
service confluent start
To stop confluent:
service confluent stop
If you want confluent daemon to start automatically at bootup, add confluent service to chkconfig
:
chkconfig confluent on
Replacing conserver with confluent
A new keyword, consoleservice
, has been added to the xCAT site table to allow the system administrator to control between conserver and confluent. If consoleservice
is not set, default behavior is to use conserver.
Set the consoleservice to confluent:
chdef -t site consoleservice='confluent'
Run makeconfluentcfg
to create the confluent configuration files:
makeconfluentcfg
Use rcons
as before to start the console session.:
rcons <singlenode>
Web Browser access
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 xcat
Create a non-root user in confetty
# /opt/confluent/bin/confetty create users/xcat
Set the password for the non-root user
# /opt/confluent/bin/confetty set users/xcat password="mynewpassword"
password="********"
Rest Explorer
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
LoadModule proxy_http_module modules/mod_proxy_http.so
<Location /confluent-api>
ProxyPass http://10.2.5.3:4005
</Location>
# 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.
Confluent consoles
confluent-web is provided in a subdirectory under the confluent project confluent_web
Download the content of that directory to /var/www/html/confluent
and point your browser to:
http://<server ip>/confluent/consoles.html