Oracle ZFS Storage Appliance

Simulator Quick Start Guide

March 2015

Part No: E39468-05

This document is a guide to Oracle ZFS Storage Appliance Simulator setup and initial configuration. The
Simulator introduces you to the power and simplicity of the Oracle ZFS Storage Appliance software using
VirtualBox and is identical in every way to the appliance version, with the exception of clustering.
Use the following sections for basic setup:

First Steps on page 2 - Complete all prerequisites before beginning setup and configuration.
VirtualBox Setup on page 3 - Set up the Simulator virtual machine in VirtualBox.
Configuring the Simulator on page 4 - Complete basic configuration in your browser.

For additional configuration, refer to these sections (optional):

Bridged Networking Setup on page 8 - Enable access to the Simulator from other machines on
your network.
Example Filesystem Setup on page 10 - Set up a simple filesystem share over SMB.
Preparing for Remote Replication on page 11 - Prepare for replication between two Simulators.

First Steps
Before you begin the setup and configuration procedures, complete the following prerequisites.
1. Ensure that your host system (laptop, desktop, server) has sufficient resources to support the Simulator's
configuration of 2560 megabytes of memory and 125 gigabytes of dynamically allocated disk space.
2. Check that your CPU has 64-bit capability and supports hardware virtualization; to do so, refer to your
system information or the documentation for your hardware manufacturer.
3. Check that either Intel Virtualization Technology (VT-x) or Advanced Micro Devices Virtualization
(AMD-V) is enabled on your system. Often these settings are within the BIOS, sometimes under
chipset, processor, security, power, or advanced settings. The BIOS menu is usually accessible during
reboot by pressing specific keys. Your system may require a BIOS update for these settings to be
available. For Intel-based Apple products, you might need to install the latest EFI firmware update. For
details, refer to your system information or the documentation for your hardware manufacturer.
4. Download and decompress the latest Oracle ZFS Storage Simulator from the Oracle Technical
Network (http://www.oracle.com/technetwork/server-storage/sun-unified-storage/
downloads/sun-simulator-1368816.html).
5. Download and install the latest VirtualBox package and extension pack (minimum version 4.2.12) that
is compatible with your operating system from https://www.virtualbox.org/. Read the "Network
Interfaces" warning and accept to continue installation.
When you install VirtualBox, a host-only adapter is defined by default. You can use this adapter for the
host-only network used during initial Simulator configuration. For details about host-only networks,
refer to the VirtualBox documentation (https://www.virtualbox.org/manual/ch06.html).
6. Open VirtualBox and verify that a host-only adapter is defined by navigating to File > Preferences >
Network > Host-only Networks. If there is no host-only adapter, click the plus icon to add one.

Oracle ZFS Storage Appliance Simulator Quick Start Guide

Ensure that the DHCP server is set up and enabled by clicking the screwdriver icon

7. If you are on a virtual private network (VPN), ensure that it allows access to the local host network. If it
does not, you may not be able to access the Simulator while on the VPN.

VirtualBox Setup
Complete the following steps to set up the Oracle ZFS Storage Appliance Simulator in VirtualBox.
1. Start VirtualBox and select Import Appliance from the File menu.
2. Navigate to and choose the Simulator OVF file and click Next.
3. If desired, change any of the default settings, including the name. The RAM setting must be at least
2560 megabytes, which is the default.
4. Click Import.
5. Select the Simulator in VirtualBox and go to Settings > System > Acceleration. Verify that "Enable VTx/AMD-V" is checked.
If hardware virtualization is not enabled on your system, you will not be able to access the Acceleration
tab; see First Steps on page 2.

6. To start the VM, click Start. The Boot screen appears.

If you get this error message, you need to enable VT-x/AMD-V as described in First
Steps on page 2.

Oracle ZFS Storage Appliance Simulator Quick Start Guide

7. Press any key to begin configuration. The Configuration screen appears.

8. Use the arrow keys on your keyboard to navigate among the fields on this screen. Verify that the IP
address and IP netmask match the default host-only network. If you modified any values in the hostonly configuration settings in VirtualBox, you may see different values entered on this screen.
Complete the remaining fields:

Host Name: Any name you want

DNS Domain: localdomain

Default Router: Match the IP address, but use 1 as the final octet (example: 192.168.56.1)

DNS Server: Match the IP address, but use 1 as the final octet (example: 192.168.56.1)
Password: Any password you want
9. Press the ESC key followed by the 1 key to confirm these settings.
10. Wait until the screen provides you with two URLs to use for subsequent configuration and
administration: one with an IP address and one with the hostname you specified.

You will use the IP address URL to configure the Simulator in the next section. You cannot access the
Simulator using the hostname URL without more advanced configuration, as described in Bridged
Networking Setup on page 8. You must configure the Domain Name Server (DNS) to map the
hostname to its corresponding IP address.

Configuring the Simulator

Complete basic Simulator configuration in the Browser User Interface (BUI) using the following steps.
Note - The Simulators default configuration, described here, uses a host-only network, meaning that

the Simulator can only be accessed from the computer on which it is running. You can later enable
access to the Simulator from other machines on your network, as described in Bridged Networking
Setup on page 8.
1. Open a web browser and navigate to the URL with the IP address provided in the last step of
VirtualBox Setup on page 3. Accept the web browser security warning.
Oracle ZFS Storage Appliance Simulator Quick Start Guide

The login screen appears.

2. Type the username root and the password you created in the configuration screen, then click LOGIN.
The Welcome screen appears.

Note - At the top right of every BUI page is a HELP link to the Simulator online help, which is context-

sensitive and provides more detailed information about each configuration step.
3. Click START to begin setup.
4. On the Configure Networking screen, click COMMIT to continue.

5. Click COMMIT to skip the Configure DNS screen. You can later set these parameters to map the
hostname to its corresponding IP address, as described in Bridged Networking Setup on page 8.

Oracle ZFS Storage Appliance Simulator Quick Start Guide

6. On the Configure Time screen, optionally set the appliance time, or click COMMIT to skip. You
can later synchronize the appliance time with a Network Time Protocol (NTP) server, as described in
Bridged Networking Setup on page 8.

7. Click COMMIT to skip the Configure Name Services screen. You can later configure NIS, LDAP, and
Active Directory for user access control, as described in Bridged Networking Setup on page 8.

8. Create a storage pool by clicking the plus icon

next to Available Pools.

9. Name the new storage pool and click APPLY.

Oracle ZFS Storage Appliance Simulator Quick Start Guide

10. Use the pull-down list next to Data Devices to allocate storage to the pool, then click COMMIT.

11. Select a data profile based on your business needs. Click COMMIT to configure the pool.

12. The new pool and a description of allocation appear. Click COMMIT to continue.

13. On the Registration & Support screen, select LATER and click OK to confirm.
When setting up a real Oracle ZFS Storage Appliance, you use this screen to register the appliance,
enable Phone Home support, and configure web proxies required to connect to the Oracle support site.

Oracle ZFS Storage Appliance Simulator Quick Start Guide

14. The final configuration screen appears with links to further documentation.

You can return to the configuration wizard at any time by navigating to Maintenance > System and
clicking INITIAL SETUP. If accessing the Simulator through the CLI, enter the context maintenance
system and enter the command setup. Current settings are not changed unless you explicitly change
them. User data on the storage pool (including projects and shares) is not affected.
15. To close the Simulator, click LOGOUT near the top of the screen and close the VM command window.
16. To power off the Simulator, in VirtualBox, select Machine > Close. For details about save and power-off
options, refer to the VirtualBox documentation (http://www.virtualbox.org/manual/ch01.html).

Bridged Networking Setup

When first installed, the Oracle ZFS Storage Appliance Simulator can only be accessed from the computer
on which it is running. You can optionally enable access to the Simulator from other machines on your
network by setting up bridged networking using the following steps.
For detailed information about bridged networking and limitations for your operating system, refer to the
VirtualBox documentation (http://www.virtualbox.org/manual/ch06.html).
1. Collect the following information for the network you want to use:

IP address and netmask

Host name
DNS domain name
DNS server IP address
Default router (gateway) IP address

You may need to contact your network administrator for this information.
2. Open VirtualBox. From the main screen, select the Simulator virtual machine and click Start. Wait until
the console login prompt appears (hostname console login).
3. Log in to the CLI by entering username root and the password you created during VirtualBox
Setup on page 3. Wait until the hostname prompt appears.
4. Go to configuration net routing and use the show command to list the routing properties. Set the
gateway value appropriate for your network.
hostname:> configuration net routing
hostname:configuration net routing> show
ROUTE DESTINATIONGATEWAYINTERFACE TYPE STATUS
route-000 0.0.0.0/0192.168.56.1e1000g0 static active
hostname:configuration net routing> select route-000

Oracle ZFS Storage Appliance Simulator Quick Start Guide

hostname:configuration net route-000> set gateway="GATEWAY"

hostname:configuration net route-000> commit

5. Go to configuration net interfaces and use the show command to list the interface properties. Set
the IP address and netmask values appropriate for your network.
hostname:> configuration net interfaces
hostname:configuration net interfaces> show
Interfaces:
INTERFACE STATECLASS LINKS ADDRSLABEL
e1000g0 upip e1000g0192.168.56.101/24Untitled Interface
hostname:configuration
hostname:configuration
hostname:configuration
hostname:configuration

net
net
net
net

interfaces> select e1000g0

interfaces e1000g0> set v4addrs="IP/NETMASK"
interfaces e1000g0> set v4adhcp=false
interfaces e1000g0> commit

6. In VirtualBox, select the Simulator virtual machine, and click Settings.

7. Select Network and configure Adapter 1 so that it is attached to the Bridged Adapter.

8. Optionally, configure services in the Simulator BUI by navigating to Configuration > Services and
clicking the name of the service you want to configure:

DNS - Set parameters to map the hostname to its corresponding IP address.

NTP - Synchronize appliance time with an NTP server by completing the fields under NTP Settings,
or set the appliance time to match the time and date according to your web browser by pressing
SYNC under Clock.

Note - The NTP service can take several minutes to complete startup due to the nature of NTP and the

adjustment of the system clock.

NIS - Configure this name service to authenticate users and groups using the Network Information
Service (NIS).
LDAP - Configure this name service to authenticate users and groups using the Lightweight
Directory Access Protocol (LDAP).
Active Directory - Configure this name service to authenticate users and groups using a Microsoft
Active Directory Server.

Services can also be configured in the CLI by going to configuration services.

Refer to the Simulator online help for detailed information about working with services.

Oracle ZFS Storage Appliance Simulator Quick Start Guide

Example Filesystem Setup

Complete the following steps to set up a simple filesystem share over Server Message Block (SMB) with
Windows user access.
1. Navigate to the Shares screen. Click the plus icon

next to Filesystems to create a new filesystem.

2. Name the filesystem demo and change the permissions for Group and Other to allow anyone to read,
write, and execute on the filesystem. The filesystem is part of the default Project. Click APPLY.

3. The filesystem appears on the Shares screen. Mouse over the demo list item and click the Edit Entry icon
to edit the filesystem attributes.

4. Click the Protocols link.

5. In the SMB section, clear the "Inherit from project" checkbox and enter Resource Name demo. Click
APPLY to save the changes.

Oracle ZFS Storage Appliance Simulator Quick Start Guide

10

6. Click Configuration to access the Configuration > Services screen.

7. Enable the SMB service by clicking the power icon . The state changes from Disabled to Online.
8. Finally, configure a user with access to the filesystem share. Click USERS in the navigation bar, and
click the plus icon next to Users to create a new user.

9. Select the Local Only radio button, set the Username and Password, and click ADD.
10. Log out of the Simulator by clicking LOGOUT near the top of the screen.
11. From a Windows client, connect to the IP address of your Simulator and log in with the credentials you
set in step 9 to acess the shared filesystem demo.

Preparing for Remote Replication

To prepare for remote replication between two Simulators, assign a unique appliance serial number to each
Simulator by performing the following steps. This procedure only needs to be performed once because all
settings are retained, even when powering on and off the Simulators.
1. Create two appliance Simulators as described in VirtualBox Setup on page 3, but create a
different host name and IP address for the second Simulator in the configuration screen.
2. Complete initial configuration of both Simulators as described in Configuring the
Simulator on page 4. Do not log out of the second Simulator when finished.
3. On the second Simulator, navigate to Maintenance > System, click FACTORY RESET, and click OK.

4. When prompted in the VirtualBox boot screen, press any key to begin configuration.
5. Complete all required fields marked with an asterisk (*). Be sure to enter the correct host name and IP
address for the second Simulator.
6. Press the ESC key followed by the 1 key to confirm these settings.
7. Direct a web browser to the URL with the IP address of the second Simulator, and log in.
8. Click START and repeat the setup procedure.
Oracle ZFS Storage Appliance Simulator Quick Start Guide

11

Copyright 2015, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as
expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or
display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT END USERS. Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S.
Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication,
disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to
license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications,
including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe,
backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in
dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC
International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The
Open Group.
This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not
responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any
loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Copyright 2015, Oracle et/ou ses affilis. Tous droits rservs.

Ce logiciel et la documentation qui laccompagne sont protgs par les lois sur la proprit intellectuelle. Ils sont concds sous licence et soumis des restrictions dutilisation et de
divulgation. Sauf disposition de votre contrat de licence ou de la loi, vous ne pouvez pas copier, reproduire, traduire, diffuser, modifier, breveter, transmettre, distribuer, exposer, excuter,
publier ou afficher le logiciel, mme partiellement, sous quelque forme et par quelque procd que ce soit. Par ailleurs, il est interdit de procder toute ingnierie inverse du logiciel, de le
dsassembler ou de le dcompiler, except des fins dinteroprabilit avec des logiciels tiers ou tel que prescrit par la loi.
Les informations fournies dans ce document sont susceptibles de modification sans pravis. Par ailleurs, Oracle Corporation ne garantit pas quelles soient exemptes derreurs et vous invite, le
cas chant, lui en faire part par crit.
Si ce logiciel, ou la documentation qui laccompagne, est concd sous licence au Gouvernement des Etats-Unis, ou toute entit qui dlivre la licence de ce logiciel ou lutilise pour le compte
du Gouvernement des Etats-Unis, la notice suivante sapplique:
U.S. GOVERNMENT END USERS. Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S.
Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication,
disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to
license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
Ce logiciel ou matriel a t dvelopp pour un usage gnral dans le cadre dapplications de gestion des informations. Ce logiciel ou matriel nest pas conu ni nest destin tre utilis dans
des applications risque, notamment dans des applications pouvant causer des dommages corporels. Si vous utilisez ce logiciel ou matriel dans le cadre dapplications dangereuses, il est de
votre responsabilit de prendre toutes les mesures de secours, de sauvegarde, de redondance et autres mesures ncessaires son utilisation dans des conditions optimales de scurit. Oracle
Corporation et ses affilis dclinent toute responsabilit quant aux dommages causs par lutilisation de ce logiciel ou matriel pour ce type dapplications.
Oracle et Java sont des marques dposes dOracle Corporation et/ou de ses affilis. Tout autre nom mentionn peut correspondre des marques appartenant dautres propritaires quOracle.
Intel et Intel Xeon sont des marques ou des marques dposes dIntel Corporation. Toutes les marques SPARC sont utilises sous licence et sont des marques ou des marques dposes de
SPARC International, Inc. AMD, Opteron, le logo AMD et le logo AMD Opteron sont des marques ou des marques dposes dAdvanced Micro Devices. UNIX est une marque dpose dThe
Open Group.
Ce logiciel ou matriel et la documentation qui laccompagne peuvent fournir des informations ou des liens donnant accs des contenus, des produits et des services manant de tiers. Oracle
Corporation et ses affilis dclinent toute responsabilit ou garantie expresse quant aux contenus, produits ou services manant de tiers. En aucun cas, Oracle Corporation et ses affilis ne
sauraient tre tenus pour responsables des pertes subies, des cots occasionns ou des dommages causs par laccs des contenus, produits ou services tiers, ou leur utilisation.