summary openfire info

I.setup
- step 1: execute installer
windows : just double click
linux : using rpm to install
in case of updating : just use rpm -U

- step 2: use browser to connect to port 9090 eg. http://xxxx:9090 as setup wizard
set language, time and database connection string that you should setup it first. see next topic.

II.configure external database.
Openfire provide database script in (/opt)/openfire/resources/database folder.
choose script that match with your DB server. Now we use Mysql then select "openfire_mysql.sql".
Copy it to your pc.

Go to mysqladmin (phpMyadmin or any MysqlGui). Create new database then run script openfire_mysql.sql.


In case of to change database after wizard installation..
- edit /opt/openfire/conf/openfire.xml
find and edit ..


com.mysql.jdbc.Driver
jdbc:mysql://xxxx:3306/openfire_linux
xxxx
xxxx
select 1
true
true
5
15
1.0




III.configure to enable http-bind in openfire (base on openfire version 3.5.0)
enable "HTTP Binding" and set port to selected port
at 'Server' tab > 'Server Setting' > 'HTTP Binging' column in the left


add system properties below if not exist
xmpp.httpbind.client.requests.polling = 0
xmpp.httpbind.client.requests.wait = 10

IV.configure to enable http-bind in apache
see http://www.igniterealtime.org/community/message/156841 and do as suggestion.
if still have problem, see http://www.linuxquestions.org/questions/linux-server-73/authentication-error-openfirejwchat-http-binding-612818/


Config the httpd.conf file of apache

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so


ServerName localhost
DocumentRoot /var/www/jwchat

Options +MultiViews

AddDefaultCharset UTF-8
ProxyPass /http-bind/ http://127.0.0.1:8080/http-bind/


V.Increase java memory
See installation manual : http://www.igniterealtime.org/builds/openfire/docs/latest/documentation/install-guide.html
windows Gui - create file name 'openfired.vmoptions' in {openfire path}/bin
- In this file, add the following lines...
-Xms512m
-Xmx1024m
- Restart openfire
windows service - same as normal but change filename to 'openfire-service.vmoptions'

linux manual run- edit /opt/openfire/bin/openfire.sh as http://www.igniterealtime.org/community/message/167950
linux service - see http://www.igniterealtime.org/community/message/151499
- edit /etc/sysconfig/openfire
- find and replace this line
OPENFIRE_OPTS="-Xms256m -Xmx512m"

