README
¶
Pelican Command Line
The Pelican command line tool allows one to use a Pelican federation as a client and serve datasets through running a Pelican origin service.
For more information on Pelican, see the Pelican Platform page.
For documentation on using the Pelican Platform, see the Pelican Platform documentation page.
Testing and Usage
Run the following command to download a test file (/test/query1) from the
configured federation:
$ pelican object get /test/query1 ./
Running an Pelican origin
To launch a Pelican origin, run the following:
pelican origin serve -f https://director.example.com -v /tmp/stash/:/test
Running an OSDF origin or client
The Open Science Data Federation (OSDF) is a well-known Pelican federation in support of the science and engineering communities in the US.
To launch an origin using OSDF defaults, rename the output binary from
pelican to osdf. Then, run:
osdf origin serve -v /tmp/stash/:/test
Similarly, the osdf binary can be used to download from the OSDF:
$ osdf object get /osgconnect/public/dweitzel/blast/queries/query1 ./
To ease the transition of stashcp
users to pelican, the tool can also
be renamed or symlinked to stashcp:
$ stashcp /osgconnect/public/dweitzel/blast/queries/query1 ./
and it shares the same defaults and behavior as stashcp.
Building
Building is performed with the goreleaser tool. To build a snapshot (not release):
$ goreleaser --clean --snapshot
The binaries will be located in ./dist directory.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package launcher_utils contains utility functions for the github.com/pelicanplatform/pelican/launcher package.
|
Package launcher_utils contains utility functions for the github.com/pelicanplatform/pelican/launcher package. |
|
LotMan is only supported on Linux at the moment.
|
LotMan is only supported on Linux at the moment. |
|
Package namespaces implements namespace lookups and matches for legacy [stashcp] and [osdf-client] to maintain backward compatibility.
|
Package namespaces implements namespace lookups and matches for legacy [stashcp] and [osdf-client] to maintain backward compatibility. |
|
Package registry handles namespace registration in Pelican ecosystem.
|
Package registry handles namespace registration in Pelican ecosystem. |
|
Package server_structs shares structs and their methods used across multiple server packages (origin/cache/registry/director).
|
Package server_structs shares structs and their methods used across multiple server packages (origin/cache/registry/director). |
|
Package server_utils shares utility functions used across multiple server pacakges (origin, cache, registry, director).
|
Package server_utils shares utility functions used across multiple server pacakges (origin, cache, registry, director). |