Tigase Install

developer 2012. 4. 23. 14:47

이문서는 Xmpp 서버를 검토과정에서 Tigase를 설치할때 정리한 문서이다.

기본적을 Tigase  사이트를 번역한 내용이며  번역한 내용을 기준으로 실제 설치과정에서의 간단한 코멘트를 추가하였다..

좀더 정확한 내용을 참조하기 위해서는 원서를 확인하기 바란다. 


Tigase Quick Start

url : http://www.tigase.org/content/quick-start

이문서는 빠르게 tigase를 시작하게 하는 문서 이다.

모든 문서는 사용하거나 개발하는데 하나의 주제로 소개 된다.

원하는 주제에 대해 목록을 찾아 보고 없으면 연락 주라..

1. Installation using GUI installer
2. Installing using console installer
3. Manual installation in console mode
4. Tigase server binary updates


Installation using GUI installer


url : http://www.tigase.org/content/installation-using-gui-installer

수동으로 설치하지 않으려면 GUI 설치 프로그램을 사용할수 있다.

GUI 설치는 필요 서버 파일의 복사 뿐만아니라 환경설정 변수 및 database 까지 설치해준다.

이것은 Tigase를 설치 하기 위한 기본 방법이다.

Prerequisites (필요한것들..)

먼저 java가 설치 되어 있어야 한다. 설치할때는 JRE만 있어도 되지만 server구동에는 JDK가 필요하다.

최소 JDK 1.6이 필요하다.  JDK가 설치 되어 있지않다면 설치하라.

JDK를 설치 및 설정하면 tigase gui 설치 프로그램을 다운로드 받아 설치를 시작 할수 있다.

Download the installer

Tigase 사이트의 다운로드 섹션에서 최신 Tigase package를 다운로드 받을수 있다.

페이지에 들어가면 다운로드 받을수 있는 파일들이 나온다.

처음인 사용자는 선택 목록이 너무 많아서 혼란스러울수 있으나 그런 필요가 없다.

모든 tigase binary package는 쉽게 구별할수 있는 이름 규칙을 가지고 있다.

최신 버젼을 다운로드 받을것을 권장 한다.

Run the jar file

대부분의 시스템에서 JRE/JDK는 클릭또는 더블클릭을 통해서 기본으로 설치를 할수 있다.

이를 할수 없을때에는  수동으로  설치 해야 한다. ( 수동은 다음 단계를 수행해라. )

1. 윈도에서 설치시 command 창에서 java command를 사용할수 있다.

    ' 시작' 메뉴를 클릭하고 설치작업을 시작해라.

..... 이후 설치 작업은  UI 에서 간단한 설정 작업이라 다음 command 설치 부분으로 넘어간다.........

..... 실제 설치는 linux의 command로 진행 되므로 .......


 

Installing using console installer

url : http://www.tigase.org/content/installing-using-console-installer

Installation using the text-mode installer

console 모드의 설치는 4.1.5 버젼이후에서만 사용할수 있다.

Requirements and and important notice

설치전 유의 사항..

첫번째 알파버젼의 text mode  설치 - 서버를 설치하고 몇가지 기본적인 설정을 구성한다.

이부분에 대한 오류가 있으면 report를 feedback 달라...

Artur Hefczyc or Mateusz Fiołka 에게 메일을 보내라.

설치전 몇가지 추가단계를 수행해야 한다.

JDK 1.6버젼 이상 설치 .

이가이드는 고급 사용자를 대상으로 하고 있다. 따라서 JDK 설치에 대한건 알아서~..

Download the installer


download 섹션에 가서 설치할 파일을 다운로드 받아라....

Run the jar file


ssh 나 terminal에서 아래와 같이 입력하라.

java -jar nameOfTheDownloadedJarFile.jar -console

 

Installation steps

이제 설치할 준비가 됬다.

console 설치 작업을 위한 몇가지 tip

