Overview of the Fossology User Interface¶

This chapter provides an overview of the default Fossology User Interface (UI). Detailed descriptions of Fossology's functions are provided in additional sections of Fossology documentation, which can be accessed from the User Docs contents page.

Fossology User Interface - Initial Screen¶

The Fossology User Interface (UI) initial screen is shown below.

When you first access the Fossology UI - limited functionality is available until you log in to the interface. An example of the initial Fossology screen is shown below.

The functions that are provided to users who are not logged-in are:

• Home - return to Home page
• Help - get help using Fossology
• Login - log in to the full Fossology UI

Depending on how the FOSSology site is administered and configured, users may also be able to search or browse.

• Search - search the uploaded projects for specific files
• Browse - browse the currently uploaded projects

Once you have logged in to the Fossolgy UI, you can access Fossology's full functionality, as described in the following sections.

Logging In to the UI¶

You can log in to the Fossology UI by clicking on the highlighted login item on the right side of the screen. \\

The following login screen is displayed.

Fill in the username/password information and then click the button at the bottom of the screen. \\
*Notes: *

• Prior to being able to log in, you must posses an account on the Fossology system.
• Username and Password are required.

Fossology User Interface - After Logging In¶

After you log in to the Fossology user interface, the following screen is displayed.

Getting Help¶

The Help menu provides several topics about the Fossology user interface.

Finding License Information Using Browse¶

The Browse tab provides a means of displaying analyzed license information in the fossology Respository.

An example of the Browse screen is provided below.

Note that the Browse screen provides folder navigation in the left-side window, and upload information in the right-side window. By clicking on a folder and then on an upload, you can browse the repository and navigate to license information.

Refer to the following documentation for detailed information about using the Browse functionality.

• FIXME the links below need updating
• How to Browse the Data-Base explains some basics about using the Browse functionality.
• How to Find Analyzed License Information explains how to navigate through the license information provided by Browse.

Uploading Files to Analyze¶

FOSSology has many options for importing and uploading files for analysis. \\ These options can be accessed from the Upload tab in the Fossology UI.

The options vary based on where the data to upload is located. The data can be uploaded from:

• Your browser system - Use the Upload a File from your computer option to select and upload the file. While this can be very convenient (particularly if the file is not readily accessible online), uploading via your web browser can be slow for large files, and files larger than 650 Megabytes may not be uploadable. * A remote server - Use the Upload from a URL option to specify a remote server. This is the most flexible option, but the URL must denote a publicly accessible HTTP, HTTPS, or FTP location. URLs that require authentication or human interactions cannot be downloaded through this automated system.
• Use the Analyze a single file for licenses option to upload a single file for license analysis (similar to upload from file). The analysis is done in real-time. Note the limitations that are listed on the One-Shot License Analysis screen.
• Use the Analyze a single file for Copyrights, Email and URL's option to upload a single file for copyright, email and URL analysis (similar to upload from file). The analysis is done in real-time. Note the limitations that are listed on the One-Shot Copyright/Email/URL screen.

If your system is configured to use multiple agent servers, the data area must be mounted and accessible to the FOSSology user (fossy) on every agent system. See the section scheduler in the Scheduler documentation.

Organizing Fossology Data¶

Fossology provides many options for organizing license data and uploads.

You can access these options from the Organize tab in the Fossology UI.

Organizing Folders¶

In the Organize > Folders submenu, you can Create, Edit, and Move folders. Only administrators are allowed to delete folders. There is no undelete, so folder removal is permanent.

Organizing Uploads¶

The Organize > Uploads submenu provides the ability to move uploaded files and edit the properties of uploaded files. Only administrators are allowed to delete uploaded files. There is no undelete, so upload removal is permanent.

Managing Jobs on the System¶

The Jobs menu is used to manage Fossology jobs and access Fossology job information.

Within this menu, you can schedule an uploaded file for license analysis, and you can follow the progress of the analysis.

How to Interpret the Job Queue provides a description about interpreting and using the information provided by the Jobs functions.

Scheduling an Analysis¶

The Jobs>Agents menu item provides access to the various Fossology agents that perform the license analysis of files that have been uploaded to the Fossology Repository. In addition to scheduling a general license analysis, there are several specific types of analysis that can be performed.

MyJobs¶

The MyJobs function is designed to give the user a continuous status of their jobs by automatically updating the page every seven seconds. MyJobs provides less detail than the other job displays but provides a link to the Jobs>Queue>Details page if more details are needed for a particular job.

Getting Job Queue Information¶

The Jobs > Queue menu provides access to job information in the following ways:

• Job queue summary - See a short summary of jobs.
• Job queue details - See detailed information about jobs.
• Job queue information by upload - See scheduled jobs associated with an uploaded file.

The following fossology job information is provided:

• Jobs that are Queued
• Jobs that are Scheduled
• Jobs that are Running
• Jobs that are Finished
• Jobs that are Blocked
• Jobs that are Failed

Performing Administrative Functions¶

For details on how to administer FOSSology, see [[admin:Admin User Interface|Administering FOSSology]]

Finding Files Using Search¶

The search menu is an optional feature that by default is turned off. The FOSSology administrator determines if search if available to users. The feature is turned off by default because this feature allows anyone to search and display any material in the Fossology system. Even if that material is not yours. In the future FOSSology will change this feature to by default search only the users material.

If search is turned on, it will be visible when you are logged in. See below.

Select the Search tab in the top menu to access the search screen.

If you know the name, or part of the name, of a file, you can search for it within the Fossology Repository using the search mechanism on this screen. Enter the search information into the text box, and click the Search button underneath it, to initiate a search.

If you select the Advanced search feature, additional search capabilities are provided, as shown in the following screen example: