LiveBOS Server(Tomcat版)安装手册

面向对象的业务支撑平台与建模工具 * 实现 应您所需, 随时而变 的应用 * 业务管理应用软件最佳选择 * LiveBOS Server (Tomcat 版 ) 安装手册 福建顶点软件股份有限公司 www.livebos.com Copyright c 1996-2010 版权所有福建顶点软件股份有限公司 1

目录 1 简介... 3 2 安装须知... 4 3 安装步骤... 5 4 授权注册... 20 5 数据源变更说明... 23 6 卸载 LiveBOS... 26 6.1 卸载注意事项... 26 6.2 卸载步骤... 26 附录 A LiveBOS 安装目录说明... 28 附录 B 服务器项目目录说明... 29 附录 C FAQ... 30 2

1 简介 LiveBOS 每个版本都支持两种 tomcat 安装部署方式 : 一种是安装程序包 LiveBOS.exe, 还有一种是完整的压缩文件包 LiveBOS_Tomcat.rar 这两种安装方式的区别在于, 前者在安装过程中逐步完成 LiveBOS 数据库基础数据的创建和系统参数的配置, 而后者则需要用户手动进行 LiveBOS 基础数据的创建, 解压后手动配置系统参数 建议 LiveBOS 系统初学者采用第一种安装包的方式进行 3

2 安装须知 安装本程序前, 请检查是否符合本程序的安装要求 (1) 目前支持 Windows 操作系统, 推荐使用 Windows XP (2) 要求数据库已安装好 数据库可选择 SQLServer2000 SQLServer2005 SQLServer2008 Oracle9i 以上版本, 且要求 SQLServer2000 和 SQLServer2005 都需要打 SP3 及以上版本的补丁,SQLServer2005 和 SQLServer2008 需要在网络配置中启用 TCP/IP 协议 (3) 如果不使用安装程序自带的 JDK, 可手动配置 JDK 的系统环境变量, 需要 1.6 以上版本支持 4

3 安装步骤 在顶点软件公司网站上下载 LiveBOS Tomcat 的安装程序 LiveBOS.exe 到本地 1, 双击 livebos.exe, 开始进入安装界面, 如图 ; 图 3.1 2, 单击 是, 进入解压缩界面, 如图 ; 图 3.2 3, 解压缩完成后, 进入语言选择界面, 系统默认选择 chn 单击 Ok 继续安装 ; 5

图 3.3 4, 欢迎界面, 单击 下一步 继续安装 ; 图 3.4 5, LiveBOS 平台简介界面, 单击 下一步 继续安装 ; 6

图 3.5 6, 用户授权许可协议界面, 选择我接受该许可协议的条款, 单击 下一步 继续安装 ; 7

图 3.6 7, 程序安装路径选择界面, 单击 下一步 继续安装 ; 8

图 3.7 注 LiveBOS 安装路径不允许包含中文字符 8, 可选安装包选择界面,LiveBOS Server LiveBOS 核心程序和 LiveBOS 数据库脚本是必选项,JDK 和 LiveBOS 文档是可选项 ( 推荐全选 ) 单击 下一步 继续安装; 9

图 3.8 9, 服务器基本信息配置界面, 配置完成后, 单击 下一步 继续安装 ; 10

图 3.9 系统名称 : 默认为 LiveBOS, 可由用户修改, 如修改为 灵动商务系统 ; HTTP 端口 :8080 为 Tomcat 默认端口, 访问 LiveBOS 的端口 如果 8080 端口被系统其他应用程序占用, 可由用户进行修改 ; 数据库类型 : 选择要安装的数据库类型, 当前提供 2 种数据库类型 SQLServer/Oracle 供选择 10, 进入数据库连接信息配置界面, 配置数据库连接信息, 完成后, 单击 下一步 继续安装 ; 11

