본문으로 건너뛰기
버전: 3.4.4

웹어드민

본 문서에서는 Installer를 이용한 BXI웹어드민 설치 방법을 설명한다.

설치​

1. bxi admin installer 실행​

bash bxi_admin_3.4.4-${TAG_NAME}.bin

2. 엔진타입 입력​

설치할 엔진 타입을 FEP, MCI, EAI 중 설정한다.

###########################################

     BXI WebAdmin Installation
     3.4.4-${TAG_NAME}

###########################################

1) FEP
2) MCI
3) EAI
Please choose BXI engine type: 1

3. 설치경로 입력​

웹어드민을 설치할 경로를 입력한다. 미입력 시 현재경로 하위의 admin디렉토리에 설치된다.

BXI WebAdmin Installation Path [/home/bxi/admin]: /home/bxi/admin

4. 설치 여부 입력​

yes를 입력해 설치를 진행한다.

   FEP BXI WebAdmin Installation Path : /home/bxi/admin

Do you want to continue with the installation [yes/no]? yes

5. 환경변수 확인​

~/.bash_profile에 BXI_ADMIN_HOME 및 JETTY_HOME의 위치가 정상적으로 설정되었는지 확인한 후, 안내에 따라 해당 환경변수를 적용한다. (ex. source ~/.bash_profile)

Installing...
/home/installer/admin doesn't exist, trying to create path.

Installation is completed!

/home/bxi/.bash_profile file has changed, please type : source /home/bxi/.bash_profile

환경설정​

정상적인 웹어드민 실행을 위해서는 다음과 같은 부가적인 작업을 수행해야 한다.

1. jetty 포트 설정​

포트 기본값은 8080이며, 해당 서버의 가용 포트번호를 배정한다.

${BXI_ADMIN_HOME}/jetty9/start.ini
## Connector port to listen on
 jetty.http.port=8080

2. DB Connection 설정​

DB properties를 사용할 데이터베이스에 맞게 변경한다.

${BXI_ADMIN_HOME}/jetty9/webapps/[ENGINE_TYPE]/WEB-INF/config/props/bxi-config-.properties
#+-----------------------------------
#|      dev
#+-----------------------------------
db.driver=oracle.jdbc.driver.OracleDriver
db.url=jdbc:oracle:thin:@ip:port:sid
db.username=user
db.password=password

3. 데이터베이스 작업​

BXI에서 사용할 데이터베이스에서 기본 제공되는 DDL, DML스크립트를 수행한다. 스크립트의 실행 순서는 DDL, DML 먼저 수행한 후, PATCH 파일이 존재할 경우 추가로 수행한다.

노트
  • DDL : ${BXI_ADMIN_HOME}/scripts/[Engine Type]/ddl-oracle.sql 또는 ddl-mysql.sql
  • DML : ${BXI_ADMIN_HOME}/scripts/[Engine Type]/dml-[Engine Type].sql
  • PATCH DDL : ${BXI_ADMIN_HOME}/scripts/[Engine Type]/ddl-oracle-patch.sql 또는 ddl-mysql-patch.sql
  • PATCH DML : ${BXI_ADMIN_HOME}/scripts/[Engine Type]/patch-[Engine Type].sql

실행​

다음의 명령어로 웹어드민을 실행한다.

${BXI_ADMIN_HOME}/jetty9/bin/jetty.sh start

BXI 웹어드민을 정상 실행했다면 http://(IP):(PORT)/(Engine Type)로 접속하여 아래와 같은 로그인 화면을 확인할 수 있으며, 초기 계정인 bxiadmin/bxi1231!로 로그인하여 대시보드에 접속할 수 있다.

팁

jetty.sh는 start외에도 restart, stop등의 커맨드를 제공한다.

FAQ​

Access to DialectResolutionInfo cannot be null when 'hibernate.dialect' not set​

데이터소스 정보가 잘못된 경우 발생한다.

DB Connection 설정 재확인 및 hibernate.dialect을 사용하는 DB에 맞게 지정한다.

${BXI_ADMIN_HOME}/jetty9/webapps/[ENGINE_TYPE]/WEB-INF/config/props/bxi-config-common.properties
# DBMS 벤더를 설정한다. 설정하지 않았을 경우 자동으로 설정하나, 통신 또는 보안 문제가 있을 경우엔 반드시 설정해줘야 한다.
hibernate.dialect=org.hibernate.dialect.Oracle10gDialect