> Installation Guide > Running the Installation Program in Graphical Mode

Installation Guide

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

Running the Installation Program in Graphical Mode

The following sections describe how to run the installation program in graphical mode:

This section discusses the content of the installation wizard. It goes through installation panels using default settings.

 

Running the Installation Program

The installation wizard helps you to install BEA AquaLogic Service Registry on a local computer. You will complete the following configurations as you run the installation program:

The following figure shows the first panel of the installation wizard.

Figure 6-1 Welcome Panel

Welcome Panel

To continue, click Next.

To stop this installation at any time, click Exit. To return to a previous panel, click Back.

Figure 6-2 License Panel

License Panel

The preceding figure shows the BEA AquaLogic Service Registry license. To continue with the installation of the registry, read the license agreement and agree to it. Click Next.

If you do not accept the terms of the license agreement, click Exit.

Until you agree to the license, only the Exit button is enabled. You cannot proceed with the installation without agreeing to the license.

Installation Type

Figure 6-3 Installation Type

Installation Type

The preceding figure shows several installation scenarios. Select one.

Standalone registry

Default installation. Installs a standalone registry and enables the creation of a new registry database.

Standalone registry with data migration

Installs standalone registry with migration of data from a previous installation of the registry. For more information, please see Migration..

Discovery registry

Installs the discovery registry. This is the second part of the approval process registry installation. The discovery registry allows users to query BEA AquaLogic Service Registry. For more information, see Discovery Registry Installation.

Publication registry

Installs the publication registry of the approval process. The publication registry is one part of the approval process registry installation. The publication registry is a space for users to publish and test data prior to its approval for promotion to the discovery server. For more information, see Publication Registry Installation.
Figure 6-4 Installation Directory


Installation Directory

On the panel shown in Figure 6-4, type the path to the installation directory where BEA AquaLogic Service Registry will be installed. The default directory is the current working directory.

If you are installing on a Windows platform you can selected from the following:

Create shortcut icons on the desktop

If selected, icons for accessing the Registry Console and for starting and stopping the registry will be created on the desktop.

Add shortcut icons to the Start menu

If selected, the icons noted above are added to the Start menu.

Program group name

Group name created in the Start menu where shortcut icons will be placed.
Note: You must have read and write permissions on the installation directory.

Server Settings

Figure 6-5 Server Configuration

Server Configuration

The preceding figure shows the server configuration settings. These settings will be used for the HTTP and HTTPS servers. The default recommended settings are filled in the text fields.

HTTP Port

The nonsecure port for accessing the Registry Console (default value: 7001)

SSL (HTTPS) Port

Secure port for accessing the Registry Console (default value: 7002)

Host name

The host name of this computer; change the auto-completed entry if it is different.

Application Server Context

This is the WebLogic application context into which the registry application is deployed.

Deploy to the WebLogic Server at the end of the installation

If this setting is checked, the WAR file is created and automatically deployed into WebLogic Server. If the setting is not checked, the WAR file is created and stored in the file system.

The host name, SSL Certificate Alias, and SSL password are used to create a new security identity in the local protected store. It creates a certificate and adds this certificate to REGISTRY_HOME/conf/clientconf.xml, REGISTRY_HOME/conf/pstore.xml, and also exports it to the certificate file REGISTRY_HOME/doc/registry.crt. This certificate file is used in several situations including the approval process registry scenario. See PStore Tool in the Administrator's Guide in Using the AquaLogic Service Registry for instructions in how to operate the protected security store.

Note: The server configuration may be changed after install. See Reconfiguration After Installation.

SMTP Configuration

Figure 6-6 SMTP Configuration

SMTP Configuration

The preceding figure shows SMTP configuration. The SMTP configuration is important when users needs to receive E-mail notification from subscriptions and from the approval process.

SMTP Host Name

Host name of the SMTP server associated with this installation of BEA AquaLogic Service Registry

SMTP Port

Port number for this SMTP server

SMTP Password

Confirm password

Retype the same password. Note that if it is not same as the password in the previous box, you cannot continue.

SMTP Default Sender E-mail, Name

BEA AquaLogic Service Registry will generate mail messages with this identity.

Setup Administrator Account

Figure 6-7 Administrator Account

Administrator Account

Database Settings

The registry requires a database which may be created during installation. During installation you can create a new database, create schema in an existing empty database or connect to an existing database with created schema. Using the Setup tool, you can also drop the database or database schema. Select your database creation method on the following panel.

Figure 6-8 Database Creation Method

Database Creation Method

Create database

Create new database/users/tablespaces (depending on the type of the database server) and database schema. This is the most comfortable way, but please note that you must know the credentials of the database administrator.

Create schema

Create a new schema in an existing database. Use this option if you have access to an existing empty database and the ability to create tables and indexes. This option is suitable when you do not know the administrator's credentials. We assume the administrator has already created a new database/users/tablespaces for this option.
Note: For more information, see Database Installation.

