操作系统

  • OSROOM支持Linux中部署, Windows未测试过
  • 建议使用Ubuntu >= 14.04版本;
  • 测试过操作系统有Ubuntu 14.04, 16.04, 18.04; Centos 6.5;
  • 其他Linux系统还未测试

Pyhotn要求

  • Python 3.4以上版本, 比如Python 3.4, Python 3.5, Python 3.6

创建Python虚拟环境(建议)

  • 例如在在/home/work创建名为venv-osroom的虚拟环境
  • 没有安装好python-venv请先安装, Ubuntu安装命令如下(注意py版本号):

安装依赖包

  • 进入虚拟环境
  1.     source /home/work/venv-osroom/bin/activate
  2.     # 或
  3.     . /home/work/venv-osroom/bin/activate

  • 使用pip安装依赖包

  1. pip install -r requirements.txt

安装需求包异常情况

  • 情况1:类似以下错误信息

Ubuntu系统:

  1.  # 不一定需要版本号
  3.  sudo apt-get install python3.5-dev
  1.   # 不一定需要版本号
  2.  sudo yum install python3.5-devel
  • 情况2:类似错误信息
  1.  Command "python setup.py egg_info" failed with error code 1 in ...

那么请尝试安装 setuptools

安装

初始化配置

  1.  cp db_config_sample.py db_config.py
  • 编辑db_config.py, 在配置中对应位置填写好数据库用户名和密码
  • 注意: redis数据库如果没有密码，则下面配置文件中redis的password为""就可以
  2.  DB_CONFIG = {
  3.     "redis": {
  4.         "password": "<Your password>",
  5.         "host": [
  6.             "127.0.0.1"
  7.         ],
  8.         "port": [
  9.             "6379"
  10.         ]
  11.     },
  12.     "mongodb": {
  13.         "mongo_web": {
  15.             "username": "work",
  16.             "config": {
  17.                 "fsync": False,
  18.                 "replica_set": None
  19.             },
  20.             "host": [
  21.                 "127.0.0.1:27017"
  22.             ],
  23.             "dbname": "osr_web"
  24.         },
  25.         "mongo_user": {
  26.             "password": "<Your password>",
  27.             "username": "work",
  28.             "config": {
  29.                 "fsync": False,
  30.                 "replica_set": None
  31.             },
  32.             "host": [
  33.                 "127.0.0.1:27017"
  34.             ],
  35.         },
  36.         "mongo_sys": {
  37.             "password": "<Your password>",
  38.             "username": "work",
  39.             "config": {
  40.                 "fsync": False,
  41.                 "replica_set": None
  43.             "host": [
  44.                 "127.0.0.1:27017"
  45.             ],
  46.             "dbname": "osr_sys"
  47.         }
  48.     }
  49. }
  • 进入项目的Python虚拟环境
  • 进入根目录运行start.py add_user 按如下操作和提示创建第一个用户 创建完成提示"End"后Ctrl+C把创建程序关闭
  1. (venv_osroom) work@osroom:~/project/osroom$ python start.py add_user
  2.  * [User] add
  3. Input username:root
  4. Input email:hehecdirr@163.com
  5. Input password(Password at least 8 characters):
  6. [Warning]: 密码至少8个字符！ 至少包含数字，字母，特殊字符中的任意两种
  8. Input password(Password at least 8 characters):
  9.  * Create root role...
  10. Create root user role successfully
  11.  * Create root user...
  12.  * Create a root user role successfully
  13.  * Create the average user role...
  14.  * Create a generic user role successfully
  15. The basic information is as follows
  16. Username: root
  17. Email: h*****irr@***.com
  18. User role: Root
  19. Password: #D****qw123
  20. End

使用自带的服务测试是否能够成功运行osroom（测试用, 实际部署产品不会使用该方式启动运行）

启动OSROOM

  • 打开浏览器访问 127.0.0.1:5000