1. JDK 설치 위치를 기억하라 설치 작업에서 입력한다.

2. 설치 도중에 중단하면 진행된 설치 과정의 파일들이 삭제될수 있다.

3. 현재 설치 프로그램의 버젼이 베타정도이기때문에 고급 구성을 사용하는거은 권장되지 않는다 . 나중에 좀 개선할 예정~..

Initial screen

이초기 화면에는 서버버젼이 표기되고 tigase 개발자에게 뭔가 제안하고 싶을때..... 유용할것?

Welcome to the installation of Tigase XMPP (Jabber) Server X.Y.Z!
- Artur Hefczyc
The homepage is at: http://www.tigase.org/
press 1 to continue, 2 to quit, 3 to redisplay

JDK selection

현재 설치환경에 설치된 JDK가 여러개 일경우 하나를 선택한다.

JDK 경로에 대한 유효성 체크가 없기 때문에 알아서 제대로 입력하라..

The installed application needs a JDK. A java run-time
environment (JRE) will be not sufficient.
Enter path: /lib/jvm/java-6-sun

Actions selection

이미 서버가 설치되있다면 추가 설치를 할지아니면 설치된 서버의 configuration을 할지 결정

*** Select what you want to do next:
On this panel you can specify whether you want to install
only or configure already installed server or to do both. If
you are just installing a server on your machine it is a
good idea to do both steps.
-------------------
The wizards you want to execute
Installation of the Tigase Server
[on, off]
on
Configuration of the Tigase Server
[on, off]
on

Installer info

installer에 대한 소개

Please note!
While the Tigase server is quite stable and well tested
application the installer itself is a new addition. Take
precautions especially if you upgrade the server from
earlier version. Backup old server files and the database.
If you notice any problems please report them to address:
<a href="/user/1/contact">Artur Hefczyc</a>
press 1 to continue, 2 to quit, 3 to redisplay

 

Server info

정확히 tigase 서버가 무엇인지 모르는 경우, 이 화면에서 몇가지 기본적인 소개를 찾을수 있다.

Tigase XMPP (Jabber) server ver 4.1.5-bDEV
About
Copyright (C) 2004 Tigase.org. <http://www.tigase.org/>
Tigase Jabber/XMPP Server is
Open Source and Free (GPLv3)
Java based server. The goals behind the design and
implementation of the server are:
Make the server robust and reliable.
Make the server secure communication platform.
Make flexible server which can be applied to different use
cases.
Make extensible server which takes full advantage of XMPP
protocol extensibility.
--- Press ENTER to continue ---
Make the server easy to setup and maintain.
Installation, configuration and compilation
The most recent documentation on all these topics is always
available in the project website: www.tigase.org. Please
refer to the website for all the details and always up to
date guides.
You would probably want to start with Quick Start:
http://www.tigase.org/content/quick-start documentation.
The website also contains lots of other useful information
like load tests results, user discussions and on-line support
and help always available to you.
This is 4.1.5-bDEV release of the server. Please include the
exact version number in all correspondence regarding the
server.
press 1 to continue, 2 to quit, 3 to redisplay

Server licence

Tigase 서버를 사용하는데 동의 해야하는 라이센스 .

Please read the following license agreement carefully:
GNU General Public License - GNU Project - Free Software
Foundation (FSF)
GNU GENERAL PUBLIC LICENSE
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc.
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
...
... Fragment cut out
...
You should also get your employer (if you work as a
programmer) or school, if any, to sign a "copyright
disclaimer" for the program, if necessary. For more
information on this, and how to apply and follow the GNU
GPL, see --- Press ENTER to continue ---
<http://www.gnu.org/licenses/>.
The GNU General Public License does not permit incorporating
your program into proprietary programs. If your program is
a subroutine library, you may consider it more useful to
permit linking proprietary applications with the library.
If this is what you want to do, use the GNU Lesser General
Public License instead of this License. But first, please
read
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
1. I accept the terms of this license agreement.
2. I do not accept the terms of this license agreement.
Choose number (1-2):
1
press 1 to continue, 2 to quit, 3 to redisplay


