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.
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.
Note: | To stop this installation at any time, click Exit. To return to a previous panel, click Back. |
The following figure shows the Installation Directory panel.
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. |
The following figure shows the Choose Shortcuts panel.
If you are installing on a Windows platform you can selected from the following:
The following figure shows the Deployment Target Type panel.
The preceding figure shows two deployment types. Select one.
The following figure shows the BEA Home Directory panel.
The preceding figure shows where the WebLogic Server is installed.
The following figure shows the Installation Type panel.
The preceding figure shows several installation scenarios.
The following figure shows the SMTP Configuration panel.
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.
The following figure shows the Setup Administrator Account panel.
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.
Select your database creation method on the following panel.
Note: | For more information, see Database Installation. |
The following figure shows the Select Database panel.
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
.
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. |
The following figure shows the Authentication Provider panel.
The panel shown in Figure 6-12 allows you to select an authentication provider.
com.systinet.uddi.account.ExternalBackendApi
must be implemented and added to the registry installation.
The following figure shows the Deployment panel.
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.
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. |
The following figure shows the HTTP Server Settings panel.
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.
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.
The following figure shows the Installation Summary panel.
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 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.
To conclude the installation, click Finish the panel shown in Figure 6-17.
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.
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.
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
For information about the installed product and troubleshooting tips, go to Installation Summary.