图 3.10 数据库服务器地址 : 数据库服务器所在地 IP 地址, 本机数据库可以配置为 localhost, 非本机数据库服务器可配置为 IP 地址, 如 :192.168.0.17 数据库端口 : 数据库服务器的监听端口 SQLServer 数据库一般为 1433,Oracle 数据库一般为 1521 数据库名称 : 数据库中已有的数据库名称 ; 数据库用户 / 口令 : 已有数据库用户和口令 ; 初始化数据库, 执行 LiveBOS 基础数据的初始化操作 若当前数据库已经存在 LiveBOS 所需的系统表, 则可以不在复选框前打勾 ; 若当前数据库为新建的空库, 则必须在复选框前打勾 11, 进入安装信息确认界面, 单击 下一步 继续安装 ; 12

11, 进入包安装过程界面 ; 图 3.11 13

图 3.12 12, 包安装完成, 单击 下一步 继续安装 ; 14

图 3.13 13, 数据库及系统参数处理界面,LiveBOS 系统初始化完成, 单击 下一步 继续安装 ; 15

图 3.14 说明 若初始化处理失败, 界面将给出错误提示, 用户可根据错误提示重新安装配置 ; 14, 创建快捷方式界面, 可以选择桌面创建快捷方式等 单击 下一步 继续安装 ; 16

图 3.15 15, 安装完成, 单击 完成 结束安装 17

图 3.16 补充 :LiveBOS 安装程序在 Oracle 数据库上连接信息配置如图 : 18

注意 : 这里要求 Oracle 数据库中, 数据库用户已存在 19

4 授权注册 第一步 : 启动 LiveBOS 服务 打开 Windows 开始 选项, 选择所有程序 LiveBOS 业 务架构平台 启动 LiveBOS 服务, 将 LiveBOS 服务器启动 ; 也可以找到 LiveBOSServer\LiveBOS _Tomcat\bin 目录, 双击 startup.bat 文件启动服务 图 4.1 注 : 当 LiveBOS 服务器出现如上图所示 :Server startup in... ms 时, 说明服务启动成功 第二步 : 打开 Windows 开始 选项, 选择所有程序 LiveBOS 业务架构平台 控制中心, 进入管理控制台界面 输入管理员用户名 ( 如 :admin) 和密码 ( 如 :000000), 单击 Login 20

图 4.2 注 右上角为返回应用系统按钮, 点击此按钮可完成应用系统与管理控制台之间的切换功能 第三步 : 进入管理控制台首页, 显示系统信息 复制序列号给 LiveBOS 软件开发商福建顶点软件股份公司, 以获取授权文件 livebos.license 如下图所示; 图 4.3 第四步 : 点击上图序列号右侧的放大镜按钮, 在弹出的对话框中选中 livebos.license 文 件, 单击 确定 即完成授权注册 注册完成后, 重启 LiveBOS 服务器, 授权方可生效 21

图 4.4 22

