D 2010-05-22T14:41:22
J comment I\swant\sto\sget\smy\scompany\susing\sfossil,\sbut\scan't\sfigure\sit\sout\sfrom\sthe\sweb\ssite\sand\scan't\sfind\sa\sforum\sor\semail\sto\sseek\shelp,\sso\sI'm\sadding\sthis!\r\nThe\stutorial\sin\sthe\swiki\sis\sno\shelp.\r\nThe\s'quick\sstart'\sis\sall\sout\sof\sorder:\sa\snewbie\sneeds\sa\sprocess\sto\sfollow\sto\ssee\sthings\shappening.\r\nThe\sfirst\sthing\sany\suser\swill\swant\sto\sdo\sis\sput\sa\sfile\sinto\sa\snew\srepository,\sget\sit\sto\sanother\sPC,\schange\sit,\sand\ssee\sthe\schanges\son\sthe\sfirst\sPC...\r\nHere's\swhat\sI'm\strying\s(using\sWindows\sat\sthe\smoment):\r\n\r\n\s\s1)\s\sGet\sfossil.exe\son\seach\sof\stwo\sPCs,\sin\sthe\sWindows\sfolder\sand\sopen\sa\scomman\r\nd\sprompt.\r\n\r\n\s\s2)\s\son\sone\sPC\swhich\sI'll\scall\sServer,\screate\sa\sfile\sTest.txt\swith\sthe\sfollowing\stwo\slines:\r\n<blockquote><pre>\r\nLine\s1\r\nLine\s2\r\n</pre></blockquote>\r\n\r\n\s\s3)\s\sstill\son\sserver,\stype:\r\n<blockquote><pre>\r\nfossil\snew\sTest.fossil\r\nfossil\sopen\sTest.fossil\r\nfossil\sadd\sTest.txt\r\nfossil\scommit\s-m\s"First\sversion"\r\nfossil\sclose\sTest.fossil\r\nfossil\sui\sTest.fossil\r\n</pre></blockquote>\r\n\r\n\s\s4)\s\s\sSet\sup\sthe\snew\sproject\sname,\sdescription\sand\slogo\sin\sthe\sbrowser\r\n\r\n\s\s5)\s\s\sSet\sthe\s(Windows)\sfirewall\s(control\spanel)\sto\slisten\sto\sTCP\sport\s80\r\n\r\n\s\s6)\s\son\sthe\sother\sPC,\swhich\sI'll\scall\sClient,\stype:\r\n<blockquote><pre>\r\nfossil\sclone\shttp://Server/Test.fossil\sTest.fossil\r\n</pre></blockquote>\r\n\r\nThe\sparty\sends\shere.\sI\sget\stold:\r\n\r\n<blockquote><pre>\r\n__________________________________________________________\r\n\s\s\s\s\s\s\s\s\s\s\s\s\s\s\s\sBytes\s\s\s\s\s\sCards\s\sArtifacts\s\s\s\s\sDeltas\r\nSend:\s\s\s\s\s\s\s\s\s\s\s\s\s\s49\s\s\s\s\s\s\s\s\s\s1\s\s\s\s\s\s\s\s\s\s0\s\s\s\s\s\s\s\s\s\s0\r\nERROR.\sserver\ssays:\s\s405\sMethod\snot\sallowed\r\nSend:\s\s\s\s\s\s\s\s\s\s\s\s\s619\s\s\s\s\s\s\s\s\s24\s\s\s\s\s\s\s\s\s\s0\s\s\s\s\s\s\s\s\s\s0\r\nERROR.\sserver\ssays:\s\s405\sMethod\snot\sallowed\r\nTotal\snetwork\straffic:\s603\sbytes\ssent,\s2000\sbytes\sreceived\r\nRebuilding\srepository\smeta-data...\r\n0\s(0%)...\r\nproject-id:\s(null)\r\nserver-id:\s\scdc358fe23c4aeb03e467e6e9c44d8b4547bb4d8\r\nadmin-user:\sRoss\s(password\sis\s"0f00ea")\r\n__________________________________________________________\r\n</blockquote></pre>\r\n\r\nApparently\sArtifacts\sshould\sbe\sartefacts\s(i->e)\r\n\r\nWhat\sdoes\s"ERROR.\sserver\ssays:\s\s405\sMethod\snot\sallowed"\smean?\r\nHow\sdo\sI\sget\sa\scopy\sof\sTest.txt\sout\sof\sthe\srepository\sto\sedit?\r\n\r\nYou\smust\shave\sspent\shundreds\sof\shours\son\sthe\scode,\sbut\sit's\swasted\sif\sit\stakes\san\senthusiastic\snewbie\sI.T.\smanager\sa\sday\sto\sget\sthis\sfar!\sI'd\slove\sto\suse\sfossil\sand\ssupport\sit,\sbut\sit\sneeds\sa\sforum\sfor\shelp\s(I\scan't\sfind\sone)\sor\sat\sleast\sa\swalk-through\sin\sthe\sstyle\sI\sstarted\sabove\s(perhaps\sa\sflow\schart\sto\sinclude\spotential\serrors\slike\sforgetting\sto\sopen\sports).\sIf\sit\sneeds\sme\sto\swrite\sthe\sdocs,\sI'll\sdo\sit,\sbut\sfirst\sI\sneed\sto\smake\sit\swork!\r\n\r\n<hr><i>anonymous\sclaiming\sto\sbe\sArnel\sadded\son\s2010-05-18\s23:14:33:</i><br>\r\nThe\srepo\scloning\sneeds\sto\sbe\sdone\sthis\sway:\r\n\s\s*\s\sLaunch\sthe\sserver\sinstance\susing\seither\s<tt>fossil\sui</tt>\sor\s<tt>fossil\sserver</tt>\susing\sthe\sfirst\srepo.\r\n\s\s*\s\sOn\sthe\suser's\sown\sPC\s(where\sthe\sclone\swill\sbe\skept),\srun\s<tt>fossil\sclone\shttp://<servername\sor\sIP\saddress>:<port\s#>\sclone_repo.fossil</tt>\sto\sprocess\sthe\scloning.\r\n\r\nThe\sdocumentation's\sa\slittle\ssparse\sthan\swhat\sI\swould\shave\sliked,\syes,\sbut\sI've\sfound\sthe\stext\swithin\sthe\s"help"\scommand\ssufficient\sfor\swhat\sI\sneeded.\sMost\sof\sthe\swikis\sgo\sdeeper\sinto\ssome\sof\sthe\sconcepts\sinvolved\swith\sFossil\sand\sDVCS\sin\sgeneral.\sIs\sthere\sanything\sin\sparticular\sthat\syou're\slooking\sfor?\r\n\r\n<hr><i>anonymous\sclaiming\sto\sbe\sRoss\sadded\son\s2010-05-20\s21:26:32:</i><br>\r\nSpecifically,\sI'd\slike\sa\sforum\sto\sask\squestions\son,\sbut\sfor\snow,\sto\sknow\swhat\sthis\smeans:\r\n\r\nERROR.\sserver\ssays:\s405\sMethod\snot\sallowed\r\n\r\nand\show\sto\sget\sa\scopy\sof\sa\sfile\sfrom\sthe\sserver\sto\sthe\sclient\s(I've\sgot\sas\sfar\sas\syour\sbullet\spoints,\sbut\ssomething\sis\swrong...\s405\r\n\r\nMy\sprevious\sattempt\sat\swriting\sa\spost\slost\severy\sother\snewline,\sso\sI'll\sreformat\sit\sand\smake\sit\slegible\shere:\r\n\r\n__________________________________________________________\r\n\r\nI\swant\sto\sget\smy\scompany\susing\sfossil,\sbut\scan't\sfigure\sit\sout\sfrom\sthe\sweb\ssite\sand\scan't\sfind\sa\sforum\sor\semail\sto\sseek\shelp,\sso\sI'm\sadding\sthis!\sThe\stutorial\sin\sthe\swiki\sis\sno\shelp.\sThe\s'quick\sstart'\sis\sall\sout\sof\sorder:\sa\snewbie\sneeds\sa\sprocess\sto\sfollow\sto\ssee\sthings\shappening.\r\n\r\nThe\sfirst\sthing\sany\suser\swill\swant\sto\sdo\sis\sput\sa\sfile\sinto\sa\snew\srepository,\sget\sit\sto\sanother\sPC,\schange\sit,\sand\ssee\sthe\schanges\son\sthe\sfirst\sPC...\r\n\r\nHere's\swhat\sI'm\strying\s(using\sWindows\sat\sthe\smoment):\r\n\r\n1)\sGet\sfossil.exe\son\seach\sof\stwo\sPCs,\sin\sthe\sWindows\sfolder\sand\sopen\sa\scommand\sprompt.\r\n\r\n2)\son\sone\sPC\swhich\sI'll\scall\sServer,\screate\sa\sfile\sTest.txt\swith\sthe\sfollowing\stwo\slines:\r\n\r\nLine\s1\r\n\r\nLine\s2\r\n\r\n3)\sstill\son\sserver,\stype:\r\n\r\nfossil\snew\sTest.fossil\r\n\r\nfossil\sopen\sTest.fossil\r\n\r\nfossil\sadd\sTest.txt\r\n\r\nfossil\scommit\s-m\s"First\sversion"\r\n\r\nfossil\sclose\sTest.fossil\r\n\r\nfossil\sui\sTest.fossil\r\n\r\n4)\sSet\sup\sthe\snew\sproject\sname,\sdescription\sand\slogo\sin\sthe\sbrowser\r\n\r\n5)\sSet\sthe\s(Windows)\sfirewall\s(control\spanel)\sto\slisten\sto\sTCP\sport\s80\r\n\r\n6)\son\sthe\sother\sPC,\swhich\sI'll\scall\sClient,\stype:\r\n\r\nfossil\sclone\shttp://Server/Test.fossil\sTest.fossil\r\n\r\nThe\sparty\sends\shere.\sI\sget\stold:\s\r\n\r\n__________________________________________________________\r\n\r\nBytes\sCards\sArtifacts\sDeltas\sSend:\s49\s1\s0\s0\r\n\r\nERROR.\sserver\ssays:\s405\sMethod\snot\sallowed\r\n\r\nSend:\s619\s24\s0\s0\r\n\r\nERROR.\sserver\ssays:\s405\sMethod\snot\sallowed\r\n\r\nTotal\snetwork\straffic:\s603\sbytes\ssent,\s2000\sbytes\r\n\r\nreceived\sRebuilding\srepository\smeta-data...\r\n\r\n0\s(0%)...\r\n\r\nproject-id:\s(null)\sserver-id:\scdc358fe23c4aeb03e467e6e9c44d8b4547bb4d8\sadmin-user:\sRoss\s(password\sis\s"0f00ea")\r\n\r\n__________________________________________________________\r\n\r\nApparently\sArtifacts\sshould\sbe\sartefacts\s(i->e)\r\n\r\n\r\nWhat\sdoes\s"ERROR.\sserver\ssays:\s405\sMethod\snot\sallowed"\smean?\r\n\r\nHow\sdo\sI\sget\sa\scopy\sof\sTest.txt\sout\sof\sthe\srepository\sto\sedit?\r\n\r\n\r\nYou\smust\shave\sspent\shundreds\sof\shours\son\sthe\scode,\sbut\sit's\swasted\sif\sit\stakes\san\senthusiastic\snewbie\sI.T.\smanager\sa\sday\sto\sget\sthis\sfar!\sI'd\slove\sto\suse\sfossil\sand\ssupport\sit,\sbut\sit\sneeds\sa\sforum\sfor\shelp\s(I\scan't\sfind\sone)\sor\sat\sleast\sa\swalk-through\sin\sthe\sstyle\sI\sstarted\sabove\s(perhaps\sa\sflow\schart\sto\sinclude\spotential\serrors\slike\sforgetting\sto\sopen\sports).\sIf\sit\sneeds\sme\sto\swrite\sthe\sdocs,\sI'll\sdo\sit,\sbut\sfirst\sI\sneed\sto\smake\sit\swork!\r\n\r\n<hr><i>anonymous\sclaiming\sto\sbe\sArnel\sadded\son\s2010-05-21\s00:13:01:</i><br>\r\nThanks\sfor\sthe\sreformat\s-\sit\sdoes\sread\sbetter\sthat\sway.\r\n\r\nI\sthink\sthe\s405\serror\sis\srelated\sto\sthe\sway\syou're\strying\sto\sclone\sthe\srepo\swith\s<pre>fossil\sclone\shttp://Server/Test.fossil\sTest.fossil</pre>\r\n\r\nIf\syou\sneed\sto\sclone\sanother\srepo\sfile,\syou\swill\sneed\sto\suse\s<pre>fossil\sclone\s--repository\s<repo\sfilename></pre>\srather\sthan\sthe\sHTTP\smethod.\sThe\sHTTP\smethod\smakes\sfossil\sact\sas\sif\sit's\scloning\sthe\srepo\sfrom\sa\sserver,\snot\sfrom\sa\srepo\sfile\s-\shence\sthe\s405\serror.\r\n\r\nOnce\syou're\sdone\scloning,\syou\sshould\srun\s<pre>fossil\sopen\s<repo\sfilename></pre>\sto\smake\sthe\ssource\stree\scontents\savailable\sfor\sediting.\r\n\r\n<hr><i>anonymous\sadded\son\s2010-05-21\s21:11:52:</i><br>\r\nBut\sI\s_am_\strying\sto\sclone\sfrom\sthe\sserver\s(see\smy\snumber\s6\ssays:\r\n\r\n\r\n6)\son\sthe\sother\sPC,\swhich\sI'll\scall\sClient,\stype:\r\n\r\nfossil\sclone\shttp://Server/Test.fossil\sTest.fossil\s\r\n\r\n\r\nI'm\strying\sto\swork\son\sthe\ssame\srepo\sfrom\stwo\scomputers,\sso\sI'm\smaking\sa\stest\stext\sfile,\sadding\sit\sto\stest.fossil,\sthen\strying\sto\sedit\sthat\sfile\sfrom\sa\sdifferent\scomputer.\sI\sthought\sthat's\swhat\sthis\sis\sfor,\sand\sthat\sthis\sis\sthe\ssimplest\sthing\sto\sstart\swith...\r\n\r\nI\salso\swant\sto\sfind\sout\show\sto\sdo\sother\ssimple\sthings,\slike\sedit\sthe\shome\spage\s(web\spage)\sbut\scan't\sfind\sany\sway\sto\sdo\sso.\r\n\r\nHence\smy\srequest\sfor\sdocumentation\s-\sa\slist\sof\swhat\serror\snumbers\smean,\sa\swalkthrough\sof\seach\sprocess\susers\swould\sexpect\sto\sgo\sthrough\setc.\r\n\r\n\r\n<hr><i>anonymous\sadded\son\s2010-05-22\s09:52:44:</i><br>\r\nIt's\sjust\soccurred\sto\sme\sthat\sError\s405\smight\sbe\san\sHTTP\sserver\sreply.\r\n\r\nIt\swould\sbe\shelpful\sif\sthe\serror\smessage\ssaid\sthat:\sI\sthought\sit\swas\sa\sfossil\serror\snumber,\sbut\sif\sit's\sHTTP\sI\scan\ssimply\slook\sup\swhat\sto\sdo\son\sthe\sInternet...\r\n\r\nSee\show\smuch\sa\slittle\sdocumentation\scould\shelp!\sSeveral\sdays\sof\sno\sprogress,\sthinking\sI\scouldn't\sfind\sthe\serror,\swhen\sreally\sI\scould!\s=\sfrustrating.\r\n\r\n<hr><i>anonymous\sclaiming\sto\sbe\sRoss\sadded\son\s2010-05-22\s13:51:40:</i><br>\r\nI\scan\sfinally\sdocument\sthe\sfirst\ssteps\sfor\sa\snewbie\s(to\sVersion\sControl\sas\swell\sas\sfossil)!\r\n\r\nOn\sthe\sserver:\r\n\r\nMake\sa\ssimple\stext\sfile\s(Test.txt):\r\n<pre>\r\nLine\s1\r\nLine\s2\r\n</pre>\r\n\r\nCreate\sa\snew\srepository\sand\sput\sthe\stext\sfile\sin\sit,\snoting\sthe\sUser\sand\sPassword\sthat\s'new'\sgives,\sand\sthe\sport\sthat\s'server'\sgives:\r\n<pre>\r\nfossil\snew\sTest.fossil\r\nfossil\sopen\sTest.fossil\r\nfossil\sadd\sTest.txt\r\nfossil\scommit\s-m\s"First\sversion"\r\nfossil\sclose\sTest.fossil\r\nfossil\sserver\sTest.fossil\r\n</pre>\r\n\r\nNow\son\sanother\snetwork-connected\sPC\s(the\sClient)\stype:\r\n<pre>\r\nfossil\sclone\shttp://User:Password@Server:8080/Test.fossil\sTest.fossil\r\n</pre>\r\nwhere\sUser\sand\sPassword\sare\swhat\s<kbd>fossil\snew</kbd>\stold\syou\s(case-sensitive)\sand\sServer\sis\sthe\sURL\sor\sIP\saddress\sof\sthe\sServer\syou\sset\sup.\r\n<ul>\r\n<li>If\sthe\sserver\shas\sanother\sapplication\slistening\sto\sport\s8080,\syou\smay\sget\s<kbd>ERROR.\sserver\ssays:\s\s405\sMethod\snot\sallowed</kbd>\san\sHTTP\serror\s405.</li>\r\n<li>If\syou\sforget\sthe\sUser\sand\sPassword,\sand\sare\susing\sport\s80,\syou\swill\sget\s<kbd>ERROR.\sserver\ssays:\s\s401\sUnauthorized</kbd>\san\sHTTP\serror\s401.</li>\r\n<li>If\syou\sforget\sthe\sUser\sand\sPassword\syou\swill\sget\s<kbd>Error:\snot\sauthorized\sto\sclone</kbd>.</li>\r\n<li>If\syou\sget\sthe\sPassword\swrong\s(it\sis\scase-sensitive)\syou\sget\s<kbd>Error:\slogin\sfailed</kbd>.</li>\r\n</ul>\r\n\r\nTo\saccess\sTest.txt,\sopen\sthe\srepository\sand\scheck\sout\sthe\sfile:\r\n<pre>\r\nfossil\sopen\sTest.fossil\r\n</pre>\r\nThis\ssaves\sthree\sfiles\sto\sthe\scurrent\sdirectory\splus\sthe\sTest.txt\sfile:\r\n<pre>\r\n\s\s\s211\smanifest\r\n\s\s\s\s41\smanifest.uuid\r\n50,176\sTest.fossil\r\n\s\s\s\s18\sTest.txt\r\n\s7,168\s_FOSSIL_\r\n</pre>\r\n\r\nThe\scontents\sof\sthe\schecked\sout\srepository\scan\sbe\slisted\swith\s<kbd>fossil\sls</kbd>\r\n\r\nnow\sfor\sthe\sreverse\sjourney,\sedit\sthe\stext\sfile,\sTest.txt,\sadding\s<kbd>Line\s3</kbd>\sin\sthe\smiddle:\r\n<pre>\r\nLine\s1\r\nLine\s3\r\nLine\s2\r\n</pre>\r\n\r\nAfter\ssaving\sthe\sfile,\suse\s<kbd>fossil\scommit\s-m\s"Added\sLine\s3"</kdb>\sto\supdate\sthe\slocal\srepository,\sand\s<kbd>fossil\spush</kbd>\sto\supdate\sthe\sServer\srepository.\r\n\r\nNow\syou\scan\sgo\sto\sa\sthird\sPC\sand\sgo\sthrough\sthe\ssame\sclient\sprocess\sto\salter\sText.txt\sagain.
K 4404464b0dd64dd389e80c3f474488f5d3239725
U drh
Z 0af4823045e5eb7c66990681a132818c