Siebel System Administration Guide > Configuring Siebel Servers > Advanced Configuration Tasks >

Reconfiguring Siebel Server Component Definitions

Component reconfiguration is a process that allows existing component tasks to continue running until they finish, while starting new processes with reconfigured component parameter values. Each component can be reconfigured, but this is primarily done for multithreaded Siebel Server components.

Component reconfiguration is particularly useful for scenarios such as site migration. In this scenario, component reconfiguration allows you to maintain the existing component configuration, which remains available until the migration is complete and a new component configuration becomes available.

When a component reconfiguration is committed, this action sends a signal to every Siebel Server in the Siebel Enterprise Server signifying that a new component definition is available, and not to start any new tasks for that component. Existing tasks, however, continue to run until completion. The connected Siebel Servers then launch a number of new processes for the component using the new parameter values read from the Siebel Gateway Name Server. The number of new processes is governed by the parameter Minimum MT Servers (alias MinMTServers). Because old and new processes for the component are both running, there may be a significant increase in the number of multithreaded processes running on the Siebel Server machines.

NOTE:  Previous component tasks not affected by the component reconfiguration can continue to run for a very long time; therefore, the multithreaded process hosting the task continues to run and occupy task slots in shared memory.

Run component definition reconfiguration at times when the server component workload is low; that is, when the component's existing tasks or sessions are few in number. This scenario allows existing tasks or sessions to end while the new tasks, in addition to the previous tasks, do not exhaust system resources.

NOTE:  Parameters set at the individual component level are not affected by component definition reconfiguration unless the parameter override is deleted on that parameter.

For information on running the server component definition reconfiguration procedure from the command-line interface, see Reconfiguring Component Definition Commands.

Before reconfiguring Siebel Server components, make sure that:

• All Siebel Servers running the server component designated for reconfiguration are running; this check makes sure server components receive the reconfigured parameter values.
• Any external resources accessed by current tasks running on the existing component configuration remain available.
• Any external resources defined in the new component configuration are available.

Examples of external resources include the SRF and configuration files that are defined in the component configuration.

To reconfigure Siebel Server components

1. Navigate to Administration-Server Configuration screen, Enterprises, and then the Component Definitions view.
2. In the Component Definitions list, select the component definition you want to reconfigure.
3. Click the menu button and then click Start Reconfiguration.

   The Definition State field changes to Reconfiguring.

4. In the lower Component Definitions list, change the Value field of parameters that you want to reconfigure for the component.

   You can also change the values of fixed parameters, but you cannot change whether parameters are fixed.

5. After parameter values have been reconfigured, commit the new configuration by clicking the menu button and then clicking Commit Reconfiguration.

   The new parameter values will be merged at the enterprise level. To cancel the reconfiguration before it has been committed, click the menu button and then Cancel Reconfiguration.