If you are a Managed Hosting customer, this topic doesn't apply to you.
В программе установки 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.
