web server - Borland Technical Publications

web server - Borland Technical Publications web server - Borland Technical Publications

techpubs.borland.com
from techpubs.borland.com More from this publisher
12.11.2014 Views

Security management with the Security Map The following examples illustrate the use of ResourceVaultGen: Example 1: java -Dborland.enterprise.licenseDir=/opt/BES/var -Dserver.instance.root=/opt/BES/var/servers/servername - Dpartition.name=standard com.borland.enterprise.visiconnect.tools.ResourceVaultGen -rolename administrator -username red -password balloon -vaultfile /opt/BES/var/servers/servername/adm/properties/partitions/standard/ resourcevault -vpwd lock This usage generates a resource vault named resourcevault to /opt/BES/var/servers/ servername/adm/properties/partitions/standard, with a role administrator associated with a Password Credential with username red and password balloon. The vault file itself is password protected, using the password lock. For VisiConnect to use this vault, the following properties must be set for it: -Dvisiconnect.resource.security.vaultpwd=lock -Dvisiconnect.resource.security.login=resourcevault Example 2: java -Dborland.enterprise.licenseDir=/opt/BES/var/domains/base/configurations/ /mos//adm/properties/ management_vbroker.properties> -Dserver.instance.root=/opt/BES/var/domains/base/configurations/ /mos//adm/properties/ management_vbroker.properties> -Dpartition.name=petstore com.borland.enterprise.visiconnect.tools.ResourceVaultGen -rolename manager accounts -username mickey daffy -password mouse duck -vpwd goofy This usage generates a default resource vault (named resource_vault) to /opt/BES/var/ servers/servername/adm/properties/partitions/petstore, with a role manager associated with a Password Credential with username mickey and password mouse, and another role accounts associated with a Password Credential with username daffy and password duck. The vault file itself is password protected, using the password goofy. For VisiConnect to use this vault, the following properties must be set for it: -Dvisiconnect.resource.security.vaultpwd=goofy Example 3: java -Dborland.enterprise.licenseDir=/opt/BES/var/servers/servername/adm - Dserver.instance.root=/opt/BES/var/servers/servername -Dpartition.name=standard com.borland.enterprise.visiconnect.tools.ResourceVaultGen -rolename OClone ENolco -username darkstar geraldo -password meteor rivera This usage generates a default resource vault (named resource_vault) to /opt/BES/var/ domains/base/configurations//mos//adm/ properties/management_vbroker.properties>, with a role developer associated with a Password Credential with username darkstar and password meteor, and a role host associated with a Password Credential with username geraldo and password rivera. The vault file itself is not password protected. VisiConnect requires no additional parameters to use this vault. Chapter 27: Using VisiConnect 263

Resource Adapter overview Note ResourceVaultGen cannot be used to write vault information to an existing file containing invalid characters. For example, a file generated by 'touch', or a StarOffice or Word document. ResourceVaultGen can only write vault information to a new file that it itself generates, or a valid existing vault file. Resource Adapter overview According to the Connectors 1.0 specification, you must be able to deploy a Resource Archive (RAR) as part of an Enterprise Archive (EAR). With BES AppServer Edition and VisiConnect you can also deploy a standalone RAR. Once the RAR is deployed, you must do the following: ■ ■ ■ ■ Write code to obtain a connection. Create an Interaction object. Create an Interaction Spec. Create record and/or result set instances. ■ Run the execute command so the record objects become populated. In addition to some introductory conceptual information, this chapter provides steps to help you understand the code you must write. The J2EE Connector Architecture enables Enterprise Information System (EIS) vendors and third-party application developers to develop Resource Adapters that can be deployed to any J2EE 1.3 compliant application server. The Resource Adapter is the main component of the J2EE Connector Architecture (Connectors), providing platform-specific integration between J2EE application components and the EIS. When a Resource Adapter is deployed to the Borland Enterprise Server, it enables the development of robust J2EE applications which can access a wide variety of heterogeneous EISs. Resource Adapters encapsulate the Java components and, if necessary, the native components required to interact with the EIS. Development overview See “Developing the Resource Adapter” on page 268 for more information. Developing a Resource Adapter from scratch requires implementing the necessary interfaces and deployment descriptors, packaging these into a Resource Adapter Archive (RAR), and finally deploying the RAR to the Borland Enterprise Server. The following summarizes the main steps for developing a Resource Adapter: 1 Write Java code for the various interfaces and classes required by the Resource Adapter within the scope of the Connectors 1.0 specification. 2 Specify these classes in the ra.xml standard deployment descriptor file. 3 Compile the Java code for the interfaces and implementation into class files. 4 Package the Java classes into a Java Archive (JAR) file. 5 Create the Resource Adapter-specific deployment descriptors: ■ ■ ra.xml: describes the Resource Adapter-related attributes and deployment properties using the Sun standard DTD. ra-borland.xml: add additional Borland Enterprise Server-specific deployment information. This file contains the parameters for connection factories, connection pools, and security mappings. 6 Create the Resource Adapter Archive (RAR) file (that is, package the Resource Adapter) 264 BES Developer’s Guide

