Update of "User Guide"
Not logged in
Overview

Artifact ID: 1bb56695ac974a52dadd6c35420d4e07e69dae20
Page Name:User Guide
Date: 2020-05-30 03:06:30
Original User: martin_vahi
Parent: d7134dfecd2afab64be54de6b677a42add7330ea (diff)
Next edf9d84a0e117ed4e5e3aa571261d340c43f6757
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 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 

    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