Documente Academic
Documente Profesional
Documente Cultură
The product is designed and built to operate as 2nd tier storage alongside pre-existing commercial
storage, providing online continuation of data for months and years, with tapes relegated to
archival purposes only. The appliance is targeted for 2nd-tier NAS and iSCSI applications requiring
extremely low cost storage as well as dramatically simplified provisioning, expansion, backup,
replication and archiving. NexentaStor can also be used as a primary NAS in businesses that wish
to expand at closer to commodity pricing.
NexentaStor product is available in two packages:
• NexentaStor Virtual Appliance – pre-installed VMware or Xen1 image that will run
unmodified on the corresponding hosted products listed below.
It is recommended to deploy appliance on a single dedicated x86/64 based platform, with at least
512MB of RAM. Quick summary of requirements for the Virtual and Unified Appliance products
follows below.
1. VMware® is a registered trademark of VMware, Inc. Xen® and Citrix® are registered trademark of Citrix Systems,
Inc. All other trademarks and names mentioned herein may be trademarks of their respective companies.
2. For product availability and pricing, please refer to NexentaStor Products page.
• Documentation mentions two built-in user accounts: root and admin. What is the
difference?
• At least two physical4 and/or virtual disks, with at least 4GB of total free disk space for the
latter. Note that NexentaStor uses one of the hard drives for a system disk – the disk that
holds system folder and all subsequent system upgrades.
• At least 1 GB of RAM
• At least two physical and/or virtual disks, with at least 4GB of total free disk space for the
latter. Note that NexentaStor uses one of the hard drives for a system disk – the disk that
holds system folder and all subsequent system upgrades.
3. NexentaStor Virtual Appliance contains configuration file that specifies 64bit architecture. The Virtual Appliance,
however, will run on a 32bit hardware architectures (and within 32bit VM) since the OS kernel has the capability to
automatically determine the architecture and load the corresponding (32bit or 64 bit) libraries.
4. Note that your VMware product may support direct access to local hard disks
• 2 identical relatively small disks for high-availability system folder (for operating system
and the rest appliance's software) and additional drives/storage for data volumes.
For more information on hardware compatibility, please visit NexentaStor F.A.Q., and in particular
the following two F.A.Q. entry:
Document Conventions
Cross-reference
Terminology
The following lists just a few terms used throughout this document. For the complete list of terms,
please see [1].
Term Comment
NMS Nexenta Management Server. There is only one server instance per
appliance. The server provides public and documented Storage
Appliance API (SA-API) available to all appliance management and
monitoring clients, remote and local, including (but not limited to)
NMC.
5. You can certainly also install Unified Appliance CD yourself into an “empty” VMware or Xen Virtual Machine.
NMV Nexenta Management View. Web client uses the same SA-API (above)
to communicate with the NMS. NMV shows status of all appliances on
the network, displays graphical statistics collected by "statistic
collectors" (see below), and more.
NexentaStor Unified Appliance ISO image is available in two editions: Developer Edition and Free
Trial Edition. The Products page on the website summarizes the differences between NexentaStor
editions, in terms of functionality, available support, available extensions, and upgrade options:
Prior to installation, you may also want to visit NexentaStor FAQ page,
and in particular, the following frequently asked questions:
Finally, do not forget to check the hardware requirements – Section “System Requirements –
Unified Appliance”.
To install, insert the CD and boot from it, following the on screen instructions. With the very first
screen, the boot manager invites you to start the hardware installation6:
6. Note that some of the screenshots throughout this document may differ in your version of NexentaStor.
The appliance can be installed via serial port COM1. The latter option is available if
your system BIOS supports keyboard/monitor to serial port redirection. Please pay
attention to the very first menu – the boot manager menu, an example of which is
shown on the picture above. This shows that by default the boot manager will try to
use serial port, that is, unless you hit a Down arrow and ask it to boot using directly
attached keyboard/monitor.
NexentaStor can be installed via directly attached keyboard/monitor, as well as via serial port
COM1.
To install via serial port, please configure the BIOS to use serial port
input. The serial port parameters are the most common 9600 8,N,1
After configuring the BIOS to use serial port and inserting Installation CD,
you should see Nexenta Installer's welcome message on the remotely
connected terminal window. Please make sure that the remote terminal
client supports ANSI or VT100 emulation and is also configured for 9600
8,N,1.
You can postpone the installation, and optionally run a thorough memory check – notice the 2nd
entry in the menu above. Choosing to do so brings the following screen, with a multitude of
available memory-checking options and algorithms. Use instruction at the bottom of the screen to
control the execution:
The next screen covers the product license7, which must be accepted to proceed further.
7. Evaluation license, in this particular example. Note that some of the screenshots throughout this document may be
outdated – captured from older versions of NexentaStor. This may be reflected in minor differences with the actual
appliance screens that you observe.
The corresponding drives are sometimes also called “root drives” or “boot drives”. At least one
drive is necessary to install the system. However, if you have two or three equal size disks with
sizes less than 100GB, it would be recommended to setup a mirror set for the system volume8:
8. Note that N-way mirror can sustain simultaneous failure of (N-1) drives.
The system volume is then formatted and the appliance software is installed. Please note that the
installer may pause for some period around 3% or 4% completion, as the packages are being
examined.
The progress bar may stay at 3% for some time, sometimes a few minutes.
Note that the installation continues in the background. Please wait.
Footnote at the bottom of the screen (see screenshot above) explains how to switch from Installer
to Shell (F2), to Log (F3), and back to the main screen (F1).
After all operations complete, you are asked to reboot the appliance. Please do so, and proceed to
Section “Three Easy Operations”.
The Virtual Appliance is provisioned with 2 virtual disks (one system disk 9 and one data disks) and
1GB of memory. Prior to powering on your new VM, take a moment to consider these settings.
You may want to add data disks. Note that you can change the Nexenta-supplied defaults at any
time, at the very first powering-on of the NexentaStor VM or later.
In general, there is a wealth of information on the Web and in print, related to deploying and
managing Virtual Machines. If you would like to research it, learn more about multiple available
VM deployment options, a good place to start would be VMware Documentation. This (research)
however, is optional – for product evaluation purposes 10 you could start by using the default
settings and the documentation provided with the appliance (see Section “References” below).
Getting started with NexentaStor Virtual Appliance is easy – essentially it boils down to extracting
the files from .zip or .tar.gz archive and booting the appliance in your preferred VMware
environment. This section provides instruction on running the appliance in both the VMware
Workstation (hosted) environment and the Hypervisor (ESX server) environment. But first:
Step 1. Check the requirements (Section “System Requirements – Virtual Appliance”), and
download Virtual Appliance:
9. Or, more exactly, one disk that is used for system volume and one disk that is not allocated.
10. and beyond..
• NexentaStor.vmx - configuration
Most importantly, one of the files above is the pre-installed Virtual Machine (VM) – the
.vmx image.
From here on, the next steps depend on your VMware environment.
11. For ZIP file format introduction and history, see for instance http://en.wikipedia.org/wiki/ZIP_(file_format)
ESX
As far as ESX is concerned, there are two basic ways to extract Virtual Appliance from the
downloaded compressed archive:
1) extract the archive on a Windows platform, and then copy the extracted files onto ESX
For the first way (extracting on Windows and copying), the detailed steps are: use any compliant
PKZIP utilities for .zip extension, or any archiver that supports .tar.gz – for .tar.gz extension,
respectively. The resulting folder is then uploaded onto ESX using VMware Infrastructure Client or
VMware vSphere Client, as illustrated in the next section.
You may also choose to copy the archive directly onto ESX server. The procedure outlined in this
document requires SSH root access, as per Knowledge Base article:
http://kb.vmware.com/selfservice/microsites/search.do?
language=en_US&cmd=displayKC&externalId=8375637
Once SSH root access is acquired, you can then SCP the archived Virtual Appliance using any
compliant SCP implementation (for instance, WinSCP for Windows). Next, SSH into ESX and
unpack the appliance. For the .tar.gz extension, the corresponding command would look like:
Workstation
Use the tools available on the platform to unpack the archive. For instance, on Linux you'd use tar
to run:
At this point you can simply boot it by pressing on a little green icon on the toolbar, or by
clicking “Power On” of the top level VM menu. You can also change configuration via Edit
virtual machine settings link (see picture above): add more virtual disks, memory, etc.
Step 5. Uploading pre-installed NexentaStor Virtual Appliance into ESX server. Or, in
VMware terms, adding the corresponding .vmx file (NexentaStor.vmx) to ESX Inventory:
12. Note that VMware vSphere(tm) is used here solely for illustration purposes.
Step 8. And finally, booting. You can power on NexentaStor VM by clicking a little green
triangle on the toolbar, or via the Inventory => Virtual Machine => Power menu.
The Virtual Appliance is provisioned with 1 virtual disks with pre-installed NexentaStor Appliance
and 1GB of memory. Prior to powering on your new VM, take a moment to consider these
settings. You may want to add data disks. Note that you can change the Nexenta-supplied
defaults at any time, at the very first powering-on of the NexentaStor VM or later.
Getting started with NexentaStor Virtual Appliance is easy – essentially it boils down to unzipping
the downloaded image and running it in your preferred Citrix environment. This section provides
detailed instructions:
Step 1. Check the requirements (Section “System Requirements – Virtual Appliance”), and
download Virtual Appliance.
Step 2. Unzip the downloaded ZIP13 archive into a new directory. The extracted archive will
contain the following files:
Step 3. To boot pre-installed image in Citrix XenServer, start your XenCenter. Select
“Import…” in the “VM” menu:
13. For ZIP file format introduction and history, see for instance http://en.wikipedia.org/wiki/ZIP_(file_format)
Click “Next”
In all cases – virtual and “bare-metal”, evaluation and commercial – it takes 3 easy operations to
deploy the appliance:
Step 2. Follow instructions on the appliance's console15 to register the appliance software:
14. Some of the screenshots throughout this document may be outdated – captured from older NexentaStor versions.
15. Nexenta Management Console a. k. a. NMC
To register NexentaStor Developer Edition, please click on the evaluation registration link
on the Community page, as shown below:
To register commercial version of the product, please follow instructions emailed to you
after you have purchased the license directly from Nexenta Systems, Inc at
http://www.nexenta.com/store, or via a certified third party vendor. The commercial
registration form will look as follows:
Notice the field “Machine Signature” on all product registration forms shown above.
You will need to enter the exact value as displayed on your appliance's console. In the example
Error: Reference source not found (see Step 2 on page #Error: Reference source not found) the
Machine Signature would be: DC56AFAD.
Fill out the rest of the corresponding registration form and click 'Submit Request'. An
automatically generated unique license key will be emailed to you, and you will be able to activate
the appliance.
• When I enter license key, I get an error message saying the key is invalid...
Key is case sensitive. Make sure to enter the key exactly as specified in the auto-
generated email. The '-' separating groups of key characters need to be entered as well.
Once the Registration Key is entered, (“TRIA-...” in the example above), proceed to
configure primary network interface. You can connect to the system as is via the stated
address if you configure a client on the same network with a 192.168.1.X type address.
Next, you will want to reconfigure the primary network interface. Choose DHCP if your
environment supports that, or elect to set up the interface statically (you will need to
specify the device’s IP address, subnet mask, default gateway, and DNS server addresses
to do so).
Step 4. After choosing your primary IP settings, you need to elect not to reconfigure:
At this point the appliance is installed and READY TO BE INITIALLY CONFIGURED via
appliance's web GUI.
Notice a brief instruction displayed on the console above the login prompt (highlighted). It
is essential to follow this instruction and use Internet Browser to perform a few most
basic configuration steps.
If your Internet Browser does not connect to the appliance, it is most probably
because the primary networking interface (Steps 4 and 5 above) is mis-
configured. You can always fix the configuration by logging in the console and
running:
Note that already at this point you could log into the appliance via Nexenta
Management Console (NMC) from either use the directly connected monitor or
by ssh-ing to the appliance's primary IP address. In both cases login as root, and
use the password that is sent to you in registration email (see Step 4 above).
If you elect to do so, you will be greeted by the following SYSTEM NOTICE:
Step 7. Your next step is to continue appliance's configuration. The appliance has a web
interface that will also initialize the system if the network (see Step 6 above) is available.
Use the URL printed above. Security certificate is displayed since you are connecting via
secure connection:
Step 8. NexentaStor Initial Configuration Wizard is subdivided into two guided stages:
Wizard demonstration is available on the website. The demo shows the most
essential steps (of setting up the installed appliance), and provides
commentary.
Notice the URL in the browser's address location window (below). This is the appliance's
web GUI URI, the same one that was displayed at the end of Section “B. Configuring
primary network interface and NMV transport” (above).
For more information on the Wizard and Wizard-guided steps of configuring the appliance,
see “NexentaStor User Guide” [1], Section “Initial Configuration Wizard”, and Initial
Configuration Wizard tutorial on the website (see [3]).
• Documentation mentions two built-in user accounts: root and admin. What is the
difference?
It is important to setup at least a mail server and mailing address to system notifications,
reports, and faults to be reported. Configure as necessary for your site.
If the mailer is not configured and Inbox is disabled, the appliance will fail to
notify of important events, and the notifications will silently end up in the
appliance's log.
You can always review the changes, and either apply them (Save Configuration), or go
back and make more changes (Previous Step):
The Stage-II Configuring Network and Storage Wizard can be run multiple times.
Stage-II Wizard can be run multiple times. Even though Nexenta Management View
provides a superset of functionality, you may find it convenient to re-run the Wizard, by
pointing your Internet Browser to the /wizard2 URL. In the example (below) that URL is:
http://192.168.1.108:2000/wizard2
The following shows some of the Stage-II Wizard screens, to configure Networking and
Storage. Start from configuring appliance's primary interface:
Stage-II Wizard contains a number of optional steps, to setup network and storage, data
volumes, folders and zvols.
At the end of this sequence you will be asked to create a system checkpoint. For the
freshly installed appliance, it is recommended to create system checkpoint upon initial
configuration.
The appliance supports all 3 types of iSCSI discovery. Here you can connect to iSCSI
Please see the system notice on screen and NexentaStor F.A.Q. for more information.
Finally, with its last screen the Wizard invites to review and save all changes:
The Wizard will also recommend to create system checkpoint (see above) – “a snapshot of
the freshly installed and initially configured appliance”. Please see [2] for introduction and
[1] for detailed information on appliance's upgrade/checkpoint functionality.
The Stage-II Installation Wizard can be run multiple times. Even though NMV provides
a superset of functionality, you may still find it convenient to re-run the Wizard. To do
this, point your Internet browser to a the following URL:
https://<appliance's IP address:2000>/wizard2
or:
https://<appliance's hostname:2000>/wizard2
or:
http://<appliance's hostname:2000>/wizard2
Make sure to use the 2000 port and the right (http or https) prefix.
You can start using NexentaStor Free Trial Edition, and after a trial period decide to purchase a
commercial version. If at this point you already deployed the Trial Edition, there will be no need to
reinstall. As part of the product purchasing process, a new license key will be generated and sent
to you. There will be no downtime.
If you already started using NexentaStor Developer Edition in production environment, and then
decided to convert it into a commercial version with better support options, extra features, ability
to run commercial plugins, and fewer (or none) usage restrictions – please contact technical
support. The preferred and recommended option though is to start using NexentaStor Free Trial
Edition which does not require any conversion whatsover.
For a summary and details on available product editions, please refer to NexentaStor
Editions Table on the website, or Section "2. Hardware Installation" in this document.
To display appliance's license information, simply click on the About menu of the Nexenta
Management View top level toolbar, for example:
If you changed your licensing terms (e. g., added more capacity) and received a new license key
for the appliance that is already in use, re-register the appliance using the following NMC
command:
For information on registering (and re-registering) appliance, see the corresponding manual page:
Or, you can re-register using the appliance' web GUI interface:
In addition, starting with version 2.1, there is a convenient way to request additional storage
capacity. You can simply specify the number of additional terabytes you'd need to deploy with a
given NexentaStor appliance, and a new license key will be automatically generated and sent to
you to replace the old license.
For more information on “licensed storage capacity”, please see the following F.A.Q. entry:
• When I enter license key, I get an error message saying the key is invalid...
Use the Technical Support form (below) to report any technical problems and/or request new
features. From this page a simple email can be sent to support technicians.
• Documentation
• Knowledge Base
• Release Notes
• NexentaStor Plugins