P. 1
32-bit_to_64-bit_Migration_Guide_for_Linux

32-bit_to_64-bit_Migration_Guide_for_Linux

|Views: 176|Likes:
Published by Chezzy Bear

More info:

Published by: Chezzy Bear on Feb 16, 2011
Copyright:Attribution Non-commercial

Availability:

Read on Scribd mobile: iPhone, iPad and Android.
download as PDF, TXT or read online from Scribd
See more
See less

11/15/2011

pdf

text

original

Sections

  • Contents
  • 32-bit to 64-bit Cross-Platform Migration for Linux
  • Using this Document
  • Scenarios
  • Scenario 1: One Server to One Server
  • Nomenclature
  • Source Server Assumptions
  • Destination Server Assumptions
  • Prepare the Source Server
  • Direct Upgrade Path
  • Indirect Upgrade path
  • Prepare the Destination Server
  • Create Directory for Blackboard Learn Application and Database Backup Files
  • Create the Blackboard Application User
  • Preparing to Transfer the Source Server Application and Database
  • Create a Blackboard Learn Application and Database Backup
  • Restoring the Blackboard Application and Database to the Destination Server
  • Scenario 2: One Server to Two Servers
  • Destination Application Server Assumptions
  • Destination Database Server Assumptions
  • Prepare the Destination Application Server
  • Create Directory for Blackboard Learn Application Backup Files
  • Create NFS Share Mount Point Mappings
  • Prepare the Destination Database Server
  • Create Directory for Blackboard Learn Database Backup Files
  • Create the Shared Content Directory Structure and NFS Shares
  • Restoring the Blackboard Content and Database to the Destination Database Server
  • Restoring the Blackboard Learn Application to the Destination Application Server
  • Scenario 3: Two Servers to Two Servers
  • Source Application Server Assumptions
  • Source Database Server Assumptions
  • Preparing to Transfer the Source Server Application
  • Create a Blackboard Learn Application Backup
  • Preparing to Transfer the Source Server Database
  • Create a Blackboard Learn Database Backup

Release 9.

1

32-bit to 64-bit Cross Platform Migration for Linux

[Type the abstract of the document here. The abstract is typically a short summary of the contents of the document. Type the abstract of the document here. The abstract is typically a short summary of the contents of the document.]

Copyright

Publication Date: July 21, 2010
Worldwide Headquarters Blackboard Inc. International Headquarters Blackboard International B.V.

650 Massachusetts Avenue NW Sixth Floor Washington, DC 20001-3796 +1 800 424 9299 toll free US & Canada +1 202 463 4860 telephone +1 202 463 4863 facsimile www.blackboard.com

Dam 27 2nd Floor 1012 JS Amsterdam The Netherlands +31 20 5206884 (NL) telephone +31 20 5206885 (NL) facsimile www.blackboard.com

Copyright © 1997-2010. Blackboard, the Blackboard logo, BbWorld, Blackboard Learn, Blackboard Transact, Blackboard Connect, the Blackboard Outcomes System, Behind the Blackboard, and ConnectED are trademarks or registered trademarks of Blackboard Inc. or its subsidiaries in the United States and other countries. U.S. Patent Numbers: 6,988,138; 7,493,396; 6,816,878. Sun™, Java™, JDK™, JVM™, JDBC™, Solaris™, Microsoft®, Windows®, Windows Server®, Windows Vista®, SQL Server®, Internet Explorer®, Oracle®, Red Hat®, Enterprise Linux®, Apple®, Mac OS®, Tiger®, Leopard®, Snow Leopard®, Safari®, Apache Tomcat™, Tomcat™, Mozilla®, Firefox®, JAWS for Windows®, VMware®, Xen™, Wimba Pronto™, Acxiom Identify-X™ are trademarks or registered trademarks of their respective owners. Other product and company names mentioned herein may be the trademarks of their respective owners. No part of the contents of this manual may be reproduced or transmitted in any form or by any means without the written permission of the publisher, Blackboard Inc.

32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.1 on Windows
©2010 Blackboard Inc. Proprietary and Confidential

Page 2

Contents

Contents
Contents ................................................................................................................................... 3 32-bit to 64-bit Cross-Platform Migration for Linux ................................................................ 5
Using this Document ............................................................................................................................... 5 Scenarios ................................................................................................................................................. 5

Scenario 1: One Server to One Server ................................................................................... 6
Nomenclature ......................................................................................................................................... 6 Source Server Assumptions ................................................................................................................... 6 Destination Server Assumptions ............................................................................................................ 7 Prepare the Source Server ..................................................................................................................... 8 Direct Upgrade Path ................................................................................................................................ 8 Indirect Upgrade path ............................................................................................................................. 8 Prepare the Destination Server .............................................................................................................. 8 Create Directory for Blackboard Learn Application and Database Backup Files ...................... 8 Create the Blackboard Application User............................................................................................. 9 Preparing to Transfer the Source Server Application and Database .............................................. 10 Create a Blackboard Learn Application and Database Backup ................................................ 10 Restoring the Blackboard Application and Database to the Destination Server.......................... 14

Scenario 2: One Server to Two Servers ................................................................................. 18
Nomenclature ....................................................................................................................................... 18 Source Server Assumptions ................................................................................................................. 18 Destination Application Server Assumptions ..................................................................................... 19 Destination Database Server Assumptions ........................................................................................ 19 Prepare the Source Server ................................................................................................................... 20 Direct Upgrade Path .............................................................................................................................. 20 Indirect Upgrade path ........................................................................................................................... 20 Prepare the Destination Application Server ...................................................................................... 21 Create Directory for Blackboard Learn Application Backup Files ................................................ 21 Create the Blackboard Application User........................................................................................... 21 Create NFS Share Mount Point Mappings ......................................................................................... 21 Prepare the Destination Database Server .......................................................................................... 22 Create Directory for Blackboard Learn Database Backup Files ................................................... 22 Create the Blackboard Application User........................................................................................... 22

32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.1 on Windows
©2010 Blackboard Inc. Proprietary and Confidential

Page 3

Contents Create the Shared Content Directory Structure and NFS Shares .................................................. 22 Preparing to Transfer the Source Server Application and Database .............................................. 23 Create a Blackboard Learn Application and Database Backup ................................................ 23 Restoring the Blackboard Content and Database to the Destination Database Server .............. 27 Restoring the Blackboard Learn Application to the Destination Application Server .................... 29

Scenario 3: Two Servers to Two Servers ................................................................................ 32
Nomenclature ....................................................................................................................................... 32 Source Application Server Assumptions ............................................................................................ 32 Source Database Server Assumptions ............................................................................................... 33 Destination Application Server Assumptions ..................................................................................... 33 Destination Database Server Assumptions ........................................................................................ 34 Prepare the Source Server ................................................................................................................... 35 Direct Upgrade Path .............................................................................................................................. 35 Indirect Upgrade path ........................................................................................................................... 35 Prepare the Destination Application Server ...................................................................................... 36 Create Directory for Blackboard Learn Application Backup Files ................................................ 36 Create the Blackboard Application User........................................................................................... 36 Create NFS Share Mount Point Mappings ......................................................................................... 36 Prepare the Destination Database Server .......................................................................................... 37 Create Directory for Blackboard Learn Database Backup Files ................................................... 37 Create the Blackboard Application User........................................................................................... 37 Create the Shared Content Directory Structure and NFS Shares .................................................. 37 Preparing to Transfer the Source Server Application ........................................................................ 38 Create a Blackboard Learn Application Backup ............................................................................ 38 Preparing to Transfer the Source Server Database ........................................................................... 39 Create a Blackboard Learn Database Backup ............................................................................... 39 Restoring the Blackboard Content and Database to the Destination Database Server .............. 42 Restoring the Blackboard Learn Application to the Destination Application Server .................... 44

