Fossil

1) Get fossil.exe on each of two PCs, in the Windows folder and open a comman d prompt.

2) on one PC which I'll call Server, create a file Test.txt with the following two lines:

Line 1
Line 2

3) still on server, type:

fossil new Test.fossil
fossil open Test.fossil
fossil add Test.txt
fossil commit -m "First version"
fossil close Test.fossil
fossil ui Test.fossil

4) Set up the new project name, description and logo in the browser

5) Set the (Windows) firewall (control panel) to listen to TCP port 80

6) on the other PC, which I'll call Client, type:

fossil clone http://Server/Test.fossil Test.fossil

The party ends here. I get told:

__________________________________________________________
                Bytes      Cards  Artifacts     Deltas
Send:              49          1          0          0
ERROR. server says:  405 Method not allowed
Send:             619         24          0          0
ERROR. server says:  405 Method not allowed
Total network traffic: 603 bytes sent, 2000 bytes received
Rebuilding repository meta-data...
0 (0%)...
project-id: (null)
server-id:  cdc358fe23c4aeb03e467e6e9c44d8b4547bb4d8
admin-user: Ross (password is "0f00ea")
__________________________________________________________

Apparently Artifacts should be artefacts (i->e)

What does "ERROR. server says: 405 Method not allowed" mean? How do I get a copy of Test.txt out of the repository to edit?

You must have spent hundreds of hours on the code, but it's wasted if it takes an enthusiastic newbie I.T. manager a day to get this far! I'd love to use fossil and support it, but it needs a forum for help (I can't find one) or at least a walk-through in the style I started above (perhaps a flow chart to include potential errors like forgetting to open ports). If it needs me to write the docs, I'll do it, but first I need to make it work!

anonymous claiming to be Arnel added on 2010-05-18 23:14:33:
The repo cloning needs to be done this way:

• Launch the server instance using either fossil ui or fossil server using the first repo.
• On the user's own PC (where the clone will be kept), run fossil clone http://<servername or IP address>:<port #> clone_repo.fossil to process the cloning.

The documentation's a little sparse than what I would have liked, yes, but I've found the text within the "help" command sufficient for what I needed. Most of the wikis go deeper into some of the concepts involved with Fossil and DVCS in general. Is there anything in particular that you're looking for?

anonymous claiming to be Ross added on 2010-05-20 21:26:32:
Specifically, I'd like a forum to ask questions on, but for now, to know what this means:

ERROR. server says: 405 Method not allowed

and how to get a copy of a file from the server to the client (I've got as far as your bullet points, but something is wrong... 405

My previous attempt at writing a post lost every other newline, so I'll reformat it and make it legible here:

__________________________________________________________

I want to get my company using fossil, but can't figure it out from the web site and can't find a forum or email to seek help, so I'm adding this! The tutorial in the wiki is no help. The 'quick start' is all out of order: a newbie needs a process to follow to see things happening.

The first thing any user will want to do is put a file into a new repository, get it to another PC, change it, and see the changes on the first PC...

Here's what I'm trying (using Windows at the moment):

1) Get fossil.exe on each of two PCs, in the Windows folder and open a command prompt.

2) on one PC which I'll call Server, create a file Test.txt with the following two lines:

Line 1

Line 2

3) still on server, type:

fossil new Test.fossil

fossil open Test.fossil

fossil add Test.txt

fossil commit -m "First version"

fossil close Test.fossil

fossil ui Test.fossil

4) Set up the new project name, description and logo in the browser

5) Set the (Windows) firewall (control panel) to listen to TCP port 80

6) on the other PC, which I'll call Client, type:

fossil clone http://Server/Test.fossil Test.fossil

The party ends here. I get told:

__________________________________________________________

Bytes Cards Artifacts Deltas Send: 49 1 0 0

ERROR. server says: 405 Method not allowed

Send: 619 24 0 0

ERROR. server says: 405 Method not allowed

Total network traffic: 603 bytes sent, 2000 bytes

received Rebuilding repository meta-data...

0 (0%)...

project-id: (null) server-id: cdc358fe23c4aeb03e467e6e9c44d8b4547bb4d8 admin-user: Ross (password is "0f00ea")

__________________________________________________________

Apparently Artifacts should be artefacts (i->e)

What does "ERROR. server says: 405 Method not allowed" mean?

