Skip to content
This repository has been archived by the owner on Jun 22, 2022. It is now read-only.

Installation Notes for Mac OS X Computers

Jump to bottom
Michael edited this page Sep 13, 2019 · 2 revisions

This document covers a dedicated installation instructions for Mac OS X computers. It was running with

  • Mac OS X version 10.14
  • Docker desktop community 2.1.0.2

Prerequisites

Steps 1: Setup Docker Environment

A. At first you may need to install a tool which computes hashes for the downloads to check their integrity:

$ brew install md5sha1sum

This tool is used by the setup scripts.

B. Then, you need to add some shared folders so that the docker containers can access your file system. For this go to the docker menu (the docker icon in the menu bar) -> select the item Preferences-> go to tab File Sharing and add the following two folders:

/${path-to-chores}/sw360choress/_deploy/
/${path-to-chores}/sw360choress/configuration

C. Then execute the main command for sw360chores:

$ ./sw360chores.pl --build -- up

Steps 2: Get the SW360 Software

A. You need to deploy the SW360 packages to the Liferay container. You can generate the packages from the SW360 project:

mvn package -P deploy
  -Dbase.deploy.dir=.
  -Dliferay.deploy.dir=/${path-to-chores}/sw360chores/_deploy/liferay
  -Dbackend.deploy.dir=/${path-to-chores}/sw360chores/_deploy/tomcat
  -Drest.deploy.dir=/${path-to-chores}/sw360choress/_deploy/tomcat

B. Note two things here:

  • The SW360 solution ha three major parts:
    • The portal needs to go into the Liferay deploy folder (named liferay here)
    • The backend needs to go into the tomcat webapps folder (named tomcat here)
    • The rest API components need to go into the tomcat webapps folder as well (named tomcat here)
  • If you want to build the packages and it fails (at the lib-datahandler) at some tests: in 99% of the cases there is no couchdb database server running which is required for tests. Try -DskipTestsif you would like to avoid it.

Steps 3: Continue with SW360

After successful installation you should see something like this in the log:

13-Sep-2019 20:08:47.446 INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [245,610] milliseconds

(well, not so fast, admitted, MBP 13" Retina 2014) Now you need to continue in SW360. Call in a Web browser:

https://localhost:8443/

The certificate is self-signed, so you need to go ahead despite your browser does not recommen it. Go ahead with Configure Liferay Portal from the page: https://github.com/eclipse/sw360/wiki/Deploy-Upgrade-to-Liferay-7.2

Clone this wiki locally