OpenSpirit - Support - End-User FAQ

General

	Why can't my OpenSpirit Launcher running on Windows find my UserServer running on UNIX?
	How do I run OpenSpirit in debug mode ?
	How do I run PC clients (Kingdom, Petra...)in debug mode ?
	I have a server that is not responding. How can I tell what is going on?
	How can I get more information on a CORBA exception?
	Why do I get a "ddraw.dll" error when I try to run the OpenSpirit tools from my WindowsNT machine?
	Why if I create a user "spirit" for the installation does it have to be a member of the DBA group?

Why can't my OpenSpirit Launcher running on Windows find my UserServer running on UNIX?

Here are some reasons why the Launcher might not be able to find your already-running UserServer, if it's running on a Unix machine.

•	You must register a master account with OpenSpirit before you can run the UserServer. If the account's login ID for the NT account does not match the UNIX ID, the Launcher will prompt you as to whether you will register as a new user (a new master account) or register an alias to an existing account. If you registered as a new user, you cannot go back and change it to an alias. You must delete the account, and then restart the Launcher on NT to register the account as an alias. The OpenSpirit installation's Administrator account has a tool available for this, called the User Manager (userMgr.sh). Ask the Administrator to delete the NT account, then re-register it as an alias to the UNIX account.

•	When OpenSpirit is installed on a Windows machine, it sets two system environment variables that tell the underlying ORB layer how to communicate with the ORB daemon (OSP_HOST and OSP_PORT). These values are critical. The OSP_HOST value should be the IP address where the OpenSpirit shared services are running (this was determined when OpenSpirit was installed/configured on the Unix machine), and the OSP_PORT must match the port number that was entered when OpenSpirit was installed. If the OSP_HOST is a symbolic hostname, as opposed to an IP address, then the Windows machine often cannot properly resolve the hostname. This can be fixed by changing the hostname to an IP address, or by adding it to the system hosts file (usually in C:\WINNT\system32\drivers\etc\hosts).

How do I run OpenSpirit in debug mode?

Make sure your User Server and Data Servers are not running
1. Exit the OpenSpirit Launcher and select the bottom radio button to shutdown the User Server and all data servers.
2. If the OpenSpirit Launcher is not running, start it and then Exit as described above.
Create an empty file in your UNIX home directory called osp.debug. (touch ~/osp.debug)
**note this file is just a trigger to add debug information into the regular OpenSpirit log files, nothing is written to this file.
Start the OpenSpirit Launcher and recreate your workflow.
Execute Step 1 again.
Execute the script $OSP_HOME/bin/etc/tarOSPlogs.sh and send the output file to support@openspirit.com.
Delete the ~/osp.debug file created in step 2, and delete the file created in step 5.

Note: Turning on debugging is not recommended unless you have been instructed to do so by OpenSpirit Support. Debugging output can generate massive log files, and server performance will be degraded.

More fine-grained control of debugging information is possible. See the FAQ on debugging for server developers.

How do I run PC clients (Kingdom, Petra...)in debug mode?

If you have a data server that runs on the PC (Kingdom, Petra...) then; to run in debug mode you need put an "osp.debug" file in c:\Documents and Settings\pc-id\OpenSpirit. Just keep in mind that this should be an empty file, and the extension MUST be ".debug". After you run your workflow, the debug log files will be located in C:\Documents and Settings\pc-id\OpenSpirit\logs.

I have a server that is not responding. How can I tell what is going on?

All the OpenSpirit servers are Java servers. To inspect what is happening with the server at any point in time, users can locate the server process id and issue the following command:

   kill -QUIT

This command will send a SIGQUIT signal to the Java process. This process will temporarily halt to check and print all deadlocks, dump thread stacks, and dump lock registry to the server log file before resuming execution.

My application got a CORBA exception from the server with limited information. How can I get more information on the exception?

The Java ORB has some Java VM properties for clients to set on their Java, CORBA servers:

   -DORBwarn=<number>

where number is between 0 and 2, inclusive. The default is now 2.

0 is to print nothing.
1 will print the user defined CORBA exceptions and their stack traces.
2 means to print both user defined and system CORBA exceptions as well as their stack traces.

   -DORBdebug=<true | false>

False is the default. This option turns on additional ORB vendor debug messages.

Both of these options are set when you turn on debugging by creating a file called $HOME/osp.debug. See the FAQ for turning on debugging information in the servers.

To initiate these options for OpenSpirit Java programs running on the PC, edit a file in your PC's installation to set them for all programs. See the bottom of the FAQ on running OpenSpirit on a PC using VPN.

Why do I get a "ddraw.dll" error when I try to run the OpenSpirit tools from my WindowsNT machine?

If you have installed the OpenSpirit Runtime Client on a Windows NT machine, when you start one of the tools (e.g. TabSelector) you get the error:

"Initialization of the dynamic link library C:\WINNT\System32\ddraw.dll fails. The process is terminating abnormally."

The workaround is to exit out of OpenSpirit on the PC. Edit the file C:\Program Files\OpenSpirit\bin\etc\ospenv.bat and replace the following line:

set ORB_OPTS=-DORBwarn=2

with

set ORB_OPTS=-DORBwarn=2 -Dsun.java2d.noddraw=true

Then startup the OpenSpirit Runtime Client normally and the tools should work fine.

Why is it that if I create a user "spirit" for the installation it has to be a member of the DBA group?

This recommendation appears because the account that owns the installation may at times require tasks that demand maintenance of the Oracle table space that is used by OpenSpirit.

Being in the DBA group does not give the account any special Oracle privileges; it just helps to define a division of responsibilities. If your policies and procedures do not allow or require this then it is not necessary.

Site Map • Legal • Privacy