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