Safe.PrivacyKeeper server는 Redhat Linux 계열, 윈도우 계열 서버에서 동작이 가능하며 기본적으로 FTP 서버 및 GCC가 설치 되어 있어야 한다. 다만, 컴파일 할 상황이 발생하지 않는다면 GCC Library는 설치 하지 않아도 무방하다.

WIndows 설치

언어 및 기본 설정을 입력하고 [다음]을 눌러서 진행합니다.

⁠

전환된 창에서 ‘Install now’를 클릭합니다.

⁠

‘Select the operating system you want to install’에서 ‘Standard Evaluation(Desktop Experience)’를 선택하고 ‘Next’를 클릭합니다.

⁠

Applicable notices and license terms에서 밑의 내용을 승인하는 체크박스를 클릭 하고 ‘Next’를 클릭하여 다음으로 이동합니다.

⁠

어디에 OS를 설치하기를 묻는 창에서는 설치할 스토리지를 클릭으로 선택후 ‘Next’를 클릭하여 다음으로 이동합니다.

⁠

설치 중이라는 창이 나오면 모두 완료가 될 때까지 기다립니다.

⁠

암호를 설정합니다. 암호는 대/소문자, 숫자 그리고 특수문자 중 3가지를 조합하여 최소 6자리 이상으로 설정해야 합니다. 추후 원활한 서버 관리를 위하여 비밀번호는 “qwe123!@#”으로 설정합니다.

⁠

1.2 Configuration

1.2.1 Firewalld configuration

Administrator권한이 부여된 계정으로 로그인 해야 합니다.

‘WIN + R’을 눌러 실행창을 열고 ‘wf.msc’를 입력 후 엔터를 눌러 실행합니다.

⁠

Windows Defender Firewall with Advanced Security창이 열리면 Inbound Rules 를 클릭하고 우측 사이드바 안에 Actions > Inbound Rules > New Rule..을 더클릭합니다.

⁠

New Inbound Rule Wizard창의 왼쪽 사이드바에서 Rule Type > Port를 선택하고 ‘Next’를 클릭합니다.

⁠

Protocol and Ports 섹션에서 ‘TCP’를 선택하고 ‘Specific local posts’를 선택하고 ‘5432, 20000’를 입력합니다. 입력 완료 후 창 우측 하단의 ‘Next’를 눌러 다음을 진행합니다.

⁠

Action 섹션에서는 ‘Allow the connection’을 클릭하고 완료 후 우측 하단의 ‘Next’를 눌러 다음을 진행합니다.

⁠

Profile 섹션에서 Domain, Private, Public을 모두 체크하고 완료 후 우측 하단의 ‘Next’를 클릭합니다.

⁠

Name 섹션에서 Name에 ‘spk sql web’라고 입력후 우측 하단의 Finish를 클릭합니다.

⁠

목록에서 등록한 Inbound Rule을 확인 합니다.

⁠

등록이 된것을 확인 한 뒤에 ‘Outbound’에서도 동일하게 진행합니다.

Name은 SPK(OUT)으로 합니다.

⁠

2. JDK Installation

2.1 Downloading

Safe.PrivacyKeeper Web Server는 Java 개발툴로 개발하여 JDK를 꼭 설치하여야 정상 작동 합니다.

제공된 링크에서 Java SE Development Kit 7u25를 찾아 OS에 맞는 파일을 선택하여 다운로드 받습니다.

https://www.oracle.com/java/technologies/javase/javase7-archive-downloads.html⁠

⁠

2.2 Installation

다운로드 받은 파일을 서버로 옮긴 후 더블클릭하여 설치파일을 실행합니다.

⁠

Setup창이 뜨면 별다른 설정 없이 ‘Next’버튼만 클릭하여 설치를 진행합니다. 창 아래에 ‘Close’버튼이 나오면 클릭하여 JDK설치를 완료합니다.

⁠

WIN+R 을 눌러 실행창을 열고 CMD입력 후 실행해서 ‘Prompt’를 실행합니다.

⁠

Prompt에 ‘java -version’을 입력 후 실행하여 버젼을 확인합니다.

⁠

2.3 Basic Configuration

‘WIN + R’을 눌러 ‘Run’창을 연 다음 ‘sysdm.cpl’을 입력 하여 ‘System Properities’창을 엽니다.

⁠

‘Advanced’ 탭을 선택하고 창 밑에서 ‘Environment Variables’ 버튼을 클릭합니다.

⁠

‘Environment Variables’창에서 ‘System variables > New’를 클릭 합니다.

⁠

Variable name: 에 ‘JAVA_HOME’을 입력하고 Variable value’에서는(Finder 에서 직접 찾아보자)

⁠

‘New System Variable’팝업창을 ‘OK’버튼을 클릭하고 나온 뒤 ‘System variables’의 목록에서 ‘path’라는 변수줄에 마우스 커서를 가져대고 더블 클릭 한다. (한번 클릭으로 선택한후 우측 하단의 ‘Edit’를 클릭해도 된다.)

⁠

(T)를 눌러 변수 값(V)의 제일 뒤에 ‘;%JAVA_HOME%\bin’을 추가하고 확인을 클릭합니다.