5 数据源变更说明 安装程序安装成功后, 有时用户需要变更数据源的配置项, 可以通过以下方式进行 : 1. 进入到 $LiveBOSServer\LiveBOS_Tomcat\conf 文件夹, 打开 server.xml 找到 <Context crosscontext="true" docbase="${catalina.home}/livebos/formbuilder" path="" reloadable="false"> 节点 : <Resource auth="container" driverclassname="com.microsoft.sqlserver.jdbc.sqlserverdriver" maxactive="100" maxidle="30" maxwait="10000" name="jdbc/livebosds" password="000000" type="javax.sql.datasource" url="jdbc:sqlserver://localhost:1433;databasename=livebos;selectmethod=cursor;" username="sa"/> ( 注意 : 其中各个对应的节点的值根据具体变更做相应的修改 ) auth="container":container 是作者的名称, 这是资源节点的一个属性 driverclassname="com.microsoft.sqlserver.jdbc.sqlserverdriver" : 指定了数据库的驱动类名, 这里使用的是 SQL 数据库, 因此使用的驱动类名为 com.microsoft.jdbc.sqlserver.sqlserverdriver, 管理员可以根据数据库的不同在这里进行修改 maxactive= 100 : 指定了与数据库的最大连接数, 默认为 100, 管理员可以根据需要对其进行调整 maxwait="10000": 指定了尝试与数据库相连的最大等待时间, 以毫秒为单位, 最长等待时间默认为 10 秒, 管理员可以根据需要对其进行修改 name="jdbc/livebosds": 这里的名称指的是资源节点的名称, 默认为 jdbc/livebosds ( 注意大小写问题, 并且这里配置的 resource 的 name 必须保证唯一, 不允许重复 ) password="000000": 指定了与用户名匹配的密码, 管理员可以根据数据库的不同在这里修改密码 type = "javax.sql.datasource":javax.sql.datasource 标记了资源节点的类型, 它也是资源节点的属性之一 url="jdbc:sqlserver://localhost:1433;databasename=livebos;selectmethod=cursor: 指定了数据库的信息, 数据库的访问路径是 jdbc:microsoft:sqlserver://localhost:1433, 数据库的名称是 LiveBOS( 数据库中建立的数据库名称 ), 并以指针作为选择方式, 在具体配置过程中, 管理员可以根据数据库的不同在这里进行修改 username="sa": 指定了数据库的用户名, 管理员可以根据数据库的不同在这里修改用户名 上文详细描述了 SQL Server 数据库连接池的配置 对于 Oracle 或者其他类型的数据库, 只需在相应的地方做修改即可 下面再简单说明配置 Oracle 数据库连接池的例子 类似 SQL Server 数据库数据源配置, 在 server.xml 文件中找到如下节点 ( 数据源节点 ), 并 23

对节点的值做相应修改 ( 可修改的部分用红色字体标志 ): <Resource auth="container" driverclassname="oracle.jdbc.driver.oracledriver" maxactive="100" maxidle="10" maxwait="1000" name="jdbc/oracleds" password="abs" type="javax.sql.datasource" url="jdbc:oracle:thin:@192.168.0.17:1521:orcl" username="crmii" validationquery="select 1 from dual"/> 与 SQL Server 相同的部分不再说明, 可参照上文栏目解释 driverclassname="oracle.jdbc.driver.oracledriver": 与 SQL Server 类似, 为 oracle 驱动器类 url="jdbc:oracle:thin:@192.168.0.17:1521:orcl":192.168.0.17 为 Oracle 数据库服务器地址, orcl 为 Oracle 数据库服务名, 默认主机为本机 1521 端口, 也可设置为其他主机, 如 : 192.168.0.1 validationquery="select 1 from dual": 验证数据源配置的时候使用的测试语句 2. 关闭并保存配置文件, 完成配置 3. 重启 tomcat 服务 启动后, 打开 IE, 输入如下地址 :http:// 服务器地址 :8080 如果服务器在本机上, 则可直接输入 :http://localhost:8080, 会进入如下界面 : 图 5.1 4. 点击右下角的切换图标, 进入管理控制台登录页面 ( 见下图 ), 分别输入用户名和密码, 如果成功登录, 说明配置没有错误 : 24

图 5.2 25

6 卸载 LiveBOS 6.1 卸载注意事项 卸载 LiveBOS 时的注意事项如下 : (1) 卸载本程序前, 请停止 LiveBOS Server 服务 ; (2) LiveBOS 一旦卸载, 将不能恢复, 请慎用 6.2 卸载步骤 1. 打开 Windows 开始 选项, 选择所有程序 LiveBOS 业务架构平台 卸载 LiveBOS, 将 会弹出一个 LiveBOS 卸载窗口 图 6.1 注 若勾选强制删除复选框, 则彻底卸载 LiveBOS; 若不勾选强制删除复选框, 则有别的程序引用里面的文件时 LiveBOS 将无法删除 2. 单击 卸载, 开始进入卸载 LiveBOS Server 图 6.2 3. 单击 退出, 完成 LiveBOS Server 的卸载 26

