Legend: Known problem -Frequently Asked Question

---

DESCRIPTION

Maximum number of opened sessions

Problem description	Origin
1) When I log on FrameKit with an opened model, I never get the session menu. 2) When I launch a service, I never get results from it.	Current implementation choices in Framekit assign a maximum number of communication channels. When this maximum is reached, it is impossible either to create a new one or to detect this maximum has been reached.
Turnaround/Recovering
Two track should be investigated: There are to many opened sessions (for all users). Disconnect one session and the probleme will be solved (until the maximum is reached again). There are some FrameKit processes left. Check on Unix. There should be N + 1 macao_proxy running for N users) and M session_server running for M running sessions (do not forget remote sessions). Extra processes should be detroyed. Check tools processes too. If many users frequently access the platform, you may run it in mono-session mode (command FrameKit -help for more details)

Problems when quickly switching sessions

Problem description	Origin
When I switch session while something is being downloaded by Macao, big troubles appears, that may end the current session.	Session switch acknowledge is not yet fully supported by Macao (it will come soon or later;-).
Turnaround/Recovering
Please avoid switching sessions during information transfert (menu, result sent by services...).

Quote in model names

Problem description	Origin
When I launch my service, I get no result at all.	Macao and FrameKit properly manage most character except the ' character that has a special signification in Unix-shell. It essentially cause troubles when the tool associated to the service is programmed using a shell script.
Turnaround/Recovering
Please avoid quote in macao model names.

FrameKit complains about TCP service and does not start

Question	Origin
When I start FrameKit, I get the following message. ERROR: Impossible to bind socket... Some processes must be using tcp service framekit Please be sure that all such processes are killed and start again.	(1) FrameKit is already running and the connection daemon is using the TCP service 7001 or (2) another running program is using TCP service 7001.
Answer
If case (1), check first if you are in the FrameKit executable file (the only place you can run any administration for FrameKit). If you are in, then try to find the person who also installed and started FrameKit on that machine. If case (2), please contact us. We may build a specific FrameKit package for you (this should be very rare).

FrameKit warns about framekit TCP service

Question	Origin
When I start FrameKit, I get the following message. WARNING: getservbyname/tcp lookup failed for 'framekit', will use 7001 anyway. you should ask the system ingenier to create the tcp service toto, having identifier 8000	The framekit TCP service (#7001) has not been declared in the /etc/services file (or equivalent).
Answer
Declaration of TCP service framekit is not necessary but FrameKit will complains each time you start it. To avoid this warning, contact your system administrator that will declare the service for you (it cannot be done by somebody else but root).

FrameKit does not start (executable files not found)

Question	Origin
When I start FrameKit, I an error message: lmacao_proxy not found	The PATH variable does not contain the "." directory.
Answer
Add path "." into the PATH environment variable ( you should do that in your .cshrc or .profile).

FrameKit does not start (library problem under Solaris)

Question	Origin
When I start FrameKit, I get a message in file Macao_proxy.XXX.stderr (where XXX is the hostname). When you run an administration tool in standalone mode, the same message appears directly on the screen. This message is: ld.so.1: admin_kit: fatal: libucb.so.1: can't open file: errno=2	The compatibility library is not installed (1) or the LD_librARY_PATH is not properly set (2).
Answer
if case (1), then, ask your system administrator to install the SunOS compatibility library "libucb.so.1". if case (2), add in your LD_librARY_PATH the cirectory in which the BSD compatibility library "libucb.so.1" is located (you should do that in your .cshrc or .profile). It is usually in directory /usr/ucblib.