webnetwork 5e Installation and Configuration Guide Note: This manual is the property of Stoneware, Inc. It is not to be reproduced, copied, or printed without prior consent from Stoneware, Inc.
webnetwork 5e Installation and Configuration Guide by Stoneware, Inc. This document will provide detailed step by step instructions on how to install and upgrade your webnetwork 5e system. Complete product documentation can be located in the webnetwork 5e Installation and Configuration manual.
Services 3 1 Services 1.1 webpages Overview webpages was designed to provide school teachers with a simple means of publishing content and information to parents and students. webpages provides a "template" system by which teachers can provide valuable information to their class without becoming and HTML editor or web page designer. webpages simplifies the process of moving content online by providing a common "look and feel" across an entire school district and allowing teachers to rapidly publish educational information. webpages provides the following services: School Branding for creating unique school profiles within a district Registration provides teachers with a "Self Service" configuration of their classes and content Announcements Template Calendar Template Assignments Templates Documents Template Books Template Supplies Template Links Template FAQs Template Search Template Multi-class support 1.1.1 Student Lockers Student Lockers Student Lockers were designed so that students and teachers could easily pass documents between one another. Integrated into the template system of webpages, Student Lockers provide teachers with a simple means of accessing class documents for each student. The benefits of student lockers are:
4 webnetwork 5e Installation and Upgrade Guide Students can pass documents for review to teachers leveraging their existing home directory Teachers can easily access a student's personal class directory to review and grade documents The Student Locker application is designed to be populated with class and student information from the school's student record system. In order to utilize this feature of webpages schools should be capable of extracting course and student information from their student record system and populating the webpage database tables. 1.1.1.1 Requirements Student Lockers requires the following: webnetwork 5e or above webpages is installed and configured on the webnetwork system Students have a home directory on the network Students have the home directory path stored on an attribute of their user object Ability to populate the Locker's student/class table (i.e. - SIFS agent) with student and course information 1.1.1.2 Configuring Student Lockers This section of the document will step the webnetwork administrator through configuration of Student Lockers. 1) Enabling Student Lockers The webnetwork administrator will need to enable the Student Lockers from the webpages Administration screen. A new link labeled "Lockers Administration" should appear after webnetwork 5 has been upgraded to 5e. Follow the steps below to enable Student Lockers: a. From the webpages Administration screen select the Locker Administration link b. Check the Use Student Lockers box c. Select the SAVE button 2) Setting the Virtual Paths Virtual Paths will control webnetwork's access to student directories. There are two
Services 5 paths that are defined: Proxy Account Paths - The FOLDER NAME (Virtual Path) of the File System Node that points to the root of all student home directories. This path will be used by a proxy account to access the student's home directory on behalf of a teacher. * The Proxy Account Path can be followed by a subdirectory level setting if required (i.e. - /Students/1). The "1" signifies there are subdirectories below the path specified in the File Services Node that further organize user home directories. As an example: Student Home Directory path is separated by graduation years (i.e. - /Students/2006/jsmith The File Services Node Path is /Students The level setting following the Folder Name would read /Students/1 This setting would notify the webpages application that student home directories are categorized by sub directory and it should search down one sub directory to locate the user's home directory. Student Home Directories - The FOLDER NAME (Virtual Path) of the File System Node that points to the students' home directories. This step requires that the administrator has already created a File Services Node to the student's home directory. The FOLDER NAME that was defined on the File System Node should These two File Services paths will provide both the student (Student Home Directory) and teacher (Proxy Account Path) with access to the student's home directory based on class. Follow the steps below to configure the Virtual Path settings: a. Create a File Services Node to the Student's Home Directory if not already present (remember the FOLDER NAME). This File Service node will use a Stoneware Variable such as @@typelessuserid@@ or @@attr:samaccountname@@ in the path to dynamically change between student directories. See File Services for more information on how to configure a File System Node. b. Create a File Services Node to the ROOT of the Student Home Directories if not already present (remember the FOLDER NAME). See File Services for more information on how to configure a File System Node. c. Select the ADD button in the PROXY ACCOUNT PATHS section and enter the File Services FOLDER NAME for the Student's Home Directory node d. Select the ADD button in the STUDENT HOME PATHS section and enter the File Services FOLDER NAME for the Student's Home Directory node
6 webnetwork 5e Installation and Upgrade Guide e. Select the SAVE button Lockers should be configured within the webpages application. The next step will be to add data into the locker tables from the student record system. 1.1.1.3 Importing Student Information Once the Student Locker service has been configured it will need to have student and course data imported in order to provide teachers with a listing of all available students for a given course. webpages maintains two tables that contain this information: STUDENTS and SECTIONENROLLMENT. These two tables create a relationship between the teacher, courses, students, and their home directories on the network. Student Lockers was designed to have the STUDENTS and SECTIONENROLLMENT tables populated by a SIF (School Interoperability Framework ) agent. The agent can be configured to automatically update the two tables with information from the school's student record system. Each table structure is given below: STUDENTS STUDENTDN - varchar STUDENT-FIRSTNAME - varchar STUDENT-LASTNAME - varchar HOMEDIRECTORY - varchar SECTIONENROLLMENT STUDENTDN - varchar TEACHERDN - varchar CLASSNAME - varchar 1) The DN, First Name, and Last Name of each student should be entered into the Students table (Homedirectory will be automatically added by webpages).
Services 7 2) The DN of each student, each CLASSNAME they attend, and DN of their teacher for the given class should be entered into the SECTIONENROLLMENT table. * A DN is a distinguished name for an account in directory services. The DNs are used to identify the teacher and student for security purposes and locate their home directory. To test the functionality of Student Lockers the administrator can manually enter a set of student, course, and teacher information into the webpagesdb to verify that it is functioning properly. The steps below will outline how to update the webpagesdb database to store student, teacher, and course information. * Before you begin -create a test student account (i.e. - Student1) that has the home directory and it is defined on the user's home directory attribute. - create a test teacher account (i.e. - Teacher1) -configure the test teacher's account and define a course (i.e. - Math101) within webpages 1. Login to the webnetwork System as an administrative user 2. Select the REPORT BUILDER link under the REPORTS menu 3. Select the QUERY BUILDER tab at the top of the page 4. Select the CONNECTION of webpagesdb 5. Enter the USER ID and password required to connect to the database * sa is the default user ID for webpages systems that use the default Hypersonic database (no password) * If webpages has been configured to use another database (i.e. - MySQL, MSQL, etc) a USER ID/password should be supplied from the database administrator 6. Select the CONNECT button 7. Once connected select the DATABASE OPTIONS icon 8. Select the INTERACTIVE SQL link * This will allow the administrator to manually enter records into the STUDENTS and SECTIONENROLLMENT tables 9. Enter the command below add a student to the table
8 webnetwork 5e Installation and Upgrade Guide INSERT INTO STUDENTS VALUES('cn=Student1,ou=students,o=school,'Joe','Student','',''); * Remember to change the DN to reflect the directory structure of your tree 10.Select the EXECUTE SQL button to update the table 11.Enter the command below to enter the student, teacher, and course to the enrollment table INSERT INTO SECTIONENROLLMENT VALUES('cn=Student1,ou=students,o=school','cn=Teacher1,ou=teachers,o=school','Math1 01'); * Remember to change the DN to reflect the directory structure of your tree 12. Select the EXECUTE SQL button to update the table 13. The tables should be updated. Proceed to the next section to test the configuration. 1.1.1.4 Accessing Student Lockers Once the student and teacher information has been entered into the STUDENTS and SECTIONENROLLMENT tables the administrator is ready to verify that the Student Locker system is working correctly. Follow the steps below to verify Student Lockers are working correctly: 1. Login into the webnetwork System with the teacher account that was created to test the system 2. Select the webpages link 3. Enter the teacher's personal information if necessary * Note - the teacher should see a LOCKERS template listed on the left-side of the page 4. Select the EDIT PERSONAL INFO option from the select box at the bottom left of the screen
Services 9 5. Enter a Class Name of Math101 in the CLASS TO ADD section 6. Select the ADD button 7. Select the UPDATE INFORMATION button 8. Select the LOCKERS template from the left-hand side of the screen 9. ENABLE the template if prompted * Note - The teacher will be prompted if it is the first time he/she has accessed the Lockers template 10.Select the CREATE FOLDERS icon from the upper right-hand corner of the screen * Note - This step will create a Math101 folder under each student's home directory. The teacher will only be able to access student files that exist under the directory that matches the class name. 11.Select the CREATE FOLDERS FOR YOUR STUDENTS button 12.A list will be displayed verifying the directory has been created for each student in the class 13.Select the BACK TO THE STUDENT LOCKER TEMPLATE hyperlink 14.A student dropdown box should be available with a list of all students in the class. Selecting a student will display the contents of the class subdirectory (Math101) that is under the selected student's home directory. 15.Select the ADD icon to upload a file to the student's Math101 subdirectory