Administration Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Deploying Dataspaces

This chapter describes how to deploy dataspaces to an Administration Server, a Managed Server, and a cluster. It also describes how to migrate dataspaces from development to production.

The chapter contains the following sections:

 


Introduction

ALDSP Administration Console provides you the ability to deploy, export and import dataspaces. Using the console, you can export, import, and delete dataspaces that are deployed on a WebLogic Server without interrupting other running dataspaces. In addition, you can import artifacts to an existing dataspace without interrupting existing requests running against that dataspace

During development, you can deploy dataspaces to a WebLogic Server directly from the eclipse-based IDE. After development, you can deploy dataspaces to production WebLogic Servers using the ALDSP Administration Console or the IDE.

 


Creating a New Dataspace

You can create a new dataspace using the ALDSP Administration Console and associate a JAR file with it. This enables you to create and manage the dataspace on the server directly.

Note: Only a domain user has the ability to create a new dataspace. For more information about domain users, refer to Working with Administrative Access Control Policies section in Securing ALDSP Resources.

To create a new dataspace in the ALDSP-enabled WebLogic domain:

  1. Click the System Administration category from the navigation pane.
  2. Select the domain node.
  3. From the workspace content area, click New as shown in Figure 3-1.
  4. Figure 3-1 Creating a New Dataspace


    Creating a New Dataspace

  5. On the Create Dataspace page shown in Figure 3-2, specify the following:
  1. Click Next. This displays details such as the file size and checksum information about the resource file being imported as shown in Figure 3-3.
  2. Figure 3-3 Resource File Details


    Resource File Details

  3. On this page, select the Filter Configuration checkbox if you do not want to import the resource file configuration. To retain the resource file configurations, make sure that you do not select the Filter Configuration checkbox.
  4. Each dataspace contains one .space file that contains all the global dataspace properties. For example, for a dataspace my_dspace_DS there is a corresponding file named My_DSpace.space. The dataspace also contains one file, named My_DSpace.sources, that contains all the properties pertaining the physical sources used by the dataspace My_DSpace.

    For each dataservice (.ds) file contained in the dataspace, there is a .service file named after the dataservice and located within the same folder as the data service, that carries the data service configuration properties.

    Finally, a dataspace may contain one or more .xml files under the folder DSP-INF/service-accounts, which carry service account information details.

  5. Click Next. This displays the page where you can select the state and targets for the dataspace as shown in Figure 3-4.
  6. Figure 3-4 Selecting the State and Target Server for a Dataspace


    Selecting the State and Target Server for a Dataspace

    A deployed dataspace can be in one of the following states:

  1. Specify the state and target server and click Finish to create and deploy the new dataspace.
Note: You may need to wait for sometime before the new dataspace is deployed successfully depending on the size of the dataspace.

 


Deleting a Dataspace

Only a domain user can delete a deployed dataspace. To delete a dataspace:

  1. Navigate to the ALDSP Domain level.
  2. Select the dataspace that you need to delete as shown in Figure 3-5.
  3. Figure 3-5 Selecting the Dataspace to Delete


    Selecting the Dataspace to Delete

  4. Click Delete. The next page confirms if you want to delete the dataspace. Select Yes to delete the dataspace.
Note: If you delete the target Managed Server on which your dataspace is deployed, the dataspace deletion will fail.

 


Deploying Dataspaces on a Target Server

Deployment is done through the System Administration category in the ALDSP Administration Console. ALDSP dataspaces can only run in an ALDSP-enabled WebLogic domain. You can create a new WebLogic domain using the Configuration Wizard.

Note: For more information about using the Configuration Wizard to set up an ALDSP-enabled WebLogic domain, refer to Creating a New Domain section in Overview of ALDSP Administration.

The Configuration Wizard automatically transfers the required items to the target server. These include the ALDSP dataspace artifacts, with the corresponding configuration and binary files, as well as WebLogic components such as data source connections and pools. When you move a dataspace from the development to production, you need to make sure that these items are transferred to the target production server.

Note: A target server can be an Administration Server, a Managed Server, or a cluster. The steps to deploy dataspaces on any of these targets are the same.

An Administration Server is the central configuration repository for the set of WebLogic Servers in a domain.

You can deploy a dataspace on multiple Managed Servers and clusters depending on your requirement. To deploy dataspace artifacts on a Managed Server or a cluster, you must first create a Managed Server or cluster using the Configuration Wizard.

Note: If you need to deploy a Web Service Map on a cluster, then you need to specify the cluster address. For details, refer to Deploying a Web Service Map on a Cluster.

For more information about creating Managed Servers, refer to the Create Managed Servers topic in WebLogic Server Administration Console Online Help.

For more information about creating clusters, refer to the Create a Cluster topic in WebLogic Server Administration Console Online Help.

Deploying a Dataspace