32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.1 on Windows
©2010 Blackboard Inc. Proprietary and Confidential

Page 4

1 is the first release to offer an entire application and database footprint using 64-bit addressable memory. To take advantage of more addressable memory. Scenario 1 describes one server to one server migration Scenario 2 describes one server to two server migration Scenario 3 describes two servers to two server migration 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.1 on Windows ©2010 Blackboard Inc. Blackboard strongly encourages clients to deploy using 64-bit operating systems (OSs) and sub components (Java and Oracle).0 on existing hardware to Blackboard Learn 9. As with any major change to an enterprise system. The steps are detailed and every effort has been made to recreate instructions in the order a migration would logically be made. Database restore to a 64-bit machine must be completed before running the application server upgrade. Proprietary and Confidential Page 5 . All instructions in this document are based on migration to new hardware. Using this Document Significant platform changes have occurred in Blackboard Learn 9.1 instance operating on a Linux 32-bit platform to Blackboard Learn 9. This document contains information on how to migrate a Blackboard Learn 9.1 operating on a Linux 64-bit platform. Upgrading Blackboard Academic Suite 8.32-bit to 64-bit Cross Platform Migration 32-bit to 64-bit Cross-Platform Migration for Linux Blackboard Learn Release 9.0 or Blackboard Learn 9. Scenarios Three separate scenarios for making a cross platform migration are included in the documentation.1 must occur before migration. backup your data before you made any changes.1 to take advantage of 64-bit technology. Migrating to 64-bit operating systems allows institutions to deploy a 64-bit JVM with larger heap sizes that suppresses the need to run in Tomcat clustered environments.