Configure database

Configure registry database. Use this option if the registry database already exists (For example, from a previous installation) and fill in only the connection parameters.

No database

Choose it if you intend to create a registry database later. Note that BEA AquaLogic Service Registry cannot be started without a database.
Figure 6-9 Select Database


Select Database

Figure 6-9 shows the supported database engines that can be prepared for BEA AquaLogic Service Registry.

You can specify the name of BEA AquaLogic Service Registry installation. The name is saved to the operational business entity. The registry name appears in the upper right corner of Registry Console and Business Service Console.

Select Install demo data if you want to evaluate the provided BEA AquaLogic Service Registry demos after installation.

The default database to create is the Preconfigured HSQL (HSQL). This database is recommended for evaluation purposes.

Note that it is possible to change the database after installation, using the Setup tool.

For more information on database installation, see Database Installation.

On the panel displayed in Figure 6-7, you are only required to provide administrator account settings. The database files will be installed into the REGISTRY_HOME/hsqldb/uddinode directory. The database user is uddiuser and the password is uddi.

Figure 6-10 Optional JDBC Driver

Optional JDBC Driver

Enter the path to JDBC Drivers on the panel shown in Figure 6-10. It is not necessary to configure this path for the HSQL and PostgreSQL databases as the JDBC drivers for these databases are installed in the distribution.

Figure 6-11 Authentication Provider

Authentication Provider

Figure 6-11 allows you to select an authentication provider.

Database

All accounts will be stored in the registry database.

LDAP

Registry accounts integrated with LDAP server.

External

Registry accounts integrated with other external storage. The the interface com.systinet.uddi.account.ExternalBackendApi must be implemented and added to the registry installation.

Confirmation and Installation Process

Figure 6-12 Confirmation

Confirmation

Figure 6-12 shows a summary of installation information. All required and optional properties are set. If you want to continue with the installation, click Next and the install process will start. If you want to change any property click Back.

Figure 6-13 Installation Process

Installation Process

Figure 6-13 shows the installation output and progress. Installation consists of copying files, configuring the server, and installing the database. When the installation has completed successfully, the Next button is enabled. If there is a problem, an error message and Recovery button will appear on the screen.

For more information on recovery, see Troubleshooting Your Installation.

Figure 6-14 Finish Panel

Finish Panel

On this panel, click Finish to conclude the installation.

Complete the Deployment of BEA AquaLogic Service Registry to WebLogic Server

Note that WebLogic 8.1, 9.0, and 9.1 are supported.

When you finish running the installer successfully, complete the following steps to complete the deployment of AquaLogic Service Registry to WebLogic Server.

  1. For WebLogic 8.1:
    1. Open the BEA WebLogic Server launch script:

      2. WL_HOME/user_projects/domains/DOMAIN_NAME/startWebLogic.sh or

      startWebLogic.cmd

    2. Add the following property to the Java command line for starting the WebLogic server:

      3. -Djava.security.auth.login.config=REGISTRY_HOME/conf/jaas.config

  2. For WebLogic 9.0 and 9.1:
    1. Open the setup script for the server's domain environment:

      2. WL_HOME/user_projects/domains/DOMAIN_NAME/bin/setDomainEnv.sh or

      setDomainEnv.cmd

    2. Add the following line:

      3. set JAVA_OPTIONS= -Djava.security.auth.login.config=REGISTRY_HOME/conf/jaas.config

  3. For WebLogic 8.1, 9.0, and 9.1:

    4. If you have not already done so, enable SSL in WebLogic. Restart WebLogic Server so that the previous changes in to the startup script in Step 1 take effect.

  4. (Optional) This step only required if you wish to use the sample client code.
    5. Note: AquaLogic Service Registry ships with sample client code that requires the WebLogic Server SSL certificate for the WebLogic Server instance on which AquaLogic Service Registry is deployed.

    Note that any other client code you use must also be configured for SSL connections to AquaLogic Service Registry using the appropriate tools for that type of client.

    Import the WebLogic Server SSL certificate to the BEA AquaLogic Service Registry configuration file.

    You can obtain the WebLogic SSL certificate via a browser by accessing a WebLogic-hosted page using HTTPS, and exporting the certificate to a Base-64 .cer file.

    To import this certificate into AquaLogic Service Registry, use the PStoreTool located in [registry_home]/bin PStoreTool.sh. add -config [registry_home]/conf/clientconf.xml -certFile [weblogic.cer]

This completes the deployment. The BEA AquaLogic Service Registry URL is: 

http://[hostname]:[http_port]/[context]/uddi/web

 

What's Next?

For information about the installed product and troubleshooting tips, go to Installation Summary.


  Back to Top       Previous  Next