MWeb™ Universal Administrator's Guide
Troubleshooting
Contents
Expand All Answers Collapse All Answers
General Problems
1. An error message was displayed.
There is a complete list of error messages and diagnostics in alphabetical order
here.
2. An error message says Notify Systems Planning. What should I do?
Please send us an email giving the full text of the error message (cut and paste the message or send a screenshot if you can). We also request additional details as described in
Reporting Problems.
3. I lost my password.
We do not store your passwords, so we must request you to send a file from the server which we can analyze. Use PKZip or WinZip to compress the file /unidata/MWebUni.dat, then attach it to an email to info@systemsplanning.com and we will recover the password. (In order to avoid spam filtering, use the word MWeb in the subject line.)
In order to verify that you are the Project Owner, you must provide the MWeb order number and the credit-card number originally used to purchase MWeb. Because of the time it takes to recover your password, we reserve the right to bill $30.00 for repeated requests.
Ordering and Downloading Problems
4. How do I download from a different computer?
Here is the procedure:
- Go to http://store.esellerate.net/support
- Enter your email address and your order number and log on
- Click the here link under the Re-download section to view your original receipt
- Click the yellow and black Download Now button
Then use the normal installation procedure with the downloaded file.
5. The Webstore is asking about product activation.
We do not use product activation, so this means that some link has gone wrong. Follow the instructions in the previous item to re-download.
Installation Problems
6. The server is asking for a user ID and password
If there is a popup logon box it is from IIS, not from MWeb. This means that the program has the wrong permissions. See the subsection "Setting permissions on physical directories"
here.
7. Installation failed with the message "Could not grant ... full permissions ..."
If you are using a virtual server you may need to follow the instructions under "Setting permissions on physical directories" and "Change permissions in TEMP directory" in
this chapter.
8. After installation I get a 404 (File not found) message when I try to run MWeb
If you are using Windows Server, you may need to set the Web Service Extensions to allow executable programs to run. This is normally handled by the installation program, but might have gone wrong. See "Allow programs to run" in
this chapter.
9. When I go to http://www.example.org/uni/ I get an error "File cannot be run"
- See if c:\mweb\unicgi\MWebUni.exe exists.
- Check that IIS is allowed to run that program (see previous answer).
- Check that IIS has "Execute" permission on /unicgi/.
- Make sure IIS is allowed to redirect from /uni/index.htm to /unicgi/MWebUni.exe. It may be turned of for security reasons.
Configuring Problems
Databases
10. Why does the server timeout when adding a Database?
When you add a Database, a record of this is sent to the Systems Planning registration server. It may be that one that is timing out. Make sure your server is allowed to access other servers.
11. Why do configuration lists say Not applicable?
For MWeb Enterprise and PastPerfect-Online databases, MWeb Universal uses the configuration and index of the original database. Changes made in Universal would not be sent to the original database because this would affect the other users of that database. Therefore, make required configuration changes to the original database.
12. Why does the Database list show spaces after backslashes?
This is done so the display will wrap and not be too wide. The spaces are inserted for display purposes only and do not affect your Database.
13. The wizard did not add tables
A limitation of the Microsoft Visual FoxPro ODBC driver means that the wizard cannot fill the list of tables if the FoxPro database is a DBC; you will have to add each table by hand. If possible, use free tables to avoid this problem.
MySQL
14. Can't connect to MySQL server on ... (10061)
Check that the MySQL server is installed and running. To test it, follow these steps:
- From a command prompt on the Database Server, run mysql -u root -p
- Enter the root password you assigned when MySQL was installed
- Enter use mweb;
- Enter select count(*) from subset;
You should see a number in the results.
Indexing Problems
15. Why does indexing fail?
Indexing may fail if the incorrect
Encoding is set
16. The indexing program has been running too long
Normally indexing takes a few minutes, up to a few hours for a large database. The status report in your browser should change periodically as the indexer works its way through the Database. If there is no change overnight, click the Stop button in the browser and notify Systems Planning. For MARC files, make sure the files adhere strictly to the format.
17. How can I speed up indexing?
We have optimized the indexing process as much as possible. However, there are things you can do. Most important, eliminate unimportant tables and fields from the indexing. Do this by clicking the Configure button for the Database, selecting Configure Tables and unchecking the Use This Table checkbox for unimportant tables. Then click Configure Fields and uncheck the Use This Field checkbox for unimportant fields.
A future release of MWeb will allow you to reindex only tables that have changed rather than the entire Database. However, if most of the tables have changed, it will still be faster to reindex the entire Database.
18. I got an error message like "X056: SQLite do failed: database or disk is full ..."
Are you creating the index on a disk formated with FAT32? If so, files are limited to 2 gigabytes in size. A Database of a million records or more may generate an index that big. Put the index on an NTFS drive instead.
Self-hosted PastPerfect databases
19. Why did indexing fail with the message "X056: DBD::ODBC::db selectall_hashref failed: [Microsoft][ODBC Visual FoxPro Driver]File ... does not exist."?
If you did not export some tables in the PastPerfect web-export wizard, go to the MWeb Universal Configure Tables display and uncheck the tables you did not export, then reindex
Search Problems
20. My searches are too slow.
21. How can I specify case-sensitivity in searches?
Searches are not case-sensitive in MWeb. There is no way to specify this. You may enter search terms in any case you wish and the results will be the same.
MARC files
22. How can I search the Leader or Fixed Fields?
Searching the Leader and Fixed Fields is not really practical. MWeb limits a keyword in its index to 15 characters. Therefore whatever you enter as a search term, only the first 15 characters will be matched. In addition, the MWeb index is a keyword index, so you cannot use embedded spaces in a search term.
23. How can I search for indicators?
MWeb's keyword index stores values as single words, without spaces. Therefore a pair of indicators like " 4" is stored as "4". This means you cannot search for indicators containing a space. This capability may be added in a later release.
24. How can I search for multiple subfields?
Subfield delimiters are considered to be word-separators in MWeb. Therefore each subfield is treated as one or more words and put into the index separately. You cannot specify the subfield to be searched. However, you may use phrase searching to span the subfields. For example, you can search for "smith john 1919" using the quotation marks and you will get the 1xx subfields $a and $d if they are adjacent in the MARC record.
Display Problems
25. Why are my field labels changed? For example, my field "Series #" displays as "Series Number".
The MWeb Universal Data Connectors return data from your Databases in XML. The field labels become XML element names (the names between the < and the >), and these are not allowed to contain ampersands or number signs. Therefore the Data Connectors replace ampersands (&) with the word "and", and number signs (#) by the word "Number".
26. What is this funny symbol 〓 doing in my data?
This symbol is displayed by MWeb when it has detected an invalid UTF-8 code. Invalid codes will cause display problems, so this symbol (called a Geta) is used instead. This substitution is just for display -- your original data is not modified in any way.
27. There are no records shown in Search Results, or no fields shown in Full Records.
Three data elements control what fields are displayed:
- the Use This Table checkbox in Configure Tables must be checked for any of the fields in the table to be used in the Project
- the Use This Field checkbox in Configure Fields must be checked for the field to be used in the Project
- finally, the field must be assigned a display sequence number for it to be displayed. The display sequence number used depends on what kind of display is being shown. The Data Display Sequence field controls the Search Results data layout, the Thumbnail Display Sequence field controls the Search Results thumbnail layout, and the Full Record Sequence field controls the Full Record layout.
In other words, make sure that the table has Use This Table checked, and that some fields have both their Use This Field checkbox checked, and also have a display sequence number that is not zero. (Incidentally, the three display sequence numbers also control the order the fields are displayed.)
28. Why do some of my Search Results have too many columns and some with no column headings?
The table in question may have a primary key made up from multiple fields in the table. Logon as the Administrator and click the Databases button and go to Configure Tables to correct this.
29. My long fields are truncated
At present, MWeb Universal has a limit of 60,000 characters per field. Please contact Systems Planning if this is a problem
30. Accent marks are over the wrong letters
Some browsers, such as Firefox 2.0, do not display UTF-8 combining diacritics correctly. Others, such as IE7, show the data correctly. This is a problem when diacritics are stored as separate characters, such as in MARC files.
Tables
31. Tables have no borders around empty cells
Unfortunately Internet Explorer 6 does not implement this feature correctly (Internet Explorer 7, Firefox, and Safari handle it correctly). Instead, it is necessary to insert a (non-breaking space character) into each empty cell. To do this, change the relevant XSLT stylesheet from
<td><xsl:apply-templates /></td>
to
<xsl:choose>
<xsl:when test=normalize-space(.)>
<td><xsl:apply-templates /></td>
</xsl:when>
<xsl:otherwise>
<td> </td>
</xsl:otherwise>
</xsl:choose>
This will have no adverse effect on other browsers.
Images
32. I can't see any images
- If the display says "No image", the image linking in your database is incorrect.
- If you see a pseudo-image that browsers show when they can't find an image, or if you see only a link to the full image, right-click on it and select Properties to see where the MWeb believes the image should be.
All contents of website, including HTML and JavaScript,
copyright © 1996-2010 Systems Planning. MWeb, InFORMer, and CAPS are trademarks of Selago Design, Inc. MARCView and MARConvert are trademarks of OCLC, Inc.
Systems Planning
4915 Redford Road
Bethesda, MD 20816 USA
(301) 652-1231
info@systemsplanning.com
Including the name of one of our products in the subject of your message will bypass all spam filters.
