Welcome to the sw360portal wiki!
- For development, please see the README.md file of the project first.
- Check the pages on the right widget of pages. Not every page there has a link on this page!
- See the sections below
Naming Policies for this Wiki
Please start every page with a prefix
- Admin: for setting up and configure and maintain
- Dev: All topics for developers
- User: topics suitable for admins and end users
For using the sw360 as a user, please see the following basic workflows:
- Basic workflows for creating a component, release and projects.
- Workflow how FOSSology and sw360 play together.
- How to search in sw360
Particular Use Cases
- Use case description importing projects, releases with licenses BDP Import
- Use case description how to manage vulnerabilities in your project
- User documentation how to use the cve-search server
- Documentation about the handling of vulnerabilities
Explaining how it works
- Find information about the role and access model
- If you are interested in the concept about moderation requests, read the documentation here.
- Explaining fields and terms
- Technical notes about entering the country codes
Deployment: how to install and setup sw360
In order to install sw360, you can choose between the following ways:
- Use the Vagrant-based installation. Please refer to the sw360 vagrant project and the included Readme file. Basic prerequisites are
- Presumeably a git client
- You could install the sw360portal project natively on the machine. This will require more work in order to install the prerequisites. The above mentioned vagrant project documents very precisely what to do in order to install the sw360portal.
- Checkout the docker suite sw360chores and run a docker-based deployment.
- Checkout the docker suite sw360chores and generate a pre-built container where you can deploy the
*.warfiles of sw360portal (both frontend and backend)
Portal deployment: next steps
Once the vagrant deployment is ready, a couple of additional steps need to be applied:
- Setup liferay / sw360
- Setup of connection with Fossology
- Setup Secure Deployment
- More information on how to user sw360vagrant on Windows
Portal deployment: adminstration issues
After installing sw360portal more topics may include:
- How to export data and import it to a new instance
- How to migrate an existing sw360portal to a new instance
- Using costco to modify the couchdb database
- Adding more rights to sw360 admin role, so it can change other user's roles
- sw360.properties explained
sw360 is a server application using Java servlets. It did some faint steps towards micro services (ie. one maintaining licenses, another for vulnerabilities), the frontend is a portlet applications using good old JSPs.
Developing for sw360portal
The sw360portal is Java-based application consisting of two main parts:
- A Liferay/based front end application that allows users to work with sw360
- A Java-based servlet offering Thrift interfaces that allows the Liferay part and other applications to manage and store data
- In the backend, couchdb is used for storing project, component, release and license information as well as attachments.
Contributing: Submitting Issues
Please report issues to the issue tracker, but please keep also in mind that someone else has to read them! Issues should include:
- What you intended to do
- What did you observe
- Why do you think it is wrong
- Screenshots of what you have observed presumably gone wrong or link to pages were another person can follow
- Version where you have observed this.
- Common written English and use of line breaks!!! Use the preview function!
Please refer to the following pages:
As basic introduction, the dev ops works as following:
- We are issue-based, please do not hesitate to create issues - also for questions (and set the issue tag)
- The issues are organised by milestones which do not represent releases anymore. Milestone are meant to be useful packages of work done
- We use the waffle board in order to organize our work
- Contributions are made through pull requests
- We do conversations directly on issues and pull requests
How to get into the sw360 development
- How to write a new portlet
- Adding a new backend service
- Changing the data model
- Infrastructure overview
- Definiton of done and code style
- Creating a sw360 release
- Brief notes on the jgiven testing
- For help with problems, you might want to check that