Document ingestsql

[andrey-utkin]

This documents cvmfs_swissknife ingestsql command.

Deployed for preview at https://autkin.net/tmp/doc-cvmfs/html/cpt-swissknife.html

There is a small cleanup in a separate commit.

[vvolkl]

Looks great! Only suggestion I have is to move it here: https://autkin.net/tmp/doc-cvmfs/html/cpt-repo.html#grafting-files Instead of a separate section on swissknife.

Actually we may also be missing a convenience wrapper cvmfs_server ingestsql. For other swissknife commands we typically have a cvmfs_server "wrapper" command that loads the config and uses this to fill most of the parameters. I'll look into this

[andrey-utkin]

@vvolkl would you accept documentation of swissknife ingestsql command into the repo, or only cvmfs_server ingestsql? Asking regardless of which section anything would go.

[vvolkl]

@vvolkl would you accept documentation of swissknife ingestsql command into the repo, or only cvmfs_server ingestsql? Asking regardless of which section anything would go.

Hopefully cvmfs_server is the same as swissknife but just easier to use, so for user-facing documentation I think it makes sense to show cvmfs_server. If there's a good reason to use cvmfs_swissknife that can be used too.

If it's OK for you I will replace current latest branch with mkdocs, before merging this, so this PR should be changed to markdown.

[andrey-utkin]

I have reworked the added content on top of current latest branch.

I kept it centered on cvmfs_swissknife ingestsql command and merely mentioned cvmfs_server ingestsql, because the wrapper doesn't seem to be working as intended now. I can't find a substitute for the initial command, creating an empty database file: cvmfs_swissknife ingestsql -D '' -N '' -n my.db

[root@cvmfs-dev /]# cvmfs_server ingestsql -D '' -N '' -n my.db
Please provide a SQLite database with -D <path>                                                                                                                [root@cvmfs-dev /]# cvmfs_server ingestsql -D /dev/null -N '' -n my.db
Error: The repository -N does not exist.
[root@cvmfs-dev /]# cvmfs_server ingestsql -D /dev/null -N repo.name -n my.db
Error: The repository my.db does not exist.
[root@cvmfs-dev /]# cvmfs_server ingestsql -D my.db repo.name
Error: The repository repo.name does not exist.
[root@cvmfs-dev /]# ls /cvmfs/
test.cern.ch  test.repo.org
[root@cvmfs-dev /]# cvmfs_server ingestsql -D my.db test.repo.org
failed to stat file my.db
cvmfs_swissknife: /usr/local/src/cvmfs/cvmfs/swissknife_ingestsql.cc:502: vector<string> get_file_list(string &): Assertion `0' failed.
Aborted (core dumped)
ingestsql failed

Executed Command:
cvmfs_swissknife ingestsql -N test.repo.org -w http://cvmfs.web.garage.internal:3902/test.repo.org -t /var/spool/cvmfs/test.repo.org/tmp -k /etc/cvmfs/keys/test.repo.org.pub -s /etc/cvmfs/keys/test.repo.org.gw -@ http://127.0.0.1:8008 -D my.db
[root@cvmfs-dev /]#