Si es un cliente de Managed Hosting, este tema no se aplica a usted.

Comenzando por la versión del segundo trimestre de 2016, el instalador de Blackboard Learn 9.1 se basa en Gradle y Maven. El proceso de instalación se ha modificado, pero finalmente se está simplificando más. El nuevo instalador se ejecuta completamente desde la línea de comandos. Las propiedades de Blackboard Learn están preconfiguradas en un archivo sin formato junto con algunos ajustes para definir el proceso de instalación. Solo hay algunas consultas requeridas en ese archivo. La mayoría de los ajustes tienen un valor predeterminado razonable que solo requiere una entrada si usted necesita modificarlo.


Preparación de las propiedades del instalador

El nuevo instalador de Blackboard Learn no tiene una interfaz del usuario. Por lo tanto, no hay formularios disponibles para recopilar los datos en el momento de la instalación. Para especificar esta información, el instalador requiere un archivo sin formato que contenga la información de configuración anteriormente ingresada durante la instalación. A los efectos de este documento, el archivo de configuración debe tener el nombre installation.properties, pero no hay requisitos para un nombre de archivo en particular, ya que la ruta completa al archivo se transfiere al script de instalación como un argumento de línea de comandos.

El instalador requiere varios parámetros y un subconjunto de parámetros necesarios que dependen de la base de datos que el sistema utilizará.


Instalación nueva

PropiedadDescripción del
bbconfig.basedirEste es el directorio donde se debe instalar Learn. Por lo general, /usr/local/blackboard o C:/blackboard
bbconfig.file.licenseEsta es la ruta completa a la licencia de Blackboard para utilizar al instalar Learn
bbconfig.java.homeEsta es la ruta completa al directorio de Java 8, es decir, /usr/local/jdk1.8.0_60
bbconfig.appserver.fullhostnameEl nombre de host completo del servidor de aplicaciones de Learn
bbconfig.admin.emailDirección de correo electrónico del administrador
bbconfig.smtpserver.hostnameEl nombre de host del servidor de correo SMTP
bbconfig.inst.nameNombre de la institución
bbconfig.inst.cityCiudad de la institución
bbconfig.inst.stateEstado de la institución
bbconfig.inst.zipCódigo postal de la institución
bbconfig.inst.countryPaís de la institución
bbconfig.inst.typeTipo de institución: Desarrollador, K12, corporativo, NAHE, INTL, etc.
antargs.default.users.integration.passwordContraseña para el usuario 'integración', usada para la integración de la instantánea
antargs.default.users.rootadmin.passwordContraseña para el usuario 'root_admin', usada para la función de instalación virtual inactiva
antargs.default.users.administrator.passwordContraseña para el usuario 'administrador'
antargs.default.users.guest.passwordContraseña para el usuario 'invitado'
bbconfig.database.datadirEl directorio para colocar los archivos de la base de datos. Debe estar ubicado fuera del directorio de instalación de Blackboard.
bbconfig.database.typeEl tipo de base de datos. Debe ser mssql u oracle.
bbconfig.database.server.instancenameEl nombre de la instancia de la base de datos
bbconfig.database.server.fullhostnameEl nombre de host completo del servidor de la base de datos
bbconfig.database.server.systemuserpasswordContraseña del sistema del servidor de la base de datos
antargs.default.vi.db.passwordContraseña de la base de datos BBLEARN
antargs.default.vi.stats.db.passwordContraseña de la base de datos BBLEARN_stats
antargs.default.vi.report.user.passwordContraseña de la base de datos BBLEARN_report
bbconfig.database.admin.passwordContraseña de la base de datos BBLEARN_admin
bbconfig.cs.db.cms-user.passContraseña de la base de datos BBLEARN_cms y BBLEARN_cms_doc
bbconfig.database.server.instancenametype.oracleLa SID o el SERVICE_NAME de Oracle
bbconfig.oracle.client.drivertypeEl tipo de controlador de Oracle, es decir, 'delgado'
bbconfig.database.indexdir.oracleEl directorio que aloja los índices de Oracle
bbconfig.server.typeServer type for the installation. This property is only needed if your Learn environment had a PRODUCTION MODE mobile registration. Mobile registration may default to TEST MODE if this property isn't set to PRODUCTION. Visit Behind the Blackboard to learn more about this known issue.

El directorio de datos debe estar disponible para la base de datos y el directorio DEBE existir anticipadamente. Debido a que el directorio de instalación de Blackboard no existe antes de una instalación limpia, el directorio de datos NO DEBE estar en el directorio de instalación.

Ejemplo de archivo de las propiedades de la instalación

En el siguiente ejemplo se muestra cómo sería el archivo installation.properties. Para brindar la información completa, aparecen los ajustes para SQL Server y Oracle, pero usted solo debe utilizar el que corresponda con su instalación.

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


Actualización

La versión del segundo trimestre de 2016 contiene una actualización para ActiveMQ. Es importante que la tabla ACTIVEMQ_MSGS esté vacía antes de realizar la actualización. Si usted es un cliente autoalojado y necesita asistencia con esta acción, abra un caso en Asistencia al cliente.

Si está actualizando una instalación de Blackboard Learn existente, la lista de cantidades mínimas de parámetros requeridos es mucho más pequeña.

A continuación, se muestra un ejemplo de archivo installer.properties que contiene las propiedades 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 que "######" representa las contraseñas. El proceso de actualización ignora los valores en estos parámetros, ya que usted está actualizando un sistema existente que ya conoce estos valores. El valor de antargs.default.vi.db.password debe coincidir con el parámetro que aparece en el archivo bb-config.properties.

Una vez que la actualización esté completa, puede agregar cualquier opción jvm personalizada nuevamente en el archivo bb-config.properties y ejecutar un comando PushConfigUpdates. Varias opciones de JVM obsoletas de Java 8.

Más información sobre Java 8