63
Enterprise Troubleshooting in CAMS Three Rivers Systems, Inc. Published: 25 March 2015 Abstract This document is designed to provide you with information necessary to troubleshoot some issues with CAMS Enterprise. Not every institution has these issues and this document may not have the particular issue that the institution is experiencing. Some of the issues here may help IT personnel in remembering something that could assist in a resolution. This document should be used in conjunction with other troubleshooting techniques. It does not, in any way, list every issue that you may encounter. Recommended steps could be: Determine if it is a network issue, CAMS issue or other vendors' programs used in conjunction with CAMS Use help files, both online and PDF documentation Use troubleshooting document Helpdesk Support Note: If it is a network issue or other vendor program you can check with Three Rivers Systems to see if there are any known issues but ultimately these issues will have to be resolved by the institution.

Enterprise - Lane College

  • Upload
    others

  • View
    1

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Enterprise - Lane College

Enterprise Troubleshooting in CAMS

Three Rivers Systems, Inc.

Published: 25 March 2015

Abstract

This document is designed to provide you with information necessary to troubleshoot some issues with CAMS Enterprise.

Not every institution has these issues and this document may not have the particular issue that the institution is

experiencing. Some of the issues here may help IT personnel in remembering something that could assist in a resolution.

This document should be used in conjunction with other troubleshooting techniques. It does not, in any way, list every

issue that you may encounter.

Recommended steps could be:

Determine if it is a network issue, CAMS issue or other vendors' programs used in conjunction with CAMS

Use help files, both online and PDF documentation

Use troubleshooting document

Helpdesk

Support

Note: If it is a network issue or other vendor program you can check with Three Rivers Systems to see if there are any

known issues but ultimately these issues will have to be resolved by the institution.

Page 2: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 2 of 63

Disclaimer

Three Rivers Systems, Inc. makes no representation or warranties with respect to the contents or use of this guide. Further, Three Rivers Systems, Inc. reserves the right to revise this guide and make changes to its contents at any time without obligation to notify any person or entity of such revisions or changes. In no event will Three Rivers Systems, Inc. be liable to buyer or any other party for any damages, including any lost profits, lost savings, or other special incidental or consequential damages arising out of the use of or inability to use such product, even if Three Rivers Systems, Inc. has been advised of the possibility of such damages, or for any claim by any other party. © 2015 Three Rivers Systems, Inc. All rights reserved. All company and product names included in this site may be trademarks or registered trademarks of their respective companies. The information contained in these pages is subject to change at any time without prior notice.

Page 3: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 3 of 63

Table of Contents

General Practices .......................................................................................................................................... 6 Accessing CAMS ........................................................................................................................................ 10

Error: Microsoft OLEDB Persistence Provider: Rowset cannot be loaded because the stream is invalid. ................................................................................................................................................ 10

Admissions .................................................................................................................................................. 11 CAMS Error # = 4022 or Update failed on Student demographics .................................................... 11 If we enter a high school by mistake and want to delete it. ............................................................... 11 Expected Entrance Term defaults to wrong term. .............................................................................. 11 Select student screen is always blank or missing students ............................................................... 11

Billing ........................................................................................................................................................... 13 Billing Office Hold Voids ..................................................................................................................... 13 Cannot Distribute a Batch .................................................................................................................. 13 1098s Are Incorrect ............................................................................................................................ 13 1098 Export Error ............................................................................................................................... 14

CAMS Manager ........................................................................................................................................... 15 Cannot modify lookup tables. ............................................................................................................. 15 Setting up College data ...................................................................................................................... 15 SSI Regeneration Failed .................................................................................................................... 15 Missing Menu Items ........................................................................................................................... 15 User Menu Missing Items ................................................................................................................... 15 Version Check Failure ........................................................................................................................ 16 Need to change from DNS to IP in Global ASA and CAMSLicense table. ........................................ 16 The local policy of this system does not allow you to log on interactively. ........................................ 17

Crystal Reports ........................................................................................................................................... 18 Reports will not display and all settings look correct .......................................................................... 18 Reports only display a red X. ............................................................................................................. 18 Could not open the field definition file ................................................................................................ 19 No reports are displaying. Object required error message ................................................................ 19 No reports are displaying. They were working before ........................................................................ 20 Cannot export from Crystal Reports ................................................................................................... 20 Custom reports only load when the person printing them has Crystal reports loaded on their PC ... 20 Users cannot get Crystal Reports to display ...................................................................................... 21 Receive crdb_fielddef.dll and crdb_ado.dll errors. ............................................................................. 21

Database ..................................................................................................................................................... 22 Need to copy the college database to the training database. ............................................................ 22

Development ............................................................................................................................................... 23 No Activities Display in Constituent or Ledger Correspondence ....................................................... 23

Email ........................................................................................................................................................... 24 Email is not being sent from CAMS Enterprise .................................................................................. 24 Email is not being sent from Admissions >Student >BYOR .............................................................. 25 Email attachments cannot be attached .............................................................................................. 25 Email attachments residing on local workstation cannot be attached ............................................... 26 Routing email through your Exchange server. ................................................................................... 26

Exporting/Uploading .................................................................................................................................... 27 Cannot export files over a certain size. .............................................................................................. 27 Windows 2003 Server ........................................................................................................................ 27 Windows 2008 Server ........................................................................................................................ 28

Financial Aid ................................................................................................................................................ 29 Cannot import the EDE Award file ..................................................................................................... 29

Housing ....................................................................................................................................................... 31 Students are still in rooms but for incorrect term. .............................................................................. 31

Import ...................................................................................................................................................... 31 Get an error when trying to import the file. ......................................................................................... 31

Installation ................................................................................................................................................... 32 Cannot Import D:\Progra~1\CAMSEN~1\MTSDLL\ENTERP~1.REG: Error accessing the registry. 32

Page 4: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 4 of 63

HTTPS ................................................................................................................................................ 32 Miscellaneous ............................................................................................................................................. 33

How do I change the login window to point to the college database rather than “CAMS Enterprise Test”? ................................................................................................................................................. 33 CAMS Enterprise seems slower. ....................................................................................................... 33 Network Issue ..................................................................................................................................... 33 How to shut down A COM+ Object. ................................................................................................... 34 Upgraded server to Active Directory and now CAMS Enterprise does not work ............................... 34 Cannot upload Document Image documents larger than 200Kb. ...................................................... 34 Buffering ............................................................................................................................................. 34 Use SSL with CAMS Enterprise and Portals ..................................................................................... 34 Custom routines are not working now. Get Read Fail SSI message. ................................................ 35 Move CAMS Enterprise to a different drive. ....................................................................................... 36

Pictures ....................................................................................................................................................... 37 Student pictures display a red X. ....................................................................................................... 37

Portals ......................................................................................................................................................... 39 Some Portal functions are not working. ............................................................................................. 39 Where are the updates? ..................................................................................................................... 39 Cannot add attachment, permission denied message. ...................................................................... 39 Errors received when accessing Course Management. .................................................................... 40 Cannot view portal reports ................................................................................................................. 41 Simple Grade Entry ............................................................................................................................ 41 Course Management Module No Longer Working ............................................................................. 41 Submitting Final Grades ..................................................................................................................... 42 Error when trying to pull class list to register from student portal ...................................................... 42 Cannot change password on faculty portals ...................................................................................... 42 Students or Faculty do not display address information. ................................................................... 42 Faculty cannot access Course Management. .................................................................................... 43 Find Faculty Type UniqueID ............................................................................................................... 44 Set Access Rights .............................................................................................................................. 44 Terms do not display in the term dropdown field on the login page in either the student or faculty portal. ................................................................................................................................................. 45

Registration ................................................................................................................................................. 46 Grades are not calculating correctly. .................................................................................................. 46 When scheduling a class cannot enter a time. .................................................................................. 46 Troubleshooting steps for Registration issues ................................................................................... 46 Cannot create a Student Status record .............................................................................................. 47 Cannot register a student. .................................................................................................................. 47 Cannot register a student ................................................................................................................... 48 Cannot assign a faculty member to a course. .................................................................................... 48 Cannot create a new class in Offering Maintenance. ........................................................................ 48 Incorrect TransDocs being charged. .................................................................................................. 48 Grade Entry grades do not display. .................................................................................................... 48 Enrollment counts are not correct. ..................................................................................................... 49

Reports ........................................................................................................................................................ 50 Fin Aid BYOR Summary By Student Registered Hours ..................................................................... 50

SQL ............................................................................................................................................................. 51 SQL server not responding or losing data. ........................................................................................ 51 Cannot log on to Ad-Hoc Query. ........................................................................................................ 51 Msg 7391, The operation could not be performed because the OLE DB provider 'SQLOLEDB' was unable to begin a distributed transaction. OLE/DB provider returned message: New transaction cannot enlist in the specified transaction coordinator. ....................................................................... 52 Execute permission denied on object 'sp_addextendedproc', database 'master', owner 'dbo' ......... 52 We switched to new SQL servers and now cannot connect to CAMS Enterprise. ............................ 53 We cannot log into CAMS. Receive DLL xp_ctnhashproc.dll error ................................................... 54

Terminal Services ....................................................................................................................................... 55 How to transfer a file between host and client. .................................................................................. 55

Page 5: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 5 of 63

Windows 2003 ............................................................................................................................................. 56 Setting up DTC for network access .................................................................................................... 56 Before call to mdbCAMSLicensesObj.queryByDBName…. .............................................................. 56 Setting Up MSDTC Security Settings (Both machines 2003 servers.) .............................................. 56 Setting Up MSDTC Security Settings (One 2003 server and one 2000 server) ................................ 56

CAMS Enterprise DTC Configuration Windows 2003 ................................................................................. 57 CAMS Enterprise DTC Configuration Windows 2008 ................................................................................. 59 Index ............................................................................................................................................................ 62

Page 6: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 6 of 63

General Practices

Troubleshooting FAQs for CAMS Enterprise/CAMS Portals Issues

1. General Practices: These items are preemptive. They are best practices which help to avoid potential system issues that may impact CAMS performance.

a. IIS servers should be up to date with Microsoft Updates.

i. Microsoft makes its clients aware when updates are available. Three Rivers Systems does not send anything to duplicate that notice.

ii. Three Rivers will notify clients if any issues surface with any of the MS Update policies that impact CAMS Enterprise.

iii. Best Practice – wait a day or two after the updates become available to install them on your production servers.

b. Install CAMS Enterprise updates separately from Microsoft Updates.

i. Best Practice - Install Microsoft updates first and let them run for a few days to ensure they don’t cause a problem in CAMS. After a few days, apply the CAMS update.

c. Keep CAMS as up to date as possible. We realize that there are times when updating CAMS is not feasible. However, running the most recent version of CAMS ensures that any known system fixes are in place, and allows our support team to better troubleshoot any issues that arise.

