Update of "User Guide"
Not logged in
Overview

Artifact ID: 18bef4d20483fde4f7e339a476c14eb9865cf403
Page Name:User Guide
Date: 2020-05-30 00:59:57
Original User: martin_vahi
Parent: 74e406f9c47883d1dfe2e0f451199189655f4b03 (diff)
Next d7134dfecd2afab64be54de6b677a42add7330ea
Content


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 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 

https://silktorrent.softf1.com/hopefully_downloadable_silktorrent.fossilrepository

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 from the downloadable file and then log in to the online version.


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 

    https://www.softf1.com/cgi-bin/tree1/technology/flaws/silktorrent.bash/

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

The Web UI of the cloned repository can be used by

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