icebreaker installation and configuration...

Ingres 2006

Updated: December 2006

Icebreaker Installation and Configuration Guide

This documentation and related computer software program (hereinafter referred to as the "Documentation") is for the end user's informational purposes only and is subject to change or withdrawal by Ingres Corporation ("Ingres") at any time.

This Documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without the prior written consent of Ingres. This Documentation is proprietary information of Ingres and protected by the copyright laws of the United States and international treaties.

Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this Documentation for their own internal use, provided that all Ingres copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the license for the software are permitted to have access to such copies.

This right to print copies is limited to the period during which the license for the product remains in full force and effect. The user consents to Ingres obtaining injunctive relief precluding any unauthorized use of the Documentation. Should the license terminate for any reason, it shall be the user's responsibility to return to Ingres the reproduced copies or to certify to Ingres that same have been destroyed.

To the extent permitted by applicable law, INGRES PROVIDES THIS DOCUMENTATION "AS IS" WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL INGRES BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USER OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF INGRES IS EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE.

The use of any product referenced in this Documentation and this Documentation is governed by the end user's applicable license agreement.

The manufacturer of this Documentation is Ingres Corporation.

For government users, the Documentation is delivered with "Restricted Rights" as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or DFARS Section 252.227-7013 or applicable successor provisions.

Copyright © 2006 Ingres Corporation. All Rights Reserved.

Ingres, OpenROAD, and EDBC are registered trademarks of Ingres Corporation. All other trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

Contents iii

Contents

Chapter 1: Connectivity and Disk Configuration 5 Client Connectivity ................................................................................................................ 5

Firewall Settings.............................................................................................................. 5 Disk Configuration................................................................................................................. 6

Chapter 2: Installing Icebreaker 7 Exceptions in the Example Installation ..................................................................................... 7 Install Icebreaker.................................................................................................................. 7 First Boot of Icebreaker ....................................................................................................... 18

Chapter 3: Getting Started with Icebreaker 19 Connect to the Icebreaker Web Interface................................................................................ 20 Configure Icebreaker ........................................................................................................... 22 Configuration Options .......................................................................................................... 26 Log Out of Icebreaker .......................................................................................................... 27

Chapter 4: Configuring and Administering Icebreaker 29 Manage Ingres Databases .................................................................................................... 30 Check Ingres Services Status................................................................................................ 31 Change the Ingres User Password ......................................................................................... 33 Run a System Report........................................................................................................... 34 Schedule a System Reboot ................................................................................................... 35 Check for System Updates.................................................................................................... 37

Change System Update Preferences ................................................................................. 39 View Logs .......................................................................................................................... 41

View the Conary Log ...................................................................................................... 42 View the Icebreaker System Log...................................................................................... 43

View and Apply Rollbacks ..................................................................................................... 44

Connectivity and Disk Configuration 5

Chapter 1: Connectivity and Disk Configuration

This section contains the following topics:

Client Connectivity (see page 5) Disk Configuration (see page 6)

Icebreaker combines the Ingres 2006 RDBMS and a Linux-based operating system (rPath Linux) in a single integrated maintenance unit. It is designed to run on x86-compatible, 32-bit capable server hardware or a virtual server environment (such as VMware).

Icebreaker provides product updates to all components of the system in an integrated maintenance stream. For the system to download updates as they become available, it must be configured to access the Internet and must register a valid entitlement key.

For more information on system requirements, see the readme.

Client Connectivity The default configuration includes the Ingres 2006 database, networking, and Applications-By-Forms (ABF). This configuration accepts connections from client applications based on Ingres Net, JDBC, ODBC, and .Net using the TCP/IP protocol.

Firewall Settings

For added security, the system is configured with an internal firewall that is configured to allow access to the following services:

Service Protocol Port

Ingres Net TCP 21064

Ingres DAS (JDBC, ODBC, .Net) TCP 21071

rPath Appliance Agent (rAA) HTTPS/TCP 8003

SSH TCP 22

Disk Configuration

6 Icebreaker Installation and Configuration Guide

