PHP線上轉檔服務搭配pdf2htmlEX / PHP File Converter with pdf2htmlEX

我開發了一個可以用PHP線上轉檔服務 (PHP File Converter)。此服務可以讓使用者上傳檔案，然後等待系統進行轉檔，最後輸出轉檔完的結果。這個程式是為了搭配pdf2htmlEX一起運作，以省略需要用指令來進行轉檔的過程。以下介紹這個服務的由來與下載說明。

I developed an online PHP File Converter to let user online convert their files to another format. PHP File Converter use system command line to  use convert tool, for example, pdf2htmlEX. Following is introduction of PHP File Converter.

簡介 / Introduction

一開始是因為我們需要一個PDF轉成HTML的方案。這些方案中王璐的pdf2htmlEX專案轉換成效非常好。pdf2htmlEX可以把一份PDF檔案轉成一個HTML檔案，而這個HTML檔案可以直接開啟，裡面已經包含了原本PDF的排版與圖片。上圖是轉換後的成果，非常好用。

但是pdf2htmlEX的操作是要用Linux的指令列進行，這對於許多不熟悉Linux的人來說有點麻煩。這讓我想要發展一個線上轉檔網址，可以讓使用者上傳檔案，然後利用作業系統的命令列進行轉檔，轉檔完成之後再提供使用者下載的服務。最後就完成這個PHP File Converter。

特色 / Features

PHP File Converter特色在於讓使用者直接在瀏覽器中上傳檔案到伺服器，然後PHP File Converter會自動執行系統轉檔指令。轉檔完成之後，使用者則會被引導到下載網址，然後就可以下載已經轉檔完成的檔案。

具體來說，特色如下：

• 以伺服器作業系統的命令列進行轉檔。只要伺服器可以使用命令列CLI (command line interface)進行轉檔，就可以用PHP File Converter來轉檔
• 伺服器端可設定上傳檔案允許大小、格式，避免惡意檔案上傳
• 伺服器端可設定轉檔輸入的參數
• 伺服器端可設定保留轉檔數量，避免使用者上傳過多檔案而導致伺服器空間不足
• 檔案的上傳、轉換與下載會在系統留下記錄，包括檔案名稱、使用者IP與時間
• 系統是基於CodeIgniter 2.1.4，採MVC架構開發
• 以SQLite作為資料庫，不需要額外搭配其他資料庫設定

目前PHP File Converter跟pdf2htmlEX轉檔工具綁定在一起，特別設置了pdf2htmlEX會使用的Zoom等參數。

至於pdf2htmlEX則是王璐開發的專案，詳細請看他的pdf2htmlEX專案。

系統需求與設定 / System Requirement & Configuration

PHP File Converter的專案網站與下載位址如下：

• PHP File Converter 專案網站：https://github.com/pulipulichen/php-file-converter
• PHP File Converter ZIP壓縮檔案下載：https://github.com/pulipulichen/php-file-converter/archive/master.zip

PHP File Converter是以PHP架設，需要搭配SQLite資料庫才能運作。建議運作環境是：

• PHP 5.5.3
• SQLite 3
• 硬碟空間：建議100MB以上
• 測試環境XAMPP 1.8.1

轉檔程式主要的設定檔位於 [php-file-converter]/application/config/converter.php 。參考檔案內的說明來進行設定。

由於轉檔需要耗費大量伺服器資源，故在此不提供展示用的界面。

結語：未來發展方向 / Conclusion: Future Works

雖然目前PHP File Converter設定是搭配pdf2htmlEX，但其實它有很多可能。

發展PHP File Converter的原因有很多，另一個原因是因為很多服務都需要搭配轉檔工具才能使用，例如DSpace多媒體轉檔器 (Media Filter)就需要轉圖片、轉文件檔案(txt或doc)、轉聲音、轉影片，很多很多。雖然大部分轉檔工具都可以在Linux中安裝，但是每一臺都安裝自己的轉檔工具，顯然是無法善用資源的一件事情。