d. Changes that will affect any sever that CAMS is running under (IIS, SQL, and Portal) to the existing network infrastructure should be well planned and scheduled in advance with Three Rivers Systems. This would include but not limited to the following areas:

i. DNS (Internal and External)

ii. Add or Remove Network Interfaces

iii. IP Addresses or Routing

iv. Firewall and Anti Virus Suite Network Components

v. Security Policies (Group Policy Objects or Local Security Policy)

vi. Secure Socket Changes (for example, installing new SSL Certificates)

vii. SMTP (Outgoing E-Mail Server IP, Relay Settings or Anti-SPAM filtering rules)

viii. MSDTC (Microsoft Distributed Transaction Coordinator)

ix. LDAP / Active Directory Integration Username / Password

x. Folder, File or Share Permissions

xi. SQL Username or Password used by CAMS

e. Keep stock copies of Reports, SSI files, and Portals in order to compare if an issue occurs with a customized copy.

f. Always script a stored procedure to a backup before any customizations are done.

g. Follow the Custom Reports.pdf document recommendations for customizing reports.

Page 7: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 7 of 63

h. Microsoft updates sometimes install the XPS Document writer on workstations and the CAMS Server. This printer driver will become the default printer.

i. If a workstation does not need this, delete it.

ii. Always delete it from the CAMS server or reports will always try to print to this as the default from all (or most) workstations.

i. Keep SQL updated with Service Packs.

j. Separate Portal server; ensure it is updated correctly when CAMS is updated.

k. Defrag database indexes on a regular basis.

2. CAMS Enterprise – Common Issues: These are common issues that are related to setup, update, and system configuration issues.

a. Report Performance:

Problem: When running canned reports in CAMS Enterprise, the screen appears to “freeze”.

Potential Cause: Crystal Reports COM+ component essentially appears to freeze due to the amount of reports being run at once. It really is not frozen; this occurs because Crystal is attempting to “queue” requests based upon the number of physical processor cores available to the CAMS Enterprise IIS server (three concurrent threads per physical core can run concurrently).

Solution: If it appears reports are “frozen” or not being produced, the following steps can be attempted to see if the issue can be resolved:

Navigate to the CAMS IIS server through RDC.

Click Start, Run DCOMCNFG and press enter.

Expand the Component Services Group (click the +)

Expand the Computers Group (click the +)

Expand the My Computer Group (click the +)

Expand the COM+ Applications Group (click the +)

Find the Crystal Reports COM+ Application (most of the time we create this with the application name of “Crystal”, you might have some type of variant). Expand the Crystal Application (click the +) then click on the Components group (single click here). This should display the six different components in Large Icon view. In the tool bar, find and click the Detail View icon. With this view you can see how many objects are currently in call, as well as how long they have been in call. This is just more informational than anything.

Right click the Crystal COM+ Application and choose to “shutdown” the COM+ Application.

o Shutting down the application may cause reporting loss in some cases, but if it truly is locked up (frozen), then that does not really matter.

o Once it has been shutdown, have a single user attempt to run a new report. If the report successfully is generated then the “frozen” application has been successfully restored.

Page 8: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 8 of 63

If a Crystal COM+ Component cannot be found, or the Shutdown in 2.a does not resolve this issue you will need to perform an IIS Reset (Stop and Start the W3WC Service). Since CAMS does not use ASP Session, this should not affect current users if they just stay on their current screen and don’t change anything. Restarting IIS requires you to be connected to the CAMS IIS server. Click Start, Run, type IISRESET and hit enter.

o Once the IIS service has been re-set, have a single user attempt to display a report. If the report is displayed, the critical issue has been resolved.

o If reports still cannot be displayed you can try rebooting the IIS server, but Three Rivers still needs to be contacted at this point if it is a system wide occurrence. Individual workstations are not considered a Work Stoppage.

b. Script Timeouts

Problem: User received an error message that the script timed out.

Cause: Typically due to the ASP Script Timeout setting under the Web Site/Virtual Directory hosting the CAMS application.

Solution: Increase the ASP Script Timeout setting. 1200 seconds seems to cover most user needs.

c. Query Timeouts

Problem: User received an error message that the query timed out.

Causes:

i. SQL Server Properties, Connections, Remote Query Timeout.

ii. SQL Database table blocking and/or deadlocks.

iii. Custom Triggers and/or Processes Causing Issues.

Solution: Review the above listed items and make changes as needed.

d. Internet Timeouts

Problem: Users receive a message that their IE/browser window has timed out.

Cause: Typically caused by lengthy requests from the UI.

Solution: These are difficult to track down, possibly run the same request in a less busy time of day and/or restrict the request further by adding additional query parameters.

e. Distributed Transaction Timeouts

Problem: Users receive a message that the DTC has timed out.

Cause: The default limits are set too low.

Solution: DTC Timeouts are found under the COM+ (Component Services), My Computer, Right Click, Properties, Options Tab. The default transaction timeout is 60 seconds; you might need to increase this value. We have found that 300 seconds is a good timeout limit for most of CAMS operations.

Note: this value needs to be configured on both the IIS server and the SQL server.

Page 9: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 9 of 63

f. Microsoft Distributed Transaction Coordinator (MSDTC)

Problem: User(s) experiencing sudden, unexplained inability to pull up pages in CAMS Enterprise.

Cause: There are times when an update from Microsoft changes the security level of MSDTC back to the defaults (defaults are based upon the server’s operating system and existing service pack level). If CAMS users cannot log into the system after a Microsoft security update has been performed with a message that has the content similar to “cannot enlist in a new transaction”, this indicates the MSDTC between the IIS server and the SQL server have become out of sync with each other.

Another cause of this type of message might come from changes in the Firewall settings that disabled the port(s) that MSDTC uses to communicate between the two servers.

Solution: See CAMS Enterprise DTC Configuration in this document.

Page 10: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 10 of 63

Accessing CAMS

Error: Microsoft OLEDB Persistence Provider: Rowset cannot be loaded because the stream is invalid.

Problem: An error occurs when accessing a Windows Server 2008 or later from a Windows XP workstation.

Possible Solution: On the Windows XP computer, disable HTTP 1.1 in the browser. See the Microsoft Knowledgebase article at http://support.microsoft.com/kb/977938.

Page 11: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 11 of 63

Admissions

CAMS Error # = 4022 or Update failed on Student demographics

Problem: Failure when bringing a prospect record over to student records.

Possible Solution: Regenerate the glossary/reference SSI files. Another option is to check that the Term Calendar table has the default 0 TermCalendarID value. (Make sure there is an entry that has an “A” for the Term field and that the TextTerm field is left blank.)

If we enter a high school by mistake and want to delete it.

Problem: How to delete a high school entry on the Admissions >Change Student >HS tab.

Possible Solution: You can select the blank record directly from CAMS Enterprise. You can change the value of the HighSchoolID field to 0 (zero) in the StudentHighSchool SQL table for the student using their StudentUID. This will clear it out of their record.

Expected Entrance Term defaults to wrong term.

Problem: The Expected Entrance Term has a term in it when it used to be blank when entering a new prospect or student or it has the wrong term.

Possible Solution: What displays when a new prospect or student is created comes from the Last Term Used field in the CAMS User's profile screen. This field is set by a couple of areas of CAMS, for instance, when they register a student, whatever term was used will now be the Last Term Used. This field cannot be manually changed from directly inside CAMS. You would have to change two SQL tables, UserRegParameters and CAMSUser. While the CAMS User is OUT of CAMS change the TermCalendarID in the UserRegParameters table to the desired termID and change the LastTerm field in the CAMSUser table to the same ID. If you change both tables to have the ID of 0 then the Expected Entrance Term field will be blank.

Select student screen is always blank or missing students

Problem: When searching for students no names appear or when I have added some students they do not show up.

Possible Solution: You must give students an Access Campus setting and you must also be allowed to view that campus or be a Super User.

To set the student’s Access Campus open Admissions >Student >Student Access and enter the Access Campus field. The Access Campus field is used to determine the main campus used by the student.

Figure 1: Access Campus

Page 12: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 12 of 63

Users can be set to only view students on a specific Access Campus in their user account settings under CAMS Manager.

Figure 2: User Access to Campus

To allow a user to view all students across all campuses they must be set to Super User.

Figure 3: Super User

Page 13: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 13 of 63

Billing

Billing Office Hold Voids

Problem: Need to run a procedure nightly that voids any holds on students accounts that are no longer accurate. Question: Are my only ties to the billing holds the balance from the billing table? Is there any other table I need to look at?

Possible Solution: All holds are stored in the StudentHolds table. Holds are not physically tied to any particular event. When voiding holds outside the system, you will need to adjust the StudentAlert.BusinessHold value for each student. This field contains the number of Non-Voided Holds.

Cannot Distribute a Batch

Problem: "Cannot distribute a batch while others are using it."

Possible Solution: A semaphore for that batch when it was created and the semaphore was not cleared when they existed the batch screen. Removed the entry in the FundBatchSemaphore table.

1098s Are Incorrect

Problem: The 1098 forms and data are not correct.

Possible Solution: Check the items below.

1. Check your criteria.

Is your criteria correct for the year you are reporting on?

Calendar Year is for the correct year.

First and Last day in report year are correct?

Are the correct terms selected for the report year?

Is the correct term selected for the first term in the current year?

Have you selected the correct GPA Groupings for Graduate students and are those students actually marked with those GPA Groupings on their status record?

Are the students marked with the correct AR Type if selected?

Are you reporting Debit or Credit method?

Page 14: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 14 of 63

2. Students are not appearing on the 1098 forms or verification report.

Students will not appear if their financial aid that they received completely covered all of their 1098 related expenses, tuition and fees. Technically, the student did not pay any tuition since it completely covered by financial aid.

If your institution requires that you report on all students, including those that did not actually pay tuition you can select “Remove Full Scholarship Students” on the Initiate tab.

3. Amounts are not coming out correctly.

Ensure that your TransDocs are marked correctly. Only one 1098 related checkbox for any TransDoc should be marked. If you find some that are not marked correctly, fix them and then rerun the 1098 reports.

Are the transactions themselves actually correct?

1098 Export Error

Problem: When trying to run the 1098 Export get the following error:

---------------------------

VBScript: Update error occurred

---------------------------

A data or business logic error has occurred in this application. Information about this error has been logged in your institution's database. The following information will assist support personnel in troubleshooting the problem:

Error number:100 Error description:Unable to complete StateReports:busState:Get1098TExport method

---------------------------

The error detail in CAMS Manager >View Error Log is:

Unable to complete StateReports:busState:Get1098TExport method

VisualBasic Error num: -2147217833

Desc: String or binary data would be truncated.

Possible Solution: This tells us that a field is too long for the export file. Normally it would be either the SSN field or the Student Name field. More likely it is the SSN as the SSN field can only have 9 numbers and 2 dashes. The SSN does not have to have any dashes. But if it is more than 9 numbers long it can only be dashes in the SSN.

