- Table of contents
Here you will find user instructions related to using SciSoft.
In addition to the instructions below, please also see build-framework.
See the "Getting Help" section if you have further questions.
While it is possible to download individual files directly from http://scisoft.fnal.gov/, we recommend using pullProducts or pullPackage Use pullProducts to download a complete distribution bundle. Use pullPackage to download a single product. Refer to the help (-h) in both scripts for more information. The major distribution bundles have download instructions for each release. See, for instance, the instructions for larsoft v06_51_00.
About SciSoft permissions¶
For security reasons, the ability to upload files is strictly controlled. Only a few people from any one project or experiment will have the necessary permissions to upload files. Read-write access to SciSoft is controlled via nfs4 Kerberos groups. Each project/experiment will have their own group. Anyone requesting permissions must have a valid Fermilab user account and a FermiCloud account. A valid Kerberos ticket is required when using the upload tools.
Update an existing package on SciSoft¶
To upload tarballs for an existing package, use copyToSciSoft.
Update an existing bundle on SciSoft¶
To add a new bundle release, simply use copyToSciSoft to upload the manifests, related tarballs, build config, and bundle description html files. The build config files are used by buildFW.
Adding a new package or bundle to SciSoft¶
First make a Service Now reqest (see above) for permissions to add the new product or bundle. You will need to specify the correct spelling of the package or bundle. You will also need to specify the permission group (generally an experiment) who will need write permissions for this bundle or package. If there is not yet an appropriate permission group, you will also need to specify the people who need write access. Once permissions have been granted, use copyToSciSoft to upload the appropriate files.
The copyToSciSoft script makes all necessary directories and copies the files into them. Wildcards are permissible. The file will NOT be copied if it already exists. If you need to replace a file, please first login to scisoftportal.fnal.gov and carefully remove only the file you wish to replace. Then run copyToSciSoft.
- Requests for new versions of existing packages should be made through the SciSoft issues tracker
- Bug reports for experiments or projects should be made via the redmine site for that experiment or project.
- If you wish to do any of the following, please open a Service Now ticket by searching for SciSoft on the dashboard. Then "request service".
- request space on SciSoft for a new experiment or project
- add or remove people from a permission list
- add the build of a new package to SciSoft for an existing experiment or project
- This link should take you to the SciSoft request page: https://fermi.service-now.com/wp?id=evg-service-item&sys_id=6cb39034db1c1f00da5174131f9619cc
- User instructions for uploading packages and distribution bundles are on redmine.
- All other questions may be directed to firstname.lastname@example.org