Chapter 13: Installing Digital Teacher server components

Do I need to install these components?

If you plan to use the Digital Teacher web application to create and run the .HTM type lessons only, you do NOT need these components. Please ignore this chapter.

However, if you plan to create and run the ASP type lessons either on your PC or on the Web, you must install the following two components.

• dtsys40.dac - Digital Teacher web data access component
• dteach40.dll - Digital Teacher ActiveX web data server component

These files are included in the Digital Teacher Web Application Components (Chapter 5: Publishing Web Lessons).

The dtsys40.dac does not require a special installation procedure. All you have to do is to place the file in the Digital Teacher Web Application's Database folder as described in the previous chapter.

The dteach40.dll file must be registered to the Window's system registry. The system registry is a special Windows database, which contains and sets information about how your computer runs. Registering a file is to set the file information to your Windows system.

To register dteach40.dll on your local PC,

1. Place the file in the \dteacher folder as shown in the earlier part of this chapter.
   
   
2. From the Taskbar, choose Start and Run. Enter the following line in the Open box, and click OK.
   
   Regsvr32.exe [file path]
   
   where the [file path] is the physical location of dteach40.dll.
   Example: Regsvr32.exe "c:\Inetpub\wwwroot\dteacher\dteach40.dll"
   
   
3. This will register the file in your system. Restart the computer to update the newly changed registry information.

To register dteach40.dll on your server machine,

1. Ask your network administrator to register the file.
   The location of the file will depend on your network administrator's requirement.
2. Also, you might want to provide him/her with the information from the next two topics, Database Connections and Setting up Database Permissions on the IIS Server.

Database Connections (for Network Administrator)

The Digital Teacher lesson database connection is established by dteach40.dll, an ActiveX data access (ADO) component using OLEDB 4.0 to Microsoft Jet Database.

	Connection method
	- DSN-less connection to the physical location of a database
	- Thus, does not require the ODBC DSN setup and/or global.asa
	- The ConnectionTimeOut is set to the default value.

	Usage in the Digital Teacher lesson ASP page
	- Connection object is created to verify the user (student)
	- Connection object is destroyed on load
	- Connection object is created to retrieve the user's performance result
	- Connection object is destroyed on unload

	Usage in the Digital Teacher grade book ASP page
	- Connection object is created (instantiated) to verify the user (teacher)
	- Connection object is destroyed on load
	- Connection object is created to retrieve a student's grade record
	- Connection object is destroyed immediately

All ASP pages created with Digital Teacher Web Application do not use session objects. EnableSessionState is set to False.

Setting up Database Permissions on the IIS Server (NTFS Only)

(If you are previewing your Digital Teacher lessons with PWS on Windows 9x, you do not need to set any permissions on the database. Please ignore this topic.

If running on a NT or 2000 web server using the NTFS file system, you need to pass the information in this topic to your server administrator, who has physical access to the server. Note that he/she is not necessarily the same person as the network administrator in your organization.)

To enable the student to write login data to the lesson database at the beginning, and write results at the end of a lesson, it is necessary to give him/her Read and Write permissions on the

• directory containing the lesson database file
• database file itself. You may also need to set permissions on the
• Temp directory because your version of Microsoft Jet may create temporary files in this directory

The student account is the Internet Guest account, commonly called IUSR_MyComputer (where MyComputer is the name of your machine) or similar. IUSR_MyComputer is by default part of the "Everyone" group.

To set the permissions on the directory (i.e. /database/sample_exam.wsd ) for NT and 2000, open Windows Explorer.

Open the directory's Properties dialog by right clicking on the directory.

1. Choose the Security tab.

2. Uncheck the Allow inheritable permissions from parent to propagate to this object check box from the bottom of the dialog box.

3. Click on the Add... button.

The Select Users or Groups dialog box will open.

1. Select the IUSR_MyComputer account from the list, where MyComputer is the name of your computer. IUSER is the default Internet Guest Account set up when IIS is installed.

2. Click on the Add button. MyComputer\IUSER_MyComputer appears in the box at the bottom half of the dialog.

3. Click OK.

You should now be back at the Properties dialog window where the top box should now contain Internet Guest Account (MyComputer\IUSER_MyComputer).

1. Select the Internet Guest Account (MyComputer\IUSER_MyComputer) account.

2. Assign Read and Write permissions for this account by checking the boxes at the bottom.

Note: To ensure that you have no problems with permissions, you might want to check all boxes for now. Later, you can change them back to Read/Write.

Repeat all the steps above on the lesson database file (i.e. /database/sample.exe.wsd). Make sure the file is NOT marked as "Read-only" on the General tab.

Repeat all the steps above on the Temp directory if necessary.

Copyright 2001-2002 Francis Software, Sunnyvale, California