Server location selection

서버가 설치될 경로를 입력한다. 관리자 권한으로 설치할 경우 모든 응용프로그램이 모여 있는 표준 경로에 설치 할 수 있다.

관리자 권한이 아니라면 쓰기 권한이 있는 경로로 지정한다.

Select target path
[/home/user/tigase] /home/user/tigase-server
press 1 to continue, 2 to quit, 3 to redisplay 1
Tistory 태그: ,

Selection of packs to be installed

일부팩은 옵션이고 사용여부는 설정할수 있다.

다음 화면에서 선택할수 있다.

선택항목의 번호를 입력하고 엔터를 입력하면 된다.

선택이 끝나면 d를 선택한다.

Select the packs you want to install:
1 => Base, The base files
2 => Unix Files, Files needed to run the server on Unix like systems
3 => [x] Docs, The documentation
4 => [x] Extras, Extras libraries, MUC, PubSub...
5 => [x] Derby Database, Derby database and JDBC driver
6 => [x] MySQL Database, MySQL JDBC driver (MySQL has to be
installed separately)
7 => [x] PostgreSQL Database, PostgreSQL JDBC driver
(PostgreSQL has to be installed separately)
8 => [x] SQL Server Database, SQL Server JDBC driver (SQL
Server has to be installed separately)
9 => [ ] Sources, The server source files, tools and
libraries sources are not included
r => Redisplay menu
d => Done
Choose action: d
press 1 to continue, 2 to quit, 3 to redisplay

Installation

설치가 진행되는 동안 설치상태가 프로그래스로 표기된다.

[ Starting to unpack ]
[ Processing package: Base (1/9) ]
[ Processing package: Unix Files (2/9) ]
[ Processing package: Windows Files (3/9) ]
[ Processing package: Docs (4/9) ]
[ Processing package: Extras (5/9) ]
[ Processing package: Derby Database (6/9) ]
[ Processing package: MySQL Database (7/9) ]
[ Processing package: PostgreSQL Database (8/9) ]
[ Processing package: SQL Server Database (9/9) ]
[ Unpacking finished ]

Basic configuration

이부분에 Tigase 서버의 가장 중요한 설정이 포함되어 있다.

서버를 실행할때 구동시킬 component를 선택하고  XMPP admin user의 계정정보를 입력한다. ( 하나이상의 관리자계정을 입력할 경우,로 구분한다. )

그리고 데이터 베이스를 선택한다.  현재 사용중인 DB가 없다면  DerbyDB를 사용할수도 있다.

중요사항 : Tigase 서버에서는 DB Driver를  포함하지 않는다. 예외로 JDK의 Derby Database만 포함한다.

                필요하다면  database에 대한 부분은 알아서 설치하라.

*** Basic Tigase server configuration
On this panel you can specify basic configuration settingsㅊ
for the Tigase server.
Based on your selection here more configuration options
might be presented later on. After the configuration is
complete init.properties file will be created.
You can optionally restart the server at the end of the
process if you like.
-------------------
0 [x] Default installation
1 [ ] Default plus extra components
2 [ ] Session Manager only
3 [ ] Network connectivity only
input selection:
0
Your XMPP (Jabber) domains [my-laptop]
Server administrators [admin@my-laptop]
Admin password [tigase]
0 [x] Derby (built-in database)
1 [ ] MySQL
2 [ ] PostgreSQL
3 [ ] SQLServer
4 [ ] Other...
input selection:
1

Advanced configuration

주의사항 : 이 버젼은 고급 구성을 지원하지 않는다 그러니 왠만하면 쓰라 마라..

Advanced configuration options
[on, off]
off
press 1 to continue, 2 to quit, 3 to redisplay

 

