Siebel Installation Guide for Microsoft Windows > Verifying and Troubleshooting Your Installation >

Troubleshooting Installation and Configuration for Siebel CRM


This topic presents troubleshooting information related to installation and configuration of Siebel CRM server modules. Some of the information also applies to additional modules that use the same installer and are also configured using Siebel Management Console, such as Siebel Enterprise Cache and Siebel Constraint Engine.

This topic includes the following information:

Related Topics

Starting the Siebel Server Service

Verifying Installation for Siebel CRM

Stopping and Starting the Siebel Application Container

Troubleshooting Installation and Configuration for the Siebel Gateway

This topic describes potential errors that can result from a faulty installation or configuration of Siebel Gateway. Such problems can have any of several causes, some of the most common of which are listed in Table 31.

NOTE:  If you cannot start the Siebel Gateway, then you will not be able to configure a Siebel Enterprise or configure and start a Siebel Server.

Table 31. Troubleshooting Siebel Gateway Installation and Configuration
Problem
Cause
Solution

The Siebel Gateway does not start.

You might not have privileges as the Siebel service owner.

Review the instructions in Creating the Siebel Service Owner Account.

You cannot start the Siebel Gateway service on \\COMPUTER_NAME.

Error XXX: The service did not start due to logon failure.

Login failure

  1. Navigate to Control Panel, Administrative Tools, and then Services.
  2. Select the Siebel Gateway.
  3. Right-click, then choose Properties.
  4. In the Log On tab, specify the user name and password to use for this service.

You receive an error at system startup that a driver is missing.

This problem can occur if you uninstall earlier Siebel CRM versions without first stopping the Siebel Server.

Stop the Siebel Server before uninstalling Siebel CRM.

If the services are no longer visible within the Services menu, then contact Oracle Global Customer Support for instructions.

Troubleshooting Installation and Configuration for the Siebel Server

This topic describes potential errors that can result from a faulty installation or configuration of Siebel Server. Such problems can have any of several causes, some of the most common of which are listed in Table 32.

Table 32. Troubleshooting Siebel Server Installation and Configuration
Problem
Cause
Solution

The Siebel Server cannot be installed.

Insufficient user privileges

For information about setting up appropriate administrative user privileges to install, see Creating the Siebel Service Owner Account.

Trying to install or configure the Siebel Server out of sequence

For the required installation and configuration sequence, see Overview of Installing Siebel CRM.

Failure to install the required hardware or software

Installation errors related to software requirements are logged in the Siebel Enterprise Server installer log file. For requirements, see the Certifications tab on My Oracle Support.

The Siebel Server does not start after configuration.

Siebel Gateway not started

Verify that the Siebel Gateway was started. Start it if it was stopped.

Invalid input values for Siebel Server profile creation and deployment

Verify that the input values were valid.

Insufficient system privileges

Verify that you have sufficient system privileges to start the service. For more information, see Creating the Siebel Service Owner Account.

Cannot save a new profile in Siebel Management Console.

The specified profile name might already exist.

Provide a unique name for the new profile and retry saving the profile.

URL does not bring up Siebel Management Console.

Installations might not have been correctly performed.

Security certificates might not be valid, as configured.

You might have specified an incorrect port number in the URL.

Other causes might apply.

Verify the following:

  • The installations were correctly performed,
  • Valid security certificates were used, and the security authentication system is available
  • The Siebel Application Interface application container is running
  • The URL is correct and includes the correct HTTP or HTTPS port

See also Troubleshooting Installation and Configuration for Siebel Application Interface. For security issues, see also Siebel Security Guide.

URL does not bring up login page for a Siebel application.

Cannot log in to a Siebel application.

Configuration of Siebel Server or Siebel Application Interface might not have been correctly performed or completed.

Siebel database information might have been specified incorrectly.

The Application Object Manager might not have been enabled on the Siebel Server.

You might have specified an incorrect port number in the URL.

You might have added components on a new Siebel Server, but neglected to update the Siebel Application Interface profile.

Siebel system services might not be running.

You might be experiencing problems with the security authentication system you are using.

Other causes might apply.

Verify the following:

  • The installations and configurations were correctly performed, and database information was specified correctly
  • Security authentication was correctly configured and the security authentication system is available
  • The Siebel Application Interface application container is running
  • The Siebel Gateway and Siebel Server services are running
  • The URL is correct and includes the correct HTTP or HTTPS port

See also Troubleshooting Installation and Configuration for Siebel Application Interface. For security issues, see also Siebel Security Guide.

Troubleshooting Installation and Configuration for Siebel Application Interface

This topic provides suggestions for troubleshooting problems that you might encounter when installing and configuring the Siebel Application Interface.

Typical problems are shown in Table 33.

Table 33. Troubleshooting Siebel Application Interface Installation and Configuration
Problem
Cause
Solution

Siebel Application Interface profile deployment fails despite no obviously incorrect profile values.

The application container might not have been available to support the configuration process.

Try the following:

  1. Clear the CGHostURI entry in the applicationinterface.properties file, in SIEBEL_AI_ROOT\applicationcontainer\
    webapps.
  2. Restart the application container, as described in Stopping and Starting the Siebel Application Container.
  3. Deploy Siebel Application Interface again.

After installation, when the Siebel Web Client is started, a message appears, stating:

Page Cannot be displayed

The application container is not running.

Make sure that the application container is running.

Refresh the connection between your browser and the Siebel Application Interface.

The Siebel Application Interface port is incorrectly specified.

Verify that the Siebel Application Interface port information is correct.

Applications were not configured properly.

Make sure that the Local Path for the configured applications is correct and resembles the following:

SIEBEL_AI_ROOT\applicationcontainer\webapps\siebel

Anonymous users have incorrect responsibilities.

Make sure that the specified anonymous users are also defined in the Siebel database with the correct responsibilities. Otherwise, end users cannot access the home page.

The connect string for the Siebel application is incorrect.

Make sure that the connect string for the Siebel application is correct. The value resembles the following example:

ConnectString = siebel.TCPIP.none.none://SiebelServerHost:2321/EnterpriseServerName/ProductNameObjMgr_language

Siebel Server components or component groups might not be enabled.

Make sure that the necessary Siebel Server components and component groups are enabled.

Your Siebel application stops responding, displays a blank page or page not found, or times out.

Appropriate settings are not available within the application configuration defined in the profile for the Siebel Application Interface.

Make sure that the configuration contains valid anonymous user and port number values.

Also make sure that appropriate values were specified for session time-out and guest session timeout. For information about configuring these and other settings, see Creating a Siebel Application Interface Profile.

Inability to access the Siebel Web Client. The browser status bar might display errors such as:

SWESubmitOnEnter is undefined

Also, the login page might stop responding.

Or, the Siebel Web Client login page does not display properly; for example, images might be missing.

The user account running the Siebel Application Interface does not have proper permissions to the SIEBEL_AI_ROOT\ applicationcontainer\webapps\siebel directory.

Stop the Siebel Application Interface. Make sure that the permissions meet the requirements described in Requirements for Installing and Configuring the Siebel Application Interface. Restart the Siebel Application Interface, as described in Stopping and Starting the Siebel Application Container.

Siebel Installation Guide for Microsoft Windows Copyright © 2018, Oracle and/or its affiliates. All rights reserved. Legal Notices.