-
Notifications
You must be signed in to change notification settings - Fork 22
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
update sw360 install and setup guilde
- Loading branch information
1 parent
85d7d05
commit 9ed4380
Showing
25 changed files
with
136 additions
and
68 deletions.
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -46,12 +46,13 @@ SW360은 다음 두 가지의 설치 방법을 제공한다. 사용자는 이 | |
|
||
이 가이드에서는 `Docker`로 Deploy하는 방법을 소개한다. 자세한 사항은 README를 참고한다. : https://github.com/eclipse-sw360/sw360/blob/main/README_DOCKER.md | ||
|
||
|
||
### 1. 코드 다운로드 | ||
|
||
Docker Image 빌드를 위해 코드를 다운로드 한다. 테스트가 완료된 코드는 여기서 받을 수 있다. : https://github.com/haksungjang/sw360/tree/docker_build | ||
|
||
```sh | ||
$ git clone -b docker_build https://github.com/haksungjang/sw360.git | ||
git clone -b docker_build https://github.com/haksungjang/sw360.git | ||
``` | ||
|
||
### 2. 빌드 | ||
|
@@ -61,103 +62,169 @@ $ git clone -b docker_build https://github.com/haksungjang/sw360.git | |
아래와 같이 `docker_build.sh`를 실행하여 빌드한다. | ||
|
||
```sh | ||
$ cd sw360 | ||
$ ./docker_build.sh | ||
cd sw360 | ||
./docker_build.sh | ||
``` | ||
|
||
정상적으로 빌드가 완료되면 아래와 같이 생성된 이미지를 확인할 수 있다. | ||
|
||
```sh | ||
docker image ls | ||
|
||
REPOSITORY TAG IMAGE ID CREATED SIZE | ||
eclipse-sw360/sw360 18-development ab0fd848bf80 8 minutes ago 2.95GB | ||
eclipse-sw360/sw360 latest ab0fd848bf80 8 minutes ago 2.95GB | ||
ghcr.io/eclipse-sw360/sw360 18-development ab0fd848bf80 8 minutes ago 2.95GB | ||
ghcr.io/eclipse-sw360/sw360 latest ab0fd848bf80 8 minutes ago 2.95GB | ||
eclipse-sw360/binaries 18-development aa7debf0a1fc 8 minutes ago 347MB | ||
eclipse-sw360/binaries latest aa7debf0a1fc 8 minutes ago 347MB | ||
ghcr.io/eclipse-sw360/binaries 18-development aa7debf0a1fc 8 minutes ago 347MB | ||
ghcr.io/eclipse-sw360/binaries latest aa7debf0a1fc 8 minutes ago 347MB | ||
eclipse-sw360/base 18-development e5147733fc88 37 minutes ago 1.52GB | ||
eclipse-sw360/base latest e5147733fc88 37 minutes ago 1.52GB | ||
ghcr.io/eclipse-sw360/base 18-development e5147733fc88 37 minutes ago 1.52GB | ||
ghcr.io/eclipse-sw360/base latest e5147733fc88 37 minutes ago 1.52GB | ||
ghcr.io/eclipse-sw360/thrift 0.18.1 0012d7998058 4 weeks ago 152MB | ||
ghcr.io/eclipse-sw360/thrift latest 0012d7998058 4 weeks ago 152MB | ||
eclipse-sw360/thrift 0.18.1 0012d7998058 4 weeks ago 152MB | ||
eclipse-sw360/thrift latest 0012d7998058 4 weeks ago 152MB | ||
``` | ||
|
||
### 3. 실행 | ||
|
||
`docker-compose up` 명령으로 생성된 이미지를 실행한다. | ||
|
||
### 1\) 사전 설치 | ||
|
||
vagrant box에 SW360을 설치하기 위해서는 openjdk, VirtualBox 및 Vagrant를 설치해야 다. 먼저 openjdk 1.8.0을 설치한다. | ||
|
||
```text | ||
$ yum install java-1.8.0-openjdk | ||
$ java -version | ||
openjdk version "1.8.0_191" | ||
OpenJDK Runtime Environment (build 1.8.0_191-b12)” | ||
OpenJDK 64-Bit Server VM (build 25.191-b12, mixed mode) | ||
``` | ||
docker-compose up | ||
``` | ||
|
||
VirtualBox를 설치한다. | ||
정상적으로 실행이 완료되면 아래와 같이 세개의 container가 실행된 것을 볼 수 있다. | ||
|
||
```text | ||
$ sudo wget https://download.virtualbox.org/virtualbox/rpm/el/virtualbox.repo -P /etc/yum.repos.d | ||
$ sudo yum install VirtualBox-5.2 | ||
``` | ||
docker ps | ||
CentOS 7에서 VirtualBox 설치 시, “kernel module is not loaded’ 에러가 발생할 경우, kernel-devel을 설치하여 해결한 후 VirtualBox를 재설치한다. | ||
|
||
```text | ||
$ sudo yum install https://centos7.iuscommunity.org/ius-release.rpm | ||
$ sudo yum install dkms | ||
$ sudo yum install kernel-devel | ||
# reboot | ||
$ sudo /sbin/vboxconfig | ||
$ systemctl status vboxdrv | ||
● vboxdrv.service - VirtualBox Linux kernel module | ||
Loaded: loaded (/usr/lib/virtualbox/vboxdrv.sh; enabled; vendor preset: disabled) | ||
Active: active (exited) since Wed 2020-02-19 09:06:02 KST; 20min ago | ||
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES | ||
4299fd39010c eclipse-sw360/sw360 "/app/entry_point.sh" 3 minutes ago Up 3 minutes 0.0.0.0:8080->8080/tcp, 0.0.0.0:11311->11311/tcp sw360 | ||
13fd5696b140 postgres:14 "docker-entrypoint.s…" 3 minutes ago Up 3 minutes (healthy) 0.0.0.0:5438->5432/tcp sw360-postgresdb-1 | ||
7bb70f2daaf4 couchdb "tini -- /docker-ent…" 3 minutes ago Up 3 minutes (healthy) 4369/tcp, 9100/tcp, 0.0.0.0:5984->5984/tcp sw360-couchdb-1 | ||
``` | ||
|
||
Vagrant와 vagrant-aws plugin을 설치한다. | ||
이 상태에서 `http://localhost:8080/`로 접근하면 다음과 같은 화면에 진입한다. | ||
|
||
```text | ||
$ sudo yum install https://releases.hashicorp.com/vagrant/2.2.6/vagrant_2.2.6_x86_64.rpm | ||
# vagrant-aws plugin 설치 | ||
$ vagrant plugin install vagrant-aws | ||
``` | ||
 | ||