To see which SSNs are incorrect you can use the following scripts:

SELECT StudentSSN

FROM IRSForm1098

WHERE LEN(REPLACE(StudentSSN, '-', '')) >9

Then take the SSN(s) and run the following script to find the student’s name:

SELECT Lastname, Firstname FROM Student WHERE StudentSSN = {SSN from above}

Page 15: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 15 of 63

CAMS Manager

Cannot modify lookup tables.

Problem: Cannot modify lookup tables; gets an error that SSI generation failed: access denied.

Possible Solution: This is a security permissions error on the IIS server not allowing write permissions to the SSI or SSI2 folders for either the IUSR user or if integrated login is enabled, the network user.

Setting up College data

Problem: When logging into the College database you receive several errors. For example, Line 25 Object doesn't support this property or method 'Top.rslicense'

Possible Solution: A configuration record has not been created. This is usually the situation when data is being converted for the institution but has not been placed on their site. Contact Three Rivers Systems, Inc.

SSI Regeneration Failed

Problem: Cannot generate SSI files, Path Not Found error.

Possible Solution: Make sure that the correct permissions are set on the CAMSEnterprise folder. Verify that the Global.asa file under the CAMSEnterprise directory has the correct Application(“BaseSSIPath”) line pointed to the correct location. Default is \\servername\camsenterprise\.

Missing Menu Items

Problem: We do not see new items that were mentioned in CAMS Manager update file.

Possible Solution: Make sure to give yourself or your users access to the new items. Remember, by default we do not give any access to new items.

User Menu Missing Items

Problem: I’ve given my user access to an item but it still does not show up in their menu.

Possible Solution: You need to ensure that the access level hierarchy is correct. For example, let’s look at Admissions and see that it is Read Only but the user has Read/Write Access to Change Student. The setting for Students is also Read Only. So this means that Change Student has a higher level of access than the section level. To correct this Admissions needs to be Read/Write and Students needs to be Read/Write. Remember, there cannot be any higher access than what is set at the top level for the section. Additionally, you can run a delete SQL script to delete everything from the CAMSUserMenuCache SQL table, which will then rebuild every user’s access the next time they log in.

Page 16: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 16 of 63

Version Check Failure

Problem: Cannot log into CAMS Enterprise and get a Version Check Failure CAMS.VER folder not found.

Possible Solution: Ensure that the correct IWAM permissions are set on the CAMS Enterprise folder. Should be set to Full rights.

Need to change from DNS to IP in Global ASA and CAMSLicense table.

Problem: DNS is not resolving correctly to CAMS Enterprise or DNS not in use.

Possible Solution:

Two changes are necessary:

1. Change the global.asa file.

Find the global.asa file in the root of the CAMS Enterprise physical file structure.

Change every occurrence of "http://yourwebsite.edu" to the internal IP address.

There are 3 places

i. Application("IESERVERIP"):

ii. Application("CODEBASEIP")

iii. Application("BasePicURL")

2. Reset IIS.

Change the CAMSLicense table

Inside SQL Server Enterprise Manager, open the Microsoft SQL Servers object: SQL Server Group object > Server object (for CAMS Enterprise) > Database object > CAMS_Administration database.

Click the Tables object.

Right mouse click on the CAMSLicense table.

Choose "Open Table ->>> View all Rows".

Change the value in the field "IESERVERIP" for the row with the "CollegeName" of “Your College”.

The IP must be the same as the IP used in step 1.

Page 17: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 17 of 63

The local policy of this system does not allow you to log on interactively.

Problem: During a connectivity test Three Rivers Systems cannot connect to the IIS server and receive “The local policy of this system does not allow you to log on interactively” error message.

Possible Solution: This issue occurs because the user account is not a member of the local Remote DeskTop Users group. To resolve this issue, add allowed users to the Remote DeskTop Users list:

1. Click Start, point to Settings, and then click Control Panel.

2. Double-click System, and then on the Remote tab, click Select Remote Users.

3. Click Add type in the user account name, and then click OK.

If you are adding more than one user name, use a semicolon to separate the names.

Note: Adding users to the Remote DeskTop Group requires that you are logged on through an administrator account.

Page 18: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 18 of 63

Crystal Reports

Reports will not display and all settings look correct

Problem: Reports won’t display and although settings look correct.

Possible Solution: Steps to start troubleshooting are listed below.

1. The ActiveXViewer Code base version may be incorrect in our SmartViewerActiveXv8.asp page to what has been installed. To see which version is installed navigate to the following:

C:\Program Files\Common Files\Crystal Decisions\2.0\ crystalreportviewers\ActiveXViewer

2. Then open up the ActiveXViewer.cab with Winzip. Double click on the crviewer9.inf file to open it in Notepad. Search down the inf file until you locate the [CRViewer9.dll] and look at the FileVersion entry. You may see a number like 9.2.2.511. Write these down or copy them to the clipboard.

3. Open up ..\CAMSEnterprise\reports\SmartViewerActiveXv8.asp. Locate the Codebase for the activex viewer object.<OBJECT ID="CRViewer" CLASSID="CLSID:2DEF4530-8CE6-41c9-84B6-A54536C90213" WIDTH=100% HEIGHT=100% CODEBASE="/viewer9/activeXViewer/ activexviewer.cab#Version=9.2.0.528" VIEWASTEXT>

4. Modify the version information you retrieved from the inf file.

5. Next check the NTFS Security Permissions to the C:\Program Files\Common Files\Crystal Decisions folder. Everyone should have Read/List/Execute permissions.

6. You may have to create a trusted site to the root of your CAMS Web server (to make sure that the viewer9 directory has download/install privileges).

Reports only display a red X.

Problem: All reports are displaying a red X instead of any data.

Possible Solution: Ensure that the PC has the correct "Trusted Site".

1. Open Internet Explorer > Tools > Internet Options.

2. In the Internet Options window select the "Security" Tab.

3. Highlight "Trusted Sites" (Green Circle with checkmark) then click on the "Sites..." button.

4. Ensure the name of your site for CAMS Enterprise is listed. (If it is in the list skip to step 8.)

5. Enter the name of your site where CAMS Enterprise is located. This will be in the format of "http://yoursite.edu." CAMSEnterprise is the default, however it may be called something different on your site (e.g., "cams", or "ecams").

6. Uncheck the box labeled "Require server verification (https:) for all sites in this zone."

7. Click Add

8. Click OK.

Page 19: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 19 of 63

Set the Security using these steps:

1. With the icon for "Trusted Sites" (Green Circle with checkmark) still highlighted, click the "Custom Levels" in "Security Level for this zone."

2. Under "Reset custom settings", select LOW from the "Reset To:" drop down list.

3. Click Reset.

4. Then click OK.

5. Click OK again.

6. Browse to and load the ActiveX.asp file. All of the controls should load.

7. Run a report.

8. If the report displays correctly then repeat these steps for each person's PC that has the problem.

Could not open the field definition file

Problem: The report does not open and I receive this error message.

Figure 4: TTX Error Message

Possible Solution: Sometimes Crystal defaults back to where the report originated. You will have to open the specific report, which is located in your CAMS Enterprise directory in the Reports folder, with Crystal Reports and choose database >Verify Database. When it requests locations for the TTX files navigate back to the Reports folder under your CAMS Enterprise root directory and search for the TTX file with the same name. This will remap the TTX files to your server.

No reports are displaying. Object required error message

Problem: None of the reports are working. We get this error message.

Figure 5: Create Object Error Message

Possible Solution: Restart the IIS server that CAMS Enterprise is located on. Another option is if Three Rivers Systems has put Crystal into a COM object you will need to restart the CrystalReports COM Component.

Page 20: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 20 of 63

No reports are displaying. They were working before

Problem: None of the reports are working. They were working before.

Possible Solution: If you upgraded to Crystal Reports to another version you need to contact Three Rivers Systems to modify some files to work correctly with the new version.

Cannot export from Crystal Reports

Problem: Cannot export from Crystal Reports. I receive a Debug error.

Possible Solution: Ensure that Crystal Reports is up to date with all patches and Service Packs.

Reload the ActiveX.asp file.

1. Log onto the affected machine as an Administrator.

2. Open Internet Explorer >Tools >Internet Options >Settings button >View Objects button. See if there is a file called axCEExport.trsExport.

3. If not then delete all items starting with ProtoView.

4. Rerun the ActiveX.asp and see if that file gets loaded.

Custom reports only load when the person printing them has Crystal reports loaded on their PC

Problem: Created links directly to custom Crystal Reports.

Possible Solution: CAMS Enterprise uses the Crystal Reports runtime application located on your IIS server. Crystal Reports is not required to be installed on your workstations. If you are not using our SSI setup then you can go to these links:

http://support.businessobjects.com/communityCS/FilesAndUpdates/aspxmps9.exe.asp

http://support.businessobjects.com/communityCS/FilesAndUpdates/aspxmps10.exe.asp

Three Rivers Systems, Inc is not responsible for custom reports or information that is presented on the above links.

Page 21: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 21 of 63

Users cannot get Crystal Reports to display

Problem: Users cannot get Crystal Reports to display and the ActiveX doesn’t seem to load on their computer.

Possible Solution: You need to create an “Everyone” group with read and execute permissions on C:\program files\common files\Crystal Decisions so the clients can access Crystal files when they are not logged in as administrators.

Receive crdb_fielddef.dll and crdb_ado.dll errors.

Problem: Cannot run Crystal Reports. Receive crdb_fielddef.dll and crdb_ado.dll errors

Possible Solution: Open the Registry and search for and remove anything with crdb in it. Do a Reinstall/Repair from the Crystal Reports CD.

Note: You must ensure that there are no remaining entries with CRDB in it.

Page 22: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 22 of 63

Database

Need to copy the college database to the training database.

Problem: Want to copy the college database to the training database.

Possible Solution: Refer to the Managing CAMS Enterprise.pdf document for complete step-by-step instructions.

Warning. This must be done with extreme caution as you could lose access

to the training database.

Page 23: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 23 of 63

Development

No Activities Display in Constituent or Ledger Correspondence

Problem: There are export or email activities that do not display in the Constituent Correspondence report section but do display in the Ledger Correspondence or vice versa.

Possible Solution: This references Development >Reports >Correspondence. Depending on where the activity is created it can be marked as a Ledger activity or a Constituent activity. Activities will not display in both reports.

Mail Merge Export and Email Activities created directly on the constituent’s account will be considered Constituent Correspondence. These activities will only display in the Constituent Correspondence report section. Mail Merge Export and Email activities created from batch or ledger entries will be considered Ledger Correspondence and will only display in the Ledger Correspondence report section.

Page 24: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 24 of 63

Email

