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.basedir | Répertoire dans lequel installer Learn. En général /usr/local/blackboard ou C:/blackboard |
| bbconfig.file.license | Chemin complet vers la licence Blackboard à utiliser lors de l'installation de Learn |
| bbconfig.java.home | Chemin complet vers le répertoire de Java 8, à savoir /usr/local/jdk1.8.0_60 |
| bbconfig.appserver.fullhostname | Nom d'hôte complet du serveur d'application Learn |
| bbconfig.admin.email | adresse e-mail de l'administrateur |
| bbconfig.smtpserver.hostname | Nom d'hôte du serveur de messagerie SMTP |
| bbconfig.inst.name | Le nom de l'établissement |
| bbconfig.inst.city | Ville de l'établissement |
| bbconfig.inst.state | État de l'établissement |
| bbconfig.inst.zip | Code postal de l'établissement |
| bbconfig.inst.country | Pays de l'établissement |
| bbconfig.inst.type | Type d'établissement : développement, scolaire, entreprise, NAHE, INTL, etc. |
| antargs.default.users.integration.password | Mot de passe pour l'utilisateur « integration », utilisé pour l'intégration d'instantané |
| antargs.default.users.rootadmin.password | Mot de passe pour l'utilisateur « root_admin », utilisé pour la fonctionnalité d'installation virtuelle par défaut |
| antargs.default.users.administrator.password | Mot de passe pour l'utilisateur « administrator » |
| antargs.default.users.guest.password | Mot de passe pour l'utilisateur « guest » |
| bbconfig.database.datadir | Ré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.type | Type de base de données. Doit être mssql ou oracle. |
| bbconfig.database.server.instancename | Nom de l'instance de la base de données |
| bbconfig.database.server.fullhostname | Nom d'hôte complet du serveur de base de données |
| bbconfig.database.server.systemuserpassword | Mot de passe système pour le serveur de base de données |
| antargs.default.vi.db.password | Mot de passe de la base de données BBLEARN |
| antargs.default.vi.stats.db.password | Mot de passe de la base de données BBLEARN_stats |
| antargs.default.vi.report.user.password | Mot de passe de la base de données BBLEARN_report |
| bbconfig.database.admin.password | Mot de passe de la base de données BBLEARN_admin |
| bbconfig.cs.db.cms-user.pass | Mot de passe des bases de données BBLEARN_cms et BBLEARN_cms_doc |
| bbconfig.database.server.instancenametype.oracle | NOM_DU_SERVICE ou SID Oracle |
| bbconfig.oracle.client.drivertype | Type de pilote Oracle, par exemple « thin » |
| bbconfig.database.indexdir.oracle | Répertoire qui héberge les index Oracle |
| bbconfig.server.type | Type 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
#
# 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
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 dans 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.
