> For the complete documentation index, see [llms.txt](https://haksung.gitbook.io/oss/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://haksung.gitbook.io/oss/sw360/install.md). # How to install ## 구성 SW360은 다음과 같이 구성됩니다. * Frontend : Liferay-(Tomcat-)based portal application * Backend : Tomcat-based thrift service * Database : CouchDB ## 요구 사항 Project 구조와 설치를 위해 요구되는 소프트웨어 등 자세한 내용은 README의 Required software 부분에서 확인할 수 있습니다. : ## 설치 방법 SW360은 다음 세 가지의 설치 방법을 제공합니다. 사용자는 이 중 하나를 선택하여 설치할 수 있습니다. 1. Vagrant () 기반 설치 : Vagrant는 가상화 인스턴스를 관리하는 도구로서 sw360vagrant에서는 SW360을 한 번에 Deploy 하기 위한 환경을 제공합니다. : 2. SW360의 구성요소를 개별적으로 설치할 수 있습니다. : 3. Docker를 통해 Deploy 할 수 있습니다. : 여기서는 CentOS 7.6 시스템에 Vagrant 기반으로 설치하여 Deploy 하는 방법을 소개합다. {% hint style="info" %} 자세한 사항은 README를 참고하세요. : {% endhint %} ### 1) 사전 설치 vagrant box에 SW360을 설치하기 위해서는 openjdk, VirtualBox 및 Vagrant를 설치해야 합니다. 먼저 openjdk 1.8.0을 설치합니다. ``` $ 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) ``` VirtualBox를 설치합다. ``` $ sudo wget https://download.virtualbox.org/virtualbox/rpm/el/virtualbox.repo -P /etc/yum.repos.d $ sudo yum install VirtualBox-5.2 ``` CentOS 7에서 VirtualBox 설치 시, “kernel module is not loaded’ 에러가 발생할 경우, kernel-devel을 설치하여 해결한 후 VirtualBox를 재설치합니다. ``` $ 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 ``` Vagrant와 vagrant-aws plugin을 설치합다. ``` $ 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합니다. ``` $ git clone https://github.com/sw360/sw360vagrant.git ``` ### 2) Dependency 다운로드 Vagrant box를 빌드하는 시간을 줄이기 위해 Dependency Package들을 미리 다운로드 받습니다. ``` $ cd sw360vagrant $ ./download-packages.sh ``` 그러면 다음의 package들이 ./shared/package 폴더 안에 다운로드 니다. * 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) ### **3) Base box 생성** 이제 다음 명령어로 Base box를 생성합니다. ``` $ cd generate-box $ ./generate_box.sh ``` 이 작업은 수십 분 소요될 수 있습니다. ### 4) Box 실행 다음 명령어로 Box를 실행합니다. ``` # 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 ``` Box를 실행하면 liferay, postgresql 및 couchdb가 구성됩니. 이상없이 실행이 될 경우, 로 Liferay 화면에 접근할 수 있습니다. ![](https://lh6.googleusercontent.com/leof_ntxQlxjDeD91E7ZfwWY0ftUlD0D_L58AkeNJb_bEFFzKvuL28yzb4iIA6-bAuSfQydo-gVBlnn5EVGGBKcPh0-6Y7p2Qbar74qpB4uwa_nibrV535NJwEIpWXZPFeNUSRd-) ### 5) SW360 Layout Deploy 마지막 단계는 Liferay에서 SW360의 Layout을 Deploy하는 것입니다. 이 작업은 아직 자동화가 되지 않아 관리자가 수동으로 수행해야 합다. 에 접근하여 다음 계정으로 로그인합니다. * id : * pw : sw360fossy 이후에는 다음 사이트의 안내에 따라 Layout deploy를 수행합다. : Deploy가 완료되면 다음과 같은 화면을 볼 수 있습니다. ![](https://lh5.googleusercontent.com/INu1-WWi1-SA9P61IMNlgZhugTXbiwbSKUOu2eWq_d5sIIp8NfqxQntwId41ZDmTG6_5Ope8GdU1J2S0adaJDolM09dtfkwIbOE2gTDC4MZXMxhX9kN28E4Yj8a3deBUHBL7yCqj) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://haksung.gitbook.io/oss/sw360/install.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.