Skip to content

Home

Jump to bottom
Michael edited this page Apr 28, 2021 · 28 revisions

sw360vagrant

The vagrant setup installs an entire sw360 server inside one virtual machine. It can be used for different virtual machine environments, currently, there is support for virtualbox and AWS EC2 instances. Basically required:

  • Shell environment (bash...) and involved tools, such as wget for downloading software
  • Hypervisor, most likely VirtualBox
  • Vagrant including plugin vagrant-aws, and if required, proxy

The vagrant project has changed according to the changes on the sw360 - basically, which Liferay server has been used. Please refer to the following overview:

vagrant version sw360 version Liferay version OpenJDK Linux Remarks
early days 3.3 and 4.0.1 6.2 8 Ubuntu 14.04 LTS
1.0 5 onwards 7.2 8 Ubuntu 16.04 LTS
2.0 11.0 - 12.0 including 7.3 11 Ubuntu 18.04 LTS
post 2.0 - pre 2.1 first commit after 12.0, last commit before 13.0 7.3 11 Ubuntu 18.04 LTS
2.1 13.0 including 7.3 11 Ubuntu 18.04 LTS
2.2 13.1 including 7.3.3 11 Ubuntu 18.04 LTS
3.0 13.2 including 7.3.4 11 Ubuntu 20.04 LTS with couchdb 3.1.1

There is maybe more fine grained information about the actual commit IDs, if you would like to launch earlier versions, you would need to install a particular tag of an earlier version of sw360vagrant. If not, you will checkout the current master.

After the vagrant setup has finished, the Liferay server and the sw360 needs to be setup. depending which version you do use, select one of the following guides:

MacOS Installation Notes

If you are considering to use the Mac platform, you should really consider installing Homebrew https://brew.sh/. For the further the following packages need to be installed:

brew cask install virtualbox
brew cask install vagrant

This is to run the sw360vagrant in general. But, for machos there are three issues:

  • there is no wget util
  • there is only a old version of the bash shell (3.2)
  • the linux tool realpathisnot available.

Therefore the following tools need to be installed:

brew install wget
brew install bash
brew install coreutils

Then, as with other OSes (such as Ubuntu), you will need:

vagrant plugin install vagrant-aws
vagrant plugin install vagrant-disksize
Clone this wiki locally