Email is not being sent from CAMS Enterprise

Problem: Email is not being sent from CAMS Enterprise.

Possible Solution: CAMS Enterprise uses CDONTS to send email from the SMTP server. Using CDONTS with the Option Pack SMTP service, or IIS 5.0 the following minimum NTFS permissions are required:

The IUSR account must have Add rights to the Mailroot\Pickup folder.

If you are running CDONTS out of process, the IWAM account must have Add rights to the Mailroot\Pickup folder.

The System account must have Full Control rights to the entire Mailroot folder structure.

The default location for the Mailroot folder is ..\Inetpub\Mailroot.

Using CDONTS with Exchange Server, the following minimum NTFS permissions are required:

The IUSR account must have Add rights to the Exchsrvr\Imcdata\Pickup folder.

If you are running CDONTS out of process, the IWAM account must have Add rights to the Exchsrvr\Imcdata\Pickup folder.

The Exchange Server service account must have Full Control rights to the entire Exchsrvr\Imcdata folder structure.

Page 25: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 25 of 63

Email is not being sent from Admissions >Student >BYOR

Problem: When running email from student BYOR it displays the names and says email was successful.

Possible Solution: Make sure to select No for the Only Show Output option at the Top of the window.

Figure 6: Only Show Output Option

Email attachments cannot be attached

Problem: Cannot send email attachments.

Possible Solution: The IIS Server, using SMTP, is the vehicle used to send email from CAMS Enterprise. The IIS server must be able to get to the file. You can either put the file on the IIS server or put it in a sharable directory on your workstation. The path to the file must be in UNC format; for example, \\machinename\sharable directory\. Giving it a file name like "C:\myAttachment" will cause the IIS server to search its local hard drive for the file, which it will not find.

Page 26: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 26 of 63

Email attachments residing on local workstation cannot be attached

Problem: Cannot send email attachments if the document is stored on local workstation.

Possible Solution: Email can be sent through CAMS with attachments. The following e-mail screens are examples of where this functionality exists.

Admissions >Prospect >Change Prospect >E-Mail link

Faculty >Maintenance >Modify >Tab 4 (More) >E-mail

Admissions >Prospect >Reports > BYOR >E-Mail Report option

Admissions >Student >Reports >BYOR, E-mail Report option

Registration >Offering >Roster >Print Roster >E-mail Roster Report

option.

In order for users to send attachments consisting of files from their local

workstations, an "Attachments" folder must be created on the IIS server under

the CAMSEnterprise folder (Typical install is C:\Program Files\CAMSEnterprise).

The IUSR_<SERVERNAME> user must have Read/Write/Create/Delete access

rights to this folder.

Note: These copied files will remain in the “Attachments” folder on the IIS server after

sending the email. It may be desired to have a process in place for which this folder is

periodically emptied.

Routing email through your Exchange server.

Problem: Cannot route email from the CAMS server to our Exchange server.

Possible Solution: If you want mail from CAMS to relay to your main mail server, please make the following changes.

1. Give permissions on your main mail server to accept mail relayed from the CAMS server

2. On the CAMS server, in the IIS mmc

a) Right-click on Default SMTP Virtual Server, select Properties

b) Click on the Delivery tab, then the Advanced button

c) In the Smart host field, put the IP address of your main mail server in brackets ie. [10.10.10.10]. The brackets are necessary when specifying an IP address.

Here is an article from Microsoft with more detail:

http://support.microsoft.com/kb/324272/en-us

Page 27: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 27 of 63

Exporting/Uploading

Cannot export files over a certain size.

Problem: Cannot export/upload/download files over a certain size from CAMS Enterprise or the Portals. Document Image files that are larger than 200KB only display a red X.

Possible Solution: Windows 2003 (and later) server customers may have trouble uploading large documents. This applies to any file that is uploaded/downloaded and is not only related to document images.

Windows 2003 Server

First, stop IIS service. Using a plain text editor such as Notepad, open your metabase.xml which is located in C:\Windows\System32\Inetsrv. Locate the line "AspMaxRequestEntityAllowed" and change it to "67108864". This is 64 MB (megabytes) but you can enter a different value to meet your needs. Save changes and then start IIS.

Regardless of how large you make AspMaxRequestEntityAllowed in the IIS metabase.xml file, the maximum upload size that is allowed is 65536 KB (64 megabytes). The download size of a file is also limited in the meta base. By default, the metabase.xml file has this entry:

AspBufferingLimit = "4194304"

This limits download size to 4,194,304 bytes (4 MB), and larger files will be silently truncated with no message from IIS. You can change that to a larger value (such as 67108864 for 64 megabytes) to allow your Windows server to send large downloads.

The AspMaxRequestEntityAllowed and AspBufferingLimit MUST have the same number entered on the CAMS IIS server and the Portal IIS server (if using a separate portal server). The metabase.xml AspMaxRequestEntityAllowed and AspBufferingLimit entries are in bytes.

You may need to stop the IIS service before the changes will take effect.

Web Services

If you are using web services you will also need to change the httpRuntime maxRequestLength web service configuration setting in the web.config located in the CAMSServices\PortalService sub-folder inside the folder where CAMS Enterprise is installed on the CAMS Enterprise IIS box.

This setting is in KB (kilobytes) and the default is 4096. For example, this is a line from the web.config showing it set to 64 MB:

<httpRuntime maxRequestLength="65536" />

This setting MUST be the same size as the settings in the metabase.xml and MUST be in kilobytes.

Page 28: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 28 of 63

Windows 2008 Server

If you are using Windows 2008 server (IIS 7.0), you will need to change the Maximum Requesting Entity Body Limit [maxRequestEntityAllowed] and the Response Buffering Limit [bufferingLimit]in the Limits Properties in the ASP settings in the IIS Manager for the IIS box running the portals.

Note: IIS 7 displays Friendly Names by default on the ASP properties page (displayed in bold above). Change the “Display” drop-down in the ASP section to “Configuration Names” or “Both Names” in order to see the configuration label names (in square brackets above).

1. For each portal web site, double-click the ASP feature to open it, expand the Limits Properties section by clicking on the plus sign (+) and increase:

Maximum Requesting Entity Body Limit [maxRequestEntityAllowed] to 64 megabytes (67108864)

Reponse Buffering Limit [bufferingLimit] to 64 megabytes (67108864)

Script Time-out [scriptTimeout] to 10 minutes (00:10:00)

2. Click the Apply link in the Actions pane.

3. Click on the Default Web Site (if using the default web site) or CAMS Portals (if using a CAMS Portals web site) or the portal web site name (if each portal has its’ own web site) in the Connections (left) pane of the IIS Manager – if it is not already selected, select the features view in the center pane.

4. Double-click the Request Filtering feature to open it, click on the Edit Feature Settings… link in the Actions pane and increase Maximum allowed content length (Bytes) to 64 megabytes (67108864).

5. Click OK.

Note: The Request Filtering feature is not present by default in the IIS Manager on Windows Server 2008. Install “Administration Pack for IIS 7.0” available from the Microsoft downloads site.

You may need to stop the IIS service before the changes will take effect.

Web Services

If you are using web services you will also need to change the httpRuntime maxRequestLength web service configuration setting in the web.config located in the CAMSServices\PortalService sub-folder inside the folder where CAMS Enterprise is installed on the CAMS Enterprise IIS box.

This setting is in KB (kilobytes) and the default is 4096. For example, this is a line from the web.config showing it set to 64 MB:

<httpRuntime maxRequestLength="65536" />

This setting MUST be the same size as the settings in the IIS Manager and MUST be in kilobytes.

Page 29: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 29 of 63

Financial Aid

Cannot import the EDE Award file

Problem: When trying to import the EDE Award file we keep getting an error.

Possible Solution: When an error occurs importing an EDE Awards file there are usually three reasons why this happens.

Duplicate Entries

Improper Access Rights

Incorrect File Layout

When the error occurs you will usually see the error below. This is a generic error and does not actually tell you what the issue is. You should contact your CAMS Manager and have them check the View Error Log to get the specific information needed to resolve this issue.

Figure 7: EDE Award Import Errors

This error specifies that more than 1 value was returned. What that signifies is that there is a duplicate award entry for the student. Check the file and resolve any duplicate entries and then retry the import process.

Figure 8: Duplicate Entries

Page 30: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 30 of 63

This error specifies that the SQL server does not have read rights to the file. It is always recommended that the file be placed either directly on the SQL server in a shared directory or on the IIS server in a shared directory that is in the same domain as the SQL server. Check the file rights and then retry the import process.

Figure 9: Improper Access Rights

This error specifies that the file is not configured correctly. There could be extra characters, lines or some other issue. There could also be a change in the setup of CAMS Enterprise which now does not match what is in the file. Check the file or CAMS Enterprise setup for errors and then retry the import process.

Figure 10: Incorrect File Layout

Page 31: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 31 of 63

Housing

Students are still in rooms but for incorrect term.

Problem: Trying to assign students to rooms but there are students from previous terms still in the rooms.

Possible Solution: Check the End Date of students appearing to be in the rooms. CAMS Enterprise does not use the term to determine if they are in the room but the date range.

Import

Get an error when trying to import the file.

Problem: Get an error when trying to import the file. It says the wrong name or password is being used.

Possible Solution: MSSQLServer service was running on a non-domain account which did not have access to the network. The SQL server account must have access to the location of the file. This is usually done with a share. If the Everyone group has access to the share and the error still occurs then verify the account that is running the MSSQLServer service. Open the services window and view the properties of this service. Select the Log On tab and if the service is not using the Local System account then you have to ensure that the account has rights to the domain that the file is located or move the file to the SQL server itself.

Page 32: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 32 of 63

Installation

Cannot Import D:\Progra~1\CAMSEN~1\MTSDLL\ENTERP~1.REG: Error accessing the registry.

Problem: DOMAIN\TRS-MGR user does not have proper access to install DCOM components or to add to the registry.

Possible Solution: Registry needs to be larger. Increase the size.

HTTPS

Problem: Switching access to CAMS via secured web pages using HTTPS.

Possible Solution: When you installed the https you essentially modified the url. You need to update the following:

Global.asa: Anywhere you see an http:// entry, change it to https://

CAMS_Administration..CAMSLicenses table: In both records, change the IESERVERIP value to https://<...>

The system accesses the COM components on your local IIS server by these values.

Page 33: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 33 of 63

Miscellaneous

How do I change the login window to point to the college database rather than “CAMS Enterprise Test”?

Problem: CAMS Enterprise Test database comes up as the default database to log on to.

Possible Solution: Open the Databases.ssi text file in the CAMSEnterprise folder. Swap the option tags. (CAMSEnterprise/databases.ssi)

CAMS Enterprise seems slower.

Problem: CAMS Enterprise does not respond quickly or pages take longer to display.

