Update of "User Guide"
Not logged in

Artifact ID: 568d75fe135a5d98aaa58e29f59e66d0802c5059
Page Name:User Guide
Date: 2020-05-30 03:08:10
Original User: martin_vahi
Parent: edf9d84a0e117ed4e5e3aa571261d340c43f6757 (diff)
Next 83fa96f15a9d963bad2e2b6c59cd7af553c72e59

Instructions for Application Developers and Power Users 

The latest milestone release main deployment deliverable is a single Bash script. If it is executed without any command line arguments, then it prints out its usage instructions.

How to get a copy of this Fossil-repository

In an ideal world this whole ~40GiB Fossil repository could be cloned, but in practice the cloning of this repository accesses the SQLite database of this Fossil repository's online instance and although the SQLite is able to hold huge volumes of data, it does not withstand the number of threads that get started by web spiders and cloners all at once. The temporary database locking probably/often_times/usually causes an error during the cloning and therefore the way to get a copy of this Fossil repository MIGHT BE to copy a slightly modified version of it from 


Its difference from the online version is that its passwords have been changed, so that hopefully it should not be possible to get the passwords of the online version from the downloadable file.

Using the wiki of a Locally Stored Fossil-repository

The wiki at the locally stored Fossil-repository can be used by running the Fossil, a command-line program that includes a web server that serves the fossilrepository wiki page at some localhost:someport or public_IPaddress_of_the_machine:someport.

    # on localhost:
        fossil ui -port 2000 `pwd`/silktorrent.fossilrepository
    # on public IP address:
        fossil server -port 2000 `pwd`/silktorrent.fossilrepository

If this Repository were clonable, then ...

All of the development deliverables can be downloaded by cloning this Fossil repository. The cloning can take hours and it requires at least 40GiB of HDD space. The recommended way to anonymously clone the Silktorrent Fossil repository is to run the following Bash line:

    mkdir -p ./tmp_; SQLITE_TMPDIR=`pwd`/tmp_ time nice -n18 fossil clone --unversioned  https://www.softf1.com/cgi-bin/tree1/technology/flaws/silktorrent.bash/  ./silktorrent.fossilrepository

If You are a Fossil repository administrator and Your username is martin_vahi and Your remote/central Fossil instance is running at 


then the Bash line for cloning the the repository would be:

    mkdir -p `pwd`/tmp_; SQLITE_TMPDIR=`pwd`/tmp_ time nice -n18 fossil clone --unversioned --private --admin-user martin_vahi https://martin_vahi@www.softf1.com/cgi-bin/tree1/technology/flaws/silktorrent.bash/ ./repository_storage.fossil