Database configuration

database 선택에 따라 연결 옵션을 설정할수 있다. 

*** Database configuration:
You have selected MySQL database. This database needs
additional configuration parameters. Please enter all
required information.
-------------------
MySQL super user account will be used only to create and
configure database for the Tigase server. It will not be
used by the Tigase server later on.
Super user account name: [root]
WARNING: password will be visible while entering
Super user password: mysecretpassword
WARNING: password will be visible while entering
Retype password: mysecretpassword
-------------------
MySQL database details. It will be created automatically if
it does not exist.
Database account: [tigase]
Account password: [tigase12]
Database name: [tigasedb]
Database host or IP: [localhost]
Additional database parameters: []
press 1 to continue, 2 to quit, 3 to redisplay

Database checking and preparation

데이터베이스 설정의 자동테스트가 이루어진다.

접속설정이  정상적으로 테스트 되면 DB 스키마를 변경하고 Xmpp 관리자를 추가한다.

Performing DB tasks
Checking connection to the database
Connection OK
Checking if the database exists
Exists OK
Checking the database schema
New schema loaded OK
Checking whether the database needs conversion
Conversion not needed
Adding XMPP admin accounts
Added admins OK

Installation complete

이제 서버를 시작하고 사용할수 있다.

Install was successful
application installed on /home/user/tigase-server
[ Console installation done ]

Running the sever

위에서 설치한 설치 디렉토리로 접근하여  scripts 하위 디렉토리로 이동하여 tigase.sh 파일로 서버를  시작할수 있다.

./scripts/tigase.sh start etc/tigase.conf

사용자 지정 설정파일이 있다면 마지막 명령을 변경하면 된다.

윈도우즈 플랫폼에서는 bat 파일을 이용한다. root 디렉토리의 run.bat 파일 있다. 실행하려면 그냥 더블클릭하거나  command에서 입력하면된다.

How to check if the server is running

서버가 제대로 실행되었는지 확인해 보려면은 xmpp 클라이언트를 연결해보면된다.


Manual installation in console mode


url : http://www.tigase.org/content/manual-installation-console-mode

Tigase 서버를 설치 하기위한 방법으로 GUI Install 과 Binary package 와 께 제공되는 프로그램이다.

다운로드 섹션에서 최신 버젼을 받아라.

이미 서버를 가지고 있고 업그레이드 하려고 한다면 반드시 backup 먼저 해라...

Get the binary package

.zip , .tar.gz 파일로 메뉴얼 설치를 할수 있다.

Unpack the package

아래 명령으로 압축을 해제 한다.

tar -xzvf tigase-server-x.y.z-bv.tar.gz

or

unzip tigase-server-x.y.z-bv.zip

압축을 해제하면 tigase-server-x.y.z-bv/. 경로가 생길것이다.

압축을 해제하면 시작 스크립의 실행 권한이 없을수 있다.

아래 명령어로 실행권한을 줄수 있다.

chmod u+x ./scripts/tigase.sh

 

Prepare configuration


압축해제한 경로를 보면 아래와 같은 목록을 볼수 있을 것이다.

$ ls -l
total 316K
-rw-r--r-- 1 265K 2008-12-15 22:24 ChangeLog
-rw-r--r-- 1 37K 2008-12-15 22:24 License.html
-rw-r--r-- 1 1.1K 2008-12-15 22:24 README
drwxr-xr-x 6 204 2009-02-03 13:25 certs/
drwxr-xr-x 22 748 2009-02-03 13:25 database/
drwxr-xr-x 3 102 2008-12-15 22:24 docs/
drwxr-xr-x 4 136 2009-02-03 13:25 etc/
drwxr-xr-x 3 102 2009-02-03 13:25 jars/
drwxr-xr-x 12 408 2009-02-03 13:25 libs/
drwxr-xr-x 2 68 2008-12-15 22:24 logs/
-rw-r--r-- 1 1.5K 2008-12-15 22:24 package.html
drwxr-xr-x 7 238 2009-02-03 13:25 scripts/