Possible Solution: See the SQL troubleshooting item ‘SQL server not responding or losing data.’ and run the script that will defragment the indexes.

Network Issue

Problem: Windows cannot determine the user or computer name. Return value (1722). (Noticed in Event Viewer error logs)

Possible Solution: Value 1722 - "The RPC Server is unavailable" - Usually occurs when DNS servers are not configured properly. There is connectivity but not at the service level. See the Q260371 link below for troubleshooting such issues. One note here, usually it may appear that DNS is set properly but one has to double-check all the aspects of DNS registration/resolution as the problem may not be that obvious. See also Q261007 - It says that this behavior can occur if the address for the configured preferred DNS server on the client is invalid or unreachable.

Do the following to ensure that the SRV records for the AD servers are in DNS properly: (from the DOS prompt) nslookup set type=srv set type=srv _ldap._tcp.dc._msdcs.YOURDOMAIN.COM Server: dnsserver.yourdomain.com Address: 192.168.100.2 you should see something like this: _ldap._tcp.dc._msdcs.YOURDOMAIN.COM SRV service location: priority = 0 weight = 100 port = 389 svr hostname = server1.YOURDOMAIN.COM _ldap._tcp.dc._msdcs.YOURDOMAIN.COM SRV service location: priority = 0 weight = 100 port = 389 svr hostname = server2.YOURDOMAIN.COM server1.YOURDOMAIN.COM internet address = 1.1.1.2 server2.YOURDOMAIN.COM nternet address = 1.1.1.1

Page 34: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 34 of 63

If you don't then you definitely have a DNS problem. You can also view the Microsoft Knowledge Base article at http://support.microsoft.com/kb/q260371/.

Also, insure that your DNS entries are pointed to DNS servers that have your local network information. If you point to external DNS servers vice your own internal DNS server you may have this issue.

How to shut down A COM+ Object.

Problem: How to shut down a COM+ object such as the Crystal Reports component.

Possible Solution: Open the Component Services MCC on the IIS Server. Expand Computers >My Computer >COM+ Applications. Locate the required COM+ package.

Right-click the package and select the Shut down option.

Upgraded server to Active Directory and now CAMS Enterprise does not work

Problem: Active Directory has been installed on the server making it a domain controller. CAMS Enterprise does not work now. Only the main page displays.

Possible Solution: MSDTC needed to be reconfigured. Adding the server to a domain; adding a role of DC causes the machine accounts to be part of the domain. The CAMS COM+ package that uses the account needs to be updated with the new identity. See CAMS Enterprise DTC Configuration in this document.

Cannot upload Document Image documents larger than 200Kb.

Problem: Document Image files that are larger than 200Kb only display a red X.

Possible Solution: Data is stored in SQL table DocImage. DocImage table will reside on the INDEXES file (see database files in enterprise manager). If you plan on storing a large number of student documents then check the size of the hard drive where the cams database resides. Make sure you have lots of free space. Cams will store images,PDF’s, word docs, etc.

Note: Windows 2003 (and later) server customers may have trouble uploading large documents. This applies to any file that is uploaded not only related to document images. It has to do with an IIS setting. Please see page 27 for information on how to change this setting.

Buffering

You will also need to turn on Buffering for the CAMS Enterprise website.

Step-By-Step: Turn on Web Site Buffering

1. Open the IIS MMC and right click on the CAMS Enterprise website and select Properties.

2. Click the Home Directory tab and then click the Configuration button.

3. Click the Options tab and check the Enable buffering option.

4. Click OK all the way out of the Web Site Properties window.

Use SSL with CAMS Enterprise and Portals

Problem: Want to use SSL (HTTPS) with CAMS Enterprise or Portals

Page 35: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 35 of 63

Possible Solution: Any reference to http in global.asa (in CAMSenterprise and all portals) and CAMS_Administration..CAMSLicenses needs to update to https:// Users need to make sure to add the https://<site> to their trusted site list.

Custom routines are not working now. Get Read Fail SSI message.

Problem: Custom routines stopped working after the version 11 update.

Possible Solution: Because of recent change in the handling of ActiveX items by the Operating System, there needs to be a change to any ASP page that was not developed by Three Rivers Systems, Inc.

Each page now must contain the following ASP Code:

<%

Dim ssiPath

Dim uiCommon

ssiPath = Request.QueryString("ssipath")

If Right(ssiPath, 1) = "\" Then

Else

ssiPath = ssiPath & "\"

End If

Set uiCommon = Server.CreateObject("uiCECommon.ceCommon")

%>

Then change the call to the readssi function to read

<%

Call uiCommon.Readssi(ssiPath & "<ssi file name>")

%>

Page 36: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 36 of 63

Move CAMS Enterprise to a different drive.

Problem: Need to move the CAMS Enterprise directories to a different drive on the same server.

Possible Solution: You can easily move CAMS Enterprise to a different drive but not to a different server.

To move:

1. Copy all the CAMS Enterprise folders and your portal folders to the other drive.

2. Take the share name off the old CAMS Enterprise folder but remember what you called it and what permissions it had.

3. Create the same share on the new CAMS Enterprise folder.

4. In IIS repoint the virtual sites to the new locations.

5. If you changed the name of the share to something different then you'll have to go to the global.asa file and make the changes.

Page 37: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 37 of 63

Pictures

Student pictures display a red X.

Problem: Loaded student picture without a problem but picture will not display when selecting the student.

Possible Solution: If the file size is over 200KB it will not display. If the file size is under 200KB then verify the Application("BasePicURL") path in the Global.asa file located in the CAMS Enterprise directory. This needs to be a physical file path represented by a physical drive letter path (and NOT a URL) or a UNC (Uniform Naming Convention) when using COM+ on a separate portal server. Examples are:

Physical: <Drive Letter>:\<Folder>\<Folder>\

UNC: \\<Server Name>\<Share Name>\<Folder>\

When using a UNC for a separate portal server, contact Three Rivers Systems, Inc. support for assistance setting up the share, the appropriate COM+ identity on the portal's COM+ and the attendant permissions on the folders and the shares.

Both the UNC and Physical locations are absolute paths to the student picture folder located on the CAMS Enterprise IIS server.

Verify that the Application("PicPath") has the correct directory entered for your student pictures.

