Troubleshooting Installation

Resolve problems with Sybase Control Center.

Windows Problems
Problem Solution
Installer fails to start To display error messages, run setupConsole.exe instead of setup.exe.
Installer or uninstaller fails on Windows Vista, Windows 7, or Windows 2008 x86 64-bit

The installer or uninstaller fails because it cannot set environment variables. This is common if you use a 32-bit (nt386) SCC installer on a 64-bit machine.

In Windows Explorer, right-click setup.exe, setupConsole.exe, or uninstall.exe and select Properties. On the Compatibility tab, select Windows XP compatibility mode.

Error on installing or starting SCC as a service in Windows XP

If you see the error below, upgrade Windows XP to Service Pack 1 or later. The base version of Windows XP cannot run Sybase Control Center as a service.

sccservice.exe - Entry Point Not Found:
The procedure entry point SetDllDirectoryA could not be 
located in the dynamic link library KERNEL32.dll.
SCC fails to start after installation Execute scc.bat—see Starting and Stopping Sybase Control Center in Windows.
SCC fails to start after installation because it does not have enough memory You may see an error:
Could not create the Java virtual machine.

If the maximum heap size on the machine running SCC is smaller than SCC’s initial heap size (128MB), SCC cannot start. To increase the memory available to SCC, set the SCC_MEM_MAX environment variable to a value appropriate to your machine. For example:

> set SCC_MEM_MAX=512

This enables you to start SCC with the scc command. See the SCC online help for information on changing memory options for the SCC Windows service: Get Started > Launching Sybase Control Center > Configuring Memory Usage.

Running scripts is not enabled If you see Running scripts is not enabled or a similar message while you are connected to Sybase Control Center, relax the security settings on your browser as described in the next item.
Cannot connect to Sybase Control Center or install Adobe Flash Player

Browsers with strong security settings, including Internet Explorer (IE) Enhanced Security Configuration, fail to connect to Sybase Control Center if they cannot load Flash Player. When you try to connect, you might see a message similar to:

This content requires the Adobe Flash Player. Get Flash.

In some cases, there is no indication of the need for Flash Player; you might see only a gray box in the browser window.

To install Flash Player so that you can use Sybase Control Center, relax the security settings on your browser, including ActiveX controls in IE.
  1. To download Flash Player, click the Get Flash link or go to http://get.adobe.com/flashplayer/.
  2. Review the license agreement and click Agree and install now. If your browser’s security options are too strict, they prevent Flash Player from installing.
  3. Change the level of security so you can install Flash Player:
    • In Internet Explorer, go to Tools > Internet Options > Security tab > Internet > Custom level.

      Most options in the Security Settings dialog have Disable and Enable settings. Many also have a Prompt setting, which means that IE prompts you for approval before using the feature or performing the action described. Set all disabled options in the dialog to Enable or Prompt. Prompt is safer.

    • In Firefox, go to Tools > Options > Content and Tools > Options > Security and choose less restrictive settings.
  4. Return to the main window and reload the Flash Player installation page. Flash Player installs automatically and plays a small animation when it finishes.
  5. Connect to Sybase Control Center and log in.
UNIX Problems
Problem Solution
Cannot run the installer in GUI mode
  1. Verify that you have installed any operating system patches required for Java Runtime Environment (JRE) 6.
  2. Enter the following command at the UNIX prompt of the remote machine, where host_name is the name of the machine on which you want the installer to appear (that is, your local machine):

    For C shell:

    setenv DISPLAY host_name:0.0
    

    For Bourne shell:

    DISPLAY=host_name:0.0; export DISPLAY
Installation fails; you may see messages saying the file system is full Clear enough space in /tmp to allow the installer to run. For space requirements, see System Requirements.
SCC fails to start after installation Execute scc.sh—see Starting and Stopping Sybase Control Center in UNIX.
SCC fails to start after installation because it does not have enough memory You may see an error:
Could not create the Java virtual machine.

If the maximum heap size on the machine running SCC is smaller than SCC’s initial heap size (128MB), SCC cannot start. To increase the memory available to SCC, set the SCC_MEM_MAX environment variable to a value appropriate to your machine. For example:

bash$ export SCC_MEM_MAX=512

This enables you to start SCC with the scc command.

You can also execute this command before starting SCC, or add it at the beginning of SCC-3_2/bin/scc.sh:
ulimit -v 59326240

The command increases the virtual memory available to Sybase Control Center.

See the SCC online help for information on changing memory options for an SCC UNIX service: Get Started > Launching Sybase Control Center > Configuring Memory Usage.

Client not authorized to connect to server If you see this error message when you launch the installer, the remote machine does not have permission to display the user interface on the local machine where you are working:
Xlib: connection to "host_name" refused by server
Xlib: Client is not authorized to connect to Server
xhost: unable to open display "host_name"
To correct the problem:
  1. Enter the following command at the UNIX prompt of your local machine, where remote_machine is the machine on which you are running the installer:
    xhost +remote_machine
  2. Restart the installer.
Running scripts is not enabled If you see Running scripts is not enabled or a similar message while you are connected to Sybase Control Center, relax the security settings on your browser as described in the item on installing Flash Player, below.
Cannot connect to Sybase Control Center or install Adobe Flash Player

Browsers with strong security settings fail to connect to Sybase Control Center if they cannot load Flash Player. When you try to connect, you might see a message similar to this:

This content requires the Adobe Flash Player. Get Flash.

In some cases, there is no indication of the need for Flash Player; you might see only a gray box in the browser window.

To install Flash Player so that you can use Sybase Control Center, relax the security settings on your browser.
  1. To download Flash Player, click the Get Flash link or go to http://get.adobe.com/flashplayer/.
  2. Review the license agreement and click Agree and install now. If your browser’s security options are too strict, they prevent Flash Player from installing.
  3. Change the level of security so you can install Flash Player. In Firefox, go to Tools > Options > Content and Tools > Options > Security and choose less restrictive settings.
  4. Return to the main window and reload the Flash Player installation page. Flash Player installs automatically and plays a small animation when it finishes.
  5. Connect to Sybase Control Center and log in.