The gateway.ini file is the main configuration file for Oracle Communications MetaSolv Solution and for application programming interface (API) interactions with other applications. The Oracle WebLogic server accesses the gateway.ini file and gets the configuration settings for managing these interactions from the /appserver/gateway folder in the Oracle WebLogic server.
Some gateway.ini parameters can be set during installation. Therefore, the gateway.ini file may contain some site-specific values as a result.
In most cases, using the default values is recommended. In some cases, parameter settings are directly tied to internal processing and should never be changed.
Valid reasons for changing optional parameters include:
Improving performance
Updating a database ID or a password when changes are made in the environment
There may be instances when Oracle Global Customer Support requests that you change a Gateway.ini parameter for research or debug purposes.
When you change a setting in the gateway.ini file, that change does not take effect until the next time you start the Oracle WebLogic server. Therefore, whenever you change one or more of the gateway.ini parameters, you must shut down and restart the Oracle WebLogic server
When you suspend and resume a MetaSolv Solution server process, that process does not re-read the gateway.ini settings that affect its operation. Therefore, changes are ignored unless you shut down and restart the Oracle WebLogic server.
Gateway.ini parameters are grouped together in the file to make it easier for you to find parameters you may need to change. The section order may be changed.
Following is a list of the parameter groups in the order they appear in the installed gateway.ini file:
Server parameters
ThreadProcs parameters
OrbProperties parameter
Session parameters
System parameters
Gateway parameters
SignalInternetServices
Events parameters
Event2 parameters
WorkManagement parameters
JNDI parameters
CA custom attributes parameters
Portal parameters
Custom Extension parameters
The following sections provide the following types of information about each section of the gateway.ini file:
Defaults and valid entries
Parameter descriptions
Instructions about prohibited changes, where appropriate
Some lines in the Gateway.ini file are very long. When viewing the file, some editors may wrap the text, making the file appear to contain extra text. Disable Word Wrap to view long lines as they are intended to be used.
[Servers] ;This section is modified by the install to contain a list of active servers. DLRSERVER=MetaSolv.CORBA.WDIDLR.WDIRoot,MetaSolv.WDIDLR.WDIRootImpl PSRSERVER=MetaSolv.CORBA.WDIPSR.WDIRoot,MetaSolv.WDIPSR.WDIRootImpl LSRSERVER=MetaSolv.CORBA.WDILSR.WDIRoot,MetaSolv.WDILSR.WDIRootImpl WMSERVER=MetaSolv.CORBA.WDIWM.WDIRoot,MetaSolv.WDIWM.initialization.WDIRootImpl NISERVER=MetaSolv.CORBA.WDINI.WDIRoot,MetaSolv.WDINI.WDIRootImpl PSRANCILLARYSERVER=MetaSolv.CORBA.WDIPSRAncillary.WDIRoot,MetaSolv.PSRAncillary.WDIRootImpl SOASERVER=MetaSolv.CORBA.WDISOA.WDIRoot,MetaSolv.WDISOA.initialization.WDIRootImpl TMSSERVER=MetaSolv.CORBA.WDITrouble.WDIRoot,MetaSolv.WDITrouble.initialization. WDIRootImpl ;ASRSERVER=MetaSolv.CORBA.WDIASR.WDIRoot,MetaSolv.WDIASR.WDIRootImpl ;ASR41SERVER=MetaSolv.CORBA.WDIASR.WDIRoot,MetaSolv.WDIASR.WDIRootImpl ;ASR42SERVER=MetaSolv.CORBA.WDIASR42.WDIRoot,MetaSolv.WDIASR25.WDIRootImpl ;CABSSERVER=MetaSolv.CORBA.WDICABS.WDIRoot,MetaSolv.WDICABS.WDIRootImpl INFRASTRUCTURESERVER=MetaSolv.CORBA.WDIInfrastructure.WDIRoot,MetaSolv. WDIInfrastructure.WDIRootImpl PSREUBServer=MetaSolv.CORBA.WDIPSREUB.WDIRoot,MetaSolv.WDIPSREUB.WDIRootImpl [ThreadProcs] ;INTEGRATIONSERVER=com.mslv.integration.integrationServer.S3Startup EVENTPROC=MetaSolv.eventServer.S3Startup EVENT2PROC=MetaSolv.event2Server.Event2ServerStartup SYSTEMTASKSERVERPROC=com.mslv.core.api.internal.WM.systemTaskServer. SystemTaskServer SIGNALSERVERPROC=com.metasolv.system.StartServer INTERNET_SIGNAL_SERVER=MetaSolv.CORBA.WDIINTERNETSERVICES.WDIRoot,MetaSolv.SignalServer.WDIInternetSignalServerRootImpl [OrbProperties] ORBPort=2720 [Session] User=app_api Password={AES}1824a67ea02612bcbe3169d0b0d185b4 [System] URLNamingServicePort=15000 StartupMode=server;StartUp Mode - gui, batch, server Environment=prod;Environment - dev, test, prod DebugOn=true LoggingOn=true LogFileDir=/opt2/metasolv/mslv01/appserver/logs LogToFile=true LogToSystemOut=true AppendToLog=true IORPath=/opt2/metasolv/mslv01/appserver/ior TraceLevel=1 ;MaxThreads=1000 [Gateway] PrintExportObjects=true JobQueueServer=JOB SERVER NAME;Background Processor Logical Name Timeout=601 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx [Events] DBPollingInterval=30 DBPollingInterval_Srsi=60 DBPollingInterval_Serv=60 DBPollingInterval_Ge=60 DBPollingInterval_Genet=60 suspendCheckInterval=10 MaxThreads_Srsi=1 MaxThreads_Serv=1 MaxThreads_Ge=1 MaxThreads_Genet=1 maxCapacity_Srsi=500 maxCapacity_Serv=500 maxCapacity_Ge=500 maxCapacity_Genet=500 SuspendFileName=/opt2/metasolv/mslv01/appserver/suspendEventServer [Event2] DBPollingInterval=30 SuspendFileName=/opt2/metasolv/mslv01/appserver/suspendEvent2Server [WorkManagement] DbPollingInterval=120 MaxThreads=5 SystemTaskQueueMaxCapacity=2000 SuspendCheckInterval=5 SuspendFileName=/opt2/metasolv/mslv01/appserver/suspendSystemTaskServer [JNDI] User=administrator Password={AES}1824a67ea02612bcbe3169d0b0d185b4 Factory=weblogic.jndi.WLInitialContextFactory URL=http://srvsunpluto:7001 [CA] CacheDisable=false CacheManagerClass=com.mslv.core.api.internal.ca.cache.broker.CacheManager CacheRefreshActive=true CacheRefreshMode=daily CacheRefreshDayOfWeek=6 CacheRefreshHourOfDay=23 CacheRefreshHourlyInterval=1 [Portal] DefaultPortalId=asap [Custom] CLASSPATH=D:/opt2/metasolv/mslv01/appserver/samples/customExtension;
In the gateway.ini file, the term server parameter refers to a server process, which is another term for API. For instance, the PSRSERVER parameter name refers to the PSR API.
This section controls which MetaSolv Java API server processes are started automatically when the Oracle WebLogic server is started.
Caution:
Do not alter the server names or startup classes.Some servers may not be listed in the gateway.ini initially but are added as separate products are installed.
You can prevent a specific server from starting by placing a preceding semicolon (;) in front of its name.
[Servers] ;This section is modified by the install to contain a list of active servers. DLRSERVER=MetaSolv.CORBA.WDIDLR.WDIRoot,MetaSolv.WDIDLR.WDIRootImpl PSRSERVER=MetaSolv.CORBA.WDIPSR.WDIRoot,MetaSolv.WDIPSR.WDIRootImpl LSRSERVER=MetaSolv.CORBA.WDILSR.WDIRoot,MetaSolv.WDILSR.WDIRootImpl WMSERVER=MetaSolv.CORBA.WDIWM.WDIRoot,MetaSolv.WDIWM.initialization. WDIRootImpl NISERVER=MetaSolv.CORBA.WDINI.WDIRoot,MetaSolv.WDINI.WDIRootImpl PSRANCILLARYSERVER=MetaSolv.CORBA.WDIPSRAncillary.WDIRoot,MetaSolv. PSRAncillary.WDIRootImpl SOASERVER=MetaSolv.CORBA.WDISOA.WDIRoot,MetaSolv.WDISOA.initialization. WDIRootImpl TMSSERVER=MetaSolv.CORBA.WDITrouble.WDIRoot,MetaSolv.WDITrouble. initialization. WDIRootImpl ;ASRSERVER=MetaSolv.CORBA.WDIASR.WDIRoot,MetaSolv.WDIASR.WDIRootImpl ;ASR24SERVER=MetaSolv.CORBA.WDIASR.WDIRoot,MetaSolv.WDIASR.WDIRootImpl ;ASR25SERVER=MetaSolv.CORBA.WDIASR25.WDIRoot,MetaSolv.WDIASR25.WDIRootImpl ;ASR26SERVER=MetaSolv.CORBA.WDIASR26.WDIRoot,MetaSolv.WDIASR26.WDIRootImpl ;ASR27SERVER=MetaSolv.CORBA.WDIASR27.WDIRoot,MetaSolv.WDIASR27.WDIRootImpl ;ASR28SERVER=MetaSolv.CORBA.WDIASR28.WDIRoot,MetaSolv.WDIASR28.WDIRootImpl ;CABSSERVER=MetaSolv.CORBA.WDICABS.WDIRoot,MetaSolv.WDICABS.WDIRootImpl INFRASTRUCTURESERVER=MetaSolv.CORBA.WDIInfrastructure.WDIRoot,MetaSolv. WDIInfrastructure.WDIRootImpl PSREUBServer=MetaSolv.CORBA.WDIPSREUB.WDIRoot,MetaSolv.WDIPSREUB.WDIRootImpl
These parameters are modified by the install to contain a list of active servers.
Table A-1 describes the server parameters.
| Parameter | Description |
|---|---|
|
ASRSERVER, ASRnnSERVER |
This parameter starts the ASRnnSERVER for the ASR API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
CABSSERVER |
This parameter starts the CABSSERVER and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
DLRSERVER |
This parameter starts the DLR server for the Inventory and Capacity Management API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
PSREUBServer |
This parameter starts the PSREUBServer for the PSR End User Billing API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
INFRASTRUCTURESERVER |
This parameter starts the INFRASTRUCTURESERVER for the Infrastructure API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
JobQueueSERVER |
This parameter starts the Job Queue server and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
LSRSERVER |
This parameter starts the LSR server for the LSR API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
NISERVER |
This parameter starts the NI server for the Number Inventory API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
PSRANCILLIARYSERVER |
This parameter starts the PSRANCILLIARYSERVER for the PSR Ancillary API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
PSRSERVER |
This parameter starts the PSR server for the PSR API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
SOASERVER |
This parameter starts the SOASERVER for the Service Order Activation API and initializes it to the name service. This server is no longer used. To prevent this process from starting, comment out this line with a semicolon. |
|
TMSSERVER |
This parameter starts the TMSSERVER for the Trouble Management API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
|
WMSERVER |
This parameter starts the WM server for the Work Management API and initializes it to the name service. To prevent this process from starting, comment out this line with a semicolon. |
This section includes MetaSolv server processes that function like the APIs. These processes are related to transactions generated by other MetaSolv Solution components, such as gateway events from the MetaSolv Solution client or jobs from the Background Processor. These server processes receive information from other Oracle products instead of third-party applications. These ThreadProcs start when the Oracle WebLogic server starts.
Caution:
If the servers in the ThreadProcs section are missing or commented out, the Oracle WebLogic server does not start those servers. This can affect outbound gateway events, TNI Recall, system task processing, and other functions that use these servers. Do not disable a ThreadProcs server unless directed to do so by Oracle Global Customer Support.[ThreadProcs] ;INTEGRATIONSERVER=com.mslv.integration.integrationServer.S3Startup EVENTPROC=MetaSolv.eventServer.S3Startup EVENT2PROC=MetaSolv.event2Server.Event2ServerStartup SYSTEMTASKSERVERPROC=com.mslv.core.api.internal.WM.systemTaskServer. SystemTaskServer SIGNALSERVERPROC=com.metasolv.system.StartServer INTERNET_SIGNAL_SER VER=MetaSolv.CORBA.WDIINTERNETSERVICES.WDIRoot,MetaSolv.Sig nalServer.WDIInternetSignalServerRootImpl
These parameters are modified by the install to contain a list of active servers. See "Setting Up API Servers" for descriptions of active servers.
Table A-2 describes the TheadProcs Parameters.
Table A-2 ThreadProcs Parameters
| Parameters | Description |
|---|---|
|
INTEGRATIONSERVER |
Default: com.mslv.integration.integrationServer.S3Startup Valid values: com.mslv.integration.integrationServer.S3Startup Do not alter or remove this parameter. |
|
EVENTPROC |
Default: MetaSolv.eventServer.S3Startup Valid values: MetaSolv.eventServer.S3Startup This parameter starts the Gateway Event server process. The only acceptable value is MetaSolv.eventServer.S3Startup. If this parameter is present, the Oracle WebLogic server starts the Gateway Event server process when the Oracle WebLogic server starts. If this parameter is missing or is commented out, the Oracle WebLogic server does not start the Gateway Event server process and no inbound or outbound gateway events can be processed by the MetaSolv Solution APIs. Do not alter, remove, or comment out this parameter except as instructed by Oracle Global Customer Support. |
|
EVENT2PROC |
Default: MetaSolv.event2Server.Event2ServerStartup Valid values: MetaSolv.event2Server.Event2ServerStartup This parameter starts the PSR End User Billing server process. MetaSolv.event2Server.Event2ServerStartup is the only acceptable value. If this parameter is present, the Oracle WebLogic server starts the PSR End User Billing server process when the Oracle WebLogic server starts. If this parameter is missing or is commented out, the Oracle WebLogic server does not start the PSR End User Billing server process and no inbound or outbound gateway events can be processed by the MetaSolv Solution APIs. Do not alter, remove, or comment out this parameter except as instructed by Oracle Global Customer Support. |
|
SYSTEMTASKSERVERPROC |
Default: com.mslv.core.ap.internal.WM.systemTaskServer.SystemTaskServer Valid values: com.mslv.core.ap.internal.WM.systemTaskServer.SystemTaskServer This parameter starts the System Task server process. The only acceptable entry is com.mslv.core.ap.in ternal.WM.sys temTaskServer.SystemTaskServer. If this parameter is present, the Oracle WebLogic server starts the System Task server process when the Oracle WebLogic server starts. If this parameter is missing or is commented out, the Oracle WebLogic server does not start the System Task server process and no system tasks can be automatically completed by the MetaSolv Solution. Do not alter or remove this parameter. |
|
SIGNALSERVERPROC |
Default: com.metasolv.system.StartServerINTERNET_SIGNAL_SER VER=MetaSolv.CORBA.WDIINTERNETSERVICES.WDIRoot,MetaSolv.SignalServer.WDIInternetSignalServerRootImpl Valid values: com.metasolv.system.StartServer INTERNET_SIGNAL_SERVER=MetaSolv.CORBA.WDIINTERNETSERVICES.WDIRoot,MetaSolv.SignalServer.WDIInternetSignalServerRootImpl This parameter starts the SIGNALSERVERPROC server and initializes it to the name service. To prevent this process from starting, comment this line with a semicolon. Also may be referred to as the INTERNET_SIGNAL_SERVER. |
The OrbProperties section designates the port published in the API servers' CORBA IOR files. If this parameter is not set, jacORB will assign a dynamic port number at startup time.
Session parameters control the JDBC connection between the MetaSolv APIs and the Oracle database.
Table A-4 describes the session parameters.
| Parameter | Description |
|---|---|
|
User |
Default: app_api Valid values: app_api This is the (database) userid used to make connections to the database for the APIs. |
|
Password |
Default: none Valid values: A valid password This is the (database) password, for the APP_API user, that is used to make connections to the database for the API's. |
The gateway.ini system parameters provide general configuration for the MetaSolv APIs.
[System] ;URLNamingServicePort=15000 StartupMode=server;StartUp Mode - gui, batch, server Environment=prod;Environment - dev, test, prod DebugOn=false LoggingOn=true LogFileDir=D:/opt2/metasolv/mslv01/appserver/logs LogToFile=false LogToSystemOut=true AppendToLog=true IORPath=/opt2/metasolv/mslv01/appserver/ior TraceLevel=1 ;MaxThreads=1000
Table A-5 describes the system parameters.
| Parameter | Description |
|---|---|
|
URLNamingServicePort |
Default: 15000 Valid values: The port that provides the Naming Service object references using a URL. |
|
StartupMode |
Reserved for internal processing. Do not alter, remove, or comment out this parameter. |
|
Environment |
Default: Prod Valid values: Prod, dev, test Reserved for internal processing. Do not alter, remove, or comment out this parameter. |
|
DebugOn DebugLevel LoggingOn LogFileDir LogToFile LogToSystemOut AppendToLog TraceLevel |
Do not enter values for these parameters or remove them from the file. MetaSolv Solution application-specific logging uses a third-party software product (log4j) that is configured by setting properties in the Loggingconfig.xml file. Oracle WebLogic server logging can be controlled through the WebLogic Server Administration Console. See "Annotated Loggingconfig.xml" for more information on the Loggingconfig.xml file. |
|
IORPATH |
Default: /opt2/metasolv/mslv01/appserver/ior Valid values: A valid directory name The IORPath represents the physical location where the API server CORBA IOR files will be written when the Oracle WebLogic server is started. |
|
MaxThreads |
Default: 1000 Valid values: 1 to a system-specified maximum This specifies the maximum number of threads that the API server will use. |
This section specifies miscellaneous and internal configuration parameters.
[Gateway] PrintExportObjects=false JobQueueServer=JOB SERVER NAME;Background Processor Logical Name Timeout=601
Table A-6 describes the gateway parameters.
| Parameter | Description |
|---|---|
|
PrintExportObjects |
Default: False Valid values: True, False True causes extra logging. To improve performance, reset this parameter to False. This parameter causes the contents of CORBA container objects to be listed in Oracle Global Customer Support API logs, for debugging purposes. True specifies that the object state display be prior to client notification when exporting objects from the server to the client. False specifies no display of object state. |
|
JobQueueServer |
Used for internal processing. Do not alter, remove, or comment out these parameters. |
|
Server |
Used for internal processing. Do not alter, remove, or comment out these parameters. |
|
Timeout |
Used for internal processing. Do not alter, remove, or comment out these parameters. |
The Events parameters control operation of the Gateway Event server.
The following is how the Events section looks in the Gateway.ini file:
[Events] DBPollingInterval=30 DBPollingInterval_Srsi=60 DBPollingInterval_Serv=60 DBPollingInterval_Ge=60 DBPollingInterval_Genet=60 suspendCheckInterval=10 MaxThreads_Srsi=1 MaxThreads_Serv=1 MaxThreads_Ge=1 MaxThreads_Genet=1 maxCapacity_Srsi=500 maxCapacity_Serv=500 maxCapacity_Ge=500 maxCapacity_Genet=500 SuspendFileName=/opt2/metasolv/mslv01/appserver/suspendEventServer
Table A-7 describes the Events parameters.
| Parameter | Description |
|---|---|
|
DBPollingInterval |
Default: 30 (seconds) Valid values: number between 1second and 2 million seconds This parameter determines the number of seconds the Gateway event server allows to elapse before it polls the database for events to process. Setting this interval larger than a few minutes may adversely affect overall performance of the application and the API operations that involve gateway events. |
|
SuspendFileName |
Default: /opt2/metasolv/mslv01/appserver/suspendEventServer Valid values: a valid file name Disable this parameter if not needed. Identifies the path and name of a file you can use to signal the Gateway Event server to pause operation. Immediately prior to polling the database, the Gateway Event server checks for the existence of this file. If the file does not exist, the Gateway Event server polls the database, initiates needed work, then waits until the next scheduled poll. If the file exists, the Gateway Event server skips polling the database, then waits until the next scheduled poll. The server repeats this process at each scheduled polling interval as long as the file continues to exist. |
Caution:
While suspended, the Gateway Event server cannot process any incoming or outgoing gateway events. Suspending the Gateway Event server for more than a few minutes may adversely affect overall performance of MetaSolv Solution and MetaSolv Solution API operations that involve gateway events.The PSR End User Billing API uses the Event2 server process to send notifications to an external billing system.
[Event2] DBPollingInterval=30 SuspendFileName=/opt2/metasolv/mslv01/appserver/suspendEvent2Server
Table A-8 describes the Event2 server parameters.
| Parameter | Description |
|---|---|
|
DBPollingInterval |
Default: 30 (seconds) Valid values: a number between 1second and 2 million seconds This parameter determines the number of seconds which the Event2 server should allow to elapse before it polls the database for events to process. The default is 30 seconds. Setting this interval larger than a few minutes may adversely affect overall performance of MetaSolv Solution and MetaSolv Solution API operations that involve gateway events. |
|
SuspendFileName |
Default: /opt2/metasolv/mslv01/appserver/suspendEvent2Server Valid values: a valid file name Disable this parameter if not needed. This parameter identifies the path and filename of a file that you can use to signal the Event2 server that it should pause operation. Immediately prior to polling the database, the Event2 server checks for the existence of this file. The default filename is C:\MetaSolv\APPSERVER\suspendEvent2Server. If the file does not exist, the Event2 server polls the database, initiates any work that needs to be done, then waits until the next scheduled poll. If the file does exist, the Event2 server skips polling the database, then waits until the next scheduled poll. The server repeats this process at each scheduled polling interval as long as the file continues to exist. |
Caution:
While suspended, the PSR End User Billing server cannot process any gateway events.These parameters control operation of the Work Management system task server.
[WorkManagement] DbPollingInterval=120 MaxThreads=5 SystemTaskQueueMaxCapacity=2000 SuspendCheckInterval=5
Table A-9 describes the Work Management system task server parameters.
Table A-9 Work Management Parameters
| Parameter | Description |
|---|---|
|
DBPollingInterval |
Default: 120 (seconds) Valid value: number between 1second and 2 million seconds This parameter determines the number of seconds which the System Task server process should allow to elapse before it polls the database for new system tasks that should be processed. |
|
MaxThreads |
Default: 5 Valid value: 1 to system-specified maximum This parameter specifies the maximum size of the Thread Pool. When a new thread is requested, the Thread Pool checks its size to see if it is less than the MaxThreads parameter. If it is not less than the MaxThreads parameter, the thread pool will wait for a currently executing thread to finish before it creates a new thread. |
|
SuspendFileName |
Default: /opt2/metasolv/mslv01/appserver/suspendSystemTaskServer Valid value: A valid file name. This parameter identifies the path and filename of a file that you can use to signal the System Task server to pause operation. Immediately prior to polling the database, the System Task server checks for the existence of this file. If the file does not exist, the System Task server polls the database, initiates any work that needs to be done, then waits until the next scheduled poll. If the file does exist, the System Task server skips polling the database, then waits until the next scheduled poll. The server repeats this process at each scheduled polling interval as long as the file continues to exist. |
This section specifies the parameters used by the MetaSolv Web applications to connect to the EJB server which uses the Java Naming and Directory InterfaceTM (JNDI) to locate the remote MetaSolv EJB. In most cases, nothing should be changed in this section.
JNDI is a mechanism that provides Java applications with a unified interface to multiple naming and directory services.
Note:
If you change the password for the administration user or if you change the HTTP port for the server process, on the Oracle WebLogic server management console, you must also make the same changes in the JNDI section.
[JNDI]
User=administrator
Password={AES}1824a67ea02612bcbe3169d0b0d185b4
Factory=weblogic.jndi.WLInitialContextFactory
URL=http://srvsunpluto:7001
Local=true
Table A-10 describes the JNDI parameters.
| Parameter | Description |
|---|---|
|
User |
Default: Oracle WebLogic server admin user ID (user input from installer) Valid values: Oracle WebLogic server admin user ID (user input from installer) This is the administrator user that is created when running the WebLogic domain wizard to create the domain or single server. Change this parameter only if Oracle Global Customer Support recommends that you split your Web and EJB containers. |
|
Password |
Default: Oracle WebLogic server admin password (user input from installer) Valid values: Oracle WebLogic server admin password (user input from installer) This is the administrator password that is created when running the WebLogic domain wizard to create the domain or single server. The password can be changed from the WebLogic Administration Console. The administration server must be restarted after changing the password to enable the managed servers to connect with the new password. |
|
Factory |
Default: weblogic.jndi.WLInitialContextFactory Valid values: weblogic.jndi.WLInitialContextFactory The WebLogic factory class used to create the initial context object for accessing the WebLogic naming service. Change this parameter if you had in-house Java developers who subclassed WLInitialContextFactory to customize it. If you are running on an unsupported Oracle WebLogic server, use their context factory. Both of these are very unlikely scenarios and most users should use the default value. |
|
URL |
Default: t3://localhost:8001 Valid values: A valid URL The URL is used to locate the remote EJB container. Change this parameter if you are running the Oracle WebLogic server T3 service on a port other than 8001 or on a remote machine. A port other than 8001 is a common configuration setting. A machine other than localhost should only be used if MetaSolv recommends that you split your Web and EJB containers. |
The CA cache is used by the MetaSolv Solution application to retrieve, render, validate and update CAs. The CA cache consists of CA definitions and rules set up in the MetaSolv Solution Utilities application. Controlling caching provides better performance than directly accessing the database each time a set of CAs are rendered. CA changes made in MetaSolv Solution Utilities are not reflected in MetaSolv Solution until the CA cache has refreshed.
User-defined custom attributes are read and cached on the Oracle WebLogic server during server startup. This process may take several minutes to complete, depending on the amount of CA data.
The frequency of refreshing and caching is controlled by options in the gateway.ini file CA parameters. Depending on the amount of custom attribute data, the frequency of the caching refresh process can put an extra load on the database server and Oracle WebLogic server. You should determine how often the cache needs to be refreshed and set the options accordingly.
Note:
Oracle recommends daily updates, using the CacheRefreshHourOfDay parameter.Caching can be completely disabled by setting CacheDisable=true. If disabled, caching will not occur during Oracle WebLogic server startup and will not be refreshed even if CacheDisable is afterwards changed to false.
If CacheRefreshActive is set to true, the CacheRefreshMode parameter determines the frequency, either an hourly interval, once a day at a specific time, or once a week at a specific time.
[CA] CacheDisable=false CacheManagerClass=com.mslv.core.api.internal.ca.cache.broker.CacheManager CacheRefreshActive=true CacheRefreshMode=daily CacheRefreshDayOfWeek=6 CacheRefreshHourOfDay=23 CacheRefreshHourlyInterval=1
Using the default values mentioned above, the Oracle WebLogic server refreshes customer attributes daily at the 23rd hour of the day.
Table A-11 describes the CA parameters.
Table A-11 Custom Attribute Parameters
| Parameter | Description |
|---|---|
|
CacheDisable |
Default: false Valid values: true, false Determines whether or not the CA cache is built when the Oracle WebLogic server is started. If set to true, the CA cache is not built when the Oracle Robotic server is started. |
|
Cache Manager Class |
Default: com.mslv.core.api.internal.ca.cache.broker.CacheManager Valid values: com.mslv.core.api.internal.ca.cache.broker.CacheManager Do not change this parameter unless requested to do so by Oracle Global Customer Support. This is a java class name. |
|
Cache Refresh Active |
Default: true Valid values: true, false Determines whether or not the CA cache is refreshed on the Oracle Robotic server on a regular interval. If CacheDisable is false and CacheRefreshActive is true, the Oracle WebLogic server will rebuild the CA cache on an interval defined by the CacheRefreshMode parameter. |
|
CacheRefreshMode |
Default: hourly Valid values: hourly, daily, weekly Determines whether the CA cache is refreshed hourly, daily or weekly. If hourly, the cache is refreshed every x hours, where x is defined by the HourlyInterval parameter (Defaults to every hour). If daily, cache is refreshed every day on the x hour, where x is defined by the HourOfDay parameter. (Defaults to 2:00 p.m.). If weekly, cache is refreshed once a week on the day defined by the DayOfWeek parameter and on the hour defined by the HourOfDay parameter. (Defaults to Friday at 2:00 p.m.) |
|
CacheRefreshDayOfWeek |
Default: 6 Valid values: 1 - 7 The day of the week CA cache is refreshed when the CacheRefreshMode is set to weekly. Day 1 is Sunday, Day 2 is Monday... Day 7 is Saturday. |
|
CacheRefreshHourOfDay |
Default:23 Valid values: 0 - 23 The hour of day CA cache is refreshed when the CacheRefreshMode is set to daily or weekly. Hour 0 is 12:00 a.m. |
|
CacheRefreshHourlyInterval |
Default: 1 Valid values: 1 - 23 The hourly interval CA cache is refreshed when the CacheRefreshMode is set to hourly. Note: For testing purposes only, if you wish to have the cache refresh more frequently than hourly, you can set the HourlyInterval to a value between 300 and 1800. If set to a value of 300 - 1800, the cache handles the value as seconds. In other words, the cache will refresh anywhere between every 5 minutes to every 30 minutes. Do not set this value to 300 - 1800 in a production environment as it will impact performance. |
Users can customize the MetaSolv Solution desktop to display links to portlets. Portlets provide a convenient way to insert connections to other applications into the interface. A portlet uses pre-configured URL and parameters to retrieve the content from an application, then passes the content to the portlet. The default portal shipped with MetaSolv Solution contains several portlets, with the default portlet being the MetaSolv Welcome Page. When the users first logon or if the Customize User Level Portal preference is disabled, users see the default portlet on their desktops. The System Administrator can change the default portlet.
The initial default MetaSolv Solution ID is asap. When the MetaSolv Solution is first installed, only the superuser has access to the product, to Security, and to the Default Portal using the superuser ID and password.
If you have changed the DefaultPortalId and you want to upgrade, you must manually change the DefaultPortalId back to asap after the upgrade.
A custom extension enables you to extend Oracle Communications MetaSolv Solution functionality with additional business logic specific to your organization. In other words, extensions provide the ability to make calls to external systems and to send e-mail and JMS messages at predefined execution points, over and above the functionality supported by the MetaSolv Solution application and APIs.
[Custom] CLASSPATH=D:/opt2/metasolv/mslv01/appserver/samples/customExtension;