跳至內容

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,按照嚮導操作。

  1. 按新建以建立新的虛擬機器。
  2. 在歡迎螢幕上按下一步。
  3. 為虛擬機器輸入一個名稱(例如:RapidSMS),選擇Linux作為作業系統型別,選擇Ubuntu作為版本。
  4. 按下一步,選擇虛擬機器要使用的記憶體大小(256M 即可)。
  5. 按下一步,保留啟動硬碟(主引導盤)選中狀態。
  6. 按下一步,將出現新的嚮導。
    1. 保留儲存型別(動態擴充套件儲存)。
    2. 選擇 VirtualBox 要使用的儲存大小(8G 即可)。
  7. 按下一步,然後按完成。

現在,從上述步驟中選擇您建立的虛擬機器(RapidSMS),右鍵單擊它,然後選擇設定。

  1. 轉到儲存選項卡。在儲存樹上,選擇非硬碟驅動器。
    1. 在屬性窗格中,選擇 CD/DVD 裝置,並新增您下載的Ubuntu Server ISO 檔案。
  2. 在網路選項卡上
    1. 介面卡1:選中啟用網路介面卡框。
    2. 連線到欄位中,選擇主機專用介面卡
    3. 介面卡2:選中啟用網路介面卡框
    4. 連線到欄位中,選擇橋接介面卡
    5. 名稱欄位中,選擇您有網際網路連線的網路卡。
  3. 關閉並儲存虛擬機器的設定。
  4. 現在,從主 Virtual Box 選單中單擊檔案 -> 首選項。
    1. 在網路選項卡上,設定您的介面卡和 IP 地址(例如:192.168.10.1)和網路掩碼(例如:255.255.255.0)。
    2. 在 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

Python 包

[編輯 | 編輯原始碼]

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 安裝和配置

[編輯 | 編輯原始碼]

安裝和配置 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 上的驅動器號,以便輕鬆訪問它(僅在虛擬機器啟動時有效)。

RapidSMS 依賴項

[編輯 | 編輯原始碼]

按照 程式碼結構,我們現在將建立一個sources資料夾來儲存所有第三方依賴項。

cd ~
mkdir sources

Django Web 框架

[編輯 | 編輯原始碼]

解壓縮 Django 1.1.1 存檔(請參閱 系統要求 下的下載連結)後,將 Django-1.1.1 資料夾複製到sources

然後,切換到該目錄並安裝它

cd ~/sources/Django-1.1.1
sudo python ./setup.py install

RapidSMS 核心庫

[編輯 | 編輯原始碼]

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資料夾,然後按照 個人儲存庫 中的說明連結應用程式。

程式碼結構 · 個人儲存庫

華夏公益教科書