项目编号 TeamDR1.0 课题数据宝本地部署版安 装手册 科学数据中心数据技术组 2015 年 8 月
目录 课题数据宝本地部署版安装手册... 1 一 安装环境... 3 二 环境配置... 3 1. Mongodb 安装与配置... 3 1.1 Mongodb 下载... 3 1.2 Windows 系统下安装配置... 3 1.3 Linux 系统下安装配置... 6 2. Java 环境配置... 6 2.1 Windows 环境配置... 6 2.2 Linux 环境配置... 10 3. OpenOffice 安装配置... 10 3.1 Windows 下安装... 10 3.2 Linux 下安装... 11 三 安装与部署... 12 1. Windows 服务器部署... 12 2. Linux 服务器部署... 15 3. 常见问题... 16 2
一 安装环境 操作系统 Windows server 2003 以上 Linux 数据库 Mongodb 2.6+(windows 安装包已含, 无需安装 ) Java 1.8 其他软件 OpenOffice4 二 安装包版本介绍 版本 teamdrsetup-win32.exe teamdrsetup-win2008plus_x64.exe teamdrsetup-win-legacy_x64.exe teamdr.tar.gz 适用范围 Windows server2003 以上 32 位系统 Windows server 2008R2 windows7/8/8.1/10 64 位系统 Windows server2003/2008 windows vista 64 位系统各个 Linux 64 位系统 三 环境配置 1. Mongodb 安装与配置 1.1 Mongodb 下载 Mongodb 下载地址为 :https://www.mongodb.org/downloads, 根据不同的系统, 选择相应的下载安装包, 课题数据宝要求 mongodb 版本在 2.6 以上, 用户下载最新的 mongodb 版本即可 1.2 Windows 系统下安装配置 这里以 64 位 windows 系统举例, 详细说明 mongodb 在 windows 系统下的安装配置 在 1.1 3
节下载 windows 64 位安装包, 如果你的系统是 windows server 2008 win7 或者更新的版本, 请下载 MongoDB for Windows 64-bit, 如果是较低版本, 如 win vista windows server 2003, 请下载 MongoDB for Windows 64-bit Legacy 1. 运行下载下来的 mongodb 安装包 2. 点击 Next, 同意协议后, 到达安装类型选项卡, 选择 custom, 在 custom 选项卡中, 可以配置安装路径, 以及需要安装的功能 建议安装所有功能 4
3. 点击 Next, 确认安装,mongodb 将自动安装 4. 安装完成后, 需要进行一些配置, 首先新建 data 目录和 log 目录, 用于存放 mongodb 的数据文件和日志文件 在系统磁盘上创建名字为 data 和 log 的目录 5. 使用管理员身份打开 windows 控制台, 进入 mongodb 安装目录下的 bin 目录 因为前一步将 mongodb 安装在了 e:\mongodb 目录下, 所以通过控制台进入此目录下的 bin 目录 用户可以根据自己的安装情况做适当修改 6. 运行命令 : mongod.exe --dbpath "e:\mongodb\data" --logpath "e:\mongodb\log\mongod.log" install 安装 mongodb 服务 7. 运行命令 :net start MongoDB, 启动 mongodb 服务 Mongodb 服务就已经启动了, 默认监听地址为 127.0.0.1, 端口号为 27017. 若想要关闭 mongodb 服务, 可以在命令窗口运行命令 :net stop MongoDB 更多的设置, 可以参考官方网站文档 :http://docs.mongodb.org/manual/tutorial/install-mongodb-on-windows/ 5
1.3 Linux 系统下安装配置 Linux 系统版本较多, 每种版本的安装方式有一些区别, 这里以常用的 RedHat/Centos 系统为例, 其他的系统的安装方法可以到官网上找到, http://docs.mongodb.org/manual/administration/install-on-linux/ 1) 进入终端, 创建文件 /etc/yum.repos.d/mongodb-org-3.0.repo, 这样就可以使用 yum 的方法进行快速安装 文件中做如下配置 : [mongodb-org-3.0] name=mongodb Repository baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.0/x86_64/ gpgcheck=0 enabled=1 2) 运行命令 sudo yum install -y mongodb-org, 安装最新版本的 MongoDB 3) 安装完成后, 使用命令 sudo service mongod start 启动 MongoDB, 默认监听端口是 27017 4) 使用命令 sudo service mongod stop, 可以停止 MongoDB 服务 5) 可以编辑 MongoDB 配置文件 :/etc/mongod.conf, 来修改 MongoDB 监听端口等一些设 置 2. Java 环境配置 2.1 Windows 环境配置 系统需要安装 JDK1.8 版本, JDK 下载地址 : http://www.oracle.com/technetwork/java/javase/downloads/index.html; 下载安装包后双击打开进行安装, 6
安装过程中没有特别的设置, 根据向导进行安装即可 1) 下载安装 JDK 后, 需要设置环境变量, 打开系统属性页, 点击环境变量 2) 在系统变量中新建变量 JAVA_HOME, 值一栏中填入刚安装的 jdk 文件夹路径 7
3) 编辑系统环境变量 PATH, 在值的最后, 添加 ;%JAVA_HOME%\bin 注意, 不要删除原来的值, 在值的最后添加 ;%JAVA_HOME%\bin 8
4) 添加 CLASSPATH 环境变量, 值为.;%JAVA_HOME%\lib 9
2.2 Linux 环境配置 Linux 环境下 jdk 安装方式有 RPM 和 Tar 包两种, 这里以 tar 包为例, 首先下载 jdk1.8 的 tar 压缩包 1) 解压 tar 包, 使用命令 :tar zxv jdk-8u51-linux-x64.tar.gz 2) 修改 /etc/profile 文件, 设置 JAVA_HOME,PATH 环境变量, 如下图所示, 其中 JAVA_HOME 的路径是上一步解压后的 jdk 目录路径 3. OpenOffice 安装配置 OpenOffice 用于在线文档预览, 课题数据宝需要调用 OpenOffice 服务来进行文档转换, 所以必须先装 OpenOffice, 才能运行课题数据宝系统 OpenOffice 下载地址 : http://www.openoffice.org/download/index.html 3.1 Windows 下安装 1) 下载 OpenOffice 的 windows 系统安装包, 运行安装包, 安装包会将安装文件解压 在一个目录下, 注意此目录为解压目录, 还会生成安装目录, 在课题数据包安装时 需要填写安装目录 2) 解压完成后, 会自动进行安装, 在安装类型页, 选择自定义
3) 设置安装目录, 这个目录将会在课题数据宝安装时使用到 4) 一直点击下一步, 完成安装 3.2 Linux 下安装 1) 下载 Linux 系统使用的 tar 包, 并解压, 使用命令 : tar xvzf **.tar.gz 2) 使用 cd 命令, 进入解压后的目录下的 RPMS 目录 3) 在 RPMS 目录下运行命令 rpm -Uvih *rpm, 将自动安装 OpenOffice 到 /opt 目录 下, 即默认 OpenOffice 的安装目录是 /opt/openoffice4
四 安装与部署 1. Windows 服务器部署 在 http://www.teamdr.cn/public/download 上下载 windows 版安装包, 根据服务器情况, 下载 32 位或者 64 位安装包, 双击打开安装包, 如果未能打开或者提示未安装 java, 请参照第二章所述进行环境配置, 再进行安装 1) 双击打开安装包, 如下图所示 : 2) 如果系统已经安装了 MongoDB 数据库, 请不要勾选 MongoDB 服务进行安装 3) 选择安装的目录, 尽量安装在系统盘之外
4) 如果已经安装了 MongoDB 数据库, 请在这一步填写 MongoDB 数据库连接信息 ; 没有安装 MongoDB 服务, 并且在第二步中勾选了 MongoDB 安装, 安装包将默认 进行 MongoDB 安装, 这一步将直接跳过, 不需要填写 5) 填写公共邮箱号和邮箱密码, 用于发送系统邮件, 一定要设置真实有效的邮箱地址和密码, 否则影响用户注册 邮件通知等关键功能 ; 设置 OpenOffice 安装目录, 如果没有安装 OpenOffice, 请先安装 OpenOffice, 否则系统无法启动 ; 设置数据文件存储的目录
6) 设置超级管理员账号和密码, 超级管理员可以进行课题组管理 7) 完成安装后, 桌面会有两个快捷方式 启动课题数据宝系统 和 关闭课题数据宝系统, 双击 启动 快捷方式, 会弹出 tomcat 的启动控制台, 系统将自动启动, 默认绑定在 80 端口 ; 双击 关闭 快捷方式, 会关闭 tomcat 启动控制台, 同时关闭课题数据宝系统
8) 假如系统安装在 C 盘 / 系统盘, 需要通过管理员身份来运行脚本 首先使用管理员 身份打开命令行 ; 使用 cd 命令, 进入 % 课题数据宝安装目录 %\tomcat8.0\bin; 运行 批处理文件 startup.bat, 将会弹出 tomcat 窗口, 进行启动 2. Linux 服务器部署 Linux 下没有图形安装程序, 需要手动进行配置修改 首先到 http://www.teamdr.cn/public/download 页面下载 teamdr.tar.gz 包 1) 使用命令 :tar xvzf teamdr.tar.gz, 将包解压到当前文件夹 2) 使用 cd 命令, 进入解压后的目录下的 /rdpal/web-inf/classes 目录 3) 编辑目录的 db.properties 文件, 添加 MongoDB 连接 ip 和端口号, 如下图所示 :
4) 编辑目录下的 system.properties 文件, 添加公共邮箱地址与密码 openffice 安装目录以及数据文件存储目录 其中公共邮箱和密码必须真实有效, 否则影响用户注册通知等消息的发送 ;OpenOffice 的安装目录必须设置正确, 否则系统无法启动 如下图所示 : 5) 使用 cd 命令回到课题数据解压的目录下, 找到 InitMongoDB.class 文件 6) 在当前目录下运行命令 :java -classpath.:./mongo-java-driver-3.0.2.jar InitMongoDB 按照提示, 依次输入超级管理员用户名和密码, 用户名必须是邮箱 超级管理员可以登录后台管理课题组 7) 进入安装目录下的 tomcat 目录, 进入 tomcat 目录下的 bin 目录, 运行 startup.sh 启动课题数据宝系统 8) 同上一步, 在 bin 目录下有 shutdown.sh 文件, 运行此文件可以停止课题数据宝系统 3. 常见问题 1) 本地系统已经包含 tomcat 并设置了 tomcat 环境变量 TOMCAT_HOME 解决方案 : 修改 Tomcat 环境变量 TOMCAT_HOME, 将其设置成安装包内 tomcat 的地址, 即 :%teamdr 安装位置 %\tomcat8.0 更改后即可启动系统 2) 双击安装程序出现 请先安装 java1.8 并设置环境变量 JAVA_HOME 解决方案 : 到 java 官方网站下载 JDK1.8 安装程序, 并进行安装 安装完成后, 设置环境变量 JAVA_HOME 为新安装 jdk 的安装地址 3) 启动系统后, 通过 ip 或者域名无法访问系统解决方案 : 首先检查系统的防火墙, 是否允许通过 80 端口进行连接 ; 如果是 windows 系统, 还需要检查自带的 IIS 服务是否开启, 如果开启请关闭 IIS 服务,IIS 服务默认占用 80 端口, 导致 tomcat 无法绑定 80 端口,IIS 服务可以在控制面板 -> 管理工具 ->Internet 信息服务路径访问到 以上问题修改后, 重启 tomcat 即可 4) 双击启动快捷方式,tomcat 窗口出现无权限访问错误信息解决方案 : 系统可能安装在 windows 的系统盘导致文件无法正常写入, 此时需要通过 windows 命令行来启动系统 首先使用管理员身份打开 windows 命令行, 进入 % 课题数据宝安装位置 %\tomcat8.0\bin 目录, 在命令行中运行 startup.bat 命令, 即可正常启动