於是我的構想是：一臺伺服器專門負責一種檔案的轉檔，其他伺服器則是把檔案交給它轉檔。為了做到這件事情，PHP File Converter甚至有規劃API使用。

不過可惜的是，目前為止還沒有朝向這個方向進行的實際規劃。目前大家主要是手動上傳、手動下載，再把轉檔好的檔案擺到提供使用者取用的位置，伺服器之間沒有這麼自動。

最後，請讓我用這一篇文章來感謝pdf2htmlEX的作者王璐。我在安裝跟使用pdf2htmlEX時遭遇了很多問題，感謝他在信中熱情地為我解惑，而且還快速地修改了一些錯誤，真是令人尊敬的開發者。謝謝您。

(more...)

RSS全文抽取服務 / Full-Text RSS Service

Full-Text RSS是我根據FiveFilters.org提供的full-text-rss改良的開放原始碼RSS全文抽取服務。Full-Text RSS可以分析RSS中每個頁面的網址，抽取該網址中的網頁文章內容，並加上換頁偵測、中文字編碼調整，讓RSS閱讀器可以直接閱讀到全文的RSS。

Based on FiveFilters.org’s full-text-rss code, I developed Full-Text RSS service to extract full text in RSS feed especially for Chinese article. Following are Full-Text RSS’s introduction, features and usage.

由來 / Introduction