Disk Configuration Ingres recommends a server configuration that includes multiple physical disks or storage volumes to avoid a single point of failure. For detailed information on requirements to help ensure that the system can be recovered in the event of a disk failure, see DBMS Server Disk Configurations in the Ingres 2006 Getting Started for Linux guide, available from Ingres Technical Support (http://ingres.com/support).

Icebreaker groups together under various mount points the storage areas that the Ingres DBMS uses. These are described in the following table. This configuration makes it easier to implement the recommendations outlined in the Getting Started guide. When you install the product, we recommend that you select separate storage devices for each of the following mount points:

Mount Point DBMS Area Subdirectories

/opt/Ingres/IngresII II_SYSTEM ingres/*

/opt/Ingres/DATABASE II_DATABASE ingres/data

II_CHECKPOINT ingres/ckp

II_JOURNAL ingres/jnl

/opt/Ingres/BACKUP

II_DUMP ingres/dmp

II_LOG_FILE ingres/log /opt/Ingres/LOG1

II_WORK ingres/work

/opt/Ingres/LOG2 II_DUAL_LOG ingres/log

http://ingres.com/support

Installing Icebreaker 7

Chapter 2: Installing Icebreaker


Exceptions in the Example Installation (see page 7) Install Icebreaker (see page 7) First Boot of Icebreaker (see page 18)

Before you install Icebreaker, review the exceptions to the default installation used in the examples throughout the remainder of this chapter.

Exceptions in the Example Installation The installation example detailed in this document was performed on a VMware Server virtual machine configured with default hardware, except for the following items:

Seven hard disk drives (HDDs) specified, 2 GB each

Note: Using seven HDDs illustrates the automatic disk layout feature of the installation process. Using seven HDDs is not a requirement of Icebreaker, and does not replace any recommendations of Ingres Corporation regarding disk layouts for Ingres RDBMS installations.

CD-ROM set to “Use ISO image” (an ISO 9660 file system image of the Icebreaker CD)

Ethernet set to “NAT” (use network address translation)

Install Icebreaker You install Icebreaker from the installation media using the installation wizard.

To install Icebreaker

1. Insert the Icebreaker installation media in the CD drive of an x86-compatible, 32-bit capable server or machine with a virtual environment (such as VMware).

2. Start the server machine or virtual environment, or reboot it if it is already running.

Install Icebreaker


3. When the server or virtual environment boots, select the CD drive containing the Icebreaker installation media as the boot device.

When the CD boots, it displays the following prompt:

4. Press Enter to start the installation wizard in graphical mode.

Some hardware drivers are loaded in text mode, and after a short delay, the graphical interface opens. Help for each screen is displayed by default on the left. You can hide the help by clicking Hide Help.

Click Next.

Install Icebreaker


5. Select a default language for your installation and click Next.

6. Select a keyboard configuration and click Next.

The installer searches for Ingres installations.

Install Icebreaker


7. Select how you want your disk to be partitioned.

The “Automatically partition” option creates a typical starting point, and allows you to review and make changes before the installer finalizes the configuration.

Click Next.

Install Icebreaker


8. Select individual disks to install to.

Note: If there is only one drive, it will be selected but grayed out.

Ensure that the “Review (and modify if needed) the partitions created” option is selected, so that you can change the partitioning later, if necessary.

A warning message about destroying data on each disk appears:

Click Yes to continue the partitioning process.

Install Icebreaker


9. Review the results of the automatic partitioning and, if desired, change the partitioning.

For example, the following shows a modification of the “/” partition. (The “/” partition was highlighted, and then the Edit button clicked.)

When you are finished, click Next.

Install Icebreaker


10. Configure the network devices.

The following example shows DHCP as operational but not configured to provide hostnames, so a hostname must be entered manually (as Appliance0):

Note: If the IP address of the system will be obtained by DHCP, you should keep a record of the network device detailed previously (in this example, eth0). However, we recommend that, instead of DHCP, you choose a static IP address by clicking the Edit button.

When you are finished, click Next.

Install Icebreaker


11. Specify and confirm a root password for the Icebreaker server, and click Next.

The installer reads package information before displaying the next screen.

12. Select Ingres RDBMS packages for installation.

Note: Some infrequently used and legacy interoperability packages are not installed by default, but you may include these here, either individually or by selecting the “Everything” option at the bottom of the list.

Click Next.

The installer checks package dependency, which may take some time.

Install Icebreaker


13. Select the time zone for the Ingres database and click Next.

14. Select a character set for the Ingres database and click Next.

Install Icebreaker


15. Set and confirm the password for the ingres database user. (To make Icebreaker accessible over network connections [for example, JDBC, ODBC, and .Net connections], you must set the Ingres operating system user password.)

Set optional database configuration parameters, if desired. Then click Next.

A final screen is displayed before installation begins:

Install Icebreaker


16. Click Next to begin Icebreaker installation.

Installation may take some time, depending on a number of factors, including hardware and package selection.

When the installation is complete, the following screen is displayed:

Click Reboot to restart the machine.

Note: For instruction on what to do when Icebreaker boots for the first time, see First Boot of Icebreaker (see page 18).

First Boot of Icebreaker


First Boot of Icebreaker Some automated Ingres setup activities take place the first time you boot the machine after installation. For example:

Note: The smartd service may fail to start; this is a known issue, and you may safely ignore it. For other known issues, see the readme.

Getting Started with Icebreaker 19

Chapter 3: Getting Started with Icebreaker


Connect to the Icebreaker Web Interface (see page 20) Configure Icebreaker (see page 22) Configuration Options (see page 26) Log Out of Icebreaker (see page 27)

After installing Icebreaker, you must set its IP address, configure basic options, and specify the Ingres password.

Connect to the Icebreaker Web Interface


Connect to the Icebreaker Web Interface You can launch the Icebreaker web interface from any machine with a web browser and network access to the machine running Icebreaker server.

To start the Icebreaker web interface

1. Open a web browser and specify a URL in the following form:

https://hostname:8003/

hostname

Specifies the IP address you assigned to Icebreaker.

Example:

https://192.168.237.130:8003/

Note: If a Security Alert dialog appears, click Yes.

The Sign In page opens:

Connect to the Icebreaker Web Interface


2. Log in using a valid user name and password, and then click Sign In.

Note: If you are logging in for the first time, use the default username admin and password password, and then click Sign In. This starts the initialization wizard:

Click OK and follow the instructions in Configure Icebreaker (see page 22).

Configure Icebreaker


Configure Icebreaker You can configure Icebreaker from any machine with a web browser and network access to the machine running the Icebreaker server. The first time you sign in to Icebreaker, you are led through a configuration process.

To change the web interface administrator password

Enter the current Icebreaker web interface password (password), and then enter and confirm a new password. Click Change Password.

The Email Configuration page is displayed.



To configure email settings

1. Enter the hostname of a mail relay (SMTP) server accessible from the server machine.

2. Enter an email address in the Mail From field.

Note: This address will appear in the “From” field of Icebreaker email notifications.

Click OK.



3. Click the '+' icon to specify email addresses as destinations for Icebreaker notifications, if desired.

When you are done, click OK.



To enter an entitlement key

1. Enter a valid entitlement key and click OK to complete the initialization wizard.

An entitlement key permits access to online system updates. You can use Icebreaker without a key (leave the Entitlement key field empty), but system updates will be available only when a valid key is entered.

Note: During the beta phase, Ingres Development provides this key. For more information on requesting an entitlement key, see the Icebreaker readme.

Configuration Options


Summary details are displayed:

Configuration Options The following options under the Configuration menu are functions of the rPath Appliance Agent:

Configure Email

Configure Networking

Configure Notification

Configure Proxy

Manage Entitlements

For more information on any of these procedures, click the menu item and then click the Learn More button to open a help page where you can learn more about the particular function.

Log Out of Icebreaker


Log Out of Icebreaker You can log out of the Icebreaker web interface from any page.

To log out of Icebreaker

In the upper right corner of the web browser running the Icebreaker web interface, click Logout:

Configuring and Administering Icebreaker 29

Chapter 4: Configuring and Administering Icebreaker


Manage Ingres Databases (see page 30) Check Ingres Services Status (see page 31) Change the Ingres User Password (see page 33) Run a System Report (see page 34) Schedule a System Reboot (see page 35) Check for System Updates (see page 37) View Logs (see page 41) View and Apply Rollbacks (see page 44)

After configuring Icebreaker, you can perform Ingres-specific operations in the web interface, including managing Ingres databases and other Ingres administrative tasks.

Manage Ingres Databases


Manage Ingres Databases You can create and manage Ingres databases for use with Icebreaker.

Note: These tools are for testing purposes only. We recommend using standard Ingres tools such as Visual DBA and the command line utilities to manage Icebreaker databases.

To create an Ingres database

Enter a database name and click Create.

The database, which is owned by the ingres user, is added to the list of managed databases.

To create a checkpoint for a database

Click Checkpoint to the right of the listed database.

Checkpoints are displayed.

Check Ingres Services Status


To view checkpoints for a listed database

Click the down arrow by the checkpoint listing for the database.

To restore a checkpoint

Click Restore to the right of the database checkpoint listing.

Check Ingres Services Status You can check the current status of Ingres services, and start and stop services.

To display the current status of Ingres services

Click Ingres on the left side of the screen and then click Ingres Database Services.

The current state of services is listed at the top of the page.

Check Ingres Services Status


To stop listed services

1. Click Stop.

The listed services are stopped, and the status displayed. For example:

2. Click OK.

The services status list is updated.

To start Ingres services

1. Click Start.

The services are started, and the status displayed. For example:

2. Click OK.

The services status list is updated.

Change the Ingres User Password


Change the Ingres User Password To make Icebreaker accessible over network connections (for example, JDBC, ODBC, and .Net connections), you must set the Ingres operating system user password.

To change the Ingres password

1. Click Ingres on the left side of the screen and then click Ingres User Password.

2. Enter and confirm a new password and then click OK.

The password is changed.

Run a System Report


Run a System Report At some point it may be necessary to compile a system report for troubleshooting purposes. The system report details the configuration and status of the Ingres database and system services.

To run a report

1. Click Ingres on the left side of the page and then click System Report.

2. Click Check Now.

A status box shows the progress of the report:

Schedule a System Reboot


When the report is complete, the status box turns green if successful or red if an error occurred:

If the report was successful, a TAR file will be emailed to each of the notification email addresses specified.

If the report fails, you should report the last line in the status box to Ingres.

3. Click OK at the bottom of the page when you are finished viewing the report.

Schedule a System Reboot You can reboot or shut down the Icebreaker server now, or schedule a reboot for a later date and time. For instructions, see the appropriate procedure, following.

To reboot Icebreaker now

1. Click Schedule Reboot on the left side of the screen.

The Schedule System Reboot page is displayed.

Schedule a System Reboot


2. Click Reboot.

A confirmation message is displayed at the top of the page.

3. Click OK.

The Icebreaker server is rebooted.

To shut down Icebreaker now



2. Click Shutdown.

A confirmation message is displayed at the top of the page.

3. Click OK.

The Icebreaker server is shut down.

To schedule a reboot of Icebreaker



2. Click Schedule.

A calendar pop-up appears:

3. Select the month by clicking the > button; select the year by clicking the >> button.

4. Click the date for which you want to schedule a reboot.

5. Select the time for the scheduled reboot.

Note: To cancel the scheduling operation at any time, click Cancel.

6. Click Save.

The calendar control closes, and the scheduled reboot is displayed above the buttons on the Schedule System Reboot page.

Check for System Updates


To cancel a scheduled reboot



2. Click Schedule.

A calendar pop-up appears.

3. Select the month by clicking the > button; select the year by clicking the >> button.

4. Click the date of the scheduled reboot.

5. Select the time of the scheduled reboot.

6. Click Remove.

The calendar control closes, and the scheduled reboot is removed.

Check for System Updates Icebreaker is configured to automatically apply updates, but you can modify this setting or change when the system checks for updates.

To modify this configuration

1. Click System Updates on the left side of the screen.

The System Updates page is displayed.



2. Click the Preferences tab on the right side of the screen:

3. (Optional) Clear the Check for updates option if you do not want Icebreaker to periodically check for system updates.

If you leave the box selected, you can change the day and time to check for updates.

4. (Optional) Clear the Automatically install updates option if you do not want system updates to be installed automatically.

Note: To manually install system updates, see Change System Update Preferences (see page 39).

5. Click Save.

More information:

View and Apply Rollbacks (see page 44)



Change System Update Preferences

You can change system update preferences or manually update Icebreaker on the System Updates page.

To manually apply a system update

1. Click System Updates on the left side of the screen.

2. Click Check Now to check for necessary updates to Icebreaker.

Icebreaker queries the software repository at Ingres to determine whether an update of Icebreaker is available. When the search completes successfully, the following is displayed.

If the query fails, the following message is displayed.

Updates can fail because of a lack of network connectivity, or an invalid (or blank) entitlement key.



3. If the check was successful, click OK to display details of any available updates.

The following is an example:

If no updates are necessary after a successful check, clicking OK returns a status message stating that “No updates are available.”

4. Click the down arrow by System Update to see details of the updated items.

View Logs


5. Click Apply Now to download and apply the update to Icebreaker.

This may take some time and can cause some system services to be restarted, as shown in the following example:

View Logs You can view the Conary log or the Icebreaker system log.

View Logs


View the Conary Log

The Conary log is the Icebreaker system package management log. (Packages include Ingres and operating system packages.) This log shows system update history. You can download the log to a text file.

To view the Conary log

Click View Conary Log on the left side of the screen.

The Conary log is displayed.

To download the Conary log to a file

1. Scroll to the bottom of the Conary log page.

2. Click Download.

The log is displayed in its own browser window.

3. Click File, Save As to save the log contents to a local file.

4. Click the Back button on your browser to return to the previous page.

View Logs


View the Icebreaker System Log

The Icebreaker system log displays diagnostic information.

To view the system log

Click View Log on the left side of the screen.

The Icebreaker system log is displayed.

View and Apply Rollbacks


View and Apply Rollbacks When you apply system updates, Project Icebreaker saves the previous configuration in a rollback package. You can view available rollbacks on the View and Apply Rollbacks page.

Note: When you apply multiple rollbacks, you must apply them in order, the most recent to the least recent.

To view available rollbacks

Click View and Apply Rollbacks on the left side of the page.

Available rollbacks are displayed on the right side of the page.

To apply a rollback

1. Click View and Apply Rollbacks on the left side of the page.

Available rollbacks are displayed on the right side of the page.

2. Click the down arrow next to the most recent rollback.

3. Click Rollback.

The current version is rolled back to the previously updated version.

More information:

Check for System Updates (see page 37)

icebreaker installation and configuration...

Documents