If you're a Managed Hosting (SaaS) customer, this topic doesn't apply to you.
自 2016 年第二季度版本开始,Blackboard Learn 9.1 安装程序基于 Gradle 和 Maven。安装流程发生了变化,但最终会变得越来越简单。新的安装程序完全通过命令行运行。Blackboard Learn 属性已在平面文件中进行了预配置,文件中还包括一些用于定义安装流程的设置。该文件中只有一些必需的内容。大部分设置都有合理的默认值,如需对其更改,只需输入相应内容即可。
准备安装程序属性
新的 Blackboard Learn 安装程序没有用户界面。因此,就不存在安装时收集数据所用的表单。为了指定此类信息,安装程序需要平面文件(包含之前在安装时输入的配置信息)。为了实现此文档的这个目的,配置文件会被命名为 installation.properties,但对于特定文件名没有要求,因为文件的完整路径会作为命令行参数传递给安装脚本。
其中有安装程序需要的几个参数,以及依赖于系统会利用的数据库的必需参数的子集。
全新安装
属性 | 说明 |
---|---|
bbconfig.basedir | 这是将 Learn 安装到目标位置的目录。通常为 /usr/local/blackboard 或 C:/blackboard |
bbconfig.file.license | 这是要在安装 Learn 时使用的 Blackboard 许可证的完整路径 |
bbconfig.java.home | 这是 Java 8 目录的完整路径,如 /usr/local/jdk1.8.0_60 |
bbconfig.appserver.fullhostname | Learn 应用程序服务器的完整主机名 |
bbconfig.admin.email | 管理员电子邮件地址 |
bbconfig.smtpserver.hostname | SMTP 邮件服务器的主机名 |
bbconfig.inst.name | 机构名称 |
bbconfig.inst.city | 机构所在的城市 |
bbconfig.inst.state | 机构所在的州 |
bbconfig.inst.zip | 机构使用的邮政编码 |
bbconfig.inst.country | 机构所在的国家/地区 |
bbconfig.inst.type | 机构类型:开发人员、基础教育、公司、NAHE、INTL 等 |
antargs.default.users.integration.password | 用户“集成”的密码,用于快照集成 |
antargs.default.users.rootadmin.password | 用户“root_admin”的密码,用于失效的虚拟安装功能 |
antargs.default.users.administrator.password | 用户“管理员”的密码 |
antargs.default.users.guest.password | 用户“访客”的密码 |
bbconfig.database.datadir | 存放数据库文件的目录。它必须位于 Blackboard 安装目录之外。 |
bbconfig.database.type | 数据库的类型。必须为 mssql 或 oracle。 |
bbconfig.database.server.instancename | 数据库的实例名称 |
bbconfig.database.server.fullhostname | 数据库服务器的完整主机名 |
bbconfig.database.server.systemuserpassword | 数据库服务器的系统密码 |
antargs.default.vi.db.password | BBLEARN 数据库密码 |
antargs.default.vi.stats.db.password | BBLEARN_stats 数据库密码 |
antargs.default.vi.report.user.password | BBLEARN_report 数据库密码 |
bbconfig.database.admin.password | BBLEARN_admin 数据库密码 |
bbconfig.cs.db.cms-user.pass | BBLEARN_cms 和 BBLEARN_cms_doc 数据库密码 |
bbconfig.database.server.instancenametype.oracle | Oracle SID 或 SERVICE_NAME |
bbconfig.oracle.client.drivertype | Oracle 驱动程序类型,如“thin” |
bbconfig.database.indexdir.oracle | 存放 Oracle 索引的目录 |
bbconfig.server.type | 安装的服务器类型。仅在您的 Learn 环境具有生产模式移动注册时,才需要此属性。如果未将此属性设置为 PRODUCTION,则移动注册可能默认为“测试模式”。请访问 Behind the Blackboard,详细了解这个已知问题。 |
数据目录必须适用于数据库,且目录必须提前存在。因为 Blackboard 安装目录不会在全新安装前存在,因此数据目录不得位于安装目录下方。
示例安装属性文件
下方是一个 installation.properties 文件示例。为了展示完整性,SQL Server 和 Oracle 的设置都列出来了,但请仅使用与您的安装对应的设置。
Windows
#
# Installer Overrides
#
bbconfig.basedir=C:/blackboard
bbconfig.file.license=C:/bbinstaller/license/bb-license.xml
bbconfig.java.home=C:/java/jdk1.8.0_91
#
# Shared Content folder
#
bbconfig.base.shared.dir=//filer/path/bb_content
#
# Shared Content folder
#
UNIX STYLE:
bbconfig.base.shared.dir=/mnt/shares/bb_content
#
# Explicitly set Hostname properties
#
bbconfig.appserver.fullhostname=dev.bbdn.local
bbconfig.appserver.machinename=dev.bbdn.local
bbconfig.collabserver.fullhostname.default=dev.bbdn.local
bbconfig.smtpserver.hostname=mail.monument.edu
#
# Use SQL Server
#
bbconfig.database.type=mssql
bbconfig.database.server.portname=1433
bbconfig.database.datadir=C:/mssql/bbdata
bbconfig.database.server.fullhostname=mssql.monument.edu
bbconfig.database.server.instancename=SQLSERVER
bbconfig.database.server.systemuserpassword=mssql
#
# Demonstrate non-required settings
#
bbconfig.tomcat.debug.enable=true
bbconfig.min.heapsize.tomcat=2048m
bbconfig.max.heapsize.tomcat=2048m
bbconfig.max.stacksize.tomcat=1M
bbconfig.jvm.options.extra.tomcat=-XX:+UseCompressedOops -XX:+DoEscapeAnalysis -Xverify:none
bbconfig.group.javascript.files=false
bbconfig.unix.max.open.files=5000
#
# Front-End Settings
#
bbconfig.frontend.fullhostname=dev.bbdn.local
bbconfig.frontend.protocol=https
bbconfig.frontend.portnumber=8443
#
# Installer-set passwords
#
antargs.default.users.guest.password=password
antargs.default.users.administrator.password=password
antargs.default.users.integration.password=password
antargs.default.users.rootadmin.password=password
antargs.default.vi.report.user.password=mssql
antargs.default.vi.db.password=mssql
antargs.default.vi.stats.db.password=mssql
antargs.default.vi.report.user.password=mssql
bbconfig.database.admin.password=mssql
bbconfig.cs.db.cms-user.pass=mssql
#
# Institution Information
#
bbconfig.admin.email=admin@monument.edu
bbconfig.inst.city=Washington
bbconfig.inst.country=USA
bbconfig.inst.name=Monument University
bbconfig.inst.state=DC
bbconfig.inst.type=NAHE
bbconfig.inst.zip=20036
Linux
#
# Installer Overrides
#
bbconfig.basedir=/usr/local/blackboard
bbconfig.file.license=/usr/local/license/bb-license.xml
bbconfig.java.home=/usr/local/jdk1.8.0_91
#
# Explicitly set Hostname properties
#
bbconfig.appserver.fullhostname=dev.bbdn.local
bbconfig.appserver.machinename=dev.bbdn.local
bbconfig.collabserver.fullhostname.default=dev.bbdn.local
bbconfig.smtpserver.hostname=mail.monument.edu
#
# Use Oracle
#
bbconfig.database.type=oracle
bbconfig.database.server.portnumber=1521
bbconfig.database.datadir=/usr/local/oracle/bbdata
bbconfig.database.indexdir.oracle=/usr/local/oracle/bbdata
bbconfig.database.server.fullhostname=oracle.monument.edu
bbconfig.database.server.instancename=ORACLE.monument.edu
bbconfig.database.server.instancenametype.oracle=BBLEARN
bbconfig.database.server.systemuserpassword=oracle
bbconfig.oracle.client.drivertype=thin
#
# Demonstrate non-required settings
#
bbconfig.tomcat.debug.enable=true
bbconfig.min.heapsize.tomcat=2048m
bbconfig.max.heapsize.tomcat=2048m
bbconfig.max.stacksize.tomcat=1M
bbconfig.jvm.options.extra.tomcat=-XX:+UseCompressedOops -XX:+DoEscapeAnalysis -Xverify:none
bbconfig.group.javascript.files=false
bbconfig.unix.max.open.files=5000
#
# Front-End Settings
#
bbconfig.frontend.fullhostname=dev.bbdn.local
bbconfig.frontend.protocol=https
bbconfig.frontend.portnumber=8443
#
# Installer-set passwords
#
antargs.default.users.guest.password=password
antargs.default.users.administrator.password=password
antargs.default.users.integration.password=password
antargs.default.users.rootadmin.password=password
antargs.default.vi.report.user.password=oracle
antargs.default.vi.db.password=oracle
antargs.default.vi.stats.db.password=oracle
antargs.default.vi.report.user.password=oracle
bbconfig.database.admin.password=oracle
bbconfig.cs.db.cms-user.pass=oracle
#
# Institution Information
#
bbconfig.admin.email=admin@monument.edu
bbconfig.inst.city=Washington
bbconfig.inst.country=USA
bbconfig.inst.name=Monument University
bbconfig.inst.state=DC
bbconfig.inst.type=NAHE
bbconfig.inst.zip=20036
升级
2016 年第二季度版本包含 ActiveMQ 的升级。在执行升级前 ACTIVEMQ_MSGS 表格中没有任何内容非常重要。如果您是自托管客户且需要此操作方面的协助,请通过客户支持寻求帮助。
如果升级现有的 Blackboard Learn 安装,则必需参数列表中值的下限应更小。
下方是一个包含最小值属性的示例 installer.properties 文件:
Windows
# Minimum Required Parameters for Upgrade to Q2 2016
antargs.default.vi.db.password=######
antargs.default.users.administrator.password=######
antargs.default.users.integration.password=######
antargs.default.users.rootadmin.password=######
bbconfig.basedir=C:/blackboard
bbconfig.file.license=C:/license/blackboard-license.xml
bbconfig.java.home=C:/java/jdk1.8.0_91
Linux
# Minimum Required Parameters for Upgrade to Q2 2016
antargs.default.vi.db.password=######
antargs.default.users.administrator.password=######
antargs.default.users.integration.password=######
antargs.default.users.rootadmin.password=######
bbconfig.basedir=/usr/local/blackboard
bbconfig.file.license=/usr/local/license/blackboard-license.xml
bbconfig.java.home=/usr/local/jdk1.8.0_91
请注意,使用“######”作为密码。在您升级已感知这些参数值的现有系统时,升级流程应该会忽略此类值。 antargs.default.vi.db.password 的值应与 bb-config.properties 文件中的参数匹配。
升级完成后,您可以将任何定制 jvm 选项重新添加到 bb-config.properties 文件并运行 PushConfigUpdates。Java 8 弃用了几个 JVM 选项。