ASR for Managed Hosting

Advanced System Reporting (ASR)Overview

Blackboard Consulting

Advanced System Reporting Overview

Overview of Advanced System Reporting Function Data Installation and SetupAdvanced System Reporting: Sample TemplatesAdvanced System Reporting Database AttributesAuto-Reporting OptionsSend System Statistics to BlackboardHow to allow Clients access to Stats DatabaseHow to verify access to Stats DatabaseHow to pull stats without Crystal Reports

Advanced System Reporting

Robust reporting to understand how their system is being used

Data from predefined fields in the bb_bb60_stats database is used to create and tailor reports to meet specific institutional needs

These reports assist in understanding and analyzing use of the system and can report information such as:– when different types of users access the system– how they use the system– if the system improves Student performance.

Function Where does the data come from?

Data is transferred nightly into a separate reporting database.Nightly job executed from the bb-task.xml file

From the bb_bb60 schema to the bb_bb60_stats

Function (cont.)Data from the bb_bb60 schema is transferred into the bb_bb60_stats to handle the Advanced System Reporting tool.

The following are the tables from the bb_bb60 Schema that is then transferred nightly to the bb_bb60_stats schema:

Function (cont.)

By default the scheduling of the data transfer occurs at 1am which is typically where low load is seen on the app1 server.

System Administrators have access to the stats database to use the Crystal Reports template that Blackboard provides to develop reports to suit their Institutional needs.

Data Data transferred to statistics database is a sub-set of data from production database.

The bb_bb60 is the main database also referred to as the “Production Database”The bb_bb60_stats is the statistical database where the a sub-set of the tables below get transferred into nightly:

SID

bb_bb60 bb_bb60_stats

Data (cont.)How to verify Purge of data:

View the “update-tool-log.txt” located in the /usr/local/blackboard/logs/update-tools directory

Installation and Setup Advanced System Reporting is set up automatically when the Blackboard Academic Suite is installed.The Enable Event Tracking option must be set to Yes on the Auto-Reporting Options page before Statistics will be recorded. (default it is on.)

Purging data in the databases

Every day automatic process runs that synchronizes the sub-set of data in the stats database with the data in the main database.

Once the synchronization is complete the statistical data is deleted from the main database that is more than 180 days old.

Purging data in the databases (cont.)

The synchronization process only occurs for Enterprise licenses. For Basic clients any data older than 180 (default setting) simply gets deleted.

The synchronization process can be run at any time using the PurgeAccumulator tool.- Location> /usr/local/blackboard/tools/admin- Cmd> ./PurgeAccumulator.sh <command>

<Virtual_Installation> <days_or_date>

Purging data in the databases (cont.)

Advanced System Reporting: Sample Templates

Bb Academic Suite includes a set of ASR templates for use with Crystal Reports

Template use requires license for Crystal reports from Crystal Decisions Inc.

Advanced System Reporting Database Attributes

The following excerpts diagrams details the shared rows in the reporting database tables.The relationship between the tables is used to define and return customized data reports.

Advanced System Reporting Database Attributes (cont.)

ACTIVITY_ACCUMULATOR

PK1EVENT_TYPEUSER_PK1COURSE_PK1GROUP_PK1FORUM_PK1INTERNAL_HANDLECONTENT_PK1DATATIMESTAMPSTATUSMESSAGESSESSION_ID

APPLICATION

PK1APPLICATIONLARGE_ICONPLUGINS_PK1ENABLED_MASKSSL_INDRELABEL_INDLABELSMALL_ICONTYPEDESCRIPTIONALLOW_GUEST_MASKALLOW_OBSERVER_MASKNAMECAN_RELABEL_INDCAN_ALLOW_GUEST_INDCAN_ALLOW_OBSERVER_INDCAN_CONFIGURE_INDCONFIGURE_URL

COURSE_ROLES

PK1COURSE_ROLENAMEDEFAULT_NAMEORG_NAMEORG_DEFAULT_NAME

COURSE_USERS

