Documentation‎ > ‎User Guide‎ > ‎

Troubleshooting Guide

Under Construction 

COBALT CRASHES ON START-UP


(Applies to Windows users with multi-core processors and Nvidia Video cards only.) 

The solution is to turn off "Threaded Optimization" in your Nvidia video card settings

  1. Start > Control Panel
  2. Double click NVIDIA Control Panel.
  3. From the left window pane select Manage 3D Settings.
  4. From the right pane select Global Settings.
  5. In the Feature column scroll down to Threaded optimization. In the Setting Column select "off" 

CAN'T RIGHT-CLICK OBJECTS FOR EDITING


(Applies to Windows users only.) 

Cobalt may not automatically recognize that you're using a 3 button mouse. 
Manually map your mouse by following these steps: 

  1. Click on the red ball icon in the top left corner of the Cobalt window.
  2. Select VM preferences > Mouse Mapping > 3 Button mouse

TELEPORTING OR SPACE-LINKING ATTEMPTS FAIL


When you host a Cobalt Space, the Cobalt application running on your computer needs to establish a connection with your guests' computers. If your teleport or space-link attempts are failing, most likely your firewall or router configuration is blocking this connection.

There are many brands/models of firewalls and routers on the market, so, unfortunately, we cannot provide customized instructions for all possible combinations. In the sections below we give specific instructions on how to adjust two common firewall models, the ones that come built-in with Windows and Mac. We also offer general instructions on how to adjust your router, with a link to the portforward.com site, where, if you need it, you can find more specific information about your particular model.

  • TIP:
    For teleports or one-way space-links, the connection problem can be traced to firewall/router settings of the user hosting the Space. 
    However, for two-way space-links, where both parties are effectively functioning as hosts, the fault could be with user A's computer, user B's computer, or both computers. To isolate the source of the connection failure it will help to first try a simple teleport. In this test, each user should take turns playing host and guest. The teleport test will tell you if one or both computers are implicated in the problem. In addition, check out the Testing Connectivity document for a blow-by-blow procedure you can follow.


Windows Users

Adjusting Firewall Settings (applies to the built-in Windows Firewall)

  1. Click/Start/Control Panel/Windows Firewall/
  2. Click tab/Exceptions/
  3. Click/Add Port/
  4. Enter Name: cobaltdispatcher
  5. Enter Port number: 6900
  6. Click radio button TCP
  7. Click OK
  8. Relaunch Cobalt. Double-click cobalt.bat, then drag the blue ball and see if the linking/teleporting works.

Similar problems have been reported with Norton Firewall on Windows and it may need adjustment or switching off

If you still can't connect after modifying your firewall, you may need to adjust your router settings:

Adjusting Router Settings 

  1. Close Cobalt without saving.
  2. Click the Windows Start button, then select Run.
  3. Enter cmd and hit return to get command prompt window.
  4. In command prompt window, enter ipconfig and hit return.
    Look for IP Address: 192.168.xxx.xxx (for example).
  5. Do port forwarding for your router:
    6900 to 192.168.xxx.xxx TCP
    1. For detailed help, visit http://portforward.com
    2. Skip all advertisements.
    3. Select your Router, then select Default Guide for router.
    4. Follow the instructions for setting port forwarding for your router for the application Open Cobalt.
  6. Find the config directory within your Cobalt application folder. Rename the file cobalt-router.conf to cobalt-router-std.conf.
  7. Find the example-config directory within your Cobalt application folder. Copy the file cobalt-router-manual.conf in the example-config directory into the config directory and rename it cobalt-router.conf.
  8. Edit the file cobalt-router.conf by changing

    "localAddressString: '172.19.1.2';"

    to

    localAddressString: '192.168.xxx.xxx';

    (filling in the xxx's as per from ipconfig). Be sure to remove the double quotes.

  9. Save file as cobalt-router.conf.
  10. Relaunch Cobalt. Double-click cobalt.bat, then drag the blue ball and see if the linking/teleporting works.

If connection still fails, contact cobalt-dev[AT]duke[DOT]edu for help. 


OPEN GL ISSUE DURING STARTUP

Below is an example of computer/OS combination that we’ve found to present certain problems, at least initially. If you're having Open GL issues feel free to tell us about it--including, if possible, a screen capture of the error message--by emailing the Open Cobalt development team and we’ll try and help you!


1) DELL D520 LAPTOP RUNNING WINDOWS XP PROFESSIONAL WITH SERVICE PACK 3

RUNNING OPEN COBALT ON A DELL D520 LAPTOP WITH A FRESHLY INSTALLED OEM OPERATING SYSTEM CD-ROM

When first firing up Open Cobalt after installing the OEM version of Windows XP Professional on this type of machine you may see a message such as the following:





This is an Open GL error message. To resolve it, simply close Open Cobalt, insert DELL DRIVERS AND UTILITIES ALREADY INSTALLED ON YOUR COMPUTER Disk 1, click the NEXT button and scroll down to the Video Drivers section. Click the EXTRACT button and this will install the correct video drivers onto your machine. Restart Open Cobalt and you should no longer see the error message displayed.

Mac Users

Adjusting Firewall Settings

  1. Select System Preferences>Security
  2. Choose the Firewall tab
  3. Set the firewall to either "Allow all incoming connections"  or "Set access for specific services and applications".   If the latter you have to add the cobalt executable to the list (hit the '+' button, pick from the file selection dialog, then set the pop up to the right of the cobalt entry to "allow incoming connections")

If you still can't connect after modifying your firewall, you may need to adjust your router settings:

Adjusting Router Settings 

  1. Finder, open Application folder, Utilities folder (inside apps folder) , launch the Network Utility
  2. Info tab. pop up menu box lists the network interfaces.  Go throgh them until you find the right one.
  3. Look for IP Address: 192.168.xxx.xxx (for example).
    Do port forwarding for your router: 6900 to 192.168.xxx.xxx TCP

For detailed help, visit http://portforward.com

  1. Skip all advertisements.
  2. Select you Router, then select Default Guide for router.
  3. Follow the instructions for port forwarding.
  4. Find the config directory within your Cobalt application folder. Rename the file cobalt-router.conf to cobalt-router-std.conf.
  5. Find the example-config directory within your Cobalt application folder. Copy the file cobalt-router-manual.conf in the example-config directory into the config directory and rename it cobalt-router.conf.
  6. Edit file cobalt-router.conf by changing

    "localAddressString: '172.19.1.2';"

    to

    localAddressString: '192.168.xxx.xxx';

    (filling in the xxx's as per from ipconfig). Be sure to remove the double quotes.

  7. Save file as cobalt-router.conf.
  8. Launch the Cobalt application, drag the blue ball and see if the linking/teleporting works.

If connection still fails, contact cobalt-dev[AT]duke[DOT]edu for help.


Comments