1. these instructions must be adjusted as needed. You know your database “sys” and “system” administrator password.0. You are running the Blackboard appserver on port 8009 and the webserver on port 80.6. Your database index files directory is /usr/local/blackboard/oracle/data. update 20 is now available).407. You are running Oracle 10g Release 2 (10.0. Your log files directory is /usr/local/blackboard/logs. The destination server refers to the new server which is intended as the stand-alone migration target of this process and it is running a Red Hat Linux 5 64-bit operating system. Proprietary and Confidential .0_18 (update 18 was used as of this writing. You are running Blackboard Learn 8. Page 6 Your storage location for /courses is 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.6 32-bit at /usr/local/jdk1. You have installed Blackboard to /usr/local/blackboard. /usr/local/blackboard/content/storage/courses. Nomenclature The source server refers to the original server running your production stand-alone Blackboard instance on a Red Hat Linux 5 32-bit operating system.Scenario1: One Server to One Server Scenario 1: One Server to One Server This scenario describes how to migrate from one server running a production standalone Blackboard instance on a Red Hat Linux 5 32-bit operating system to a new server running Red Hat Linux 5 64-bit operating system. Source Server Assumptions If your configuration varies from these assumptions.1 HF1 (9. Review the nomenclature and server assumptions and adjust accordingly to fit your installation.9).475.4) and you know the instance name (ENG10R2 is used in this example).0) at a minimum and you are planning to upgrade to Blackboard Learn 9.2.1 on Windows ©2010 Blackboard Inc.0 SP6 (8. • • • • • • • • • • • • You are running Red Hat Linux 5 32-bit. Your database data files directory is /usr/local/blackboard/oracle/data. You are running the latest version of JDK 1. Your shared content location is /usr/local/blackboard/content.

32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.6 64-bit installed at /usr/local/jdk1.1 on Windows ©2010 Blackboard Inc. /usr/local/blackboard/content/storage/users. Your storage location for /orgs is /usr/local/blackboard/content/storage/orgs. You have the following Oracle 11g patches installed: p7112447. p7524366. You are running Oracle 11g Release 1 (11. You have the latest version of JDK 1.0_18 (update 18 was used as of this writing.6.0. p7272646.7) on port 1521/TCP and you know the instance name (ENG11R1 in this example). Your storage location for /users is Your collaboration server is running on TCP port 8010 and HTTP port 8011. Destination Server Assumptions • • • • You are running Red Hat Linux 5 64-bit.Scenario1: One Server to One Server • • • • • • /usr/local/blackboard/content/storage/institution. update 20 is now available).1. Proprietary and Confidential Page 7 . You know your SMTP server hostname. Your storage location for /institution is Your storage location for /library is /usr/local/blackboard/content/storage/library.

Run the Blackboard Learn 9.0 SP6 (8.539.0. Proprietary and Confidential Page 8 .1.1 HF1 (9. Run the Blackboard Learn 9.0 (9.0. 1.0) installer to upgrade the instance.0. Prepare the Destination Server This work needs to be done as a user which has been granted sudo or root permissions.407.Scenario1: One Server to One Server Prepare the Source Server Upgrade your installation from Blackboard Learn 8.0 SP2 (9. 5. Create Directory for Blackboard Learn Application and Database Backup Files Type this command: mkdir /usr/local/bb_backup 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.13) or later.0. Run the Blackboard Learn 9.9) installer to upgrade the instance Indirect Upgrade path Follow this path if you are running Blackboard Learn 9.407.9) installer to upgrade the instance. 1.1.407.0 SP6 (8.1.2) installer to upgrade the instance.0.0) installer to upgrade the instance.407.1 (9.440. Run the Blackboard Learn 9.0). 3.1 (9.0) to Blackboard Learn 9. Direct Upgrade Path Follow this path if you are running Blackboard Learn 8.475. • • Test this upgrade process before performing these actions on your production system.505.2) installer to upgrade the instance. Run the Blackboard Learn 9.1 HF1 (9.0 SP1 (9.407.1.1. Run the Blackboard Learn 9. 2.475.351. 2. 4.1 on Windows ©2010 Blackboard Inc.1 HF1 (9. This work needs to be done as a user which has been granted sudo or root permissions.0) installer to upgrade the instance.9).0. Run the Blackboard Learn 9.0 SP3 (9.

Proprietary and Confidential Page 9 .1 on Windows ©2010 Blackboard Inc.Scenario1: One Server to One Server Create the Blackboard Application User Type the following: groupadd -g 550 bbuser useradd -c "Blackboard Application User" -u 550 -g 550 bbuser passwd bbuser 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.

sql script. then you may need to follow instructions on using a split named pipe as described by Jeff Hunter at Oracle DBA Tips. where $PASSWORD is the Oracle system user password.sh services. \ bb_bb60_report. cms_files_library. ten (10) indexes and eleven (11) users to backup.log \ owner=\(bbadmin. 1. users and privileges for Blackboard Learn by creating the /usr/local/sql_backup/backup-database. bb_bb60. mkdir /usr/local/sql_backup chown oracle /usr/local/sql_backup 2. bb_bb60_stats. \ cms_files_users\) buffer=2048000 Warning: If your export is greater than 2GB in size. /usr/local/blackboard/tools/admin/ServiceController.oracle export EXPORT_DIR=/usr/local/sql_backup $ORACLE_HOME/bin/exp system/$PASSWORD \ file=$EXPORT_DIR/bb_export. Backup the tablespace definitions. \ cms_files_inst. su . Export the database data for the Blackboard application. 3. Proprietary and Confidential Page 10 .1 on Windows ©2010 Blackboard Inc. cms_doc. Create a directory to store the database backup and make sure that the oracle user has write access to the directory. set echo off set feedback off set heading off set linesize 200 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.Scenario1: One Server to One Server Preparing to Transfer the Source Server Application and Database Shut down the Blackboard Learn instance. cms_files_courses. cms_files_orgs. cms.stop Create a Blackboard Learn Application and Database Backup There are ten (10) tablespaces.dmp \ log=$EXPORT_DIR/bb_export.

sql -. dba_data_files ddf where (dt.Generate SQL Script to Recreate the Blackboard Learn Tablespaces select 'create tablespace ' || dt. -.1 on Windows ©2010 Blackboard Inc.tablespace_name = ddf. Proprietary and Confidential Page 11 .tablespace_name || ' datafile ''' || ddf.tablespace_name like 'CMS%').file_name || ''' size 100m autoextend on extent management local segment space management auto.tablespace_name and dt.Scenario1: One Server to One Server spool $EXPORT_DIR/recreate_bb_database.Generate SQL Script to Recreate the Blackboard Learn Database Users select 'create user ' || username || ' identified by values ''' || password || ''' default tablespace ' || default_tablespace || ' temporary tablespace ' || temporary_tablespace || ' quota unlimited on ' || default_tablespace || '.tablespace_name like 'BB%') or (dt.Generate SQL Script to Grant Role Privileges to the Blackboard Learn Database Users select 'grant ' || granted_role || ' to ' || grantee || '.tablespace_name = ddf. -.' from dba_users where (username like 'BB%') or (username like 'CMS%'). ' from dba_tablespaces dt.' from dba_role_privs where grantee in (select username from dba_users 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.tablespace_name and dt.

Copy the Blackboard Learn instance and database backup to the destination server. Proprietary and Confidential Page 12 .1 on Windows ©2010 Blackboard Inc.' from dba_sys_privs where grantee in (select username from dba_users where (username like 'BB%') or (username like 'CMS%') ).Scenario1: One Server to One Server where (username like 'BB%') or (username like 'CMS%') ).Generate SQL Script to Grant System Privileges to the Blackboard Learn Database Users select 'grant ' || privilege || ' to ' || grantee || '. Execute the /usr/local/sql_backup/backup-database.Closing Statement for Generated SQL Script select 'quit' from dual.sql script. Type the following commands where $DST_HOSTNAME is the destination server. cd /usr/local 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. This step deliberately excludes the database files within the /usr/local/blackboard/oracle directory tree. -. -. export EXPORT_DIR=/usr/local/sql_backup $ORACLE_HOME/bin/sqlplus "/ as sysdba" @$EXPORT_DIR/backupdatabase. spool off quit 4.oracle 5.sql su .

1 on Windows ©2010 Blackboard Inc.Scenario1: One Server to One Server rsync -avz --exclude=blackboard/oracle blackboard $DST_HOSTNAME:/usr/local/bb_backup rsync -avz sql_backup $DST_HOSTNAME:/usr/local/bb_backup 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Proprietary and Confidential Page 13 .

exit $ORACLE_HOME/bin/sqlplus "/ as sysdba" \ @$EXPORT_DIR/recreate_bb_database.oracle export EXPORT_DIR=/usr/local/bb_backup/sql_backup sqlplus "/ as sysdba" alter system set db_create_file_dest='/usr/local/blackboard/oracle/data'.dmp \ log=$EXPORT_DIR/bb_import. but the import will complete successfully and the warnings can be safely ignored: IMP-00041: Warning: object created with compilation warnings full=y buffer=2048000 3.oracle 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. sqlplus "/ as sysdba" su . $DB_INSTANCE should be replaced with your database instance name and $DOMAIN should be replaced with your DNS domain name. There are ten (10) tablespaces. Reconfigure the Blackboard Learn configuration parameters within the restored database. $DST_APP_HOSTNAME should be replaced with the unqualified hostname of the destination application server.log \ Note: There are multiple warnings of this type.Scenario1: One Server to One Server Restoring the Blackboard Application and Database to the Destination Server 1. $DST_DB_HOSTNAME should be replaced with the unqualified hostname of the destination database server.sql $ORACLE_HOME/bin/imp system/$PASSWORD \ file=$EXPORT_DIR/bb_export. Proprietary and Confidential Page 14 . su .1 on Windows ©2010 Blackboard Inc. Move the Blackboard Learn files to their proper location using these commands. Restore the database. ten (10) indexes and eleven (11) users to restore. mv /usr/local/bb_backup/blackboard /usr/local mkdir -p /usr/local/blackboard/oracle/data chown -R bbuser /usr/local/blackboard chown oracle /usr/local/blackboard/oracle/data 2.

win=\\usr\\l ocal\\blackboard\\content bbconfig.machinename=$DST_H OSTNAME bbconfig.fullhostname=$DST_ HOSTNAME.$DOMAIN bbconfig. Proprietary and Confidential . exit 4.fullhostname.java. Note that this is a single line in the file. Reconfigure Blackboard Property Files.home. it was broken up here for readability. Double back slashes required.shared. • File /usr/local/blackboard/config/bb-config.$DOMAIN bbconfig. 0_18 bbconfig.collabserver.$DOMAIN :1521:$DB_INSTANCE Update server name and SQL Server instance name. There are 28 properties across three (3) files that must be updated or verified. unqualified Set the appserver domain name Update the SMTP server.java.smtpserver.home=/usr/local/jdk1. fully qualified Set the collaboration server Page 15 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Check the shared content location Check the shared content location.dir.0_18 bbconfig.appserver.Scenario1: One Server to One Server update bbadmin.appserver.de Update JDK location.$DOMAIN'. • $DST_HOSTNAME needs to be replaced with the unqualified hostname of the destination server. Double back slashes required.base.BB_CONFIG_REGISTRY set HOSTNAME = '$DST_APP_HOSTNAME.domainname=$DOMAIN bbconfig.1 on Windows ©2010 Blackboard Inc. fully qualified Set the appserver hostname. File /usr/local/blackboard/apps/xythos/xythos.shared. $DB_INSTANCE needs to be replaced with your database instance name and $DOMAIN needs to be replaced with your DNS domain • name. fully qualified Set the appserver machine name.6.webserver.6.appserver. if necessary. if necessary Update JDK location.win=\\usr\\local\\ jdk1.$DOMAIN bbconfig. if necessary.fullhostname=$DST_ HOSTNAME.BaseJDBCConnectionURL= jdbc:oracle:thin:@$DST_HOSTNAME.base.properties Property Purpose bbconfig.dir=/usr/local/b lackboard/content bbconfig.hostname=$SMTP_HO STNAME. Set the webserver hostname.properties Property Purpose Xythos.

Double back slashes required.external.storage.server.inst=/usr/l ocal/blackboard/content/storage/insti tution bbconfig.Scenario1: One Server to One Server Property Purpose fault=$DST_HOSTNAME.data.$DOMAIN bbconfig.server.orgs=/usr/l ocal/blackboard/content/storage/orgs bbconfig. Set the database server hostname. Proprietary and Confidential Page 16 .users=/usr/ local/blackboard/content/storage/user s bbconfig.server.name=$ DST_HOSTNAME.indexdir.logdir.external.name=$DST_HO STNAME bbconfig.mssql=\\usr\ \local\\blackboard\\oracle\\data bbconfig.data. fully qualified Set the database server instance name Set the database stats server hostname. fully qualified Check the database data directory Check the database data directory.cs.database.stats.data.win=\\usr\\ local\\blackboard\\oracle\\data bbconfig.external.server. Check the database index directory Enable 64bit binaries Enable 64bit libraries Check the courses shared content location Check the institution share content location Check the library shared content location Check the orgs shared content location Check the users shared content location Check the storage shared content location 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.database.data.cs.data.platform.database.location =/usr/local/blackboard/content/storag e hostname.libdir=lib64 bbconfig.cs.cs.datadir.database.database.library=/us r/local/blackboard/content/storage/li brary bbconfig.cs.$DOMAIN bbconfig.instancename =$DB_INSTANCE bbconfig.$DOMAIN bbconfig.cs.external.datadir=/usr/local/ blackboard/oracle/data bbconfig.platform.64bit=true bbconfig. unqualified Set the database server hostname.external.courses=/us r/local/blackboard/content/storage/co urses bbconfig.1 on Windows ©2010 Blackboard Inc.fullhostname =$DST_HOSTNAME.database. fully qualified Check the database log directory.external.database.oracle=/us r/local/blackboard/oracle/data bbconfig.database. Double back slashes required.

1 on Windows ©2010 Blackboard Inc.sh Property Purpose set JAVA_HOME=/usr/local/jdk1. /usr/local/blackboard/tools/admin/PushConfigUpdates.0_18 Update JDK location.sh 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.Scenario1: One Server to One Server • File /usr/local/blackboard/tools/admin/PushConfigUpdates. Update the Blackboard configuration by running. if necessary 5.6. Proprietary and Confidential Page 17 .

You are running the Blackboard appserver on port 8009 and the webserver on port 80. You have installed Blackboard to /usr/local/blackboard.6. The destination database server refers to the new server which is intended as the database instance migration target of this process and it is running a Red Hat Enterprise Linux 5 64-bit operating system. update 20 is now available).32-bit to 64-bit Cross Platform Migration Scenario 2: One Server to Two Servers This scenario describes how to migrate from one server running a stand-alone production Blackboard instance on a Red Hat Enterprise Linux 5 32-bit operating system to two new servers running Red Hat Enterprise Linux 5 64-bit operating system. Proprietary and Confidential Page 18 .0) at a minimum and you are planning to upgrade to Blackboard Learn 9.1. 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. The destination application server refers to the new server which is intended as the application instance migration target of this process and it is running a Red Hat Enterprise Linux 5 64-bit operating system.1 HF1 (9. You know your database “sys” and “system” administrator password.1 on Windows ©2010 Blackboard Inc.0.407. You are running the latest version of JDK 1.0 SP6 (8.475.6 32-bit at /usr/local/jdk1. these instructions must be adjusted as needed. Your database data files directory is /usr/local/blackboard/oracle/data. You are running Oracle 10g Release 2 (10. • • • • • • • • • • You are running Red Hat Enterprise Linux 5 32-bit. You are running Blackboard Learn 8.0_18 (update 18 was used as of this writing.9). Your database index files directory is /usr/local/blackboard/oracle/data. Nomenclature The source server refers to the original server running your production stand-alone Blackboard instance on a Red Hat Enterprise Linux 5 32-bit operating system. Your shared content location is /usr/local/blackboard/content.2. Review the nomenclature and server assumptions and adjust accordingly to fit your installation.4) and you know the instance name (ENG10R2 is used in this example).0. Source Server Assumptions If your configuration varies from these assumptions.

6 64-bit installed at /usr/local/jdk1.0_18 (update 18 was used as of this writing. p7272646. Destination Database Server Assumptions • • • • • • • • You are running Red Hat Enterprise Linux 5 64-bit.6. /usr/local/blackboard/content/storage/orgs. You have the latest version of JDK 1. p7524366.7) on port 1521/TCP and you know the instance name (ENG11R1 in this example). update 20 is now available).0. /usr/local/blackboard/content/storage/institution. Your shared content location is /usr/local/bb_share/content which is shared through NFS.0_18 (update 18 was used as of this writing. /usr/local/blackboard/content/storage/users.Scenario 2: One Server to Two Servers • • • • • • • • Your log files directory is /usr/local/blackboard/logs. You have the latest version of JDK 1. Your database index files directory is /usr/local/blackboard/oracle/data. Your storage location for /courses is Your storage location for /institution is Your storage location for /library is /usr/local/blackboard/content/storage/library. Proprietary and Confidential Page 19 . You are running Oracle 11g Release 1 (11.1 on Windows ©2010 Blackboard Inc.1. update 20 is now available). Your database data files directory is /usr/local/blackboard/oracle/data. /usr/local/blackboard/content/storage/courses. Destination Application Server Assumptions • • You are running Red Hat Enterprise Linux 5 64-bit. Your storage location for /orgs is Your storage location for /users is Your collaboration server is running on TCP port 8010 and HTTP port 8011. You know your SMTP server hostname.6 64-bit installed at /usr/local/jdk1. You have the following Oracle 11g patches installed: p7112447. 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.6. You know your database “sys” and “system” administrator password.

407.1 on Windows ©2010 Blackboard Inc.539.475.0 SP1 (9.9) installer to upgrade the instance Indirect Upgrade path Follow this path if you are running Blackboard Learn 9. Run the Blackboard Learn 9.1.0 SP6 (8. Run the Blackboard Learn 9. 4.0. Direct Upgrade Path Follow this path if you are running Blackboard Learn 8.475.0 SP6 (8.0) to Blackboard Learn 9. • • Test this upgrade process before performing these actions on your production system. Run the Blackboard Learn 9. 1.1 (9. 5.1.0. 1.0) installer to upgrade the instance. Run the Blackboard Learn 9.0.1 HF1 (9. Proprietary and Confidential Page 20 .1 HF1 (9.2) installer to upgrade the instance.0 (9.0 SP3 (9.Scenario 2: One Server to Two Servers Prepare the Source Server Upgrade your installation from Blackboard Learn 8. Run the Blackboard Learn 9.407.407. 3.0) installer to upgrade the instance.0.0).440. 2.0) installer to upgrade the instance.351. 2.9) installer to upgrade the instance. 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.407.2) installer to upgrade the instance.1 (9.1.505.1.0 SP2 (9.1. This work needs to be done as a user which has been granted sudo or root permissions. Run the Blackboard Learn 9.0.407.1 HF1 (9.9). Run the Blackboard Learn 9.0.13) or later.

rw.Scenario 2: One Server to Two Servers Prepare the Destination Application Server This work needs to be done as a user which has been granted sudo or root permissions.$DOMAIN:/usr/local/bb_share/content /usr/local/blackboard/content nfs auto.wsize=8192 0 0 :wq 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.nolock. Create Directory for Blackboard Learn Application Backup Files Type this command: mkdir /usr/local/bb_backup Create the Blackboard Application User Type the following: groupadd -g 550 bbuser passwd bbuser useradd -c "Blackboard Application User" -u 550 -g 550 bbuser Create NFS Share Mount Point Mappings Type the following: vi /etc/fstab $DST_DB_HOSTNAME.rsize=8192.timeo=60.intr.1 on Windows ©2010 Blackboard Inc. Proprietary and Confidential Page 21 .soft.

Create Directory for Blackboard Learn Database Backup Files Type this command: mkdir /usr/local/bb_backup Create the Blackboard Application User The numeric user ID should be the same as it is on the destination application server.Scenario 2: One Server to Two Servers Prepare the Destination Database Server This work needs to be done as a user which has been granted sudo or root permissions. Proprietary and Confidential Page 22 .$DOMAIN(rw.anonuid=550.anongid=550) :wq exportfs -r exportfs -v 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Type the following: groupadd -g 550 bbuser passwd bbuser useradd -c "Blackboard Application User" -u 550 -g 550 bbuser Create the Shared Content Directory Structure and NFS Shares mkdir -p /usr/local/bb_share/content chown -R bbuser /usr/local/bb_share vi /etc/exports /usr/local/bb_share/content $DST_APP_HOSTNAME.1 on Windows ©2010 Blackboard Inc.

3. then you may need to follow instructions on using a split named pipe as described by Jeff Hunter at Oracle DBA Tips. \ bb_bb60_report. bb_bb60. bb_bb60_stats. cms_files_orgs.sh services.Scenario 2: One Server to Two Servers Preparing to Transfer the Source Server Application and Database Shut down the Blackboard Learn instance. Create a directory to store the database backup and make sure that the oracle user has write access to the directory.oracle export EXPORT_DIR=/usr/local/sql_backup $ORACLE_HOME/bin/exp system/$PASSWORD \ file=$EXPORT_DIR/bb_export. users and privileges for Blackboard Learn by creating the /usr/local/sql_backup/backup-database. /usr/local/blackboard/tools/admin/ServiceController. Backup the tablespace definitions.1 on Windows ©2010 Blackboard Inc. Proprietary and Confidential Page 23 . cms. mkdir /usr/local/sql_backup chown oracle /usr/local/sql_backup 2.dmp \ log=$EXPORT_DIR/bb_export. cms_files_courses. \ cms_files_users\) buffer=2048000 Warning: If your export is greater than 2GB in size. \ cms_files_inst. Export the database data for the Blackboard application. su . ten (10) indexes and eleven (11) users to backup. cms_doc. set echo off set feedback off set heading off set linesize 200 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. 1.log \ owner=\(bbadmin. where $PASSWORD is the Oracle system user password.stop Create a Blackboard Learn Application and Database Backup There are ten (10) tablespaces. cms_files_library.sql script.

tablespace_name and dt.tablespace_name || ' datafile ''' || ddf.Generate SQL Script to Recreate the Blackboard Learn Database Users select 'create user ' || username || ' identified by values ''' || password || ''' default tablespace ' || default_tablespace || ' temporary tablespace ' || temporary_tablespace || ' quota unlimited on ' || default_tablespace || '. dba_data_files ddf where (dt.tablespace_name and dt.Scenario 2: One Server to Two Servers spool $EXPORT_DIR/recreate_bb_database.tablespace_name like 'CMS%'). Proprietary and Confidential Page 24 .sql -.' from dba_role_privs where grantee in (select username from dba_users 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.1 on Windows ©2010 Blackboard Inc. -.file_name || ''' size 100m autoextend on extent management local segment space management auto.Generate SQL Script to Recreate the Blackboard Learn Tablespaces select 'create tablespace ' || dt.tablespace_name = ddf.tablespace_name = ddf.tablespace_name like 'BB%') or (dt.Generate SQL Script to Grant Role Privileges to the Blackboard Learn Database Users select 'grant ' || granted_role || ' to ' || grantee || '. ' from dba_tablespaces dt. -.' from dba_users where (username like 'BB%') or (username like 'CMS%').

sql script.Closing Statement for Generated SQL Script select 'quit' from dual.Generate SQL Script to Grant System Privileges to the Blackboard Learn Database Users select 'grant ' || privilege || ' to ' || grantee || '. Copy the Blackboard Learn Application instance to the destination Application server. Proprietary and Confidential Page 25 .Scenario 2: One Server to Two Servers where (username like 'BB%') or (username like 'CMS%') ). -. export EXPORT_DIR=/usr/local/sql_backup $ORACLE_HOME/bin/sqlplus "/ as sysdba" @$EXPORT_DIR/backupdatabase. This step deliberately excludes the database files within the /usr/local/blackboard/oracle directory and the content files within the /usr/local/blackboard/content directory.1 on Windows ©2010 Blackboard Inc. -.sql su . Execute the /usr/local/sql_backup/backup-database. 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Type the following commands where $DST_APP_HOSTNAME is the destination Application server. spool off quit 4.' from dba_sys_privs where grantee in (select username from dba_users where (username like 'BB%') or (username like 'CMS%') ).oracle 5.

Type the following commands where $DST_DB_HOSTNAME is the destination Database server.1 on Windows ©2010 Blackboard Inc. Copy the Blackboard Learn Content and Database instance to the destination Database server. Proprietary and Confidential Page 26 . cd /usr/local rsync -avz blackboard/content $DST_DB_HOSTNAME:/usr/local/bb_backup rsync -avz sql_backup $DST_DB_HOSTNAME:/usr/local/bb_backup 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.Scenario 2: One Server to Two Servers cd /usr/local rsync -avz --exclude=blackboard/oracle \ $DST_APP_HOSTNAME:/usr/local/bb_backup --exclude=blackboard/content blackboard \ 6.

Restore the database. Proprietary and Confidential Page 27 .dmp \ log=$EXPORT_DIR/bb_import.log \ Note: There are multiple warnings of this type. exit $ORACLE_HOME/bin/sqlplus "/ as sysdba" \ @$EXPORT_DIR/recreate_bb_database. su . $DST_DB_HOSTNAME should be replaced with the unqualified hostname of the destination database server. Move the Blackboard Learn files to their proper location using these commands. sqlplus "/ as sysdba" su .sql $ORACLE_HOME/bin/imp system/$PASSWORD \ file=$EXPORT_DIR/bb_export.oracle 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Reconfigure the Blackboard Learn configuration parameters within the restored database. $DB_INSTANCE should be replaced with your database instance name and $DOMAIN should be replaced with your DNS domain name. There are ten (10) tablespaces.oracle export EXPORT_DIR=/usr/local/bb_backup/sql_backup sqlplus "/ as sysdba" alter system set db_create_file_dest='/usr/local/blackboard/oracle/data'. but the import will complete successfully and the warnings can be safely ignored: IMP-00041: Warning: object created with compilation warnings full=y buffer=2048000 3. mv /usr/local/bb_backup/content /usr/local/bb_share mkdir -p /usr/local/blackboard/oracle/data chown -R bbuser /usr/local/blackboard chown oracle /usr/local/blackboard/oracle/data chown -R bbuser /usr/local/bb_share 2. $DST_APP_HOSTNAME should be replaced with the unqualified hostname of the destination application server.1 on Windows ©2010 Blackboard Inc.Scenario 2: One Server to Two Servers Restoring the Blackboard Content and Database to the Destination Database Server 1. ten (10) indexes and eleven (11) users to restore.

Proprietary and Confidential Page 28 .1 on Windows ©2010 Blackboard Inc.$DOMAIN'. Exit 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.BB_CONFIG_REGISTRY set HOSTNAME = '$DST_APP_HOSTNAME.Scenario 2: One Server to Two Servers update bbadmin.

$DB_INSTANCE needs to be replaced with your database instance name and $DOMAIN needs • to be replaced with your DNS domain name. Check the shared content location Check the shared content location. • $DST_APP_HOSTNAME needs to be replaced with the unqualified hostname of the destination Application server. if necessary. Move the Blackboard Learn files to their proper location using these commands. Reconfigure Blackboard Property Files. $DST_DB_HOSTNAME should be replaced with the unqualified hostname of the destination Database server.Scenario 2: One Server to Two Servers Restoring the Blackboard Learn Application to the Destination Application Server 1.java. Double back slashes required.$DOM AIN:1521:$DB_INSTANCE Update server name and SQL Server instance name. Page 29 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.dir.BaseJDBCConnectionURL= jdbc:oracle:thin:@$DST_DB_HOSTNAME.shared.6.properties Property Purpose Xythos. it was broken up here for readability. Proprietary and Confidential .base.java.webserver.home. Set the webserver hostname. File /usr/local/blackboard/apps/xythos/xythos. if necessary Update JDK location.0_18 bbconfig.win=\\usr\\l ocal\\blackboard\\content bbconfig. mv /usr/local/bb_backup/blackboard /usr/local mkdir /usr/local/blackboard/content chown -R bbuser /usr/local/blackboard mount /usr/local/blackboard/content 2.1 on Windows ©2010 Blackboard Inc. Note that this is a single line in the file.shared.6. There are 28 properties across three (3) files that must be updated or verified.home=/usr/local/jdk1.dir=/usr/local/b lackboard/content bbconfig.properties Property Purpose bbconfig.win=\\usr\\local\\ jdk1. 0_18 bbconfig.base. Double back slashes required.fullhostname=$DST_ Update JDK location. • File /usr/local/blackboard/config/bb-config.

$DOMAIN bbconfig.external. fully qualified Check the database data directory Check the database data directory.external. Double back slashes required. fully qualified Set the database server instance name Set the database stats server hostname.orgs=/usr/l ocal/blackboard/content/storage/orgs fully qualified Set the appserver hostname.appserver.$DOMAIN bbconfig.cs.datadir.database.database.appserver.database.64bit=true bbconfig.logdir.hostname=$SMTP_HO STNAME.data. if necessary.database.platform.libdir=lib64 bbconfig.server.database.name=$ DST_DB_HOSTNAME.name=$DST_DB _HOSTNAME bbconfig. Double back slashes required. Proprietary and Confidential .platform.indexdir.machinename=$DST_A PP_HOSTNAME bbconfig.fullhostname.appserver. Set the database server hostname.external.1 on Windows ©2010 Blackboard Inc.$DOMAIN bbconfig. fully qualified Check the database log directory.smtpserver.$DOMAIN bbconfig.instancename =$DB_INSTANCE bbconfig.inst=/usr/l ocal/blackboard/content/storage/insti tution bbconfig.database.server.server. Check the database index directory Enable 64bit binaries Enable 64bit libraries Check the courses shared content location Check the institution share content location Check the library shared content location Check the orgs shared content location Page 30 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.fullhostname=$DST_ APP_HOSTNAME.stats.external.database.oracle=/us r/local/blackboard/oracle/data bbconfig.collabserver.Scenario 2: One Server to Two Servers Property Purpose APP_HOSTNAME. unqualified Set the appserver domain name Update the SMTP server.cs.mssql=\\usr\ \local\\blackboard\\oracle\\data bbconfig.domainname=$DOMAIN bbconfig. fully qualified Set the collaboration server hostname.$DOMAIN bbconfig.$DOMAIN bbconfig.courses=/us r/local/blackboard/content/storage/co urses bbconfig.de fault=$DST_APP_HOSTNAME.data.library=/us r/local/blackboard/content/storage/li brary bbconfig.cs.data. unqualified Set the database server hostname. fully qualified Set the appserver machine name.server.database.cs.win=\\usr\\ local\\blackboard\\oracle\\data bbconfig.datadir=/usr/local/ blackboard/oracle/data bbconfig.data.fullhostname =$DST_DB_HOSTNAME.

1 on Windows ©2010 Blackboard Inc.storage.sh Property Purpose set JAVA_HOME=/usr/local/jdk1.data. if necessary 3.cs.Scenario 2: One Server to Two Servers Property Purpose bbconfig.0_18 Update JDK location.users=/usr/ local/blackboard/content/storage/user s bbconfig.location =/usr/local/blackboard/content/storag e Check the users shared content location Check the storage shared content location File /usr/local/blackboard/tools/admin/PushConfigUpdates.6.external.sh 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.cs. /usr/local/blackboard/tools/admin/PushConfigUpdates. Update the Blackboard configuration by running.external. Proprietary and Confidential Page 31 .

6.1.0. • • • • • • • You are running Red Hat Enterprise Linux 5 32-bit. Page 32 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.475. Source Application Server Assumptions If your configuration varies from these assumptions. The source database server refers to the original database server running your production Blackboard database instance and it is running a Red Hat Enterprise Linux 5 32-bit operating system.0 SP6 (8.1 HF1 (9.0_18 (update 18 was used as of this writing.0) at a minimum and you are planning to upgrade to Blackboard Learn 9.1 on Windows ©2010 Blackboard Inc. these instructions must be adjusted as needed. You are running the Blackboard appserver on port 8009 and the webserver on port 80.6 32-bit at /usr/local/jdk1.32-bit to 64-bit Cross Platform Migration Scenario 3: Two Servers to Two Servers This scenario describes how to migrate from two servers running a production Blackboard instance on the Red Hat Enterprise Linux 5 32-bit operating system to two new servers running Red Hat Enterprise Linux 5 64-bit operating system.9). The destination database server refers to the new server which is intended as the database instance migration target of this process and it is running a Red Hat Enterprise Linux 5 64-bit operating system. You are running the latest version of JDK 1. Your log files directory is /usr/local/blackboard/logs. You are running Blackboard Learn 8. Proprietary and Confidential . You have installed Blackboard to /usr/local/blackboard. Review the nomenclature and server assumptions and adjust accordingly to fit your installation. Nomenclature The source application server refers to the original application server running your production Blackboard application instance and it is running a Red Hat Enterprise Linux 5 32-bit operating system. The destination application server refers to the new server which is intended as the application instance migration target of this process and it is running a Red Hat Enterprise Linux 5 64-bit operating system. update 20 is now available). Your shared content location is /usr/local/blackboard/content which is mapped to $SRC_DB_HOSTNAME:/usr/local/bb_share/content through NFS.407.

1 on Windows ©2010 Blackboard Inc. /usr/local/blackboard/content/storage/orgs.0_18 (update 18 was used as of this writing. You are running Oracle 10g Release 2 (10. update 20 is now available). You know your SMTP server hostname. 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Your database index files directory is /usr/local/blackboard/oracle/data. You have the latest version of JDK 1. • • • • • • You are running Red Hat Enterprise Linux 5 32-bit.0.6 64-bit installed at /usr/local/jdk1. Destination Application Server Assumptions • • You are running Red Hat Enterprise Linux 5 64-bit. these instructions must be adjusted as needed. Your shared content location is /usr/local/blackboard/content which is shared through NFS.4) and you know the instance name (ENG10R2 is used in this example). Proprietary and Confidential Page 33 .Scenario 2: Two Servers to Two Servers • • • • • • • /usr/local/blackboard/content/storage/courses. Source Database Server Assumptions If your configuration varies from these assumptions.2. Your storage location for /orgs is Your storage location for /users is Your collaboration server is running on TCP port 8010 and HTTP port 8011. Your database data files directory is /usr/local/blackboard/oracle/data. Your storage location for /courses is Your storage location for /institution is /usr/local/blackboard/content/storage/institution.6. /usr/local/blackboard/content/storage/users. You know your database “sys” and “system” administrator password. Your storage location for /library is /usr/local/blackboard/content/storage/library.

Proprietary and Confidential Page 34 . Your database data files directory is /usr/local/blackboard/oracle/data. You have the following Oracle 11g patches installed: p7112447. 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.1 on Windows ©2010 Blackboard Inc. You have the latest version of JDK 1. You know your database “sys” and “system” administrator password.Scenario 2: Two Servers to Two Servers Destination Database Server Assumptions • • • • • • • • You are running Red Hat Enterprise Linux 5 64-bit.1.6.0.0_18 (update 18 was used as of this writing. Your database index files directory is /usr/local/blackboard/oracle/data.7) on port 1521/TCP and you know the instance name (ENG11R1 in this example).6 64-bit installed at /usr/local/jdk1. p7524366. update 20 is now available). p7272646. You are running Oracle 11g Release 1 (11. Your shared content location is /usr/local/bb_share/content which is shared through NFS.

407. 4. 1.1 (9.0.1 (9.1 HF1 (9.Scenario 2: Two Servers to Two Servers Prepare the Source Server Upgrade your installation from Blackboard Learn 8.351.0). Run the Blackboard Learn 9.539.0 (9.2) installer to upgrade the instance.0 SP3 (9. 1.0 SP1 (9. • • Test this upgrade process before performing these actions on your production system. 2. Run the Blackboard Learn 9.440. 5.475. Proprietary and Confidential Page 35 .1 HF1 (9.9) installer to upgrade the instance Indirect Upgrade path Follow this path if you are running Blackboard Learn 9.505. Direct Upgrade Path Follow this path if you are running Blackboard Learn 8.0) to Blackboard Learn 9. Run the Blackboard Learn 9. Run the Blackboard Learn 9.475.1. This work needs to be done as a user which has been granted sudo or root permissions.0 SP2 (9.1 on Windows ©2010 Blackboard Inc. 2.407.0.0.407.0 SP6 (8.1. 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Run the Blackboard Learn 9.1 HF1 (9.0) installer to upgrade the instance.0) installer to upgrade the instance. Run the Blackboard Learn 9.9). Run the Blackboard Learn 9.1.0.9) installer to upgrade the instance. 3.0.407.0.2) installer to upgrade the instance.0) installer to upgrade the instance.1.407.0 SP6 (8.13) or later.1.

timeo=60.$DOMAIN:/usr/local/bb_share/content /usr/local/blackboard/content nfs auto.intr.wsize=8192 0 0 :wq 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Proprietary and Confidential Page 36 .rw.1 on Windows ©2010 Blackboard Inc.soft.nolock. Create Directory for Blackboard Learn Application Backup Files Type this command: mkdir /usr/local/bb_backup Create the Blackboard Application User Type the following: groupadd -g 550 bbuser passwd bbuser useradd -c "Blackboard Application User" -u 550 -g 550 bbuser Create NFS Share Mount Point Mappings Type the following: vi /etc/fstab $DST_DB_HOSTNAME.rsize=8192.Scenario 2: Two Servers to Two Servers Prepare the Destination Application Server This work needs to be done as a user which has been granted sudo or root permissions.

$DOMAIN(rw.Scenario 2: Two Servers to Two Servers Prepare the Destination Database Server This work needs to be done as a user which has been granted sudo or root permissions. Type the following: groupadd -g 550 bbuser passwd bbuser useradd -c "Blackboard Application User" -u 550 -g 550 bbuser Create the Shared Content Directory Structure and NFS Shares mkdir -p /usr/local/bb_share/content chown -R bbuser /usr/local/bb_share vi /etc/exports /usr/local/bb_share/content $DST_APP_HOSTNAME.1 on Windows ©2010 Blackboard Inc. Create Directory for Blackboard Learn Database Backup Files Type this command: mkdir /usr/local/bb_backup Create the Blackboard Application User The numeric user ID should be the same as it is on the destination application server. Proprietary and Confidential Page 37 .anongid=550) :wq exportfs -r exportfs -v 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.anonuid=550.

rsync -avz blackboard --exclude=blackboard/content $DST_APP_HOSTNAME:/usr/local/bb_backup 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.stop 2. Type the following commands where $DST_APP_HOSTNAME is the destination Application server. Shut down the Blackboard Learn instance.sh services. Copy the Blackboard Learn Application instance to the destination Application server. This step deliberately excludes the content information in the /usr/local/blackboard/content directory.1 on Windows ©2010 Blackboard Inc.Scenario 2: Two Servers to Two Servers Preparing to Transfer the Source Server Application Create a Blackboard Learn Application Backup 1. Proprietary and Confidential Page 38 . /usr/local/blackboard/tools/admin/ServiceController.

Create a directory to store the database backup and make sure that the oracle user has write access to the directory. bb_bb60_stats.sql -. mkdir /usr/local/sql_backup chown oracle /usr/local/sql_backup 2.sql script. \ cms_files_users\) buffer=2048000 Warning: If your export is greater than 2GB in size. cms_files_library. Proprietary and Confidential Page 39 . 3.Generate SQL Script to Recreate the Blackboard Learn Tablespaces 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. where $PASSWORD is the Oracle system user password. Export the database data for the Blackboard application. cms. su . cms_files_courses.dmp \ log=$EXPORT_DIR/bb_export.1 on Windows ©2010 Blackboard Inc. bb_bb60. set echo off set feedback off set heading off set linesize 200 spool $EXPORT_DIR/recreate_bb_database.log \ owner=\(bbadmin. cms_files_orgs. \ cms_files_inst. ten (10) indexes and eleven (11) users to backup.Scenario 2: Two Servers to Two Servers Preparing to Transfer the Source Server Database Create a Blackboard Learn Database Backup There are ten (10) tablespaces. 1. \ bb_bb60_report. users and privileges for Blackboard Learn by creating the /usr/local/sql_backup/backup-database. cms_doc.oracle export EXPORT_DIR=/usr/local/sql_backup $ORACLE_HOME/bin/exp system/$PASSWORD \ file=$EXPORT_DIR/bb_export. then you may need to follow instructions on using a split named pipe as described by Jeff Hunter at Oracle DBA Tips. Backup the tablespace definitions.

Generate SQL Script to Recreate the Blackboard Learn Database Users select 'create user ' || username || ' identified by values ''' || password || ''' default tablespace ' || default_tablespace || ' temporary tablespace ' || temporary_tablespace || ' quota unlimited on ' || default_tablespace || '. dba_data_files ddf where (dt.1 on Windows ©2010 Blackboard Inc.file_name || ''' size 100m autoextend on extent management local segment space management auto.tablespace_name like 'BB%') or (dt.tablespace_name and dt. ' from dba_tablespaces dt.tablespace_name || ' datafile ''' || ddf.' from dba_role_privs where grantee in (select username from dba_users where (username like 'BB%') or (username like 'CMS%') ). Proprietary and Confidential Page 40 .tablespace_name like 'CMS%'). -.tablespace_name and dt.Scenario 2: Two Servers to Two Servers select 'create tablespace ' || dt.Generate SQL Script to Grant Role Privileges to the Blackboard Learn Database Users select 'grant ' || granted_role || ' to ' || grantee || '. -. 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.' from dba_users where (username like 'BB%') or (username like 'CMS%').tablespace_name = ddf.tablespace_name = ddf.

Closing Statement for Generated SQL Script select 'quit' from dual.1 on Windows ©2010 Blackboard Inc. Execute the /usr/local/sql_backup/backup-database.sql script.Scenario 2: Two Servers to Two Servers -.' from dba_sys_privs where grantee in (select username from dba_users where (username like 'BB%') or (username like 'CMS%') ).sql su . spool off quit 4.oracle 5. -. Proprietary and Confidential Page 41 . export EXPORT_DIR=/usr/local/sql_backup $ORACLE_HOME/bin/sqlplus "/ as sysdba" @$EXPORT_DIR/backupdatabase. cd /usr/local rsync -avz bb_share/content $DST_DB_HOSTNAME:/usr/local/bb_backup rsync -avz sql_backup $DST_DB_HOSTNAME:/usr/local/bb_backup 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.Generate SQL Script to Grant System Privileges to the Blackboard Learn Database Users select 'grant ' || privilege || ' to ' || grantee || '. Copy the Blackboard Learn Content and Database instance to the destination Database server. Type the following commands where $DST_DB_HOSTNAME is the destination Database server.

oracle 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Move the Blackboard Learn files to their proper location using these commands. su .1 on Windows ©2010 Blackboard Inc. exit $ORACLE_HOME/bin/sqlplus "/ as sysdba" \ @$EXPORT_DIR/recreate_bb_database. $DB_INSTANCE should be replaced with your database instance name and $DOMAIN should be replaced with your DNS domain name.Scenario 2: Two Servers to Two Servers Restoring the Blackboard Content and Database to the Destination Database Server 1. mv /usr/local/bb_backup/content /usr/local/bb_share mkdir -p /usr/local/blackboard/oracle/data chown -R bbuser /usr/local/blackboard chown oracle /usr/local/blackboard/oracle/data chown -R bbuser /usr/local/bb_share 2. $DST_DB_HOSTNAME should be replaced with the unqualified hostname of the destination database server. There are ten (10) tablespaces.dmp \ log=$EXPORT_DIR/bb_import.log \ Note: There are multiple warnings of this type.sql $ORACLE_HOME/bin/imp system/$PASSWORD \ file=$EXPORT_DIR/bb_export. Reconfigure the Blackboard Learn configuration parameters within the restored database. $DST_APP_HOSTNAME should be replaced with the unqualified hostname of the destination application server. Restore the database. Proprietary and Confidential Page 42 . ten (10) indexes and eleven (11) users to restore. sqlplus "/ as sysdba" su . but the import will complete successfully and the warnings can be safely ignored: IMP-00041: Warning: object created with compilation warnings full=y buffer=2048000 3.oracle export EXPORT_DIR=/usr/local/bb_backup/sql_backup sqlplus "/ as sysdba" alter system set db_create_file_dest='/usr/local/blackboard/oracle/data'.

Scenario 2: Two Servers to Two Servers update bbadmin.BB_CONFIG_REGISTRY set HOSTNAME = '$DST_APP_HOSTNAME.1 on Windows ©2010 Blackboard Inc. Exit 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9. Proprietary and Confidential Page 43 .$DOMAIN'.

There are 28 properties across three (3) files that must be updated or verified. it was broken up here for readability. Proprietary and Confidential Page 44 .6.base.win=\\usr\\l ocal\\blackboard\\content bbconfig.fullhostname=$DST_ APP_HOSTNAME. fully qualified 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.webserver.shared. File /usr/local/blackboard/apps/xythos/xythos.home. Move the Blackboard Learn files to their proper location using these commands. if necessary.properties Property Purpose Xythos.properties Property Purpose bbconfig. Note that this is a single line in the file. Double back slashes required.win=\\usr\\local\\ jdk1.6.home=/usr/local/jdk1. if necessary Update JDK location.1 on Windows ©2010 Blackboard Inc. 0_18 bbconfig.BaseJDBCConnectionURL= jdbc:oracle:thin:@$DST_DB_HOSTNAME.java. Double back slashes required. Set the webserver hostname.$DOM AIN:1521:$DB_INSTANCE Update server name and SQL Server instance name.java.base. • $DST_APP_HOSTNAME needs to be replaced with the unqualified hostname of the destination Application server.$DOMAIN Update JDK location.shared. Check the shared content location Check the shared content location.Scenario 2: Two Servers to Two Servers Restoring the Blackboard Learn Application to the Destination Application Server 1. $DB_INSTANCE needs to be replaced with your database instance name and $DOMAIN needs • to be replaced with your DNS domain name. $DST_DB_HOSTNAME should be replaced with the unqualified hostname of the destination Database server.0_18 bbconfig. mv /usr/local/bb_backup/blackboard /usr/local mkdir /usr/local/blackboard/content chown -R bbuser /usr/local/blackboard mount /usr/local/blackboard/content 2.dir=/usr/local/b lackboard/content bbconfig.dir. • File /usr/local/blackboard/config/bb-config. Reconfigure Blackboard Property Files.

external.instancename =$DB_INSTANCE bbconfig.$DOMAIN bbconfig.platform.appserver.server. fully qualified Set the database server instance name Set the database stats server hostname.datadir=/usr/local/ blackboard/oracle/data bbconfig. Set the database server hostname. Check the database index directory Enable 64bit binaries Enable 64bit libraries Check the courses shared content location Check the institution share content location Check the library shared content location Check the orgs shared content location Check the users shared Page 45 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.$DOMAIN bbconfig. Double back slashes required. unqualified Set the database server hostname.name=$DST_DB _HOSTNAME bbconfig.database. Proprietary and Confidential .$DOMAIN bbconfig.courses=/us r/local/blackboard/content/storage/co urses bbconfig.indexdir.Scenario 2: Two Servers to Two Servers Property Purpose bbconfig.fullhostname=$DST_ APP_HOSTNAME.server.cs.stats.de fault=$DST_APP_HOSTNAME.database.cs.data.external.database.cs.cs. fully qualified Set the appserver machine name.data.fullhostname.name=$ DST_DB_HOSTNAME. fully qualified Check the database data directory Check the database data directory.collabserver.external.appserver. fully qualified Check the database log directory.1 on Windows ©2010 Blackboard Inc.database.library=/us r/local/blackboard/content/storage/li brary bbconfig.orgs=/usr/l ocal/blackboard/content/storage/orgs bbconfig.$DOMAIN bbconfig.database.server. if necessary.data.win=\\usr\\ local\\blackboard\\oracle\\data bbconfig.inst=/usr/l ocal/blackboard/content/storage/insti tution bbconfig.oracle=/us r/local/blackboard/oracle/data bbconfig.server.logdir.database.database.platform.users=/usr/ Set the appserver hostname. Double back slashes required.machinename=$DST_A PP_HOSTNAME bbconfig.data.domainname=$DOMAIN bbconfig.external.libdir=lib64 bbconfig. fully qualified Set the collaboration server hostname.hostname=$SMTP_HO STNAME.smtpserver.cs.fullhostname =$DST_DB_HOSTNAME.mssql=\\usr\ \local\\blackboard\\oracle\\data bbconfig.$DOMAIN bbconfig.datadir.external.database.appserver.64bit=true bbconfig. unqualified Set the appserver domain name Update the SMTP server.data.

Update the Blackboard configuration by running.0_18 Update JDK location.location =/usr/local/blackboard/content/storag e content location Check the storage shared content location • File Property Purpose set JAVA_HOME=/usr/local/jdk1.6.cs.sh 32-bit to 64-bit Cross Platform Migration for Blackboard Learn 9.external.Scenario 2: Two Servers to Two Servers Property Purpose local/blackboard/content/storage/user s bbconfig.1 on Windows ©2010 Blackboard Inc.storage. /usr/local/blackboard/tools/admin/PushConfigUpdates. if necessary 3. Proprietary and Confidential Page 46 .

You're Reading a Free Preview

Download
scribd
/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->