그중 중요한 파일 두개를 가지고 있는 etc 디렉토리이다.

$ ls -l etc/
total 8.0K
-rw-r--r-- 1 97 2008-12-15 22:24 init.properties
-rw-r--r-- 1 333 2008-12-15 22:24 tigase.conf

tigase.conf 에 대한변경이 필요하다.

JAVA_HOME에 대한 변경이다.

JAVA_HOME="${JDKPath}"

java 경로를 ${JDKPath}로 바꾼다.

init.properties 파일도 수정이 필요하다.

init.properties에는 구성프로그램 에서 설정한 초기 매개 변수가 있다.

이파일을 직접 수정해야 한다.

$ cat etc/init.properties
config-type=--gen-config-def
--admins=admin@$HOST_NAME
--virt-hosts = $HOST_NAME
--debug=server

$HOST_NAME 부분을 Xmpp 설치에 사용된 도메일이름으로 교체한다.

'jabber.your-great.net' 이라고 가정하면

아래와 같이 수정된다.

$ cat etc/init.properties
config-type=--gen-config-def
--admins=admin@jabber.your-great.net
--virt-hosts = jabber.your-great.net
--debug=server

원한다면 여러개의 가상 도메인을 사용할수 있다.

가상도메인에 대한 부분은 따로 조사해봐라.

데이터 베이스에 대한  연결도 수정해야한다.

먼저 어떤 DB를 쓸것인지 결정하고  연결 문자열을 지정한다.

$ cat etc/init.properties
config-type=--gen-config-def
--admins=admin@jabber.your-great.net
--virt-hosts = jabber.your-great.net
--debug=server
--user-db=derby
--user-db-uri=jdbc:derby:/var/lib/tigase/derby

Prepare database

아래 명령으로  DB를 구성한다. (Derbi DB 인경우이다. )

$ ./scripts/derby-db-create.sh /var/lib/tigase/derby

위 실행에 아무런 오류 메세지가 없다면 정상적으로 수행됬다는 얘기...

* 권한에 따라 설치 경로를 다른경로로 해야할 경우도 생길수 있다. 

 

Start the server

아래 명령으로 서버를 실행할수 있다.

./scripts/tigase.sh start etc/tigase.conf

실행하면 아래와 같은 로그를 볼수 있다.

Starting Tigase:
2
nohup: redirecting stderr to stdout
3
Tigase running pid=18103

Check if it is working

서버가 실행되었는지는 로그를 확인해보라. 몇가지 로그 파일이 생성된다.

$ ls -l logs/
total 40K
-rw-r--r-- 1 20K 2009-02-03 21:48 tigase-console.log
-rw-r--r-- 1 16K 2009-02-03 21:48 tigase.log.0
-rw-r--r-- 1 0 2009-02-03 21:48 tigase.log.0.lck
-rw-r--r-- 1 6 2009-02-03 21:48 tigase.pid

tigase-console.log , tigase.log.0. 파일은 제한된 정보이지만 중료한 항목이 포함되어 있다.

로그의 심각한 오류가 있는지 확인하라..

이제 jabber 클라이언트와 연결할수 있다.

클라이언트 계정을 등록하려면 클라이언트 설명서를 참조하라.

'developer' 카테고리의 다른 글

Tigase Source Compile  (0) 2012.04.23
Tigase Server Binary Update  (0) 2012.04.23
Tigase Install  (0) 2012.04.23
패턴 이야기  (0) 2011.11.23
코드 커버리지 측정 도구 클로버  (1) 2011.11.17
Deview 2011  (0) 2011.11.16
Posted by 살사, 안드로이드, 다우기술, 스타일리쉬 초롬[yellowish green]
TAG ,

댓글을 달아 주세요