[Contents] [Prev] [Next]

Appendix D

System Administrator Guide

PC Troubleshooting Guide

Troubleshooting Procedure

The table below lists all the error messages you might encounter while running on the Windows 95 and Windows NT 4.0 operating systems. Follow these steps to locate the exact error message:

Start an MS-DOS Window
Change to the directory where C-MOLD is installed
Run the cmdefs.bat file
Change to the scripts directory

Run the cmoldlmd.bat file

To see a more in-depth error message, set the variable CLM_VERBOSE to yes before running the cmoldlmd.bat file:

% set CLM_VERBOSE=yes

Try to match the error message with one in the table below

Error message NT 95
`Server is not configured to execute on node name (HostID hex#)`
There is no `config' line in keyfile
`Keyfile was not found at /usr/local/cmoldxxx/keyfile`
`Error in gethostbyname call`
`Unable to obtain hostid NCBRESET return code: hex#`
`Environment variables var_name and var_name are not set`
`License key is for a version of this application that was released after your S&U expired`
`Server line in keyfile should have hostname hostname`
`Cannot locate \user directory`

Troubleshooting the Keyfile

A keyfile editor called ckey is located in the cmoldxxx\bin directory which will point out any blatant problems before saving the keyfile. This can be used in conjunction with some of the keyfile resolutions below. Remember that Exceed must be properly running for ckey to start. Also, it should read the keyfile into the editor automatically. If it does not, then check the spelling and the location of the keyfile. Many text editors will place a .txt extension on the keyfile, but this must be removed before it will work.

Error Messages

This section lists the error messages most commonly experienced when installing C-MOLD on the Windows NT 4.0 and Windows 95 operating systems. Following each message are the possible resolutions.

