Process Manager Overview
The OpenSpirit framework provides access to multiple versions of a variety of geoscience data repositories. Each type of geoscience database has its own computing platform requirements that often change from one release version to the next. The computing platform required to access a particular data repository may differ from the computing platform used to run your application. The OpenSpirit framework enables these heterogeneous computing platforms to be bridged making it possible for your application to work with data that otherwise would not be accessible. This platform bridging requires the OpenSpirit framework to create processes on other computers in your company's network in order to work with data that is not accessible from your desktop computer.
Two types of processes are created by the OpenSpirit framework. They are data connector processes and process starter processes. These processes are created on demand when an OpenSpirit tool or an OpenSpirit enabled application needs to access a data repository. The processes run in the background with no user interface and end after some configurable period of inactivity. The Process Manager tool is used to monitor and control these background processes that are created by the OpenSpirit framework.
The Process Manager tool is accessed from the OpenSpirit Desktop by clicking the Process Manager tool bar icon or by choosing the Tools > Data Browser > Process Manager menu item. The Process Manager displays all of the background processes started by the OpenSpirit framework that is running. The Process Manager shows the processes that were created for the user that is running the OpenSpirit Desktop. The OpenSpirit Desktop shows processes that have been created for all OpenSpirit users when it is running from the OpenSpirit Runtime administrator account or if the desktop has been put in admin mode using the admin mode button
in the desktop tool bar. The OpenSpirit shared service process is also shown when running in admin mode.
The process list displayed by the Process Manager is not automatically refreshed. A refresh button is provided to force the Process Manager to update the process list to display the currently running processes.
The Name column in the process table displays the name given to the process by the OpenSpirit framework. Data connector process names include the name of the data source that it is connected to. Some data connector process names also include the name of a project if the data source does not permit a process to access multiple projects. Process starter processes all have the name Process Starter. The OpenSpirit shared services process appears with the name Shared Service.
The Host Name column shows the name of the computer that the process is running on. It may appear as an IP address during the PENDING stage of process startup.
The Username column shows the OpenSpirit username of the user that caused the process to start. This may or may not be the same as their computer login account name.
The Account Name column shows the computer login account being used to run the process. This is most often the OpenSpirit user's login account name, but may differ if a different account was used when configuring data source host and accounts using the OpenSpirit User Setup wizard.
The Log file path column shows the fully qualified name of the log file that the process is writing its log messages to. The log file path may not be directly accessible from the computer that your OpenSpirit desktop is running on. The log file path is a click able hyper- link. Clicking the path opens a window that displays the log file content and provides a button that can be used to save the log file in a folder of your choice.
The Start Time column shows the date and time that the process started.
The Process ID column shows the operating system process id of the process. This can be useful if you need to identify the process in the Microsoft Windows Task Manager or are using the UNIX ps
or top
command to monitor the process.
The Account Domain column displays the domain that the process account is defined in. Currently all accounts appear in Global Domain.
The State column provides an indication of the state of the process as it is starting. A process appears with a PENDING state between the time that it was requested to start and the time it has completed its startup initialization. Processes appear with an ACTIVE state once they are fully initialized and ready to respond to requests.
The Type column categorizes the processes. Data connector processes appear with type Data. Process starter processes appear with type User. The shared service process appears with type Shared. The type column is primarily provided to enable them to be grouped according to type by clicking the column header to sort by type.
The Dedicated To column is usually empty. The OpenSpirit framework provides the ability for an application to request a data connector that is dedicated for its use rather than sharing the data connector with other running applications. You may see something in this column when running the OpenSpirit Copy Manager to copy data into an OpenWorks or Studio data source. The value that appears the name of the copy job.