RapidSMS 開發者指南/安裝
以下描述瞭如何在 Windows 機器上,在虛擬機器 (VM) 中安裝 RapidSMS。此設定適合生產和開發。
對於 Linux 使用者,只需按照虛擬機器內的說明操作,或使用 Virtual Box 按照常規說明操作。
| 型別 | 軟體 | 版本 |
|---|---|---|
| 作業系統 | Ubuntu (linux) | 9.10 server i386 |
| 虛擬機器 | Virtualbox | 3.1.4-57640-Win |
| SSH 客戶端 | Putty | 0.60 |
| 網頁瀏覽器 | Firefox | 3.6 |
| 編輯器 | Scite | 2.03 |
| Web 框架 | Django | 1.1.1 |
所有上述軟體準備就緒後,啟動 Virtualbox,按照嚮導操作。
- 按新建以建立新的虛擬機器。
- 在歡迎螢幕上按下一步。
- 為虛擬機器輸入一個名稱(例如:RapidSMS),選擇Linux作為作業系統型別,選擇Ubuntu作為版本。
- 按下一步,選擇虛擬機器要使用的記憶體大小(256M 即可)。
- 按下一步,保留啟動硬碟(主引導盤)選中狀態。
- 按下一步,將出現新的嚮導。
- 保留儲存型別(動態擴充套件儲存)。
- 選擇 VirtualBox 要使用的儲存大小(8G 即可)。
- 按下一步,然後按完成。
現在,從上述步驟中選擇您建立的虛擬機器(RapidSMS),右鍵單擊它,然後選擇設定。
- 轉到儲存選項卡。在儲存樹上,選擇非硬碟驅動器。
- 在屬性窗格中,選擇 CD/DVD 裝置,並新增您下載的Ubuntu Server ISO 檔案。
- 在網路選項卡上
- 介面卡1:選中啟用網路介面卡框。
- 在連線到欄位中,選擇主機專用介面卡。
- 介面卡2:選中啟用網路介面卡框
- 在連線到欄位中,選擇橋接介面卡
- 在名稱欄位中,選擇您有網際網路連線的網路卡。
- 關閉並儲存虛擬機器的設定。
- 現在,從主 Virtual Box 選單中單擊檔案 -> 首選項。
- 在網路選項卡上,設定您的介面卡和 IP 地址(例如:192.168.10.1)和網路掩碼(例如:255.255.255.0)。
- 在 DHCP 子選項卡上,停用 DHCP 伺服器。
現在,透過單擊啟動,啟動您配置的虛擬機器。
啟動虛擬機器後,您的作業系統(在本例中為 Ubuntu)將啟動。
我們需要在 Ubuntu 中安裝一些軟體,以配置 RapidSMS 並使其正常執行。
上述配置在虛擬機器中設定了兩個網路介面
- 主機專用介面,我們將始終使用它來訪問虛擬機器。
- 橋接介面,我們將使用它從虛擬機器訪問網際網路,並在網路上公開 RapidSMS 伺服器。
要配置虛擬機器中的網路,我們需要編輯interfaces檔案
sudo nano /etc/network/interfaces
在該檔案中寫入以下內容
# The loopback network interface auto lo iface lo inet loopback auto eth0 iface eth0 inet static address 192.168.10.20 netmask 255.255.255.0 auto eth1 iface eth1 inet dhcp
儲存檔案(:x)並重新啟動網路服務
sudo /etc/init.d/networking restart
RapidSMS 需要幾個軟體。以下命令將下載並安裝所需的軟體(約 40MB)。
sudo apt-get install aptitude
sudo aptitude install gettext git-core python python-pybabel python-serial \ python-setuptools python-tz python-mysqldb python-pysqlite python python-pysqlite2 \ sqlite sqlite3
以下命令將安裝一些額外的庫(約 100MB)。可選。
sudo aptitude install python-reportlab pdftk python-matplotlib python-xlwt
以下命令將安裝PEP8,這是一個用於確保滿足 Python 編碼標準的工具。
sudo easy_install pep8
以下命令將在虛擬機器中生成語言環境檔案。新增您可能想要使用的所有語言環境(您可以在之後進行此操作)。以下分別是法語、英語(美國)和阿拉伯語(約旦)的語言環境(按順序排列)。
sudo locale-gen fr_FR.UTF-8 sudo locale-gen en_US.UTF-8 sudo locale-gen ar_JO.UTF-8
安裝和配置 Samba 將為我們提供一種方法,可以使用常規的 Windows 文字編輯器,直接從 Windows 內部寫入虛擬機器內的檔案。
sudo aptitude install samba smbfs sudo nano /etc/samba/smb.conf
在檔案末尾新增以下內容
Security = share
[rsms]
comment = RapidSMS Dev
path = /home/{your ubuntu username}
public = yes
writable = yes
create mask = 0644
directory mask = 0755
force user ={your username}
force group = {your username}
關閉檔案並重新啟動 Samba
sudo service samba restart
在 Windows 上,您現在可以透過以下 URL 訪問您的主目錄(/home/<username>):\\192.168.10.20\rsms。
您可以將此資料夾對映到 Windows 上的驅動器號,以便輕鬆訪問它(僅在虛擬機器啟動時有效)。
按照 程式碼結構,我們現在將建立一個sources資料夾來儲存所有第三方依賴項。
cd ~ mkdir sources
解壓縮 Django 1.1.1 存檔(請參閱 系統要求 下的下載連結)後,將 Django-1.1.1 資料夾複製到sources。
然後,切換到該目錄並安裝它
cd ~/sources/Django-1.1.1 sudo python ./setup.py install
RapidSMS 主分支(核心)位於 github.com/rapidsms/rapidsms。
克隆程式碼並安裝它
cd ~/sources git clone git://github.com/rapidsms/rapidsms.git cd rapidsms sudo python ./setup.py install
現在,RapidSMS 已安裝。
許多 RapidSMS 應用程式並不位於核心。它們可以從開發者的儲存庫中獲取。
如果您想使用某些應用程式,請將這些儲存庫克隆到sources資料夾,然後按照 個人儲存庫 中的說明連結應用程式。