Caso você seja um cliente de Hospedagem gerenciada, este tópico não se aplica a você.

A partir da versão Q2 2016, o instalador do Blackboard Learn 9.1 será baseado em Gradle and Maven. O processo de instalação mudou, mas está ficando mais simples. O novo instalador é executado totalmente a partir da linha de comando. As propriedades do Blackboard Learn são pré-configuradas em um arquivo simples junto com algumas definições para definir o processo de instalação. Existem várias entradas exigidas no arquivo. A maioria das configurações tem um valor padrão razoável que só exigirá uma entrada se você precisar alterá-la.


Preparação das propriedades do instalador

O novo instalador do Blackboard Learn não tem uma Interface de usuário. Dessa forma, não existem formulários disponíveis para recolher os dados no momento da instalação. Para especificar essas informações, o instalador requer um arquivo simples que contém as informações de configuração previamente inserida durante a instalação. Para efeito neste documento, o arquivo de configuração será nomeado installation.properties, mas não existe um requisito para um nome de arquivo em particular já que o caminho completo para o arquivo é passado no script de instalação como um argumento de linha de comando

Existem vários parâmetros exigidos pelo instalados, e um sub-conjunto de parâmetros exigidos que vão depender do banco de dados que o sistema vai utilizar.


Instalação nova

PropriedadeDescrição
bbconfig.basedirEste é o diretório no qual instalar o Learn. Geralmente /usr/local/blackboard ou C:/blackboard
bbconfig.file.licenseEste é o caminho completo para a licença do Blackboard usar na instalação do Learn
bbconfig.java.homeEste é o caminho completo para o diretório do Java 8, isto é /usr/local/jdk1.8.0_60
bbconfig.appserver.fullhostnameO nome de host completo do Servidor de aplicativo do Learn
bbconfig.admin.emailEndereço de e-mail do administrador
bbconfig.smtpserver.hostnameO nome de host do servidor de e-mail SMTP
bbconfig.inst.nameNome da instituição
bbconfig.inst.cityCidade da instituição
bbconfig.inst.stateEstado de instituição
bbconfig.inst.zipCEP da instituição
bbconfig.inst.countryPaís da instituição
bbconfig.inst.typeTipo de instituição: Desenvolvedor, Ensino fundamental, Corporativo, NAHE, INTL, etc.
antargs.default.users.integration.passwordSenha da "integração" do usuário, usada na integração do instantâneo
antargs.default.users.rootadmin.passwordSenha do usuário 'root_admin', usada no recurso extinto Instalação Virtual
antargs.default.users.administrator.passwordSenha o usuário 'administrador'
antargs.default.users.guest.passwordSenha do usuário 'convidado'
bbconfig.database.datadirO diretório onde serão colocados os arquivos de banco de dados. Isso deve existir fora do diretório da instalação do Blackboard.
bbconfig.database.typeO tipo de banco de dados. Deve ser mssql ou oracle.
bbconfig.database.server.instancenameO nome da instância do banco de dados
bbconfig.database.server.fullhostnameO nome de host completo do servidor do banco de dados
bbconfig.database.server.systemuserpasswordA senha do sistema do servidor do banco de dados
antargs.default.vi.db.passwordSenha do banco de dados BBLEARN
antargs.default.vi.stats.db.passwordSenha do banco de dados BBLEARN_stats
antargs.default.vi.report.user.passwordSenha do banco de dados BBLEARN_report
bbconfig.database.admin.passwordSenha do banco de dados BBLEARN_admin
bbconfig.cs.db.cms-user.passSenha do banco de dados BBLEARN_cms e BBLEARN_cms_doc
bbconfig.database.server.instancenametype.oracleO Oracle SID ou SERVICE_NAME
bbconfig.oracle.client.drivertypeO Oracle Driver Type, isto é, 'thin'
bbconfig.database.indexdir.oracleO diretório que hospeda os indicadores da Oracle
bbconfig.server.typeTipo de servidor para a instalação. Essa propriedade é necessária somente se o ambiente Learn possui um registro móvel do MODO DE PRODUÇÃO. O registro móvel pode ser definido como MODO DE TESTE se essa propriedade não for configurada como PRODUCTION. Visite o Behind the Blackboard para saber mais sobre esse problema.

O diretório de dados deve estar disponível no banco de dados e o diretório DEVE existir antes do tempo. Como o diretório de instalação do Blackboard não existirá antes de uma instalação limpa, o diretório de dados NÃO DEVE estar no diretório de instalação.

Arquivo de amostra das propriedades de instalação

O seguinte exemplo mostra como um arquivo installation.properties deve se parecer. Para concluir, as configurações do servidor SQL e da Oracle estão listados, mas só use o que corresponda a sua instalação.

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


Atualização

A versão Q2 2016 contém uma atualização do ActiveMQ. É importante que a tabela ACTIVEMQ_MSGS esteja vazia antes de fazer sua atualização. Se você for um cliente de auto-hospedado e precisar de ajuda com essa ação, abra um caso do Suporte ao cliente.

Se estiver atualizando uma instalação existente do Blackboard Learn, o número mínimo de parâmetros exigidos na lista será bem menor.

Aqui está um exemplo do arquivo installer.properties que contém as propriedades mínimas:

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

Observe o uso de '######' como as senhas. O processo de atualização deve ignorar os valores nesses parâmetros, já que você está atualizando e o sistema atual já conhece esses valores. O valor de antargs.default.vi.db.password deve corresponder ao parâmetro do seu arquivo bb-config.properties.

Quando a atualização for concluída, será possível adicionar opções personalizadas JVM de volta ao arquivo bb-config.properties e executar PushConfigUpdates. O Java 8 desativou várias opções JVM.

Mais sobre o Java 8