How do I get a copy of Test.txt out of the repository to edit?

You must have spent hundreds of hours on the code, but it's wasted if it takes an enthusiastic newbie I.T. manager a day to get this far! I'd love to use fossil and support it, but it needs a forum for help (I can't find one) or at least a walk-through in the style I started above (perhaps a flow chart to include potential errors like forgetting to open ports). If it needs me to write the docs, I'll do it, but first I need to make it work!

anonymous claiming to be Arnel added on 2010-05-21 00:13:01:
Thanks for the reformat - it does read better that way.

I think the 405 error is related to the way you're trying to clone the repo with

fossil clone http://Server/Test.fossil Test.fossil

If you need to clone another repo file, you will need to use

fossil clone --repository <repo filename>

Once you're done cloning, you should run

fossil open <repo filename>

anonymous added on 2010-05-21 21:11:52:
But I _am_ trying to clone from the server (see my number 6 says:

6) on the other PC, which I'll call Client, type:

fossil clone http://Server/Test.fossil Test.fossil

I'm trying to work on the same repo from two computers, so I'm making a test text file, adding it to test.fossil, then trying to edit that file from a different computer. I thought that's what this is for, and that this is the simplest thing to start with...

I also want to find out how to do other simple things, like edit the home page (web page) but can't find any way to do so.

Hence my request for documentation - a list of what error numbers mean, a walkthrough of each process users would expect to go through etc.

anonymous added on 2010-05-22 09:52:44:
It's just occurred to me that Error 405 might be an HTTP server reply.

It would be helpful if the error message said that: I thought it was a fossil error number, but if it's HTTP I can simply look up what to do on the Internet...

See how much a little documentation could help! Several days of no progress, thinking I couldn't find the error, when really I could! = frustrating.

anonymous claiming to be Ross added on 2010-05-22 13:51:40:
I can finally document the first steps for a newbie (to Version Control as well as fossil)!

On the server:

Make a simple text file (Test.txt):

Line 1
Line 2

Create a new repository and put the text file in it, noting the User and Password that 'new' gives, and the port that 'server' gives:

fossil new Test.fossil
fossil open Test.fossil
fossil add Test.txt
fossil commit -m "First version"
fossil close Test.fossil
fossil server Test.fossil

Now on another network-connected PC (the Client) type:

fossil clone http://User:Password@Server:8080/Test.fossil Test.fossil

• If the server has another application listening to port 8080, you may get ERROR. server says: 405 Method not allowed an HTTP error 405.
• If you forget the User and Password, and are using port 80, you will get ERROR. server says: 401 Unauthorized an HTTP error 401.
• If you forget the User and Password you will get Error: not authorized to clone.
• If you get the Password wrong (it is case-sensitive) you get Error: login failed.

To access Test.txt, open the repository and check out the file:

fossil open Test.fossil

   211 manifest
    41 manifest.uuid
50,176 Test.fossil
    18 Test.txt
 7,168 _FOSSIL_

The contents of the checked out repository can be listed with fossil ls

now for the reverse journey, edit the text file, Test.txt, adding Line 3 in the middle:

Line 1
Line 3
Line 2

After saving the file, use fossil commit -m "Added Line 3"</kdb> to update the local repository, and fossil push to update the Server repository.

Now you can go to a third PC and go through the same client process to alter Text.txt again.

drh added on 2010-05-22 14:45:51:
The message "Method not allowed" is not an error message generated by Fossil.

The "fossil ui" command uses TCP port 8080 by default. This suggests that the original poster has some other web server or web service running on port 80 and that other web server is the thing generating the "Method not allowed" error.

anonymous claiming to be Ross added on 2010-05-22 19:26:28:
That's right: IIS was running on the Server, but that wasn't my only problem: I hadn't figured out that I had to specify the 8080 or the user and password on the clone url.

I couldn't get a clear picture in my head about how fossil was making the connection because the user,password,port and url are not demonstrably linked in the documentation.

Any help on how to edit the home page? I still can't figure that out either!

anonymous claiming to be Ross added on 2010-05-22 19:48:53:
OK -I've logged into the fossil server from the client on my browser and seen the description of how to edit the home page - I haven't made a wiki page yet. You can close this ticket now - thanks for helping, and above all, thanks for making the application in the first place. Hopefully my attempt at a quick-start (above) will be useful for someone else.