Default Folders for Student Pictures College Database (..\<CAMS Enterprise Folder>\stuPics\ Training Database (..\<CAMS Enterprise Folder>\pics\

Setting NTFS Permissions on the student picture folder. The picture folder is defined in the StuPicturePath field located in the CAMS_Administration >CAMSLicenses SQL table.

Using Web Services: The identity of the application pool used to run the Services virtual directory on the CAMS IIS server (typically Network Service). This user must have read/list/execute NTFS rights to the folders containing student pictures. Non Web Services: The identity of the CAMS COM+ package user. This user is most likely has the proper rights to the student picture folders (used to upload and read the student pictures in CAMS). Generally this user is the <local machine>\IWAM_<Machine Name> user under Windows 2003 Server. Might also be Network Service under Windows Server 2008. This user needs Read/List rights on the folder. If the portals are installed on a different IIS server from CAMS Enterprise, and the COM+ objects are located on this portal server, the Application variable "BasePicURL" should be entered as a UNC path. The COM+ Identity of the CAMS package will then need to be granted read/list rights to both the CAMS Enterprise share and the base NTFS permissions for the picture folder(s).

Warning: Modifying the Global.asa file will cause CAMS to display SSI

Failure in all dropdowns. It disconnects all user from CAMS. You will have

to reset IIS to resolve this issue. Recommend that this is done only when

all users are out of the system.

Page 38: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 38 of 63

Page 39: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 39 of 63

Portals

Some Portal functions are not working.

Problem: Some functions on the portals are not working and/or giving errors.

Possible Solution: Portal Patches have not been installed at your site.

Portal patches are not installed automatically like CAMS Enterprise. We do not want to overwrite any modifications our clients may have made to the portals, so we do not install the patch files for the portals.

This allows our client to review the changes and update their code to match our code.

The current patch files can be found in the "Portal Updates" folder in your CAMS Enterprise install directory.

In this directory you will see 3 more directories:

1. Faculty Portal - contains the patch files for the faculty portal.

2. Read Me - contains the read me documentation for both the faculty and student portals.

3. Student Portal - contains the patch files for the student portal.

If you do not make changes to the portals merely copy the contents of this Faculty and Student portal directory into your install directory of each.

Where are the updates?

Problem: No updates have been applied to my portals.

Possible Solution: See Portals item Some things are not working page Error! Bookmark not defined..

Cannot add attachment, permission denied message.

Problem: When trying to add an attachment to an email from the faculty portal a permission denied error is generated.

Possible Solution: The IUSR account needs Read, Write, Modify permissions on the attachments folder in the Faculty directory.

Page 40: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 40 of 63

Errors received when accessing Course Management.

Problem: Receive errors when trying to access Course Management

Possible Solution: Security settings to specific directories is incorrect. Specific directories must have the correct permissions set to allow Course Management to work. Three Rivers Systems, Inc. will set these permissions but because of security issues sometimes an institution will change the settings.

The following directories in the Portals need the following permissions:

Faculty Portal:

Attachments IUSER -Read, Write, Modify. IWAM -Modify, Read, Write

Uploaded IUSER -Read, Write, Modify. IWAM -Modify, Read, Write

Student Portal:

CourseWebs IUSER -Read, Write IWAM -Modify, Read, Write

Uploaded IUSER -Read, Write IWAM -Modify, Read, Write

Note: This assumes IIS is allowing anonymous access as IUSER_{SERVER} and COM is running as IWAM_{SERVER} Identity.

Page 41: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 41 of 63

Cannot view portal reports

Problem: Get a red X instead of the report.

Possible Solution: You are receiving the "Red X" because you do not have java virtual machine installed on your PC.

Here is a link that might help: http://java.com/en/download/manual.jsp

Got to this page and look for your OS. After the JVM is installed you can then go to http://java.com/en/download/installed.jsp to verify that it is installed and running.

In order to keep browser independent for the portals we have to use Crystal's Smart Java Viewer to view the reports.

Simple Grade Entry

Problem: Is there a simple way to submit grades for midterm and final without having exams, etc.

Possible Solution: Grade calculations from the portals are currently done through calculations of all grade book entries. The easiest way from the portals is to create just one grade book entry called Midterm or Final grade and then enter the actual points and grade. CAMS will use just that entry for the calculation.

Course Management Module No Longer Working

Problem: The course management module is not working form the faculty portal. We have classes going on but the instructors cannot access course management to enter information for the courses.

Server object error 'ASP 0177 : 80040111'

Server.CreateObject Failed

Possible Solution: CourseManagement.dll needed to be re registered.

1. Open Component Services >Computers >My Computer >COM+ Applications >eCAMS >Components.

2. Change the View to Status view.

3. Highlight all CAMSCourseManagement.xxx objects and delete them.

4. Click Action on the Menu bar and select New to start the wizard.

5. Click Next.

6. Click Install new component(s).

7. Navigate to the CAMSEnterprise >MTSDLL folder and select CAMSCourseManagement.dll.

8. Click Next and then click Finish.

9. It is now reregistered.

Faculty cannot register student

Problem: Faculty cannot register student. Says in use by another user.

Possible Solution: Go to CAMS Manager >Semaphores >Registration. Click reset to release semaphores.

Page 42: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 42 of 63

Submitting Final Grades

Problem: When the faculty submit final grades through the faculty portal an email is generated to the person that is set up in Portal Configuration. Where do the grades go in CAMS?

Possible Solution: They go to a batch where they wait for approval. This is located in Registration >Academic >Grades >Authorize Portal Grades. Select the term and then click Find. A list of grades awaiting authorization displays. Once authorized, you can view the grades in the student's maintenance window in Registration >Academic >Maintenance.

Error when trying to pull class list to register from student portal

Problem: ADODB.Recordset error '800a0cc1'

Item cannot be found in the collection corresponding to the requested name or ordinal.

Possible Solution: Student Portal asp files are out of date. After updates ensure that all portal updates are applied.

Cannot change password on faculty portals

Problem: Faculty cannot change their password online.

Possible Solution: The password is case sensitive, so the original password must be typed exactly the same as when it was issued (or previously changed), otherwise there is a mismatch message. Another way to handle this would be to reset their password in the Faculty >Maintain >Modify >More tab >Portal button. Just re-key the existing password (encrypted).

Students or Faculty do not display address information.

Problem: Address information is blank

Possible Solution: The portals are probably using an address type that the student or faculty does not have. Remember, every student or faculty MUST have a home, local, and billing address.

Page 43: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 43 of 63

Faculty cannot access Course Management.

Problem: When faculty click on a course hyperlink they get a security error

Possible Solution: Security entries on two SQL tables have not been completed as described in the CAMS Manager document.

1. Ensure that all faculty types (including teacher’s assistant types) are

entered in the facFacultyType glossary table.

2. Using SQL Server Enterprise Manager navigate to the tables for CAMS Enterprise.

Figure 11: CAMS Enterprise Tables in SQL Server Enterprise Manager

Page 44: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 44 of 63

Find Faculty Type UniqueID

1. Click Tools >SQL Query Analyzer.

2. Type in the following SQL script:

Select * from glossary where category = 2020 3. Click Execute Query button.

This will display all of the faculty types that are in facFacultyType glossary table.

Figure 12: Faculty Types

4. Write down or remember the UniqueID for each type.

Set Access Rights

Right click on the CourseManagementSecurity table and select Open Table >Return All Rows.

Figure 13: Course Management Security table

A list of existing security items displays. (If there are none then you will need to add them to this table.)

1. Set the SecurityLevelDesc to either Full for full access or Partial for teacher’s assistant access.

2. Set the SecurityLevelID field to 1 for Full access and 0 for Partial access.

Note: Teacher’s assistant access will only allow the teacher’s assistant to enter the Course Management area. The instructor will still need to set access to the various areas for the teacher’s assistant in the Utilities >Set TA Access.

If you need to add a type to this table, fill in the FacultyTypeDesc as it was displayed when the script was run and the matching FacultyTypeID.

Page 45: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 45 of 63

Terms do not display in the term dropdown field on the login page in either the student or faculty portal.

Problem: Some terms are not displaying in the dropdown of the login screen.

Possible Solution: There must be one cost center in Tuition and Refund setup that hasn't been closed in this term and there must also be at least one course in the offering for the term before the term will appear in the term drop down field for the student and faculty portals.

Page 46: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 46 of 63

Registration

Grades are not calculating correctly.

Problem: Grades are not calculating correctly or error message 16002 is being received.

Possible Solution: Errors when saving grades usually happen when a grade is missing in your grades table (CAMS Manager > Lookup Table options > Custom Grade Entry). All grades must be defined here for the grade catalogs the students are assigned to. Even if you assign a "blank" grade to a student it still has to be defined in your grades table.

One way to find out what grades are missing is to Rebuild All Grades from Cams Manager. When the process starts, the first thing CAMS does is check to make sure all the grades in your student academic table (sracademic) are defined. If they aren't then the process sTops and displays the missing grades.

When scheduling a class cannot enter a time.

Problem: A time cannot be entered in the time fields.

Possible Solution: Click in either time field and then press either the up or down arrow on your keyboard. This will start the time and you will now be able to adjust it.

Troubleshooting steps for Registration issues

Problem: Registration classes, amounts or other not correct.

Possible Solution: Ninety percent of all tuition/refund issues are centered around incomplete setup. To start troubleshooting, you'll need the following pieces of information:

A student (Name or ID)

The Term being registered.

Open the Registration, Academic, Register (Offical/Unoffical) screen for this student/term and click load. Jot down the registered courses, making a note on the Cost Center/Refund Schedule attached to each course. This information is available in the offering grid and in the registered list. Don't forget to look at the dropped tab for courses that may have been dropped.

Click on the Student Status link and jot down the following information:

Campus

Cost Type

Refund Type

Checking for Tuition Questions you'll need the following:

Student Campus

Student Cost Type

Course Cost Center

Page 47: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 47 of 63

Open Registration->Offering-Tuition & Refund Setup. Find the term/cost center in question and double click to look at the cost type definition (You might have to look at multiple cost centers if the student has registered for more than one. Make sure that the student's cost center is setup for each registered cost center.

Incidental Fees, Insurance Fees are determined based upon the Student's Campus. Look at the Campuses reference table, find the student's campus and look at the defined Cost Center. This cost center will be used to determine which Incidental and Insurance fees to use. Make sure that this cost center is defined in Tuition Setup. Make sure that the incidental and Add/Drop transdocs are defined in the Campuses Reference Table.

Click on the CostCenter reference table. Make sure that the Tuition Charge, LabFee (amount determined by the course LabFee field), Insurance Fee, Hourly Fee (amount determined by the hourly fee field on the offering record), LateRegFeeDoc, and AuditFeeDoc are completed properly. Remember blank values will produce a blank transaction document in Billing if the system determines that a fee needs to be charged.

Click on the Cost Type reference table. CAMS allows clients to have a student based billing by defining different cost types documents. If a Cost Type has a Tuition Document defined (non blank), then all the above documents will be picked up from the Cost Type reference. Again, if the student's cost type has a non blank Tuition document, then all the other associated tuition documents MUST also be completed.

For refund Issues the process is similar except the information you need is the following:

Cost Center from the course

Refund Schedule from the course

Refund Type from the student

Click on the refunds tab in Offering Tuition Setup and make sure that the Refund Schedule/Refund Type are setup properly. Refunds are calculated whenever a negative tuition amount is determined. If the effective registration date <= the First day of class defined in the refund schedule a 100% refund is always used. Refund percentages are based upon if the Effective Registration Date <= Refund Date. Schools should always have a date with a zero refund percentage.

At this point you have all the information needed to determine what happened. Remember, CAMS makes an exact match so Blank <> Default

Cannot create a Student Status record

Problem: Cannot create a Student Status record for a student who has previous status records.

Possible Solution: Check the latest status record that the student has listed. In the TermCalendar reference table verify that that term is not listed twice.

Cannot register a student.

Problem: Cannot register a student.

Possible Solution: Determine the term of the last status record that the student has. Then check the TermCalendar reference table and ensure that the term is not listed twice. If it is you will have to change one as CAMS Enterprise cannot determine which one to use to make the next status record.

Possible Solution: The Main Cost Center has been deleted. This cost center must always exist even if it is not used.

Page 48: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 48 of 63

Cannot register a student

Problem: Get a debug error when trying to register the student.

Possible Solution: The student has a Cost Type that has not been set up in the Cost Center that is used for the course. Change the student’s Cost Type or add the Cost Type to the Cost Center.

Cannot assign a faculty member to a course.

Problem: Cannot assign a faculty member to a course. Receive an error message.

Possible Solution: Ensure that there is a cost structure set up for the term and that the class has the cost center and refund schedule applied including From and To dates.

Cannot create a new class in Offering Maintenance.

Problem: Receive an error message. Error number: 9017

Error Description: Unable to complete RegCourseOffering.busCourseOffering. WriteNewCourse method.

Possible Solution: You are trying to add a course with duplicate Term, Department, CourseID, Course Type, and Section. You must ensure that a combination of all these fields is not duplicated. Change the section number.

Incorrect TransDocs being charged.

Problem: After registering a student the wrong TransDocs are displaying on the statement.

Possible Solution: If there are TransDocs entered into the Cost Type table they will override the TransDocs that are listed in the Cost Center table.

Grade Entry grades do not display.

Problem: When entering grades for students, the grades are available on the data grid dropdown, but when double clicking on the student to go to the detail screen there are no grades in the dropdown.

Possible Solution: The Grade Catalog has not been defined for the student. The grades on the grid are a unique list of all grade catalogs. The detail is based upon the student's grade catalog only. Ensure that the grade catalog in use for the student has grades defined.

Page 49: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 49 of 63

Enrollment counts are not correct.

Problem: Enrollment counts are different when looking at reports and offering maintenance or we know eight people are enrolled but the report says only six.

Possible Solution: Rebuild Enrollment Counts from CAMS Manager >Rebuild >Registration >Enrollment Counts. Then verify numbers. Additionally, if courses are Cross-Listed then when running reports it will display a total of all students registered for all cross-listed courses. But, when viewing the individual course in offering maintenance it will only show those students actually registered for that particular course.

Page 50: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 50 of 63

Reports

Fin Aid BYOR Summary By Student Registered Hours

Problem: Registered Hours field displays only zeros.

Possible Solution: You must select a registration term for evaluation.

Page 51: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 51 of 63

SQL

SQL server not responding or losing data.

Problem: SQL server doesn’t respond or seems to be losing data.

Possible Solution: Look at your database and right click and go to properties. On the option tab the option "Auto Shrink" should be set for the main purpose of shrinking up the space taken by your transaction log in SQL.

Also needed is a daily maintenance plan and backup for SQL. In enterprise manager this is setup under "database maintenance". On the optimization tab you should check the box that says "Update the statistics used by the query optimizer with 20% sampling". Also "Shrink database" should be checked with 30% space remaining.

On the Integrity tab you should check the "check database integrity" with include indexes and "attempt to repair any minor problems".

If you’re using another software package to perform SQL backups be sure you do a daily backup. Database indexes should be defragmented on a daily basis. This can be set up as a SQL job that runs during off hours. In your <CAMS Enterprise>\SQL folder there are SQL scripts that can be used for this job. The file, defragment_indexes.sql, can be sued for SQL 2000. The file, defragment_indexes_SQL2005.sql, can be used for SQL 2005 and 2008.

Cannot log on to Ad-Hoc Query.

Problem: Cannot log on to Ad-Hoc Query screen.

Possible Solution: The Ad-Hoc query screen required an SQL user to be setup.

1. To setup an SQL user, open Enterprise Manager, select Security, then logins.

2. Add a new user, password, then grant that user access rights to those objects they will need to be using.

When using the ad-hoc query generator, this is the user you will be using to log into the database.

Page 52: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 52 of 63

Msg 7391, The operation could not be performed because the OLE DB provider 'SQLOLEDB' was unable to begin a distributed transaction. OLE/DB provider returned message: New transaction cannot enlist in the specified transaction coordinator.

Problem: The problem occurs because Microsoft Distributed Transaction Coordinator (MSDTC) is not configured for network access. By default, the network access settings of MSDTC are disabled on new installations of SQL Server 2000 on computers running Windows Server 2003, Enterprise Edition or Standard Edition.

Possible Solution: Configure the MSDTC for network access using the steps outlined in the CAMS Enterprise DTC Configuration section of this document.

Note: In some cases, you must start the DTC service before you start the computer that is running SQL Server so that the linked server distributed queries work well.

Execute permission denied on object 'sp_addextendedproc', database 'master', owner 'dbo'

Problem: Cannot log into the SQL database.

Possible Solution: The hard drive might be full. If you are using MS enterprise manager you can specify to truncate the transaction log. Another option is to set the transaction log recovery model to "simple". This eliminates the problem of huge transaction logs.

Note: However you will not be able to role back the database to some point in the past

If you are doing all of the above you may have to look to see if some other item may be filling up the hard drive.

Page 53: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 53 of 63

We switched to new SQL servers and now cannot connect to CAMS Enterprise.

Problem: Moved the databases to a new server setup but CAMS Enterprise will not work.. Some errors that may be seen are Internet Client Error: Request Timeout and Object required: ‘objCamsUsers.GetLicenseList(…)’. Another error you may notice in the Error Log:

Event Type: Error

Event Source: VBRuntime

Event Category: None

Event ID: 1

Date: 6/12/2006

Time: 9:32:40 AM

User: N/A

Computer: CAMS1

Description:

The VB Application identified by the event source logged this Application

CamsUser: Thread ID: 4556 ,Logged: New transaction cannot enlist in

the specified transaction coordinator. [-2147168246)

For more information, see Help and Support Center at

http://go.microsoft.com/fwlink/events.asp.

Possible Solution:

1. Change the database server name in CE global.asa, and all the portal’s global.asa to the new server name, Also in the SQLServerName field of the CAMS_Administration..CAMSLicenses table from existing server name to the new server name.

2. Ensure that MSDTC is set up according to the pre-installation checklist and then reboot the IIS server. When it is completely up restart the SQL server. See Msg 7391 on page 52.

3. Ensure that DNS is correctly set up. Have TWO people verify the IP addresses.

4. Ensure that all CAMS related databases, CAMS_Administration, CAMS_Enterprise, and CAMS_Enterprise_Test, have the CAMSUser SQL account as the dbo.

5. Ensure that all CAMS related databases, CAMS_Administration, CAMS_Enterprise, and CAMS_Enterprise_Test, have the CAMSUser SQL account as the dbo.

Page 54: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 54 of 63

We cannot log into CAMS. Receive DLL xp_ctnhashproc.dll error

Problem: A Microsoft update may have occurred and now we cannot log into CAMS Enterprise. We get a DLL xp_ctnhashproc.dll error.

Possible Solution: On each node in the SQL Cluster, copy the xp_CTNHashProc.dll (typically located in the SQL subdirectory under the root of CAMSEnterprise) to the C:\program files\Microsoft SQL Server\Binn folder. This file should have NTFS permissions Everyone (Read,Execute). Once the file is in place, run the EnableCTNHash.sql (located in the same directory as the dll above).

Page 55: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 55 of 63

Terminal Services

How to transfer a file between host and client.

Problem: Cannot transfer files when in Terminal Services.

Possible Solution:

1. Setup the feature when you first connect to the host from client. Go to Start > Programs > Accessories > Communications > Remote DeskTop Connection.

2. From the Remote DeskTop Connection dialog box, enter the host name in Computer first. Then click Options>>. Select Local Resource tab. Select Disk drives check box to enable redirection of the local drives in the remote access session.

Figure 14: Disk drives check box

3. Then click Connect to start the session. This will map all of the drives on your computer to the server you are connecting to. The files can then be copied with Windows Explorer.

Page 56: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 56 of 63

Windows 2003

Setting up DTC for network access

Problem: Setting up DTC for network access.

Possible Solution: See SQL Item Msg 7391 Page 52

Before call to mdbCAMSLicensesObj.queryByDBName….

Problem: Cannot login to CAMS.

Possible Solution: See SQL Item Msg 7391 Page 52

Setting Up MSDTC Security Settings (Both machines 2003 servers.)

Problem: Set up MSDTC Security if both machines are Windows 2003 servers.

Possible Solution: See CAMS Enterprise DTC Configuration in this document.

Setting Up MSDTC Security Settings (One 2003 server and one 2000 server)

Problem: Set up MSDTC Security if one machine is a Windows 2000 server if the Windows 2003 server has SP1 installed.

Possible Solution: See CAMS Enterprise DTC Configuration in this document.

Page 57: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 57 of 63

CAMS Enterprise DTC Configuration Windows 2003

These changes can result in an inoperable/unstable server if not applied correctly. These changes should be made by a qualified network technician. If you have any questions or concerns, please contact Three Rivers Systems.

CAMS Enterprise requires the same Distributed Transaction Coordinator (DTC) settings on the IIS Server running CAMS Enterprise and the SQL Server for CAMS Enterprise.

Step-By-Step: Configure DTC on a Windows 2003 or 2003 R2 Server

1. Run dcomcnfg from the Windows Run command.

2. Expand Components Services and then Computers.

3. Right click on My Computer and go to Properties.

4. In the My Computer Properties window, click on the MSDTC tab.

5. Click on the Security Configuration… button on the MSDTC tab.

6. On the Security Configuration window:

a. Check the box Network DTC Access

b. Check the box Allow Remote Clients

c. Check the box Allow Inbound

d. Check the box Allow Outbound

e. Leave the radio button at Mutual Authentication Required (the default setting)

f. DTC Logon Account should be NT Authority\Network Service

g. Click OK to close the security configuration window

h. Click OK and click Yes on the DTC Console Message window to restart the MS DTC service

i. Click OK on the DTC Console Message confirmation window

7. Click OK to close the My Computer Properties window.

8. Close the Component Services window.

DTCTESTER, a free tool available from Microsoft downloads, can be used to test your DTC settings.

The Mutual Authentication Required Transaction Manager Communication mode adds support for mutual authentication starting in Windows 2003 SP1. Use the Incoming Caller Authentication Required mode when SQL is running in a clustered environment and the No Authentication Required mode if the server running CAMS Enterprise and the SQL server are in different domains / workgroups or one or both are running the Windows 2000 OS and Mutual Authentication Required in all other cases. The Transaction Manager Communication mode must be the same on the Windows server running CAMS Enterprise and the Windows server running SQL server that is used by CAMS Enterprise. See Microsoft KB article 899191 for details.

Page 58: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 58 of 63

DTC depends on the ability of both servers involved in the transaction (in this case the IIS server running CAMS Enterprise and the SQL server for CAMS Enterprise) to resolve NetBIOS computer names to IP addresses in a quick, reliable fashion. The ping.exe program resolves a name and sends ICMP echo requests to that IP address. To test, ping the host name of the DNS server(s) your servers use. Then ping the NetBIOS name of the IIS server running CAMS Enterprise from the SQL server for CAMS enterprise. Finally, ping the NetBIOS name of the SQL server for CAMS Enterprise the IIS server running CAMS Enterprise. If the ping test(s) fail, verify that the host (A) record entries are correct on your DNS server, that your DNS server is reachable and that your network and firewall(s) allow DNS (UDP port 25) and ICMP echo requests to pass between the servers and between the servers and your DNS server. If NetBIOS cannot reliably resolve names using DNS, you can temporarily add entries to (%systemroot%\System32\Drivers\Etc\hosts) on both servers. See http://technet.microsoft.com/en-us/library/bb727005.aspx for more details on host name resolution.

How to control RPC dynamic port allocation on Windows Server 2003

By default, the RPC endpoint mapper on Windows Server 2003 can allocate any port within the range 1024-65535 to the MSDTC service. This is documented in Microsoft KB article 832017. Search for "RPC randomly allocated high TCP ports"

If one or both machines are Windows Server 2003, you can limit the port allocated by the TCP endpoint mapper by editing the registry using the following procedure which is documented in Microsoft KB article 306843. You must use the Regedt32.exe program instead of the Regedit.exe program. The Regedit.exe program does not support the REG_MULTI_SZ data type that is required for the Ports value.

1) In Registry Editor, expand

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc 2) Click the RPC folder, and then click add Key on the Edit menu. 3) In the Add Key dialog box, type Internet in the Key Name box, and then

