跳至内容

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文件夹,然后按照 个人存储库 中的说明链接应用程序。

代码结构 · 个人存储库

华夏公益教科书