NexentaStor QuickStart
NexentaStor QuickStart
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 Image1 that will run unmodified
on all VMware's hosted products, including VMware Player, VMware Workstation and
VMware Server for Windows and Linux, VMware Fusion for Mac.
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. All other trademarks and names mentioned herein may be
trademarks of their respective companies.
2. Other packaging/delivery options are being considered, including LiveCD (http://en.wikipedia.org/wiki/LiveCD) and
bootable USB flash drive.
3. 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. Recommended environment for
the Virtual Appliance product also includes:
• 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:
4. Note that your VMware product may support direct access to local hard disks
5. You can certainly also install Unified Appliance CD into one of the VMware products listed in the previous section.
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.
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 more equal size disks, it is
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
While the software installs, you can review the detailed progress by simply pressing F3 key:
After all operations complete, you are asked to reboot the appliance. Please do so, and proceed to
Section “Three Easy Operations”.
Step 2. Unzip the downloaded ZIP9 archive into a new directory. The extracted archive will
contain the following files:
Most importantly, one of the files (above) is the pre-installed Virtual Machine (VM) – the
.vmx image. Next picture shows opening NexentaStor.vmx using VMware Workstation:
9. For ZIP file format introduction and history, see for instance http://en.wikipedia.org/wiki/ZIP_(file_format)
The Virtual Appliance is provisioned with 3 virtual disks (one system disk and two data disks) and
512MB of memory (above), which is the required minimum. Prior to powering on your new VM,
take a moment to consider the settings. You can change the Nexenta-supplied defaults, now or
later.
If your system has 1GB of memory or more, you may want to increase the memory share
allocated for NexentaStor – that'll improve appliance's performance. 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 purposes10 you could simply use the default settings and documentation provided with
the appliance (see Section “References” below).
In all cases – virtual and “bare-metal”, evaluation and commercial – it takes 3 easy operations to
deploy the appliance:
11. Some of the screenshots throughout this document may be outdated – captured from older NexentaStor versions.
Note the Machine Signature (DC56AFAD in the example above) on the appliance's console.
This value identifies the machine, and is needed to produce unique registration. Product
registration forms are available on the website.
To register NexentaStor Developer Edition, please click on the evaluation registration link
on the Community page, as shown below:
To register NexentaStor Trial Edition, please click on the Free Trial Registration link on the
Products 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
above (see Step 2 on page #15) 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 network interface and choose DHCP if your
environment supports that, or elect to set up the interface statically (you’ll need 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.
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:
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
targets and discover remote LUNs. The following screen shows existing directly attached
disks, and allows to attach more, via 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.
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:
For more information, please see the following F.A.Q. entries on the website13:
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