Index: lams_webct_integration/readme.txt =================================================================== RCS file: /usr/local/cvsroot/lams_webct_integration/readme.txt,v diff -u -r1.2 -r1.3 --- lams_webct_integration/readme.txt 1 Feb 2008 03:05:40 -0000 1.2 +++ lams_webct_integration/readme.txt 8 Feb 2008 04:16:52 -0000 1.3 @@ -14,16 +14,15 @@ 3. Installation 4. Configuring WebCt Side 5. Configuring LAMS Side +6. Using the LAMS logo for the LAMS Link 1. REQUIREMENTS ================================================================================ * Blackboard CE 6.x (Also known as WebCt Campus Edition) -* Http Server -* Ant +* A Http Server. * MySql Server 5.0 -* CVS Client 2. Downloading the package @@ -57,26 +56,30 @@ GRANT ALL PRIVILEGES ON TO ''@'' IDENTIFIED BY '. 8. You can test the cross-server MySql access by installing a MySql client and the typing the following command: mysql -h -u -p ; + 9. Open up the createTable_MySql.sql script in a text editor, edit all appearances of ${dbTable}, and name the table. + 10. Run the create table script using the following command. + mysql -u -p < path/to/createTable_MySql.sql Installation of Powerlink 1. Download lams2-webct-integration-1.0.0.zip from the downloads page. (Not yet available for download) 2. Unzip to a temporary location. 3. The package should contain the following files: - * apache-ant-1.7.0 (folder) - * db (folder) - * deploy (folder) - * lib (folder) - * build.properties - * build.xml - * DeployableComponentConfig.xml - * license.txt + * lams2 (directory) + * authmodule_CE_1.4.jar + * commons-codec-1.3.jar + * lams2-webct-integration-1.x.x.jar + * mysql-connector-java-3.1.2-bin.jar + * xercesImpl.jar * readme.txt + * license.txt * release_notes.txt + * createTable_MySql.sql - 4. Open up the build.properties in a text editor, you will need to change these entries to suit your own configuration. - NOTE: These settings can be configured in the Blackboard CE admin pages, EXCEPT for the image URL which must be correct, otherwise you will need to re-install the package. + 4. Create a directory called LAMS2 in the /path/to/bea815/weblogic81/config/WebCTDomain/deployablecomponents folder + 5. Copy the authmodule_CE_1.4.jar, commons-codec-1.3.jar, lams2-webct-integration-1.x.x.jar, mysql-connector-java-3.1.2-bin.jar into this directory. + 6. IF you are running Blackboard CE 6.2 or newer, copy xercesImpl.jar into the directory, otherwise DO NOT. 4. Configuring WebCt Side @@ -87,16 +90,26 @@ 3. Click on utilities (the red box) tab, then settings to get to the admin screen. 4. Under the System Integration list there should now be a link called "LAMS Integration Module", click on that link. 5. Select the true option of the Enable setting and also ensure you select the "Override Setting at Child Contexts" option to enable it at all contexts. - NOTE: DO NOT select the "Lock This Setting" Option yet as there have been known issues associated with this, these settings are only visible to the serveradmin user so there is no need to lock them. - 6. You can edit the other configuration fields (except of the image url), but make sure you select the "Override Setting at Child Contexts" option to filter the setting to all contexts. Again, do not lock the settings. - 7. Scroll down to the bottom of the page and click save to save the configuration. - 8. Next, click on the Powerlinks Proxy Tools tab, then click the Create Proxy Tool button. - 9. From the drop down menu, select "LAMS Integration Module". - 10. Enter the proxy tool name, version (1.0) and description, do not lock any of they settings, and do not select the "Release to My WebCT" option. - 11. Click save, the new Proxy Tool should appear in the list. - 12. Now return to the settings screen by clicking on the utilities (red box) tab then clicking settings. - 13. Under tools, a new link should appear with the same name as you used for the proxy tool name. Click it. - 14. The Enable Tool Field should be locked, you will need to unlock it first, then return to the menu again and select true to enable the tool. Make sure you select the "Override Setting at Child Contexts" also. + 6. Edit the configuration fields to suit your needs. The important fields are listing in the following steps. + 7. The database JDBC url should be filled to match the URL to connect to your database. + 8. The database driver jar should be left as default, unless you are using a non-mysql database. + 9. The database name should be the same name that was in your database URL. + 10. The database user should be the same as the one set up in the pre-steps. + 11. Database user password needs to be correct to connect to the database. + 12. LAMS server url is the url to get to the LAMS login page, make sure it has a forward slash "/" at the end. + 13. LAMS server id is a arbitrary name that will be used to configure the LAMS/WebCt server connection, make sure you remember this feild. + 14. LAMS server secret key, is the secret field that will be used to hash requests between LAMS/WebCT servers. Choose a field only your administrators know, and make sure you remember it. + 15. The reqSrc field is an arbitrary name which the LAMS server will use when returning to the Blackboard CE server, you can leave it as Blackboard CE, or change it to whatever you wish to call you 'home' Blackboard CE server. + 16. The imgUrl should be set to point to a web address folder containing the tigra images, as was set up in the pre-steps. + 17. The LAMS Author, Monitoring and Learner roles allow you to map WebCT roles to LAMS roles. + 18. Once finished configuring settings, make sure for each setting the "Override Setting at Child Contexts" is selected and then save. + 19. Next, click on the Powerlinks Proxy Tools tab, then click the Create Proxy Tool button. + 20. From the drop down menu, select "LAMS Integration Module". + 21. Enter the proxy tool name, version (1.0) and description, do not lock any of they settings, and do not select the "Release to My WebCT" option. + 22. Click save, the new Proxy Tool should appear in the list. + 23. Now return to the settings screen by clicking on the utilities (red box) tab then clicking settings. + 24. Under tools, a new link should appear with the same name as you used for the proxy tool name. Click it. + 25. The Enable Tool Field should be locked, you will need to unlock it first, then return to the menu again and select true to enable the tool. Make sure you select the "Override Setting at Child Contexts" also. 5. Configuring LAMS Side @@ -112,4 +125,12 @@ 8. The 'disabled' checkbox disables this integration, you can select this later if you wish to disable the connection. 9. The User Information URL is arbitrary for LAMS/Blackboard CE integrations, so put a dummy URL in. 10. You can specify a timeout page that LAMS will go to if there is an error. + + +6. Using the LAMS logo for the LAMS Link +======================================== +Any time you add a link to your WebCT homepage, you can specify an image to use for the link. + +The LAMS_logo.jpg is included with the package, and is suggested to be used for this purpose. +