Step 1: Install Software

Step 1: Install Software

Introduction

이 튜토리얼은 JDK와 아파치 더비 소프트웨어를 필요로 한다.

첫번째, 이 섹션에서 설명된것은 JDK릴리즈 버젼을 요구하며, 이미 설치가 되어 있지 않다면 설정과, 설치에 대한 내용을 봐야한다.

다음으로 Apache Derby소프르웨어를 어떻게 설치할지 보여줄 것이다. 설정과 더비 임베디드 JDBC드라이버를 이용한 환경 설정과 Derby sysinfo툴을 이용하여 인스톨 검증에 대해서 논의한다.

Java Development Kit (JDK)

더비는 J2SE 1.4.2 혹은 더 높은 것을 요구한다. 튜토리얼은 (JDK 1.5를 이용한다., JRE는 더비가 실행할때 필요하다.JRE만 더비를 실행할때 필요하다.

이미 JDK가 설치되어 있다면 verify 설정파일을 이용하여 Apache Derby 를 실행할 수 있을 것이다.

Install JDK

아직 설치된 JDK가 없다면 다운로드 받길 바란다. 오직 요구되는 JDK는 J2SE 1.4.2버젼 이상이면 된다.

Configure JDK

JAVA_HOME를 환경변수에 설정하고 JDK의 루트 디렉토리를 지정한다. 아래 예를 보면 쉽게 알 수 있다.

Windows: C:\> set JAVA_HOME=C:\jdk1.5

UNIX Korn Shell: $ export JAVA_HOME=/opt/jdk1.5

다음으로 PATH 환경 변수에 JDK BIN디렉토리를 연결한다. PATH변수는 운영체제에 자바 인터프리터와 자바 컴파일러에 대한 위치를 알려주는 역할을 한다.

Windows: C:\> set PATH=%PATH%;%JAVA_HOME%\bin

윈도우에서는 이 값을  "My Computer" -> Advanced -> Environment"에 있는 변수에 지정한다.

UNIX Korn Shell: $ export PATH=$JAVA_HOME/bin:$PATH

Verify JDK

java -version 명령어를 이용하여 자바 버젼을 확인하자.

java -version java version "1.5.0_06" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05) Java HotSpot(TM) Client VM (build 1.5.0_06-b05, mixed mode, sharing)

다운로드 더비

더비 배포판을 다운로드 받기 위해서는 더비 웹사이트인 http://db.apache.org/derby/derby_downloads.html에서 받으면 된다.

이 튜토리얼은 10.4.1.3 버젼을 이용하였고 다음 테입블에 있는 바이너리 배포판을 받은 것을 전제로 한다.

Operating System	Download File
Windows	db-derby-10.4.1.3-bin.zip
UNIX, Linux, and Mac	db-derby-10.4.1.3-bin.tar.gz

더욱 최근 릴리즈를가 잇다면, 10.4.1.3 다음 버젼에 대체할 버젼을 다운 받으면 된다.

인스톨 하기

더비 소프트웨어를 설치할 디렉토리를 설정한다. 반드시 디렉토리 퍼미션에 쓰기 퍼미션이 필요하다. 샘플은 다음 위치를 이용한다.

윈도우 : C:\Apache

유닉스 : /opt/apache

실제로 동작할 위치를 지정하면 된다. 그런 다음 지정한 디렉토리에 압축을 해제한 파일을 복사하면 된다.

더비 인스톨 설정

DERBY_INSTALL 변수를 설정하여 인스톨된 더비를 가리키도록 한다. 아래 예를 보고 당신의 시스템에 맞게 이용하면 된다.

Windows: C:\> set DERBY_INSTALL=C:\Apache\db-derby-10.4.1.3-bin

UNIX Korn Shell: $ export DERBY_INSTALL=/opt/Apache/db-derby-10.4.1.3-bin

Embedded Derby 설정하기

Derby를 Embedded모드로 사용하기 위해서 CLASSPATH를 다음과 같이 설정하여 jar을 연결한다.

• derby.jar: JDBC드라이버를 포함한 더비와 더비 엔진을 포함하고 있다.
• derbytools.jar: 선택적이며, ij툴을 제공한다. 이것은 이번 튜토리얼의 2개 섹션에서 이용될 것이다.

아래와 같이 CLASSPATH에 명시적으로 설정해 준다.

Windows: C:\> set CLASSPATH=%DERBY_INSTALL%\lib\derby.jar;%DERBY_INSTALL%\lib\derbytools.jar;.

UNIX: $ export CLASSPATH=$DERBY_INSTALL/lib/derby.jar:$DERBY_INSTALL/lib/derbytools.jar:.

참고로 복합 요소를 지정하고자 할경우에는 윈도우에서는 (;)를, 유닉스에서는 (:)를 지정해야함을 기억해야한다.

더비 검증해 보기

sysinfo명령어를 실행하면 다음과 같이 더비 시스템 정보를 확인 할 수 있다.

java org.apache.derby.tools.sysinfo

Successful output will look something like this:

------------------ Java Information ------------------

Java Version: 1.5.0_06

Java Vendor: Sun Microsystems Inc.

Java home: C:\jdk1.5

Java classpath: C:\Apache\DB-DER~1.3-B\lib\derby.jar;C:\Apache\DB-DER~1.3-B\lib\derbytools.jar;

OS name: Windows XP

OS architecture: x86

OS version: 5.1

Java user name: user

Java user home: C:\Documents and Settings\user Java user dir: C:\Apache\db-derby-10.4.1.3-bin\bin java.specification.name: Java Platform

API Specification java.specification.version: 1.5

--------- Derby Information --------

JRE - JDBC: J2SE 5.0 - JDBC 3.0 [C:\Apache\db-derby-10.4.1.3-bin\lib\derby.jar] 10.4.1.3 - (648739) [C:\Apache\db-derby-10.4.1.3-bin\lib\derbytools.jar] 10.4.1.3 - (648739)

------------------------------------------------------

----------------- Locale Information -----------------

Current Locale : [English/United States [en_US]] Found support for locale: [cs] . . .

Found support for locale: [zh_TW] version: 10.4.1.3 - (648739)

------------------------------------------------------

출력 결과는 시스템에 따라 아마도 조금씩 다르게 나타날 것이다. 그러나 정상적으로 설정되었다면 어떠한 에러도 없이 위와 같은 내용이 나타날 것이다. 만약 아래와 같은 에러를 확인한다면 클래스 패스가 잘못 지정된 경우이다.

$ java org.apache.derby.tools.sysinfo Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/derby/tools/sysinfo

CLASSPATH를 에코해 보고 그 에코 내용을 따라가보면 확인할 수 있다.

Windows: C:\> echo %CLASSPATH% C:\Apache\DB-DER~1.3-B\lib\derby.jar;C:\Apache\DB-DER~1.3-B\lib\derbytools.jar;

UNIX: $ echo $CLASSPATH /opt/Apache/db-derby-10.4.1.3-bin/lib/derby.jar:/opt/Apache/db-derby-10.4.1.3-bin/lib/derbytools.jar:

sysinfo출력이 바른 정보로 출력되었다면 다음 단계로 넘어가면 된다. "Step 2: ij Basics".