⁠

새 팝업창에서 ‘OK’를 클릭하고 다음으로 이동한다.

⁠

‘Edit System Variable’에서 ‘Variable value’의 값 맨 끝에 ‘;%JAVA_HOME\%bin’을 추가하고 완료 후 ‘OK’ 버튼을 클릭합니다.

⁠

팝업창이 사라지면 나머지 팝업 창들도 창 우측에 ‘X’를 눌러 창을 닫아 줍니다.

cmd창을 열어 ‘echo %JAVA_HOME%’을 실행하여 입력한 환경변수의 값을 확인합니다.

⁠

2.4 Portable Ver. Configuration

환경변수를 등록하지 않고 Tomcat 소스를 Local에 저장 후 설정한다.

./bin/으로 이동

service.bat을 메모장 또는 스크립트 편집 프로그램(vscode)으로 열람한다.

‘setlocal’ 밑에 아래의 스크립트 입력

⁠

4. Tomacat Installation⁠

으로 이동 후 이어서 진행

3. PostgreSql Installation

위에서 인터넷과 연결되지 않은 상황에서 수동(Manual)으로 JDK를 설치 한 것과 같이 이번 섹션에서도 인터넷 없이 설치파일을 서버로 옮겨서 진행합니다.

3.1 Configuration

C:\java_web에 ‘alpha_smart_spk_tblspc’ 폴더를 생성하고 그 안에 ‘data’ 폴더를 생성합니다.

⁠

‘data’ 폴더 위에서 우클릭으로 옵션 팝업을 띄우고 하단의 ‘Properties’를 선택합니다.

⁠

‘Properties’ 팝업창이 뜨면 ‘Security’탭에서 ‘Edit’버튼을 클릭합니다.

⁠

‘Group or usernames’섹션에서 ‘Users’를 선택하고 하단의 ‘Permissions for Users’에서 ‘Full control’의 체크박스를 클릭합니다.

⁠

설정을 완료하면 창 하단의 ‘Apply’를 클릭하고 적용이 완료 되면 ‘OK’ 버튼을 눌러 창을 닫습니다.

⁠

3.2 Installation

PostgreSQL의 언어는 인스톨시에 설치될 OS의 사용 언어팩에 맞게 설정되어집니다. 따라서, PostgreSQL 설전에 OS에 적용된 언어팩을 확인하고 한국어가 없으면 반드시 사전에 다운로드 및 적용을 합니다.

작업을 시작하기 전에

postgresql-9.2.14-3-windows-x64⁠

파일을 확보합니다.

작업할 서버에 파일을 복사 또는 이동 시켜서 파일을 실행할 준비를 합니다.

⁠

TableScript가 PostgreSQL 9.2 이상으로 개발되어 9.2 이상 설치를 권장합니다. 별도의 설정 없이 ‘Next’버튼을 클릭하여 설치 합니다.

⁠

Password에서 Superuser에 대한 비밀번호를 설정합니다. 비밀번호는 ‘qwe123!@#’로 입력합니다. 입력 완료후 우측 창 하단에서 ‘Next’버튼을 눌러 다음으로 이동합니다.

⁠

Port는 기본값인 ‘5432’인지 확인합니다.

⁠

4. Tomcat Installation

4.1 Installation

회사에서 제공하 최신 ‘java_web’폴터를 Windows Server ‘C:\’ 디렉토리로 복사합니다.

⁠

Windows Key를 눌러 검색창을 열고 ‘cmd’를 입력합니다. 목록에 ‘Command Prompt’가 뜨면 목록 위에서 커서를 가져갑니다.

⁠

목록 위에 커서를 가져간후 우클릭을 해서 옵션 창을 엽니다. 목록에서 ‘Run as administrator’을 클릭합니다.

⁠

명령 프롬프트에 ‘C:\java_web\apache-tomcat-7.0.41\bin’디렉토리로 이동합니다. 이동하기 전에 ‘Finder’에서 이동할 경로를 미리 체크합니다.

⁠

다음의 명령어를 실행하여 SPK_ENT를 설치 합니다.

‘SPK_ENT’: 사전에 정의 되어 있는 것을 로드 하는 것이 아닌, 명령어를 쓰는 순간 bin안에 있는 ‘service.bat’로 ‘./bin/에서 실행되는 서비는 ‘SPK_ENT’처럼 내가 정의한 이름대로 서비스 목록에 등록하게 된다.

⁠

4.2 Configuration

Windows 서비스에 ‘alpha_smart_spk’를 Windows 부팅시 자동실행 할 수 있도록 환경 설정하며, SPK Web 서비스를 시작합니다.

Windows Key를 눌러 윈도우 검색창을 띄우고 ‘Service’라고 입력한뒤 목록에 나타나는 ‘Service’ 앱을 실행합니다.

⁠

‘Apache Tomcat alpha_smart_spk’를 마우스 우클릭 하고 ‘Properties’을 선택합니다.

⁠

새로 나타난 ‘Properties’창에서 ‘Startup type’ 섹션에 선택되어 있는 ‘Manual’을 ‘Automatic’으로 변경합니다.

⁠

