SiiRU CMS 설치 매뉴얼

SiiRU CMS의 설치 권장 사양 및 설치 방법입니다.

설치 권장 사양

SiiRU CMS는 아래와 같은 환경에서 설치 및 운영할 것을 권장합니다.

JAVA : Open JDK 1.8 이상
Database
- MySQL 8.0 이상
- MariaDB 10.2 이상
- Oracle Database 11g 이상
- Tibero 5 이상

설치 방법

본 매뉴얼에서 예시로 설치한 환경은 다음과 같습니다.

OS : CentOS 7.9
WEB : Apache 2.4.6
WAS : Apache Tomcat 9.0

1. 설치 파일 업로드

SiiRU CMS 설치 파일을 서버에 업로드 후 설치할 폴더에 압축 해제합니다.

tar zxvf SiiRUCMS_v2.1.tar.gz [설치할 경로]

예) tar zxvf SiiRUCMS_v2.1.tar.gz /usr/local/siiru

2. Database 설정

SiiRU CMS가 운영될 Database를 사용 중인 DB 서비스에 생성하고 DB 정보를 입력합니다.

2.1. Database 및 사용자 추가

-- 데이터베이스 생성
CREATE DATABASE IF NOT EXISTS [생성할 DB명] DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 사용자 추가
CREATE USER [생성할 사용자명]@[Host명] IDENTIFIED BY '[패스워드]';

-- 사용자 권한 설정
GRANT ALL PRIVILEGES ON [생성한 DB명].* TO [생성한 사용자명]@[Host명];

-- 권한 새로고침
FLUSH PRIVILEGES;

-- 테이블스페이스 생성
CREATE TABLESPACE [생성할 테이블스페이스명]
	DATAFILE '[기존 테이블스페이스 저장 경로]/[생성할 테이블스페이스명].dbf'
	SIZE 200M
	AUTOEXTEND ON
	DEFAULT STORATE(
		INITIAL 80K
		NEXT 80K
		MINEXTENTS 1
		MAXEXTENTS 121
		PCTINCREASE 80
	) ONLINE;

-- 사용자 추가
CREATE USER [생성할 사용자명] IDENTIFIED BY [패스워드] DEFAULT TABLESPACE [저장될 테이블 스페이스명];

-- 사용자 Role 부여
GRANT CONNECT, DBA, RESOURCE TO [생성한 사용자명];

-- 필요한 사용자 권한 부여
GRANT CREATE DATABASE LINK, CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, SELECT ANY TABLE,INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE, CREATE PROCEDURE, CREATE ANY PROCEDURE, ALTER ANY PROCEDURE, DROP ANY PROCEDURE, EXECUTE ANY PROCEDURE, CREATE SESSION,LOCK ANY TABLE,COMMENT ANY TABLE, CREATE SEQUENCE, CREATE ANY SEQUENCE, ALTER ANY SEQUENCE, DROP ANY SEQUENCE,SELECT ANY SEQUENCE, CREATE TRIGGER, CREATE ANY TRIGGER, ALTER ANY TRIGGER, DROP ANY TRIGGER, CREATE VIEW, CREATE ANY VIEW,DROP ANY VIEW TO [생성한 사용자명];

-- 프로시저에서 테이블 생성 권한 부여
GRANT EXECUTE ON DBMS_SQL TO [생성한 사용자명];

-- 백업 테이블 권한 부여 (Tibero는 해당사항 없음)
GRANT BACKUP ANY TABLE TO [생성한 사용자명];

2.2. DB 정보 입력

[설치파일 압축해제경로]/public_html/WEB-INF/classes/props/config.properties 파일에 연동할 Database 정보를 입력합니다.

# DbType [oracle, tibero, mariadb, mysql]
Database.DbType=[해당 DbType명]
Database.DriverClassName=org.[해당 DbType명].jdbc.Driver
Database.Url=jdbc:[해당 DbType명]://[DB 호스트 주소]:[DB 포트]/[DB명]
Database.UserName=[DB 사용자명]
Database.Password=[DB 사용자 비밀번호]
# Connection을 jndi로 선택시
Database.jndi=[JNDI명]

(예)
Database.DbType=mariadb
Database.DriverClassName=com.mariadb.cj.jdbc.Driver
Database.Url=jdbc:mariadb://192.168.1.203:3306/siiru
Database.UserName=siiru
Database.Password=siiru1234

3. WAS 실행

3.1. 포함된 Apache Tomcat을 사용하는 경우

설치 파일 폴더 내에 있는 Apache Tomcat을 실행하여 운영할 경우, 아래와 같이 실행합니다.

cd [설치파일 압축해제경로]/tomcat/bin
sh ./startup.sh

3.2. 별도의 Apache Tomcat을 설치하여 사용할 경우

JDK 1.8.0 이상이 설치된 환경에서 최소 Apache Tomcat 8.5.51 이상을 권장합니다.

Apache Tomcat을 다운로드합니다.

버전 선택 → bin 폴더 → apache-tomcat-9.x.tar.gz 파일 다운로드