图 6.3 27

附录 A LiveBOS 安装目录说明 LiveBOS 完成安装后, 安装目录如下所示 : 各个关键子目录及其说明请看下表 : 目录说明 Doc JDK LiveBOS_Tomcat res SQL Uninstaller shutdown.bat start.bat LiveBOS 文档目录 Java 运行环境 LiveBOS Server 相关文件目录资源目录 LiveBOS 安装程序的数据库脚本目录 LiveBOS 卸载目录关闭 LiveBOS 服务的批处理文件启动 LiveBOS 服务的批处理文件 28

附录 B 服务器项目目录说明 每一个由服务器管理的项目, 都带有一个对应的配置目录 ( 也可以在后台通过配置系统 参数的方法配置 ), 本例中项目 LiveBOS 的对应项目配置目录是 ABS_DOCUMNET, 下面我们 将对该文件夹的核心目录做个介绍 核心目录及其子目录说明请看下表 : 目录说明 config logs Plugins 存放了用户自定义对象模板配置文件 (templet.xml) 和用户自定义控件配置文件 (control.xml) LiveBOS 自动记录当前服务器运行日志并保存日志历史, 日志文件以天为单位, 历史日志的文件名自动添加日期作为后缀存放用户自定义插件, 允许以两种形式部署插件, 一种以.jar 包形式部署, 另一种按类路径建立对应目录结构部署编译后的 java 类 例如 灵动商务系统 LiveBOS 文件夹, 里面是当前项目的相关文件 项目名称对应 的文件夹 Report workflow portal-config navigator FormLayout 其他以对象内部名称命名的文件夹 存放当前项目报表定义文件存放当前项目工作流流程图存放当前项目门户模板存放当前项目页面导航文件存放当前项目界面定制文件分别存放此对象的外部文档字段数据 29

附录 C FAQ 问题 1:SQLServer 数据库连接失败 :Network error IOException: Connection refused: connect 解决 : 检查数据库服务器端口是否被防火墙阻止了 问题 2:SQLServer 数据库连接失败 :I/O Error :DB server closed connection. 30

解决 : 检查数据库服务器的 TCP/IP 协议是否已经启用, 或者数据库服务器的端口是否配置 正确 问题 3: SQLServer 数据库连接失败 : 无法打开登录所请求的数据库 登录失败 31

解决 : 执行初始化数据库前, 确认数据库服务器中是否存在名为 LiveBOS 的空库 该安装 程序不会自行创建数据库 问题 4:LiveBOS 系统安装成功后, 双击 startup.bat 启动 tomcat 时, 界面闪了一下就消失了 解决 : 可以通过手动配置 JDK 系统环境变量来解决 问题 5: 安装 tomcat 过程, 执行安装时报 : 到主机的 TCP/IP 连接失败 java.net.socket TimeoutException: connect timed out SYSTEM CONFIGURE ERROR!null 解决 : 数据库服务器的 1433 端口被阻止了, 在防火墙中开启该端口 问题 6: LiveBOS 系统授权信息 ( 对象数 / 用户数 / 系统数 ) 说明 解决 : 对象数 : 是指服务器允许提交的对象数目, 包括了 LiveBOS 自带的系统对象 ; 用户数 : 是指同一时间内登录到 LiveBOS 系统的用户数 ; 系统数 : 是指 LiveBOS 允许的系统方案数 问题 7: 数据库服务器使用 SQL Server 2008, 安装成功后, 登录 LiveBOS 系统时, 报 : 不支 持此服务器版本 目标服务器必须是 SQL Server 2000 或更高版本 解决 : 更换数据库驱动 LiveBOSServer\LiveBOS_Tomcat\lib 目录下 sqljdbc4.jar 文件是 SQL2008 的驱动, 将其名称改为 sqljdbc.jar 即可 32