如果您是 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.fullhostnameLearn 应用程序服务器的完整主机名
bbconfig.admin.email管理员电子邮件地址
bbconfig.smtpserver.hostnameSMTP 邮件服务器的主机名
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.passwordBBLEARN 数据库密码
antargs.default.vi.stats.db.passwordBBLEARN_stats 数据库密码
antargs.default.vi.report.user.passwordBBLEARN_report 数据库密码
bbconfig.database.admin.passwordBBLEARN_admin 数据库密码
bbconfig.cs.db.cms-user.passBBLEARN_cms 和 BBLEARN_cms_doc 数据库密码
bbconfig.database.server.instancenametype.oracleOracle SID 或 SERVICE_NAME
bbconfig.oracle.client.drivertypeOracle 驱动程序类型,如“thin”
bbconfig.database.indexdir.oracle存放 Oracle 索引的目录
bbconfig.server.type安装的服务器类型。仅在您的 Learn 环境具有生产模式移动注册时,才需要此属性。Mobile registration may default to TEST MODE if this property isn't set to 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
#
# 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 的更多信息