Skip to content

Commit 754da00

Browse files
authored
Merge pull request #57 from bedroge/publish_improvements
Add note about changing the cvmfsdirtab file
2 parents a6332b8 + 994db9c commit 754da00

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

docs/04_publishing.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ By adding an (empty, hidden) file named `.cvmfscatalog` into a directory of your
110110

111111
### 4.3.2 `.cvmfsdirtab` file
112112

113-
Instead of creating `.cvmfscatalog` files, you can also add a (hidden) file named `.cvmfsdirtab` to the root of your repository. In this file you can specify a list of relative directory paths (they all start from the root of your repository) that should get a nested catalog. You can also use wildcards to specify patterns and automatically include future contents, and use exclamation marks to exclude paths from a nested catalog.
113+
Instead of creating `.cvmfscatalog` files, you can also add a (hidden) file named `.cvmfsdirtab` to the root of your repository. In this file you can specify a list of relative directory paths (they all start from the root of your repository) that should get a nested catalog. You can also use wildcards (both `*` and `?`) to specify patterns and automatically include future contents, and use exclamation marks to exclude paths from a nested catalog.
114114

115115
As an example, assume you have a typical HPC software module tree in your repository with the following
116116
structure (relative to the root of the repository):
@@ -150,6 +150,9 @@ One final note: if you use a `.cvmfsdirtab` file, a tarball ingestion using the
150150
[will currently (in CernVM-FS 2.8.0) not automatically create the nested catalogs](https://sft.its.cern.ch/jira/browse/CVM-1968).
151151
You will need to do another (empty) transaction right after the ingestion to trigger the creation of the nested catalogs.
152152

153+
!!! warning
154+
If you change `.cvmfsdirtab` later on and exclude certain paths from the structure, either directly or indirectly, previously generated `.cvmfscatalog` files will not be automatically removed.
155+
You have to remove those manually in order to really get rid of these nested catalogs.
153156

154157
## Exercise
155158

0 commit comments

Comments
 (0)