由於我個人是重度的RSS讀者，然而大部分的RSS訂閱來源都只有提供文章一小部分的內容，例如Linux伊甸園開源社區 (RSS網址為：http://www.linuxeden.com/rss.php) ，這意思是說我要看文章的內容，還得從RSS瀏覽器中打開瀏覽器、上網、然後用他們網站中不適合手機小尺寸螢幕的排版來閱讀。雖然之前我也找許多RSS全文服務，包括まるごとRSS、FeedEx.net、FiveFilters.org，但是因為效率跟中文編碼的問題，總讓我使用起來十分受限。

這讓我興起了想要自己來架設RSS全文抽取服務的念頭。一開始我是在GitHub上搜尋，找到很多以full-text-rss為名字的專案。然後循著README.md，才找到於FiveFilters.org的開放原始碼軟體full-text-rss。

於是我就很開心地下載下來，改放到GitHub託管，然後隨著自己的習慣不斷地改造這個Full-Text RSS全文抽取服務。

特色與改造 / Features

RSS全文抽取服務最主要的目的在於抽取RSS的文章內容。以Linux伊甸園開源社區為例，原本的RSS網址 www.linuxeden.com/rss.php 只能顯示部分內容，如下圖：

但是經過RSS全文抽取之後，可以把原本的網址取代成RSS全文抽取服務的網址： http://example-full-text-rss.org/full-text-rss/makefulltextfeed.php?url=www.linuxeden.com%2Frss.php&max=10&links=preserve&exc=&submit=Create+Feed  (只是範例網址，實際上不能連線喔)，顯示內容如下：

你可以看到「物联网福音 不耗电Wi-Fi技术问世」一文已經從原本的部分文字抽取成文章全文了。

而我從FiveFilters.org下載full-text-rss之後，還進行了以下特色的改造：

• 為中文編碼進行調整，儘可能避免亂碼。但是當伺服器記憶體不足時還是會變成亂碼。
• 如果網頁內有換頁，則會自動下載下一頁的內容，合併成一篇文章。軟體玩家的文章就常常有換頁，例如日本旅遊必備上網好夥伴—Wi-Up日本4G吃到飽分享器（2014日本東京10日）實測。
• 針對自己常看的網站設計全文抽取專用的版型，以免抽取內容錯誤。像是engadget中文版、Mr.6等等。

用到現在也將近快1年了，陸陸續續修改了很多次，到現在總算是覺得比較穩定一點，所以就來寫這篇Blog介紹。

系統需求 / Server Requirement

Full-Text RSS是以PHP運作。安裝時條件如下：

• PHP版本：5以上
• 不需要搭配資料庫

但是由於Full-Text RSS在抓取網站的全文時需要大量記憶體與等待相當長的時間，如果超過PHP可以執行的時間，就會顯示錯誤訊息：

[unable to retrieve full-text content]

因此我們必須調整PHP的設定檔php.ini的部分參數，讓Full-Text RSS能有比較寬裕的執行環境：

• max_execution_time=300
• max_input_time=600
• memory_limit=128M
• 必須啟用cURL，才能抓取資料

如果還有其他參數需要調整，請在下面留言跟我說。

由於Full-Text RSS會消耗大量伺服器的資源，我本來想試著架設在免費的PaaS上來運作，可惜免費空間都跑不動。因此我推薦是安裝在自己的電腦上，當然，你的電腦也得是可以公開連線的伺服器才行。

安裝 / Installation

請從以下網址下載Full-Text RSS：

• Full-Text RSS專案網址：https://github.com/pulipulichen/full-text-rss
• Full-Text RSS ZIP壓縮檔案下載：https://github.com/pulipulichen/full-text-rss/archive/master.zip

下載後，請解壓縮到你的PHP運作環境目錄。以XAMPP伺服器來說，執行目錄就是在htdocs資料夾底下。例如c:\xampp\htdocs\full-text-rss\

然後運作網頁伺服器，直接開啟Full-Text RSS網址，例如http://your-ip/full-text-rss/，這樣就可以連線了。

使用方法 / Usage

Step 1. 輸入RSS訂閱資訊網址 /  Enter RSS Feed URL

首先在Enter URL輸入RSS訂閱資訊的網址，例如：http://www.linuxeden.com/rss.php。然後按下「Create Feed」按鈕。

接著等待一段時間，讓Full-Text RSS去讀取。如果讀取到最後發生錯誤，建議修改輸入頁面的「Max items / 最多抽取文件篇數」，降低為5篇以下，可以降低Full-Text RSS的讀取負擔。

Step 2. 取得全文抽取網址 / Get Full-Text RSS Feed

順利開啟之後，到網址列複製Full-Text RSS提供的網址。舉例來說：

• 原本網址：http://www.linuxeden.com/rss.php
• Full-Text RSS轉換網址：http://example-full-text-rss.org/full-text-rss/makefulltextfeed.php?url=www.linuxeden.com%2Frss.php&max=10&links=preserve&exc=&submit=Create+Feed 

剛剛的參數都寫在網址上，應該很容易看懂吧。

Step 3. 加入您的RSS閱讀器 / Add Feed To Your RSS Reader

然後把剛剛拿到的Full-Text RSS網址加入到你的RSS閱讀器，像是Feedly (可惜沒有Google Reader了)，這樣就可以了。

結語：不太對的回饋 / Conclusion: Missing Feedback

Full-Text RSS網站服務又是一個受惠於開放原始碼的例子。我從FiveFilters.org取得了full-text-rss，然後改造之後再到GitHub去發佈，現在寫一篇Blog介紹這怎麼使用。取之開放原始碼，回饋於開放原始碼，嗯？好像哪裡怪怪的？

是的，其實Git版本控制在團隊合作之間一般是使用Fork建立自己的分支專案，然後用Pull Requests來請求原作者看一下我改過的程式碼，以回饋給原作者。這部分doggy有比較詳細的介紹：了解 GitHub 的 fork 與 pull request 版控流程。

可惜當初我還不知道Fork這個很重要的功能，所以到現在也就獨立發展了。以後會乖乖Fork專案，好好回饋給作者的啦。

(more...)

IMLF 2014參加心得 / Thoughts of IMLF 2014

今年六月初我去參加了印尼峇里島的國際行動學習研討會(International Mobile Learning Festival 2014, IMLF 2014)，並發表了一篇「Effects of Different Text Display Types on Reading Comprehension」。以下記錄發表的投影片。

This June, I went to Bali and published a research paper in International Mobile Learning Festival 2014 (IMLF 2014) conference. The research titled "Effects of Different Text Display Types on Reading Comprehension". Following are the abstract and slide of this research.

發表文章 / Publication

這次發表的題目是「Effects of Different Text Display Types on Reading Comprehension, Sustained Attention and Cognitive Load in Mobile Reading Contexts」(行動閱讀情境中不同文字顯示方式對於閱讀理解成效、持續注意力與認知負荷的影響)。APA書目如下：

Chen, Y.-T., & Chen, C.-M. (2014). Effects of Different Text Display Types on Reading Comprehension, Sustained Attention and Cognitive Load in Mobile Reading Contexts. In Proceedings of the International Mobile Learning Festival 2014. Bali, Indonesia.

這個很長的標題題名已經點出了這篇研究的內容。也就是以iPod Touch中設計三種不同的文字顯示方式：靜態翻頁、動態自動卷軸與逐字顯示的混合模式，以筆試測試閱讀理解成效、以腦波儀NeruoSky偵測持續注意力、以量表詢問認知負荷，然後請受試者在坐著、站著與行走等不同情境下閱讀。最後發現不同形態顯示方式與不同的情境皆會對這三種依變項造成影響，可供我們在設計行動閱讀載具的參考。

以下是這次報告的投影片：

• 投影片下載：Google Drive、One Drive、Box.net

感謝老師的允許與學妹的研究，才能讓我有這機會去發表。再此特別表示感謝。

演講稿 / Speech Visual Aids

這是我第一次出國用英文發表，而我平常在臺上演講的經驗也不多，這次出國發表對我來說是一大挑戰。另一方面，議程演講的時間有30分鐘，扣掉發問時間也大概需要講25分鐘。這25分鐘內要用英文全程演講，到底該怎麼辦好呢？

雖然老師跟週遭的朋友們都一副「你上臺就知道要講什麼了」的表情，但我的英文並沒有到這種程度。要用英文寫一份HTML文件的話，我的確可以馬上開始。但是要上臺用英文講話，我可能還要先記下我要講什麼東西。

所以這次是應用了之前Dr. Jeremy Sykes教的「English Academic Writing and Oral Presentation Skill 2」中的技巧，乖乖地擬訂演講內容。在這裡面儘量地使用平常易懂、常用的句子；捨棄學術論文中艱深難唸的專有名詞，換成比較易懂、也好唸的片語；演講速度一字一句唸清楚，不是急著講完，反正25分鐘也足夠演講。然後再依據這份講稿來練習、背誦。這份講稿的擬訂也是受到許多人的幫忙，一邊擬稿的過程中也學到很多英文的技巧，感謝大家。不過由於個人事務繁忙，投影片跟講稿修訂上我也花了太多時間，甚至到報告前一天我才能有時間在房間裡好好地練講。最後影響到老師跟一起去報告的學弟的行程，真的是很不好意思。

演講感想 / Academic Speech

IMLF 2014雖然是一個國際會議，可是參與者並不多。在會場裡面大概不到20人，工作人員約5人左右。不過儘管人很少，發問倒是非常踴躍。一個講者10分鐘的發問時間裡面，大家會積極地對他的研究內容以及應用的可能性進行討論。學弟在第一天發表時，臺下聽眾也熱烈發問，甚至連這天的場次結束了，還有三四個人圍了上來提問。其實比起經過練習的演講內容，如何應對別人用英文提問的回答，才是國際研討會壓力最大的地方。當學弟在臺上收到大量英文提問的攻擊時，他顯得有點驚慌失措，我坐得太遠了難以上去打pass，還好中國大陸來的主講人趕緊用中文幫學弟翻譯一下，總算讓學弟能夠渡過這個難關。

不過輪到我的時候，不知道是因為講得不是很好，還是研究內容跟其他遊戲式教學比起來不太有趣，臺下的聽眾興趣缺缺，也只有收到一個問題。不過那個問題是問「這個研究對現在的學習有什麼幫助？」這種大問題，我除了再次強調了論文中結論的部分之外，倒也不知道怎麼用英文再跟她進一步解釋。

總之，吸取這次的經驗，下次還要更加努力，希望能有更好的表現，多多加油吧！

(more...)

Android系列裝置禁止快取縮圖thumbnails / Deny Thumbnails In Android Devices

Android裝置會自動產生大量快取縮圖(thumbnails)，佔據Android裝置所剩不多的記憶體空間(ROM space)。本文教你如何防止Android裝置產生縮圖。

Android system automatically create thumbnails to SD card’s “DCIM/.thumbnails”. The “.thumbnails” directory will occupy most of SD card’s space. This article show you how to stop Android system to create thumbnails.

空間不足的問題 / Not Enough Space Problem

我的平板電腦是Samsung Galaxy Note 8，內建空間16GB，而實際上可用空間大概是9.78GB。上面的截圖中，我目前的空間剩餘大概3.23GB。

9.78GB乍看之下似乎很多，但在以前，這個空間往往很快就會被不知名的檔案佔據，系統會一直提示我儲存空間不足、請刪除軟體APP、圖片、影片與文件 (Not enough space. Delete unnecessary items, such as downloaded software, pictures, videos, and documents)。

上面這張圖片是來自於How to Tackle Message “Not Enough Space, Delete Unnecessary Items…” When Opening Gallery on Android，他也是跟我一樣使用Galaxy系列的手機，也是遇到了一樣的問題。

龐大的快取圖片資料夾 / Fat “.thumbnails” Folder

後來我使用Storage Analyser分析記憶卡中佔用記憶體空間的檔案，才發現佔用空間的並不是各種APP或是下載的檔案，而是記憶體中的「/DCIM/.thumbnails」這個資料夾佔據了大量的空間。

這個.thumbnails資料夾存放的是圖片的快取縮圖。只要開啟了圖片，這個快取縮圖資料夾就會增加該張圖片的縮圖。附帶一提，這個資料夾「.thumbnails」開頭是一個「.」，這是Linux檔案系統中表示隱藏檔案的功能，一般是存放系統檔案時使用。

別看這個縮圖好像沒什麼了不起，就算我空間有9.78GB，這個.thumbnails資料夾甚至可以佔到3GB之多，早已超過我現在的剩餘空間了。

我的Sony Xperia TX也會有一樣的問題。這個.thumbnails就佔據了3.09GB，對手機記憶體空間帶來不小的負擔。

無法清理乾淨的快取圖片資料夾 / Cannot Remove .thumbnails Folder

TrickyWays的建議是刪除「.thumbnails」這個資料夾。但是事實上，這個做法並非長久之計。

因為.thumbnails快取圖片資料夾會持續產生。只要開啟圖片，.thumbnails資料夾就會產生縮圖，而這個縮圖又會佔據記憶體空間。過不久，我又得再次手動刪除.thumbnails資料夾。

因此我後來又去找了其他解法，發現xda developers中Minions_Army提出的方法的確可以永久解決這個問題。

放置快取縮圖產生 / Deny Thumbnails

原理是把.thumbnails資料夾刪除，然後建立一個.thumbnails檔案。這樣子快取縮圖就無法順利產生。

以下例子我用ES文檔瀏覽器(ES File Explorer)來操作，做法如下：

Step 1. 顯示隱藏的資料夾 / Display Hidden Directory

由於.thumbnails是隱藏資料夾，在ES文檔瀏覽器中預設不會顯示。在此我們要先修改設定，以顯示.thumbnails資料夾。

開啟ES文檔瀏覽器(ES File Explorer)，進入設定(Settings)。

進入顯示設定(Display settings)。

打勾「顯示隱藏檔案」(Show hidden files)。

再回到記憶體的DCIM資料夾中，就會看到.thumbnails資料夾了。

Step 2. 移除快取縮圖資料夾 / Delete .thumbnails Directory

首先長壓.thumbnails資料夾，直到ES文檔瀏覽器選取了該資料夾。然後再按下下方垃圾桶圖示的刪除(Delete)。

接著ES文檔瀏覽器會跳出一個確認刪除視窗，按下確認刪除。

Step 3. 建立取代檔案 / Create .thumbnails File

接著按下ES文檔瀏覽器左下角的「建立」(New)，選擇建立「檔案」(File)。

將該檔案命名為「.thumbnails」。

建立完成，這個位置就塞了一個.thumbnails檔案了。

這樣子未來Gallery APP就無法在「.thumbnails」資料夾中建立快取縮圖，因為這個路徑不是資料夾，而是檔案，因此會無法建立。

小結：刪除快取縮圖之後的後遺症？ / Conclusion: Is There Any Problems After Deleting .thumbnails?

我的Note 8平板刪除了.thumbnails資料夾已經過了一個月了。這個月我也是照常開啟網頁、讀PDF paper、看影片、看漫畫，並沒有感覺到什麼異常。

理論上刪除.thumbnails之後，開啟圖片的速度應該比較慢一點。但是這問題感覺上不明顯。倒是記憶體剩餘空間多了許多這點比較令人有感覺。

大家可以一起來試試看，有問題歡迎一起來討論。

(more...)

Git取代分支檔案的方法 / Replace Branch Files In Git

我通常使用TotoiseGIT工具利用Git與團隊協同開發。當我想要把自己的分支清空，全部改用別人的檔案時，可以使用以下的方法來取代自己的分支。

This article describes how to use TotoiseGIT to replace a branch’s files to another branch.

分支說明 / Branch Description

在本文的例子中會使用兩個分支(Branch)。

• Branch A：我目前所在的分支，以本地端的pudding分支為例。我不再需要該分支的所有檔案，我希望換成Branch B的檔案。
• Branch B：目標分支，以遠端伺服器上的master為例。我希望把Branch B的檔案拿到Branch A使用。

我的方法很笨，就只是單純的替換檔案而已。以下說明做法。

Step 1. 遞交Branch A / Commit Branch A

由於接下來做的事情會變動到Branch A的檔案，不論任何修改，使用Git都應該養成隨時遞交(Commit)的習慣。因此在此我們也先遞交Branch A。如果沒有任何檔案有修改的話，也可以勾選左下角的「只有訊息」(Message only)，並撰寫遞交的訊息(Message)即可。

Step 2. 獲取Branch B的資訊 / Fetch Branch B

我們要在TotoiseGIT中獲取Branch B的資訊。

做法是開啟Git同步(Git Sync)。

選擇要同步的Branch B。你可以按下「…」按鈕，開啟分支瀏覽器 (Browse reference)，在「/remotes/kals/master」找到我們要的Branch B。按下OK確定。

點選「獲取」(Fetch)。

如果出現藍色的「Success」訊息，表示獲取成功。

Step 3. 切換成Branch B / Checkout Branch B

我們要利用TotoiseGIT的Checkout功能，把Branch A切換到Branch B去。

在該Git專案的目錄底下按右鍵，選擇Switch/Checkout。

選擇Branch為遠端的master分支：remotes/kals/master。然後勾選建立新分支(Create New Branch)、強制切換(Force)，追蹤(Track)選項保持預設。然後按下OK。

接著切換檔案，如果出現藍色的「Success」訊息，表示成功。

雖然看起來檔案沒有什麼明顯的差別，但是現在的確切換成了分支Branch B。按右鍵可以看到「Git Commit -> "master"」，表示現在的分支的確是Branch B。

Step 4. 複製Branch B的檔案到另一個資料夾 / Copy Branch B’s Files To Another Folder

接下來我建立一個資料夾叫做「kals-temp」，然後把原本資料夾「kals」裡面的檔案複製到「kals-temp」去。這樣我就可以先保留了Branch B的資料。

Step 5. 切換回Branch A / Checkout Branch A

接著我再回到「kals」資料夾，然後以類似Step 3的方法切換回Branch A，也就是本機端的pudding分支。記得勾選「強制」(Force)。

Step 6. 刪除Branch A的檔案 / Delete Branch A’s Files

然後我們不需要Branch A的檔案了，全選檔案之後，把它們統統刪除吧。

Step 7. 移動Branch B的檔案回到專案的資料夾 / Move Branch B’s Files Back To Project Folder

接著再把存放Branch B的「kals-temp」資料夾中的資料移動到專案目錄「kals」資料夾中。

現在Branch A裡面的檔案就會是Branch B的檔案了。

Step 8. 遞交Branch A / Commit Branch A

 

完成取代之後，再一次遞交Branch A。由於現在這個Branch A的檔案是Branch B的檔案，因此跟Step 1遞交的檔案有很大的差異。下面的檔案變動(Changes made)會列出相當多的改變。總之先保存這次的變動，遞交吧。

這樣子我們就完成拿Branch B的檔案替換到Branch A分支裡面去了的任務了。

小結：尚未摸透Git / Conclusion: Complex Git

事實上，上述這個做法看起來很愚蠢。雖然我也寫了一個簡單的Git介紹，但老實說我對於Git仍不是這麼的熟悉。分支之間檔案交換的方法還有很多種，這篇是我找到最可行的一種方式。

一般的做法都是教你使用「比較跟前面版本的差異」(Diff with previous version)。可是這種做法中，Branch A中有、Branch B中沒有的檔案，依然還會存在在替換後的Branch A中。特別是當Branch B的檔案名稱修改時，就會造成Branch A替換後出現了兩個不同名稱檔案、但是檔案內容卻一樣的問題。

不過我後來在想，是不是應該要用Rebase這個工具來取代分支檔案呢？這點我就要繼續再研究看看了。希望熟悉Git的朋友能給我一些建議吧。

(more...)

Proxmox VE 3.2已經修復的備份鎖定問題 / Proxmox VE 3.2 Fixed Problem: Backup Lock

Proxmox VE在備份時會設定虛擬機器的備份鎖，位於/var/lib/vz/lock/[VMID].lck。在Proxmox VE 3.2版本中，備份異常中斷、或是有其他備份仍在進行中的時候，備份功能依然可以正常運作。

When Proxmox VE start a backup job, it will create a lock file at /var/lib/vz/lock/[VMID].lck. In Proxmox VE 3.2 version, when previous backup job got error or not finished, current current backup job will not crash.

舊版本的錯誤 / Problem of Older Version

備份時所產生的備份鎖，在舊版本的Proxmox VE中不會自動解除。例如這篇「backup failed - command 'qm set 101 --lock backup' failed with exit code 255」就遇到了這個問題，發問者doknet的錯誤訊息如下：

vm1:~# vzdump --dumpdir /var/lib/vz/dump/  --snapshot  101

INFO: starting new backup job: vzdump --dumpdir /var/lib/vz/dump/ --snapshot 101

INFO: Starting Backup of VM 101 (qemu)

INFO: stopped

INFO: status = stopped

INFO: setting parameters failed - VM is locked (backup)

ERROR: Backup of VM 101 failed - command 'qm set 101 --lock backup' failed with exit code 255

INFO: Backup job finished with errors

這時候由於備份時產生的備份鎖無法自動解除，所以必須要管理者手動刪除檔案。以VMID 101的虛擬機器為例：

rm -f /var/lib/vz/lock/101.lck

刪除該鎖之後，備份就可正常進行。

備份機制的運作方式 / The Survivability of Backup

在Proxmox VE 3.2版本中，備份時常發生的錯誤都不會影響備份任務的心情。常遇到的錯誤如下：

其他備份任務尚未完成 / Another Backup Job Is Still Not Completed

備份任務一次只能進行一個。較晚執行的備份任務會先等待其他任務完成，顯示訊息為：

INFO: trying to get global lock – waiting…

這時候備份任務會進行等待，然後當其他備份任務完成時，這個任務就會開始進行備份。

在這個情況下會連續製作備份檔案，請自行注意。

之前的備份任務異常中斷 / Previous Backup Job Is Crashed

如果之前的備份任務因為斷電、斷網等各種因素導致無法順利進行，那後來的備份任務也不會因此被鎖住，而可以直接開始備份。

備份空間不足的問題 / No Space Left When Backup

在各種試誤中，最後我只有找到了「No space left on device」的錯誤。如文字所示，這純粹是硬碟空間不足而已，也不是備份功能的問題。

如果大家在備份時有遇到被鎖住的錯誤情況，請再跟我分享。

(more...)