Security management with the Security Map<br />

The following examples illustrate the use of ResourceVaultGen:<br />

Example 1:<br />

java -Dborland.enterprise.licenseDir=/opt/BES/var<br />

-D<strong>server</strong>.instance.root=/opt/BES/var/<strong>server</strong>s/<strong>server</strong>name -<br />

Dpartition.name=standard<br />

com.borland.enterprise.visiconnect.tools.ResourceVaultGen -rolename<br />

administrator<br />

-username red -password balloon -vaultfile<br />

/opt/BES/var/<strong>server</strong>s/<strong>server</strong>name/adm/properties/partitions/standard/<br />

resourcevault -vpwd<br />

lock<br />

This usage generates a resource vault named resourcevault to /opt/BES/var/<strong>server</strong>s/<br />

<strong>server</strong>name/adm/properties/partitions/standard, with a role administrator associated<br />

with a Password Credential with username red and password balloon. The vault file<br />

itself is password protected, using the password lock. For VisiConnect to use this vault,<br />

the following properties must be set for it:<br />

-Dvisiconnect.resource.security.vaultpwd=lock<br />

-Dvisiconnect.resource.security.login=resourcevault<br />

Example 2:<br />

java -Dborland.enterprise.licenseDir=/opt/BES/var/domains/base/configurations/<br />

/mos//adm/properties/<br />

management_vbroker.properties><br />

-D<strong>server</strong>.instance.root=/opt/BES/var/domains/base/configurations/<br />

/mos//adm/properties/<br />

management_vbroker.properties><br />

-Dpartition.name=petstore<br />

com.borland.enterprise.visiconnect.tools.ResourceVaultGen<br />

-rolename manager accounts -username mickey daffy<br />

-password mouse duck -vpwd goofy<br />

This usage generates a default resource vault (named resource_vault) to /opt/BES/var/<br />

<strong>server</strong>s/<strong>server</strong>name/adm/properties/partitions/petstore, with a role manager associated<br />

with a Password Credential with username mickey and password mouse, and another<br />

role accounts associated with a Password Credential with username daffy and<br />

password duck. The vault file itself is password protected, using the password goofy.<br />

For VisiConnect to use this vault, the following properties must be set for it:<br />

-Dvisiconnect.resource.security.vaultpwd=goofy<br />

Example 3:<br />

java -Dborland.enterprise.licenseDir=/opt/BES/var/<strong>server</strong>s/<strong>server</strong>name/adm -<br />

D<strong>server</strong>.instance.root=/opt/BES/var/<strong>server</strong>s/<strong>server</strong>name<br />

-Dpartition.name=standard<br />

com.borland.enterprise.visiconnect.tools.ResourceVaultGen<br />

-rolename OClone ENolco -username darkstar geraldo -password meteor rivera<br />

This usage generates a default resource vault (named resource_vault) to /opt/BES/var/<br />

domains/base/configurations//mos//adm/<br />

properties/management_vbroker.properties>, with a role developer associated with a<br />

Password Credential with username darkstar and password meteor, and a role host<br />

associated with a Password Credential with username geraldo and password rivera.<br />

The vault file itself is not password protected. VisiConnect requires no additional<br />

parameters to use this vault.<br />

Chapter 27: Using VisiConnect 263

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!