PK1CRSMAIN_PK1DATA_SRC_PK1ROLELINK_NAME_1LINK_URL_1LINK_DESC_1LINK_NAME_2LINK_URL_2LINK_DESC_2LINK_NAME_3LINK_URL_3LINK_DESC_3USERS_PK1PHOTO_LINKINTRONOTEPINFOCARTRIDGE_INDAVAILABLE_INDSOS_ID_PK2ROW_STATUSENROLLMENT_DATECRSMAIN_SOS_ID_PK2USERS_SOS_ID_PK2DTMODIFIED

INSTITUTION_ROLES

PK1ROLE_NAME

COURSES

PK1BUTTONSTYLES_PK1CARTRIDGE_PK1CLASSIFICATIONS_PK1DATA_SRC_PK1SOS_ID_PK2DTCREATEDDTMODIFIEDCOURSE_NAMECOURSE_IDCOURSE_DESCROW_STATUSBATCH_UIDENROLL_OPTIONDURATIONPACESERVICE_LEVELABS_LIMITSOFT_LIMITUPLOAD_LIMITSTART_DATEEND_DATEENROLL_START_DATEENROLL_END_DATEDAYS_OF_USEFEEENROLL_ACCESS_CODEBANNER_URLINSTITUTION_NAMEREG_LEVEL_INDNAVIGATION_STYLETEXTCOLORBACKGROUND_COLORCOLLAPSIBLE_INDCATALOG_INDLOCKOUT_INDDESC_PAGE_INDAVAILABLE_INDALLOW_OBSERVER_INDLOWER_COURSE_ID

DATA_SOURCE

PK1DTMODIFIEDROW_STATUSBATCH_UIDDESCRIPTION

NAVIGATION_ITEM

PK1APPLICATIONINTERNAL_HANDLEENTITLEMENT_UIDFAMILYHREFENABLED_MASKCOMPONENT_TYPENAVIGATION_TYPESRCLABELDESCRIPTIONSUB_GROUPPOSITIONLAUNCH_INDREDIRECT_URLUSER_LABELVISIBLE_IND

SYSTEM_ROLES

PK1SYSTEM_ROLENAMEDEFAULT_NAME

SYSTEM_TRACKING

PK1TIMESTAMPCOURSESACTIVECOURSESCARTRIDGESORGANIZATIONSACTIVEORGANIZATIONSUSERSACTIVEUSERSUSERS_ZUSERS_AUSERS_CUSERS_HUSERS_NUSERS_OUSERS_RUSERS_UACTIVE_COURSE_USERSCOURSE_USERS_BCOURSE_USERS_GCOURSE_USERS_PCOURSE_USERS_SCOURSE_USERS_TCOURSE_USERS_UINST_USERS_1INST_USERS_2INST_USERS_3INST_USERS_4INST_USERS_5INST_USERS_6INST_USERS_7INST_USERS_8INST_USERS_9INST_USERS_10INST_USERS_11INST_USERS_12INST_USERS_13INST_USERS_14INST_USERS_15INST_USERS_16INST_USERS_17INST_USERS_18INST_USERS_19INST_USERS_20PAGE_VIEWSSESSIONSCOURSE_PAGE_VIEWSSYSTEMEXTENSIONSLOGIN_ATTEMPTS_SUCCESSLOGIN_ATTEMPTS_FAILURE

USERS

PK1CITYDATA_SRC_PK1SYSTEM_ROLESOS_ID_PK2DTCREATEDDTMODIFIEDROW_STATUSBATCH_UIDUSER_IDPASSWDFIRSTNAMEMIDDLENAMELASTNAMEGENDEREDUC_LEVELBIRTHDATETITLESTUDENT_IDEMAILJOB_TITLEDEPARTMENTCOMPANYSTREET_1INSTITUTION_ROLES_PK1STREET_2STATEZIP_CODECOUNTRYB_PHONE_1B_PHONE_2H_PHONE_1H_PHONE_2M_PHONEB_FAXH_FAXWEBPAGESETTINGSCOMMERCE_ROLECDROMDRIVE_PCCDROMDRIVE_MACPUBLIC_INDADDRESS_INDPHONE_INDWORK_INDEMAIL_INDAVAILABLE_INDLAST_LOGIN_DATEIM_TYPEIM_ACCOUNT

ADVANCED SYSTEM REPORTINGBlackboard Learning SystemTM (Release 6)

NOTE: Fields in gray are database control fields© 2003 Blackboard Inc. Proprietary and Confidential