다운로드 받은 파일을 서버에 업로드하고 특정 경로에 해당 파일의 압축을 해제합니다.
```
tar zxvf apache-tomcat-9.0.60.tar.gz [Tomcat 설치경로]
```
Tomcat이 설치된 디렉토리 하위의 conf/server.xml 파일을 서버 환경에 맞게 수정합니다.
- <Host>의 appBase에 설치 파일이 압축해제된 폴더 경로를 입력합니다.
- 서브디렉토리 방식의 도메인을 사용할 경우 의 path를 수정합니다. (예) www.domain.com/test인 경우 path="/test"
```
<Host name="localhost" appBase="[설치파일 압축해제경로]" unpackWARs="true" autoDeploy="true" xmlValidation="false" xmlNamespaceAware="false">
  <Context docBase="public_html" path="/" reloadable="false">
		<CookieProcessor sameSiteCookies="none" />
	</Context>
</Host>
```
Tomcat 서비스를 기동합니다.
```
sh [Tomcat 설치경로]/bin/startup.sh
```

Tomcat 서비스 기동을 확인합니다.

# 프로세스 확인
ps -ef | grep java | grep [Tomcat 설치경로]

# 서비스 포트 확인
netstat -an | grep "LISTEN " | grep 8080

# 로그 확인
tail -f [Tomcat 설치경로]/logs/catalina.out

3.3. Apache httpd와 연동할 경우

Tomcat이 설치된 디렉토리 하위의 conf/server.xml 파일에서 <Connector>의 protocol을 HTTP/1.1에서 AJP/1.3으로 수정합니다.
```
<Service name="Catalina">
     <Connector port="8080" protocol="AJP/1.3" ... />
...
</Service>
```
Tomcat Connectors JK 최신 버전을 다운로드하고 서버에 업로드 후 압축 해제합니다.
```
tar zxvf tomcat-connectors-1.2.48-src.tar.gz [압축 해제할 경로]
```
apxs 모듈 설치 경로를 확인합니다.
```
which apxs
```

압축 해제된 디렉토리 아래 native 폴더로 이동 후 configure를 아래와 같이 진행합니다.

cd [압축 해제된 경로]/tomcat-connector-1.2.48-src/native

./configure --with-apxs=[2에서 확인한 apxs 모듈 경로]

모듈 설치 파일을 생성하고 및 설치합니다.
```
make && make install
```
모듈 설치가 완료된 후 확인합니다.
```
find / -name 'mod_jk.so'
```

Apache 환경 설정 폴더 아래에 httpd.conf 파일의 내용을 수정 및 추가합니다.

LoadModule jk_module modules/mod_jk.so

<IfModule jk_module>
  JkWorkersFile "conf/workers.properties"
  JkLogFile "logs/mod_jk.log"
  JkLogLevel info
  JkShmFile run/mod_jk.shm
  JkMountFile conf/uriworkermap.properties
  JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
	JkRequestLogFormat "%w %V %T"
</IfModule>

Apache 환경 설정 폴더 아래에 workers.properties 파일을 생성합니다.

worker.list=[서비스명]

worker.[서비스명].port=8080 # 톰캣_서비스_포트
worker.[서비스명].host=localhost # 톰캣_서비스_호스트주소
worker.[서비스명].type=ajp13
worker.[서비스명].lbfactor=1

Apache 가상 호스트 설정 파일 httpd-vhosts.conf에서 Tomcat을 연동할 하위에 아래 내용을 추가합니다.

<VirtualHost *:80>
  ...

	JkLogFile logs/mod_jk.log
	JkLogLevel info
	JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
	JkMount /* [서비스명]  # workers.properties에서 지정해준 list명
</VirtualHost>

Apache와 Tomcat을 모두 재기동하여 서비스가 정상적으로 실행되는지 확인합니다.

4. SiiRU 관리자 페이지 접속

DB 정보 입력 후 Tomcat 서비스가 정상적으로 시작되면 웹 브라우저에서 관리자 화면으로 접속합니다.

URL 접속 주소 : http://[호스트 주소]/siiru/

4.1. 초기 데이터 설치 및 로그인 페이지 이동

SiiRU CMS의 DB가 설치되지 않은 경우 아래와 같은 화면에서 생성할 사이트 ID, 사이트명, 사이트 도메인 입력 후 [SiiRU Setup] 버튼을 클릭하여 설치를 진행합니다.
정상적으로 설치가 완료된 후 관리자 로그인 페이지로 이동합니다.

4.2. 라이센스 잠금 화면

SiiRU 라이센스가 인증되지 않은 경우 라이센스 잠금 화면이 표시됩니다.
(주)가민정보시스템 프레임웍연구팀 (TEL : 062-653-2879 | 직통 : 070-4827-4930)에 문의하여 라이센스를 발급받을 수 있습니다.
[설치파일 압축해제경로]/public_html/WEB-INF/classes/props/config.properties 파일에 발급 받은 라이센스를 입력하고, WAS 서비스를 재기동합니다.
```
# License : (주)가민정보시스템 정보기술연구소 문의
SiiRU.License=[발급받은 라이센스 키]
```

4.3. IP 잠금 화면

SiiRU CMS가 설치된 이후 허용되지 않은 IP로 접속 시 IP 잠금 화면이 표시됩니다.
SiiRU 관리자 접속이 허용된 위치에서 접속하여 기본 설정 > IP 관리 > CMS 페이지에서 해당 IP를 추가합니다.

Previous고객 지원 NextSiiRU CMS 운영 매뉴얼

Last updated 3 years ago

Was this helpful?