|How to troubleshoot AICC Course tracking problems.|
Categories: Main Page > LearnerWeb
Last Modified: May 16, 2005 12:56 PM
Article ID: 10105
The presumption to this article is you have the AICC course loaded to the server, the AICC course launches and you are returned back to LearnerWeb. The only thing not working is tracking of progress data back into LW (LearnerWeb).
To troubleshoot you will need some basic information.
What is the Learner_ID of the user you are testing for. Ex: BAR100
What is the Course ID of course you are testing. Ex GMP300
For the purposes of this document, we will use the learner id and course id just mentioned.
Now LW creates a log of all AICC activity. It's physical location is C:\webplus\script\<yourInstanceName>\ezaic\logs. <yourInstanceName> is the name of your installed instance and is usually the company name or common abbreviation. Please note that your IT people may have installed WEBPLUS to a different physical location. This is the location of the LW Application Server.
To view the log you will either need access to the physical location, or have your IT resource map a virtual web folder to that location. If the latter, the URL will usually be http://YourDomain/aicclog/ if they followed our conventions.
Ok so now you have access to the log. You will see a lot of files in there and you want to focus on the files that are formated as follows.
aicc_YYYY-MM-DD.txt as in aicc_2005-05-11.txt. This is the log of all activity for the day. This file APPENDS to the file throughout the day. (The file can grow to 1-4MBs if there is a lot of courseware activity)
Locate the log file you want to review.
If you find the date you want and the file is blank and you are sure there was activity on the course, it's time to call MaxIT for help as something is not configured properly.
If the entries are recent, a good practice is to scroll to the bottom of the file and work up. Another good practice is to use the FIND feature (CTRL-F) to locate a learner or course ID in question. Another good practice is to copy the log to a word process if word wrapping is not available.
The file will contain a lot of text which looks like jibberish, but will make sense with a little patience. There are three types of log entries:
GetParm... this is a request of data by the course. The LMS is sending data to the course.
PutParam... this is a post of data by the course to the LMS. The LMS is receiving data from the course.
ExitAu... the is the course telling the LMS it is done with the current sessioin.
Most of the time, you will be concerned with the PutParam. The PutParam line will have multiple lines and a snipet is shown below...
Date & Time: 2005-05-11 19:07:29 Command = PutParam Session Id = BAR100$GMP300$A001$23822 Aicc data = [CORE] time=00:09:38 lesson_location=a001_thank_you_fail.html score=100 lesson_status=I [CORE_LESSON] ...
The PutParam can be broken into three sections. Stuff before [Core], stuff between [Core] and [Core_lesson] and stuff after [Core_Lesson].
The stuff before [Core] is a date-time stamp, the aicc command and SessionID. SessionID is important because it is actually a compound key seperated by the $ character. The first section "BAR100" is the learner id or student id. "GMP300", the second section is the course id. If the course has multiple lessons or units, the third section contains the unit ID the person was working on. The final section is the internal database number for the training tracking record for the module. So reading this bit of the log tells you the user BAR100 was doing work on Course GMP300.
The stuff between [Core] and [Core_Lesson] is the basic tracking.In the example above, it shows the time, lesson location or bookmark, the core and the lesson status.
[Core_Lesson] has additional tracking information which is often vendor specific and is therefor outside the scope of this article.
Now the example above is an actual example of troubleshooting for a client. Here you see the user scored 100 but the status was set to I for incomplete. This means the courseware is not posting to the LMS a completion status. Time to call the courseware vendor.
In a good log entry you will see something like:
Date & Time: 2005-05-11 19:07:29 Command = PutParam Session Id = BAR100$GMP300$A001$23822 Aicc data = [CORE] time=00:09:38 lesson_location=a001_thank_you_pass.html score=100 lesson_status=complete[CORE_LESSON] ...
Here you see the status is set as complete. Another status supported by AICC is PASS. When the lesson status is received as complete or pass, the module_history record is also set to the same status. If a single module or all modules are completed/passed, only then is the training record updated to finished.