This appendix provides a reference to the Oracle Event Processing Deployer
utility, which you can use to deploy Oracle Event Processing applications.
This appendix includes the following sections:
The Deployer
utility is a Java-based deployment utility that provides administrators and developers command-line based operations for deploying Oracle Event Processing applications. In the context of Oracle Event Processing deployment, an application is defined as an OSGi bundle at http://www.osgi.org/
JAR file that contains the following artifacts:
The compiled Java class files that implement some of the components of the application, such as the adapters, adapter factory, and POJO that contains the business logic.
One or more Oracle Event Processing configuration XML files that configure the components of the application, such as the processor, adapter, or streams.
The configuration files must be located in the META-INF/wlevs
directory of the OSGi bundle JAR file.
An EPN assembly file that describes all the components of the application and how they are connected to each other. The EPN assembly file extends the standard Spring context file.
The EPN assembly file must be located in the META-INF/spring
directory of the OSGi bundle JAR file.
A MANIFEST.MF
file that describes the contents of the JAR.
See Oracle Fusion Middleware Developing Applications for Oracle Event Processing for information about creating this deployment bundle.
The Deployer utility uses HTTP to connect to Oracle Event Processing, which means that you must configure Jetty for the server instance to which you are deploying your application. See Oracle Fusion Middleware Administering Oracle Event Processing.
Oracle Event Processing uses the deployments.xml
file to internally maintain its list of deployed application OSGi bundles. This file is located in the DOMAIN_DIR/servername
directory, where DOMAIN_DIR
refers to the main domain directory corresponding to the server instance to which you are deploying your application and servername
refers to the server instance itself.
Caution:
The XSD for the deployments.
xml file is provided for your information only. Oracle does not recommend updating the deployments.xml
file manually.
Before you can use the Deployer utility, you must configure your environment appropriately.
Configure the Deployer utility environment:
CLASSPATH
variable to include the wlevsdeploy.jar JAR
file, located in the /Oracle/Middleware/my_oep/
oep/bin
directory.Sometimes it is useful to run the Deployer
utility on a computer different from the computer on which Oracle Event Processing is installed and running.
Run the Deployer utility remotely:
The syntax for using the Deployer utility is as follows:
java -jar wlevsdeploy.jar [Connection Arguments] [User Credential Arguments] [Deployment Commands]
The following sections describe the various arguments and commands you can use with the Deployer utility. See Deployer Utility Examples for specific examples of using the utility.
Table B-1 lists the connection arguments you can specify with the Deployer utility.
Table B-1 Connection Arguments
Argument | Description |
---|---|
-url url
|
Specifies the URL to the Deployer utility for the Oracle Event Processing instance to which you want to deploy the OSGI bundle. The URL takes the following form: http://host:port/wlevsdeployer where:
For example, if Oracle Event Processing is running on host http://ariel:9002/wlevsdeployer |
Table B-2 lists the user credential arguments you can specify with the Deployer utility.
Table B-2 User Credential Arguments
Argument | Description |
---|---|
-user username
|
User name of the Oracle Event Processing administrator. If you supply the |
-password password
|
Password of the Oracle Event Processing administrator. NOTE: this argument is deprecated and may be removed in a later release. Oracle recommends that you do not use this argument. |
Table B-3 lists the deployment commands you can specify with the Deployer utility.
Table B-3 Deployment Commands
Command | Description |
---|---|
-encrypt |
Encrypts the user name and password and writes it to output file. |
-encryptoutfile encryptoutfile
|
Specifies that encryptoutfile should be used to write encrypted the user and password. |
-group groupname
|
Specifies that the deploy command (install, uninstall, update, suspend, or resume) applies to a target group, or more specifically, to the set of running servers within that group. To specify the domain group, use the keyword -group all To specify a custom group, simply specify the name of the group: -group my_group Note: You may only deploy to a group if the server is part of a multiserver domain (that is, if clustering is enabled). You may not deploy to a group if the server is part of a standalone-server domain (that is, if clustering is disabled). For more information, see About Multiserver Domains. |
-help |
Prints a message describe command syntax and arguments. |
-install bundle
|
Installs the specified OSGi bundle to the specified Oracle Event Processing instance. The Be sure to specify the full pathname of the bundle if it is not located relative to the directory from which you are running the Deployer utility. In particular, Oracle Event Processing:
|
-resume name
|
Resumes a previously suspended OSGI bundle on the specified Oracle Event Processing instance; the configured adapters once again start immediately receiving incoming data. The Bundle-SymbolicName: myApp |
-status name
|
Returns status information about a currently installed OSGi bundle. The Bundle-SymbolicName: myApp |
-suspend name
|
Suspends a currently running OSGI bundle which was previously installed to the specified Oracle Event Processing instance. The Bundle-SymbolicName: myApp |
-uninstall name
|
Removes the existing bundle from the specified Oracle Event Processing instance. The Bundle-SymbolicName: myApp In particular, Oracle Event Processing:
|
-update bundle
|
Updates the existing OSGi bundle with new application code. The Be sure to specify the full pathname of the bundle if it is not located relative to the directory from which you are running the Deployer utility. In particular, Oracle Event Processing:
|
-userconfigfile userconfigfile
|
Specifies that userconfigfile (security-config.xml) should be used to retrieve encrypted user name and password from the file. |
-userkeyfile userkeyfile
|
Specifies that userkeyfile (.msainternal.dat) should be used to get the encryption key used to encrypt the password in the user |
The following examples show how to use the Deployer utility. In all the examples, Oracle Event Processing is running on host ariel
, listening at port 9002
, and the user name/password of the server administrator is oepadmin/welcome1
, respectively. For clarity, the examples are shown on multiple lines; however, when you run the command, enter all arguments and commands on a single line.
java -jar wlevsdeploy.jar -url http://ariel:9002/wlevsdeployer -user wlevs -password wlevs -install /application/bundles/com.my.exampleApp_1.0.0.0.jar
The preceding example shows how to install an OSGi bundle called com.my.exampleApp_1.0.0.0.jar
, located in the /application/bundles
directory.
The next command shows how to resume this application after it has been suspended:
java com.bea.wlevs.deployment.Deployer -url http://ariel:9002/wlevsdeployer -user wlevs -password wlevs -resume exampleApp
The next example shows how to uninstall the application, which removes all traces of it from the domain directory:
java com.bea.wlevs.deployment.Deployer -url http://ariel:9002/wlevsdeployer -user wlevs -password wlevs -uninstall exampleApp
The following example shows how to install an application called strategies_1.0.jar
to the strategygroup
; this example also shows how to use the -jar
command of the java
utility:
java -jar wlevsdeploy.jar -url http://ariel:9002/wlevsdeployer -install strategies_1.0.jar -group strategygroup