VI.Add plugin
We can do it at web admin consule (http://xxxx:9090)
'Plugins' tab > Avaliable plugins
select to add plugins by click plus green button in the right (+).

useful plugin is 'User Import Export' plugin. because when we need to change database server, we can use this plugin to migrate all information of user in database without password problem.



VII.Manage user account : Use web admin console > 'Users/Group' tab > user > user summary
If we already installed 'user import/export' plugin, you will see 'Import/Export' sub tab...that we use this to import/export user from/into CSV format.

VIII.See concurrent user and manage (kick user) : also use web admin console > 'Sessions' tab > Active session > Client session
to kick user, use close connection X red button (x) at the right.



.. to enable or disable many feature of openfire, you can find some menu from web admin, rare case as to change database destination need to config in file in {openfire folder}/conf folder.



IX. Testing with ./jabsimule
See link http://www.ejabberd.im/benchmark
1. increase ulimit -n to more than defallt (I use 100000)
2. to generate userm use testsuite tools

cvs -z3 -d:pserver:anonymous@jabbertest.cvs.sourceforge.net:/cvsroot/jabbertest co testsuite
cd testsuite/
cp Makefile.linux Makefile
make userreg

in this package, it
have many tools inside..
use ./userreg to grnerate user name test_{number} to server. (use this tools is enought)
use ./pasvlogin to simulate authentication only with many user.


./userreg -h localhost -u 3000 -n 1
<-h openfire host>
<-u number of users to generate>
<-n number of start user> ex. want to genarate 100 user
we use -n 1 to generate from test_1 to test_100

after that we need to increase to 1000 users
we should us -u 900 -n 101 to generate 900 users start at number test_101

3. get jabsimul to generate bulk of user
wget http://www.ejabberd.im/files/other/jabsimul.tar.gz
tar xzf jabsimul.tar.gz

configure
in {installed folder}/jabsimule/jab_simul/jab_simul.xml

you can download example from 'http://tkabber.jabber.ru/files/badlop/jab_simul.xml.chat60'
to use, rename it to jab_simul.xml

run
call ./jab_simul
or ./jab_simul xxxx.xml if you like to use another configured file


limitation that we have found from using
1. jabsimul cannot simulate user more than around 7000 user per instant
so, you need to use more than 1 instant to simulate more user.
as...

17000

2. number of user to create cannot more than around 50000 ()

like below, jabsimul will occur 'segmentation falut'.


4900056000

to fix you can only reduce number to 50000,
as 4900050000

However, to simulate more user, you can edit jab_simul.xml to change 'resource' or create new series of user account.
(I use import/export plugin to rename from test_xxx to eidos_xxx)




see connerent user in web admin console, session tab.


create script test.sh
nohup /home/sang/jabsimul/jab_simul/jab_simul jab_simul_max${1}.xml > test${1}.log &
use
./test.sh 1 to run 1st configuration
./test.sh 2 to run ... config

X. Increase number of concurrent users which openfire server can support
see how to Increase java memory..
moreover, we found that we need to change ulimit of openfire server too.

XI.Connection Manager
1. go to http://www.igniterealtime.org/projects/openfire/connection_manager.jsp
download and extract connection manager
tar -xzvf connection_manager_3_0_0.tar.gz
mv connection_manager /opt

2. See documentation and installation guide in {connection manager folder}/documentaion/index.html

3. Check that server already install java jdk version more than 1.5 by java -version command
if not, you need to download new verion of java .rpm from java.sun.com

4. Go to openfire web admin(xxxx:9090) Server > Server settings > Connection managers
- tick enable, set port and set password
- click save setting

4. back to connection manager, edit configuration at {connection manager folder}/conf/manager.xml

find and fill information to it

enados.beta

5262

xxxx

5. to use more than 1 connection manager, you have to change this tag in xml file



cm1

1


5



madatory field is 1 that it is idenfied number of connectin manager
which have to be unique number in each connection manager.

6. To enable DNS and HTTP-Bind. We still cannot use this feature..
- To use httpbind it need some servlet java library and change to 'true'..
but It still have a problem with web client (xmpp4js) cannot connect.
- To use DNS, please find more information in connection manage documents

7. run {connection manager folder}/bin/cmanager.bat for windows or chamager.sh for linux

7.1 to increase java vm or fix some problem about java command calling to incorrect java jdk

go to {connection manager folder}/bin ,we can call java bu full path as below

/usr/java/jdk1.6.0_05/bin/java -Xms512m -Xmx1024m -jar ../lib/startup.jar

(in enados.beta I have already created script name is sangrun.sh in {CM folder}/bin)


XII.Clustering
see.. http://www.igniterealtime.org/community/docs/DOC-1471


====================
summary


configure database destination (connection string) : /opt/openfire/conf/openfire.xml at: jdbc:mysql://xxxx:3306/openfire_linux
configure Java VM Size : /etc/sysconfig/openfire at: OPENFIRE_OPTS="-Xms256m -Xmx512m"
configure Connection Manager : /opt/connection_manager/conf/manager.xml

In 'web admin of openfire' you can

change XMPP port,web admin port,SSL enable : at Server > Server manager > Server information > Edit Server Properties
Http bind port, Http bind configure : at Server > Server manager > System Properties
Custering (need to upgrade to Enterprise first) : at Server > Server manager > Clustering
Database stat : at Server > Server manager > Database
logs error : at Server > Server manager > logs

Connection manager : at Server > Server setting > Connection Managers
File transfer : at Server > Server setting > File Transfer Settings