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

В программе установки 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 задан РАБОЧИЙ РЕЖИМ регистрации на мобильных устройствах. Если для этого свойства не задан рабочий режим (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

#
# 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


Обновить

Выпуск за 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