Copyright © 2008, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices
In Oracle Virtual Compute Appliance X3-2 with pre-installed Release 1.0.1 software, compute node provisioning functionality is disabled at the factory. In order to complete the first-time configuration of your system, an update of the software is required. This chapter provides step-by-step instructions to initialize the system with Release 1.0.2 of the software.
Before starting the system and applying the initial configuration, read and understand the Oracle Virtual Compute Appliance X3-2 Release Notes. Chapter 4, Known Limitations and Workarounds provides information that is critical for correctly executing the procedures in this document. Ignoring the release notes may cause you to configure the system incorrectly. Bringing the system back to normal operation may require a complete factory reset.
To be able to install and provision the compute nodes correctly, and deploy your virtual infrastructure, it is critical that you execute this procedure accurately and complete it successfully.
A hardcopy of the Oracle Virtual Compute Appliance Quick Start Poster is included with the shipment of your Oracle Virtual Compute Appliance X3-2. Follow the instructions up to step 8. At this point, you can use the browser on the workstation connected to the internal appliance management network to open the Oracle Virtual Compute Appliance Dashboard.
Press the power button of the second management node. Wait approximately 5 minutes to allow the management system to power on completely. You are now ready to configure the appliance for the first time.
DO NOT change the system password prior to the mandatory update.
Follow these steps to configure the network connectivity of your Oracle Virtual Compute Appliance.
Using SSH and an account with superuser privileges, log in to
both management nodes to create the
install.log file.
The default root password is
Welcome1.
Use a workstation connected to the provided cable attached to
port 24 of the Oracle Switch ES1-24. In this internal appliance
management network, the first management node IP address is
192.168.4.3
; the second management node IP address is
192.168.4.4
.
Port 24 of the Oracle Switch ES1-24 has a minimum transfer rate of 1000 Mbit/s (GbE). If your workstation requires a lower speed (Fast Ethernet, 100 Mbit/s), you may use port 19 of the second Oracle Switch ES1-24, which is the one on the right hand side if you look from the rear of the rack. A Cat5 Ethernet cable is plugged in and coiled up on the side.
# ssh root@192.168.4.3 root@192.168.4.3's password: root@ovcamn05r1 ~]# touch /tmp/install.log root@ovcamn05r1 ~]# ssh root@192.168.4.4 root@192.168.4.4's password: root@ovcamn06r1 ~]# touch /tmp/install.log root@ovcamn06r1 ~]# exit logout Connection to 192.168.4.4 closed. root@ovcamn05r1 ~]#
Using the web browser on the workstation, connect to the Oracle Virtual Compute Appliance Dashboard with the predefined IP address of the first management node: http://192.168.4.3.
192.168.4.3 is the predefined port IP address for configuring Oracle Virtual Compute Appliance X3-2. If there is another device on your network that is using this IP address, you should change the conflicting device's IP address prior to connecting to Oracle Virtual Compute Appliance X3-2.
Log into the Oracle Virtual Compute Appliance Dashboard using the user name ovcaadmin and password Welcome1.
Go to the Network Setup tab and complete the following configuration fields:
Management Node 1: Use this field to specify an IP address within your data center network that can be used to directly access this management node.
Hostname: Use this field to specify the host name for the first management node system.
Management Node 2: Use this field to specify an IP address within your data center network that can be used to directly access this management node.
Hostname: Use this field to specify the host name for the second management node system.
Domain Name: Use this field to specify the domain that each of the management node systems belong to.
Virtual IP: Use this field to specify the shared Virtual IP address that is used to always access the active management node. This IP address must be in the same subnet as the IP addresses that you have specified for each management node.
Netmask: Use this field to specify the netmask for the network that the Virtual IP address and management node IP addresses belong to.
Default Gateway: Use this field to specify the default gateway for the network that the Virtual IP address and management node IP addresses belong to.
NTP: Use this field to specify the NTP server that the management nodes and other appliance components must use to synchronize their clocks to.
DNS: Use the fields provided here to specify at least one DNS server that the management nodes can use for domain name resolution.
DO NOT change the system password prior to the mandatory update.
If you change the system password before successfully completing the software update, a full re-installation of the Oracle Virtual Compute Appliance is required.
Click the OK button at the bottom of the page.
The settings that are currently displayed on the page are saved, and the configuration on each of the management nodes is updated accordingly.
The configuration is typically up-to-date after 10-20 minutes. Then the appliance is ready for the software update.
The mandatory initial software update, and any further update of Oracle Virtual Compute Appliance X3-2, is performed from the command line of the management node. Software updates are a three-tier process. First, a zipped ISO containing the updated software must be downloaded from My Oracle Support and made available on an HTTP or FTP server. From there, the ISO is downloaded to the Sun ZFS Storage Appliance 7320. When the download is complete and the software is unpacked in the appropriate directories, the update is activated and applied to each affected component.
If direct public access is not available within your data center and you make use of proxy
servers to facilitate HTTP, HTTPS and FTP traffic, it may be necessary to edit
/etc/ovca.conf, on each management node, to ensure that the correct
proxy settings are specified for a download to succeed from the Internet. This depends on the
network location from where the download is served. For more information, refer to the section
Adding Proxy Settings for Oracle Virtual Compute Appliance Updates in the Oracle Virtual Compute Appliance X3-2 Administrator's Guide.
Updates are controlled with ovca-updater commands. To display usage options, enter ovca-updater --help at the shell prompt of the management node.
Follow these steps to update the Oracle Virtual Compute Appliance software.
Log into My Oracle Support and download the Oracle Virtual Compute Appliance Release 1.0.2 update.
You can find the update by searching for the product name “Oracle Virtual Compute Appliance”, or for the patch related to Bug Number 17967425.
Make the update, a zipped ISO, available on an HTTP or FTP server that is reachable from your Oracle Virtual Compute Appliance.
Using SSH and an account with superuser privileges, log into the master management node.
# ssh root@192.168.4.3 root@192.168.4.3's password: root@ovcamn05r1 ~]#
Download the ISO to your Oracle Virtual Compute Appliance.
# ovca-updater -m download -s -u http://download-url.example.com/ovca-version-build.iso.zipDownload of http://download-url.example.com/ovca-version-build.iso.zipstarted successfully. \ Task id is 5ba4f1a09c9546b29a560e3d6682ce67
Check the progress of the ISO download. When the download is finished, proceed with the next step.
# ovca-updater -m download -l -i 5ba4f1a09c9546b29a560e3d6682ce67 Task ID Pct Elapsed time Status 5ba4f1a09c9546b29a560e3d6682ce67 60% 155.305 sec RUNNING # ovca-updater -m download -l -i 5ba4f1a09c9546b29a560e3d6682ce67 Task ID Pct Elapsed time Status 5ba4f1a09c9546b29a560e3d6682ce67 70% 285.904 sec RUNNING # ovca-updater -m download -l -i 5ba4f1a09c9546b29a560e3d6682ce67 Task ID Pct Elapsed time Status 5ba4f1a09c9546b29a560e3d6682ce67 100% 338.102 sec SUCCESS
To list all downloads and their status, enter this command:
# ovca-updater -m download -l Task ID Pct Elapsed time Status 5ba4f1a09c9546b29a560e3d6682ce67 100% 338.102 sec SUCCESS
When the download has completed successfully, activate it by launching the update process.
# ovca-updater -m update -s WARNING:root:Activating update process. Starting with nonmaster node 192.168.4.4
Once you issue this command, the update process is initiated as described in the section Oracle Virtual Compute Appliance X3-2 Software Update of the Oracle Virtual Compute Appliance X3-2 Administrator's Guide.
Check the progress of the software update.
# ovca-updater -m update -l Mgmt Node IP Update Started Update Ended Elapsed 192.168.4.4 2013-10-02 16:52:14 ------------------- 0:02:18
At a certain point during the update process, the active management node is rebooted. As a result, the SSH connection is lost. In addition, this may cause the Dashboard to become unresponsive temporarily, and you may be required to log back in.
When the master management node reboots, the secondary (updated) management node assumes the master role. The original master management node is then also updated and becomes the backup management node.
Once all Oracle Virtual Compute Appliance services are running on the new master management node, the provisioning of the compute nodes begins automatically. The provisioning process is described in detail in the section Provisioning and Orchestration of the Oracle Virtual Compute Appliance X3-2 Administrator's Guide.
Log into the Oracle Virtual Compute Appliance Dashboard using the user name ovcaadmin and password Welcome1.
Go to the Hardware View tab to monitor the compute node provisioning.
For more details, refer to the section Hardware View of the Oracle Virtual Compute Appliance X3-2 Administrator's Guide.
When all compute nodes have completed provisioning and have joined the Oracle VM server pool, the appliance is in Ready state, meaning virtual machines (VMs) can be deployed.
Copyright © 2008, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices