unison雙向同步工具命令行使用說(shuō)明

unison雙向同步工具命令行使用說(shuō)明Unison 是一個(gè)文件同步工具，采用 rsync 類(lèi)似的算法，但是提高了一步，雙向同步以及一個(gè)統(tǒng)一的版本控制系統(tǒng)。unison命令行可以用如下格式調(diào)用unisonunisonprofile_name[options]讀取 ~/.unison 目錄下的配置文件 "profile_name.prf" 。注意到命令行沒(méi)有指出要進(jìn)行文件同步的兩個(gè)地址，實(shí)際上應(yīng)該在配置文件<profile_name.prf>中有相關(guān)的root指令進(jìn)行了設(shè)置。如：less..Rootsofthesynchronizationroot=/home/bcpierceroot=ssh://saul//home/bcpiercePathstosynchronizepath=currentpath=commonpath=.netscape/bookmarks.htmlunisonprofileroot1root2[options]root1,root2分別是要執(zhí)行同步的兩個(gè)路徑。這時(shí)"profile.prf"配置文件中，應(yīng)該不包含root設(shè)置；root1,root2 路徑的格式可以是本地目錄，也可以是遠(yuǎn)程服務(wù)器的路徑，例如 :ssh://username@remotehost//home/jiangxin/workunisonroot1root2[options]相當(dāng)于 unisondefaultroot1root2 。即讀取 "default.prf" 的配置。常用參數(shù)-testserver測(cè)試連通性，連接到服務(wù)器即退出。示例 :$unison/ssh://opensou1@bluehost/-servercmd=~/bin/unison-testserver如果服務(wù)器端unison可執(zhí)行文件不在默認(rèn)目錄下，甚至沒(méi)有unison命令（需要你編譯一個(gè)上傳到服務(wù)器），則需要使用-servercmd參數(shù)告訴要執(zhí)行的服務(wù)器 unison 命令位置。使用-testserver參數(shù)，則成功鏈接即退出，也不會(huì)去執(zhí)行目錄的比較等后續(xù)操作。-servercmdxxx告訴 unison，服務(wù)器端的 unison 命令是什么。參見(jiàn)上面的示例。-auto接受缺省的動(dòng)作，然后等待用戶(hù)確認(rèn)是否執(zhí)行。-batchbatchmode, 全自動(dòng)模式，接受缺省動(dòng)作，并執(zhí)行。-ignorexxx增加 xxx 到忽略列表中-ignorecase[true|false|default]是否忽略文件名大小寫(xiě)-followxxx是否支持對(duì)符號(hào)連接指向內(nèi)容的同步；例如在我的 ~/.unison 的配置文件 default.prf 中有Unisonpreferencesfilefollow=Path{unison_*}ignore=Path{WWWROOT/wiki_mirror}ignore=Name{,.}*{.~$lock}ignore=Name{a.out}我將預(yù)進(jìn)行同步的系統(tǒng)文件在 xxx/src 下分別作符號(hào)鏈接，如unison_httpd.conf指向c:/programfiles/apache/.../httpd.conf 。同步時(shí)，"follow=Path{unison_*}" 配置（或參數(shù)）將跟蹤符號(hào)鏈接指向的實(shí)際文件。 如果沒(méi)有該設(shè)置，符號(hào)鏈接不予同步。-immutablexxx不變目錄，掃描時(shí)即忽略-silent安靜模式-times同步修改時(shí)間-pathxxx 參數(shù)只同步 -path 參數(shù)指定的子目錄以及文件，而非整個(gè)目錄。例如unison/home/usernamessh://remotehost//home/username\-pathshared\-pathpub\-scape/bookmarks.html模式匹配如下參數(shù) ignore/ignorenot,follow,sortfirst/sortlast,backup,merge 定義各自的匹配模式。例如 :ignore=patternpattern 的語(yǔ)法格式Regexregexp即常規(guī)表達(dá)式。unison雙向同步工具命令行使用說(shuō)明PostedatJanuary26th,200710:33Filedunder 資訊火藥庫(kù)/LINUX/UNIXUnison 是一個(gè)文件同步工具，采用 rsync 類(lèi)似的算法，但是提高了一步，雙向同步以及一個(gè)統(tǒng)一的版本控制系統(tǒng)。 1.unison 命令行可以用如下格式調(diào)用 unisonunisonprofile_name[options]讀取 ~/.unison 目錄下的配置文件 "profile_name.prf" 。注意到命令行沒(méi)有指出要進(jìn)行文件同步的兩個(gè)地址，實(shí)際上應(yīng)該在配置文件 <profile_name.prf> 中有相關(guān)的 root指令進(jìn)行了設(shè)置。如： less..#Rootsofthesynchronizationroot=/home/bcpierceroot=ssh://saul//home/bcpierce #Pathstosynchronizepath=currentpath=commonpath=.netscape/bookmarks.htmlunisonprofileroot1root2[options]root1,root2分別是要執(zhí)行同步的兩個(gè)路徑。這時(shí)"profile.prf"配置文件中，應(yīng)該不包含root設(shè)置；root1,root2 路徑的格式可以是本地目錄，也可以是遠(yuǎn)程服務(wù)器的路徑，例如:ssh://username@remotehost//home/jiangxin/workunisonroot1root2[options]

相當(dāng)于

unisondefaultroot1root2

。即讀取

"default.prf"

的配置。

2.

常用參數(shù)-testserver 測(cè)試連通性，連接到服務(wù)器即退出。示例:$unison/ssh://opensou1@bluehost/ -servercmd=~/bin/unison-testserver 如果服務(wù)器端 unison 可執(zhí)行文件不在默認(rèn)目錄下，甚至沒(méi)有unison命令（需要你編譯一個(gè)上傳到服務(wù)器），則需要使用-servercmd參數(shù)告訴要執(zhí)行的服務(wù)器 unison 命令位置。使用-testserver 參數(shù)，則成功鏈接即退出， 也不會(huì)去執(zhí)行目錄的比較等后續(xù)操作。 -servercmdxxx 告訴 unison，服務(wù)器端的

unison

命令是什么。參見(jiàn)上面的示例。

-auto

接受缺省的動(dòng)作，然后等待用戶(hù)確認(rèn)是否執(zhí)行。 -batchbatchmode, 全自動(dòng)模式，接受缺省動(dòng)作，并執(zhí)行。-ignorexxx 增加 xxx 到忽略列表中-ignorecase[true|false|default] 是否忽略文件名大小寫(xiě)-followxxx是否支持對(duì)符號(hào)連接指向內(nèi)容的同步；例如在我的~/.unison的配置文件default.prf中有#Unisonpreferencesfilefollow=Path{unison_*}ignore=Path{WWWROOT/wiki_mirror}ignore=Name{,.}*{.~$lock}ignore=Name{a.out}我將預(yù)進(jìn)行同步的系統(tǒng)文件在xxx/src下分別作符號(hào)鏈接，如unison_httpd.conf指向c:/programfiles/apache/.../httpd.conf。同步時(shí)，"follow=Path{unison_*}"配置（或參數(shù)）將跟蹤符號(hào)鏈接指向的實(shí)際文件。 如果沒(méi)有該設(shè)置，符號(hào)鏈接不予同步。 -immutable不變目錄，掃描時(shí)即忽略-silent安靜模式-times同步修改時(shí)間-pathxxx參數(shù)只同步-path參數(shù)指定的子目錄以及文件，而非整個(gè)目錄。例如 unison/home/usernamessh://remotehost//home/username\-pathshared\-pathpub\-scape/bookmarks.html3. 模式匹配如下參數(shù) ignore/ignorenot,follow,sortfirst/sortlast,backup,merge定義各自的匹配模式。例如:ignore=patternpattern的語(yǔ)法格式Regexregexp即常規(guī)表達(dá)式。Namename路徑的最后一部分與“name"匹配?？梢允褂猛ㄅ浞?jiàn)下面描述。Pathpath

全路徑與

"path"

匹配?？梢允褂猛ㄅ浞?，見(jiàn)下面描述。以下通配符可以用在

Path

和

Name

中:匹配除了"/"之外，任意單個(gè)字符；*匹配除了"/"之外的任意字符；如果用在"Name"中，則不和以"."開(kāi)始的文件匹配，而用在"Path"中，可以和"."開(kāi)始的向匹配。[xyz]匹配{x,y,z}中任一字符；{a,bb,ccc}匹配a,bb,ccc中任何一個(gè)；示例：忽略CVS目錄以及以.cmo結(jié)尾的文件：ignore=Name{CVS,*.cmo}忽略路徑a/b:ignore=Patha/b忽略路徑*/tmp。當(dāng) *用在 Path 中，可以和以 "."開(kāi)始的文件、目錄名匹配，如下面的和 ".foo/tmp" 匹配；ignore=Path*/tmp忽略 a/b/開(kāi)始，結(jié)尾是 .ml 的文件。ignore=Regexa/b/.*\.ml4. 應(yīng)用舉例本地目錄間的鏡像 unison<目錄1><目錄2>獲取遠(yuǎn)程 unison 版本sshremotehostnameunison-version 測(cè)試unison-testServer 本地目錄ssh://user@remotehostname/ 遠(yuǎn)程目錄執(zhí)行數(shù)據(jù)同步unison <本地目錄>ssh://remotehostname/< 遠(yuǎn)程目錄>遠(yuǎn)程目錄是絕對(duì)目錄， 不是用戶(hù)主目錄注意 在主機(jī)和目錄間又多加了一個(gè) "/"：unison <本地目錄>ssh://remotehostname//< 絕對(duì)路徑>參數(shù) -path 指定同步的子目錄。以下只同步 /home/username 下的 shared目錄。unison/home/usernamessh://remotehost//home/username-pathshared-path 可以多次出現(xiàn)unison/home/usernamessh://remotehost//home/username\-pathshared\-pathpub\-scape/bookmarks.html5.unison 配置文件5.1..unison 目錄~/.unison目錄保存用戶(hù)配置文件以及Archive文件。配置文件擴(kuò)展名為.prf，缺省的配置文件為:"default.prf"。Archive文件可能有多個(gè)，每對(duì)同步的對(duì)象對(duì)應(yīng)一個(gè)文件。這個(gè)文件記錄了文件的狀態(tài)，可以在后續(xù)的更新動(dòng)作中更快速的判斷文件的更新動(dòng)作。Archive文件名和雙方的主機(jī)名、路徑名等相關(guān)。Archive雖然自動(dòng)由unison維護(hù)，但是特殊情況下（如本機(jī)的地址經(jīng)常變更），可以利用下面的方法：環(huán)境變量"UNISONLOCALHOSTNAME"可以用于本機(jī)地址經(jīng)常變化的環(huán)境，unison會(huì)采用該環(huán)境變量的值；可以在缺省的配置文件中，用rootalias命令將新的主機(jī)、路徑名稱(chēng)對(duì)應(yīng)為老的主機(jī)名和路徑名，然后再確定出archive名稱(chēng)。這樣就不會(huì)造成由于主機(jī)名修改，導(dǎo)致 unison 更新?tīng)顟B(tài)的丟失， 進(jìn)而導(dǎo)致上次更新?tīng)顟B(tài)的丟失。 rootalias=//new-hostname//new-path->//old-hostname//old-path5.2.*.prf 配置文件如果 unison 只帶一個(gè)參數(shù)執(zhí)行，如 unison<name>則在 ~/.unison 目錄下查找 "<name>.prf" 配置文件。如果不帶參數(shù)執(zhí)行 unison，則查找 "default.prf" 文件。5.3. .prf 文件示例簡(jiǎn)單的 default.prf 示例#Rootsofthesynchronizationroot=/home/bcpierceroot=ssh://saul//home/bcpierce #Pathstosynchronizepath=currentpath=commonpath=.netscape/bookmarks.html更復(fù)雜的配置文件:#Rootsofthesynchronizationroot=/home/bcpierceroot=ssh://saul//home/bcpierce#Pathstosynchronizepath=currentpath=commonpath=.netscape/bookmarks.html#Someregexpsspecifyingnamesandpathstoignoreignore=Nametemp.*ignore=Name*~ignore=Name.*~ignore=Path*/pilot/backup/Archive_*ignore=Name*.oignore=Name*.tmp#Windowheightheight=37#Keepabackupcopyoftheentirereplicabackup=Name*#Usethiscommandfordisplayingdiffsdiff=diff-y-W79--suppress-common-lines#Logactionstotheterminallog=true使用include包含文件"unisonworkingset"參照"workingset.prf"執(zhí)行：path=current/paperspath=Mail/inboxpath=Mail/draftsincludecommon"common"文件內(nèi)容:在common包含文件中，沒(méi)有出現(xiàn)PATH，畢竟要在包含文件中包含各個(gè)配置文件的交集么。#Rootsofthesynchronizationroot=/home/bcpierceroot=ssh://saul//home/bcpierce#(...otherpreferences...)IfanynewpreferencesareaddedbyUnison(e.g.’ignore’#preferencesaddedviathegraphicalUI),thenstoretheminthe#file ’common’rathenthaninthetop-levelpreferencefileaddprefsto=common#regexpsspecifyingnamesandpathstoignoreignore=Nametemp.*ignore=Name*~ignore=Name.*~ignore=Path*/pilot/backup/Archive_*ignore=Name*.oignore=Name*.tmp6.FAQ 超時(shí)問(wèn)題和遠(yuǎn)程服務(wù)器同步大量數(shù)據(jù)， 上傳一部分?jǐn)?shù)據(jù)后，超時(shí)： 9%559:15ETAReadfromremotehostbluehost:ConnectionresetbypeerFatalerror:LostconnectionwiththeserverGoogle似問(wèn)題：該文章提出增大 ssh 超時(shí)時(shí)間設(shè)置：

搜索類(lèi)ThedirectoryIamsyncingisprettylarge...about3000subdirsandeachofthosesubdirshasacoupledozendirsunderthem.About80GBsofdatatotal.Iamusingthefollowingcommand:unison-batch/dir/pathssh://remoteserver//dir/pathIoriginallyusedrsynctomovethedirectoryovertotheremoteserverhoweverInowhaveaneedforbidirectionalmirroringhencethereasonwhyInowuseunison.WhenIrunthiscommand,Igettheusualwarningaboutnopriorindexfoundsincethisisthefirstrun.Unisonthenbeginstolistallthedirsandsubdirs(buildingtheindexdbaseIsuppose).Whenit'salmostfinished,Igetthefollowinglines:WaitingforchangesfromserverFatalError:LostconnectionwithserverIhaveusedunisonbeforetomirrordirectoriesbetweenthesetwomachines,butnoneofwhichwerethisbigwithsomanysubdirbranches.Nothinginanylogstogivemeanyclues.Ithoughitmightbesomesortofsshtimeout,soIadded"ConnectTimeout10"in/etc/ssh/ssh_configtogiveita10secondtimeout,butIdontthinkthiswillhelpsincethesshsessiondoesindeedconnectinitially.ulimit-sshowsIhavean8MBstacksize.Cananyoneshedanylightontothisproblem?Thankyou另外一個(gè)用戶(hù)提出將一個(gè)任務(wù)分解成多個(gè)任務(wù)的方法：longtimewhencheckingforupdates.So,ifthereisamasqueradingrouter(orafirewallusingstatefulinspection)betweentheclientandtheserver,itmaywronglyconsiderthattheconnectionisdeadaftersometime.Theusualworkaroundistousethepathdirectivetosynchronizesmallerpartsofthereplicaatatime.Thisshouldnecessaryonlyforthefirstsynchronization,asthesubsequentonesaremuchfaster.YoucouldalsotrytousetheServerAliveIntervaldirectiveofsshinordertokeeptheconnectionactive. 實(shí)際操作中，第一次，我先把要上傳的文件打成包，用ftp上傳，然后展開(kāi)到服務(wù)器中，之后執(zhí)行一次unison同步即可。Namename路徑的最后一部分與“name"匹配。可以使用通配符，見(jiàn)下面描述。Pathpath全路徑與 "path" 匹配?？梢允褂猛ㄅ浞?，見(jiàn)下面描述。以下通配符可以用在 Path 和Name 中:匹配除了 "/"之外，任意單個(gè)字符；*匹配除了"/"之外的任意字符；如果用在"Name"中，則不和以"."開(kāi)始的文件匹配，而用在"Path"中，可以和"."開(kāi)始的向匹配。[xyz]匹配 {x,y,z} 中任一字符；{a,bb,ccc}匹配 a,bb,ccc 中任何一個(gè)；示例：忽略 CVS 目錄以及以 .cmo 結(jié)尾的文件：ignore=Name{CVS,*.cmo}忽略路徑 a/b:ignore=Patha/b忽略路徑 */tmp。當(dāng)*用在 Path 中，可以和以 "."開(kāi)始的文件、目錄名匹配，如下面的和 ".foo/tmp" 匹配；ignore=Path*/tmp忽略 a/b/開(kāi)始，結(jié)尾是 .ml 的文件。ignore=Regexa/b/.*\.ml應(yīng)用舉例本地目錄間的鏡像unison<目錄1><目錄2>獲取遠(yuǎn)程 unison 版本sshremotehostnameunison-version測(cè)試unison-testServer 本地目錄ssh://user@remotehostname/ 遠(yuǎn)程目錄執(zhí)行數(shù)據(jù)同步unison <本地目錄>ssh://remotehostname/< 遠(yuǎn)程目錄>遠(yuǎn)程目錄是絕對(duì)目錄，不是用戶(hù)主目錄注意 在主機(jī)和目錄間又多加了一個(gè) "/"：unison <本地目錄>ssh://remotehostname//< 絕對(duì)路徑>參數(shù) -path 指定同步的子目錄。以下只同步/home/username 下的 shared 目錄。unison/home/usernamessh://remotehost//home/username-pathshared-path 可以多次出現(xiàn)unison/home/usernamessh://remotehost//home/username\-pathshared\-pathpub\-scape/bookmarks.html5.unison 配置文件5.1..unison 目錄~/.unison 目錄保存用戶(hù)配置文件以及 Archive 文件。配置文件擴(kuò)展名為 .prf，缺省的配置文件為 :"default.prf"。Archive 文件可能有多個(gè)，每對(duì)同步的對(duì)象對(duì)應(yīng)一個(gè)文件。這個(gè)文件記錄了文件的狀態(tài)，可以在后續(xù)的更新動(dòng)作中更快速的判斷文件的更新動(dòng)作。Archive 文件名和雙方的主機(jī)名、路徑名等相關(guān)。Archive 雖然自動(dòng)由 unison 維護(hù)，但是特殊情況下（如本機(jī)的地址經(jīng)常變更），可以利用下面的方法：環(huán)境變量 "UNISONLOCALHOSTNAME" 可以用于本機(jī)地址經(jīng)常變化的環(huán)境， unison 會(huì)采用該環(huán)境變量的值；可以在缺省的配置文件中，用 rootalias 命令將新的主機(jī)、路徑名稱(chēng)對(duì)應(yīng)為老的主機(jī)名和路徑名， 然后再確定出archive 名稱(chēng)。這樣就不會(huì)造成由于主機(jī)名修改，導(dǎo)致 unison 更新?tīng)顟B(tài)的丟失， 進(jìn)而導(dǎo)致上次更新?tīng)顟B(tài)的丟失。rootalias=//new-hostname//new-path->//old-hostname//old-path5.2.*.prf 配置文件如果 unison 只帶一個(gè)參數(shù)執(zhí)行，如unison<name>則在 ~/.unison 目錄下查找 "<name>.prf" 配置文件。如果不帶參數(shù)執(zhí)行 unison，則查找 "default.prf" 文件。5.3. .prf 文件示例簡(jiǎn)單的 default.prf 示例Rootsofthesynchronizationroot=/home/bcpierceroot=ssh://saul//home/bcpiercePathstosynchronizepath=currentpath=commonpath=.netscape/bookmarks.html更復(fù)雜的配置文件 :Rootsofthesynchronizationroot=/home/bcpierceroot=ssh://saul//home/bcpiercePathstosynchronizepath=currentpath=commonpath=.netscape/bookmarks.htmlSomeregexpsspecifyingnamesandpathstoignoreignore=Nametemp.*ignore=Name*~ignore=Name.*~ignore=Path*/pilot/backup/Archive_*ignore=Name*.oignore=Name*.tmpWindowheightheight=37Keepabackupcopyoftheentirereplicabackup=Name*Usethiscommandfordisplayingdiffsdiff=diff-y-W79--suppress-common-linesLogactionstotheterminallog=true使用 include 包含文件"unisonworkingset" 參照 "workingset.prf" 執(zhí)行：path=current/paperspath=Mail/inboxpath=Mail/draftsincludecommon"common" 文件內(nèi)容:在common 包含文件中，沒(méi)有出現(xiàn) PATH，畢竟要在包含文件中包含各個(gè)配置文件的交集么。Rootsofthesynchronizationroot=/home/bcpierceroot=ssh://saul//home/bcpierce(...otherpreferences...)IfanynewpreferencesareaddedbyUnison(e.g.’ignore’preferencesaddedviathegraphicalUI),thenstoretheminthefile’common’rathenthaninthetop-levelpreferencefileaddprefsto=commonregexpsspecifyingnamesandpathstoignoreignore=Nametemp.*ignore=Name*~ignore=Name.*~ignore=Path*/pilot/backup/Archive_*ignore=Name*.oignore=Name*.tmp6.FAQ 超時(shí)問(wèn)題和遠(yuǎn)程服務(wù)器同步大量數(shù)據(jù)，上傳一部分?jǐn)?shù)據(jù)后，超時(shí)：9% 559:15ETAReadfromremotehostbluehost:ConnectionresetbypeerFatalerror:LostconnectionwiththeserverGoogle 搜索類(lèi)似問(wèn)題：該文章提出增大 ssh超時(shí)時(shí)間設(shè)置：3hellousers,Iamtryingtorununisontosyncup2differentservers.ThedirectoryIamsyncingisprettylarge...about3000subdirsandeachofthosesubdirshasacoupledozendirsunderthem.About80GBsofdatatotal.Iamusingthefollowingcommand:unison-batch/dir/pathssh://remoteserver//dir/pathIoriginallyusedrsynctomovethedirectoryovertotheremoteserverhoweverInowhaveaneedforbidirectionalmirroringhencethereasonwhyInowuseunison.WhenIrunthiscommand,Igettheusualwarningaboutnopriorindexfoundsince