Академический Документы
Профессиональный Документы
Культура Документы
JUNE 2001
Siebel Systems, Inc., 2207 Bridgepointe Parkway, San Mateo, CA 94404 Copyright 2001 Siebel Systems, Inc. All rights reserved. Published 2001 Printed in the United States of America No part of this publication may be stored in a retrieval system, transmitted, or reproduced in any way, including but not limited to photocopy, photographic, magnetic or other record, without the prior agreement and written permission of Siebel Systems, Inc. The full text search capabilities of Siebel eBusiness Applications include technology used under license from Fulcrum Technologies, Inc. and are the copyright of Fulcrum Technologies, Inc. and/or its licensors. Siebel, the Siebel logo, TrickleSync, TSQ, Universal Agent, and other Siebel product names referenced herein are trademarks of Siebel Systems, Inc., and may be registered in certain jurisdictions. Windows is a registered trademark of Microsoft Corporation. All other product names, marks, logos, and symbols may be trademarks or registered trademarks of their respective owners. U.S. GOVERNMENT RESTRICTED RIGHTS. Programs, Ancillary Programs and Documentation, delivered subject to the Department of Defense Federal Acquisition Regulation Supplement, are commercial computer software as set forth in DFARS 227.7202, Commercial Computer Software and Commercial Computer Software Documentation, and as such, any use, duplication and disclosure of the Programs, Ancillary Programs and Documentation shall be subject to the restrictions contained in the applicable Siebel license agreement. All other use, duplication and disclosure of the Programs, Ancillary Programs and Documentation by the U.S. Government shall be subject to the applicable Siebel license agreement and the restrictions contained in subsection (c) of FAR 52.227-19, Commercial Computer Software - Restricted Rights (June 1987), or FAR 52.227-14, Rights in DataGeneral, including Alternate III (June 1987), as applicable. Contractor/licensor is Siebel Systems, Inc., 2207 Bridgepointe Parkway, San Mateo, CA 94404.
Proprietary Information Siebel Systems, Inc. considers information included in this documentation and in Siebel Online Help to be Confidential Information. Your access to and use of this Confidential Information are subject to the terms and conditions of: (1) the applicable Siebel Systems software license agreement, which has been executed and with which you agree to comply; and (2) the proprietary and restricted rights notices included in this documentation.
Contents
Introduction
Who Should Use This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intro-2 How This Guide Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intro-3 Whats New in This Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intro-4 Additional Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intro-4 . . . . . . . . . . . . . . . . . . . Intro-8 Contacting Siebel Technical Support . . . . . . . . . . . . . . . . . . . . . . . . Intro-6 Siebel Systems Welcomes Your Comments
PART 1.
iii
Contents
PART 2.
iv
Contents
Editing Mobile Client Configuration Parameters . . . . . . . . . . . . . . . . . . . 5-9 Setting Siebel Remote Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9 Sample Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11 Editing the Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11 Recovering from Failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12 Setting Up the Siebel Remote Server . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13 Setting Up a New Siebel Remote User . . . . . . . . . . . . . . . . . . . . . . . . . 5-13 Creating a Mobile Client User Account . . . . . . . . . . . . . . . . . . . . . . . . . .5-13 Setting Up Mobile Client Hardware and Software . . . . . . . . . . . . . . . . . . .5-14 Establishing Autodial Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-14 Registering a Mobile Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-14 Running Database Extract for a Mobile Client . . . . . . . . . . . . . . . . . . . . .5-15 Starting Siebel Remote Server Processes . . . . . . . . . . . . . . . . . . . . . . . . . .5-17 Starting the Transaction Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-18 Initializing a Mobile Client Local Database . . . . . . . . . . . . . . . . . . . . . . . 5-21 Synchronizing a Mobile Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22 How Changes Are Propagated to and from a Mobile Client Machine . . . . .5-22 Workflow for Changes Made by Mobile Users . . . . . . . . . . . . . . . . . . . . .5-24 Synchronizing a Mobile Client Machine . . . . . . . . . . . . . . . . . . . . . . . . . .5-26 Editing Dedicated Client Configuration Files . . . . . . . . . . . . . . . . . . . . 5-26
Contents
PART 3.
Thin Client for Windows and Java Thin Client Installation and Configuration
Chapter 8. Thin Client for Windows and Java Thin Client Overview
What Are Thin Client for Windows and Java Thin Client? . . . . . . . . . . . 8-2 Whats New in Java Thin Client and Thin Client for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5 Deploying Windows and Java Thin Client Applications . . . . . . . . . . . . . 8-6 User Interface Functionality Supported in Windows and Java Thin Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7 Applet Classes Supported by Thin Clients . . . . . . . . . . . . . . . . . . . . . . . . 8-8 Supported Control Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9 Unsupported Siebel Script Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-10
vi
Contents
Launching Siebel Thin Client for Windows . . . . . . . . . . . . . . . . . . . . . 9-10 Creating a Custom Installer and Sharing Thin Client Files . . . . . . . . . . 9-10 Creating a Custom Thin Client for Windows Installer . . . . . . . . . . . . . . . . 9-11 Packaging the Thin Client for Windows Installer . . . . . . . . . . . . . . . . . . .9-15 Distributing the Thin Client Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-16 Modifying the Shortcut for the Stand-Alone Executable . . . . . . . . . . . . 9-17 Sample Connect Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-18 Server-Side Performance Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-20 Removing Thin Client for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 9-20
vii
Contents
Chapter 12. Java Thin Client and Thin Client for Windows Network Requirements
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2 Accessing the Thin Clients from Outside a Firewall . . . . . . . . . . . . . . . 12-2 Firewall Requirements in a Load-Balanced Environment . . . . . . . . . . . . . 12-2 Firewall Requirements in a Non-Load-Balanced Environment . . . . . . . . . 12-4
Chapter 13. Troubleshooting Thin Client for Windows and Java Thin Client
Troubleshooting Your Thin Client . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1
PART 4.
vii i
Contents
Chapter 15. Preparing to Install Siebel .COM Applications on Windows NT Server and UNIX Systems
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2 Pre-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2 Verifying Thin Client Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-2 Planning the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-3 Verifying the Siebel Enterprise Server . . . . . . . . . . . . . . . . . . . . . . . . . . .15-5 Verifying Web Server Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-5 Installing Siebel .COM Applications . . . . . . . . . . . . . . . . . . . . . . . . . 15-6 Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-6
ix
Contents
PART 5.
Appendices
Contents
Index
xi
Contents
xii
Introduction
Who Should Use This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intro-2 How This Guide Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intro-2 Whats New in This Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intro-3 Additional Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intro-3
Contacting Siebel Technical Support . . . . . . . . . . . . . . . . . . . . . . . . Intro-5 Siebel Systems Welcomes Your Comments . . . . . . . . . . . . . . . . . . . Intro-6
I n tr o - 1
Introduction
Who Should Use This Guide
Intro
Persons responsible for the whole system, including installing, maintaining, and upgrading Siebel products.
Siebel Application Persons who plan, implement, and configure Siebel applications, Developers possibly adding new functionality. Installers
Intro
In t ro - 2
The rest of the parts of this guide are organized by client type. Table 1 provides a list of the parts of the book by client type.
This Guide Is Organized by Client Type
See the following part of this guide: Dedicated and Mobile Clients Installation and Configuration Thin Client for Windows and Java Thin Client Installation and Configuration HTML Thin Client Installation and Configuration and the Siebel Server Installation Guide and Configuring Siebel .COM Applications
Table 1.
If you are interested in installing and configuring: Dedicated or mobile client applications Thin Client for Windows and Java Thin Client applications HTML Thin Client applications
See Appendix A, Index of Configuration Parameters, for an alphabetical list of the client configuration parameters documented in this guide.
Introduction
Whats New in This Release
This guide provides information necessary to implement, configure, and monitor Siebel applications, with particular detail provided for application, client/server, and thin client administration.
Intro
See the overview chapters for each client type for a list of the new features in this release. The overview chapters are:
Additional Documentation
NOTE: Users must understand how to use Siebel Tools to be successful in configuring Siebel HTML Thin Client applications. Users should read the Siebel Tools Guide and Configuring Siebel .COM Applications before configuring their Siebel HTML Thin Client applications.
NOTE: Your Siebel implementation may not have all the features described in this
Intro
The following documentation also provides information on the topics addressed in this guide. Configuring Siebel .COM Applications Siebel Applications Administration Guide Siebel eBriefings Guide Siebel Object Interfaces Reference Siebel Object Types Reference Siebel Release Notes Siebel Server Administration Guide Siebel Tools Guide
I n tr o - 3
Introduction
Additional Documentation
This guide does not provide information about general software concepts, such as records and queries, or about using Windows and UNIX. Neither does it provide instructions for basic navigation of Siebel applications. For this kind of information about Siebel applications, refer to Siebel Basics. Administrators and developers, such as marketing administrators, call center administrators, and application developers, should also read the Siebel Applications Administration Guide for information on how to set up and maintain Siebel applications features. You can find information about Siebel Technical and Professional Services in Guide to Siebel Global Services. For copies of these documents, please use the Siebel Books Online Web site (http://ebusiness.siebel.com/booksonline). Through Siebel Books Online, you can order additional Siebel documentation and copies of the Siebel Bookshelf for Enterprise Applications CD-ROM. For the most current and accurate documentation, see the Documentation Updates section of the Siebel SupportWeb site (http://ebusiness.siebel.com/supportweb/). The Documentation Updates show changes that have been made to the documentation since it was released. For up-to-the-minute information on Siebel products, see Siebel Release Notes. Siebel Release Notes appear on the Siebel SupportWeb site. Siebel Systems reserves the right to modify the documentation at any time by posting revised documentation on the Siebel SupportWeb site. Another source of information is Siebel Online Help.
In t ro - 4
Introduction
Contacting Siebel Technical Support
Intro
Do you know how to access Siebel Technical Support? It is crucial that you understand the requirements for getting support before you encounter technical issues that require Siebel Technical Supports assistance. This will facilitate smooth resolution of your issues. If you have questions, please dont hesitate to contact us. To maximize your knowledge of Siebel products and your return on investment: You must attend Siebel training to become a designated contact. Your Siebel-trained designated contacts provide technical support to your users. Siebel Technical Support provides support directly to your designated contacts only.
To provide efficient, timely support and access to the Technical Support knowledge base: Siebel Technical Support is primarily Web-based; it can be accessed through Siebel SupportWeb (http://ebusiness.siebel.com/supportweb/). Please submit new service requests to us through SupportWeb, where you can also search the knowledge base for solutions. Designated contacts receive read/write access to Siebel SupportWeb. All other project team members at your company receive read-only accounts so that they can access the knowledge base.
To register for Siebel training, access http://siebeluniversity.siebel.com/edPortal and choose Implementation Team Training. Please submit your technical issues and updates to Siebel SupportWeb (http://ebusiness.siebel.com/supportweb/). If you do not have a SupportWeb account, or if you have a question, please contact us at support@siebel.com or call your local Siebel Support Center:
North America: Brazil (So Paulo): UK (London): Germany (Munich): France (Paris):
+1 800 214 0400 or +1 650 295 5724 +55 11 5110 0800 +44 800 072 6787 or +44 1784 494949 +49 89 95718 400 +44 800 072 6787 or +44 1784 494949
I n tr o - 5
Introduction
Siebel Systems Welcomes Your Comments
+44 800 072 6787 or +44 1784 494949 0120 606 750 (Japan domestic only), +81 3 5464 7948 (outside of Japan) +65 212 9266
Contact us through regular mail or email at: Siebel Systems, Inc. Technical Publications Department 2207 Bridgepointe Parkway San Mateo, CA 94404-5009 doc@siebel.com We appreciate your feedback.
In t ro - 6
Singapore:
Outside of local support center hours, Gold and Rollout Support Option customers can call +1 800 214 0400 or +1 650 295 5724. We appreciate your business and look forward to working with you.
Intro
The name and version number of the Siebel eBusiness Application you are using Your name, job title or functional area, company name, phone number, and email address
Part 1
Introduction to Siebel Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Siebel Client Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Benefits of Thin Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Application Object Manager and Thin Clients . . . . . . . . . . . . . . . . . . . . 1-6 Choosing a Thin Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 The Main Differences Between the Thin Clients . . . . . . . . . . . . . . . . 1-7
1-1
Siebel Gateway Server and Name Server Resonate Application Server Manager
Siebel Server
Siebel Server
Siebel Server
Siebel Database
Figure 1-1.
1-2
All Siebel eBusiness Applications installations include one or more of the various Siebel clients that connect to various servers (depending on the type of client) to request and analyze data. You may deploy a mixture of dedicated and thin clients.
NOTE: In addition to these Siebel clients for individual users, the dedicated client is
from the client PC and do not store data locally. Thin client connects directly to the Gateway Server only, not to any other server. The Siebel Server executes all business logic for thin clients. There are three types of thin clients: Siebel Java Thin Client, Siebel Thin Client for Windows, and Siebel HTML Thin Client. The two thin clients that do not run inside a Web browser are Siebel Java Thin Client, which enables enterprises to deploy the user interface layer of Siebel eBusiness Applications as a stand-alone Java application, and the new standalone Thin Client for Windows. Java Thin Client and the stand-alone Thin Client for Windows do not run inside a browser; like the other thin clients, they do not store any data locally. See Chapter 8, Thin Client for Windows and Java Thin Client Overview, and Chapter 14, Siebel HTML Thin Client Overview, for more information about each thin client.
Dedicated and mobile clients. The dedicated client is connected directly to a
database server for all data access, and it does not store any Siebel data locally. The mobile client is designed for local data access, without the need to be connected to a server. See Chapter 3, Dedicated and Mobile Clients Overview, for more information about dedicated and mobile clients.
Siebel thin client is different from Siebel dedicated client, which is the default Siebel client for Siebel eBusiness Applications. In Siebel dedicated and mobile clients, unlike Siebel thin clients, all layers of the Siebel eBusiness Applications architecture, except for the database, reside on the users personal computer. For mobile client users, a local database is stored on each mobile machine.
1-3
Figure 1-2 shows the deployment differences between Siebel dedicated client and Siebel thin clients.
Dedicated Client User Interface Objects Layer Siebel Applications Client Business Objects Layer Data Objects Layer
Thin Client for Windows Web Browser User Interface Objects Layer
Siebel Database
Figure 1-2.
Deployment Difference Between the Siebel Dedicated Client and the Thin Clients
1-4
1-5
The Application Object Manager communicates with thin clients using the TCP/IP protocol. Communication between the clients and the Application Object Manager can be compressed and encrypted. An independent session is established to serve incoming connect requests from each client. Subsequent requests from clients are directed to the same Application Object Manager tasks until the sessions are terminated. The Siebel repository file (.srf) is installed as part of each Siebel Server installation. Any changes to the applications repository file must be applied to the appropriate Siebel Server installations that serve the modified application to the thin clients. When they reconnect to the Application Object Manager, thin client users automatically retrieve the new Siebel application configuration. User preferences set and saved by thin clients will be saved on the server. For more information about Siebel thin clients, see Chapter 8, Thin Client for Windows and Java Thin Client Overview, and Chapter 14, Siebel HTML Thin Client Overview.
1-6
Thin Client Feature High responsiveness Complete Siebel look-and-feel Windows on users desktop Non-Windows platforms Tight integration with the look-and-feel of Web site Low bandwidth connection
1
1-7
1-8
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Sample Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Example Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Editing Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 How to Edit Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
2-1
2-2
Below is an example of the uagent.cfg configuration file from the Siebel Server for Call Center. On the left are the parameters, and on the right are sample values. Edit the values according to how you want your system to function. See How to Edit Configuration Files on page 2-6 before you attempt to edit any configuration files.
[Siebel] RepositoryFile ApplicationName ApplicationTitle ApplicationSplashText ComponentName ShowMessageBar DataSource ClientRootDir TempDir JTCHelpURL Version ClientFileServSupport MultiCurrency EnableScripting ScriptingDLL EnableOLEAutomation OLEAutomationDLL EnableCORBA CORBADLL CorrespODBCDataSource ReportsODBCDataSource ServerDbODBCDataSource DockRepositoryName HoldExportOdbcConnection LargeFont SmallFont DefaultChartFont NavBarItemFont NavBarSelectFont = = = = = = = = = = = = = = = = = = = = = = = = = = = = = siebel.srf Siebel Universal Agent Siebel Call Center Call Center Siebel Call Center Client TRUE Local c:\2456\Sea c:\2456\Sea\temp %JTC_HELP_URL% 100 TRUE TRUE TRUE sscfbas.dll TRUE sscfole.dll FALSE sscfcorb.dll SEA MMerge c:/2456/Sea CHANGE_ME SEA Oracle80 c:/2456/Sea Siebel Repository FALSE MS Sans Serif-10-normal MS Sans Serif-8-normal Arial-10-normal MS Sans Serif-8-bold MS Sans Serif-8-bold
2-3
NavBarTitleFont AppletTitleFont SrvrUpdateInterval SrvrTimeOutInterval AccessDir LocalDbODBCDataSource [DataSources] Local Sample Server Gateway DataMart [Local] Docked ConnectString TableOwner DockedDBFilename DLL SqlStyle MaxCachedCursors MaxCachedDataSets ReverseFillThreshold CaseInsensitive InsensitivityFactor DockTxnsPerCommit DockConnString SearchStyle SearchConnectString SearchDefName OLAPServer=ichan2456 [Sample] Docked ConnectString TableOwner DockedDBFilename DLL SqlStyle MaxCachedCursors MaxCachedDataSets ReverseFillThreshold CaseInsensitive InsensitivityFactor SearchStyle SearchConnectString SearchDefName OLAPServer
= = = = = = = = = = = = = = = = = = = = = = = = = = =
Arial Black-10-normal Arial-10-bold 60 600 CHANGE_ME SEA Local Db c:/2456/Sea Local Sample Server Gateway DataMart FALSE c:\2456\Sea\local\sse_data.dbf -Q -m SIEBEL CHANGE_ME SSCDW55.DLL Watcom 16 16 100 FALSE 2 500 laptop1 Fulcrum SEA Search c:/2456/Sea Fulcrum Sample
= FALSE = c:\2456\Sea\sample\sse_samp.dbf -Q -m = SIEBEL = CHANGE_ME = SSCDW55.DLL = Watcom = 16 = 16 = 100 = TRUE = 2 = Fulcrum = SEA Search c:/2456/Sea = Fulcrum Sample = olap
2-4
[Server] Docked ConnectString TableOwner DLL SqlStyle MaxCachedCursors MaxCachedDataSets ReverseFillThreshold CaseInsensitive InsensitivityFactor FileSystem SearchStyle SearchConnectString SearchDefName GatewayAddress EnterpriseServer RequestComponent RequestServer OLAPServer [DataMart] Docked ConnectString TableOwner DLL SqlStyle MaxCachedCursors MaxCachedDataSets ReverseFillThreshold CaseInsensitive InsensitivityFactor FileSystem SearchStyle SearchConnectString SearchDefName OLAPServer [Gateway] ConnectString PrimaryEnterprise DLL Hidden CaseInsensitive InsensitivityFactor [Preload] View1 View2
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
TRUE siebel_db siebel sscdo80.dll Oracle 16 16 100 FALSE 2 c:\files Fulcrum SEA Search c:/2456/Sea Fulcrum Sample gtway siebel SRMSynch rqstsrvr olap TRUE CHANGE_ME CHANGE_ME sscdo80.dll Oracle 16 16 100 FALSE 2 c:\files Fulcrum SEA Search c:/2456/Sea Fulcrum Sample olap
= gtway = siebel = sscda10.dll = TRUE = FALSE = 0 = Opportunity List View = All Service Request List View
2-5
[CTI] Enable DeviceDriver [ProductConfigurator] ConfiguratorDLLName [DataCleansing] Enable Type Dir [DeDuplication] Enable Type Dir [Internet] TableOwner SqlStyle
= FALSE = CSTGenesysDriver = SSCSBC.DLL = FALSE = IdCentric = CHANGE_ME = FALSE = IdCentric = CHANGE_ME = siebel = Oracle
2 Using any text editor, such as Notepad, open the default version of the .cfg file. 3 Edit the parameter values to obtain the desired application behavior. 4 Run a test using the .cfg file that you edited. 5 If there is an error in your test, resave the backup file as the default .cfg file. 6 If no error occurs, then use the modified .cfg file.
2-6
Part 2
Chapter 3. Dedicated and Mobile Clients Overview Chapter 4. Installing the Dedicated and Mobile Clients Chapter 5. Configuring the Dedicated and Mobile Clients Chapter 6. Optimizing Dedicated and Mobile Client Performance Chapter 7. Troubleshooting the Dedicated Client
What Are the Siebel Dedicated and Mobile Clients? . . . . . . . . . . . . . . . . 3-2 More Information About the Mobile Client and Siebel Remote . . . . . . 3-2 Comparing the Siebel Dedicated and Mobile Clients . . . . . . . . . . . . . . . . 3-5
3-1
3-2
Server and the Siebel File System to perform its functions. The dedicated client may also interact with Enterprise Server components for additional functionality. A dedicated client does not store any Siebel data locally.
Mobile Client. The mobile client, typically a laptop computer used by a field sales
or service representative, is designed to operate without a real-time connection to any of the servers. See More Information About the Mobile Client and Siebel Remote to learn more about the mobile client.
3-3
The Siebel Remote client uses the TCP/IP protocol to communicate with the Siebel Remote server over a modem using dial-up networking, a local area network, a wide area network, or a public network such as the Internet. The Siebel Remote client does the following to manage the synchronization process:
1 Connects to the Siebel Remote server, which starts a synchronization manager for the mobile client.
NOTE: The synchronization manager notifies the mobile user and initializes the local database if the Siebel administrator performed a database extract for the mobile client or if the local database does not exist.
2 Extracts transactions from the local database. 3 Sends and receives transaction files to and from Synchronization Manager. 4 Sends and retrieves file attachments. 5 Applies transaction files from the Siebel Remote server to the local database.
3-4
Administrator clients are the only ones that connect directly through the Gateway Server. Non-administrator clients connect directly through the database server.
Each mobile client connects directly to the Siebel Server from which it was last extracted.
Siebel Server
Siebel Server
Siebel Server
Server Manager
Siebel Dedicated and Mobile Clients Siebel Client Installation and Administration Guide
3-5
3-6
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 Preinstallation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 Choosing a Directory Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3 Verifying Siebel Client Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . 4-3 Installing Database Connectivity Software . . . . . . . . . . . . . . . . . . . . 4-3 Installing Included Third-Party Software . . . . . . . . . . . . . . . . . . . . . 4-4 Installing Fulcrum SearchServer Desktop . . . . . . . . . . . . . . . . . . . . . 4-5 Installing the Siebel Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 Post-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11 Verifying Successful Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11 Verifying the Siebel Client Directory Structure . . . . . . . . . . . . . . . . 4-14 Verifying the Siebel Client Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-16 Verifying Siebel Client ODBC Data Sources . . . . . . . . . . . . . . . . . . . . . . .4-17 Removing the Dedicated Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18
4-1
Preinstallation Tasks
Choosing a Directory Name on page 4-3 Verifying Siebel Client Prerequisites on page 4-3 Installing Database Connectivity Software on page 4-3 Installing Included Third-Party Software on page 4-4 Installing Fulcrum SearchServer Desktop on page 4-5
Perform the following tasks before running the standard client installation program:
4-2
4-3
4-4
1 Close any open Windows programs. 2 Insert the Siebel eBusiness Applications Client Programs CD-ROM into the CDROM drive on the Siebel administrators PC. 3 Using Windows Explorer, navigate to the \Thirdpty\enu\acrobat directory on the Siebel eBusiness Applications Client CD-ROM.
Caution: You must run this and other installation programs from the CD-ROM or a network drive mapped to a drive letter. If you attempt to install from an unmapped network drive, the installation program will be unable to locate files it needs to proceed and will fail.
4 Double-click the rs405eng.exe file to start the Acrobat installer. 5 Read and accept the terms and conditions.
By default, Adobe Acrobat Reader will be installed into C:\Program Files\Adobe\Acrobat 4.0. To install Adobe Acrobat Reader into a different directory, change the target directory location and click Install to continue.
6 The setup program will copy files to the PCs hard disk and create an icon labeled Acrobat Reader 4.0 in the Adobe Acrobat 4 program group. 7 Click OK to complete the installation.
4-5
To complete the installation, refer to the Siebel Release Notes that accompanied your software. The System Requirements and Supported Platforms chapter in the Siebel Release Notes contains version numbers and other updated information.
NOTE: Do not attempt to perform a single client installation for use across multiple Siebel Enterprises. Although running the client with different .cfg files will allow it to work with multiple Enterprises for testing purposes, this can cause Siebel Anywhere failures. Files from different Enterprises in the client root directory will collide and Siebel Anywhere may behave erratically. The only solution to this issue is to perform a clean reinstallation.
4-6
1 Using Windows Explorer, navigate to the \sea directory of the Siebel eBusiness Applications Client Programs CD-ROM.
Caution: You must run this and other installation programs from the CD-ROM or a network drive mapped to a drive letter. If you attempt to install from an unmapped network drive, the installation program will be unable to locate files it needs to proceed and will fail.
3 In the Welcome dialog box, click Next. 4 In the Setup Type dialog box, select the type of Siebel installation to perform:
Typical Setup. This setup option will install all Siebel components except the
5 While still in the Setup Type dialog box, verify that the installation directory listed is correct.
The default directory for Siebel is c:\sea\client. Click Next to accept the default directory. Click Browse to select a different destination directory. The directory pathname can be up to 18 characters long and must not include spaces or special characters. If you specify a directory other than c:\sea\client, make the appropriate substitutions throughout the remainder of this chapter.
Packager Utility, Server Manager, Sagent Runtime, DataMart Administration, and SME Cache Generator. This option is recommended for most users.
Compact Setup. This setup option will install all components except the Help
Files, Packager Utility, and demonstration database. Select this option for end-user client PCs that will receive customized help text, that will not be used for packaging Siebel software for distribution to other PCs, and that will not be using Siebel Marketing.
Custom Setup. This setup option lets you customize your installation by
choosing components you wish to install. Each component is listed with the amount of disk space it requires. Click the Disk Space button to see the disk space available on the designated installation drive.
NOTE: You must use the Custom Setup option to install the Server Manager and the Packager Utility. This setup should be performed by the Siebel administrator so that the Siebel client can be installed on the rest of the nonadministrator machines.
You must also use this option to install the Data Mart Administration, Sagent Runtime, and SME Cache Generator options for Siebel Marketing. See the Siebel Marketing Guide for more information on these options.
4-7
6 In the Database Identification dialog box, enter the type of server database on which you are implementing your Siebel application and click Next. 7 In the Document Integrator dialog box, select the product suite that you want to use for document integration and click Next. The possible sections include:
Microsoft Office Lotus SmartSuite
9 In the Server Locations dialog box, enter your Siebel Remote Server and File System connectivity information.
You must use the network name (machine name) of the server where the Siebel Remote Server is installed. For instance, a network name might be NTSRV1. Siebel File System connectivity information can be either the UNC share name of the Siebel File System directory (for example, \\NTSRV1\siebfile), or a drive letter mapped to the Siebel File System directory (for example, K:\).
4-8
11 In the Enterprise Server Information dialog box, specify the Gateway Server Address and Enterprise Server to which this client will connect for administration.
The address specified for the Gateway Server will vary depending on whether your Siebel Servers are using Resonate Central Dispatch to support connection brokering: If you are using Resonate Central Dispatch, the Gateway Server address is the Gateway VIP (virtual IP address) of the machine on which the Gateway Server is installed. If you are not using Resonate Central Dispatch, enter either the network name or the IP address of the application server on which the Gateway Server is installed.
The Enterprise Server name is the name of the Enterprise Server under which the Siebel Servers that support this clients server database were installed.
12 In the Server Request Information dialog box, enter the information that dedicated clients will use to invoke the Server Request Manager component for dynamic assignment and other interactive operations, and then click Next.
These settings are not applicable if you are not using the Request Manager component: The Request Component is the name of the Request Manager component. The default value of SRMSynch is correct for the server component definitions included in the default Siebel Server installation. Do not change this value unless you have created your own Request Manager configured component. If you are not using Resonate Central Dispatch, you must also specify the Request Server Name. This is the logical name of the Siebel Server operating the Request Manager component.
Siebel Client Installation and Administration Guide
4-9
13 In the Analysis Proxy Server Setup dialog box, enter the machine name or IP address of the Siebel Server on which the Marketing Analysis Proxy Manager server component is operating, and then click Next.
This setting is used only for Siebel Marketing. See the Siebel Marketing Guide for more information. If you are not using Siebel Marketing, you do not need to enter anything in this dialog box.
for the server on which Fulcrum SearchServer is operating. If you are not using Fulcrum, accept the default parameters, and click Next.
15 In the Select Program Folder dialog box, enter the name of the program folder that will contain your Siebel icons in the Select Program Folder dialog box.
The default name is Siebel Client 6.0. You can use spaces and the backslash (\) in folder names to create a folder hierarchy.
Caution: If you are deploying Windows NT 4.0 clients operating against an Oracle database, do not include parentheses in the labels of the Siebel icons if you modify them. Including parentheses will prevent the application from connecting to the Oracle database.
16 When you click Next, the setup program will copy files to the local host machines hard disk.
A status bar in the Setup Status dialog box indicates the progress of the installation.
4-10
17 Review the Event Log dialog box, and when you are finished, click Next.
This log provides details of the steps the installer completes during your Siebel client installation.
18 Review the Registry Log dialog box, and when you are finished, click Next.
This log provides details of the registry information the installer completes during your Siebel client installation.
Post-Installation Tasks
Perform the following tasks after running the Siebel client installation program: Verifying Successful Installation Verifying the Siebel Client Directory Structure on page 4-14 Verifying the Siebel Client Icons on page 4-16 Verifying Siebel Client ODBC Data Sources on page 4-17
4-11
To start Siebel Client without a licensed Siebel VB or eScript installation Set EnableScripting = FALSE in the .cfg file used by your Siebel client configuration. By default, this .cfg file resides in the C:\sea\client\bin directory.
Several different Demo icons are providedsuch as Sales Demo, Service Demo, and Call Center Demothat will log you on to the database as several different users with different privileges. To see all Siebel views
2 Specify SADMIN for the User Name and Password, and choose Sample from the Connect To picklist.
Logging on as SADMIN allows you to see all screens and views. Details on other logons included in the sample database can be found in the Siebel Release Notes.
4-12
1 Choose File
Connect.
1 While connected to the sample database, click the New Correspondence toolbar button. 2 Pick a correspondence template and attach recipients. 3 View the correspondence.
If you are unable to view the correspondence, make sure that the ODBC data source called SEA MMerge C:/sea/client is correctly installed. See Verifying Siebel Client ODBC Data Sources on page 4-17 for more information.
NOTE: If you are running Microsoft Word 97 under Windows 95 or 98, you must complete the next set-up steps, To enable Siebel Correspondence on Windows 95/98, to configure your Siebel client system to display MS-DOS file extensions.
2 Click the View tab. 3 Disable (uncheck) the check box labeled Hide MSDOS file extensions for file types that are registered.
1 Choose View
4-13
4-14
sea. The top-level directory for Siebel installation. You can change the name during
4-15
sample. Where the sample database is installed. files. Where the sample literature and correspondence files are installed. inbox. Siebel Remote directories for the sample database. log. Stores the log files from client operations. outbox. Siebel Remote directories for the sample database. si. Siebel eBriefings. images. Contains image files used by Siebel eBriefings. search. Contains sample search data and index for the Siebel Search module. data. Contains the physical documents that the Siebel Search index references. index. Contains the Siebel Search index used by Siebel to perform text retrieval on a local client. scripts. Files used by the Siebel Search engine. temp. Contains working report files. upgrade. Will contain Siebel Anywhere upgrade files retrieved by the user.
install.
Siebel Call Center. Use this icon to open Siebel Universal Agent, a configuration
combining Siebel Sales and Siebel Service applications into a single desktop. Use this icon to connect to the database server (for LAN-connected users), to an initialized local database, or to the Siebel demonstration database shipped with the product.
4-16
Siebel Call Center Demo. Use this icon to start the Siebel demonstration database, a
configuration combining Siebel Sales and Siebel Service applications into a single desktop.
Siebel eBusiness Applications Help. Use this icon to access the Online Help. Siebel Marketing. Use this icon to start Siebel Marketing. Siebel Remote. Use this icon to start the stand-alone synchronization program. Siebel Sales. Use this icon to start Siebel Sales. You can start in three modes:
Connected to the database server (for LAN-connected users) Connected to an initialized local database (for mobile users) Connected to the Siebel demonstration database found in the standard Siebel application
Siebel Sales Demo. Use this icon to start the Siebel demonstration database for Siebel
Sales.
Siebel Service. Use this icon to start Siebel Service when you are connected to the
database server (for LAN-connected users), to an initialized local database (for mobile users), or to the Siebel demonstration database included with the standard Siebel product.
Siebel Service Demo. Use this icon to start the Siebel demonstration database for
Siebel Service.
4-17
The drive letter and directory at the end of each data source name will vary, depending on where you have chosen to install the Siebel client.
NOTE: If the database server is SQL Server, the client must be configured to use SQL Server authentication. All ODBC data sources and the SQL Server database should be configured using SQL Server authentication.
Table 4-1.
Data Source
SEA Local Db C:/sea/client SEA MMerge C:/sea/client SEA MSQL C:/sea/client SEA Oracle C:/sea/client
NOTE: It is necessary to use the ODBC drivers included on the Siebel Software CD.
4-18
Logging Onto Your Siebel Application . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Establishing Network Connectivity to the Siebel Remote Server . . . . . . . 5-3 Setting User Synchronization Options . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Synchronization Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4 Editing Mobile Client Configuration Parameters . . . . . . . . . . . . . . . . . . . 5-9 Setting Siebel Remote Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9 Sample Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11 Editing the Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11 Recovering from Failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12 Setting Up the Siebel Remote Server . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13 Setting Up a New Siebel Remote User . . . . . . . . . . . . . . . . . . . . . . . . . 5-13 Creating a Mobile Client User Account . . . . . . . . . . . . . . . . . . . . . 5-13 Setting Up Mobile Client Hardware and Software . . . . . . . . . . . . . . 5-14 Establishing Autodial Preferences . . . . . . . . . . . . . . . . . . . . . . . . . 5-14 Registering a Mobile Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14 Running Database Extract for a Mobile Client . . . . . . . . . . . . . . . . . 5-15 Starting Siebel Remote Server Processes . . . . . . . . . . . . . . . . . . . . . 5-17 Starting the Transaction Processor . . . . . . . . . . . . . . . . . . . . . . . . . 5-18 Initializing a Mobile Client Local Database . . . . . . . . . . . . . . . . . . . 5-21 Synchronizing a Mobile Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22 How Changes Are Propagated to and from a Mobile Client Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22 Workflow for Changes Made by Mobile Users . . . . . . . . . . . . . . . . . 5-24 Synchronizing a Mobile Client Machine . . . . . . . . . . . . . . . . . . . . . . . . . .5-26 Editing Dedicated Client Configuration Files . . . . . . . . . . . . . . . . . . . . 5-26
5-1
3 Enter your license key number in the dialog box that appears and click OK.
You can find the license key number that has been assigned to your site on the CD-ROM case.
NOTE: If you need to find the License Keys dialog box at a later time, choose
If you see a warning message dialog box, click OK, and then enter your license key number in the dialog box that appears.
NOTE: The first time that you launch Siebel as a remote user (specify a local database), it will automatically prompt you to connect to the Siebel server and retrieve a new local database. You must first extract this database. See the Siebel Remote and Replication Manager Administration Guide for more information on Siebel Remote and extracting local databases.
5-2
Help
to the Server Database Section of the setup.ini file. This statement is not added when the mobile client is created; you must edit the setup.ini file and add it manually if you wish to set up the client as a mobile client. See the Siebel Remote and Replication Manager Administration Guide for more information.
5-3
Figure 5-1.
Synchronization Actions
This section describes the available actions in the Siebel Remote synchronization dialog box as shown in Figure 5-1.
5-4
Connect to Server
This action connects to the server, dials the phone number if necessary, and performs version, schema, and database initialization checking. If a dbinit or upgrade is pending, this action downloads and applies the pending dbinit or upgrade. This action must run successfully for the following three actions to be enabled.
Sleep
This action sets the Siebel Remote client to sleep mode for a given number of seconds. This action displays the number of seconds of remaining sleep time.
5-5
Action List
You can enable or disable each action by clicking the check box to the left of the action. Here are the possible check box states:
Disabled. This action will not run when its turn comes. Not runnable. This action cannot run because an action it depends upon
While an action is running, you can reset the action check box before the action has finished. If an action is running when you disable it, it will stop as soon as possible, and synchronization will continue with the next action. The action status check boxes persist throughout the session. If you start synchronization with the Apply Database Changes option disabled, it will remain disabled throughout synchronization. If you restart Siebel applications, the action status check boxes return to their default state (enabled).
5-6
files.
5-7
Cancel/Hide Button
If synchronization has not started, clicking Cancel will close the Synchronization dialog box and abort synchronization. If synchronization has started, the label on this button will change to Hide, and clicking the button will hide the Synchronization dialog box.
Setup Button
Clicking the Setup button displays the Docking Preferences dialog box. The two File options control which files to synchronize. File options can be changed while synchronization is running.
5-8
When the mobile client receives a transaction on a file table, synchronization decides whether to retrieve the file locally. The default is not to bring down files to the mobile client unless the file is requested. File screens generally have a request field that users can select to bring down the file during the next docking session (if the Retrieve Requested Files action is enabled). Files are also sent upward by docking. If you change a file, you must send the new file up with the transaction to make the corporate database consistent. These files are stored near the corporate database on a file server. Files are named carefully to avoid conflicts should two users attempt to modify a file at the same time.
where
5-9
siebel server name = the name of the computer where the Siebel Server
5-10
is currently running.
network protocol = the name of the networking protocol to use. TCP/IP is the only valid value and is the default value. sync port # = the TCP/IP port number dedicated to the Synchronization
service = the TCP/IP service you are requesting. For docking, it should always be set to the default DOCK. encryption = the encryption package you are using. The encryption facility
must match the type used by the server. Currently, the only supported encryption facility is Mscrypto. The default is NONE.
This parameter must have the same value as the Siebel Server repository.
NOTE: Make sure that you set the value of Siebel_Repository to the name of the
Siebel schema is installed. Default is SIEBEL. To initialize a mobile client database, this parameter must be set to SIEBEL.
FileSystem. Name of the directory on the mobile client where attachment files reside. To use alternative file systems, use a comma-separated list of file system directories. An example is: D:\files,\\bstevens\files
In this example, D:\files is a directory on a CD-ROM, and \\bstevens\files is a directory on the mobile client. In this example, the client will search both directories when files are requested.
DockTxnsPerCommit. Number of transactions that Siebel Remote applies to the local database before performing a commit. You should set this configuration parameter to a value that satisfies the needs at your site. The default is 500. Single user mobile clients. If a user uses the Siebel client application to dock, set the DockTxnsPerCommit to a high value. Presumably, the database is not used by another user; while not committing, merged transactions will not lock out other users. This will enhance the performance of Siebel Remote. Stand-alone synchronizer. If a user uses the stand-alone synchronizer, set the DockTxnsPerCommit to a high value only if the program will be the only active user on the database. If the program will be applying transactions while other users are using the database, then set a low value to prevent locking out other users while merging transactions.
Committing often will affect the performance of other users. Set the DockTxnsPerCommit parameter to any desired value starting with 10 transactions per commit.
5-11
5-12
NOTE: See the Siebel Server Administration Guide for advanced topics; for example,
5-13
2 Click Setup in the Synchronize dialog box to toggle the autodial feature and define its parameters.
1 Log on to your Siebel application using an account with access to the System Administration screen.
5-14
2 Choose Screens
1 Choose File
Synchronize.
Mobile Clients.
4 Enter the user name in the User Login Name field (required).
This is the login name of the mobile client. It will be used to access the local database during initialization and synchronization.
3 Enter the last name for a client user in the Last Name field, and then choose Query Execute Query from the menu.
If the user has a position assigned in the organization hierarchy, the record appears. The position information is used by the systems routing rules, and may affect the outcome of Database Extract.
Positions from the Screens menu. New Query from the menu.
5-15
b Click the Server Tasks applet. If there is a record with Server Manager in the Component field and Running in the Task State field, then Server Manager is already running. 2 Click New on the Server Tasks applet again.
A blank server task record appears.
3 Click the drop-down arrow in the Component field, and select Database Extract from the Pick Assigned Component dialog box. 4 Click Parameters, find the Client Name parameter, and change the Value field to the name of your client user.
The Client Name parameter is required to run Database Extract. The correct value corresponds to the name that appears in the Mobile Client field on the Mobile Clients view of the Siebel Remote Administration screen.
5-16
Servers
The following example shows a portion of the server directory tree after you run Database Extract for the mobile client called MThrelfall:
siebel docking sample inbox outbox MThrelfall inbox outbox
5-17
2 In the Assigned Components list applet, select the Synchronization Manager record. 3 If the Server Manager Task Status is not Running or Enabled, click Enable.
When the component starts, the value of the Component State field changes to Starting up. Once the component is started, the value of the Component State field changes to Enabled or Running.
2 In the Assigned Components list applet, select Transaction Processor. 3 Click Enable if the value of the Component field is not already Enabled. 4 The value of the Component State field changes to Enabled. 5 Click Startup.
When the Transaction Processor starts, the value of the Component State field changes to Starting up. Once the Transaction Processor is started and the task is completed, the value of the Component State field changes to Enabled or Running.
NOTE: The Transaction Processor must be enabled before you can start it.
5-18
Servers
Servers
2 In the Assigned Components list applet, select Transaction Router. 3 Click Enable if the value of the Component field is not already Enabled.
The value of the Component State field changes to Enabled.
4 Click Startup.
When Transaction Router starts, the value of the Component State field changes to Starting up. Once Transaction Router is started and the task is completed, the value of the Component State field changes to Enabled or Running.
NOTE: The transaction router must be enabled before you can start it.
Servers
5-19
2 In the Assigned Components list applet, select Transaction Merger. 3 Click Enable if the value of the Component field is not already Enabled.
The value of the Component State field changes to Enabled.
4 Click Startup.
When Transaction Merger starts, the value of the Component State field changes to Starting Up. Once Transaction Merger is started and the task is complete, the value of the Component State field changes to Enabled or Running.
NOTE: The transaction merger must be enabled before you can start it.
5-20
Servers
1 From the mobile client, establish a connection between the Siebel Remote server and the client machine.
A warning dialog box appears stating that the local Siebel database could not be found. This is expected, as the local database has not yet been initialized.
4 Enter the first and last name of the mobile client user in the Client Name field, and enter the user name in the User Name field. 5 Click Continue.
After the synchronization completes, the client machine is ready for use in the field. From time to time, the mobile user will need to resynchronize with the Siebel Remote Server. Instructions for this process are included in the next section, Synchronizing a Mobile Client.
2 Choose Start
Programs
Siebel Remote.
5-21
1 The new opportunity record is saved to the opportunities table in the Microsoft SQL Server database, and a record is saved to the master transaction log. 2 A Transaction Router task writes each transaction from the database server to transaction files in separate outbox directories for each mobile client.
The mobile client outbox directories are stored on the Siebel Remote server.
5-22
a The Siebel Remote client on the laptop dials the modem to connect to the Siebel Remote server.
This can be handled by an existing modem or LAN connection.
b The Siebel Remote client connects to the Siebel Remote server. c The Siebel Remote server starts the Synchronization Manager for the mobile client. d The Synchronization Manager validates the mobile clients node name against the list of valid mobile clients in the server database. e The Transaction Processor scans the master transaction log on the database server and prepares the transaction log for the Transaction Router.
The transaction log contains a record for the new opportunity.
The Siebel Remote client receives transaction files going to and from the Synchronization server, and retrieves file attachments.
g The client retrieves transaction files created by the Transaction Router from the client users outbox directory on the Siebel Remote server and stores the transaction files in the mobile users local inbox directory. The client also retrieves the users requested, published, or broadcasted file attachments from the Siebel File Server. h The Transaction Router routes the transactions since the users last synchronization from the master transaction log to the users mobile client outbox directory on the Siebel Remote server. i j
The new opportunity record is saved to the opportunities table in the users local copy of the database. The Siebel Remote client closes the connection with the Siebel Remote server.
k On the Siebel Remote server, the Synchronization Manager deletes all transaction files in the users outbox directory (on the server) that the mobile client successfully applied to the users local database.
5-23
After disconnecting from the Siebel Remote server, the Siebel Remote client applies the incoming transaction files to the local database and applies retrieved file attachments to the local file system. The mobile user can use the Siebel client while the Siebel Remote client applies the changes to the local database.
Caution: Users should never directly modify the local transaction log. The Siebel Remote synchronization client automatically purges the local transaction log table.
1 As a result of the meeting, the mobile client user makes changes to the opportunity record. 2 The modified opportunity record is saved to the opportunities table in the local database server, and a transaction record is saved to the local transaction log. 3 The mobile client user synchronizes the laptop.
See the next section, Synchronizing a Mobile Client Machine on page 5-26, for step-by-step synchronization instructions.
5-24
During the synchronization session, the following steps occur to record the changes to the opportunity record:
a Siebel Remote dials the modem to connect to the Siebel Remote server.
This can be handled by an existing modem or LAN connection.
b The Siebel Remote client connects to the Siebel Remote server. c The Siebel Remote server starts the Synchronization Manager for the mobile client user. d The Synchronization Manager validates the mobile client users node name against the list of valid mobile clients in the server database. e The Siebel Remote client extracts all pending transactions from the local transaction log into transaction files and then sends the transaction files to the mobile client users inbox directory on the Siebel Remote server. f
The Transaction Merger task merges the incoming transaction files, including the mobile client users change to the opportunity record, to the database server and Siebel File Server.
g Siebel Remote closes the connection with the Siebel Remote server.
5-25
1 Start Siebel Sales in the Siebel program group on the mobile client machine. 2 Choose File Synchronize from the menu.
The Synchronization dialog box appears. Choose the synchronization options, as discussed in, Setting User Synchronization Options on page 5-3.
3 Click Synchronize.
5-26
Configuring Cursor Close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Calculating Cursor Configuration Parameter Values . . . . . . . . . . . . . . 6-3 Setting Cursor Configuration Parameter Values . . . . . . . . . . . . . . . . . 6-4 Configuring Active Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7 Siebel Docking Transaction Logging at Runtime . . . . . . . . . . . . . . . . . . . 6-7 Configuring Antivirus Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8 Server-Side Performance Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
6-1
6-2
Description Accesses the system to perform system updates and may need to access large amounts of data. Performs development and customization of the Siebel application by running Siebel Tools against the Siebel repository on DB2. Sporadically submits queries or execute operations returning a large number of rows. Examples include: No re-query formulation is available to access the next set of data. Operation requires the complete result set, such as a client Export to Excel. Data returned must be internally consistent. When a re-query is issued, the returned data set may be changed because of other database activity.
-1
-1
Typical
Majority of users. Examples include call center agents and sales representatives.
48
6-3
NOTE: Some Siebel Server programs, such as Incentive Compensation and Report Server, use a Siebel Object Manager (SOM) instance for a subset of their operations. Anomalous behavior will occur if cursor configuration parameters are set for a SOM used by these Siebel Server programs.
NOTE: If usage pattern averages are not available, you should set the Typical standard cursor configuration value to 48 for dedicated clients on a high speed LAN/WAN.
6-4
Identify special users and the standard cursor configuration parameter value for their normal, limited query operations. Create the two logon procedures, Typical and Special. For Siebel administrators and Siebel application developers, turn off the cursor configuration parameters by setting them to -1 in their .cfg files.
guideline, but this combination should be rare. Connect over a high-speed LAN/WAN to the server database, use the same cursor configuration parameter values as those for the dedicated client users.
6-5
1 Copy a Siebel .cfg client configuration file (siebel.cfg or uagent.cfg) and rename it. 2 Set the parameters MaxCursorSize and PreFetchSize in this client configuration file to the desired values.
4 Create a new component using the AppObjMgr component type and set the Configuration File parameter of this component to the parameter value used in Step 2.
For information on creating server components, see the Siebel Server Administration Guide.
6 Stop and restart the Siebel Server on which this new component was created.
6-6
Enterprise Configuration
Component
2 Find Docking:Transaction Logging in the System Preference Name field, and change the System Preference Value to FALSE.
1 From the Siebel client, choose Application Administration from the Screens menu.
System Preferences
6-7
6-8
7
7
A refined query selects a smaller set of rows containing the desired row or, if you are paging through a list, the next set of rows from the database. For example, if you are looking for the contact "ABLE" and enter a query for all names that start with "A," it is likely the result set will be long and the message above will appear when you begin paging through the rows. Instead, refine the query to look for all names that start with "ABL." The result set will be much smaller and more likely to contain the desired row.
7-1
7-2
Thin Client for Windows and Java Thin Client Installation and Configuration
Part 3
Chapter 8. Thin Client for Windows and Java Thin Client Overview Chapter 9. Installing and Configuring Siebel Thin Client for Windows Chapter 10. Installing and Configuring Siebel Java Thin Client Chapter 11. Deploying Siebel Thin Client for Windows Chapter 12. Java Thin Client and Thin Client for Windows Network Requirements Chapter 13. Troubleshooting Thin Client for Windows and Java Thin Client
What Are Thin Client for Windows and Java Thin Client? . . . . . . . . . . . 8-2 Whats New in Java Thin Client and Thin Client for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5 Deploying Windows and Java Thin Client Applications . . . . . . . . . . . . . 8-6 User Interface Functionality Supported in Windows and Java Thin Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7 Applet Classes Supported by Thin Clients . . . . . . . . . . . . . . . . . . . . . 8-8 Supported Control Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9 Unsupported Siebel Script Types . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10
8-1
What Are Thin Client for Windows and Java Thin Client?
Siebel Thin Client for Windows and Siebel Java Thin Client enable enterprises to deploy the user interface layer of Siebel eBusiness Applications in a form in which it can be accessed using a Web browser, as a stand-alone Windows application, or as a Java application. The thin client can dramatically reduce the costs of deploying Siebel eBusiness Applications in the enterpriseusers access the Siebel application from their desktop clients, which connect to a Siebel Server. There are three types of Siebel thin clients:
Siebel Thin Client for Windows. Siebel Thin Client for Windows enables enterprises
8-2
to deploy the user interface layer of Siebel eBusiness Applications in a standard Web browser or as a stand-alone Windows executable.
Siebel Java Thin Client. Siebel Java Thin Client enables enterprises to deploy the
interface. Because HTML Thin Client differs substantially in its installation and usage, it is covered separately beginning with Chapter 14, Siebel HTML Thin Client Overview, in this guide.
With the Siebel thin client architecture, all business logic embodied in the Siebel business objects layer and data objects layer executes in scalable, multi-threaded Application Object Manager server components. The Application Object Manager is a component of the Siebel Server environment and is described in more detail in the Siebel Server Administration Guide.
Figure 8-1 shows an example of a view in Siebel eBusiness Applications as it appears in the stand-alone implementation of Siebel Thin Client for Windows.
Figure 8-1.
8-3
Figure 8-2 shows the same view as it appears in the Siebel Java Thin Client.
Figure 8-2.
8-4
Whats New in Java Thin Client and Thin Client for Windows
Table 8-1 list the new features for the Java Thin Client and Siebel Thin Client for Windows in release 6.x.
Table 8-1.
Feature
New 6.x Features for Java Thin Client and Siebel Thin Client for Windows
Description New in Thin Client for Windows New in Java Thin Client
(Sheet 1 of 2)
New in Both Java Thin Client and Thin Client for Windows
HTTP Tunneling
Use HTTP as the communication protocol between the thin client and Application Object Manager. This is useful for data transfers across firewalls.
View an HTML page inside Thin Client for Windows without the need to launch an external browser.
Column Reordering
(already part of Thin Client for Windows) (already part of Thin Client for Windows)
Attachment
8-5
Table 8-1.
Feature
New 6.x Features for Java Thin Client and Siebel Thin Client for Windows
Description New in Thin Client for Windows New in Java Thin Client
(Sheet 2 of 2)
New in Both Java Thin Client and Thin Client for Windows
8-6
SmartScript
Provides an interactive workflow questions-and-answers guide for call center agents. This feature functions the same as its counterpart in the dedicated client.
8
Information about the applet classes, control types, and script types is provided in the following three sections.
8-7
8-8
8-9
Any views containing unsupported business component scripts can be displayed to a thin client user, but the functionality provided by the script will be unavailable.
8-10
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2 Connect String Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2 Where to Find Information for New Connect String . . . . . . . . . . . . . . 9-2 Support for Connect String Style Prior to Siebel 2000 . . . . . . . . . . . . . 9-3 Pre-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3 Verifying Thin Client Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3 Verifying the Siebel Enterprise Server . . . . . . . . . . . . . . . . . . . . . . . 9-4 Understanding the Administrator Installation Tasks . . . . . . . . . . . . . . 9-5 Installing Siebel Thin Client for Windows . . . . . . . . . . . . . . . . . . . . . . . 9-5 Launching Siebel Thin Client for Windows . . . . . . . . . . . . . . . . . . . . . 9-10 Creating a Custom Installer and Sharing Thin Client Files Creating a Custom Thin Client for Windows Installer . . . . . . . . . . 9-10 . . . . . . . . . . . 9-11
Packaging the Thin Client for Windows Installer . . . . . . . . . . . . . . . 9-15 Distributing the Thin Client Installer . . . . . . . . . . . . . . . . . . . . . . . 9-16 Modifying the Shortcut for the Stand-Alone Executable . . . . . . . . . . . . 9-17 Sample Connect Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-18 Server-Side Performance Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-20 Removing Thin Client for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 9-20
9-1
9-2
Pre-Installation Tasks
You must complete the following pre-installation tasks before you begin the installation and configuration tasks for Siebel Thin Client for Windows: Verifying Thin Client Platforms Verifying the Siebel Enterprise Server on page 9-4 Understanding the Administrator Installation Tasks on page 9-5
NOTE: CORBA and Resonate Central Dispatch are not required to run Siebel Thin
9-3
If you or someone else filled out the Deployment Planning Worksheet before installing your Siebel servers, make a copy and keep it with you while installing the thin client; otherwise, make a note of the Siebel Enterprise Server name and the IP address (or Gateway VIP if you are using Resonate Central Dispatch) of the Gateway Server, as well as the name of the Object Manager-defined components operating on the Enterprise Server. You will need this information when configuring the thin client start-up files for Windows.
9-4
1 Test the standard installer for Thin Client for Windows to decide how you want to customize the installation for your users. See Installing Siebel Thin Client for Windows on page 9-5, which provides instructions for installing Thin Client for Windows using the standard installation process provided on your CD-ROM. 2 Customize the installation process by editing the siebel.ini file. You may want to suppress dialog boxes that you dont want your users to see, select and enforce a default installation directory, and so on. See Creating a Custom Thin Client for Windows Installer on page 9-11 for instructions. 3 Provide your users with the location of the customized installation program and instructions for installing in their environment.
NOTE: Typically, you would place your customized self-extracting installer, such as the setupex.exe file, on the public Web server, to be downloaded by the thin client end-users, to install before they launch the thin client program.
9-5
The thin client start-up files for the ActiveX control and the Netscape plug-in are automatically installed into the \tclient subdirectory of the Siebel Server during Siebel Server installations on Windows NT. See To verify that the Thin Client for Windows start-up files were installed on page 9-9. The stand-alone Thin Client for Windows does not require a start-up file.
NOTE: You should test the standard installation process, compare it to the way you want your thin client users to install the program, and modify the installation process to conform to the needs of your thin client users. You should not distribute the thin client installation program to your users as it stands. You should customize the installation process, possibly suppressing all dialog boxes and choosing defaults for your users, to produce the easiest possible installation process.
To customize the installation for your thin client users, see Creating a Custom Thin Client for Windows Installer on page 9-11. To install Thin Client for Windows using the standard installation process
NOTE: This standard installation process applies to all Thin Client for Windows installations, including the ActiveX control, Netscape plug-in, and stand-alone Thin Client for Windows implementations.
1 On the CD-ROM drive, navigate to the Windows Client\thinclient directory and double-click setup.exe. 2 In the Choose Setup Language dialog box, select your language from the picklist, and then click OK.
The Welcome dialog box appears.
9-6
6 In the Select Components dialog box, click the Browse button to select an alternate destination directory if needed and then click Next.
If an alternate destination directory is not selected, Thin Client for Windows files will be automatically installed in the default Program Files\siebel\tclient directory.
NOTE: To install the Thin Client for Windows files in a different directory, change the RootDirectory parameter from Program Files\siebel\tclient to the directory where you want your users to install the files. If you are making changes such as this one to the client installation program, you will later create a custom installation program so that your users can install the thin client for Windows on their client machines. The RootDirectory parameter resides in the siebel.ini file. Instructions are provided in Creating a Custom Thin Client for Windows Installer on page 9-11.
Thin Client for Windows within a browser. This is the win32 stand-alone executable version of the Thin Client for Windows.
ActiveX Control: Select this option if your users will run Thin Client for
Windows within a Netscape browser. In addition, there are optional components that can be installed during the Siebel Thin Client for Windows installation; for example, CTI (Computer Telephony Integration support).
9-7
7 In the Load Balancing dialog box, select the applicable option and click Next:
Click Yes if your Siebel Server will use Resonate. Click No if your Siebel Server will not use Resonate.
NOTE: Step 7 through Step 13 will only appear if the Stand-alone version is selected during the Custom installation option. If you did not select the Standalone version, go to Step 14 now.
8 In the Gateway and Enterprise Server Information, enter information for each of the fields, and click Next.
Gateway Server Host: the default is localhost. Gateway Port: the default is 2320. Enterprise Server Name: the default is siebel.
9 In the Siebel Server Information dialog box, enter the name of your Siebel Server, and then click Next. 10 In the Object Manager Component dialog box, enter the component name for your Object Manager and click Next.
You can use one of the following components: SSEObjMgr for Siebel Sales SSVObjMgr for Siebel Service SCCObjMgr for Siebel Call Center SFSObjMgr for Siebel Field Service
11 In the Connection Protocol dialog box, select either TCP/IP or HTTP, and then click Next. 12 In the Encryption Type dialog box, select the type of encryption to use for the connection, and then click Next. 13 In the Compression Method dialog box, select the compression type to use for the connection, and then click Next.
A status bar appears to show the progress of the installation.
9-8
To verify that the Thin Client for Windows start-up files were installed Ensure that the \tclient directory exists on one Siebel Server and has been populated with these files: enu.txt, tclient.htm, tclient.stc. The files are installed from the Siebel Server, so they need only be available on one Siebel Server. There are no further steps for installing Thin Client for Windows. Now you must modify the start-up files for the clients if you are running the thin client from a Web browser. See the Siebel Server Installation Guide for instructions on configuring tclient.stc and tclient.htm. The stand-alone Thin Client for Windows does not require further configuration.
9-9
Double-click the shortcut Siebel Thin Client for Windows, created on the desktop during installation. The shortcut launches either Microsoft Internet Explorer or the Netscape Web browser with the URL address specified in the siebel.ini file.
NOTE: If client users will use the stand-alone version of Thin Client for Windows, you do not need to distribute the start-up files. In this case, you must distribute only the Thin Client for Windows client installation program after you have finished customizing it.
9-10
Programs
2 Copy the Thin Client for Windows files to the administrators workstation. Copy the entire Windows Client\thinclient directory from the Siebel eBusiness Applications Client Programs CD-ROM to a directory on the administrators workstation.
This next section assumes that the directory on the administrators workstation is c:\ThinClient; be sure to substitute the actual directory name where you see this reference.
9-11
2 Startup. In the [Startup] section, you can modify the following parameters:
HideBackground. When the HideBackground parameter is set to No, the
9-12
installation background window is displayed during the client installation. When it is set to Yes, the user will not see the background. The default setting is No.
Language. This parameter specifies the language for the installation. The default setting is ENU for American English.
the client machines desktop to the Thin Client for Windows executable.
FolderIcon. This parameter is set to Yes by default to create a shortcut in the
client machines Program Folder to the Thin Client for Windows executable.
5 Dialog. You can modify the following parameters in the [Dialog] section. If you would like to supply a silent installation that enforces particular parameter values, set each dialog box to No.
Welcome. Setting the Welcome parameter to Yes shows a Welcome dialog box
tclient.stc file. Here is an example if your users are accessing Thin Client for Windows from Internet Explorer. Notice the .htm extension at the end of the path:
http://myserver/tc/elise/CallCenter.htm
Here is an example for your users who are accessing Thin Client for Windows from within a Netscape Web browser. Notice the .stc extension at the end of the path:
http://myserver/tc/elise/CallCenter.stc Caption. The default is Siebel Thin Client for Windows.URL.
Change this setting if you would like to change the text on the icon.
Folder. This is set to Desktop by default and specifies where the shortcut to Thin Client for Windows is located for your users. The shortcut differs depending on whether your users are running Siebel Thin Client for Windows from within the Netscape or the Internet Explorer Web browser.
when users begin the installation of Thin Client for Windows. The default setting for this parameter is Yes. Set this parameter to No if you dont want your users to see this dialog box.
FolderName. If set to Yes, this dialog box appears and enables the user to set
the name of the folder in which Thin Client for Windows will appear in the Programs group. Set this parameter to No if you do not want your users to see this dialog box.
9-13
Setup Type. If set to Yes, the Setup Type dialog box appears during the installation. The user can select from Typical, Compact, or Custom options in this dialog box. Set this parameter to No if you do not want your users to see this dialog box during the installation process. Finish. If set to Yes, the Finish parameter will display a dialog box indicating
6 Defaults. You can modify the following parameters in the [Defaults] section:
RootDirectory. The directory into which Thin Client for Windows will be
9-14
that the installation was successful. The default setting for the Finish parameter is No. This ensures that the installation will not be noticeable to the end user.
installed. The default is \Program Files\siebel\tclient. Leaving this parameter set to No will not give users the ability to edit the default installation directory. The default installation directory is specified in the Defaults section in the siebel.ini file. The default setting for this parameter is Yes. Set this parameter to No if you dont want your users to see this dialog box.
GatewayHost. Replace with the name of your Gateway Server. GatewayPort. Replace with the transport protocol with 80 for TCP/IP or 2320
ConnectionCompression. Replace with the compression used during data transfers. The default is none. ResonateInstalled. Replace with TRUE if your configuration includes Resonate Central Dispatch. The default is FALSE. FolderName. Specifies the default Program group name, Siebel Thin Client 6.0.
7 Module. If you are creating a silent installation, identify the components you want to install by setting the parameters in the [Modules] section.
For example:
[Module.Configuration] Typical = ACTIVEX,CTI
Save and close the siebel.ini file once you have made the desired edits. To test the settings, double-click the C:\ThinClient\setup.exe file in Windows Explorer to launch the Thin Client for Windows installer. It will execute using the settings that you just entered in the siebel.ini file.
1 In Windows Explorer, double-click the file exebuild.exe in the \packager\bin subdirectory of your Siebel dedicated client installation to start the EXE Builder. 2 Perform the following steps to run exebuild.exe, the program that builds the new installer: a Click Next in the Welcome dialog box. b In the first of four dialog boxes, specify the directory into which you copied the thin client files in Step 2 on page 9-11. Select both Create a 32bit selfextracting EXE and Compress the included files. Click Next. c In the second dialog box, select setup.exe as the executable to be launched upon extract. Click Next.
9-15
d In the third dialog box, enter the target directory in which the self-extracting executable will be created. Enter an application name, if desired. You may also enter a password that users will need to specify to install the software. Click Next. e In the fourth dialog box, review Source File Location, Command line to run, and Self-extracting EXE to create information. If any of these settings is incorrect, click Back to return to the appropriate dialog box and correct the information. Click Finish when you are ready to create the Installer.
NOTE: The EXE Builder will package your customized Siebel Thin Client for Windows installer into a single, self-extracting executable file, setupex.exe. This is the file that must be distributed to your thin client users for installation.
You may elect to use a combination of these methods to serve different user communities. Whichever sharing mechanisms you elect to deploy, distribute the customized installer now and make sure that the thin client machines have read access to them. Once the Thin Client for Windows customized installer is accessible to the thin client machines, your clients are ready to proceed with installing Siebel Thin Client for Windows.
9-16
Distribute the actual file through email, CD-ROM, or other distribution medium. Use commercial software distribution products to distribute and potentially execute the thin client installer.
To modify the shortcut for the stand-alone thin client on a single machine
1 Find and right-click the shortcut icon, and choose Properties from the Shortcut menu. By default, a shortcut is created in the Programs folder and on the Desktop.
The Siebel Thin Client Shortcut Properties dialog box appears.
2 The shortcut URL appears in the Target field on the Shortcut tab, and looks similar to this example:
"C:\Program Files\siebel\tclient\BIN\siebtc.exe" /host "siebel[.transport][.encryption][.compression]:// <gatewayserver>[:port]/<enterpriseserver>/<objectmanager>/ <siebelserver>"
where < > (angle brackets) indicate a required parameter, and [ ] (square brackets) indicate an optional parameter.
Transport values are tcpip or http. The default is tcpip. Encryption values are none or mscrypto. The default is none. Compression values include none, zlib, and pkware. The default is none.
NOTE: If you want to accept the default protocol settings, all protocol values
9-17
b Substitute your Gateway Server address and port for <gatewayserver>, your Enterprise Server name for <enterpriseserver>, your Application Object Manager component name for <objectmanager>, and your Siebel Server name for <siebelserver>.
NOTE: You must specify <siebelserver> if you are not using Resonate
Central Dispatch. If you are using Resonate Central Dispatch, <siebelserver> is optional.
3 Click Apply to save your changes, and then click OK to dismiss the Siebel Thin Client Properties dialog box.
9-18
Example 1
"siebel.none.mscrypto://<gatewayaddress>[:port]/ <siebelenterprise>/objectmanager>"
Example 2
"siebel.http.mscrypto://<gatewayaddress>[:port]/ <siebelenterprise>/<objectmanager>"
Here is an example that uses http for the transport, no compression, and no encryption:
"siebel.http.none.none://<gatewayaddress>[:port]/ <siebelenterprise>/<objectmanager>"
9-19
See the Siebel Server Administration Guide for information about disabling Find Fast and other server performance enhancements that will improve client performance.
9-20
10
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2 Where to Find Information for New Connect String . . . . . . . . . . . . . . . 10-2 Pre-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2 Verifying Thin Client Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2 Verifying the Siebel Enterprise Server . . . . . . . . . . . . . . . . . . . . . . . . . . .10-3 Installing Siebel Java Thin Client Under UNIX . . . . . . . . . . . . . . . . . . . 10-4 Configuration Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6 Editing the Java Thin Client Configuration File . . . . . . . . . . . . . . . . 10-6 Year 2000 Compliance in Siebel Java Thin Client . . . . . . . . . . . . . . 10-11 Customizing the Java Thin Client Help . . . . . . . . . . . . . . . . . . . . 10-11
Sharing Thin Client Start-Up Files . . . . . . . . . . . . . . . . . . . . . . . . . . 10-17 Starting Java Thin Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-17 Removing Java Thin Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-18
10-1
10
This chapter covers the installation of Siebel Java Thin Client. Siebel Java Thin Client should be installed once in a directory accessible to all the thin client users.
10
See Sample Java Thin Client Start-Up File on page 10-6 and Editing the Java Thin Client Configuration File on page 10-7.
Pre-Installation Tasks
Verifying Thin Client Platforms Verifying the Siebel Enterprise Server on page 10-3
10
You must complete the following pre-installation tasks before you begin installation of Siebel Java Thin Client:
10-2
10
Network connectivity to the Siebel Enterprise Server using one of the supported network protocols and configurations specified in the Siebel Release Notes.
10
Before installing Siebel Java Thin Client, you must have completed the installation of the Siebel Database Server and Siebel File System, and have installed and configured an Enterprise Server containing the Gateway Server and at least one Siebel Server, following the instructions provided in the Siebel Server Installation Guide. Java Thin Client supports the Enterprise Server running on both Windows NT and UNIX platforms.
NOTE: It is strongly recommended that you implement the connection-brokering capabilities of the Siebel Gateway Server if you will support the Java Thin Client from multiple Siebel Servers. These capabilities help to provide high scalability and availability for your thin client users. Refer to your Siebel Server Installation Guide for more information on connection brokering.
If you or someone else filled out the Deployment Planning Worksheet before installing your Siebel Servers, make a copy and keep it with you while installing Java Thin Client; otherwise, make a note of the Siebel Enterprise Server name and the IP address (or VIP if you are using Central Dispatch) of the Gateway Server, as well as the name of the Application Object Manager-defined components operating on the Enterprise Server. You will need this information when configuring siebel.cfg for Java Thin Client.
10-3
10
Java Thin Client consists of client-side software written in the Java language. The Java Thin Client connects to the Application Object Manager, which is a component of the Siebel Server. See the Siebel Server Administration Guide for detailed information about the Application Object Manager. To install Siebel Java Thin Client on a supported UNIX platform, you must first install a supported Web browser. Once you have installed the Web browser, you are ready to install Siebel Java Thin Client on a network-accessible machine to which all the thin client users have access. To install Siebel Java Thin Client
1 Open a command shell window. 2 Create a directory in which you want to install Siebel Java Thin Client. 3 Navigate to the /Java Client/jtc/jtc_Installer directory on your UNIX server CD-ROM and open the install.htm file using your Web browser. 4 The Siebel Java Thin Client Installer Web page opens. 5 Select the For Solaris link for your UNIX install.
The Java Thin Client Installer instructions screen appears.
6 Select the Install the Siebel Java Thin Client for Solaris link for your UNIX install.
The Save Downloaded File dialog box appears.
8 Open a UNIX shell command window and change directory into the directory into which you downloaded the installation file, setup.bin.
10-4
9 Execute the Siebel Java Thin Client installation program by typing the following command and pressing ENTER:
sh setup.bin
10 Enter the directory created in Step 2, and then click Next to install Siebel Java Thin Client.
The default selection is Siebel.
1 Click the Back button in the browser to return to the initial Siebel Java Thin Client Installer Web page. 2 Select the Update the Default Configuration File hyperlink.
The Save Downloaded File dialog box appears.
NOTE: If the Save Downloaded File dialog box does not appear, right-click the
link and choose Save Link As. The dialog box will now appear.
3 Choose the same directory into which you installed the Java Thin Client, and click Save.
Caution: Be sure that your siebel.cfg file is not saved with the wrong extension. Note that your browser will save the .cfg file with the extension of the last file that it saved. Therefore, if the last file your browser saved had a .exe extension, your configuration file (siebel.cfg) would become saved as siebel. If this happens you will not see anything in the login pop-up box.
10-5
Configuration Tasks
After installing Java Thin Client on a machine to which all thin client users have access and copying the configuration file to the same directory, you must: Edit the configuration file, siebel.cfg, to set the default Siebel connectivity information. Ensure Year 2000 compliance in your Java Thin Client applications.
10
Siebel Java Thin Client is configured with the siebel.cfg file, a text file that sets a number of run-time parameters, including its default appearance, authorization information, and connectivity information. If you have not already retrieved the file from the CD-ROM, its located on the UNIX Server CD-ROM under /Java Client/ jtc/jtc_installer.
10-6
10
[SSE] SOMConnectString = "siebel://elan/esprit/sseobjmgr/esprit" [SSV] SOMConnectString = "siebel://elan/esprit/ssvobjmgr/esprit" [SCC] SOMConnectString = "siebel://elan/esprit/sccobjmgr/esprit" [SFS] SOMConnectString = "siebel://elan/esprit/sfsobjmgr/esprit" [FileExtensionMap] Browser = "/opt/netscape/netscape" html = "/opt/netscape/netscape" jpg = "/opt/netscape/netscape" gif = "/opt/netscape/netscape" bmp = "/opt/microsoft/bin/iexplorer" txt = "/usr/dt/bin/dtpad" cfg = "/usr/dt/bin/dtpad"
10-7
To edit siebel.cfg
1 Edit the DataSource, DateYearFormat, and DecimalNumberScale parameters in the Siebel section as described here:
[Siebel]: This section sets the default connection, date format, and number
2 Edit the parameters in the [DataSources] section to add or modify the servers in your local Siebel deployment.
[DataSources]: This section lists the available Siebel Servers in your deployment in the following format: Sample SSE SSV SCC SFS = = = = = "Sample "Siebel "Siebel "Siebel "Siebel Database" Sales" Service" Call Center" Field Service"
3 Add a data source section for each data source you added in Step 2, and replace <gatewayserver> with the name of your Gateway Server, <enterpriseserver> with the name of your Enterprise Server, and <siebelserver> with the name of your Siebel Server in each connect string to show the servers from which that particular data source is available.
10-8
format for your Siebel client. The default for this section reads as follows:
DataSource DateYearFormat DecimalNumberScale = "SCC" = "YYYY" = "2"
Edit DataSource to show your users default data source, selecting from the available data sources listed in Step 2. Leave DateYearFormat as it stands; it is already properly set to use four-digit dates. Using four-digit dates prevents Year 2000 problems with your data. Leave DecimalNumberScale as it stands unless you want your Siebel application to display numbers in some format other than with two decimal places showing.
4 Modify the parameters in the FileExtensionMap section to point to your default browser, and add other extensions as needed for the file types used in your deployment.
[FileExtensionMap]: This section lists file extensions and associates them with
will have a section of its own. The connect string for each data source takes this general form:
"siebel[.transport][.compression]://<gatewayserver>[:port]/ <enterprisename>/<objectmanagername>[/<siebelservername>]" [SSE] SOMConnectString = "siebel://<gatewayserver>/ <enterpriseserver>/sseobjmgr/<siebelserver>" [SSV] SOMConnectString = "siebel://<gatewayserver>/ <enterpriseserver>/ssvobjmgr/<siebelserver>" [SCC] SOMConnectString = "siebel://<gatewayserver>/ <enterpriseserver>/sccobjmgr/<siebelserver>" [SFS] SOMConnectString = "siebel://<gatewayserver>/ <enterpriseserver>/sfsobjmgr/<siebelserver>"
In addition to these default entries, you can add any other extensions you want and associate them with any application program installed on your workstation. Examples of extensions you may want to add include:
NoExtension asc txt text htm shtml htp asp = = = = = = = = "<application>" "<application>" "<application>" "<application>" "<application>" "<application>" "<application>" "<application>"
10-9
NoExtension tells Siebel how to treat files with no extension, such as a Readme file. The extensions asc, txt, and text are common extensions for ASCII text files, and should be associated with a text editor, such as vi or Emacs. The remaining extensions in the sample list refer to several different types of HTML files, which should be associated with your Web browser. You can also add extensions for attached files in formats such as graphics programs, audio clips, video clips, and any other type of data you may include on your server.
5 Set the parameters in the Preferences section to reflect the color scheme and fonts for your user interface.
[Preferences]: This section allows you to set the default color scheme and fonts that Siebel Java Thin Client will use. The default entries are: ;Colors = Web ;DefaultFont = SansSerif-12-normal ;ScreenBitmap = FALSE ;ListAlternateColor = FALSE
10-10
To set Colors to a value other than the default, remove the semicolon from the beginning of the line. The options for this entry are Web, High, and VGA. To set DefaultFont to a different font, remove the semicolon from the beginning of the line. You can also change this entry to modify the point size and style. Available fonts are Serif, SansSerif, and Monospaced. Available point sizes are whole numbers between 8 and 24, although most users on most systems will find any point size below 10 too small and any size above 14 too large. Available styles are normal, bold, and italic. To set ScreenBitmap to TRUE, remove the semicolon from the beginning of the line. If this parameter is set to FALSE, the bitmap of the currently selected view will not appear in the View bar. If set to TRUE, the bitmap will appear in the View bar. To set ListAlternateColor to TRUE, remove the semicolon from the beginning of the line. If set to FALSE, the rows in list applet tables will not use alternating list color, which means all rows in each list applet table will use the same background color. In this case the tables will display horizontal grid lines. If set to TRUE, list applet tables will display alternate rows in different colors.
10
The Java VM (Virtual Machine) returns a 2-digit date by default. For example, 99 is the 2-digit format representing the 4-digit format for 1999. This default 2-digit format could have an impact on users running Siebel applications in the Java Thin Client environment. Users may inadvertently enter a date with an incorrect century. The siebel.cfg file shipped with Java Thin Client is configured correctly to enforce use of a 4-digit date format for Java Thin Client itself, as the DateYearFormat parameter is set to YYYY. Ensure that this setting is present in every .cfg file for each application installed on each client computer in your organization that will use the Java Thin Client environment.
10
10-11
10-12
(Sheet 1 of 4)
Purpose/Contents Getting Started table of contents Cascading style sheet for the project Table of contents Page containing Siebel banner Page containing frames; page to click to start viewing help system Welcome topic Basics table of contents Entering information topics Finding and sorting topics, including querying Keyboard shortcut topics Logon instructions topic Menu topics Working with menus, screens, and views topics Navigating between views topics Setting options topics Administration screen topics CTI Toolbar topics Glossary
jtc_basics
other
10-13
Table 10-1.
Directory
(Sheet 2 of 4)
Purpose/Contents Screen topics table of contents Accounts screen topics Activity Management screen topics Agreements screen topic Calendar screen topics Contact Management screen topics Employees screen topics Entitlements screen topics Product Information screen topics Campaigns screen topics Categories screen topics Incentive Compensation screen topics List Management screen topics Opportunity Management screen topics Price Lists screen topics Quotes screen topics Responses screen topics
screentopics
contents_screen_topics.html sa_accounts.html sa_activ.html sa_agree.html sa_cal.html sa_cont.html sa_empl.html sa_ent.html sa_prodi.html se_camp.html se_cat.html se_incent.html se_list.html se_opp.html se_price.html se_quote.html se_resp.html
10-14
Table 10-1.
Directory
(Sheet 3 of 4)
Purpose/Contents Sales Quotas screen topics Cycle Counts screen topics Inventory Transactions screen topics Orders screen topics Part Browser screen topics Receiving screen topics Repair screen topics Service Requests screen topics Service Inventory screen topics Shipping screen topics Assets screen topics Quality and Defect Tracking screen topics Solutions screen topics
screentopics (continued)
10-15
Table 10-1.
Directory
(Sheet 4 of 4)
Purpose/Contents New Query icon Run Query icon Add New Record icon Switch icon Bitmap for returning to the top of the page Copy button Cancel button Delete button New button Switch icon Blue bullet used in the tables of contents Copyright symbol Call button New Correspondence button New Query icon Run Query icon Resizing a column, image 1 Resizing a column, image 2 Siebel header
gif graphics
10-16
10
Once you have installed Siebel Java Thin Client and edited the configuration file, notify your thin client users. For ease of maintenance, Siebel strongly recommends that you share the configuration file from a network-accessible machine, in the same directory in which you installed Java Thin Client. This allows you to easily distribute changes in the event that your Siebel Enterprise Server configuration is altered.
10
1 Execute Siebel Java Thin Client using the siebel program directly from a command shell window with the ./Siebel command.
The logon dialog box appears.
2 Enter your Siebel user ID, password, and connect string or data source name.
If the siebel.cfg file has been properly configured, then you can choose the data source to which you want to connect. Enter the name of the data source you will use from those listed in your siebel.cfg file. If you are a system administrator setting up a client workstation, look in the siebel.cfg file for a list of available data sources. If you are an end user, your system administrator should provide you with an appropriate connect string and data source. If you prefer, you can enter the appropriate data source name instead of a connect string. You will then be connected directly to the specified data source.
Version 6.2, Rev. A
10-17
10
1 Open a command shell window. 2 Change directory to the parent directory of the Java Thin Client installation directory. 3 Type the following commands exactly as shown:
rm -rf [directory]
10-18
11
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2 Thin Client for Windows Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2 Deployment Sample Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3
11-1
11
11
Siebel Thin Client for Windows is a deployment option for customers who want to deploy their existing Siebel eBusiness Applications over the Internet or on their corporate intranet. Thin Client for Windows is a deployment option because customers do not have to perform additional configuration using Siebel Tools. The application configurations that were completed for dedicated clients can also be deployed through Thin Client for Windows. For example, A. K. Parkers PC sales division has an existing Siebel Call Center application that supports the call center agents when potential customers call or when agents are following up with customer leads. A. K. Parker wants to make the application available to satellite sales offices. Because A. K. Parker already has a fully functional Siebel Call Center application in use, the work required to implement Thin Client for Windows is minimal. The next section, Deployment Sample Steps, provides a model for implementing Siebel Thin Client for Windows.
NOTE: There are a few exceptions in which dedicated client functions have yet to be supported on Thin Client for Windows. Please see Chapter 8, Thin Client for Windows and Java Thin Client Overview, for more information.
11-2
11
1 Install and customize a Siebel eBusiness Application, such as Siebel Call Center. a Use Siebel Tools to customize the applets and views within the selected Siebel eBusiness Application. b Install the dedicated client.
Every Siebel Thin Client for Windows deployment should contain at least one dedicated client installation. This is so that administrators can configure and administer the non-administrator client machines. Administrators use the dedicated client to set server component parameters, define workflow rules, and so on. In addition, the dedicated client can be a useful way to debug a thin client application.
11-3
If thin client users will run the Siebel application using a Netscape browser, and you need to edit start-up parameters, edit tclient.stc. If thin client users will run the Siebel application using the Internet Explorer browser, and you need to edit start-up parameters, edit tclient.htm. If both Netscape and Internet Explorer browsers are in use among the thin client users, and you need to edit start-up parameters, you must edit both tclient.stc and tclient.htm. If the thin client users will run the stand-alone Thin Client for Windows, you do not need to edit start-up files.
4 Test your Siebel application by viewing it with Siebel Thin Client for Windows. 5 If necessary, you can run the application using the dedicated client if you need to debug the customizations in your Siebel application.
11-4
Java Thin Client and Thin Client for Windows Network Requirements
12
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2 Accessing the Thin Clients from Outside a Firewall . . . . . . . . . . . . . . . 12-2 Firewall Requirements in a Load-Balanced Environment . . . . . . . . . 12-2 Firewall Requirements in a Non-Load-Balanced Environment . . . . . . . . . .12-4
12-1
Java Thin Client and Thin Client for Windows Network Requirements
About This Chapter
12
This chapter outlines the network configuration requirements for deploying Siebel Java Thin Client and Siebel Thin Client for Windows. This information is particularly useful when deploying these applications across firewalls.
12
One of the key advantages of Siebel Thin Client for Windows and Siebel Java Thin Client is the capability of allowing users to connect to Siebel eBusiness Applications through a remote connection. Enabling thin clients to connect to Siebel Servers over the Internet and through a firewall requires specific client/server, firewall, and network configurations.
12
If you are using Resonate Central Dispatch to dynamically load-balance connections across the Enterprise Server, you need to expose only a single port through the firewall. The Siebel thin clients use this port to connect to the Siebel Gateway Server, which in turn forwards the connection to the Application Object Manager. In the load-balanced environment, the Application Object Manager supports connections using both TCP/IP and tunneled HTTP. If you are using TCP/IP, you must expose the TCP port of the Gateway Server (the default is 2320) through the firewall. If you are using HTTP, you need to expose only a generic HTTP port; the default HTTP port is 80. If you are using load balancing, both HTTP and TCP/IP connections to Application Object Manager support firewalls that perform network address translation. However, neither can be used with a firewall that has a multiplexing application proxy. While the use of HTTP does create some overhead and can degrade response times, you may prefer it for firewall configurations requiring packet filtering or other stringent security measures.
12-2
Java Thin Client and Thin Client for Windows Network Requirements
Accessing the Thin Clients from Outside a Firewall
The Application Object Manager communications protocol is set as part of the definition of each Object Manager-defined component. As multiple defined components can operate in the Enterprise Server, it is possible to use a mix of HTTP and TCP/IP communications in your deployment; however, each Object Manager can use only a single protocol, and the start-up file for a thin client can only specify one Application Object Manager-defined component. See the Siebel Server Administration Guide for instructions on configuring the communication protocol for Application Object Manager.
NOTE: See Editing the Java Thin Client Configuration File on page 10-6 for
information about configuring Java Thin Client. See the Siebel Server Installation Guide for instructions on configuring the thin client startup files for the ActiveX control and the Netscape plug-in. The stand-alone Thin Client for Windows does not require configuration.
12-3
Java Thin Client and Thin Client for Windows Network Requirements
Accessing the Thin Clients from Outside a Firewall
12
The firewall requirements are slightly different if you do not use load balancing in your Enterprise Server. The Application Object Manager only supports connections over TCP/IP in this environment. In addition to the Gateway Server TCP port (the default is 2320), the TCP port on which each Object Manager listens must also be exposed through the firewall. The Object Manager port is determined by the Object Manager configuration and can be allocated dynamically or statically. To minimize the number of ports that must be opened through the firewall, it is recommended that you use static port allocation and create as small a number of Object Manager-defined components as possible.
NOTE: In the non-load-balanced environment, the Object Manager connection does not support network address translation, and does not support firewalls with multiplexing proxy servers.
12-4
13
13
As Java Thin Client and Thin Client for Windows are deployment platforms, there are several items you can check if your client is not functioning as expected:
Make sure that the Siebel Server Object Manager component configuration file has the correct parameters; for example, make sure that the configuration file for Siebel Call Center, uagent.cfg, has the correct parameters, such as Database ConnectString and TableOwner. Verify that Siebel Servers and the Object Manager components to which Siebel Thin Client for Windows will be connecting are operating. Verify that the user login and password are correct. Make sure that each item in your connect stringincluding the Gateway Server, Enterprise Server, Object Manager, and Siebel Server settingis correct. Verify that the configuration files used by Siebel Server have the correct data source setting; for example, make sure that the data source setting in uagent.cfg, located in \server\bin, is set correctly for Siebel Call Center.
13-1
13-2
Part 4
Chapter 14. Siebel HTML Thin Client Overview Chapter 15. Preparing to Install Siebel .COM Applications on Windows NT Server and UNIX Systems Chapter 16. HTML Thin Client Network Requirements Chapter 17. Troubleshooting
14
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-2 Whats New in This Release of HTML Thin Client . . . . . . . . . . . . . . . . 14-2 How Siebel HTML Thin Client Works . . . . . . . . . . . . . . . . . . . . . . . . . 14-3 What Is Siebel HTML Thin Client? . . . . . . . . . . . . . . . . . . . . . . . . . 14-4 Key Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-4 What Happens When a User Enters a URL . . . . . . . . . . . . . . . . . . . . . 14-5 Where to Find Additional Information . . . . . . . . . . . . . . . . . . . . . . . . 14-8
14-1
14
This chapter defines the concepts behind Siebel HTML Thin Client, the technology behind Siebel .COM Applications, and describes the architecture of an n-tiered system developed using Siebel HTML Thin Client.
NOTE: Siebel HTML Thin Client differs substantially from the other Siebel thin
clients.
14
Dynamic drilldown
Personalization
14-2
14
Siebel HTML Thin Client is a set of components for customizing and implementing the .COM Web applications based on Siebel object definitions, as shown in Figure 14-1. While the figure denotes Siebel HTML Thin Client components with a shaded box, the areas that are not shaded, such as the Web server and the database server, are integral to the HTML Thin Client technology.
Templates
Database
14-3
14
Siebel HTML Thin Client is a technology used for deploying the Siebel .COM Applications. The .srf definition of applications can be displayed using .swt files for HTML formatting and layout. Users of the Siebel .COM Applications can: View dynamically generated Web pages that include data from a Siebel database. Add to, delete, or modify data in a Siebel database. Perform queries, sorts, and other operations using any of the other thin clients or a dedicated client.
Siebel HTML Thin Client is part of a larger system that also includes Application Object Manager, Siebel Server, a database server, and a Web server, which together enable you to deploy and customize Siebel .COM Applications.
Key Components
Siebel Web templates. HTML pages that contain both standard HTML tags and
14-4
14
Figure 14-1 on page 14-3 lists the key components of the HTML Thin Client system: Siebel tags. The Web application developer creates an application definition in Siebel Tools, associates templates for layout, and deploys the resulting application on a Web server, enabling users to access it through a Web browser.
Siebel Web Engine. Joins template layout definition with repository-based
application definition; this service inside Application Object Manager dynamically generates the HTML pages that make up the applications user interface.
Application Object Manager. The component of the Siebel Server that passes Siebel
object definitions and data between the database and the Siebel Web Engine. These object definitions provide the application logic and enable the user to interact with the database.
14
1 A user with a browser sends the URL of your application to your Web server.
The user can do this by typing in the URL or clicking a link on your main site. An example of this URL is: http://www.mycompany.com/siebel/eService/ start.swe?SWEView=ISS+Service+Request+View
2 The suffix of this URL (.swe) tells your Web server to direct the request to the Siebel Web Server Extension. For instance:
http://www.mycompany.com/siebel/eService/ start.swe?SWEView=ISS+Service+Request+View
Matches repository definition of applet with Siebel web template file (.SWT) for layout Returns HTML
Siebel Object Manager Reads and/or writes data Instantiates BO, Views, and applets
User Clicks
Web Server
Siebel Web Engine Get or create state information Get or create object manager session Parse request to pass to object manager
14-5
3 The Siebel Web Engine matches the virtual directory specified in the URL. It does this in one of two ways:
In the above example, eapps.cfg, the configuration file, is located in the virtual directory sweapp/bin. On UNIX, it uses the file swe.conf. The file swe.conf is referenced from Netscape Server configuration file obj.conf. The Siebel installer will add the reference to obj.conf. For example, heres a typical line added to obj.conf:
Init fn="swe-init" config-file="/usr/netscape/suitespot/ https-test/config/swe.conf"
4 The Siebel Web Engine reads the eapps.cfg file to find out:
Which Gateway Server to direct the request to, and at which port The name of the Application Object Manager server (in case Resonate Central Dispatch is not being used)
5 The Web server directs the request through the Gateway Server to an available Siebel Web Engine and Application Object Manager server. 6 Application Object Manager determines the configuration file corresponding to the particular service (as set in the Configuration File component parameter for this Object Manager service).
For example, the Configuration File parameter might be set to esales.cfg.
7 Application Object Manager reads the configuration file (located in the Siebel Servers \bin directory) to find out the application name and the name of the .srf file.
For example, one of the parameters in the configuration file may identify the application name as Siebel eSalesThin and the .srf file as siebel.srf.
14-6
8 The ApplicationName parameter tells Application Object Manager which application definition (from the .srf file in the \objects directory) to use for retrieving data. 9 The Siebel Web Engine retrieves data from the database and the repository definition of the views and applets through the Application Object Manager. 10 From the request, the Siebel Web Engine determines which .swt file to use. It will then parse the .swt file for the Siebel tags. 11 The Siebel Web Engine generates the HTML file based on the .swt file, the Siebel data, and the repository definition of the views and applets, and sends it back to the Web server. 12 The Web server receives the generated HTML file from the Siebel Web Engine and passes it back to the browser.
For instructions on configuring your servers and application to enable this flow of events, see Chapter 15, Preparing to Install Siebel .COM Applications on Windows NT Server and UNIX Systems, Configuring Siebel .COM Applications, and the Siebel Server Installation Guide.
14-7
14
For Information About Installing the .COM applications, which are supported by Siebel HTML Thin Client technology How Siebel HTML Thin Client components interact with Siebel Servers Using Siebel Tools to configure applications Siebel eService, eSales, and eChannel, which are part of the Siebel .COM Applications and based on Siebel HTML Thin Client technology Customizing your Siebel .COM Applications using Siebel HTML Thin Client technology
Siebel Server Administration Guide Siebel Tools Guide Siebel .COM Applications Guide
For copies of these documents, contact Siebel Books Online, on the Siebel Systems Web site (www.siebel.com).
14-8
Preparing to Install Siebel .COM Applications on Windows NT Server and UNIX Systems
15
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2 Pre-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2 Verifying Thin Client Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2 Planning the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-3 . . . . . . . . . . . . . . . . . . . . . . 15-5 Verifying the Siebel Enterprise Server
Verifying Web Server Requirements . . . . . . . . . . . . . . . . . . . . . . . . 15-5 Installing Siebel .COM Applications Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . 15-6
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-6
15-1
Preparing to Install Siebel .COM Applications on Windows NT Server and UNIX Systems
About This Chapter
15
This chapter describes the pre-installation tasks for Siebel .COM Applications under Windows NT and UNIX. The installation steps are documented in the Siebel Server Installation Guide. The Web Engine is installed as part of the Siebel Server installation, and the Siebel .COM Applications are installed on the same machine as the Web Server host to support Siebel HTML Thin Client technology. As with Siebel Thin Client for Windows and Siebel Java Thin Client, the .COM applications connect to the Application Object Manager, in this case executing the Siebel Web Engine.
Pre-Installation Tasks
You must complete the following pre-installation tasks before you begin installing Siebel .COM Applications: Verifying Thin Client Platforms Planning the Installation on page 15-3 Verifying the Siebel Enterprise Server on page 15-5 Verifying Web Server Requirements on page 15-5
15
15-2
15
Network connectivity to the Siebel Enterprise Server using one of the supported network protocols and configurations specified in the Siebel Release Notes.
Preparing to Install Siebel .COM Applications on Windows NT Server and UNIX Systems
Pre-Installation Tasks
15
Siebel Web Engine is one of several software components that are installed to support Siebel HTML Thin Client technology and the .COM applications. The Siebel Web Engine is automatically installed along with the Siebel Server. Siebel HTML Thin Client technology also requires a Web server (Netscape for Solaris installations and Microsoft IIS for Windows NT installations). Before beginning the installation process, consider how you will distribute these software components. There are two possible deployment topologies: Single-node, in which all components are operated on a single server Distributed, in which the components are distributed across multiple application servers
Each clients browser (in which the Web application appears at run time) would be installed on a separate node, such as on each users laptop or other personal computer.
Single-Node Installation
In a single-node installation, recommended only for development and testing purposes, all the server-side components are installed on one machine (or node). These are: The Web server (Microsoft IIS for Windows NT installations and Netscape for Solaris installations) Application Object Manager and Siebel Web Engine
Distributed Installation
The recommended production deployment topology is to distribute the HTML Thin Client components among two or more machines. The recommended distributed configuration has each component (Web server and Application Object Manager) on a separate machine.
NOTE: In both the single-node and distributed configurations, the database server
15-3
Preparing to Install Siebel .COM Applications on Windows NT Server and UNIX Systems
Pre-Installation Tasks
15-4
having the Application Object Manager and Siebel Web Engine on another machine reduces contention for CPU and other resources. However, to take advantage of the performance improvement, you must have a high-speed network connection between the two machines.
Load balancing. A single Web server can distribute the load of multiple user requests among multiple installations of Application Object Manager, using the connection-brokering capabilities of Siebel Gateway Server. Higher fault tolerance. Balancing the load across multiple machines reduces the chance of system failure and downtime, particularly if you have multiple installations of Application Object Manager. Greater flexibility with firewalls. Installing the Web server on a different machine
from the Application Object Manager enables you to deploy your Web server outside the firewall while keeping Application Object Manager behind the firewall.
Because of these advantages, a multi-node configuration is strongly recommended for deployments that support large numbers of concurrent users or where high availability is an operating requirement.
Preparing to Install Siebel .COM Applications on Windows NT Server and UNIX Systems
Pre-Installation Tasks
15
Before installing the Siebel .COM Applications, you must have completed the installation of the Siebel Database Server and Siebel File System, and have installed and configured an Enterprise Server containing the Gateway Server and at least one Siebel Server. Complete the steps in your Siebel Server Installation Guide to install and configure the Enterprise Server entities, following the configuration chosen in the previous pre-installation task, Planning the Installation on page 15-3.
NOTE: It is strongly recommended that you implement the connection-brokering capabilities of the Siebel Gateway Server if you will support the thin client software from multiple Siebel Servers. These capabilities help to provide high scalability and availability for your thin client users. Refer to your Siebel Server Installation Guide for more information on connection brokering.
If you or someone else filled out the Deployment Planning Worksheet (in the Siebel Server Installation Guide) before installing your Siebel servers, make a copy and keep it with you while installing the thin client components. Otherwise, make a note of the Siebel Enterprise Server name and the IP address (or VIP if you are using Central Dispatch) of the Gateway Server, as well as the name of the Object Managerdefined components operating on the Enterprise Server. You will need this information when configuring the client start-up files.
15
Ensure that the application server that will support the Siebel Web Engine meets all the Siebel Server hardware and software platform requirements documented in the Siebel Release Notes. You must also install and configure a Web server for your platform: For Windows NT servers, install Microsoft IIS on the application server. Follow the documentation provided by Microsoft to complete this task. For UNIX servers, install and configure Netscape Enterprise Server on the application server. Follow the documentation provided by Netscape to complete this step.
15-5
Preparing to Install Siebel .COM Applications on Windows NT Server and UNIX Systems
Installing Siebel .COM Applications
15
In the version 6.0 release of Siebel Server, Siebel Web Engine supports Windows NT Web servers running Microsoft Internet Information Server (IIS) and Sun Solaris (UNIX) Web servers running Netscape Enterprise Server.
NOTE: There is no client component installation for Siebel .COM Applications. The only software that must be installed on each client machine are a Web browser and network connectivity software. All the Siebel components for the HTML Thin Client technology and Siebel .COM Applications are stored on the server.
Because the HTML Thin Client components are part of the Siebel Server installation and the Siebel .COM Applications installation (both server installations), the installation steps are documented in the Siebel Server Installation Guide.
Configuration Files
The information supplied during the .COM application installation is written to a configuration file, eapps.cfg, that supports the Siebel .COM Applications.
15
If you move one of the server-side components to another machine, you must edit the eapps.cfg file with the new information. In addition, you can edit the configuration file to change .COM application-specific preferences, such as timeout interval, logging level, and so on. See the Siebel Server Installation Guide for information about editing the parameters contained in the eapps.cfg installed with the .COM Applications.
15-6
16
About This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2 Firewall Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-3 Browser to Web Server Connection . . . . . . . . . . . . . . . . . . . . . . . . 16-4 Web Server Extension to Application Object Manager Connection . . . 16-4 Firewall Requirements in a Load-Balanced Environment . . . . . . . . . . . . 16-5 Firewall Requirements in a Non-Load-Balanced Environment . . . . . . . . 16-6
16-1
16
16-2
Firewall Configuration
16
Figure 16-1 shows one possible network configuration for deploying Siebel HTML Thin Client. Your actual configuration will vary depending on the firewall hardware or software and security standards of your organization; however, the requirements outlined here apply across all configurations and should be used as the guidelines for your environment.
External firewall
Internal firewall
TCP/IP port Siebel application definition (.srf) Siebel Web Engine Siebel Object Manager
Templates
Database
16-3
In an HTML Thin Client deployment, there are two distinct network connections: the Web browser connection to the Web server and the Siebel Web Server Extension connection to the Siebel Application Object Manager component running on the Siebel Enterprise Server. These connections have unique requirements, particularly for firewall configuration. Each is discussed in turn.
16
The Web browser uses a standard HTTP or SSL connection to the Web server. Typically this connection requires only that the firewall be able to pass HTTP or SSL traffic to a single port on the Web server. These requirements are determined entirely by the configuration of your browsers and Web server; refer to the documentation provided by the product vendors for more information on supported firewall configurations in these environments. Usually these connections can be supported over VPNs, through firewalls that perform network address translation, through multiplexing proxies, and so on.
NOTE: The use of SSL does impose some overhead that can degrade performance. For that reason, Siebel Systems recommends its use only in those portions of your application configuration where network security is critical, such as transfers involving login information.
16
The Siebel Web Server Extension, operating on the Web server, connects to the Application Object Manager component operating within the Siebel Enterprise Server. This connection uses Siebel's application protocol, which is compressed by default and can also be encrypted when both components are deployed on Windows NT. The supported configurations for a firewall between the Web server and Siebel Enterprise Server vary depending on whether you are using dynamic load balancing in the Enterprise Server.
16-4
16
If you are using Resonate Central Dispatch to dynamically load-balance connections across the Enterprise Server, you need to expose only a single port through the firewall. The Web Server Extension uses this port to connect to the Siebel Gateway Server, which in turn passes the connection to the Application Object Manager. In the load-balanced environment, the Application Object Manager can be configured to support connections over TCP/IP and tunneled HTTP. If you are using TCP/IP, you must expose the TCP port of the Gateway Server (the default is 2320) through the firewall. If you are using HTTP, you need to expose only a generic HTTP port (the default is 80). If you are using load balancing, both HTTP and TCP/IP connections to the Application Object Manager support firewalls that perform network address translation. However, neither can be used with a firewall that has a multiplexing application proxy. While the use of HTTP does create some overhead and can degrade response times, you may prefer it for firewall configurations requiring packet filtering or other stringent security measures. The Application Object Manager communications protocol is set as part of the definition of each Application Object Manager-defined component. As multiple defined components can operate in the Enterprise Server, it is possible to use a mix of HTTP and TCP/IP communications in your deployment; however, each Application Object Manager can use only a single protocol, and each Web Server Extension can only connect to one defined component. See the Siebel Server Administration Guide for instructions on configuring the communication protocol for the Application Object Manager.
NOTE: See the Siebel Server Installation Guide for information about modifying the
16-5
16
The firewall requirements are slightly different if you do not use load balancing in your Enterprise Server. The Object Manager connection can only use TCP/IP in this environment. In addition to the Gateway Server TCP port (the default is 2320), the TCP port on which each Object Manager listens must also be exposed through the firewall. The Object Manager port is determined by the Object Manager configuration and can be allocated dynamically or statically. To minimize the number of ports that must be opened through the firewall, it is recommended that you use static port allocation and create as small a number of Object Managerdefined components as possible.
NOTE: In the non-load-balanced environment, the Object Manager connection does not support network address translation, and does not support firewalls with multiplexing proxy servers.
16-6
Troubleshooting
17
General Troubleshooting Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2 Windows NT Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2 Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2 Object Manager Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2 Using a Single .srf and .cfg File for Troubleshooting . . . . . . . . . . . . 17-3 Visual Basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-3 Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-3 Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-4
17-1
Troubleshooting
General Troubleshooting Tips
17
This section provides suggestions for troubleshooting problems you may encounter.
17
Stopping and restarting the following Windows NT services solves some problems:
Configuration Files
For information, see the Application Object Manager chapter of the Siebel Server Administration Guide.
17-2
17
If youve moved any components of your installation, including the Application Object Manager or the Gateway Server, you must make the appropriate changes in the configuration files. For details about the Siebel .COM Applications .cfg files, see the Siebel Server Installation Guide.
17
You may need to reset some Application Object Manager parameters. These include:
Troubleshooting
General Troubleshooting Tips
17
If youre having problems with your HTML-based application, try running this application through the Siebel dedicated client. That is, set up your Siebel dedicated client to use the same .srf file and the same Application Object Manager configuration file (such as Siebel.cfg) as used by the HTML Thin Client application. For instance, you could create a shortcut that calls an instance of the dedicated client, but with the flag /c c:\SiebelServer\bin\ThinClient.cfg, where the string after the flag is the name and location of the .cfg file that the thin client is using. The shortcut will start a dedicated client using the same parameters and repository as the thin client. You should be able to see the same set of records through the dedicated client and through HTML Thin Client. If you are unsure about a certain behavior you are seeing in HTML Thin Client, try using the dedicated client to perform a similar operation, using the same .srf and .cfg file, and the same user name and password. For example, if a query or picklist does not have the expected result, try the same operation with the dedicated client.
Visual Basic
If your application uses VB scripts and an error occurs, you can tell whether the error is caused by VB by turning off VB. Specifically, on the SOM, edit the configuration file (such as Siebel.cfg) to set EnableBASIC to FALSE.
17
Log Files
17
When a problem occurs, check the various available log files to discover the cause. For more information, see the following section, Log Files on page 17-4.
17-3
Troubleshooting
Log Files
Log Files
For each Internet application, Siebel Web Engine generates one or more log files. Depending on the logging level you choose, these files log errors, warnings, and general information. Analyzing the log files can provide clues as to how you can improve the performance of your application. In addition, Siebel Web Engine itself creates log files. See the Siebel Server Installation Guide for more information about the log files that are created during the Siebel Web Engine and .COM applications installations.
17
17-4
Appendices
Part 5
Appendix A. Index of Configuration Parameters Appendix B. Siebel.cfg Configuration Parameters Appendix C. Limiting Views to the Thin or Dedicated Client Appendix D. Optimizing Thin Client Performance Appendix E. UNIX-Supported Business Component Classes
A-1
Appendix Overview
This appendix lists configuration parameters in alphabetical order, with crossreferences to the page that documents each one and the configuration file in which it can be found. The list contains dedicated client, mobile client, and thin client configuration parameters.
NOTE: This appendix does not document the parameters. It provides a crossreference to the location in this guide where you can find the documentation for each parameter.
Table A-1.
(Sheet 1 of 7)
Documented on Page B-3 Siebel Server Installation Guide Siebel Server Installation Guide Siebel Server Installation Guide B-3 B-3
A-2
Table A-1.
(Sheet 2 of 7)
Configuration Parameter Name ApplicationSplashText BaseDN Browser CaptionPrefix CaseInsensitive ClientFileServSupport ClientRootDir Colors ComponentName ConfiguratorDLLName ConfiguratorExeDir ConfiguratorExeFileName ConfiguratorModelDir ConfiguratorModelExportFileName ConnectString ContactLogin CorbaDLL CorrespODBCDataSource CredentialsAttributeType DataMart DataSource DateYearFormat DecimalNumberScale DefaultChartFont
Documented on Page B-3 B-21 10-9 B-3 B-8 B-3 5-9, B-3 10-10 B-3 B-16 B-16 B-16 B-16 B-16 B-8 B-8 B-3 B-3 B-21 B-7 10-8, B-3 10-8, 10-11 10-8 B-3
A-3
Table A-1.
(Sheet 3 of 7)
Configuration Parameter Name DefaultFont Dir DLL DllName DockConnString Docked DockRecvTxnsPerCommit DockRepositoryName DockTxnsPerCommit Enable EnableCORBA EnablePersonalization EnableOLEAutomation EnableScripting EncryptCredentialsPassword EncryptPassword EnterpriseServer ExtensionType FileSystem Finish Gateway GatewayAddress GatewayServer
Documented on Page 10-10 B-17 (DataCleansing), B-18 (Data DeDuplication) B-8 B-21 5-9, B-8 B-8 B-8 5-10, B-3 5-11, B-8 B-17 (DataCleansing), B-18 (Data DeDuplication) B-4 B-4 B-4 B-4 B-21 B-4 B-9 B-9 5-11, B-4 9-14 B-7 B-9 Siebel Server Installation Guide
A-4
Table A-1.
(Sheet 4 of 7)
Configuration Parameter Name Height HelpFile Hidden HideBackground HoldExportODBCConnection html InsensitivityFactor InsUpdAllCols IntegratedSecurity InternalConnectString JSECorbaConnector JTCHelpURL Lang LargeDataFont LargeFont LDAP Local LocalDbODBCDataSource Login MainRepositoryName MaxCachedCursors MaxCachedDataSets MaxConnections MaxCursorSize
Documented on Page Siebel Server Installation Guide B-4 B-9 9-12 B-4 10-9 B-9 B-9 B-10 B-10 B-5 B-5 Siebel Server Installation Guide B-5 B-5 B-20 B-7 B-5 Siebel Server Installation Guide B-5 B-10 B-10 B-10 B-10
A-5
Table A-1.
(Sheet 5 of 7)
Configuration Parameter Name MultiCurrency NavBarItemFont NavBarSelectFont NavBarTitleFont NetworkPacketSize NoExtension NonSQL ObjectManager OLEAutomationDLL OLEMessagePendingDelay PasswordAttributeType PersonalizationLog Placeholder Port PrefetchSize PrimaryEnterprise ReportsDir ReportsODBCDataSource RepositoryFile RequestComponent RequestServer ReverseFillThreshold RolesAttributeType RootDirectory
Documented on Page B-5 B-5 B-6 B-6 B-10 10-10 B-10 Siebel Server Installation Guide B-6 B-6 B-21 B-6 B-10 B-21 B-10 B-10 B-6 B-6 B-6 B-11 B-11 B-11 B-22 9-14
A-6
Table A-1.
(Sheet 6 of 7)
Configuration Parameter Name Sample SAPIdocAllowedObjects SAPRfcConnectString SAPRfcDestEntry SAPRfcPassword SAPRfcUserName ScriptingDLL SearchCheckStatus SearchCharacterSet SearchConnectString SearchDefName SearchDisableViewer SearchStyle SearchTermGenerator SearchThesaurus SecurityAdapter Server ServerName SharedModeUsersDir ShowMessageBar SiebelEnterprise SiebelServer SmallDataFont SmallFont
Documented on Page B-7 B-19 B-19 B-19 B-19 B-19 B-6 B-11 B-11 B-11 B-11 B-11 B-11 B-11 B-11 B-11 B-7, B-11 B-22 B-6 B-6 Siebel Server Installation Guide Siebel Server Installation Guide B-6 B-7
A-7
Table A-1.
(Sheet 7 of 7)
Configuration Parameter Name SqlStyle SslDatabase StatsPage SupportsIntegratedAuthentication TableOwner TempDir Type UpperCaseLogin UsernameAttributeType Version View1 View2 Welcome Width
Documented on Page B-12 B-22 Siebel Server Installation Guide B-22 5-10, B-12 B-7 B-17 (DataCleansing), B-18 (Data DeDuplication) B-12 B-22 B-7 B-15 B-15 9-13 Siebel Server Installation Guide
A-8
Generic Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2 Client and Server Application Parameters . . . . . . . . . . . . . . . . . . . . . . . . . B-3 Datasources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-7 Properties of DataSources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-8 Actuate Reports Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-15 Preload Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-15 Product Configurator Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . B-16 DataCleansing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-17 DeDuplication Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-18 SAP Subsystem Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-19 Security Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-20 LDAP Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-21 Internet Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-24
B-1
B-2
(Sheet 1 of 5)
Directory where Microsoft Access is installed. Font to use in the applet title. The font settings are for the user interface. AppletTitleFont controls the font for the title control for applets. Name of application object in repository to use (Siebel Sales, Siebel Service, and so on). The ApplicationName setting determines which splash screen appears and which set of menus is enabled. Text that appears on the application splash screen when starting up a Siebel application. The default varies by the application. If you are starting Siebel Sales, for example, the ApplicationSplashText is set to Siebel Sales by default.
ApplicationSplashText
Allows customizing of the title in the upper left hand corner of the Siebel client application. Reads Siebel by default. TRUE or FALSE. Directory where client software is installed. This parameter specifies the Siebel Anywhere configuration that should be used during version check. Navigate to the Siebel Anywhere Configurations view to see the configurations. Administration Change the setting for this parameter if you want this .cfg file to be version checked by a specific Siebel Anywhere configuration. For example, if you want to version check the office in one city separately from the office in another city, create two Siebel Anywhere configurations appropriately named, then in the .cfg file for each set of users, enter a different value for the ComponentName entry.
The Siebel extension language for CORBA. Name of ODBC data source used by mail merges and correspondence. Name of default data source as defined in the .cfg file. Font name specification for chart applets. Defaults to Arial-10 normal. Obsolete.
B-3
Table B-1.
Name
(Sheet 2 of 5)
EnableCORBA
EnableCORBA is used to load CORBADLL. For all installations except CORBA Object Manager, this flag is FALSE by default. When using a configuration file with one of the CORBA Object Manager executables, ssomorbx.exe or ssomvisi.exe, the CORBA Object Manager installer sets the EnableCORBA parameter to TRUE.
TRUE or FALSE. Enables OLE interfaces. Must be set to TRUE to activate the personalization (content targeting) functionality. TRUE or FALSE. Enables use of Siebel Visual Basic or Siebel eScript. Determines whether to encrypt users password before passing it the RDBMS. Used by customers who do not want their users to directly log into the server database using SQL*Plus or some other RDBMS tool other than Siebel. When enabled, Siebel applies a simple encryption algorithm to the password before it is sent to the database. This occurs when users attempt to login to Siebel with their password. The users Oracle login would also have to have been setup with the encrypted version of the password. Siebel has a special utility to help the administrator set these up. Where the Siebel File Server resides. Help file for the current configuration. This option applies to Access reports and Correspondence only. It does not apply to Actuate reports which use OLE to retrieve data. TRUE or FALSE. This parameter tells Siebel to disconnect from, or to keep the connection with, the Microsoft ODBC data source after Siebel has exported data into a staging database during a report generation or correspondence mail merge. Siebel engineers have found that keeping the connection is more stable than not. If the option is turned off, then the ODBC jet engine driver (ODBCJT32.DLL) from Microsoft will consistently crash on the second disconnect attempt.
B-4
Table B-1.
Name
(Sheet 3 of 5)
JSECorbaConnector
Required for eScript CORBA support (if you are using Siebel eScript and calling CORBA from eScript). Defines the name of the eScript CORBA extension DLL. Change this setting, depending on the CORBA ORBs (Object Request Broker) that you are using: Use corbavgn.dll for Inprise Visibroker Use corborbx.dll for Iona ORBIX
JTCHelpURL
MainRepositoryName
Repository this configuration should run against. MainRepositoryName is different from the RepositoryFile parameter. RepositoryFile is the physical file that is read that contains all runtime object definitions, while MainRepositoryName is used in cases where some part of the code must connect to the database to obtain information from the repository.
MultiCurrency NavBarltemFont
TRUE or FALSE. Enables multi-currency support. The NavBar settings affect the Page Tabs and the Viewbar areas. Font to use for the Navigation Bar text.
The default setting for this parameter is corbavgn.dll. Note that the ScriptingDLL parameter must be set to sscfjs.dll to select Siebel eScript as the scripting language. By default, the ScriptingDLL parameter is set to Visual Basic. A server parameter that defines the location of the online help for Java Thin Client provided by Siebel Systems. Set this parameter to the location where the help file was copied from the CD-ROM. When Java Thin Client users press the F1 key, Siebel launches the help file. The [File Extension] section of the client siebel.cfg file determines the browser with which the help file is launched. Font to use when Siebel calls for large font. Use in the list applets when Siebel calls for a large font. Name of the ODBC datasource that is set up to access the local database. It is used by a variety of features in the Siebel eBusiness Applications and in Siebel Tools. It should not need to be modified as it is correctly configured by the installation program.
B-5
Table B-1.
Name
(Sheet 4 of 5)
Font to use when a Navigation Bar item is selected. Font to use for titles in the Navigation Bar (View bars title area). Name of .DLL that implements OLE interfaces. Controls the amount of time that Siebel will wait for an OLE server to respond to a request before a "Server not responding ..." timeout message appears. The default setting is 8 seconds. The most common use is to increase the timeout on slow computers so that the timeout message does not appear as frequently.
PersonalizationLog
Add PersonalizationLog= "c:\personalization.txt" to siebel.cfg to view a log of all personalization activity, where c is the drive letter where you want to store the log. The log may assist in the process of debugging your rules, events, and actions. Directory where reports are installed. Typically left blank. Name of ODBC data source used by Access reports. Name of the Siebel.SRF file to use. RepositoryFile is different from the MainRepositoryName parameter. RepositoryFile is the physical file that is read that contains all runtime object definitions, while MainRepositoryName is used in cases where some part of the code must connect to the database to obtain information from the repository.
ScriptingDLL
Name of the shared library that implements Siebel Visual Basic or Siebel eScript. If you are running a Unix server (AIX or Solaris) and plan on using eScript, set the value of ScriptingDLL to sscfjs.so. Directory where user preference files are stored. Typically left blank. If setting SharedModeUsersDir, it must be set to a directory under a network shared drive, but it cannot be set to the shared drive itself. For example, if \\yourserver\common is the network shared drive, you cannot set SharedModeUsersDir to \\yourserver\common. Instead, set SharedModeUsersDir to a directory under \common.
SharedModeUsersDir
ShowMessageBar SmallDataFont
TRUE by default. This client parameter should be set to FALSE to remove the message box at the bottom of the Siebel application window. Use in the list applets when Siebel calls for a small font.
B-6
Table B-1.
Name SmallFont TempDir Version
(Sheet 5 of 5)
Font to use when Siebel calls for a small font. Directory where temporary files should be created. Represents version of file. This parameter is for internal use only and is automatically maintained by Siebel Anywhere. When the customer creates an upgrade kit for the .cfg file, Siebel Anywhere increments this version string appropriately, based on the version information from the Upgrade Components screen.Note that when you perform a Siebel Anywhere upgrade, you must manually upgrade files from the upgraded Siebel client directory to the Siebel server directory.
Datasources
Table B-2 lists DataSources in the Siebel Configuration file.
Table B-2.
Name Local Sample Server Gateway DataMart
DataSources
Function Defines local database name Defines sample database name Defines Server database name Defines Gateway Defines the DataMart database name
B-7
Properties of DataSources
Table B-3 lists the properties associated with the different DataSources. The previous table, Table B-2 on page B-7, defines defines each DataSource name. Each DataSource must have its own section that defines the properties of the DataSource. Sample DataSource sections are shown in Sample DataSource Sections in the Siebel.cfg File on page B-12.
Table B-3.
Name CaseInsensitive
Properties of DataSources
Comment
(Sheet 1 of 5)
TRUE or FALSE. If TRUE, notifies the client to work with the database in caseinsensitive mode. Note that queries against fields of type DTYPE_ID are always case-sensitive, even if the CaseInsensitive parameter is set to TRUE.
ConnectString
Database-dependent string that defines how to connect to the database. The -Q option hides the SQL Anywhere icon. The -c8 option indicates the cache size and the -m option indicates to the SQL Anywhere database engine to truncate the transaction log after each checkpoint. TRUE or FALSE. If TRUE, indicates that the corresponding datasource uses contact login, rather than employee login. Because a contact user is generally not associated one-to-one with a database account, you must use a security adapter to support contact users. If FALSE, the datasource is using employee login, rather than contact login.
ContactLogin
DLL DockConnString
Name of .DLL file to use for the database connector code. They differ depending upon whether you are using Oracle, SQL Server, Sybase, and so on. ODBC source to the docking server. The DockConnString in the [local] section contains the machine name of the Enterprise Server, and is not an ODBC data source. TRUE or FALSE. Designates whether database is mobile or connected to server. Number of transactions received by the mobile client before a commit is issued to the database. The default value for this parameter is 10. Change the setting to: A higher value if you have a fast network connection, such as a LAN. Increasing the value can provide better performance when synchronizing the mobile client with the server. A small value if you have a lower bandwidth network connection, such as a modem.
Docked DockRecvTxnsPerCommit
DockTxnsPerCommit
B-8
Table B-3.
Name
Properties of DataSources
Comment
(Sheet 2 of 5)
Name of the Siebel Enterprise Server. TRUE or FALSE. Determines if the data source shows up in the login dialogs picklist of data sources to which to connect. Name of the Siebel Gateway Server. TRUE or FALSE. Determines if the data source shows up in the Siebel login dialogs picklist of data sources. Set to a positive integer value (default is 2). Only applies when the datasources CaseInsensitivity setting is TRUE. The value controls the number of characters in each string that will be treated as case-insensitive in a query. Not all database vendors support case-insensitivity efficiently, so this feature provides an approximate solution. Below is an example of the SQL WHERE clause generated when searching for an Opportunity named New when the InsensitivityFactor is set to 2. WHERE ((S_OPTY.NAME LIKE ne% OR S_OPTY.NAME LIKE Ne%OR S_OPTY.NAME LIKE nE%OR S_OPTY.NAME LIKE NE%) AND UPPER(S_OPTY.NAME)=UPPER(New)) The above example shows that all permutations of the first 2 letters of the string New are checked. With a higher factor, the number of permutations grows exponentially, and performance will suffer.
InsUpdAllCols
TRUE or FALSE. Ordinarily when Siebel generates INSERT or UPDATE statements to send to the database, the actual statement only contains the columns where data is present or has changed. When there are situations where we generate many statements on a particular table, the differences in the values being updated may cause us to not be able to use an array interface supported by the DBMS. When this feature is on (set to TRUE) all columns are present in all INSERT and UPDATE statements. This automatically enables 2 statements issued against the same table in the same business component as part of a batch operation to be able to use any existing array feature of the DBMS.
B-9
Table B-3.
Name
Properties of DataSources
Comment
(Sheet 3 of 5)
IntegratedSecurity
TRUE or FALSE. Turns on the model where the user does not have to enter a database username and password: the operating system will authenticate the user instead. This is the property of a particular DataSource, although it is only supported for Oracle and MS SQL Server data sources. Can be set to TRUE or FALSE. Defaults to FALSE. If TRUE, it causes the Siebel client software to not prompt the user for a username/password. Instead, it uses the database servers own authentication facilities to determine if that user should be allowed to login to the database. For Oracle, refer to the OPS$ and REMOTE_OS_AUTHENT features. For MS SQL Server, refer to Integrated Security. No information. Only applicable to MS SQL Server: Maximum number of cursors that will be allowed to be connected to the database at single time. Denotes how many data sets will be held in memory, that is for List of Values or anything that has the Cache Data property available (BusComps). Number of connections you can make to the Server. MaxCursorSize:Sets the total number of rows that can be returned in a result set. While the value of MaxCursorSize affects every database, it is used only for IBM DB2/390. The size of the packet sent across the network. A datasource property for Sybase databases. Allows the TDS network packet size to be changed from the default of 512 bytes. TRUE or FALSE. Setting that indicates that the data source does not use an SQL DBMS to retrieve its data. This would only be used in conjunction with a specialized business component that we would build internally and would never be arbitrarily set by a customer. Used for internal testing purposes only. Number of records that the Siebel application will read up front as part of a query execution. This parameter is only intended to be used in conjunction with the MaxCursorSize parameter and must be set to the same value. If these two values are set, during the execution phase, the Siebel application will read that many records and will close the database cursor. While the value of PrefetchSize affects every database, it is used only for IBM DB2/390. The name of the Enterprise Server you want to administer from the client machine. The PrimaryEnterprise parameter must be set to view or change information in the Server Administration Screens.
NetworkPacketSize
NonSQL
Placeholder PrefetchSize
PrimaryEnterprise
B-10
Table B-3.
Name
Properties of DataSources
Comment
(Sheet 4 of 5)
Name of the server component to which the Siebel client should connect. This should be set to BusIntMgr. If not using load balancing, this is the name of the physical Siebel Server that should service requests from this Siebel client. When current query contains many rows it may be very inefficient to read sequentially through all of them if the user hits the End button. For this reason, we allow the customer to configure a threshold value where we will invert the current sort, re-execute the query, and fill our data buffers from the end. This is hidden from the user. No information. No information. How to connect to the search engine, such as Fulcrum. No information. TRUE or FALSE. If TRUE, the viewer window is not displayed. This was intended for JPN version of Siebel 3.x where double-byte characters were not supported in the Fulcrum viewer. No information. No information. No information. Optional. Set to LDAP in a datasource section to specify the Siebel-provided security adapter. This line must be included for each datasource for which you want to use a security adapter. If you dont set SecurityAdapter to anything, this indicates that youre using the database for authentication. The value to which you set SecurityAdapter: Indicates the security adapter youre using for authentication. If youre not using the Siebel-provided security adapter, SecurityAdapter will be set to a value other than LDAP. Must be a valid value specified in the Security Adapters section, described in Security Adapters on page B-20.
See also LDAP Parameters on page B-21 for a description of other security adapter parameters. Server Begin parameters for connecting to the Server database.
B-11
Table B-3.
Name SqlStyle
Properties of DataSources
Comment
(Sheet 5 of 5)
When generating SQL to send to a DBMS, there are times when you will need to construct the statement differently depending on the DBMS you are talking with. SqlStyle is the parameter that tells us what database we are talking with. In a database, tables are identified by both their owner and their name. When queries that reference tables are issued (all Siebel queries) the table owner must be included in those references (for example, SIEBEL.S_EVT_ACT where SIEBEL is the tableowner. The default is FALSE. If set to TRUE the login name of the user is converted to uppercase before its sent to the database for authentication. This value is applicable only if the database is used for authentication; the value of the parameter is ignored when SecurityAdapter is set to a non-empty value. Use this parameter if you wish to enforce a policy of having all database accounts in uppercase on a case-sensitive database, but you dont want users to worry about case when they type in their username. Note that the value of UpperCaseLogin does not affect the password.
TableOwner
UpperCaseLogin
B-12
In addition, there is a separate parameter list for each datasource named in the DataSources section. The following example shows a sample list of parameters and values for the Local datasource:
[Local] Docked ConnectString TableOwner DockedDBFilename DLL SqlStyle MaxCachedCursors MaxCachedDataSets ReverseFillThreshold CaseInsensitive InsensitivityFactor DockTxnsPerCommit DockRecvTxnsPerCommit DockConnString SearchStyle SearchConnectString SearchDefName = FALSE = E:\2822\sea\local\sse_data.dbf -Q -m = SIEBEL = laptopusers = SSCDW55.DLL = Oracle = 16 = 16 = 100 = FALSE = 2 = 500 = 10 = entsrvr = Fulcrum = Fulcrum = Fulcrum Sample
B-13
The following example shows a sample list of parameters and values for the Server datasource:
[Server] Docked ConnectString TableOwner DLL SqlStyle MaxCachedCursors MaxCachedDataSets ReverseFillThreshold CaseInsensitive InsensitivityFactor FileSystem SearchStyle SearchConnectString SearchDefName GatewayAddress EnterpriseServer RequestComponent RequestServer SecurityAdapter ContactLogin = TRUE = siebeldb = siebel = sscdo80.dll = Oracle = 16 = 16 = 100 = FALSE = 2 = \\ntsrv1\siebfile = Fulcrum = CHANGE_ME = Fulcrum Sample = siebgateway = siebel = SRMSynch = siebrequest = LDAP = FALSE
B-14
Preload Parameters
Table B-5 defines preload parameters.
Table B-5.
Name [Preload]
Preload Parameters
Description Specifies view(s) to load during startup of the application so that upon accessing the view for the first time the information is cached and appears more quickly. Name of the first view to be preloaded at startup. Name of the second view to be loaded at startup. Name of the nth view to be loaded at startup.
B-15
ConfiguratorModelExportFileName
B-16
DataCleansing Parameters
Table B-7 defines the parameters in the [DataCleansing] section of the client .cfg file.
NOTE: Data cleansing is not available for Siebel thin clients.
Table B-7.
Name Enable
DataCleansing Parameters
Description Set this optional parameter to TRUE to turn on data cleansing on a client. Set to FALSE to disable data cleansing. The following are required to use the data cleansing feature: Data Quality license key Firstlogic software installed
Type Dir
Do not change the value from IdCentric. Set to the local directory where the Firstlogic executable (not Postal Dictionary) files reside. The Siebel dedicated client installation program may set this automatically if you installed Firstlogic prior to installing the Siebel client, but only if the Siebel installer detects the presence of Firstlogic, which depends on your system configuration.
B-17
DeDuplication Parameters
Table B-8 defines the parameters in the [DeDuplication] section of the client .cfg file.
NOTE: Data deduplication is not available for Siebel thin clients.
Table B-8.
Name Enable
DeDuplication Parameters
Description Set this optional parameter to TRUE to turn on data deduplication on a client. Set to FALSE to disable data deduplication. The following are required to use the data deduplication feature: Data Quality license key Firstlogic software installed
Type Dir
Do not change the value from IdCentric. Set to the local directory where the Firstlogic executable (not Postal Dictionary) files reside. The Siebel dedicated client installation program may set this automatically if you installed Firstlogic prior to installing the Siebel client, but only if the Siebel installer detects the presence of Firstlogic, which depends on your system configuration.
B-18
SAPSubsys Parameters
Definition This optional parameter specifies allowed integration objects for incoming IDOCs. Change this value to receive IDOCs corresponding to integration objects that are different from the default. The default value is: Product - Receive SAP Material (IDOC Input), Account - Receive SAP Customer (IDOC Input)
SAPRfcConnectString
This optional parameter defines the connect string for SAP name-value pairs, IDOC outbound and BAPI adapter. Change the values to connect to the appropriate SAP client and program ID if your application sends IDOCs or makes BAPI requests. An example SAPRfcConnectString is DEST=dest CLINET= 100 LANG=E
SAPRfcDestEntry
This optional parameter defines the destination entry of type R in the saprfc.ini file (IDOC inbound). Change the value to listen on an RFC program ID to which you want to send IDOCs. An example setting for SAPRfcDestEntry is SAPRfcDestEntry=dest
SAPRfcPassword SAPRfcUserName
This optional parameter is the password for logging into the SAP system (IDOC outbound and BAPI adapter). This optional parameter is the username for logging into the SAP system (IDOC outbound and BAPI adapter).
B-19
Security Adapters
Table B-10 provides information about the configuration parameter that must be specified for each datasource for which you are using a security adapter. An example of the Security Adapters section is shown in Sample Security Adapters Section in the Siebel.cfg File.
Table B-10.
Name LDAP
In addition to the Security Adapters section, you must specify a parameters section for each security adapter that you specify. The LDAP section parameters are described in the section LDAP Parameters on page B-21. The LDAP parameters section is valid for the security adapter provided by Siebel Systems.
In the preceding example, myadapter represents the name of your security adapter. If you are not using the security adapter provided by Siebel Systems, you must also specify a parameters section that is similar to the LDAP parameters section.
B-20
LDAP Parameters
Table B-11 provides information about the configuration parameters that must be specified for each datasource for which you are using the security adapter provided by Siebel Systems. An example of the LDAP section is shown in Sample LDAP Section in the Siebel.cfg File on page B-23.
Table B-11.
Name BaseDN
(Sheet 1 of 2)
Required. The default = "", which should never be used. BaseDN represents the root of the sub-tree in the LDAP directory under which all users of interest are stored. For example: "ou=People, o=AKParker.com" Users can be stored directly or indirectly below this DN. If administration through the Siebel client is supported and a new user is added to LDAP through the Siebel application it will be added directly under this DN.
CredentialsAttributeType
Required. The default is credentials, and represents the attribute type for credentials. They are stored in the user entry under this attribute in LDAP. See the Siebel Server Administration Guide for more information about credentials.
DllName EncryptCredentialsPassword
Required, and specifies the dll to load which implements the security adapter functions. The value for LDAP is sscfldap.dll. This parameter is optional, and the default value is FALSE. If TRUE, all passwords stored in credentials will be encrypted after reading them from the security adapter and before sending them to the database or other destination for authentication. The encryption algorithm used for EncryptCredentialsPassword is the same as that used by the general configuration file parameter EncryptPassword.
PasswordAttributeType
Required. The default is userPassword, and represents the attribute type for passwords in LDAP. Use the default in almost every case. Required, and the default is 389 if SslDatabase is not set. If SslDatabase is set, then the default is 636. This value represents the port on the server machine through which LDAP is accessed. In most instances, use 389 for standard transmission and 636 for secure transmission.
Port
B-21
Table B-11.
Name
(Sheet 2 of 2)
RolesAttributeType
Required. The default is roles, which is the attribute type for roles. The roles are stored in the user entry under this attribute in LDAP. See the Siebel Server Administration Guide for more information about roles.
ServerName SslDatabase
Required, the name of the machine on which the LDAP server is running, such as AKParkerserver.com. Required, and the default = "". If empty, SSL is not being used. If the value is not empty, it must be the absolute path of a valid Netscape 4.x cert7.db certificate database which contains a certificate for the LDAP server or the Certificate Authority used by the LDAP server. See the Siebel Server Administration Guide for more information.
SupportsIntegratedAuthentication
Optional, and the default value is FALSE. For LDAP this parameter must be FALSE. If TRUE, the specified Security Adapter supports integrated authentication. This means that the user may not be required to enter a username and password and may be authenticated in some other way, such as through the operating system. If TRUE the Siebel client will attempt to use integrated authentication to authenticate with the security adapter. Note that thin client never uses integrated authentication.
UsernameAttributeType
Required. The default is uid, and represents the attribute type under which the username is stored. For example, when user SADMIN attempts to log in, the LDAP search will be for uid=SADMIN.
B-22
B-23
Internet Parameters
Table B-12 defines Internet parameters.
Table B-12.
Name TableOwner
Internet Parameters
Definition In a database, tables are identified by both their owner and their name. When Siebel issues queries that reference tables (all Siebel queries) you must include the table owner in those references (for example, SIEBEL.S_EVT_ACT where SIEBEL is the table owner). When generating SQL to send to a DBMS, there are times when you must construct the statement differently depending on the DBMS to which you are talking. SqlStyle is the parameter that tells us what database we are talking to, such as Oracle, Sybase, and so on.
SqlStyle
B-24
Limiting Views to Thin Client or Dedicated Client . . . . . . . . . . . . . . . . .C-2 Administration of Responsibilities . . . . . . . . . . . . . . . . . . . . . . . . . .C-2 Configuration of Screen Views . . . . . . . . . . . . . . . . . . . . . . . . . . . .C-2
C-1
Administration of Responsibilities
In the Application Administration Responsibilities view, remove the view from the responsibility of thin client users or dedicated client users. This approach assumes that your application administrator has created different responsibilities for each type of Siebel client.
mobile client, Thin Client for Windows, Java Thin Client, and HTML Thin Client.
Dedicated Client Only. Refers to the Siebel dedicated client. Siebel thin clients are
not supported for this view in this screen when this setting is selected.
Thin Client Only. Refers to all the Siebel thin clientsSiebel HTML Thin Client,
Siebel Java Thin Client, and Siebel Thin Client for Windows. Siebel dedicated client is not supported for this view in this screen.
Win32 Only. Refers to Siebel dedicated client and Siebel Thin Client for Windows.
Thin clients other than Thin Client for Windows are not supported for this view in this screen when this setting is selected.
You can change this setting, but you should not do so unless the view referenced by the screen view object definition has been altered to support the types of clients for which you are making the view available. C- 2
Siebel Client Installation and Administration Guide Version 6.2, Rev. A
D-1
Application Performance
To optimize the performance of your application, follow these guidelines: In Siebel Tools, create a separate application definition for the Web application instead of using an existing dedicated-client application. For example, create Sales HTML Thin Client instead of using Siebel Sales. In your HTML Thin Client application definition, follow these guidelines: Reduce the number of objectsparticularly the number of applets in a view and the number of fields in each applet. Specifically, do not include fields (and applets) that users dont often need or that dont apply to the Web. Do not define any view to have a list and a form accessing the same business component.
D-2
In your templates themselves, avoid duplicating information on the same page. For example, do not place a list and a form referring to the same business component on one page. Avoid this even if you have a view with a list and a form accessing the same business component. In your templates and other Web pages, minimize the use of multimedia objects (such as graphics, audios, and videos).
E
E
E-1
E-2
Index
A
AccessDir parameter B-3 accounts, creating mobile client 5-13 ActiveX control 9-2 Actuate parameters ActuateDevWBDir B-15 ActuateReportExportFileName B-15 ActuateDevWBDir parameter B-15 ActuateReportExportFileName parameter B-15 Adobe Acrobat Reader installing 4-4 requirement 4-4 anti-virus software, client configuration 6-8 AppletTitleFont parameter B-3 Application Object Manager 14-4 repository file 1-6 TCP/IP protocol 1-6 thin clients 1-6 ApplicationName parameter B-3 ApplicationSplashText parameter B-3 autodial preferences, mobile client 5-14
B
BaseDN parameter B-21 benefits thin client 1-5 business component classes supported E-1 UNIX E-1
C
CaptionPrefix parameter B-3 CaseInsensitive parameter B-8
caution installation 4-4, 4-6 Java Thin Client 10-5 local transaction log 5-24 mobile clients 5-24 Oracle database icons 4-10 remote component 5-24 saving files 10-5 Siebel Remote 5-24 synchronizing 5-24 Central Dispatch Gateway Server address 4-9 Request Server name 4-9 choosing a thin client 1-7 client Adobe Acrobat reader 4-4 anti-virus software 6-8 architecture 3-5 dedicated client defined 1-3 defined 1-3 deployment differences diagram 1-4 directory structure 4-14 distinguishing thin and dedicated 1-3 icons created during installation 4-16 installing the Server Manager 4-7 installing with the Compact Setup option 4-7 installing with the Custom Setup option 4-7 installing with the Typical Setup option 4-7 installing without Siebel VB licensed 4-11 logging on 5-2 mobile client defined 1-3
Index
ODBC data sources 4-17 post-installation tasks 4-11 pre-installation tasks 4-2 removing 4-18 testing Siebel Correspondence 4-13 thin client defined 1-3 traditional client defined 1-3 verifying installation 4-11 client database, failure recovery procedure 5-12 ClientFileServSupport parameter B-3 ClientRootDir parameter 5-9, B-3 Colors parameter 10-10 Compact Setup option, client installation 4-7 ComponentName parameter B-3 configuration files dedicated client 5-26 editing 2-6 HTML Thin Client 15-6 Java Thin Client sample 10-6 mobile client 5-9 sample 2-3 sample datasource section B-12 sources of information 2-2 configuration parameters finding A-2 index A-2 configuration, anti-virus software 6-8 ConfiguratorDLLName parameter B-16 ConfiguratorExeDir parameter B-16 ConfiguratorExeFileName parameter B-16 ConfiguratorModelDir parameter B-16 ConfiguratorModelExportFileName parameter B-16 configuring, HTML Thin Client 14-8 connectivity Siebel Remote 5-3 TCP/IP for Siebel Remote 5-3 ConnectString parameter B-8 ContactLogin parameter B-8 CorrespODBCDataSource parameter B-3 correspondence enabling on Windows 95 4-13 enabling on Windows 98 4-13
testing functionality 4-13 Word 97 4-13 creating accounts 5-13 mobile client user account 5-13 CredentialsAttributeType parameter B-21 custom installer creating 9-11 packaging 9-15 preparing administrator workstation 9-11 Custom Setup option client installation 4-7 Server Manager installation 4-7
D
data cleansing parameters Dir B-17 Enable B-17 Type B-17 data source. See ODBC data source Database Extract directory tree 5-16 docking 5-16 running 5-15 database, client 5-12 DataMart parameter B-7 DataSource parameter 10-8, B-3 DataSource section parameters B-7, B-8 DateYearFormat parameter 10-8 DecimalNumberScale parameter 10-8 dedicated client choosing a directory name 4-3 configuration files 5-26 database connectivity software 4-3 default installation directory 4-7 defined 3-2 installing third-party software 4-4 prerequisites 4-3 removing 4-18 deduplication parameters Dir B-18 Enable B-18 Type B-18 DefaultChartFont parameter B-3
Index
DefaultFont parameter 10-10 demonstration database, Siebel client 4-12, 4-17 deploying Java Thin Client 8-6 sample steps for Thin Client for Windows 11-3 Thin Client for Windows 8-6 differences between thin clients 1-7 Dir parameter B-17, B-18 directory name choosing 4-3 default 4-3 directory structure, client 4-14 distributing custom installer 9-16 installer 9-16 DLL parameter B-8 DllName parameter B-21 DockConnString parameter 5-9, B-8 Docked parameter B-8 docking Database Extract 5-15, 5-16 directory tree 5-16 failure recovery 5-12 initializing local database 5-21 DockRecvTxnsPerCommit parameter B-8 DockRepositoryName parameter 5-10, B-3 DockTxnsPerCommit parameter 5-11, B-8 documentation, additional Intro-3
F
failure recovery procedures 5-12 features HTML Thin Client 14-2 thin client 1-7 FileExtensionMap parameters 10-9 FileSystem parameter 5-11, B-4 finding configuration parameters A-2 font parameters LargeDataFont B-5 LargeFont B-5 NavBarItemFont B-5 NavBarSelectFont B-6 NavBarTitleFont B-6 SmallDataFont B-6 SmallFont B-7 Fulcrum, installing SearchServer Desktop before client 4-5
G
Gateway parameter B-7 Gateway Server address, Resonate Central Dispatch 4-9 GatewayAddress parameter B-9
H
help system 4-17 HelpFile parameter B-4 Hidden parameter B-9 HideBackground parameter 9-12 HoldExportOdbcConnection parameter B-4 HTML Thin Client Application Object Manager 14-4 architecture 14-3 configuration files 15-6 customizing 14-8 diagram 14-3 distributed installation 15-3 installation 14-8, 15-6 introduction 8-2, 14-4 network security 16-3 new features 14-2
E
editing configuration files how to 2-6 siebel.ini file 9-12 Enable parameter B-17, B-18 EnableOLEAutomation parameter B-4 EnablePersonalization parameter B-4 EnableScripting parameter B-4 EncryptPassword parameter B-4 Enterprise Server parameter B-9 ExtensionType parameter B-9
Index
object manager 14-4 pre-installation tasks 15-2 Siebel Web Engine 14-4 single-node installation 15-3 templates 14-4 troubleshooting 17-2, 17-3, 17-4 user request 14-5 HTML thin client troubleshooting 17-2, 17-3
I
icons Oracle database 4-10 Siebel client 4-16 index of configuration parameters A-2 initializing, local database 5-21 InsensitivityFactor parameter B-9 installation caution 4-4, 4-6 client 4-6, 10-2 creating custom installer 9-11 database connectivity software for client 4-3 dedicated client 4-6 HTML Thin Client 14-8, 15-6 Java Thin Client 10-4 mobile client 4-6 Thin Client for Windows 9-6 installer, creating custom 9-11 InsUpdAllCols parameter B-9 IntegratedSecurity parameter B-10 internet parameters B-24 introduction clients 1-2 diagram of different clients 1-2 HTML Thin Client 8-2, 14-4 Java Thin Client 8-2 Siebel clients 1-2 Thin Client for Windows 8-2
caution 10-5 control types supported 8-9 deploying 8-6 example 8-4 installation 10-4 introduction 8-2 launching 10-17 pre-installation tasks 10-2 removing 10-18 sample configuration file 10-6 saving files caution 10-5 script types supported 8-10 sharing configuration files 10-17 starting 10-17 supported applet classes 8-8 supported control types 8-9 supported platforms 10-2 supported script types 8-10 troubleshooting 13-1 uninstalling 10-18 user interface functionality 8-7 Year 2000 compliance 10-11 JTCHelpURL parameter B-5
L
Language parameter 9-12 LargeDataFont parameter B-5 LargeFont parameter B-5 launching Java Thin Client 10-17 Thin Client for Windows 9-17 LDAP parameter B-20 limiting views administration C-2 configuration of screen views C-2 local database initializing 5-21 mobile clients 3-3, 5-21 transaction log 3-3 warning 3-3 Local parameter B-7 LocalDbODBCDataSource parameter B-5 log files event 4-11
J
Java Thin Client access outside firewall 12-2 applet classes supported 8-8
Index
registry 4-11 Siebel Web Engine 17-4 logging on client 5-2 Siebel client 4-11
M
MainRepositoryName parameter B-5 MaxCachedCursors parameter B-10 MaxCachedDataSets parameter B-10 MaxConnections parameter B-10 Microsoft Windows 95, enabling Siebel correspondence on 4-13 Microsoft Word 97 4-13 mobile client user account authentication 5-13 creating 5-13 mobile clients accounts 5-13 background synchronization 3-3 caution 5-24 configuration files 5-9 database connectivity software 4-3 Database Extract 5-15 default installation directory 4-7 defined 3-2 file system 3-3 initializing local database 5-21 installing third-party software 4-4 local database 3-3 position view validity 5-15 prerequisites 4-3 registering 5-14 removing 4-18 stand-alone synchronization 3-3 starting server processes 5-17 synchronizing instructions 5-26 TCP/IP protocol 3-4 MS DOS file extensions 4-13 MultiCurrency parameter B-5
Netscape plug-in, Windows Thin Client 9-2 network security access outside firewall 12-2 firewall configuration 16-3 NetworkPacketSize parameter B-10 NoExtension parameter 10-10 NonSQL parameter B-10
O
ODBC data sources, client 4-17 OLEAutomationDLL parameter B-6 OLEMessagePendingDelay parameter online help system 4-17 Oracle database caution with icons 4-10 icons 4-10 overview, synchronizing 5-22 B-6
P
Packager Utility 4-7 PasswordAttributeType parameter B-21 performance enhancements active fields configuration 6-7 antivirus software 6-8 application D-2 configuring active fields 6-7 docking transaction logging 6-7 runtime docking transaction logging 6-7 server-side tips 6-8, D-2 Thin Client for Windows 9-20 PersonalizationLog parameter B-6 Placeholder parameter B-10 Port parameter B-21 positions, listed in view 5-15 post-installation tasks, client 4-11 Preferences parameters 10-10 preferences, autodial 5-14 PrefetchSize parameter B-10 pre-installation tasks client 4-2 HTML Thin Client 15-2 Java Thin Client 10-2 Thin Client for Windows 9-3 preload parameters B-15
N
NavBarItemFont parameter B-5 NavBarSelectFont parameter B-6 NavBarTitleFont parameter B-6
Index
R
registering mobile clients 5-14 remote component autodial preference 5-14 caution 5-24 remote component server, setting up 5-13 remote component user, setting up 5-13 remote implementation, failure recovery 5-12 removing dedicated client 4-18 Java Thin Client 10-18 Thin Client for Windows 9-20 reports parameters ReportsDir B-6 ReportsODBCDataSource B-6 ReportsDir parameter B-6 ReportsODBCDataSource parameter B-6 repository file, Application Object Manager 1-6 RepositoryFile parameter B-6 RequestComponent parameter B-11 RequestServer parameter B-11 Resonate Central Dispatch Gateway Server address 4-9 Request Server name 4-9 ReverseFillThreshold parameter B-11 RolesAttributeType parameter B-22 RootDirectory parameter 9-7, 9-14 rs405eng.exe 4-5 running Database Extract 5-15 Transaction Merger 5-20 Transaction Processor 5-18 Transaction Router 5-19
S
sample database, Siebel client 4-17 Sample parameter B-7 SAPIdocAllowedObjects parameter B-19 SAPRfcConnectString parameter B-19 SAPRfcDestEntry parameter B-19 SAPRfcPassword parameter B-19 SAPRfcUserName parameter B-19
SAPSubsys parameters SAPIdocAllowedObjects B-19 SAPRfcConnectString B-19 SAPRfcDestEntry B-19 SAPRfcPassword B-19 SAPRfcUserName B-19 ScriptingDLL parameter B-6 search parameters SearchConnectString B-11 SearchDisableViewer B-11 SearchConnectString parameter B-11 SearchDisableViewer parameter B-11 security adapters parameters BaseDN B-21 CredentialsAttributeType B-21 DllName B-21 LDAP B-20 PasswordAttributeType B-21 Port B-21 RolesAttributeType B-22 sample B-20, B-23 SecurityAdapter B-11 ServerName B-22 SslDatabase B-22 SupportsIntegratedAuthentication B-22 UpperCaseLogin B-12 UsernameAttributeType B-22 SecurityAdapter parameter B-11 Server Manager, installing 4-7 Server parameter B-7, B-11 ServerName parameter B-22 setting up mobile client hardware 5-14 mobile client software 5-14 remote component server 5-13 remote component users 5-13 Siebel Remote server 5-13 Siebel Remote users 5-13 setup.exe, client 4-6 SharedModeUsersDir parameter B-6 sharing configuration files 9-10 Java Thin Client files 10-17 Thin Client start-up files 9-10 shortcuts, Thin Client for Windows 9-9
Index
ShowMessageBar parameter B-6 Siebel client. See client Siebel Marketing during installation 4-10 Siebel program logging on 5-2 signing on without Siebel VB licensed 4-11 standard client installation 4-2 Siebel Remote application server preferences 5-9 autodial preferences 5-14 caution 5-24 connectivity 5-3 dialog box 5-4 local transaction log 5-24 network connectivity 5-3 preferences 5-9 server processes 5-17 starting Transaction Merger 5-20 starting Transaction Processor 5-18 starting Transaction Router 5-19 TCP/IP 5-3 Siebel Remote server, setting up 5-13 Siebel Remote users, setting up 5-13 Siebel Sales and Service, icon 4-10 Siebel technical support Intro-6 to Intro-7 Siebel Web Engine 14-4 siebel.ini file 9-12 SmallDataFont parameter B-6 SmallFont parameter B-7 SQL Anywhere demonstration database 4-12 error messages 4-12 sample database 4-12 SqlStyle parameter B-12, B-24 SslDatabase parameter B-22 stand-alone executable, Windows Thin Client 9-2 standard client installation, running 4-6 starting, Java Thin Client 10-17 SupportsIntegratedAuthentication parameter B-22 synchronization background 3-3 dialog box 5-4
options 5-3 stand-alone 3-3 synchronizing caution 5-24 instructions 5-26 mobile clients 5-22, 5-26 overview 5-22 workflow 5-22, 5-24
T
TableOwner parameter 5-10, B-12, B-24 technical support Intro-6 to Intro-7 TempDir parameter B-7 templates, HTML Thin Client 14-4 Thin Client Java example 8-4 Windows example 8-3 thin client Application Object Manager 1-6 benefits 1-5 central management 1-5 choosing 1-7 configuration in Siebel Tools 1-5 features 1-7 major differences 1-7 preferences stored on server 1-5 reduced resources requirements 1-5 share UI with dedicated 1-5 third-party software Fulcrum 4-5 installing for client 4-4 requirements 4-4 transaction log 3-3 Transaction Merger running 5-20 starting 5-20 Transaction Processor running 5-18 starting 5-18 Transaction Router running 5-19 starting 5-19 troubleshooting configuration files 17-2 dedicated client 7-1
Index
Java Thin Client 13-1 log files 17-3, 17-4 MaxCursorSize parameter 7-1 object manager configuration 17-2 returning more rows 7-1 .srf and .cfg 17-3 Thin Client for Windows 13-1 Visual Basic 17-3 Windows NT services 17-2 Type parameter B-17, B-18 Typical Setup option, client installation 4-7
W
Welcome parameter 9-13 Windows Thin Client access outside firewall 12-2 ActiveX control 9-2 applet classes supported 8-8 connect string samples 9-18 control types supported 8-9 custom installer 9-11 deploying 8-6 deployment scenario 11-2 example 8-3 installation 9-6 introduction 8-2 launching 9-17 Netscape plug-in 9-2 performance 9-20 pre-installation tasks 9-3 removing 9-20 sample connect strings 9-18 sample deployment 11-3 script types supported 8-10 shortcuts 9-9 stand-alone executable 9-2 starting 9-17 supported applet classes 8-8 supported control types 8-9 supported script types 8-10 troubleshooting 13-1 uninstalling 9-20 user interface functionality 8-7 verifying configuration files 9-9 Word 97 (Microsoft) 4-13
U
uninstalling client 4-18 dedicated client 4-18 Java Thin Client 10-18 mobile client 4-18 Thin Client for Windows 9-20 UNIX business component classes E-1 support E-1 updating, mobile clients 5-26 UpperCaseLogin parameter B-12 user interface functionality Java Thin Client 8-7 Thin Client for Windows 8-7 UsernameAttributeType parameter B-22 users, mobile client 5-13
V
verifying configuration files, Thin Client for Windows 9-9 Version parameter B-7 View1 parameter B-15 View2 parameter B-15 ViewN parameter B-15 views dedicated client only C-2 limiting C-2 thin client only C-2
Y
Year 2000 compliance 10-11