I have finally tested and tuned my obj.conf from the previous post on using the sed_request filter in Sun One/iPlanet Web Server 7 to provide some amount of SQL Injection and XSS protection. My final entry, which is added at the end of the Service entries in the default section of obj.conf is:
Input fn="insert-filter"
method="(GET|HEAD|POST)"
filter="sed-request"
sed="s/</\\</g"
sed="s/%3c/\\</g"
sed="s/%3C/\\</g"
sed="s/>/\\>/g"
sed="s/%3e/\\>/g"
sed="s/%3E/\\>/g"
sed="s/\x3C ?iframe//g"
sed="s/\\<src\\>[^a-zA-Z_0-9]*?\\<javascript://g"
sed="s/\\<src\\>[^a-zA-Z_0-9]*?\\<vbscript://g"
sed="s/\\<href\\>[^a-zA-Z_0-9]*?\\<javascript://g"
sed="s/\\<alert\\>[^a-zA-Z_0-9]*?\x28//g"
sed="s/\\<src\\>[^a-zA-Z_0-9]*?\\<http://g"
sed="s/\\<type\\>[^a-zA-Z_0-9]*?\\<text\\>[^a-zA-Z_0-9]*?\\<vbscript\\>//g"
sed="s/\\<href\\>[^a-zA-Z_0-9]*?\\<vbscript://g"
sed="s/\\<url\\>[^a-zA-Z_0-9]*?\\<javascript://g"
sed="s/\x3C ?script\\>//g"
sed="s/\\<type\\>[^a-zA-Z_0-9]*?\\<text\\>[^a-zA-Z_0-9]*?\\<javascript\\>//g"
sed="s/\\<url\\>[^a-zA-Z_0-9]*?\\<vbscript://g"
sed="s/(asfunction|javascript|vbscript|data|mocha|livescript)://g"
sed="s/(?i:<object[ /+\t].*?((type)|(codetype)|(classid)|(code)|(data))[ /+\t]*=)//g"
sed="s/(?i:[ /+\t\"\'`]datasrc[ +\t]*?=.)//g"
sed="s/(?i:<link[ /+\t].*?href[ /+\t]*=)//g"
sed="s/(?i:<meta[ /+\t].*?http-equiv[ /+\t]*=)//g"
sed="s/(?i:<embed[ /+\t].*?SRC.*?=)//g"
sed="s/(?i:[ /+\t\"\'`]on\x63\x63\x63+?[ +\t]*?=.)//g"
sed="s/(?i:<[i]?frame.*?[ /+\t]*?src[ /+\t]*=)//g"
sed="s/(?i:<isindex[ /+\t>])//g"
sed="s/(?i:<form.*?>)//g"
sed="s/(?i:<script.*?[ /+\t]*?src[ /+\t]*=)//g"
sed="s/(?i:<script.*?>)//g"
sed="s/\\<select\\>.{0,40}buser\\>//g"
sed="s/\\<select\\>.{0,40}\\<substring\\>//g"
sed="s/\\<select\\>.{0,40}\\<ascii\\>//g"
sed="s/\\<user_tables\\>//g"
sed="s/\\<user_tab_columns\\>//g"
sed="s/\\<all_objects\\>//g"
sed="s/\\<drop\\>//g"
sed="s/\\<substr\\>//g"
sed="s/\\<sysdba\\>//g"
sed="s/\\<user_password\\>//g"
sed="s/\\<user_users\\>//g"
sed="s/\\<user_constraints\\>//g"
sed="s/\\<column_name\\>//g"
sed="s/\\<substring\\>//g"
sed="s/\\<object_type\\>//g"
sed="s/\\<object_id\\>//g"
sed="s/\\<user_ind_columns\\>//g"
sed="s/\\<column_id\\>//g"
sed="s/\\<table_name\\>//g"
sed="s/\\<object_name\\>//g"
sed="s/\\<rownum\\>//g"
sed="s/\\<user_group\\>//g"
sed="s/\\<utl_http\\>//g"
sed="s/\\<select\\>.*?\\<to_number\\>//g"
sed="s/\\<group\\>.*\\<byb.{1,100}?\\<having\\>//g"
sed="s/\\<select\\>.*?\\<data_type\\>//g"
sed="s/\\<isnull\\>[^a-zA-Z_0-9]*?\x28//g"
sed="s/\\<union\\>.{1,100}?\\<select\\>//g"
sed="s/\\<insert\\>[^a-zA-Z_0-9]*?\\<into\\>//g"
sed="s/\\<select\\>.{1,100}?\\<count\\>.{1,100}?\\<from\\>//g"
sed="s/\x3B[^a-zA-Z_0-9]*?\\<drop\\>//g"
sed="s/\\<select\\>.*?\\<to_char\\>//g"
sed="s/\\<dbms_java\\>//g"
sed="s/\\<nvarchar\\>//g"
sed="s/\\<utl_file\\>//g"
sed="s/\\<inner\\>[^a-zA-Z_0-9]*?\\<join\\>//g"
sed="s/\\<select\\>.{1,100}?\\<from\\>.{1,100}?\\<where\\>//g"
sed="s/\\<intob[^a-zA-Z_0-9]*?\\<dumpfile\\>//g"
sed="s/\\<delete\\>[^a-zA-Z_0-9]*?\\<from\\>//g"
sed="s/\x3B[^a-zA-Z_0-9]*?\\<shutdown\\>//g"
sed="s/\\<dba_users\\>//g"
sed="s/\\<select\\>.{1,100}?\\<top\\>.{1,100}?\\<from\\>//g"
Don't forget to import the changes into the repository for it to be effective!
Monday 13 September 2010
Sunday 5 September 2010
How JavaEE is implemented in WLS - Services
Oracle WebLogic Server Internal Services
When people think of JavaEE application servers they tend to think of the JavaEE interfaces and publicly accessible subsystems such as the web container, EJB container, Java Transaction Service, Java Message Service, etc. However, to provide these publicly accessible subsystems and services a large number of “invisible” services, subsystems and components must come together. To provide enterprise level services a number of operating system-like facilities must be used to manage thread pooling, memory, logging, communications in such a way to provide enterprise level qualities of service, integration and scalability. If you look carefully at Oracle WebLogic Server, WebSphere Application Server, or even JBoss these underlying services can be seen, although they aren't meant to be accessible from application code and are only for use by the underlying system software that provides the JavaEE interfaces. This article aims to explain what some of these services are, and how they are managed, integrated and used by the application server interfaces seen by applications. We will look at individual services and how they are related in future articles, but for this article we will look at the group of services with a particular set of interrelationships designed to be started and managed as part of the T3 Server services.
Understanding services and what they mean requires some detective work. The application server exposes their operation, at least for all of those that aren't primordial (i.e. those that are pre-started before the subsystems that allow them to be observed and controlled) , for advanced adminstrators to see. Operation of those started by T3 can be seen by enabling debug logging for an instance of “Server Life Cycle” events in the Admin Server console, although it is important to realise that this doesn't show all services. The additional logging does have considerable overhead so don't do this on a production server!
Start up the Node Manager (startNodeManager.sh) and the server instance hosting the Admin Server (startWebLogic.sh) and after logging in click on the Environments branch link in the Domain Structure tree control on the left side of console main page, followed by the Server link. This will bring up a list of servers, so select the one being monitored by clicking on its link and select the Configuration tab.
When setting the configuration click the Logging subtab followed by the Advanced container link towards the bottom of the page. In this container, for the log file and standard output change the settings to log debug messages. First change the minimum severity to log section to tell the environment that it is in debug mode.
Next setup the destinations for the log entries to ensure we have some output to examine.
Once the settings have been change click on the “Save” button to commit the changes. Next select the Debug tab at the top of the page. For this we need to tell the application server instance which subsystems we want the debug messages to be logged for, in our case the T3Srvr ServerLifeCycle monitoring and the time taken for each subsystem to process the requests.
The page will, by default, contain two sub-trees; “default” and “weblogic”. In our case we want the “weblogic” sub-tree so click on it and look down towards the bottom of the tree and open the “t3” branch followed by “srvr” and click on the check boxes for “DebugServerLifeCycle” and “DebugServerStartStatistics”. Next click on the “Enable” button.
When the process is complete, return to the Domain Structure tree control, Environment tree and Servers sub-tree and click on the target server whose configuration was just changed and click on “Shutdown” followed by “Start”, leaving the “Admin Server” last to process. When the application server instance restarts it will log the subsystems and services being started in each mode to the application server log and the JVM process standard output. We can collect these from the user_projects/domains and target domain servers/<SERVER_NAME>/logs directory and examine them.
If we examine just the ServerLifeCycle entries in the standard output file we will see that the Oracle WebLogic Server runtime makes use of a considerable number of base underlying services to provide the support needed for the containers. The file will have entries similar to the following, but a large number of them.
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <Time taken to start
weblogic.diagnostics.lifecycle.DiagnosticFoundationService: 1157 ms>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <creating service: weblogic.nodemanager.NMService>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <starting service: weblogic.nodemanager.NMService>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <Time taken to start weblogic.nodemanager.NMService: 136 ms>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <creating service: weblogic.timers.internal.TimerService>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <starting service: weblogic.timers.internal.TimerService>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <Time taken to start weblogic.timers.internal.TimerService: 16 ms>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <creating service: weblogic.rjvm.RJVMService>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <starting service: weblogic.rjvm.RJVMService>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <Time taken to start weblogic.rjvm.RJVMService: 224 ms>
<03-Apr-2010 19:33:11 o'clock BST> <Debug> <ServerLifeCycle> <BEA-000000> <creating service: weblogic.protocol.ProtocolService>
...
Whilst this mechanism shows some of the services that underpin the application server instance, it won't show all of them started outside of that being monitored, the class dependences (i.e. where service classes make use of other classes) and it also won't show the detailed interfaces between these classes. So, we need to use the Java investigators tool of choice – reflection. We will also need to use JVM verbose class output to log each class and where it is loaded from. This produces a large amount of logged information that makes using the application server instance itself for anything useful problematic, but by filtering the
information carefully before examining it in depth we can get just the detailed information we need. For our reflection we simply use the same classpath as our application instance did, which can be seen from the command line and startup batch files, and load a class that reflects on each class name that appears in the verbose class output.
When the verbose class logging is enabled (-verbose:class on the JVM command line) an entry appears in the JVM standard output showing the details of each class loaded and which file on the file system it was loaded on. First the JVM classes load, but eventually entries appear referring to the application server classes, e.g.
...
[Loaded weblogic.Server from file:/home/colin/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.jar]
[Loaded java.io.FileFilter from /home/colin/Oracle/Middleware/jdk160_14_R27.6.5-32/jre/lib/rt.jar]
[Loaded java.net.MalformedURLException from /home/colin/Oracle/Middleware/jdk160_14_R27.6.5-32/jre/lib/rt.jar]
[Loaded java.lang.AssertionError from /home/colin/Oracle/Middleware/jdk160_14_R27.6.5-32/jre/lib/rt.jar]
[Loaded weblogic.management.DomainDirConstants from file:/home/colin/Oracle/Middleware/modules/com.bea.core.management.core_2.5.0.0.jar]
[Loaded weblogic.management.DomainDir from file:/home/colin/Oracle/Middleware/modules/com.bea.core.management.core_2.5.0.0.jar]
[Loaded weblogic.management.bootstrap.BootStrapConstants from file:/home/colin/Oracle/Middleware/modules/com.bea.core.management.core_2.5.0.0.jar]
[Loaded weblogic.management.bootstrap.BootStrapMin from file:/home/colin/Oracle/Middleware/modules/com.bea.core.management.core_2.5.0.0.jar]
[Loaded weblogic.management.bootstrap.BootStrap from file:/home/colin/Oracle/Middleware/modules/com.bea.core.management.core_2.5.0.0.jar]
[Loaded weblogic.Home from file:/home/colin/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.jar]
[Loaded weblogic.Home$HomeSingleton from file:/home/colin/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.jar]
...
We need to filter out the entries relating to the application server from those for the JDK and filter out any other unrelated information. On a Unix type system we simply use “grep” to filter only the entries starting “[Loaded “ and then only those that include the application server installation path, in this case “file:/home/colin/Oracle/Middleware/wlserver_10.3” or “file:/home/colin/Oracle/Middleware/modules”.
To get the information to reflect upon we now need to cut out the class names to be loaded using “cut -d ' ' -f2” and pipe it to a file. We then merely create a class to do the reflection and load it using the classpath used to load WLS itself, i.e. we need to use the classpath and other JVM parameters that starts the WebLogic.Server class and its main entry point from startWebLogic.sh:
/opt/Oracle/Middleware/jdk160_14_R27.6.5-32/bin/java -client -Xms256m -Xmx512m -XX:CompileThreshold=8000 -XX:PermSize=48m -XX:MaxPermSize=128m -Dweblogic.Name=AdminServer -Djava.security.policy=/home/colin/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.policy -Xverify:none -da -Dplatform.home=/opt/Oracle/Middleware/wlserver_10.3 -Dwls.home=/opt/Oracle/Middleware/wlserver_10.3/server -Dweblogic.home=/opt/Oracle/Middleware/wlserver_10.3/server -Dweblogic.management.discover=true -Dwlw.iterativeDev= -Dwlw.testConsole= -Dwlw.logErrorsToConsole= -Dweblogic.ext.dirs=/opt/Oracle/Middleware/patch_wls1032/profiles/default/sysext_manifest_classpath:/opt/Oracle/Middleware/patch_jdev1111/profiles/default/sysext_manifest_classpath weblogic.Server
Our class doing the reflection should look something like the following, and to this we pass the output from our filtered class list above:
import java.io.*;
import java.lang.reflect.*;
public class ShowClassFile {
public static void main(String[] args) {
if (args.length == 2) {
BufferedReader reader;
FileWriter writer;
String testClassName;
try {
reader = new BufferedReader(new FileReader(new File(args[0])));
writer = new FileWriter(args[1]);
while ((testClassName = reader.readLine()) != null) {
try {
Class test = Class.forName(testClassName);
String location;
if (test.getClassLoader() != null) {
location = "Class loaded from: " +
test.getProtectionDomain().getCodeSource().getLocation();
} else {
location = "System Classloader loaded class from: " +
test.getClassLoader().getResource(testClassName);
}
// Write the details of the class out to a file
printClassInfo(test, location, writer);
location=null;
test=null;
} catch (ClassNotFoundException e) {
System.out.println("Couldn't find class: " + args[0]);
}
testClassName = null;
writer.flush();
}
reader.close();
writer.close();
} catch (FileNotFoundException e) {
System.out.println("Input or output files not found");
} catch (IOException e) {
System.out.println("An IOException has occured writing to the file");
}
}
else {
System.out.println("Usage:ShowClassFile objectlistfile outputdetailsfile");
}
}
public static void printClassInfo(Class clazz, String location,
FileWriter writer) throws IOException {
writer.write("\n\n*******************************************************\n");
writer.write("Class Name: " + clazz.getName() + "\n");
writer.write(location + "\n");
writer.write("Superclass:" + clazz.getSuperclass() + "\n");
writer.write("\nInterfaces:\n***********\n");
writer.write("\nMethods:\n*********\n");
Method[] methods = clazz.getMethods();
for (int idx=0; idx < methods.length; idx++)
writer.write(methods[idx] + "\n");
writer.write("\nFields:\n*******\n");
Field[] fields = clazz.getFields();
for (int idx2=0; idx2 < fields.length; idx2++)
writer.write(fields[idx2] + "\n");
writer.write("\n*************************************\n\n\n");
writer.flush();
fields=null;
methods=null;
}
}
...
This gives us detailed output like the following:
*******************************************************
Class Name: weblogic.Server
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:class java.lang.Object
Interfaces:
***********
Methods:
*********
public static void weblogic.Server.main(java.lang.String[])
public java.lang.String weblogic.Server.toString()
public static boolean weblogic.Server.isRedefineClassesSupported()
public static java.lang.String weblogic.Server.getUsage()
public final native void java.lang.Object.wait(long) throws java.lang.InterruptedException
public final void java.lang.Object.wait(long,int) throws java.lang.InterruptedException
public final void java.lang.Object.wait() throws java.lang.InterruptedException
public native int java.lang.Object.hashCode()
public final native java.lang.Class java.lang.Object.getClass()
public boolean java.lang.Object.equals(java.lang.Object)
public final native void java.lang.Object.notify()
public final native void java.lang.Object.notifyAll()
Fields:
*******
public static final java.lang.String weblogic.Server.WEBLOGIC_INSTRUMENTATION_PROPERTY
public static final java.lang.String weblogic.Server.DIAGNOSTIC_PRE_PROCESSOR_CLASS
public static final java.lang.String weblogic.Server.WEBLOGIC_INSTRUMENTATION_SERVER_SCOPE
public static final java.lang.String weblogic.Server.CLASSLOADER_PREPROCESSOR
...
*******************************************************
Class Name: weblogic.server.AbstractServerService
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/modules/com.bea.core.weblogic.lifecycle_1.3.0.0.jar
Superclass:class java.lang.Object
Interfaces:
***********
Methods:
*********
public java.lang.String weblogic.server.AbstractServerService.getName()
public void weblogic.server.AbstractServerService.start() throws weblogic.server.ServiceFailureException
public void weblogic.server.AbstractServerService.stop() throws weblogic.server.ServiceFailureException
public void weblogic.server.AbstractServerService.halt() throws weblogic.server.ServiceFailureException
public java.lang.String weblogic.server.AbstractServerService.getVersion()
public final native void java.lang.Object.wait(long) throws java.lang.InterruptedException
public final void java.lang.Object.wait(long,int) throws java.lang.InterruptedException
public final void java.lang.Object.wait() throws java.lang.InterruptedException
public native int java.lang.Object.hashCode()
public final native java.lang.Class java.lang.Object.getClass()
public boolean java.lang.Object.equals(java.lang.Object)
public java.lang.String java.lang.Object.toString()
public final native void java.lang.Object.notify()
public final native void java.lang.Object.notifyAll()
Fields:
*******
public static final java.lang.String weblogic.server.ServerService.EJB
public static final java.lang.String weblogic.server.ServerService.JMS
public static final java.lang.String weblogic.server.ServerService.CONNECTOR
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN
public static final int weblogic.server.ServerStates.SRVR_STARTING
public static final int weblogic.server.ServerStates.SRVR_RUNNING
public static final int weblogic.server.ServerStates.SRVR_STANDBY
public static final int weblogic.server.ServerStates.SRVR_SUSPENDING
public static final int weblogic.server.ServerStates.SRVR_FORCE_SUSPENDING
public static final int weblogic.server.ServerStates.SRVR_RESUMING
public static final int weblogic.server.ServerStates.SRVR_SHUTTING_DOWN
public static final int weblogic.server.ServerStates.SRVR_FAILED
public static final int weblogic.server.ServerStates.SRVR_UNKNOWN
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN_PENDING
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN_IN_PROCESS
public static final int weblogic.server.ServerStates.SRVR_FAILED_RESTARTING
public static final int weblogic.server.ServerStates.SRVR_ACTIVATE_LATER
public static final int weblogic.server.ServerStates.SRVR_FAILED_NOT_RESTARTABLE
public static final int weblogic.server.ServerStates.SRVR_FAILED_MIGRATABLE
public static final int weblogic.server.ServerStates.SRVR_DISCOVERED
public static final int weblogic.server.ServerStates.SRVR_ADMIN
public static final int weblogic.server.ServerStates.SRVR_FORCE_SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN
public static final java.lang.String weblogic.server.ServerStates.STARTING
public static final java.lang.String weblogic.server.ServerStates.RUNNING
public static final java.lang.String weblogic.server.ServerStates.STANDBY
public static final java.lang.String weblogic.server.ServerStates.ADMIN
public static final java.lang.String weblogic.server.ServerStates.SUSPENDING
public static final java.lang.String weblogic.server.ServerStates.FORCE_SUSPENDING
public static final java.lang.String weblogic.server.ServerStates.RESUMING
public static final java.lang.String weblogic.server.ServerStates.SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.FORCE_SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.FAILED
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN_PENDING
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN_IN_PROCESS
public static final java.lang.String weblogic.server.ServerStates.UNKNOWN
public static final java.lang.String weblogic.server.ServerStates.DISCOVERED
public static final java.lang.String weblogic.server.ServerStates.FAILED_RESTARTING
public static final java.lang.String weblogic.server.ServerStates.ACTIVATE_LATER
public static final java.lang.String weblogic.server.ServerStates.FAILED_NOT_RESTARTABLE
public static final java.lang.String weblogic.server.ServerStates.FAILED_MIGRATABLE
public static final java.lang.String[] weblogic.server.ServerStates.SERVERSTATES
*************************************
...
The output from this shows us that there are a large number of classes that offer services, in that they subclass the AbstractServerService, but that not each is shown in the server life cycle output. The AbstractServerService class exposes getName(), getVersion(), start(), stop(), and halt() methods and we will see later that it is these methods that allow the Service Manager to control the state of the underlying services. The list of services run for a typical Oracle WebLogic Server instance, which can change with configuration, is below:
| Service | Phase/State |
|---|---|
| weblogic.server.ServiceActivator | Primordial |
| weblogic.t3.srvr.PreConfigBootService | Primordial |
| weblogic.management.provider.internal.BeanInfoAccessService | Primordial |
| weblogic.management.provider.PropertyService | Primordial |
| weblogic.management.internal.DomainDirectoryService | Primordial |
| weblogic.management.provider.MSIService | Primordial |
| weblogic.upgrade.domain.DomainUpgradeServerService | Primordial |
| weblogic.deploy.service.internal.DeploymentService | Primordial |
| weblogic.deploy.service.internal.adminserver.AdminDeploymentService | Primordial |
| weblogic.deploy.service.internal.targetserver.TargetDeploymentService | Primordial |
| weblogic.deploy.internal.targetserver.datamanagement.ConfigRecoveryService | Primordial |
| weblogic.management.provider.internal.RuntimeAccessDeploymentReceiverService | Primordial |
| weblogic.management.provider.internal.RuntimeAccessService | Primordial |
| weblogic.management.mbeanservers.runtime.internal.DiagnosticSupportService | Primordial |
| weblogic.t3.srvr.LicenseService | Primordial |
| weblogic.t3.srvr.BootService | Primordial |
| weblogic.management.provider.internal.WorkManagerService | Primordial |
| weblogic.management.provider.internal.DomainAccessService | Primordial |
State: STARTING
| Service | Phase/State |
|---|---|
| weblogic.diagnostics.lifecycle.DiagnosticFoundationService | STARTING |
| weblogic.nodemanager.NMService | STARTING |
| weblogic.timers.internal.TimerService | STARTING |
| weblogic.rjvm.RJVMService | STARTING |
| weblogic.protocol.ProtocolService | STARTING |
| weblogic.server.channels.ChannelService | STARTING |
| weblogic.socket.SocketMuxerServerService | STARTING |
| weblogic.server.channels.AdminPortService | STARTING |
| weblogic.t3.srvr.ListenerService | STARTING |
| weblogic.transaction.internal.PrimordialTransactionService | STARTING |
| weblogic.rmi.internal.RMIServerService | STARTING |
| weblogic.jndi.internal.NamingService | STARTING |
| weblogic.iiop.IIOPClientService | STARTING |
| weblogic.diagnostics.lifecycle.DiagnosticInstrumentationService | STARTING |
| weblogic.ldap.EmbeddedLDAP | STARTING |
| weblogic.security.SecurityService | STARTING |
| weblogic.jndi.internal.RemoteNamingService | STARTING |
| weblogic.security.acl.internal.RemoteSecurityService | STARTING |
| weblogic.rmi.cluster.RemoteBinderFactoryService | STARTING |
| weblogic.cluster.leasing.databaseless.DatabaseLessLeasingService | STARTING |
| weblogic.cluster.ClusterServiceActivator | STARTING |
| weblogic.cluster.leasing.databaseless.PrimordialClusterLeaderService | STARTING |
| weblogic.jndi.internal.ForeignJNDIManagerService | STARTING |
| weblogic.iiop.IIOPService | STARTING |
| weblogic.protocol.ProtocolHandlerService | STARTING |
| weblogic.xml.registry.XMLService | STARTING |
| weblogic.messaging.interception.MessageInterceptionService | STARTING |
| weblogic.cluster.migration.rmiservice.MigratableRMIService | STARTING |
| weblogic.management.provider.internal.EditAccessService | STARTING |
| weblogic.management.mbeanservers.compatibility.internal.CompatibilityMBeanServerService | STARTING |
| weblogic.health.HealthMonitorService | STARTING |
| weblogic.cluster.singleton.MigratableServerService | STARTING |
| weblogic.cluster.migration.MigrationService | STARTING |
| weblogic.t3.srvr.T3InitializationService | STARTING |
| weblogic.jms.dotnet.t3.server.CSharpInitializationService | STARTING |
| weblogic.server.channels.ChannelRuntimeService | STARTING |
| weblogic.transaction.internal.TransactionRecoveryFailBackService | STARTING |
| weblogic.transaction.internal.TransactionRecoveryNoOpService | STARTING |
| weblogic.store.admin.DefaultStoreService | STARTING |
| weblogic.transaction.internal.TransactionService | STARTING |
| weblogic.jdbc.common.internal.JDBCService | STARTING |
| weblogic.store.admin.StoreDeploymentService | STARTING |
| weblogic.management.extension.internal.CustomResourceServerService | STARTING |
| weblogic.ejb.container.deployer.EJB20ServiceActivator | STARTING |
| weblogic.connector.common.ConnectorServiceActivator | STARTING |
| weblogic.messaging.interception.configuration.Configurator | STARTING |
| weblogic.jms.JMSServiceActivator | STARTING |
| weblogic.application.ApplicationShutdownService | STARTING |
| weblogic.io.common.internal.FileService | STARTING |
| weblogic.time.server.TimerService | STARTING |
| weblogic.rmi.internal.HeartbeatHelperService | STARTING |
| weblogic.jms.BridgeService | STARTING |
| weblogic.jms.saf.SAFService | STARTING |
| weblogic.servlet.internal.WebService | STARTING |
| weblogic.webservice.conversation.internal.ConversationServiceImpl | STARTING |
| weblogic.wtc.gwt.WTCServerLifeCycleImpl | STARTING |
| weblogic.webservice.WSServerService | STARTING |
| weblogic.wsee.wstx.internal.WSATTransactionService | STARTING |
| weblogic.management.mbeanservers.runtime.internal.RuntimeServerService | STARTING |
| weblogic.management.mbeanservers.edit.internal.EditServerService | STARTING |
| weblogic.management.mbeanservers.domainruntime.internal.DomainRuntimeServerService | STARTING |
| weblogic.management.deploy.classdeployment.ClassDeploymentService | STARTING |
| weblogic.server.ServerLifeCycleService | STARTING |
| weblogic.server.channels.EnableAdminListenersService | STARTING |
| weblogic.management.provider.internal.ConfigImageSourceService | STARTING |
| weblogic.messaging.path.PathService | STARTING |
| weblogic.diagnostics.snmp.server.SNMPAgentDeploymentService | STARTING |
| weblogic.management.deploy.internal.DeploymentPreStandbyServerService | STARTING |
State: STANDBY
State: STARTING
State: START BEFORE ADMIN STATE
| Service | Phase/State |
|---|---|
| weblogic.transaction.internal.TransactionRecoveryService | START BEFORE ADMIN STATE |
| weblogic.scheduler.JobSchedulerBindingService | START BEFORE ADMIN STATE |
| weblogic.server.AdminServerListenerService | START BEFORE ADMIN STATE |
| weblogic.messaging.saf.internal.SAFServerService | START BEFORE ADMIN STATE |
| weblogic.management.deploy.internal.DeploymentServerService | START BEFORE ADMIN STATE |
| weblogic.diagnostics.lifecycle.DiagnosticSystemService | START BEFORE ADMIN STATE |
| weblogic.transaction.internal.PostLoggingResourceService | START BEFORE ADMIN STATE |
| weblogic.management.deploy.classdeployment.StartupClassPrelistenService | START BEFORE ADMIN STATE |
| weblogic.management.internal.ConfigurationAuditorService | START BEFORE ADMIN STATE |
| weblogic.cluster.InboundService | START BEFORE ADMIN STATE |
| weblogic.t3.srvr.CoreHealthService | START BEFORE ADMIN STATE |
| weblogic.management.deploy.classdeployment.ShutdownClassDeploymentService | START BEFORE ADMIN STATE |
| weblogic.diagnostics.snmp.server.SNMPService | START BEFORE ADMIN STATE |
| weblogic.diagnostics.harvester.HarvesterService | START BEFORE ADMIN STATE |
| weblogic.console.internal.ConsoleMBeanService | START BEFORE ADMIN STATE |
| weblogic.management.j2ee.internal.InternalAppDataCacheService | START BEFORE ADMIN STATE |
| weblogic.management.provider.internal.ConfigBackupService | START BEFORE ADMIN STATE |
| weblogic.t3.srvr.EnableListenersIfAdminChannelAbsentService | START BEFORE ADMIN STATE |
| weblogic.management.mbeanservers.runtime.internal.RegisterWithDomainRuntimeServiceEarly | START BEFORE ADMIN STATE |
| weblogic.application.internal.BackgroundDeploymentService | START BEFORE ADMIN STATE |
| weblogic.cluster.singleton.PreAdminSingletonServicesService | START BEFORE ADMIN STATE |
| weblogic.cluster.leasing.databaseless.ClusterLeaderService | START BEFORE ADMIN STATE |
State: ADMIN
State: RESUMING
| Service | Phase/State |
|---|---|
| weblogic.management.deploy.internal.DeploymentPostAdminServerService | START AFTER ADMIN STATE |
| weblogic.scheduler.JobSchedulerService | START AFTER ADMIN STATE |
| weblogic.cluster.replication.ReplicationService | START AFTER ADMIN STATE |
| weblogic.cluster.singleton.SingletonServicesBatchManager | START AFTER ADMIN STATE |
| weblogic.t3.srvr.EnableListenersService | START AFTER ADMIN STATE |
| weblogic.management.mbeanservers.runtime.internal.RegisterWithDomainRuntimeServiceLate | START AFTER ADMIN STATE |
| weblogic.cluster.OutboundService | START AFTER ADMIN STATE |
| weblogic.rmi.internal.RMIShutdownService | START AFTER ADMIN STATE |
| weblogic.transaction.internal.ClientInitiatedTxShutdownService | START AFTER ADMIN STATE |
| weblogic.servlet.internal.WebAppShutdownService | START AFTER ADMIN STATE |
| weblogic.rmi.internal.NonTxRMIShutdownService | START AFTER ADMIN STATE |
| weblogic.deploy.service.internal.adminserver.HeartbeatService | START AFTER ADMIN STATE |
| weblogic.application.internal.BackgroundDeploymentService$WaitForBackgroundCompletion | START AFTER ADMIN STATE |
| weblogic.cache.management.CacheServerService | START AFTER ADMIN STATE |
| weblogic.management.internal.OCMService | START AFTER ADMIN STATE |
| weblogic.ejb.container.deployer.MDBServiceActivator | START AFTER ADMIN STATE |
| weblogic.ejb.container.timer.EJBTimerStarterActivator | START AFTER ADMIN STATE |
| weblogic.jms.JMSServicePostDeploymentImpl | START AFTER ADMIN STATE |
State: RUNNING
Each one of these services starts at some phase of the startup of the server. This is necessary because services can be dependent upon one another and some may only be necessary to bootstrap other later starting services. Similarly, the startup of the server has a number of phases that take place to allow its integration into the cluster and domain environment. Some services need to load in order to bootstrap the rest of the environment so these are simply described as primordial. The SERVERSTATES string array in the AbstractServerService is used to define the states the server instance passes through and it is these that define what operations are in play by the service at any one time. The server mode and state changes are generally written to the server logs.
The server phases are as follows:
An instance can be in Shutdown mode (i.e. not started), Failed mode, Standby mode, Admin mode or Running mode, with a carefully coordinated set of transitions between each mode that leads to the Shutting Down, Starting, Suspending and Resuming transient pseudo modes. With each mode and transition different services that form part of the core functionality of the Oracle WebLogic Server are started and stopped.
Now we understand something about the number and types of services and what defines them, we need to understand how they are started and controlled and how this enables them to provide an infrastructure on which the rest of the application server functionality is built. The key to this is the ServiceGraph definition of a service which defines groupings of services to start at a particular phase in order to support particular functionality, and the ServiceActivator and ServerServiceManager classes that perform the underlying control. To understand this a little more we need to look a little deeper at the classes and how they are loaded.
We mentioned that we are looking at a particular category of services designed to be loaded in a particular way and that have a specific set of interrelationships which we have alluded to above. If we “grep” the list of classes loaded by WLS we see particular groupings just after the main entry point of the application server, the WebLogic.Server main() method in weblogic.jar, is called. The main function of the webLogic.Server beyond starting the background bootstrap processing is to get the T3Srvr class which is the core “backbone” of the application server started. If we force a failure during startup just as the services are being started we can see the mechanism used here and where to focus on.
Start a WLS instance and enter an incorrect user id and password such that the configuration can't be read.
This gives a stack trace in the output log that shows a little about the internal architecture and shows how the services are started.
<Jan 24, 2010 4:26:52 PM GMT> <Info> <WebLogicServer> <BEA-000377> <Starting WebLogic Server with BEA JRockit(R) Version R27.6.2-20_o-
108500-1.6.0_05-20090120-1115-linux-ia32 from BEA Systems, Inc.>
<Jan 24, 2010 4:26:55 PM GMT> <Info> <Security> <BEA-090065> <Getting boot identity from user.>
Enter username to boot WebLogic server:weblogic
Enter password to boot WebLogic server:
<Jan 24, 2010 4:27:07 PM GMT> <Info> <Management> <BEA-141107> <Version: WebLogic Server 10.3.1.0 Thu Jun 11 00:26:56 EDT 2009 1227385 >
<Jan 24, 2010 4:27:07 PM GMT> <Critical> <WebLogicServer> <BEA-000362> <Server failed. Reason:
There are 1 nested errors:
weblogic.management.ManagementException: [Management:141247]The configuration directory /opt/Oracle/Middleware/wlserver_10.3/common/bin/config does not exist and the admin server is not available.
at weblogic.management.provider.internal.RuntimeAccessImpl.parseNewStyleConfig(RuntimeAccessImpl.java:200)
at weblogic.management.provider.internal.RuntimeAccessImpl.<init>(RuntimeAccessImpl.java:115)
at weblogic.management.provider.internal.RuntimeAccessService.start(RuntimeAccessService.java:41)
at weblogic.t3.srvr.ServerServicesManager.startService(ServerServicesManager.java:461)
at weblogic.t3.srvr.ServerServicesManager.startInStandbyState(ServerServicesManager.java:166)
at weblogic.t3.srvr.T3Srvr.initializeStandby(T3Srvr.java:749)
at weblogic.t3.srvr.T3Srvr.startup(T3Srvr.java:488)
at weblogic.t3.srvr.T3Srvr.run(T3Srvr.java:446)
at weblogic.Server.main(Server.java:67)
>
<Jan 24, 2010 4:27:07 PM GMT> <Notice> <WebLogicServer> <BEA-000365> <Server state changed to FAILED>
<Jan 24, 2010 4:27:07 PM GMT> <Error> <WebLogicServer> <BEA-000383> <A critical service failed. The server will shut itself down>
<Jan 24, 2010 4:27:07 PM GMT> <Notice> <WebLogicServer> <BEA-000365> <Server state changed to FORCE_SHUTTING_DOWN>
So, the weblogic.Server main() method creates a T3Srvr class, which we can derive from other
investigation is a singleton at the core of WLS, and calls its run() method. This new thread running the method in turn calls the startup() method which takes WLS through its different states of startup and in the first phase this delegates to the initializeStandby() method to get the instance into the Standby state. It is here that we see the mechanism used to control our services. A ServerServicesManager class is created and its startInStandbyState() method is called. Here we see the RunTimeAccessService start() method called which initializes the application server against its configuration locally or from information directed by the AdminServer.
If we return to our list of classes we can see some of this functionality in operation.
After the T3Srvr class loads we see some related classes being loaded.
[Loaded weblogic.t3.srvr.T3Srvr from file:/home/colin/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.jar]
[Loaded weblogic.security.spi.Resource from file:/home/colin/Oracle/Middleware/modules/com.bea.core.common.security.api_1.0.0.0_5-2-0-0.jar]
[Loaded weblogic.server.ServerLifecycleException from file:/home/colin/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.jar]
[Loaded weblogic.t3.srvr.T3SrvrConsole from file:/home/colin/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.jar]
[Loaded weblogic.utils.ErrorCollectionException from file:/home/colin/Oracle/Middleware/modules/com.bea.core.utils_1.7.0.0.jar]
[Loaded weblogic.server.ServiceFailureException from file:/home/colin/Oracle/Middleware/modules/com.bea.core.weblogic.lifecycle_1.3.0.0.jar]
[Loaded weblogic.security.subject.SubjectStack from file:/home/colin/Oracle/Middleware/modules/com.bea.core.weblogic.security.identity_1.1.2.0.jar]
[Loaded weblogic.security.subject.SubjectManager from file:/home/colin/Oracle/Middleware/modules/com.bea.core.weblogic.security.identity_1.1.2.0.jar]
[Loaded weblogic.security.service.SubjectManagerImpl from file:/home/colin/Oracle/Middleware/modules/com.bea.core.weblogic.security.wls_1.0.0.0_5-2-0-
0.jar]
[Loaded java.security.AccessControlException from /home/colin/Oracle/Middleware/jdk160_14_R27.6.5-32/jre/lib/rt.jar]
[Loaded weblogic.common.T3ServicesDef from file:/home/colin/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.jar]
The T3Srvr handles the initialization of some security features and creates a T3SrvrConsole to wait for instructions, such as to shut down, and then a ServiceFailureException class is loaded from com.bea.core.weblogic.lifecycle_1.3.0.0.jar in the modules directory. This Jar file is one that has changed in version between 10.3 releases as it has some involvement in service control. Then we see the T3ServicesDef class being loaded from weblogic.jar. If we look at our reflected class information we gained earlier we can see that the T3Srvr class makes this class available for use by other classes via its public interface:
If we look at the T3ServicesDef class we can see that its public interface exposes particular categories of service types, i.e. via the NameServicesDef, LogServicesDef, TimeServicesDef, JdbcServicesDef, AdminServicesDef, and IOServicesDef classes.
*******************************************************
Class Name: weblogic.common.T3ServicesDef
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:null
Interfaces:
***********
Methods:
*********
public abstract weblogic.common.NameServicesDef weblogic.common.T3ServicesDef.name()
public abstract weblogic.common.LogServicesDef weblogic.common.T3ServicesDef.log()
public abstract weblogic.time.common.TimeServicesDef weblogic.common.T3ServicesDef.time()
public abstract weblogic.jdbc.common.JdbcServicesDef weblogic.common.T3ServicesDef.jdbc()
public abstract weblogic.common.AdminServicesDef weblogic.common.T3ServicesDef.admin()
public abstract weblogic.io.common.IOServicesDef weblogic.common.T3ServicesDef.io()
Fields:
*******
public static final java.lang.String weblogic.common.T3ServicesDef.NAME
If look at these classes we see more information, but also immediately after we see the T3ServerServices class load that refers to these and can deduce that the T3ServerServices class, in addition to any other function, is a facade for the T3Srvr class to manage and expose these classes of services.
*******************************************************
Class Name: weblogic.common.AdminServicesDef
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:null
Interfaces:
***********
Methods:
*********
public abstract void weblogic.common.AdminServicesDef.threadDump() throws java.lang.Exception
public abstract java.lang.String weblogic.common.AdminServicesDef.lockServer(java.lang.String) throws java.lang.Exception
public abstract java.lang.String weblogic.common.AdminServicesDef.unlockServer() throws java.lang.Exception
public abstract java.lang.String weblogic.common.AdminServicesDef.ping(byte[]) throws java.lang.Exception
public abstract java.lang.String weblogic.common.AdminServicesDef.shut(int) throws java.lang.Exception
public abstract java.lang.String weblogic.common.AdminServicesDef.shut() throws java.lang.Exception
public abstract java.lang.String weblogic.common.AdminServicesDef.shut(java.lang.String,int) throws java.lang.Exception
public abstract java.lang.String weblogic.common.AdminServicesDef.cancelShut() throws java.lang.Exception
public abstract java.lang.String weblogic.common.AdminServicesDef.licenses() throws java.lang.Exception
public abstract java.lang.String weblogic.common.AdminServicesDef.version() throws java.lang.Exception
public abstract void weblogic.common.AdminServicesDef.enableWatchDog(int) throws java.lang.Exception
public abstract void weblogic.common.AdminServicesDef.disableWatchDog() throws java.lang.Exception
Fields:
*******
*************************************
*******************************************************
Class Name: weblogic.jdbc.common.JdbcServicesDef
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:null
Interfaces:
***********
Methods:
*********
public abstract void weblogic.jdbc.common.JdbcServicesDef.resetPool(java.lang.String) throws java.lang.Exception
public abstract void weblogic.jdbc.common.JdbcServicesDef.shrinkPool(java.lang.String) throws java.lang.Exception
Fields:
*******
*************************************
*******************************************************
Class Name: weblogic.time.common.TimeServicesDef
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:null
Interfaces:
***********
Methods:
*********
public abstract long weblogic.time.common.TimeServicesDef.currentTimeMillis() throws weblogic.common.T3Exception
public abstract weblogic.time.common.ScheduledTriggerDef
weblogic.time.common.TimeServicesDef.getScheduledTrigger(weblogic.time.common.Schedulable,weblogic.time.common.Triggerable) throws
weblogic.time.common.TimeTriggerException
public abstract weblogic.time.common.ScheduledTriggerDef
weblogic.time.common.TimeServicesDef.getScheduledTrigger(weblogic.time.common.Scheduler,weblogic.time.common.Trigger) throws
weblogic.time.common.TimeTriggerException
public abstract int weblogic.time.common.TimeServicesDef.getRoundTripDelayMillis() throws weblogic.common.T3Exception
public abstract int weblogic.time.common.TimeServicesDef.getLocalClockOffsetMillis() throws weblogic.common.T3Exception
Fields:
*******
*************************************
*******************************************************
Class Name: weblogic.common.NameServicesDef
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:null
Interfaces:
***********
Methods:
*********
public abstract javax.naming.Context weblogic.common.NameServicesDef.getInitialContext() throws javax.naming.NamingException
public abstract javax.naming.Context weblogic.common.NameServicesDef.getInitialContext(java.util.Hashtable) throws javax.naming.NamingException
public abstract void weblogic.common.NameServicesDef.private_setT3Client(weblogic.common.T3Client)
Fields:
*******
*************************************
*******************************************************
Class Name: weblogic.t3.srvr.T3ServerServices
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:class java.lang.Object
Interfaces:
***********
Methods:
*********
public weblogic.common.NameServicesDef weblogic.t3.srvr.T3ServerServices.name()
public weblogic.common.LogServicesDef weblogic.t3.srvr.T3ServerServices.log()
public long weblogic.t3.srvr.T3ServerServices.currentTimeMillis() throws weblogic.common.T3Exception
public weblogic.time.common.TimeServicesDef weblogic.t3.srvr.T3ServerServices.time()
public weblogic.jdbc.common.JdbcServicesDef weblogic.t3.srvr.T3ServerServices.jdbc()
public void weblogic.t3.srvr.T3ServerServices.threadDump()
public java.lang.String weblogic.t3.srvr.T3ServerServices.lockServer(java.lang.String)
public java.lang.String weblogic.t3.srvr.T3ServerServices.unlockServer()
public weblogic.common.AdminServicesDef weblogic.t3.srvr.T3ServerServices.admin()
public weblogic.io.common.IOServicesDef weblogic.t3.srvr.T3ServerServices.io()
public javax.naming.Context weblogic.t3.srvr.T3ServerServices.getInitialContext() throws javax.naming.NamingException
public javax.naming.Context weblogic.t3.srvr.T3ServerServices.getInitialContext(java.util.Hashtable) throws javax.naming.NamingException
public void weblogic.t3.srvr.T3ServerServices.private_setT3Client(weblogic.common.T3Client)
public weblogic.time.common.ScheduledTriggerDef
weblogic.t3.srvr.T3ServerServices.getScheduledTrigger(weblogic.time.common.Schedulable,weblogic.time.common.Triggerable)
public weblogic.time.common.ScheduledTriggerDef
weblogic.t3.srvr.T3ServerServices.getScheduledTrigger(weblogic.time.common.Scheduler,weblogic.time.common.Trigger) throws
weblogic.time.common.TimeTriggerException
public int weblogic.t3.srvr.T3ServerServices.getRoundTripDelayMillis() throws weblogic.common.T3Exception
public int weblogic.t3.srvr.T3ServerServices.getLocalClockOffsetMillis() throws weblogic.common.T3Exception
public void weblogic.t3.srvr.T3ServerServices.resetPool(java.lang.String)
public void weblogic.t3.srvr.T3ServerServices.shrinkPool(java.lang.String)
public java.lang.String weblogic.t3.srvr.T3ServerServices.ping(byte[])
public java.lang.String weblogic.t3.srvr.T3ServerServices.shut(int) throws weblogic.server.ServerLifecycleException
public java.lang.String weblogic.t3.srvr.T3ServerServices.shut() throws weblogic.server.ServerLifecycleException
public java.lang.String weblogic.t3.srvr.T3ServerServices.shut(java.lang.String,int) throws weblogic.server.ServerLifecycleException
public java.lang.String weblogic.t3.srvr.T3ServerServices.cancelShut()
public java.lang.String weblogic.t3.srvr.T3ServerServices.licenses()
public java.lang.String weblogic.t3.srvr.T3ServerServices.version()
public void weblogic.t3.srvr.T3ServerServices.enableWatchDog(int)
public void weblogic.t3.srvr.T3ServerServices.disableWatchDog()
public final native void java.lang.Object.wait(long) throws java.lang.InterruptedException
public final void java.lang.Object.wait(long,int) throws java.lang.InterruptedException
public final void java.lang.Object.wait() throws java.lang.InterruptedException
public native int java.lang.Object.hashCode()
public final native java.lang.Class java.lang.Object.getClass()
public boolean java.lang.Object.equals(java.lang.Object)
public java.lang.String java.lang.Object.toString()
public final native void java.lang.Object.notify()
public final native void java.lang.Object.notifyAll()
Fields:
*******
public static final java.lang.String weblogic.common.T3ServicesDef.NAME
*************************************
If we return to what we learned from our stack dump where the T3Srvr was starting the services it used the ServerServicesManager class to stop and start the service we looked at. If we look at our reflected information for this and the classes loaded immediately before it and after it we can see how the services themselves are started via delegation.
*******************************************************
Class Name: weblogic.t3.srvr.ServerServices
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:null
Interfaces:
***********
Methods:
*********
Fields:
*******
public static final java.lang.String weblogic.t3.srvr.ServerServices.STANDBY_STATE
public static final java.lang.String weblogic.t3.srvr.ServerServices.ADMIN_STATE
public static final weblogic.server.servicegraph.ServiceDependencies weblogic.t3.srvr.ServerServices.WLS_DEPENDENCIES
public static final java.lang.String[] weblogic.t3.srvr.ServerServices.SERVICE_CLASS_NAMES
public static final java.util.List weblogic.t3.srvr.ServerServices.services
public static final weblogic.server.servicegraph.Service[] weblogic.t3.srvr.ServerServices.serviceArray
public static final weblogic.server.servicegraph.Service[] weblogic.t3.srvr.ServerServices.ORDERED_SUBSYSTEM_LIST
*************************************
*******************************************************
Class Name: weblogic.t3.srvr.ServerServicesManager
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:class java.lang.Object
Interfaces:
***********
Methods:
*********
public static int weblogic.t3.srvr.ServerServicesManager.getServicesCount()
public static void weblogic.t3.srvr.ServerServicesManager.addRunningStateListener(weblogic.server.RunningStateListener)
public static weblogic.t3.srvr.ServerServicesManager$StartupSnapshot weblogic.t3.srvr.ServerServicesManager.getStartupSnapshot()
public final native void java.lang.Object.wait(long) throws java.lang.InterruptedException
public final void java.lang.Object.wait(long,int) throws java.lang.InterruptedException
public final void java.lang.Object.wait() throws java.lang.InterruptedException
public native int java.lang.Object.hashCode()
public final native java.lang.Class java.lang.Object.getClass()
public boolean java.lang.Object.equals(java.lang.Object)
public java.lang.String java.lang.Object.toString()
public final native void java.lang.Object.notify()
public final native void java.lang.Object.notifyAll()
Fields:
*******
public static final java.lang.String weblogic.t3.srvr.ServerServices.STANDBY_STATE
public static final java.lang.String weblogic.t3.srvr.ServerServices.ADMIN_STATE
public static final weblogic.server.servicegraph.ServiceDependencies weblogic.t3.srvr.ServerServices.WLS_DEPENDENCIES
public static final java.lang.String[] weblogic.t3.srvr.ServerServices.SERVICE_CLASS_NAMES
public static final java.util.List weblogic.t3.srvr.ServerServices.services
public static final weblogic.server.servicegraph.Service[] weblogic.t3.srvr.ServerServices.serviceArray
public static final weblogic.server.servicegraph.Service[] weblogic.t3.srvr.ServerServices.ORDERED_SUBSYSTEM_LIST
*************************************
*******************************************************
Class Name: weblogic.server.ServerStates
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/modules/com.bea.core.weblogic.lifecycle_1.3.0.0.jar
Superclass:null
Interfaces:
***********
Methods:
*********
Fields:
*******
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN
public static final int weblogic.server.ServerStates.SRVR_STARTING
public static final int weblogic.server.ServerStates.SRVR_RUNNING
public static final int weblogic.server.ServerStates.SRVR_STANDBY
public static final int weblogic.server.ServerStates.SRVR_SUSPENDING
public static final int weblogic.server.ServerStates.SRVR_FORCE_SUSPENDING
public static final int weblogic.server.ServerStates.SRVR_RESUMING
public static final int weblogic.server.ServerStates.SRVR_SHUTTING_DOWN
public static final int weblogic.server.ServerStates.SRVR_FAILED
public static final int weblogic.server.ServerStates.SRVR_UNKNOWN
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN_PENDING
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN_IN_PROCESS
public static final int weblogic.server.ServerStates.SRVR_FAILED_RESTARTING
public static final int weblogic.server.ServerStates.SRVR_ACTIVATE_LATER
public static final int weblogic.server.ServerStates.SRVR_FAILED_NOT_RESTARTABLE
public static final int weblogic.server.ServerStates.SRVR_FAILED_MIGRATABLE
public static final int weblogic.server.ServerStates.SRVR_DISCOVERED
public static final int weblogic.server.ServerStates.SRVR_ADMIN
public static final int weblogic.server.ServerStates.SRVR_FORCE_SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN
public static final java.lang.String weblogic.server.ServerStates.STARTING
public static final java.lang.String weblogic.server.ServerStates.RUNNING
public static final java.lang.String weblogic.server.ServerStates.STANDBY
public static final java.lang.String weblogic.server.ServerStates.ADMIN
public static final java.lang.String weblogic.server.ServerStates.SUSPENDING
public static final java.lang.String weblogic.server.ServerStates.FORCE_SUSPENDING
public static final java.lang.String weblogic.server.ServerStates.RESUMING
public static final java.lang.String weblogic.server.ServerStates.SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.FORCE_SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.FAILED
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN_PENDING
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN_IN_PROCESS
public static final java.lang.String weblogic.server.ServerStates.UNKNOWN
public static final java.lang.String weblogic.server.ServerStates.DISCOVERED
public static final java.lang.String weblogic.server.ServerStates.FAILED_RESTARTING
public static final java.lang.String weblogic.server.ServerStates.ACTIVATE_LATER
public static final java.lang.String weblogic.server.ServerStates.FAILED_NOT_RESTARTABLE
public static final java.lang.String weblogic.server.ServerStates.FAILED_MIGRATABLE
public static final java.lang.String[] weblogic.server.ServerStates.SERVERSTATES
*************************************
*******************************************************
Class Name: weblogic.server.ServerService
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/modules/com.bea.core.weblogic.lifecycle_1.3.0.0.jar
Superclass:null
Interfaces:
***********
Methods:
*********
public abstract java.lang.String weblogic.server.ServerService.getName()
public abstract void weblogic.server.ServerService.start() throws weblogic.server.ServiceFailureException
public abstract void weblogic.server.ServerService.stop() throws weblogic.server.ServiceFailureException
public abstract void weblogic.server.ServerService.halt() throws weblogic.server.ServiceFailureException
public abstract java.lang.String weblogic.server.ServerService.getVersion()
Fields:
*******
public static final java.lang.String weblogic.server.ServerService.EJB
public static final java.lang.String weblogic.server.ServerService.JMS
public static final java.lang.String weblogic.server.ServerService.CONNECTOR
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN
public static final int weblogic.server.ServerStates.SRVR_STARTING
public static final int weblogic.server.ServerStates.SRVR_RUNNING
public static final int weblogic.server.ServerStates.SRVR_STANDBY
public static final int weblogic.server.ServerStates.SRVR_SUSPENDING
public static final int weblogic.server.ServerStates.SRVR_FORCE_SUSPENDING
public static final int weblogic.server.ServerStates.SRVR_RESUMING
public static final int weblogic.server.ServerStates.SRVR_SHUTTING_DOWN
public static final int weblogic.server.ServerStates.SRVR_FAILED
public static final int weblogic.server.ServerStates.SRVR_UNKNOWN
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN_PENDING
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN_IN_PROCESS
public static final int weblogic.server.ServerStates.SRVR_FAILED_RESTARTING
public static final int weblogic.server.ServerStates.SRVR_ACTIVATE_LATER
public static final int weblogic.server.ServerStates.SRVR_FAILED_NOT_RESTARTABLE
public static final int weblogic.server.ServerStates.SRVR_FAILED_MIGRATABLE
public static final int weblogic.server.ServerStates.SRVR_DISCOVERED
public static final int weblogic.server.ServerStates.SRVR_ADMIN
public static final int weblogic.server.ServerStates.SRVR_FORCE_SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN
public static final java.lang.String weblogic.server.ServerStates.STARTING
public static final java.lang.String weblogic.server.ServerStates.RUNNING
public static final java.lang.String weblogic.server.ServerStates.STANDBY
public static final java.lang.String weblogic.server.ServerStates.ADMIN
public static final java.lang.String weblogic.server.ServerStates.SUSPENDING
public static final java.lang.String weblogic.server.ServerStates.FORCE_SUSPENDING
public static final java.lang.String weblogic.server.ServerStates.RESUMING
public static final java.lang.String weblogic.server.ServerStates.SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.FORCE_SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.FAILED
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN_PENDING
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN_IN_PROCESS
public static final java.lang.String weblogic.server.ServerStates.UNKNOWN
public static final java.lang.String weblogic.server.ServerStates.DISCOVERED
public static final java.lang.String weblogic.server.ServerStates.FAILED_RESTARTING
public static final java.lang.String weblogic.server.ServerStates.ACTIVATE_LATER
public static final java.lang.String weblogic.server.ServerStates.FAILED_NOT_RESTARTABLE
public static final java.lang.String weblogic.server.ServerStates.FAILED_MIGRATABLE
public static final java.lang.String[] weblogic.server.ServerStates.SERVERSTATES
*************************************
*******************************************************
Class Name: weblogic.management.runtime.ServerStates
Class loaded from: file:/home/colin/Oracle/MiddlewareJDev/wlserver_10.3/server/lib/weblogic.jar
Superclass:null
Interfaces:
***********
Methods:
*********
Fields:
*******
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN
public static final int weblogic.server.ServerStates.SRVR_STARTING
public static final int weblogic.server.ServerStates.SRVR_RUNNING
public static final int weblogic.server.ServerStates.SRVR_STANDBY
public static final int weblogic.server.ServerStates.SRVR_SUSPENDING
public static final int weblogic.server.ServerStates.SRVR_FORCE_SUSPENDING
public static final int weblogic.server.ServerStates.SRVR_RESUMING
public static final int weblogic.server.ServerStates.SRVR_SHUTTING_DOWN
public static final int weblogic.server.ServerStates.SRVR_FAILED
public static final int weblogic.server.ServerStates.SRVR_UNKNOWN
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN_PENDING
public static final int weblogic.server.ServerStates.SRVR_SHUTDOWN_IN_PROCESS
public static final int weblogic.server.ServerStates.SRVR_FAILED_RESTARTING
public static final int weblogic.server.ServerStates.SRVR_ACTIVATE_LATER
public static final int weblogic.server.ServerStates.SRVR_FAILED_NOT_RESTARTABLE
public static final int weblogic.server.ServerStates.SRVR_FAILED_MIGRATABLE
public static final int weblogic.server.ServerStates.SRVR_DISCOVERED
public static final int weblogic.server.ServerStates.SRVR_ADMIN
public static final int weblogic.server.ServerStates.SRVR_FORCE_SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN
public static final java.lang.String weblogic.server.ServerStates.STARTING
public static final java.lang.String weblogic.server.ServerStates.RUNNING
public static final java.lang.String weblogic.server.ServerStates.STANDBY
public static final java.lang.String weblogic.server.ServerStates.ADMIN
public static final java.lang.String weblogic.server.ServerStates.SUSPENDING
public static final java.lang.String weblogic.server.ServerStates.FORCE_SUSPENDING
public static final java.lang.String weblogic.server.ServerStates.RESUMING
public static final java.lang.String weblogic.server.ServerStates.SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.FORCE_SHUTTING_DOWN
public static final java.lang.String weblogic.server.ServerStates.FAILED
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN_PENDING
public static final java.lang.String weblogic.server.ServerStates.SHUTDOWN_IN_PROCESS
public static final java.lang.String weblogic.server.ServerStates.UNKNOWN
public static final java.lang.String weblogic.server.ServerStates.DISCOVERED
public static final java.lang.String weblogic.server.ServerStates.FAILED_RESTARTING
public static final java.lang.String weblogic.server.ServerStates.ACTIVATE_LATER
public static final java.lang.String weblogic.server.ServerStates.FAILED_NOT_RESTARTABLE
public static final java.lang.String weblogic.server.ServerStates.FAILED_MIGRATABLE
public static final java.lang.String[] weblogic.server.ServerStates.SERVERSTATES
*************************************
This set of classes controls how the individual component services are grouped, started, stopped and managed with all of their dependencies, such as which services are dependent on others having been started. This is better explained with a class diagram, with the ServerServicesManager as the core.
The ServerServicesManager implements the ServerServices interface. The ServerServices interface has the ORDERED_SUBSYSTEM_LIST list of services which essentially contains the groupings of the services that are to be started that underpin the application server subsystems, and an enumeration of the dependencies that each needs to start. The ORDERED_SUBSYSTEM_LIST relates to the WLS_DEPENDENCIES which is a reference to the ServerServicesDependencies.
The ServerServicesDependencies contains sets of ServiceGroups, where each ServiceGroup relates to the services that underpin a particular subsystem, e.g. an EJBServiceGroup, a JMSServiceGroup, etc, and an internal CoreServiceGroup set of services that underpin everything else. The ServerServicesDependencies class is a subclass of the ServiceDependencies class that handles some of the ServiceGroup functionality but also some of the high level dependency management.
A ServiceGroup is composed of sets of services represented by the Service class, which maintains the list of dependencies, predecessors, and successors of each service, and it is this that controls the order of service startup. The Service class has a reference to a ServiceActivator class reference for the given service, and it is this that exposes the getName(), getVersion(), start(), stop(), and halt() methods used by the ServerServicesManager to start and stop each service.
The ServiceActivator class inherits the methods and the states from the AbstractServerService
class, and ServerService and ServerStates interfaces. This brings us back to the starting point for our investigation since it is the AbstractServerService class that the services we investigated inherited from.
Whilst the startup mechanism above is complex, it allows configurations where subsystems can be removed and services stopped where they aren't needed as all of the different dependencies are represented. The control for these configurations is handled by another Jar file in the modules directory that we will cover in a future post.
In other future posts we will look in more detail at what some of the core services do, and also at the flow through key containers, such as the web container, and how the services are used to provide the JavaEE functionality
Subscribe to:
Posts (Atom)