[continued from previous message]
| fossil import --git \ |
| --rename-master trunk \ |
| --attribute "your@mail.com your_username" \ |
| --attribute "rms@gnu.org rms" \ |
| --attribute "linus@kernel.org torvalds" \ |
| repository.fossil ~/git-exported/repository.export |
+-------------------------------------------------------------------+
The output of the import command looks like the following:
+-------------------------------------------------------------------+
| Rebuilding repository meta-data... |
| 100.0% complete... |
| Vacuuming... ok |
| project-id: e64b112b40eb3db188060ddb8deeaa96a6ad3b71 |
| server-id: bfbcd4bf8f0f64eaa2d832ddc3b4af00639624a6 |
| admin-user: your_user (password is "XAxPVZcNQ6") |
+-------------------------------------------------------------------+
If you look closely, the output gives you the repository
administrator's user and password. Keep it because you'll
need it to do certain things on your repository.
Setting Up a Fossil Server
==========================
Fossil has an embedded web server so you can take advantage of it to
create a self-hosted server quickly and easily. The following method
is enough for a system with few users, in a private network that
cannot be accessed from the outside. There are different ways to set
up a Fossil server and some are better than others depending on your
needs, so I recommend you to check out the official documentation.
First you should create a folder to store the Fossil repositories on
the server:
+-------------------------------------------------------------------+
| mkdir /path/to/your/fossils |
+-------------------------------------------------------------------+
Next copy your "fossils" to the folder on the server:
+-------------------------------------------------------------------+
| scp *.fossil user@your_server:/path/to/your/fossils/ |
+-------------------------------------------------------------------+
Now you can start the server with the following command:
+-------------------------------------------------------------------+
| fossil server --port 8043 \ |
| --cert /path/to/your_cert.pem \ |
| --pkey /path/to/cert/key.pem \ |
| --repolist /path/to/your/fossils/ |
+-------------------------------------------------------------------+
If you don't have a valid certificate you can use the follwing
command:
+-------------------------------------------------------------------+
| fossil server --port 8043 \ |
| --cert unsafe-builtin \ |
| --repolist /path/to/your/fossils/ |
+-------------------------------------------------------------------+
Once the server is running, if you put the following url
in your browser you'll
access a web page with the list of your repositories. If you click
on one of the repositories listed, you'll see the repository web
page. In the navigation menu you should see a "login" option. Click
on it and use the repository administrator's username and password.
Now you can configure the repository to your liking. Check out
Fossil's documentation to learn more.
If you lost your Fossil repository administrator's password, you can
recover it by following these steps:
1. Go to the repositories folder in your server.
2. If you don't have Sqlite installed, install it following the usual
method of your operating system.
3. Open repository.fossil with Sqlite:
+--------------------------------------------------------------+
| sqlite3 repository.fossil |
+--------------------------------------------------------------+
4. Once inside sqlite execute the following query:
+--------------------------------------------------------------+
| select login,pw from user; |
+--------------------------------------------------------------+
The query above will return something like:
+--------------------------------------------------------------+
| your_user|My3w2jRxt1 |
| anonymous|57EBCBD1AAE663B4 |
| nobody| |
| developer| |
| reader| |
+--------------------------------------------------------------+
The password is the value on the second column (in this example
the string My3w2jRxt1).
5. Exit Sqlite with the following command
+--------------------------------------------------------------+
| .quit |
+--------------------------------------------------------------+
Using Fossil
============
Here is a very brief guide on how to start working with Fossil. This
guide assumes that you know how to use Git, at a very basic level,
and it's just a starting point, so I recommend you to read Fossil's
documentation and the Fossil Book [5].
Getting Help
------------
The help command is essential to see which commands are available and
the uses and options of each one of these commands. The help command
works just like Git:
+-------------------------------------------------------------------+
| fossil --help |
| fossil command_name --help |
+-------------------------------------------------------------------+
Creating and cloning repositories
---------------------------------
These are similar to Git's but with differences. In Git it's usual
that the repository matches the current working folder. In Fossil
this is not so, there is a clear separation between the repository,
file repository.fossil, and the working (check-out) folder
repository_folder.
Creating a repository
---------------------
You can create a new repository with the command:
+-------------------------------------------------------------------+
| fossil init repository.fossil |
+-------------------------------------------------------------------+
This command will create only the repository, i.e. the file
repository.fossil. To start working with it you have to "open it".
Create a folder, move inside it, and open the repository:
+-------------------------------------------------------------------+
| mkdir my_working_folder |
| cd my_working_folder |
| fossil open /path/to/repository.fossil |
+-------------------------------------------------------------------+
You can also tell Fossil the name of the working folder and if it
does not exist Fossil will try to create it:
[continued in next message]
--- SoupGate-Win32 v1.05
* Origin: you cannot sedate... all the things you hate (1:229/2)
|
