This chapter provides information about configuring deployment settings. You configure settings in Oracle WebLogic to ensure that individual Oracle Communications Design Studio users can deploy to run-time environments, and to enable SSL (secure sockets layer) on the WebLogic server. Additionally, you can define settings that determine how the deployment messages appear in the Console view.
Note:
The procedures described in this chapter assume that you are using the WebLogic security realm. See the Oracle WebLogic Server documentation for installation and configuration instructions.Before individual Design Studio users can deploy cartridges to run-time environments, you must create users (if necessary) and assign them to the WebLogic Cartridge_Management_WebService parent group. The run-time environment and the type of cartridges individual Design Studio users deploy determine to which additional parent groups users must be assigned.
To set up users for Design Studio deployment:
Log in to the WebLogic Administration Console.
Click Security Realms.
The Summary of Security Realms page appears.
In the Realms table, click myrealm.
In Settings for myrealm, click the Users and Groups tab.
On the Users tab, click New.
The Create a New User page appears.
In the Name field, enter the user name.
In the Description field, enter information about the user.
In the Password field, enter a password for the user.
Confirm the password, then click OK.
The user appears in the Users table.
In the Users table Name column, click the user.
The Settings page appears.
Click the Groups tab.
In the Parent Groups area, select Cartridge_Management_WebService from the Available column and move it to the Chosen column.
Click Save.
Before individual Design Studio users deploy cartridges from Design Studio using an SSL connection, you must enable SSL in the WebLogic server to ensure that the Cartridge Management web service accepts the SSL connection. Additionally, you must define the environment connection parameters using HTTPS and include the correct SSL listening port.
Note:
When configuring SSL for WebLogic Server, define the minimum protocol version as Transport Layer Security (TLS) version 1.0. See Oracle Fusion Middleware Securing Oracle WebLogic Server for more information about configuring SSL.The SSL keys must be made available to Design Studio and the keystore must include keys for any environment connection using SSL. See the Design Studio Help for information about defining SSL properties on the Studio Environment editor SSL tab.
To enable SSL connections:
Log in to the WebLogic Administration Console.
In the Environment area, click Servers.
The Summary of Servers page Configuration tab appears.
In the Servers table, click the appropriate server.
The Settings tabs appear.
On the Configuration tab General subtab, select SSL Listen Port Enabled.
In the SSL Listen Port field, enter the SSL port number.
Click Save.
Start Design Studio.
From the Studio menu, select Show Environment Perspective.
In the Environment tab, double-click an environment.
The environment opens in the Studio Environment editor.
Click the Connection tab.
In the Address field, enter the following:
https://Host:Port/cartridge/wsapi
where:
Host is the host name of the system and Port is the SSL listening port number.
Click the SSL tab.
In the Keystore field, enter the location of the target server keystore.
For example, in a test environment, you can enter the location for the DemoTrust.jks keystore (from the server installation). Or, you can enter a replica.
Note:
If you are using a WebLogic Server DemoTrust keystore, and if the Java version installed on the client machine is version 1.7u40 or later, you must change the RSA key size. See "Changing the Keysize Value" for more information.For more information about configuring identity and trust for WebLogic Server, see "Configuring Identify and Trust" on the Oracle Help Center:
http://docs.oracle.com/cd/E23943_01/web.1111/e13707/identity_trust.htm
Do not use the DemoTrust.jks keystore in a production environment.
Click Save.
If you are using a WebLogic Server DemoTrust keystore, and if the Java version installed on the client machine is version 1.7u40 or later, you must change the RSA key size from 1024 Mbs to 256 Mbs in the java.security file.
For more information about configuring identity and trust for WebLogic Server, see "Configuring Identify and Trust" on the Oracle Help Center:
http://docs.oracle.com/cd/E23943_01/web.1111/e13707/identity_trust.htm
To change the key size value:
On the client machine, open the java.security file, located in the home directory:
JRE_Home/lib/security/java.security
Change the following line:
jdk.certpath.disabledAlgorithms=MD2, RSA keySize < 1024
To:
jdk.certpath.disabledAlgorithms=MD2, RSA keySize < 256
Save the file.
You use one of the available log levels to configure deployment message output for the Console view and for log files.
Note:
To configure deployment message output for the Console view and for log files, you must have access to the Design Studio software package, which is available on the Oracle software delivery website:To configure deployment messages:
Navigate to Oracle software delivery website:
Download and extract the Oracle Communications Cartridge Management Tool archive file.
Navigate to and open the cartridge_management_tools/lib folder.
Unjar the cartridge_management_ws.ear file.
Unjar the CartridgeManagementWSPortImpl.war file.
Open the log4j.xml file.
Change the log level for output to the Console view:
Search for the following line:
<appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
Change the parameter threshold to ERROR, WARN, INFO, or DEBUG.
Note:
When changing the log level to DEBUG, the priority value must be changed to DEBUG at the <root> level.Change the log level for output to the WebLogic server log file:
Search for the following line:
<appender name="WEBLOGIC" class="org.apache.log4j.ConsoleAppender">
Change the parameter threshold to ERROR, WARN, INFO, or DEBUG.
Note:
When changing the log level to DEBUG, the priority value must be changed to DEBUG at the <root> level.Change the log level at the package level:
Search for the following line:
<category name="oracle.communications.sce.cartridgemanagement">
or <category name="com.oracle.xmlns.communications.sce.cartridgemanagement.ws">
Change the priority value to ERROR, WARN, INFO, or DEBUG.
Note:
When changing the log level to DEBUG, the priority value must be changed to DEBUG at the <root> level.Repackage the .war and .ear files.
Manually deploy the cartridge_management_ws.ear file to the WebLogic server.