click OK. 4) Click the Internet folder, and then click Add Value on the Edit menu. 5) In the Add Value dialog box, type Ports in the Value Name box. 6) In the Data Type box, select REG_MULTI_SZ, and then click OK. 7) In the Multi-String Editor dialog box, specify the port or ports that you

want RPC to use for dynamic port allocation (for example 5000-5020) in the Data box, and then click OK.

8) Click the Internet folder, and then click Add Value on the Edit menu. 9) In the Data Type box, select REG_SZ, and then click OK 10) In the String Editor dialog box, enter Y 11) Restart the computer

Each string value that you enter in the Ports value specifies either a single port or an inclusive range of ports. For example, to open port 5000, specify "5000". To open port 5000 to port 5020 inclusive, specify "5000-5020". You can specify multiple ports or ports ranges by specifying one port or port range per line. All ports must be in the range of 1024 to 65535. If any port is outside this range or if any string is invalid, RPC treats the whole configuration as invalid.

For more information about how to control RPC dynamic port allocation on Windows 2003, see Microsoft KB article 300083.

Page 59: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 59 of 63

CAMS Enterprise DTC Configuration Windows 2008

These changes can result in an inoperable/unstable server if not applied correctly. These changes should be made by a qualified network technician. If you have any questions or concerns, please contact Three Rivers Systems.

CAMS Enterprise requires the same Distributed Transaction Coordinator (DTC) settings on the IIS Server running CAMS Enterprise and the SQL Server for CAMS Enterprise.

Step-By-Step: Configure DTC on a Windows 2008 or 2008 R2 Server

1. Run dcomcnfg from the Windows Run command.

2. Expand Components Services and then Computers.

3. Expand My Computer and Distributed Transaction Coordinator.

4. Right-click on Local DTC and select Properties from the menu.

