Подготовка свойств установщика

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

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

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

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

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

Каталог данных должен быть доступен для базы данных. Кроме того, каталог ДОЛЖЕН быть создан заранее. Так как теперь каталог установки 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