Server is not configured to execute on node name (HostID hex#)

It is possible that no Internet Protocol (IP) address is specified or Dynamic Host Configuration Protocol (DHCP) is being used to automatically obtain an IP address. This could cause your license manager to fail.

On Windows NT:
From the Control Panel, select:
Protocols > TCP/IP Protocol > Properties
See if the Obtain an IP address from a DHCP server toggle has been selected. If it is, unselect it and type in an IP address. If you do not have a current IP address, any will do (e.g., 198.41.6.38).

Figure D-1. IP Address

On Windows 95:
From the Control Panel, select:
Network > Configuration > TCP/IP > Properties > IP Address
See if the Specify an IP address toggle has been selected. If it is, unselect it and type in an IP address. If you do not have a current IP address, any will do (e.g., 198.41.6.25).

Figure D-2. IP Address

Another possibility for Windows NT users is that the Lana number is not set correctly.

On Windows NT:
From the Control Panel, select:
Network > Services > Interface > NETBIOS.
Ensure that the Lana number is 000 for the network route.

Figure D-3. NETBIOS

There is also a CMOLD_LANA variable that can be used to change the default from zero to the value you are using. This can easily be added to one of the batch files, for example cmdefs.bat, which is found in the C-MOLD root directory.

There is no `config' line in keyfile

This error refers to the license manager being unable to locate the line that begins with "Config" in the keyfile. This is usually caused by the format of the keyfile being corrupted-a problem that can be fixed by the user, in most cases.

Look for a text editor called ckey, located in the cmoldxxx\bin directory; it will point out any blatant problems before you save the keyfile.

If the keyfile was received by e-mail, then there is a good possibility that it contains some extraneous characters. Open the keyfile with ckey and check the format. The keyfile should begin with a line similar to the one below:

# C-MOLD keyfile V96.7 and above

If any lines appear before the above line, delete them.

If, on the other hand, the keyfile does start with the above line, then check for control characters at the end of each line of the keyfile. If you find any, delete them and re-save the keyfile before launching the license manager.

If neither of the above suggestions remedies the problem, delete any empty lines that appear before the "Config" line in the keyfile.

Keyfile was not found at /usr/local/cmoldxxx/keyfile

This error indicates that the license manager is unable to locate the keyfile. This is caused by one of the following reasons:

Keyfile is not located in the cmoldxxx directory.
Open the Explorer and ensure that the keyfile is located in the cmoldxxx directory (where xxx refers to the version, e.g., 981). If the keyfile is found in a different directory, copy/move it into this directory.
Keyfile has an extension (e.g., keyfile.txt)
If the keyfile has a .txt extension or if the file type is listed as "text document," then the license manager might have problems locating it. You must ensure that the keyfile is named "keyfile" with no extension. Sometimes the file extensions are hidden in the Explorer. To turn them on, select View > Options.
Make sure the toggle that hides files of certain types is not checked. Check the toggle to display the full MS-DOS path in the title bar.

Figure D-4. Options

Keyfile is named something other than keyfile
The keyfile must be named keyfile for the license manager to automatically locate it. If you want to use any other name, the variable CMOLD_KEY must point to that filename and location. We recommended you use the filename keyfile.

Error in gethostbyname call

The error results from the TCP/IP protocol not being active. Install the TCP/IP protocol and follow the steps given for resolving the "Server is not configured to execute on node name (HostID hex#)" message.

Unable to obtain hostid NCBRESET return code: hex#

This error alerts you to a problem with the interface of the TCP/IP network and the license manager. Some of the common remedies are listed below:

The keyfile sent by C-MOLD has the ethernet card's physical address in the Server line. This should be replaced by the hostname of the machine.
To check for the host name, open an MS-DOS Window and type, net diag /s <enter>. Use the host name reported for the name of the computer.
No IP address is specified or DHCP is being used.
The license manager is known to fail if there is no IP address specified or if you are using DHCP service to automatically obtain an IP address. From the Control Panel, select:
Network > Configuration > TCP/IP > Properties > IP Address.
See if the Obtain an IP address automatically toggle has been selected (Figure D-2). If it is, unselect it and type in an IP address. If you do not have a current IP address, any will do (e.g., 198.41.6.25).
Make the protocol that is currently being used on the system to be the default protocol.
Even if the computer is already using a certain protocol, it needs to be instructed to use it as the default. From the Control Panel, select:
Network > Configuration > Properties > Advanced.
Check the toggle to set the default protocol. Then re-boot the computer before re-trying the license manager.

Figure D-5. Default Protocol

Lana number is not set correctly.
There is also a CMOLD_LANA variable that can be used to change the default from zero to the value you are using. This can easily be added to one of the batch files, for example, cmdefs.bat, which is found in the C-MOLD root directory. Type set CMOLD_LANA=1 (or 2 or 3, until it works).

Environment variables var_name and var_name are not set

On Windows NT:
Sometimes during installation, the CMOLD_HOME variable is not set, or not set correctly. To do this, edit the cmdefs.bat file, which is located in the cmoldxxx directory. Add the following line to the top of this file:
% set CMOLD_HOME=directory_in_which_the_program_is_installed
Save the file and re-run the license manager from the START bar.
On Windows 95:
Sometimes during installation, the CMOLD_HOME variable is not installed to the c:\ directory. The variable needs to be set to the location where the C-MOLD program is loaded, e.g., c:\cmold977. To do this, edit the cmdefs.bat file, which is located in the cmoldxxx directory. Add the following line to the top of this file:
% set CMOLD_HOME=directory_in_which_the_program_is_installed
Save the file and re-run the license manager from the START bar.

License key is for a version of this application that was released after your S&U expired

Customers pay support and update in order to receive support from the hotline and receive program updates from C-MOLD development. When a customer renews his support and update contract, he should receive a new keyfile reflecting the new support expiry date. For example, in the excerpt below, this date is 08/31/98.

8khk 74ed f7ba 7b7c kb6c k487 agka 8heg cflowez NO EXPIRY 08/31/98
0x2bbc39e3 3kb4 bdb4 cfca 6khg 496g g986 4ga8 d9ah cbalance NO EXPIRY 08/31/98
0x2bbc39e3 de8b h2f8 kb67 a2ca bgaa kb8g dgf8 9g84 cfiber NO EXPIRY 08/31/98
0x2bbc39e3 b3d7 7k7g ch3h 7ha4 ah29 ge86 3gb4 7663 cpack NO EXPIRY 08/31/98

This entitles the customer to execute any C-MOLD version created up to that date for as long as he wishes. If the support and updates are not renewed, and the customer tries to run a version created after the expiry date, the program will provide the error message.

If you're sure you renewed the S/Us, and are still getting this error, check to see if you received a new keyfile. If so, install it. If not, contact C-MOLD Administration for a new keyfile.

Server line in keyfile should have hostname hostname

The keyfile sent by C-MOLD has the ethernet card's physical address in the Server line. This should be replaced by the hostname of the machine, which is shown in the error message.

Cannot locate \user directory

This error refers to Exceed (X Environment Emulator) not being installed by the current user. While starting any of C-MOLD's interactive programs, such as the Modeler, the X environment emulator must start first in order to display the graphics. During the installation of Exceed, there is a user directory created that contains all the user's settings. If Exceed is installed as a Personal copy, then only the installer will have access to the user directory. If Exceed is installed as Shared by the Administrator, all user should have access to the user directory.

[Contents] [Prev] [Next]

Copyright © 1997-1998 Advanced CAE Technology, Inc. All rights reserved.