> 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:

Welcome

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

Figure 6-1 Welcome Panel

Welcome Panel

To continue, click Next.

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

Installation Directory

The following figure shows the Installation Directory panel.

Figure 6-2 Installation Directory

Installation Directory

On the panel shown in Figure 6-2, enter the path to the installation directory where AquaLogic Service Registry will be installed, and then click Next.

Note: You must have read and write permissions on the installation directory.

Choose Shortcuts

The following figure shows the Choose Shortcuts panel.

Figure 6-3 Choose Shortcuts

Choose Shortcuts

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

“All Users” Start Menu folder

If a user without administrative privileges uses the BEA Configuration Wizard in this installation to create domains, the user may have to create Start Menu shortcuts manually. For more information, refer to the Creating WebLogic Domains Using the Configuration Wizard documentation.

Local user’s Start Menu folder

Select this option if you need to ensure that other profiles registered on this machine do not have access to these shortcuts.

Deployment Target Type

The following figure shows the Deployment Target Type panel.

Figure 6-4 Deployment Target Type

Deployment Target Type

The preceding figure shows two deployment types. Select one.

Install with WebLogic Deployment

AquaLogic Service Registry will be installed to an existing WebLogic Server instance.

Install with embedded HTTP/HTTPS server

AquaLogic Service Registry will be run from within its own HTTP Server—WebLogic Server is not required in this deployment setup.

BEA Home Directory

The following figure shows the BEA Home Directory panel.

Figure 6-5 Choose BEA Home Directory with WebLogic Server

Choose BEA Home Directory with WebLogic Server

The preceding figure shows where the WebLogic Server is installed.

Select one of the following:

Installation Type

The following figure shows the Installation Type panel.

Figure 6-6 Installation Type

Installation Type

The preceding figure shows several installation scenarios.

Select one of the following:

Standalone Registry

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

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.

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..

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.

Intermediate registry

Installs this instance of AquaLogic Service Registry as an intermediate registry, which acts as both a Publication Registry and a Discovery Registry. That is, it is deployed between other registries to support a multi-step approval process. Note that the final Discovery Registry must be installed prior to installing the Intermediate registry, since the Discovery Registry’s certificate is needed to complete the installation process.

SMTP Configuration

The following figure shows the SMTP Configuration panel.

Figure 6-7 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.

Operator Name

The name of the Registry operator.

SMTP Host Name

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

SMTP Port

Port number for this SMTP server.

Account Name

AquaLogic Service Registry will generate mail messages with this name.

SMTP Password

Password for the SMTP server.

Confirm password

Retype the same password. If it is not same as the password in the field, you cannot continue.

Sender e-mail address

AquaLogic Service Registry will generate mail messages with this address in the From field.

Setup Administrator Account

The following figure shows the Setup Administrator Account panel.

Figure 6-8 Administrator Account

Administrator Account

Account name

The login name for the administrator.

Password

Password for the administrator account.

Confirm password

Enter the password again for confirmation.

Admin e-mail

The e-mail address for the administrator.

Database Configuration

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. If you do not create a database you can do it later using the Setup tool.

Database Creation

Select your database creation method on the following panel.

Figure 6-9 Database Creation

Database Creation

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 if you intend to create a registry database later. Note that AquaLogic Service Registry cannot be started without a database.

Database Selection

The following figure shows the Select Database panel.

Figure 6-10 Select Database

Select Database

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

Registry Name: You can specify the name of 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 Populate the database with demo data if you want to evaluate the provided AquaLogic Service Registry demos after installation.

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

Note: You can 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-8, 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-11 Optional JDBC Driver

Optional JDBC Driver

Enter the path to JDBC Drivers on the panel shown in Figure 6-11.

Note: 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.

Authentication Provider

The following figure shows the Authentication Provider panel.

Figure 6-12 Authentication Provider

Authentication Provider

The panel shown in Figure 6-12 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.

Deployment Settings

The following figure shows the Deployment panel.

Figure 6-13 Deployment Settings

Deployment Settings

The preceding figure shows the server configuration settings. These settings are 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.

HTTP Server Settings

The following figure shows the HTTP Server Settings panel.

Figure 6-14 HTTP Server Settings

HTTP Server Settings

Figure 6-14 shows the server configuration settings when AquaLogic Service Registry is installed with its HTTP Server. The default recommended settings are filled in the text field.

HTTP Port

The nonsecure port for accessing AquaLogic Service Registry (default value: 8080).

HTTPS Port

The secure port for accessing AquaLogic Service Registry (default value: 8443).

Connector (Shutdown) port

The connector port listens for control signals. Note that no other application may use this port (default value: 8081).

SSL server identity password

The password to encrypt SSL private key. (default value: changeit) The password is 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, which is used in several situations including the approval process registry scenario. For instructions in how to operate the protected security store PStore Tool in the Administrator’s Guide in Using the AquaLogic Service Registry.

Host name

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

Confirmation and Installation Process

The following figure shows the Installation Summary panel.

Figure 6-15 Confirmation

Confirmation

Figure 6-15 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-16 Installation Process

Installation Process

Figure 6-16 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 appears on the screen.

For more information on recovery, see Troubleshooting Your Installation.

Figure 6-17 Finish Panel

Finish Panel

To conclude the installation, click Finish the panel shown in Figure 6-17.

Complete the Deployment of BEA AquaLogic Service Registry to WebLogic Server

Note that WebLogic 8.1 and 9.2 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.2:
    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 and 9.2:

    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