To deploy a dataspace on WebLogic Server using ALDSP Administration Console:

  1. Start the ALDSP Administration Console.
  2. For more information, see Launching ALDSP Administration Console section in Getting Started with ALDSP Administration.

  3. Select the System Administration category and then select the Targets tab from the workspace content area as shown in Figure 3-6.
  4. Figure 3-6 Deploying a Dataspace on a Target Server


    Deploying a Dataspace on a Target Server

  5. Select the target server on which you want to deploy the dataspace.
  6. Click Save. This set the target server for your ALDSP dataspace.
  7. To view or change the deployment status, click the Server Status tab as shown in Figure 3-7.
  8. Figure 3-7 Checking the Server Status


    Checking the Server Status

    The options to start and stop the target servers are mentioned in the following table:

    Table 3-1 Options for Starting and Stopping Server
    State
    Option
    Description
    Start
    Servicing Administration Requests
    Select this option when the dataspace is accessible only at the Administration level. This usually happens when the dataspace project is deployed on the production server and is yet to go live.
    Start
    Servicing All Requests
    Select this option when the dataspace is ready to service all client requests.
    Stop
    Servicing Non-Administration Requests
    Select this option when you need to stop servicing requests from clients but continue servicing administration requests.
    Stop
    Servicing All Requests
    Select this option if you need to stop servicing requests from all clients including administration requests.

Deploying a Web Service Map on a Cluster

Before you deploy a web service map on a cluster you need to specify the cluster address using the WebLogic Server console. If you do not specify the cluster address then the WSDL creation for the web service map fails.

To specify the cluster address on WebLogic Server, specify the cluster address in the Configuration > General tab for the cluster as shown in Figure 3-8.

Figure 3-8 Specifying Cluster Address on WebLogic Server

Specifying Cluster Address on WebLogic Server

For detailed information about configuring clusters on WebLogic Server, refer to Create and Configure Clusters.

 


Importing Dataspace Artifacts

ALDSP Administration Console allows you to perform incremental and full deployment of resource JAR files. This section describes the steps to perform incremental and full deployment through the ALDSP Administration Console.

Note: You can also import the data service configuration settings from ALDSP 2.5. This enables you to use the same configurations that you used in the ALDSP 2.5 environment, while continuing to work with ALDSP 3.0. For information about migrating an ALDSP 2.5 application to 3.0, refer to Migrating from ALDSP 2.5 to ALDSP 3.0.

To perform incremental or full deployment of resource files:

  1. Acquire the lock by selecting Lock & Edit.
  2. From the Navigation pane, select the System Administration category and then select the dataspace in which you want import configuration or artifacts.
  3. Click the Import tab as shown in Figure 3-9.
  4. Figure 3-9 System Administration Category: Import Tab


    System Administration Category: Import Tab

  5. Browse and specify the resource file path in the Resource JAR File box.
  6. If you want to perform full deployment, then select the Full Deployment check box from the Import Resource Jar section. If you select this option, then the system deletes all the artifacts from the dataspace and then imports the new artifacts.
  7. If you want perform incremental deployment, then do not select the Full Deployment check box. In case of incremental deployment, ALDSP updates only those dataspace artifacts that have changed and add any new artifacts.
  8. Click Next to move to the page that displays the resource JAR file details, which include file checksum details and file size as shown in Figure 3-10. In addition, this page provides the following options:
    1. Filter Configuration: Select this option if you do not want to import the configurations of the resource file.
    2. Preserve End Point Mappings: Select this option if you want import all the configuration and the resources (artifacts) but keep the old endpoint mappings intact.
    3. This option is useful when you move configurations from the staging server to a live production server. On the staging server, you configure and test the configurations. If the testing is successful, move the configurations from the staging to the production server. However, the endpoints used during staging and production would not be the same as you would not be testing directly on production server. So, when you import mappings from the staging server, you may want to retain the mappings that already exist in the production database. In that case, select the Preserve Endpoint checkbox.

      Figure 3-10 Resource File Details


      Resource File Details

  9. After selecting options on this page, click Import. When the import is completed, the message “Import operation was successful” is displayed.
Note: Depending on the size of the files and the topology of your domain, the import operation may take time, therefore you may need to wait for import to complete.
  1. Click Activate Changes from the change center to activate the import.

 


Exporting Dataspace Artifacts

You can export dataspace artifacts with or without retaining the configuration settings. To export dataspace artifacts:

  1. Click the System Administration Category and the dataspace that you want to export as a JAR.
  2. Click the Export tab.
  3. Select the Include configuration artifacts check box as shown in Figure 3-11, if you want to export the configuration along with all the artifacts.
  4. Figure 3-11 Export Tab


    Export Tab

  5. If you are already in a session and want to export changes that have occurred within that session then select the Export only the pending changes in this session check box.
Note: The Export only the changes in this session check box is enabled only when the lock is acquired.
  1. Click Export
  2. Specify the location where you want to save the dataspace artifacts and the file is saved as a JAR file at the specified location.

  Back to Top       Previous  Next