Si vous êtes un client Managed Hosting, cette rubrique ne vous concerne pas.

À partir de la version du deuxième trimestre 2016, le programme d'installation de Blackboard Learn 9.1 repose sur Gradle et Maven. Le processus d'installation a changé, mais il devient finalement plus simple. Le nouveau programme d'installation est exécuté intégralement à partir de la ligne de commande. Les propriétés Blackboard Learn sont préconfigurées dans un fichier plat, comme quelques paramètres définissant le processus d'installation. Seules quelques entrées requises se trouvent dans ce fichier. La plupart des paramètres ont une valeur par défaut raisonnable qui peut être modifiée simplement par une entrée.


Préparation des propriétés du programme d'installation

Le nouveau programme d'installation de Blackboard Learn n'a pas d'interface utilisateur. Par conséquent, aucun formulaire n'est disponible pour la collecte de données lors de l'installation. Afin d'indiquer ces informations, le programme d'installation nécessite un fichier plat contenant les informations de configuration saisies précédemment lors de l'installation. Pour les besoins de ce document, le fichier de configuration sera nommé installation.properties, mais aucun nom de fichier particulier n'est exigé, car le chemin complet vers le fichier est communiqué au script d'installation en tant qu'argument de ligne de commande.

Plusieurs paramètres sont requis par le programme d'installation, ainsi qu'un sous-ensemble de paramètres requis dépendants de la base de données qu'utilisera le système.


Nouvelle installation

PropriétéDescription
bbconfig.basedirRépertoire dans lequel installer Learn. En général /usr/local/blackboard ou C:/blackboard
bbconfig.file.licenseChemin complet vers la licence Blackboard à utiliser lors de l'installation de Learn
bbconfig.java.homeChemin complet vers le répertoire de Java 8, à savoir /usr/local/jdk1.8.0_60
bbconfig.appserver.fullhostnameNom d'hôte complet du serveur d'application Learn
bbconfig.admin.emailAdresse électronique de l'administrateur
bbconfig.smtpserver.hostnameNom d'hôte du serveur de messagerie SMTP
bbconfig.inst.nameLe nom de l’établissement
bbconfig.inst.cityVille de l'établissement
bbconfig.inst.stateÉtat de l'établissement
bbconfig.inst.zipCode postal de l'établissement
bbconfig.inst.countryPays de l'établissement
bbconfig.inst.typeType d'établissement : développement, scolaire, entreprise, NAHE, INTL, etc.
antargs.default.users.integration.passwordMot de passe pour l'utilisateur « integration », utilisé pour l'intégration d'instantané
antargs.default.users.rootadmin.passwordMot de passe pour l'utilisateur « root_admin », utilisé pour la fonctionnalité d'installation virtuelle par défaut
antargs.default.users.administrator.passwordMot de passe pour l'utilisateur « administrator »
antargs.default.users.guest.passwordMot de passe pour l'utilisateur « guest »
bbconfig.database.datadirRépertoire où placer les fichiers de la base de données. Il doit se trouver hors du répertoire d'installation de Blackboard.
bbconfig.database.typeType de base de données. Doit être mssql ou oracle.
bbconfig.database.server.instancenameNom de l'instance de la base de données
bbconfig.database.server.fullhostnameNom d'hôte complet du serveur de base de données
bbconfig.database.server.systemuserpasswordMot de passe système pour le serveur de base de données
antargs.default.vi.db.passwordMot de passe de la base de données BBLEARN
antargs.default.vi.stats.db.passwordMot de passe de la base de données BBLEARN_stats
antargs.default.vi.report.user.passwordMot de passe de la base de données BBLEARN_report
bbconfig.database.admin.passwordMot de passe de la base de données BBLEARN_admin
bbconfig.cs.db.cms-user.passMot de passe des bases de données BBLEARN_cms et BBLEARN_cms_doc
bbconfig.database.server.instancenametype.oracleNOM_DU_SERVICE ou SID Oracle
bbconfig.oracle.client.drivertypeType de pilote Oracle, par exemple « thin »
bbconfig.database.indexdir.oracleRépertoire qui héberge les index Oracle
bbconfig.server.typeType de serveur dédié à l'installation. Cette propriété est requise uniquement si votre environnement Learn possède un enregistrement mobile de MODE DE PRODUCTION. L'enregistrement mobile peut être défini par défaut sur le MODE DE TEST si cette propriété n'est pas définie sur PRODUCTION. Accédez à Behind the Blackboard pour en savoir plus sur cette problématique connue.

Le répertoire de données doit être disponible pour la base de données et le répertoire DOIT exister au préalable. Le répertoire de données NE DOIT PAS se trouver dans le répertoire d'installation, car le répertoire d'installation Blackboard n'existe pas avant une installation propre.

Exemple de fichier de propriétés d'installation

L'exemple suivant montre à quoi peut ressembler un fichier installation.properties. Par souci d'exhaustivité, les paramètres sont répertoriés pour SQL Server et Oracle, mais n'utilisez que ceux qui correspondent à votre installation.

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


Mise à niveau

La version du deuxième trimestre 2016 comprend une mise à niveau pour ActiveMQ. Il est important que la table ACTIVEMQ_MSGS soit vide avant l'exécution de la mise à niveau. Si vous êtes un client auto-hébergé et que vous avez besoin d'assistance pour cette action, ouvrez un dossier auprès du service de support clientèle.

Si vous mettez à niveau une installation Blackboard Learn existante, le nombre minimal de paramètres requis est bien moindre.

Voici un exemple de fichier installer.properties qui contient le nombre minimal de propriétés :

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

Les symboles « ###### » sont utilisés pour signifier les mots de passe. Le processus de mise à niveau doit ignorer les valeurs de ces paramètres, car vous mettez à niveau un système existant qui les connaît déjà. La valeur pour antargs.default.vi.db.password doit correspondre au paramètre du fichier bb-config.properties.

Une fois la mise à niveau terminée, vous pouvez ajouter des options JVM personnalisées dans le fichier bb-config.properties et exécuter PushConfigUpdates. Java 8 a supprimé des options JVM.

En savoir plus sur Java 8