From: Frederic Bonnard <frediz(a)linux.vnet.ibm.com&gt; It was originally in section 1 and name was kimchid.1 It got moved to kimchid.8 but not changed in .TH --- docs/kimchid.8 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/kimchid.8 b/docs/kimchid.8 index 072a16c..f5fa90a 100644 --- a/docs/kimchid.8 +++ b/docs/kimchid.8 @@ -1,4 +1,4 @@ -.TH KIMCHI 1 "February 05, 2015" "Version 1.4.0" "Kimchi Manual" +.TH KIMCHI 8 "February 05, 2015" "Version 1.4.0" "Kimchi Manual" .SH NAME Kimchi \- HTML5 based management tool for KVM .SH SYNOPSIS -- 1.9.1

--- configure.ac | 1 + docs/Makefile.am | 2 + docs/kimchid.8 | 156 ------------------------------------------------------ docs/kimchid.8.in | 156 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 159 insertions(+), 156 deletions(-) delete mode 100644 docs/kimchid.8 create mode 100644 docs/kimchid.8.in diff --git a/configure.ac b/configure.ac index 48873b2..f5091b8 100644 --- a/configure.ac +++ b/configure.ac @@ -78,6 +78,7 @@ AC_CONFIG_FILES([ po/gen-pot Makefile docs/Makefile + docs/kimchid.8 src/Makefile src/distros.d/Makefile src/nginx/Makefile diff --git a/docs/Makefile.am b/docs/Makefile.am index a22fe1a..2f686f1 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -27,3 +27,5 @@ dist_doc_DATA = \ kimchi-templates.png \ kimchid.8 \ $(NULL) + +CLEANFILES = kimchid.8 diff --git a/docs/kimchid.8 b/docs/kimchid.8 deleted file mode 100644 index f5fa90a..0000000 --- a/docs/kimchid.8 +++ /dev/null @@ -1,156 +0,0 @@ -.TH KIMCHI 8 "February 05, 2015" "Version 1.4.0" "Kimchi Manual" -.SH NAME -Kimchi \- HTML5 based management tool for KVM -.SH SYNOPSIS -.B kimchid -[\fB-h\fP|\fB--help\fP] [\fB--host\fP \fIhost\fP] [\fB--port\fP \fIport\fP] -[\fB--ssl-port\fP \fIssl_port\fP] [\fB--cherrypy_port\fP \fIcherrypy_port\fP] -[\fB--log-level\fP \fIlog_level\fP] [\fB--access-log\fP \fIaccess_log\fP] -[\fB--error-log\fP \fIerror_log\fP] [\fB--environment\fP \fIenvironment\fP] -[\fB--federation\fP \fIfederation\fP] [\fB--test\fP] -.SH DESCRIPTION -\fBKimchi\fP is an HTML5 based management tool for KVM. It is designed to make -it as easy as possible to get started with KVM and create your first guest. -\fBkimchid\fP launches the daemon on the hypervisor host which manages KVM guests through -libvirt. The management interface is accessed over the web using a browser that -supports HTML5. -.SH OPTIONS -The following options are supported: -.TP -\fB-h\fP , \fB--help\fP -Show this help message and exit. -.TP -\fB--host\fP \fIhost\fP -Specify the hostname or IP to listen on. -.TP -\fB--port\fP \fIport\fP -Specify the HTTP port (default \fI8000\fP). -.TP -\fB--ssl-port\fP \fIssl_port\fP -Specify the HTTPS port (default \fI8001\fP). -.TP -\fB--cherrypy_port\fP \fIcherrypy_port\fP -Specify the Cherrypy server port (default \fI8010\fP). -.TP -\fB--log-level\fP [\fIdebug\fP | \fIinfo\fP | \fIwarning\fP | \fIerror\fP | \fIcritical\fP] -Specify the log level (default \fIdebug\fP). -.TP -\fB--access-log\fP \fIaccess_log\fP -Specify the access log location where kimchi should create the access log file. -.TP -\fB--environment\fP [\fIdevelopment\fP | \fIproduction\fP] -Specify the running environment of kimchi server. Check cherrypy documentation for more details (default \fIproduction\fP). -.TP -\fB--federation\fP [\fIon\fP | \fIoff\fP] -Register and discover Kimchi peers in the same network using OpenSLP. Check -below the \fBFEDERATION\fP section for more details (default \fIoff\fP). -.TP -\fB--test\fP -Run kimchi on a mock version that does not affect the system. For testing proposals. -.SH FEDERATION -Federation feature is a mechanism to discover Kimchi peers in the same network. -It uses OpenSLP tool (http://www.openslp.org/) to register and find the Kimchi -servers. - -By default this feature is disabled on Kimchi as it is not critical for KVM -virtualization and requires additional software installation. - -To enable it, do the following: - -1. Install OpenSLP server package - -2. OpenSLP uses port 427 (UDP) and port 427 (TCP) so make sure to open those - ports in your firewall configuration - - For system using firewalld, do: - sudo firewall-cmd --permanent --add-port=427/udp - sudo firewall-cmd --permanent --add-port=427/tcp - sudo firewall-cmd --reload - - For openSUSE systems, do: - sudo /sbin/SuSEfirewall2 open EXT TCP 427 - sudo /sbin/SuSEfirewall2 open EXT UDP 427 - - For system using iptables, do: - sudo iptables -A INPUT -p tcp --dport 427 -j ACCEPT - sudo iptables -A INPUT -p udp --dport 427 -j ACCEPT - -3. In addition to the OpenSLP ports, you also need to allow multicast in the - firewall configuration - - For system using firewalld, do: - sudo firewall-cmd --direct --add-rule ipv4 filter INPUT 0 -s <subnet> -j ACCEPT - - For openSUSE systems, do: - Add the subnet to the trusted networks listed on FW_TRUSTED_NETS in - /etc/sysconfig/SuSEfirewall2 file. - Make sure to restart /sbin/SuSEfirewall2 after modifying /etc/sysconfig/SuSEfirewall2 - - For system using iptables, do: - sudo iptables -A INPUT -s <subnet> -j ACCEPT - -4. Start slpd service and make sure it is up while running Kimchi - sudo service slpd start - -5. Enable federation on Kimchi by editing the /etc/kimchi/kimchi.conf file: - - federation = on - -6. Then start Kimchi service - sudo service kimchid start - -The Kimchi server will be registered on OpenSLP on server starting up and will -be found by other Kimchi peers (with federation feature enabled) in the same -network. -.SH LICENCE -.br -Kimchi is distributed pursuant to the terms of two different licenses. -The user interface (located in ui/ in this distribution) is governed by -the Apache License version 2.0. - -The code under ui/spice-html5 is imported from spice-html5 project -(http://cgit.freedesktop.org/spice/spice-html5) and the code under ui/libs which is -imported from JQuery UI (http://jqueryui.com) - -The rest of this distribution is governed by the GNU Lesser General Public -License version 3. - -See COPYING.LGPL and COPYING.ASL2. -.SH BUGS -Current bugs can be found here : https://github.com/kimchi-project/kimchi/issues -.br -If you find any, please open an issue : https://github.com/kimchi-project/kimchi/issues/new -.SH AUTHOR -\fBAdam King\fP <rak(a)linux.vnet.ibm.com&gt;, -\fBAdam Litke\fP <agl(a)linux.vnet.ibm.com&gt;, -\fBAdriano Botega\fP <abotega(a)linux.vnet.ibm.com&gt;, -\fBAlexandre Tanaka Hirata\fP <hirata(a)linux.vnet.ibm.com&gt;, -\fBAline Manera\fP <alinefm(a)br.ibm.com&gt;, -\fBapporc\fP <appleorchard2000(a)gmail.com&gt;, -\fBAnthony Liguori\fP <aliguori(a)us.ibm.com&gt;, -\fBBing Bu Cao\fP <mars(a)linux.vnet.ibm.com&gt;, -\fBChristy Perez\fP <christy(a)linux.vnet.ibm.com&gt;, -\fBCole Robinson\fP <crobinso(a)redhat.com&gt;, -\fBCrístian Viana\fP <vianac(a)linux.vnet.ibm.com&gt;, -\fBDaniel H Barboza\fP <danielhb(a)linux.vnet.ibm.com&gt;, -\fBEduardo Elias Ferreira\fP <edusf(a)linux.vnet.ibm.com&gt;, -\fBEli Qiao(Li Yong Qiao)\fP <taget(a)linux.vnet.ibm.com&gt;, -\fBHongliang Wang\fP <hlwang(a)linux.vnet.ibm.com&gt;, -\fBLeonardo Garcia\fP <lagarcia(a)br.ibm.com&gt;, -\fBLise Noble\fP <lwnoble(a)us.ibm.com&gt;, -\fBMalcolm Yu\fP <minghaoyusombie(a)gmail.com&gt;, -\fBMark Wu\fP <wudxw(a)linux.vnet.ibm.com&gt;, -\fBMei Na Zhou\fP <zhoumein(a)linux.vnet.ibm.com&gt;, -\fBPaulo Vital\fP <pvital(a)linux.vnet.ibm.com&gt;, -\fBPradeep K Surisetty\fP <psuriset(a)linux.vnet.ibm.com&gt;, -\fBRamon Medeiros\fP <ramonn(a)linux.vnet.ibm.com&gt;, -\fBRodrigo Trujilo\fP <rodrigo.trujillo(a)linux.vnet.ibm.com&gt;, -\fBRoyce Lv\fP <lvroyce(a)linux.vnet.ibm.com&gt;, -\fBShaoHe Feng\fP <shaohef(a)linux.vnet.ibm.com&gt;, -\fBShu Ming\fP <shuming(a)linux.vnet.ibm.com&gt;, -\fBToby Allsopp\fP <toby(a)MI6.GEN.NZ&gt;, -\fBTony Breeds\fP <tonyb(a)au1.ibm.com&gt;, -\fBXin BJ Ding\fP <xinding(a)cn.ibm.com&gt;, -\fBYu Xin Huo\fP <huoyuxin(a)linux.vnet.ibm.com&gt;, -\fBZhou Zheng Sheng\fP <zhshzhou(a)linux.vnet.ibm.com&gt;, -.SH SEE ALSO diff --git a/docs/kimchid.8.in b/docs/kimchid.8.in new file mode 100644 index 0000000..08e96e5 --- /dev/null +++ b/docs/kimchid.8.in @@ -0,0 +1,156 @@ +.TH KIMCHI 8 "February 05, 2015" "Version @PACKAGE_VERSION@" "Kimchi Manual" +.SH NAME +Kimchi \- HTML5 based management tool for KVM +.SH SYNOPSIS +.B kimchid +[\fB-h\fP|\fB--help\fP] [\fB--host\fP \fIhost\fP] [\fB--port\fP \fIport\fP] +[\fB--ssl-port\fP \fIssl_port\fP] [\fB--cherrypy_port\fP \fIcherrypy_port\fP] +[\fB--log-level\fP \fIlog_level\fP] [\fB--access-log\fP \fIaccess_log\fP] +[\fB--error-log\fP \fIerror_log\fP] [\fB--environment\fP \fIenvironment\fP] +[\fB--federation\fP \fIfederation\fP] [\fB--test\fP] +.SH DESCRIPTION +\fBKimchi\fP is an HTML5 based management tool for KVM. It is designed to make +it as easy as possible to get started with KVM and create your first guest. +\fBkimchid\fP launches the daemon on the hypervisor host which manages KVM guests through +libvirt. The management interface is accessed over the web using a browser that +supports HTML5. +.SH OPTIONS +The following options are supported: +.TP +\fB-h\fP , \fB--help\fP +Show this help message and exit. +.TP +\fB--host\fP \fIhost\fP +Specify the hostname or IP to listen on. +.TP +\fB--port\fP \fIport\fP +Specify the HTTP port (default \fI8000\fP). +.TP +\fB--ssl-port\fP \fIssl_port\fP +Specify the HTTPS port (default \fI8001\fP). +.TP +\fB--cherrypy_port\fP \fIcherrypy_port\fP +Specify the Cherrypy server port (default \fI8010\fP). +.TP +\fB--log-level\fP [\fIdebug\fP | \fIinfo\fP | \fIwarning\fP | \fIerror\fP | \fIcritical\fP] +Specify the log level (default \fIdebug\fP). +.TP +\fB--access-log\fP \fIaccess_log\fP +Specify the access log location where kimchi should create the access log file. +.TP +\fB--environment\fP [\fIdevelopment\fP | \fIproduction\fP] +Specify the running environment of kimchi server. Check cherrypy documentation for more details (default \fIproduction\fP). +.TP +\fB--federation\fP [\fIon\fP | \fIoff\fP] +Register and discover Kimchi peers in the same network using OpenSLP. Check +below the \fBFEDERATION\fP section for more details (default \fIoff\fP). +.TP +\fB--test\fP +Run kimchi on a mock version that does not affect the system. For testing proposals. +.SH FEDERATION +Federation feature is a mechanism to discover Kimchi peers in the same network. +It uses OpenSLP tool (http://www.openslp.org/) to register and find the Kimchi +servers. + +By default this feature is disabled on Kimchi as it is not critical for KVM +virtualization and requires additional software installation. + +To enable it, do the following: + +1. Install OpenSLP server package + +2. OpenSLP uses port 427 (UDP) and port 427 (TCP) so make sure to open those + ports in your firewall configuration + + For system using firewalld, do: + sudo firewall-cmd --permanent --add-port=427/udp + sudo firewall-cmd --permanent --add-port=427/tcp + sudo firewall-cmd --reload + + For openSUSE systems, do: + sudo /sbin/SuSEfirewall2 open EXT TCP 427 + sudo /sbin/SuSEfirewall2 open EXT UDP 427 + + For system using iptables, do: + sudo iptables -A INPUT -p tcp --dport 427 -j ACCEPT + sudo iptables -A INPUT -p udp --dport 427 -j ACCEPT + +3. In addition to the OpenSLP ports, you also need to allow multicast in the + firewall configuration + + For system using firewalld, do: + sudo firewall-cmd --direct --add-rule ipv4 filter INPUT 0 -s <subnet> -j ACCEPT + + For openSUSE systems, do: + Add the subnet to the trusted networks listed on FW_TRUSTED_NETS in + /etc/sysconfig/SuSEfirewall2 file. + Make sure to restart /sbin/SuSEfirewall2 after modifying /etc/sysconfig/SuSEfirewall2 + + For system using iptables, do: + sudo iptables -A INPUT -s <subnet> -j ACCEPT + +4. Start slpd service and make sure it is up while running Kimchi + sudo service slpd start + +5. Enable federation on Kimchi by editing the /etc/kimchi/kimchi.conf file: + + federation = on + +6. Then start Kimchi service + sudo service kimchid start + +The Kimchi server will be registered on OpenSLP on server starting up and will +be found by other Kimchi peers (with federation feature enabled) in the same +network. +.SH LICENCE +.br +Kimchi is distributed pursuant to the terms of two different licenses. +The user interface (located in ui/ in this distribution) is governed by +the Apache License version 2.0. + +The code under ui/spice-html5 is imported from spice-html5 project +(http://cgit.freedesktop.org/spice/spice-html5) and the code under ui/libs which is +imported from JQuery UI (http://jqueryui.com) + +The rest of this distribution is governed by the GNU Lesser General Public +License version 3. + +See COPYING.LGPL and COPYING.ASL2. +.SH BUGS +Current bugs can be found here : https://github.com/kimchi-project/kimchi/issues +.br +If you find any, please open an issue : https://github.com/kimchi-project/kimchi/issues/new +.SH AUTHOR +\fBAdam King\fP <rak(a)linux.vnet.ibm.com&gt;, +\fBAdam Litke\fP <agl(a)linux.vnet.ibm.com&gt;, +\fBAdriano Botega\fP <abotega(a)linux.vnet.ibm.com&gt;, +\fBAlexandre Tanaka Hirata\fP <hirata(a)linux.vnet.ibm.com&gt;, +\fBAline Manera\fP <alinefm(a)br.ibm.com&gt;, +\fBapporc\fP <appleorchard2000(a)gmail.com&gt;, +\fBAnthony Liguori\fP <aliguori(a)us.ibm.com&gt;, +\fBBing Bu Cao\fP <mars(a)linux.vnet.ibm.com&gt;, +\fBChristy Perez\fP <christy(a)linux.vnet.ibm.com&gt;, +\fBCole Robinson\fP <crobinso(a)redhat.com&gt;, +\fBCrístian Viana\fP <vianac(a)linux.vnet.ibm.com&gt;, +\fBDaniel H Barboza\fP <danielhb(a)linux.vnet.ibm.com&gt;, +\fBEduardo Elias Ferreira\fP <edusf(a)linux.vnet.ibm.com&gt;, +\fBEli Qiao(Li Yong Qiao)\fP <taget(a)linux.vnet.ibm.com&gt;, +\fBHongliang Wang\fP <hlwang(a)linux.vnet.ibm.com&gt;, +\fBLeonardo Garcia\fP <lagarcia(a)br.ibm.com&gt;, +\fBLise Noble\fP <lwnoble(a)us.ibm.com&gt;, +\fBMalcolm Yu\fP <minghaoyusombie(a)gmail.com&gt;, +\fBMark Wu\fP <wudxw(a)linux.vnet.ibm.com&gt;, +\fBMei Na Zhou\fP <zhoumein(a)linux.vnet.ibm.com&gt;, +\fBPaulo Vital\fP <pvital(a)linux.vnet.ibm.com&gt;, +\fBPradeep K Surisetty\fP <psuriset(a)linux.vnet.ibm.com&gt;, +\fBRamon Medeiros\fP <ramonn(a)linux.vnet.ibm.com&gt;, +\fBRodrigo Trujilo\fP <rodrigo.trujillo(a)linux.vnet.ibm.com&gt;, +\fBRoyce Lv\fP <lvroyce(a)linux.vnet.ibm.com&gt;, +\fBShaoHe Feng\fP <shaohef(a)linux.vnet.ibm.com&gt;, +\fBShu Ming\fP <shuming(a)linux.vnet.ibm.com&gt;, +\fBToby Allsopp\fP <toby(a)MI6.GEN.NZ&gt;, +\fBTony Breeds\fP <tonyb(a)au1.ibm.com&gt;, +\fBXin BJ Ding\fP <xinding(a)cn.ibm.com&gt;, +\fBYu Xin Huo\fP <huoyuxin(a)linux.vnet.ibm.com&gt;, +\fBZhou Zheng Sheng\fP <zhshzhou(a)linux.vnet.ibm.com&gt;, +.SH SEE ALSO -- 1.9.1