Если вы используете управляемое размещение, эта статья к вам не относится.

В программе установки Blackboard Learn 9.1, начиная со II квартала 2016 г., используются компоненты Gradle и Maven. Процесс установки был оптимизирован. Новая программа установки выполняется полностью из командной строки. Свойства Blackboard Learn предварительно заданы в неструктурированном файле вместе с новыми настройками процесса установки. Этот файл содержит только требуемые строки. Для большинства настроек по умолчанию заданы подходящие значения, поэтому ввод данных требуется только в случае, если вы хотите их изменить.


Подготовка свойств программы установки

Новая программа установки Blackboard Learn не имеет интерфейса пользователя. Поэтому сбор данных во время установки в какой-либо форме недоступен. Чтобы определить эти сведения, программе установки необходим неструктурированный файл, содержащий информацию о конфигурации, которая была предварительно введена во время установки. Файл конфигурации для целей данного документа будет иметь имя installation.properties, но требования к определенному имени файла отсутствуют, так как полный путь к файлу внесен в сценарий установки в виде аргумента командной строки.

Программе установки требуются некоторые параметры, а также набор необходимых параметров, зависящий от базы данных, используемой системой.


Новая установка

СвойствоОписание
bbconfig.basedirЭто каталог, в который будет выполнена установка Learn. Обычно /usr/local/blackboard или C:/blackboard
bbconfig.file.licenseЭто полный путь к файлу лицензии Blackboard, используемый при установке Learn
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Тип учреждения: «Разработчик», «K12», «Компания», «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 или SERVICE_NAME
bbconfig.oracle.client.drivertypeТип диска Oracle, например «тонкий»
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, так и настройки 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


Обновить

Выпуск за II квартал 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.

Когда обновление будет завершено, вы сможете добавить обратно в файл bb-config.properties любые пользовательские параметры и выполнить команду PushConfigUpdates. В Java 8 исключено несколько параметров JVM.

Подробнее о Java 8