如果您是 Managed Hosting 客户,则此主题对您不适用。

自 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 选项。

有关 Java 8 的更多信息