'''[ITracker] 설치 문서''''

-- 도화재 강빈

[ITracker]는 사용자 독립적인 여러 프로젝트를 지원하는 JAVA !J2EE 기반 Issue tracking system
입니다. 쉽게 말해, bugzilla, scarab 등등과 비슷한 버그 리포트 시스템과 같은데, 버그 뿐만
아니라 여러 Issue들을 관리하는 시스템이죠. bugzilla의 무겁고, 복잡한 인터페이스에 비해 
[ITracker]는 쉽고, 간단한 인터페이스로 되어 있습니다. 중소규모의 프로젝트에 적합한 이슈 트랙킹
시스템입니다.

 * Homepage: [http://www.cowsultants.com http://www.cowsultants.com]
 * Forum: [http://www.cowsultants.com/phpBB/index.php http://www.cowsultants.com/phpBB/index.php]
 * License: GPL

[[TableOfContents]]

== 준비물 ==
{{{
 1. Java SDK 1.3 with some additional libraries (see default.properties)
 2. J2EE 2.0 Application server (and web container)
 3. Relational database set up for use with your J2EE application server
 4. log4j 1.2.6+ : This is used for all application logging.  This must be
                 installed into your web and ejb application servers.
                 A copy of the jar file is included in the lib directory.
 5. Axis 1.1 if you wish to use the web services API (supplied in some versions)
}}}

메뉴얼에는 위처럼 되어 있지만, 다음처럼 준비해도 된다.

{{{
 1. ITracker 2.2.1
 2. JAVA SDK 1.3 이상
 3. jboss 3.2.x
 4. MySQL 4.0.x, MySQL Connector/J 3.0.x
}}}

== 다운로드 ==
다운로드 페이지에 가면 6개의 화일이 있는데, `itracker_2.2.1.noaxis.bin.zip` 을 받는다.

== 설치 ==
=== DB 설정 ===
아무곳에나 `itracker_2.2.1.noaxis.bin.zip` 을 풀고, `\itracker_2.2.1.noaxis.bin\itracker_2.2.1\sql\mysql\install` 에 보면, 두개의 sql 화일이 있다.

{{{
    create_itracker_core.sql
    create_mysql_user.sql
}}}

mysql에 db를 itracker로 만들고, `create_itracker_core.sql` 을 import 하여 테이블을 만든 후에, 다음 table을 추가한다.

{{{
CREATE TABLE JMS_MESSAGES ( 
  MESSAGEID INTEGER NOT NULL, 
  DESTINATION VARCHAR(255) NOT NULL, 
  TXID INTEGER, 
  TXOP CHAR(1), 
  MESSAGEBLOB BLOB, 
  PRIMARY KEY (MESSAGEID, DESTINATION) 
); 

CREATE TABLE JMS_TRANSACTIONS ( 
  TXID INTEGER
); 
}}}

`create_mysql_user.sql` 로 mysql에 사용자를 추가한다. (암호는 알아서 바꾼다.)

=== jboss에 deploy ===
`mysql-connector-java-3.0.11-stable-bin.jar` 파일을 `c:\jboss/server/default/lib` 에 복사한다.

`c:\jboss/docs/examples/jca/mysql-ds.xml` 화일을 `c:\jboss/server/default/deploy` 에 복사한 후에, `</datasources>` 위에 다음과 같이 추가한다.

{{{
    <local-tx-datasource>
      <jndi-name>ITrackerDS</jndi-name>
      <connection-url>jdbc:mysql://localhost:3306/itracker</connection-url>
      <driver-class>org.gjt.mm.mysql.Driver</driver-class>
      <user-name>itracker</user-name>
      <password>itracker</password>
    </local-tx-datasource>
}}}

`c:\jboss/server/default/conf/standardjbosscmp-jdbc.xml` 을 다음과 같이 고친다.

{{{
    <datasource>java:/DefaultDS</datasource>
    <datasource-mapping>Hypersonic SQL</datasource-mapping>
}}}

을 다음처럼 바꾼다.

{{{
    <datasource>java:/ITrackerDS</datasource>
    <datasource-mapping>mySQL</datasource-mapping>
}}}

`c:\jboss\server\default\conf\jboss-service.xml` 의 마지막 부분을

{{{
    <attribute name="RecursiveSearch">True</attribute>
}}}

로 고친다.

`c:\itracker_2.2.1\dist\itracker.ear` 화일을 `C:\jboss\server\default\deploy` 에 복사

=== JBOSS 실행 ===
{{{
   C:\jboss\bin\run.bat
}}}

== 실행 ==
{{{
  http://localhost:8080/itracker

  ID : admin
  PW : admin
}}}

----
CategoryDevelopment