Initial Setup of Liferay 7.2 and sw360

Starting SW360 for the First Time

So, the vagrant setup has deployed sw360, but unfortunately, there is some major issue: With Liferay, certain configuration need to be applied manually in the UI. If you would know how to import *.lar files and apply some setting from the command line (without implementing an approach based on HTML testing frameworks, like selenium), please let us know.

Until then, some tasks need to be done manually, after everything has been built up:

  • import *.lar files
  • set password policies not to change after first login (it is annoying when developing)
  • set the default area to be SW360 when users login to liferay
  • apply some more settings, like users cannot create accounts on their own

Setup Login

After successful installation, the screen should look like this. If there is weird html output without images and plain text, then likely some port settings did not work and the pages generated have wrong URLs inside.

Sign in_the icon_the upper left corner. If you did not change the values in configuration.rbthe default login is setup@sw360.org and sw360fossy.

User Settings in SW360

Go into the control panel area which can be unfold by clicking in the upper left corner. In this area, go for Users > Password Policies and disable change Required if you wish to do so. Click on Save to save the selection.

Then, in Configuration > Instance Settings > Users > Default User Associations to enter SW360 and apply it also to existing users. Click on Save to save the selection.

Then, in Configuration > Instance Settings > User Authentication > General to disable all kind of auto login to make sure only authenticated users can log in.

Depending on your preferences make appropriate selections according to the screenshot. It is not advisable to allow users to self register in order to access the SW360 data.

Import *.lar Files

Then, in the SW360 area > Publishing > Import klick on the plus sign in order to import the *.lar file for public pages.

As for import settings, follow the selection as shown on the screenshot. It is very important that for the PublicPages.lar file the selection Public Pages is made.

Importing permission makes sure that pages are visible according to users rights. For public pages, it is irrelevant_the moment.

Overwriting and the write as current user needs to be selected.

After successful importing the following view should appear.

The same steps shall be repeated for the PrivatePages.lar file.

Make sure that Private Pages is selected. Follow the other selections made as shown on the screenshots.

Importing permissions …

Mirror with overwriting, use the current author …

Then the successful result should be shown like this:

If you click then the liferay logo_the upper left corner where the SW360 is, you will return to the application and the following screen should appear. Click Start to open the private pages. You are still logged in, so the setup account is used to view the pages.

Important The setup account does not belong to a group. Thus, not all view are functional because they require a group membership to work correctly.

Import User Accounts for Testing

Assuming you are still logged in, the main view of SW360 looks as follows:

Click the SW360 Admin menu which is_the right and selection the User item.

At the bottom of that view, select a User file to import for testing. Skip it if you will create users differently.

You can find a user file to import in the sw360vagrant project in the folder shared.

After the user have been imported successfully, they should appear in the table view.

After the user have been imported successfully, they should appear in the table view.

Real Login

One example user is user@sw360.org with the password 12345. Note that in the import file with the example accounts, the passwort is provided with a hash. If you would like to generate new (salted) hashes, you can change your password and export the user list using the same portlet where you have imported the users. This functionality can be also used to migrate accounts between users.

After the successful login, SW360 will look as follows.

After the successful login, SW360 will look as in the following screenshot.

For example, click on Projects to see that no projects have been created so far …