5. Click on the Security tab of the Local DTC Properties window and:

a. Check the box Network DTC Access

b. Check the box Allow Remote Clients

c. Check the box Allow Inbound

d. Check the box Allow Outbound

e. Leave the radio button at Mutual Authentication Required (the default setting)

f. DTC Logon Account should be NT Authority\Network Service

g. Click OK and click Yes on the DTC Console Message window to restart the MS DTC service

h. Click OK on the DTC Console Message confirmation window

6. Close the Component Services window.

7. If the Windows firewall is configured to block either inbound or outbound connections, enable the Distributed Transaction Coordinator rules for RPC, RPC-EPMAP, TCP-In and TCP-Out. These rules can be found in the Windows Firewall with Advanced Security MMC.

DTCTESTER, a free tool available from Microsoft downloads, can be used to test your DTC settings.

The Mutual Authentication Required Transaction Manager Communication mode adds support for mutual authentication starting in Windows 2003 SP1. Use the Incoming Caller Authentication Required mode when SQL is running in a clustered environment and the No Authentication Required mode if the server running CAMS Enterprise and the SQL server are in different domains / workgroups or one or both are running the Windows 2000 OS and Mutual Authentication Required in all other cases. The Transaction Manager Communication mode must be the same on the Windows server running CAMS Enterprise and the Windows server running SQL server that is used by CAMS Enterprise. See Microsoft KB article 899191 for details.

DTC depends on the ability of both servers involved in the transaction (in this case the IIS server running CAMS Enterprise and the SQL server for CAMS

Page 60: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 60 of 63

Enterprise) to resolve NetBIOS computer names to IP addresses in a quick, reliable fashion. The ping.exe program resolves a name and sends ICMP echo requests to that IP address. To test, ping the host name of the DNS server(s) your servers use. Then ping the NetBIOS name of the IIS server running CAMS Enterprise from the SQL server for CAMS enterprise. Finally, ping the NetBIOS name of the SQL server for CAMS Enterprise the IIS server running CAMS Enterprise. If the ping test(s) fail, verify that the host (A) record entries are correct on your DNS server, that your DNS server is reachable and that your network and firewall(s) allow DNS (UDP port 25) and ICMP echo requests to pass between the servers and between the servers and your DNS server. If NetBIOS cannot reliably resolve names using DNS, you can temporarily add entries to (%systemroot%\System32\Drivers\Etc\hosts) on both servers. See http://technet.microsoft.com/en-us/library/bb727005.aspx for more details on host name resolution.

Page 61: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 61 of 63

Page 62: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 62 of 63

Index

1098 Error ................................................................ 14 9017 ......................................................................... 48 Access Campus ....................................................... 11 Access Rights .......................................................... 44 ActieXViewer Code .................................................. 18 Active Directory ........................................................ 34 Address information is missing................................. 42 Ad-Hoc Query .......................................................... 51 Administration database ........................................... 16 Auto Shrink .............................................................. 51 Award Import Error ................................................... 29 axCEExport.trsExport ............................................... 20 BasePicURL ....................................................... 16, 37 Batch cannot distribute ............................................. 13 Blank Select Student Screen ................................... 11 Buffering ................................................................... 34 Campus .................................................................... 46 CAMS Enterprise Share Name ................................ 36 CAMS_Administration Database .............................. 53 CAMSLicense table .................................................. 16 CAMSLicense Table ................................................ 53 CAMSUser ............................................................... 11 CAMSUser SQL Account dbo .................................. 53 Cannot Connect ....................................................... 53 Cannot create a Student Status Record ................... 47 Cannot export files over a certain size ..................... 27 Cannot Import .......................................................... 32 Cannot Log In........................................................... 54 Cannot Login To CAMS Enterprise .......................... 56 Cannot Register a Student ....................................... 48 Cannot register student ............................................ 47 Cannot register student. ........................................... 41 CDONTS .................................................................. 24 CODEBASEIP .......................................................... 16 College Database Login ........................................... 15 College Name .......................................................... 16 COM+....................................................................... 34 COM+ Shutdown Object .......................................... 34 Configuration Record ............................................... 15 Connectivity ............................................................. 16 Converted Data ........................................................ 15 Copy College Database To Training Database ........ 22 Cost Center ........................................................ 46, 48 Cost Type ........................................................... 46, 48 Course cannot assign faculty ................................... 48 Course Management Module ................................... 41 Course Management No Access.............................. 43 Course Management Security Error ......................... 43 Course Management Security table ......................... 44 CourseManagement.dll ............................................ 41 CRAXDRT Error ....................................................... 19 Cross-Listed Courses affect enrollment count ......... 49 Crystal Reports ........................................................ 18 Crystal Reports ActiveX ........................................... 21 Crystal Reports crdb_ado.dll .................................... 21 Crystal Reports crdb_fielddef.dll .............................. 21 Crystal Runtime........................................................ 20 Custom pages do not work ...................................... 35 Custom Reports ....................................................... 20 Database Object ...................................................... 16

Databases.ssi........................................................... 33 Default Database ..................................................... 33 Default Term ............................................................ 11 DNS ......................................................................... 16 DNS Issue ................................................................ 33 Document Image Buffering Setting .......................... 34 Document Image size .............................................. 34 DTC For Network Access ......................................... 56 EDE Award File Error ............................................... 29 Email Attachements ........................................... 25, 26 Email From Student BYOR ...................................... 25 Email Not Working ................................................... 24 Email NTFS Permissions ......................................... 24 Email routing ...................................................... 26, 31 Email through Exchange server ......................... 26, 31 EnableCTNHash.sql ................................................. 54 Enrollment Counts are not correct ............................ 49 Enterprise Is Slower ................................................. 33 Enterprise Test ......................................................... 33 Error 9017 ................................................................ 48 Error Occurred Creatign Report Object .................... 19 Error when trying to pull class list ............................. 42 Errors received when accessing Course Management

............................................................................. 40 Exchange server ................................................ 26, 31 Execute Permission Denied ..................................... 52 Expected Entrance Term ......................................... 11 Export From Crystal Reports .................................... 20 Exporting .................................................................. 27 facFacultyType glossary table .................................. 43 Faculty cannot assign to course ............................... 48 Faculty cannot register student. ............................... 41 Faculty Type UniqueID ............................................. 44 Field Definition File ................................................... 19 File size for 2003 Servers ........................................ 34 File size for document images.................................. 34 Final Grades............................................................. 42 Generate SSIs.......................................................... 15 Global ASA .............................................................. 16 Global.asa ................................................................ 32 Grades do not display .............................................. 48 Grades Not Calculating Correctly ............................. 46 High School delete it ................................................ 11 Holds Billing Office ................................................... 13 HTTPS ............................................................... 32, 35 IESERVERIP............................................................ 16 Importing file gives an error ...................................... 31 Incorrect TransDoc used .......................................... 48 Invalid Cost Setup .................................................... 48 IP 16 Item cannot be found in the collection ...................... 42 Large files to export .................................................. 27 Last Term ................................................................. 11 Last Term Used........................................................ 11 Local policy of this system does not allow you to log

on interactively ..................................................... 17 Logon Failed ............................................................ 19 Lookup Tables.......................................................... 15 mdbCAMSLicensesObj.queryByDBName ............... 56 Move CAMS Enterprise ............................................ 36

Page 63: Enterprise - Lane College

CAMS Enterprise – Troubleshooting

Page 63 of 63

MS DTC ................................................................... 52 MSDTC .................................................................... 53 MSDTC On Windows 2003 ...................................... 56 MSSQLServer service .............................................. 31 Network Issue .......................................................... 33 New SQL Database ................................................. 53 objCamsUsers.GetLicenseList( ................................ 53 Object Required ....................................................... 19 Offering Maintenance cannot create new class ....... 48 OLE DB Provider ...................................................... 52 Only Show Output .................................................... 25 Password cannot change ......................................... 42 Path Not Found SSI error message ......................... 15 Pictures Display X .................................................... 37 Portal Errors ............................................................. 39 Portal Permissions ................................................... 40 Portal Reports Cannot View ..................................... 41 Portals

Cannot Add Attachments ..................................... 39 Some Items Are Not Working ............................... 39 Where Are The Updates ...................................... 39

Portals Grade Entry .................................................. 41 Prospect Record ...................................................... 11 ProtoView ................................................................. 20 Read Fail SSI ........................................................... 35 Red X ....................................................................... 18 Regenerate SSIs ...................................................... 11 Register a Student Debug Error ............................... 48 Registered Hours field is zeros ................................ 50 Registration Issues Troubleshooting ........................ 46 Remap TTX .............................................................. 19 Reports Do Not Display ............................................ 18 Reports Not Working ................................................ 19 Reports Used To Work ............................................. 20 Reregister CourseManagement.dll ........................... 41 Reset IIS .................................................................. 16 Routines fail ............................................................. 35 Secure Socket Layers .............................................. 35 Secure Web Using HTTPS ...................................... 32 Select Student Screen Blank ................................... 11 Share Name for CAMS Enterprise ........................... 36 Shutdown COM+ Object .......................................... 34 Slower ...................................................................... 33

sp_addextendedproc ................................................ 52 SQL Backup ............................................................. 51 SQL Losing Data ...................................................... 51 SQL Query Analyzer ................................................ 44 SQL Server Not Responding .................................... 51 SQLOLEDB .............................................................. 52 SSI Generate Fail ..................................................... 15 SSL .......................................................................... 35 Status record cannot create ..................................... 47 Step-By-Step

Configure DTC on a Windows 2003 or 2003 R2 Server .............................................................. 57

Configure DTC on a Windows 2008 or 2008 R2 Server .............................................................. 59

Turn on Web Site Buffering .................................. 34 Student cannot register ............................................ 47 Student Pictures ....................................................... 37 Student Status record cannot create ........................ 47 Submitting Final Grades ........................................... 42 Summary By Student Report ................................... 50 Super User ............................................................... 12 Teacher's Assistant Access ..................................... 44 Terminal Services Transfer File ............................... 55 Time

Cannot Enter In Field ........................................... 46 TransDoc is incorrect ............................................... 48 Truncate Transaction Log ........................................ 52 Trusted Sites ............................................................ 18 TTX .......................................................................... 19 Upgraded Crystal Reports ........................................ 20 User Setting Access Campus................................... 12 UserRegParameters ................................................ 11 Verify Database........................................................ 19 Version Check Failure .............................................. 16 Windows 2003.......................................................... 56 Windows 2003 and Windows 2000 Setup ................ 56 Windows 2003 SP1 .................................................. 56 Windows XP Error Accessing Windows 2008 .......... 10 WriteNewCourse ...................................................... 48 Wrong name or password ........................................ 31 Wrong Term displays ............................................... 11 X Displays ................................................................ 18 xp_ctnhashproc.dll Error .......................................... 54