‘Service Status: Stopped’을 ‘Start’ 버튼을 클릭하여 시작으로 변경합니다.

⁠

‘Service Status: Running’으로 바뀌면 창 우측 하단의 ‘Apply’를 눌러 적용한뒤 ‘OK’를 눌러 창을 닫습니다.

⁠

4.3 PgAdmin Configuration

4.3.1 Login/Group Roles

일반적으로 PostgreSQL을 서버에 설치하면 PgAdmin는 자동으로 설치가 된다. PostgreSQL설치를 마치고 윈도우 바탕화면에서 ‘Windows Key’를 누르고 검색창에서 ‘PgAdmin’을 검색합니다.

⁠

첫 화면인 Dashboard에서 왼쪽 사이드바 상단에 PostgreSQL을 설치하면서 생성된 서버가 생성된 것을 확인할수 있습니다. 목록을 더블클릭하면 가운데 창에 ‘Connect to Server’는 이름의 비밀번호 입력창이 생성됩니다. 비밀번호는 ‘qwe123!@#’를 입력해 진행합니다.

⁠

로그인에 성공하면 열람 할 수 있는 세부파일들이 로드됩니다. 목록에서 ‘Login Role’에 커서를 가져가 우클릭을 하여 옵션창을 띄우면 ‘New Login Role’를 클릭해 선택합니다.

⁠

팝업으로 생성된 ‘New Login Role’창에서 아래와 같이 정보를 입력 및 선택을 합니다.

Tab Properties > Role name: alphasecure

⁠

Tab Definition > Password: tpdlvm / Password(again): tpdlvm

⁠

Tab Role privileges > Check ‘Superuser’

‘Superuser’의 ‘Uncheck’박스를 을 클릭하면 ‘Can modify catalog driectly’ 가 자동으로 체크됩니다.

⁠

완료가 되면 우측 창 하단의 ‘OK’를 눌러 밖으로 이동합니다.

⁠

다시 왼쪽 사이드 바에서 ‘Tablespaces’위에 커서를 가져가 우클릭을 통해 팝업을 불러옵니다. 그리고 기능 목록에서 ‘New Tablespace'를 클릭해 실행합니다.

⁠

4.3.2 Tablespaces

‘New Tablespace에서 다음과 같이 정보를 입력 및 수정합니다.

Properties >

Name: alpha_smart_spk_tblspc

Owner: alphasecure

⁠

Definition >

Location: C:\java_web\alpha_smart_spk_tblspc\data

⁠

4.3.3 Database

메인 대쉬보드 창으로 돌아와 이번에는 ‘Databases’위로 커서를 옮긴 후 우클릭 해서 생긴 팝업창 목록의 ‘New Database’를 클릭합니다.

⁠

팝업창 ‘New Database’에서 아래와 같이 입력한 뒤 창 하단의 ‘OK’를 클릭합니다.

Properties >

Name: alpha_smart_spk

Owner: alphasecure

⁠

Definition >

Template: template0

Tablespace: alpha_smart_spk_tblspc

Collation: C

Character type: Korean_Korea.949

연결 한도: -1

⁠

목록에서 새로 생성된 데이터베이스 ‘alpha_smart_spk’를 확인 합니다.

⁠

세부내용을 보기위해 폴더를 클릭하면 폴더이미지에 있던 X 표시는 사라집니다.

⁠

데이터베이스에 테이블을 생성하기 위해 우선 데이터베이스 > alpha_smart_spk > Extensions 위로 커서를 가져가 우클릭을 합니다. 새로 생성된 팝업 창에서 ‘New Extension’을 클릭합니다.

⁠

SPK Web Server DB 생성 시 PostgreSQL에서 암호 관련 함수를 사용하기 위해 pgcrypto 모듈이 필요하므로 속성 탭에서 이름을 “pgcrypto’를 선택하고 확인버튼을 클릭하여 모듈을 추가합니다.

⁠

입력을 마치면 창하단의 ‘확인’을 클릭하고 메인 화면으로 돌아갑니다.

⁠

작업을 완료하면 ‘Extension’목록에서 등록된 ‘pgcrypto’를 확인합니다.

⁠

5. WEB 서버 설정

5.1 Web Server 연결포트 설정

SPK 설치 Web Server의 ‘“C:\java_web\apache-tomcat-7.0.41\conf” 경로에 있는 “Server.xml” 파일을 열어 “Connector port = “20000””에 해당하는 부분이 정산적으로 입력됐는지 확인합니다.

고객사 별로 상이하기 때문에 포트가 일치하는지 확인합니다.

⁠

혹시 여러개의 Connector port가 있어서 어디 값을 수정하는지 알수가 없을때는 주석 처리 여부를 확인 하는 것이 좋다. 주석은 ‘’ 처럼 되어 있다.

5.2 SPK Client 설정

SPK 사용자가 인터넷 브라우저로 SPK Client를 다운로드 할 수 있도록 SPK 설치 Web Server의 “java_web” 폴더 내 “C:\java_web\webapps\ROOT” 경로에 있는 “downfiles”폴더를 속성을 열어 Users의 사용 권한을 모든 권한으로 설정합니다.