The following steps describe how to upload a file or files into the FOSSology Software Repository Viewer. Refer to the Interpret the License Analysis Report section for information about how to interpret the information that is provided when you upload a file.

The steps to upload a file are:

1. Choose a folder for the file from the list displayed in the left frame of the main FOSSology Software Repository Viewer screen.
   • Select the folder in which you want to create the project by clicking/highlighting it. (In the example below, we’ve selected Fedora 8.)
   • If you don’t already have an existing folder for the project, skip this step - you can create a new folder in step 3.
2. Click on the “Operations” tab. The following screen appears:
3. If you don’t already have a project folder for the file, create it now by filling in the “Create New Folder” boxes and clicking on the “New Folder” button.
   • The new folder will appear in the left frame.
   • Click/highlight the new folder to select it and click on the “Operations” tab.
4. Click on the “Upload File...” button.
5. The “Upload a File” form (shown below) is displayed.
   • Fill in the required information as directed in Steps 1-4 on the form.
   • Note that the “License Analysis” box (in Step 3) is selected by default.
   • It is possible to just upload the file(s) without analysis by un-checking the “License Analysis” box.
6. Click the “Begin Upload” button after the form is completed.

NOTES:

• A UI request to upload a file will queue up to 5 jobs for scheduling and execution. Refer to Interpret the Job Queue for further information.
• The downloaded file(s) will appear in the left frame of the main FOSSology Software Repository Viewer screen, in the project directory that you designated.
• Refer to the Interpret the License Analysis Report section for help with interpreting the information provided under the “licenses” tab.
• This process could take some time. When the FOSSology tool has finished uploading the file, it will return to the “Upload File” window.

When you request the Viewer to upload a file, the following agents are scheduled and executed:

• wget - gets the requested file from the specified source.
• unpack - extracts files to analyze.

Additionally, if the “License Analysis” box was checked in the “Upload a File” form, then the following agents are also scheduled and executed

• filter license - creates the license cache files.
• license analysis - runs the analysis system on the cache files and generates the list of detected licenses.
• filter clean - purges cache files that are no longer needed.
• mimetype agent - associates a mime-type with every file.
• pkgmetagetta agent - extracts meta data from files.
• specagent agent - extracts information from RPM “.spec” files.

NOTES:

• The License Analysis box is checked by default.
• The agents above will only run on files never seen before. Files that already exist in the repository (for example, from a different software package which happens to use the exact same library files) will be skipped, since all the necessary information is already in the repository.
• The scheduler checks for queued requests every 10 seconds.
• Agents are spawned by the scheduler according to commands in the /usr/local/share/fossology/agents/scheduler.conf file.
• Agents spawned by the scheduler can be viewed by selecting “Show Jobs” from the left frame, as described in the Interpret the Job Queue section.