ORGANIZATIONS

PK1BUTTONSTYLES_PK1CARTRIDGE_PK1CLASSIFICATIONS_PK1DATA_SRC_PK1SOS_ID_PK2DTCREATEDDTMODIFIEDCOURSE_NAMECOURSE_IDCOURSE_DESCROW_STATUSBATCH_UIDENROLL_OPTIONDURATIONPACESERVICE_LEVELABS_LIMITSOFT_LIMITUPLOAD_LIMITSTART_DATEEND_DATEENROLL_START_DATEENROLL_END_DATEDAYS_OF_USEFEEENROLL_ACCESS_CODEBANNER_URLINSTITUTION_NAMEREG_LEVEL_INDNAVIGATION_STYLETEXTCOLORBACKGROUND_COLORCOLLAPSIBLE_INDCATALOG_INDLOCKOUT_INDDESC_PAGE_INDAVAILABLE_INDALLOW_OBSERVER_INDLOWER_COURSE_ID

This

is a

vie

w o

f Cou

rse_

Mai

n

This

is a

vie

w o

f Cou

rse_

Mai

n


Attribute Definitions– The tables below detail the attributes in each database table.

Each of the tables below includes the following columns: Attribute: The name of the attribute as it appears in the database. Data Type: The format of the information stored in the attribute

(date, varchar, etc.) Null? Indicated whether or not null values are allowed. Y indicates

that null values are allowed for the attribute, N indicates that null values are not allowed for the attribute.

Description: Explains the information stored in the attribute and its importance.


Attribute: The name of the attribute as it appears in the database.


Data Type: The format of the information stored in the attribute (date, varchar, etc.)


Null? Indicated whether or not null values are allowed. Y indicates that null values are allowed for the attribute, N indicates that null values are not allowed for the attribute.


Description: Explains the information stored in the attribute and its importance.


Event Types (Only for AA Table):– The following table lists the possible event types stored in the

ACTIVITY_ACCUMULATOR table.– The Page View column shows whether or not the activity counts as a

page view when generating statistics.


Tables:– ACTIVITY_ACCUMULATOR– COURSE_ROLES– COURSE_USERS– SYSTEM_ROLES– INSTITUTION_ROLES– USER_ROLES– APPLICATION– NAVIGATION_ITEM– USERS– COURSE_MAIN– DATA_SOURCE– SYSTEM_TRACKING

Auto-Reporting Options

Auto-reporting sends system updates to a secure Blackboard server automatically.Blackboard Support uses this information to assist the Administrator in maintaining Blackboard Academic Suite

Auto-Reporting Options (cont.)

Benefits of auto-reporting

Assist in capacity planning with Blackboard Academic Suite for future growth

Notification from Blackboard Learning System when a patch or upgrade is available

Assist system maintenance with the help of Blackboard Support staff

Send System Statistics to Blackboard

Email system statistics to Blackboard from the Send System Statistics to Blackboard page.Blackboard Support staff use system statistics to help troubleshoot problems.

How to allow Clients access to Stats Database

Client to provide you with a STATIC IP where the ASR tool will be kicked off from. Create a CR with OPS to send to Infra to open up firewall via port 1521Create a CR with OPS to create a “asr_user” for the database.Capture the following to provide to the client:

Hostname: 192.xxx.xxx.xxx (hosted database IP address)Port Number: 1521SID: Univ6Username (typically): asr_userPassword: Univ6asrpass

How to verify access to Stats Database

1. From the Windows desktop click Start, Run.2. In the resulting Run dialogue box, type "cmd" and click the OK

button.3. In the resulting command window, type telnet (hosted database

IP) 172.25.1.112 1521 and press Enter on your keyboard.

How to verify access to Stats Database (cont.)

4. You will see Connecting To 172.25.1.112 5. After a few minutes if there is a connection problem the

message above will be amended with Could not open connection to the host. This means the connection is blocked by a firewall. Arrangements must be made for the workstation to have firewall access to the database. This may involve setting up a static IP for the workstation by your IT staff and communicating this information to the institution where your database is housed.

How to pull stats without Crystal Reports

Questions and Answers??

ASR for Managed Hosting

Documents

Transcript of ASR for Managed Hosting