Siebel CRM – Configuration File (cfg) Disected and Explained.

Today we are going to discuss about one of the most important files for Siebel CRM. Yes, those who have worked on Siebel will know what I am talking about.
Yes, we are going to discuss “.cfg” file which stands for configuration file which largley controls siebel bhavieor. There are basically 3 important cfg files.


1. eapps.cfg
2. tools.cfg
3. cfg file for Siebel Client(Name can depend on the kind of siebel application you are using)

so for this article we will assume uagent.cfg which is used if you are using call center.To discuss eapps.cfg is out of scope for this article so in this article we will be discussing tools.cfg and uagent.cfg file.
Tools.cfg is used for Siebel Tools and uagent exsits for Siebel Client both dedicated and thin. First of all the location of the file.Tools.cfg exsits in :siebel installation directory\tools\bin\enu
Here enu means the language that you have choosen. It can be different if you have installed siebel tools in langauage other than english.uagent.cfg exsits in : siebel installation directory\web client\bin\enu.
For thin client the cfg file exsits on server and the path is
/siebel install dir/siebsrvr/bin/enu if the server is Unix
siebel install dir\siebsrvr/bin/enu if the server is Windows
Now I will describe various sections of CFG file.

In CFG file anything that starts from [] is a section that contains certain Parameters to control siebel. I will list important sections that are important and we need modify them often

1. [Siebel] 2. [DataSources] 3. [Local] 4. [Sample] Only used if you have installed sample database
5. [ServerDataSrc] Very important and modified often.
6. [SWE]

Tip: If you want to comment anything in cfg file use ; a semicolon in front of any line would mean that siebel is going to ignore that line treating it as comment.
I am goint to list only the important parameters in the sections.

1. [Siebel] : This section contains important parameters related to siebel. Which are as following

RepositoryFile :Name of the SRF file to be used
ApplicationName :Name of the Application to be used
ApplicationTitle :Name that is going to appear in Title of your browser window and can be anything
ApplicationSplashText :Name that is going to appear when you start you dedicated client and can be anything
EnableScripting :Often used for debugging purposes. If set to false no script is going to execute when you start you client
LocalDbODBCDataSource :Name of the ODBC data source that is going to be used when you start dedicated client with local database (SSD Local Db default instance by default)
ServerDbODBCDataSource :Name of the ODBC data source that is going to be used when you start dedicated client with server database (SSD default instance by default)
DockRepositoryName
:Name of the repository that is going to be used.
WebClientSiteDir : Path to the directory from where the browser scripts and images are going to be picked up
EnablePersonalization : To Enable or Disable personlaization for Siebel Users
EnableRuntimeEvents : To Enable or disable Runtime Events
EnableObjectCOCI : To Enable object check in check out when set to false you are not allowed to check out a single object. Remember Object checkout has to be enabled from tools also before you can do that

2. [DataSources] : This section contians the what you can see from the dropdown of you dedicated client. Default values are
Local = Local
Sample = Sample
ServerDataSrc = Server

You can specify more datasources under this section to specify more section you have to define it in the following way.

MyNewDataSource = NewDataSource
MyNewDataSource is the name of the Section that should be present in the cfg file that is going to contain parameters to be used for this datasource
‘NewDataSource’ is the value that is going to appear in the dropdown of dedicated siebel tools or client.
3. [Local] : In this section only one parameter is important and that we can change to our advantage
ConnectString = C:\PROGRA~1\Siebel\7.8\Tools\local\sse_data.dbf -q -m -x NONE -gp 4096 -c256m -ch256m

As you can see the value of the connection string is in the form of Path and then switches.

The path is the path to your dbf file and the switches that you can give are as following
-q : means start local database in quite mode.This prevents a SQL Anywhere window from showing up.
-m : truncate transaction log after checkpoint.
-x NONE : Do not load any network drivers.
-gp 4096 : Tells the engine that the database page size is 4,096 bytes.
-c256m : Initial cache size is 256 MB
-ch256m : Maximum cache size can be mb256.

4. [Sample] : This section is pretty similar to Local Section with exception of one parameter

FileSystem : It contains path to you file system where you attachments are stored

5. [ServerDataSrc] : This is one of the most important section and you have to change few parameter before you can actually login to server through Dedicated Client.

ConnectString : Here just like local section indicates the connection string to be used to connect to server
FileSystem : Path to you file system. Similar to local section
GatewayAddress : This will contain the name of your Siebel Gateway Server. This section has to be changed to a valid value
EnterpriseServer : This will contain the name of your Siebel Enterprise Server.This section has to be changed to a valid value

6. [SWE] : This section contains parameters related to the bitmaps and appearance of Siebel Client. But It contains an important parameter which is as following.