|
||
그리고, sw360vagrant 코드를 Clone 한다. | ||
|
||
```text | ||
$ git clone https://github.com/sw360/sw360vagrant.git | ||
``` | ||
## 설정 | ||
|
||
### 2\) Dependency 다운로드 | ||
SW360을 정상적으로 설치한 후에는 아래의 절차대로 초기 설정이 필요하다. 자세한 내용은 여기에서 확인할 수 있다. : [SW360 Initial Setup Configuration](https://eclipse.dev/sw360/docs/deployment/legacy/deploy-liferay7.4/) | ||
|
||
Vagrant box를 빌드하는 시간을 줄이기 위해 Dependency Package들을 미리 다운로드 받는다. | ||
### User, Login 설정 | ||
|
||
```text | ||
$ cd sw360vagrant | ||
$ ./download-packages.sh | ||
``` | ||
설정을 위해 다음 계정으로 로그인한다. | ||
|
||
그러면 다음의 package들이 ./shared/package 폴더 안에 다운로드 된다. | ||
* id : [email protected] | ||
* pw : sw360fossy | ||
|
||
* Liferay 7.2.1 CE GA2 with Tomcat \(9.0.17\) | ||
* Postgresql-42.2.9 ODBC client for Java as \*.jar file | ||
* SW 360에서 필요한 11개의 \*.jar 파일 | ||
* Thrift 0.11 | ||
* A box images from the Ubuntu 16.04 LTS \(xenial-server-cloudimg-amd64-vagrant.box\) | ||
로그인을 하면 아래와 같이 Not Found라는 표시가 나타나게 된다. | ||
|
||
### 3\) Base box 생성 | ||
 | ||
|
||
이제 다음 명령어로 Base box를 생성한다. | ||
화면 우상단의 아이템 아이콘(큐브 모양)을 클릭하고 `Control Panel` 탭을 선택한다. | ||
|
||
```text | ||
$ cd generate-box | ||
$ ./generate_box.sh | ||
``` | ||
 | ||
|
||
이 작업은 수십 분 소요될 수 있다. | ||
`SECURITY` > `Password Policies` > `Default Password Policy` > `PASSWORD CHANGES` > `Change Requried`를 활성화한다. | ||
|
||
### 4\) Box 실행 | ||
 | ||
|
||
다음 명령어로 Box를 실행한다. | ||
그리고, 다시 `Control Panel`탭에서 `CONFIGURATION` > `Instance Settings`을 선택한다. 그러면, `PLATFORM`메뉴를 볼 수 있다. | ||
|
||
```text | ||
# If you have built a vagrant box from this directory earlier, you will have to destroy it first via | ||
$ vagrant destroy | ||
$ cd ../sw360-single | ||
$ vagrant up | ||
``` | ||
 | ||
|
||
거기서 `Users`를 선택한다. 그리고, `Default User Associations` 메뉴로 진입하고, `Apply to Existing Users`를 체크한다. 그리고 `Save`한다. | ||
|
||
 | ||
|
||
이번에는 `Instance Settings` > `PLATFORM`에서 `User Authentication`를 선택한다. `General`로 진입하여 모든 항목을 Uncheck한다. (관리 목적상 필요한 항목은 Check하여 활성화할 수 있다.) 그리고 `Save`한다. | ||
|
||
 | ||
|
||
끝으로, jquery와 font awesome을 활성화시켜야 한다. 이를 위해 `Control Panel` 탭에서 `CONFIGURATION` > `System Settings`으로 진입하면 `PLATFORM` 하위에 `Third Party`를 볼 수 있다. | ||
|
||
 | ||
|
||
`Third Party`에 진입하여 `JQuery`와 `Font Awesome`을 각각 Enable시킨다. | ||
|
||
 | ||
|
||
 | ||
|
||
브라우저를 새로 실행하면 변경 사항이 적용된다. | ||
|
||
### LAR 파일 import | ||
|
||
SW360 설정을 위해서는 `*.lar` 파일들을 import해야 한다. 이를 설정하기 위해서는 메뉴로 진입해야 하는데, 메뉴 버튼은 화면 좌측 상단에 있다. | ||
|
||
 | ||
|
||
메뉴에서 `Publishing` > `Import`에 진입한다. | ||
|
||
 | ||
|
||
Box를 실행하면 liferay, postgresql 및 couchdb가 구성된다. 이상없이 실행이 될 경우, [https://localhost:8443/](https://localhost:8443/) 로 Liferay 화면에 접근할 수 있다. | ||
우측의 `+` 버튼을 눌러 LAR 파일을 업로드 할 수 있는데, LAR 파일은 SW360 소스 파일 내 `frontend/configuration` 폴더 하위에 있다. (예: https://github.com/haksungjang/sw360/tree/docker_build/frontend/configuration) | ||
|
||
먼저, `Public_Pages_7_4_3_18_GA18.lar` 파일을 업로드하고 `Continue` 버튼을 누른다. | ||
|
||
 | ||
|
||
File Summary 화면에서 업로드된 LAR 파일 세부 내용을 볼 수 있다. | ||
|
||
 | ||
|
||
제일 아래의 `AUTHORSHIP OF THE CONTENT`를 `Use the Current User as Author`로 변경하고 `Import` 버튼을 누른다. | ||
|
||
 | ||
|
||
그러면 Import가 성공적으로 완료된 걸 볼 수 있다. | ||
|
||
 | ||
|
||
이와 유사하게 `Private_Pages_7_4_3_18_GA18.lar` 파일을 Import한다. File Summary 화면에서 아래와 같이 `PAGES` > `Private Pages`로 변경한다. | ||
|
||
 | ||
|
||
그리고, `PERMISSIONS`, `UPDATE DATA`, `AUTHORSHIP OF THE CONTENT` 항목을 각각 아래 이미지와 같이 선택하고, `Import`버튼을 눌러 Import를 수행한다. | ||
|
||
 | ||
|
||
여기까지 수행을 마친 후 메뉴 상단의 `Home` 버튼을 누른다. | ||
|
||
 | ||
|
||
그럼 아래와 같이 `Welcome to SW360!` 화면에 진입한다. | ||
|
||
 | ||
|
||
`Start` 버튼을 눌러 SW360 첫 화면에 진입할 수 있다. (모든 항목이 비어있다.) | ||
|
||
 | ||
|
||
### 테스트를 위한 User Account 설정 | ||
|
||
SW360 메뉴에서 `Admin` > `User`를 선택한다. | ||
|
||
 | ||
|
||
화면 하단의 `UPLOAD USERS` 메뉴에서 테스트를 위한 User 리스트를 업로드 한다. 테스트를 위한 User 리스트는 여기에서 다운 받을 수 있다. : [test_users_with_passwords_12345.csv](https://github.com/haksungjang/sw360/blob/main/frontend/configuration/test_users_with_passwords_12345.csv) | ||
|
||
* (참고) 원본 파일 : [sw360vagrant](https://github.com/sw360/sw360vagrant/blob/master/shared/test_users_with_passwords_12345.csv) | ||
|
||
그러면 다음과 같이 9개의 User 리스트가 업로드 된 것을 볼 수 있다. | ||
|
||
 | ||
|
||
여기서 보이는 User 리스트 중 하나의 계정으로 다시 로그인을 시도한다. Password는 `12345`이다. | ||
|
||
 | ||
|
||
### 5\) SW360 Layout Deploy | ||
|
||
|
@@ -172,6 +239,7 @@ Deploy가 완료되면 다음과 같은 화면을 볼 수 있다. | |
|
||
 | ||
|
||
|
||
## Basic Workflow | ||
|
||
### 1\) License 등록 | ||
|