ClientBusinessService : This parameter is used if you want a business service to be called from browser scripts. The Business service has to be mentioned here in this section.
The format to mention the business service is

ClientBusinessServicen = “Business Service Name” where n is a incremental number one more than the number mentioned in last ClientBusinessService entry. For example
ClientBusinessService0 = “Message Bar”
ClientBusinessService1 = “Communications Client”

If I want to have one more entry in the file then I will enter
ClientBusinessService2 = “Business Service Name”

This completes the listing and explaination of important parameters of the cfg file used by siebel tools and siebel client.

Hope this post was helpful to you. If yes please post your comments and visit again for more.

44 Responses to Siebel CRM – Configuration File (cfg) Disected and Explained.

  1. Hi ALL.
    I am a fresher.I have just got my first project in siebel from my company.I have been asked to go through “configuration” from Basics. So kindly help me by giving all details abt “configuration”.ASAP

  2. Hi ALL.
    I am a fresher.I have just got my first project in siebel from my company.I have been asked to go through “configuration” from Basics. So kindly help me by giving all details abt “configuration”.ASAP

  3. hi,

    This is really a valuable article, Neel can u help me with my confusion regarding “DockRepositoryName”. ..Whats the exact meanin of siebel repository here. When I copy my dbf and access it it brings all the created objects in tools. Now here can I say my repository got copied ?? if yes whats the significance of parametr “DockRepositoryName” as sibel rep??

    Thnx for your help!

    NS

  4. hi,

    This is really a valuable article, Neel can u help me with my confusion regarding “DockRepositoryName”. ..Whats the exact meanin of siebel repository here. When I copy my dbf and access it it brings all the created objects in tools. Now here can I say my repository got copied ?? if yes whats the significance of parametr “DockRepositoryName” as sibel rep??

    Thnx for your help!

    NS

  5. DockRepository parameter tell siebel which repository to load by default.

    As you know that it is possible to have multiple repositories in same dbf and you can change repositories from

    File – Open Repsoitories
    and change which repository to use, but if you want to change the default repository then you can just change DockRepository parameter and specify which repsoitory to use by default

  6. DockRepository parameter tell siebel which repository to load by default.

    As you know that it is possible to have multiple repositories in same dbf and you can change repositories from

    File – Open Repsoitories
    and change which repository to use, but if you want to change the default repository then you can just change DockRepository parameter and specify which repsoitory to use by default

  7. i have installed Siebel7.7 with sql server.I want to set the local dbf for siebel configurator with different user name.how to extract the dbf file form original dbf.please help me

  8. i have installed Siebel7.7 with sql server.I want to set the local dbf for siebel configurator with different user name.how to extract the dbf file form original dbf.please help me

  9. Hi,
    Very Gud One. All these days i was blindly using the connect String path never concentrated what each term ism eant for.Thanks for your Crystal Clear Explanation.
    Rgds,
    K.Neeraja

  10. Hi,
    Very Gud One. All these days i was blindly using the connect String path never concentrated what each term ism eant for.Thanks for your Crystal Clear Explanation.
    Rgds,
    K.Neeraja

  11. ApplicationSplashText :
    In the cfg file Text present like ApplicationSplashText = Siebel Call Center
    Appears when application is opened. If we make
    ApplicationSplashText = null
    When opening the application ” Enterprise Application ” is the text appears.
    When application is clicked no Text should appear.
    Can we alter this display text and how

  12. ApplicationSplashText :
    In the cfg file Text present like ApplicationSplashText = Siebel Call Center
    Appears when application is opened. If we make
    ApplicationSplashText = null
    When opening the application ” Enterprise Application ” is the text appears.
    When application is clicked no Text should appear.
    Can we alter this display text and how

  13. Hi all,
    I am completely new to Siebel but managed to install Siebel 8.0 tools,dev webclient and the sample database.After installation I changed the tools.cfg file to point to my sample db and it works,am able to log in into Siebel Tools.
    The problem is with dev web client, struggling to login into the application it says “no local database found, would you like to connect to the server db…bla bla bla…”.
    My uagent.cfg file has got the connectstring entry for sample db is
    ConnectString = C:PROGRA~1Siebel8.0WEBCLI~1SAMPLEUTF8sse_samp.dbf -q -m -x NONE -gp 4096 -c40m -ch60m

    and in the log file I can see the below entry:
    2021 2010-01-20 00:22:12 2010-01-20 00:22:14 +0530 00000006 001 003f 0001 09 siebel 2060 2064 C:Program FilesSiebel8.0web clientlogsiebel.log 8.0 SIA [20405] ENU

    ObjMgrLog Error 1 000000024b55080c:0 2010-01-20 00:22:12 (wccon.cpp (2030)) SBL-SFR-00117: The local Siebel database was not found. Would you like to connect to the Siebel Remote server to initialize the local database?

    GenericLog GenericError 1 000000024b55080c:0 2010-01-20 00:22:12 (secmgr.cpp (2486) err=4597538 sys=127) SBL-SEC-10018: The local Siebel database was not found. Would you like to connect to the Siebel Remote server to initialize the local database?(SBL-SFR-00117)
    Specified database not found

    GenericLog GenericError 1 000000024b55080c:0 2010-01-20 00:22:12 (secmgr.cpp (2558) err=4597521 sys=0) SBL-SEC-10001: An internal error has occurred within the authentication subsystem for the Siebel application. Please contact your system administrator for assistance.

    ObjMgrSessionLog Error 1 000000024b55080c:0 2010-01-20 00:22:12 (physmod.cpp (9244)) SBL-SFR-00117: The local Siebel database was not found. Would you like to connect to the Siebel Remote server to initialize the local database?

    ObjMgrSessionLog Error 1 000000024b55080c:0 2010-01-20 00:22:12 (model.cpp (5867)) SBL-SFR-00117: The local Siebel database was not found. Would you like to connect to the Siebel Remote server to initialize the local database?

    Any help would be greatly appreciated….
    thanks in advance.
    anand

  14. Hi all,
    I am completely new to Siebel but managed to install Siebel 8.0 tools,dev webclient and the sample database.After installation I changed the tools.cfg file to point to my sample db and it works,am able to log in into Siebel Tools.
    The problem is with dev web client, struggling to login into the application it says “no local database found, would you like to connect to the server db…bla bla bla…”.
    My uagent.cfg file has got the connectstring entry for sample db is
    ConnectString = C:\PROGRA~1\Siebel\8.0\WEBCLI~1\SAMPLE\UTF8\sse_samp.dbf -q -m -x NONE -gp 4096 -c40m -ch60m

    and in the log file I can see the below entry:
    2021 2010-01-20 00:22:12 2010-01-20 00:22:14 +0530 00000006 001 003f 0001 09 siebel 2060 2064 C:\Program Files\Siebel\8.0\web client\log\siebel.log 8.0 SIA [20405] ENU

    ObjMgrLog Error 1 000000024b55080c:0 2010-01-20 00:22:12 (wccon.cpp (2030)) SBL-SFR-00117: The local Siebel database was not found. Would you like to connect to the Siebel Remote server to initialize the local database?

    GenericLog GenericError 1 000000024b55080c:0 2010-01-20 00:22:12 (secmgr.cpp (2486) err=4597538 sys=127) SBL-SEC-10018: The local Siebel database was not found. Would you like to connect to the Siebel Remote server to initialize the local database?(SBL-SFR-00117)
    Specified database not found

    GenericLog GenericError 1 000000024b55080c:0 2010-01-20 00:22:12 (secmgr.cpp (2558) err=4597521 sys=0) SBL-SEC-10001: An internal error has occurred within the authentication subsystem for the Siebel application. Please contact your system administrator for assistance.

    ObjMgrSessionLog Error 1 000000024b55080c:0 2010-01-20 00:22:12 (physmod.cpp (9244)) SBL-SFR-00117: The local Siebel database was not found. Would you like to connect to the Siebel Remote server to initialize the local database?

    ObjMgrSessionLog Error 1 000000024b55080c:0 2010-01-20 00:22:12 (model.cpp (5867)) SBL-SFR-00117: The local Siebel database was not found. Would you like to connect to the Siebel Remote server to initialize the local database?

    Any help would be greatly appreciated….
    thanks in advance.
    anand

  15. Anand,
    I had faced the same problem before, but my connect string was wrong.
    Please check whether in the mentioned path you have “UTF8” in SAMPLE folder.
    Just hope this helps you maybe.

    Cheers

  16. Anand,
    I had faced the same problem before, but my connect string was wrong.
    Please check whether in the mentioned path you have “UTF8” in SAMPLE folder.
    Just hope this helps you maybe.

    Cheers

  17. Hii , Neel .. Thank u very much…
    By The Way , in my tools.cfg file .. there is no section called [SWE] , eventhough siebel 8.1.1 is working fine … 😀
    Why so ?

  18. Hi Neel,

    I was searching for the information on the cfg files and your post is really good. Could you also please share the differences in tools.cfg and uagent.cfg file.

    Thanks
    Neha

  19. hai
    I am a fresher.I have just got my first project in siebel from my company.I have been asked to go through “configuration” from Basics. So kindly help me by giving all details abt “configuration”

Leave a Reply

Contribute