installation guide - fujitsumanuals.ts.fujitsu.com/file/11048/iosphere-ig-en.pdf · fio-msrv*.rpm...

Installation Guide

ioSphere Software Installation Guide for Version 3.3.4 English

ioSphere Software InstallationGuideVersion 3.3.4

ioSphere Software Installation Guide | _________________________________ ___ ___ 2

ioSphere Software 3.3.4 Installation Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Download Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Management Server Firewall Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Management Server Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Management Server - Linux Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Management Server - Windows Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Agent Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Agent Linux Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Agent Windows Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Agent Mac Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Agent Config Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Fusion Powered Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23


ioSphere Software 3.3.4 Installation Guide

Legal NoticesThe information contained in this document is subject to change without notice.

Copyright © 2013 Fusion-io, Inc. All rights reserved.

Fusion-io, the Fusion-io logo, ioDrive, and directCache are registered trademarks, and VSL is a registered trademark of

Fusion-io, Inc. in the United States and other countries.

The names of other organizations and products referenced herein are the trademarks or service marks (as applicable)

of their respective owners. Unless otherwise stated herein, no association with any other organization or product

referenced herein is intended or should be inferred.

Fusion-io

2855 E. Cottonwood Parkway, Suite 100

Salt Lake City, UT 84121

USA

(801) 424-5500

January 19, 2013

Part Number D0003080-008_1


IntroductionioSphere allows you to manage ioMemory devices using a convenient web interface. There are four main components

that you must install to use ioSphere:

ioMemory VSL (Driver)

Agent

Management Server ( )fio-msrv

Optional: directCache driver (Install only if you intend to manage directCache from ioSphere.)

ioMemory VSL (Driver)

The ioMemory VSL is the driver that runs ioMemory devices. The driver, along with all of its support packages and

utilities, must be installed for ioSphere to work. For more information on installing and using the driver, see the

ioMemory User Guide for your operating system, which you can find at .http://support.fusionio.com

Management Server

The Management Server manages ioMemory devices on the host (or hosts) by communicating with the Agent on each

host.

The Management Server offers a web-based user interface for managing your ioMemory devices. For information

regarding using this web interface, see the .ioSphere Software User Guide

Install the Management Server on a server that you will use to manage all of your host ioMemory devices.

For optimum ioMemory device performance, we recommend running ioSphere on a machine that does not host

ioMemory devices.

Agent

The Agent communicates with the ioMemory VSL and the Management Server. The Agent should be installed on a

host machine after the ioMemory VSL is already installed.

http://support.fusionio.com


Because ioSphere allows management of multiple hosts, you will install the Agent on every host machine that you

wish to control using ioSphere.

directCache

If you wish to take advantage of the added capabilities of directCache, you will need to install directCache. Go to

and download the latest version of directCache software and documentation. The http://support.fusionio.com

(for Windows or Linux) contains instructions on how to install directCache software.directCache User Guide

http://support.fusionio.com/


System RequirementsThe following levels of software and hardware are required to run ioSphere.

Server

ioSphere on a centralized server

RAM: 2GB plus 20MB of free RAM for each ioMemory module managed

Storage: Up to 10MB minimum hard drive space plus up to 3 MB additional space for each ioMemory module

Agent

ioSphere has an Agent on each ioMemory host server

Fusion-io VSL: Version 2.1 or later

Host may not be a server

RAM: Minimum of 64MB of free RAM

Windows

The ioSphere Management Solution Agent and Server run on the following Windows distributions:

Microsoft Windows Server 2003 64-Bit (with SP2 or higher)

Microsoft Windows Server 2008 64-Bit, all versions (with SP1 or higher)

Microsoft Windows Server 2008 R2 64-Bit, all versions (with SP1 or higher)

Microsoft Windows Server 2012

Operating Systems

The ioSphere Management Solution Agent and Server support the following operating systems:

Red Hat Enterprise Linux 5, 6

SUSE Linux Enterprise Server (SLES) 10

OpenSUSE 11

CentOS 5

Solaris 10 U8 & U9, 11 (Agent Only) Open Solaris 10 (Agent Only)

OEL 5, 6


SLES 10, 11

Mac OS X 10.6 (Agent Only)

VMware

There is no Agent that runs on ESX/ESXi servers. However, after the installation of a SMI-S (CIM) provider on the

ESX/ESXi host, the ioSphere Management Solution Server can communicate with the ESX/ESXi host.

An SMI-S provider can be installed on ESX/ESXi 4.x and ESXi 5.0.

Supported Browsers

To take advantage of all the ioSphere Management Solution features, please use one of the following fully supported

browsers:

Mozilla Firefox 10 and later (Windows, Mac, and Linux)

Microsoft Internet Explorer 8, 9 (Internet Explorer 10 is not supported)

The following browsers have not been tested, but are believed to work:

Google Chrome (Windows, Linux)

Safari (Mac)

Browsers with known issues:

Google Chrome on Mac

Resolution

1024 x 768 or greater

Adobe Flash Player

For an optimal viewing experience, we recommend that you install the latest version of Adobe Flash Player 11.


Download FilesTo install the Management Server and Agent applications, go to andhttp://support.fusionio.com/downloads

download and install the following files:

Linux

fio-common*.rpm (if not already installed) or fio-common*.deb

fio-msrv*.rpm (ioSphere's Management Server) or fio-msrv*.deb

fio-agent*.rpm or fio-agent*.deb

After installation, you can use at a command line to output a unique number that differentiatesfio-msrv -vbetween software builds.

Windows

Fusion-io_Management_Server_Setup_*_x64.exe (Server and Agent)

Mac

fio-agent.pkg (Agent only)

Installation and configuration procedures are described on the following pages.

http://support.fusionio.com/downloads


Management Server Firewall SettingsIf you need to adjust your firewall settings to allow Agents to communicate via SSL to the Management Server, use the

following:

Port: 9051 TCP (TLS/SSL)

Direction: Outbound (Agent), Inbound (Server)

Domain: [Management Server Domain/IP]

Port 9051 TCP is the port that has been assigned to Fusion-io by the Internet Assigned Numbers Authority

(IANA). You can choose to modify the port in the Management Server settings (in the web user interface), but

you may need to re-export the Agent access key if you do not use auto-discovery.


Management Server Installation and ConfigurationFollow the instructions based on your platform.

Management Server - Linux Installation and Configuration

Installation

Install (if not already installed)fio-common

All commands require administrator privileges. Log in as "root" or use to run the install.sudo

fio-common is a support package that is available with the ioMemory VSL (driver) installation. To see if

is installed, run:fio-common

rpm -qa | grep -i fio-common

Debian equivalent command:

dpkg -l | grep -i fio-common

To install , run the following command:fio-common

sudo rpm -i fio-common*.rpm

For Ubuntu/Debian, run this command:

sudo dpkg -i fio-common*.deb

If you are upgrading from version 1.x to 3.x , uninstall the old version before proceeding to thefio-msrvfollowing steps.


Install Management Server ( )fio-msrv

Run the following command:

sudo rpm -i fio-msrv*.rpm


sudo dpkg -i fio-msrv*.deb

After installation is complete, start the server with the following command:

sudo /etc/init.d/fio-msrv start

fio-msrv is already configured to auto-start on boot.

If you have upgraded and installed the new , ioSphere maintains most of your data, but does notfio-msrvrestore your saved searches or custom alerts. As a part of the upgrade process, ioSphere puts the contents of those

two files on disk in two different text files. If you want to keep your alerts and search rules created in a previous

version, you will have to read them and re-enter them in the new GUI after the installation is complete and upon

first run.

These are the names of the two backed-up files:

alert_rules.txt

saved_searches.txt

and this is the directory where you will find them: ./var/lib/fio/data/data_legacy

You may use the data in the two text files to recreate your saved alert rules and saved searches in the ioSphere 3.x

server.

If you are updating to 3.x, then you will need to associate the same Labels to the ioMemory that they were

previously associated with in the previous version.


1.

2.

a.

b.

3.

4.

5.

Uninstalling the Management Server

To uninstall the Management Server, run the following command:

sudo rpm -e <pkg-name>


sudo dpkg -r <pkg-name>

First Time Setup

Local Browser

On the machine where you you installed , open your local browser and go to fio-msrv http://localhost:9051/

Select New Install or Restore.

To return to this screen during setup, refresh the browser window.

If you select New Install, go to step 3.

If you select Restore, click , navigate to the .tbz2* archive file, select it andBrowse iosphere-backup-

click .Restore

Set the admin password. Click Next.

Enter the (optional). Default is 15 seconds. Increasing this number will makeioMemory Push Frequency

updates less frequent (and history/report information less detailed). Decreasing this number makes updates

more frequent, but could affect performance if you are using many clients (more than 20 or 30, for example).

Increasing this number above 600 displays this message: "A high push frequency will potentially result in

data being out of date in ioSphere."

Enable Remote Access (optional). Unchecked by default. Check this box to allow the Agent to remotely

access this server.

http://localhost:9051/


6.

7.

8.

9.

1.

2.

3.

Advertise Using Zeroconf (optional). This allows Agents to automatically discover and connect to ioSphere

(requires Avahi on Linux or Bonjour on Windows).

Using this option still requires manual configuration of Access Keys.

Host Name (optional). Select or Enter the remote host name or Host IP here.

Use caution when entering the IP. It should be static. If an invalid hostname or IP address is entered it can

be reset by clicking the Settings tab and entering the new IP address in the Host Name field.

Port. This is set to by default; Fusion-io owns this port. You have the option of entering a different port9051here.

Use pre-configured Fusion-io certificate (optional).

ioSphere includes a pre-configured SSL certificate, but it is recommended that you create and use a custom

certificate.

No Local Web Browser in Linux

If you run from a command line without a local browser, you must configure these settings manually:fio-msrv

Set admin password:

sudo fio-msrv -w

Enable remote access:

sudo fio-msrv -R

Set the port number <num> that the service is listening to:

sudo fio-msrv -P<num>


4.

5.

6.

Enable automatic Agent authorization

This will decrease security.

sudo fio-msrv -A

To view the remote URL path run:

sudo fio-msrv -u

Open your web browser and enter the URL ) https://hostname:9051/index.html

You will be prompted to configure the remaining settings, as described above.

Server Firewall Settings

If you need to adjust your firewall settings to allow Agents to communicate via SSL to the Server, use the following:

Port: 9051 TCP (TLS/SSL)

Direction: Outbound (Agent), Inbound (Server)

Domain: ioSphere Server Domain/IP

Management Server - Windows Installation and Configuration

Warning

To prevent loss of data during the Windows installation, be sure to do the following BEFORE uninstalling

ioSphere 1.x and BEFORE installing ioSphere 3.x:

Before uninstalling ioSphere 1.x:

Backup the data folder found in .C:\Program Files\Fusion-io iomemory VSL\Utils\Resources

Before installing ioSphere 3.x:

Backup the data folder found in C:\Windows\System32\config\systemprofile\AppData\Roaming\fio.

Return the data folder back to its original location in

.C:\Windows\System32\config\systemprofile\AppData\Roaming\fio

Installation

Run and follow the installation wizard's on-screen instructions.Fusion-io_Management_Server_*_x64.exe

https://hostname:9051/index.html


1.

2.

a.

b.

3.

4.

If you have upgraded and installed the new , ioSphere maintains most of your data, but does notfio.msrvrestore your saved searches or custom alerts. As a part of the upgrade process, ioSphere puts the contents of those

two files on disk in two different text files. If you want to keep your alerts and search rules created in a previous

version, you will have to re-enter them in the new GUI after the installation is complete and upon first run.

These are the names of the two backed-up files:

alert_rules.txt

saved_searches.txt

and this is the directory where you will find them:

C:\Windows\System32\config\systemprofile\AppData\Roaming\fio\data\data_legacy.

You may use the data in the two text files to recreate your saved alert rules and saved searches in the ioSphere 3.x

server.

If you are updating to 3.x, then you will need to associate the same Labels to the ioMemory that is was previously

associated with in 1.x.

First Time Setup

To configure the ioSphere management server:

Open your browser on the machine where the management server was installed and go to


Select New Install or Restore.

If you select New Install, go to step 3.

If you select Restore, click , navigate to the archive file, select itBrowse iosphere-backup\*.tbz2and click . (To return to the Login screen from the Restore screen, refresh the browser.)Restore

Set the admin password. Click Next.

Optionally, enter the . Default is 15 seconds. Increasing this number will make updatesAgent Push Frequency

less frequent (and history/report information less detailed). Decreasing this number makes updates more

frequent, but could affect performance if you are using many clients (more than 20 or 30, for example).

Increasing this number above 600 displays this message: "A high push frequency will potentially result in

data being out of date in ioSphere."



5.

6.

7.

8.

9.

10.

Enable Remote Access (optional). Allows remote access to the Management Server from Agent processes not

located on the same machine as the Management Server.

The features below appear when the "Enable Remote Access" box is checked.

Advertise Using Zeroconf (optional). Causes the Management Server to advertise its service using the

Zeroconf service discovery protocol. This allows remote Agent services to automatically discover and

communicate with the Management Server.

The Zeroconf protocol requires that Avahi be installed on Linux operating systems and Bonjour be

installed on Windows operating systems.



Host Name. Enter an IP address that will not change in an uncontrolled way (such as a DHCP lease that

expires). This address is used by Agent services to communicate to the Management Server. If you are unable to

reach the Management Server at the configured IP address, you can reset the IP address by clicking the Settings

tab and entering the new IP address in the Host Name field.

Port. By default, the port is set to 9051, which is reserved for ioSphere worldwide and should not conflict with

any other applications. You may opt to change the port (to 443, for example) depending on your requirements.

pre-configured SSL certificate (optional). Fusion-io provides a pre-configured certificate, but will result in

"untrusted certificate" messages. It is less secure than using a certificate signed by a trusted CA that is made

specifically for your server.

Click .Save Changes

ioSphere includes a pre-configured SSL certificate, but it is recommended that you create and use a custom

certificate.


Agent Installation and ConfigurationFollow the instructions based on your platform.

Agent Linux Installation and Configuration

3.x Linux agents require two libraries to be installed:

a 3.x version of libvsl

a 3.x verison of fio-common

(2.x releases required a library called . However, with 3.x, the required code is installed with libfio.)libvsl

All commands require administrator privileges. Log in as or use to run the install and start the server.root sudo

Install (if not already installed)fio-common

All commands require administrator privileges. Log in as or use to run the install.root sudo

fio-common is a support package that is available with the ioMemory VSL (driver) installation. To see if

is installed, run:fio-common

rpm -qa | grep -i fio-common

Debian equivalent command:

dpkg -l | grep -i fio-common

To install , run the following command:fio-common

sudo rpm -i fio-common*.rpm



sudo dpkg -i fio-common*.deb


Install fio-agent

Run the following command:

sudo rpm -i fio-agent*.rpm


sudo dpkg -i fio-agent*.deb

After installation is complete, start the Agent with the following command:

sudo /etc/init.d/fio-agent start

The Agent is already configured to auto-start on boot.

Uninstalling fio-agent

To uninstall the Agent, run the following command:

sudo rpm -e <pkg-name>


sudo dpkg -r <pkg-name>

Configuration

The Agent is configured to automatically find and connect to a Management Server (ioSphere requires Avahi on

Linux).

To connect the agent to the server manually:


1.

2.

Using ioSphere, navigate to Settings/Remote Access Key.

On the host machine where the Agent is running, click and save the copy toDownload Remote Access Key

this location on the remote machine:

/var/lib/fio/agent_keys/

Once copied, the Agent should connect within 15 seconds.

To disconnect the Agent from the server manually, delete the Access Key ( ) from the following[hostname].keylocation on the machine where the Agent is running:

/var/lib/fio/agent_keys/[hostname].key

Proxy (ioSphere only)

The Agent uses the Linux and environment variables for proxy connections. If youhttp_proxy https_proxywant the Agent to use a proxy server, consult your OS documentation on how to modify these environment variables.

Agent Run Options

Option Description

, -f --foreground Run in foreground rather than service/daemon.

--verbose Enable verbose (debug) logging.

, -d --debug Display additional debug information.

(default)--brief Disable verbose (debug) logging.

, -r --runonce FMS -"Run Once" mode. Collect device data once and push to Fusion-io, then

exit.

, -o --outfile <path> Same as but dump to specified path instead of automatically--runoncesending to Fusion-io.

, -c --cfg-path Path to config file.<path>

-t,--runtime-datafiles-path<path>

Path to runtime data files (if not specified, default location is used.)

Help Option Description

, -h --help Print the help menu then exit.

, -v --version Print the program name and version then exit.


1.

2.

Agent Windows Installation and Configuration

Installation

Run and follow the on-screen instructions.Fusion-io_Management_Server_Setup_*_x64.exe

Configuration

The Agent is configured to automatically find and connect to an ioSphere server (requires Bonjour on Windows).

To connect the Agent to the server manually:

Using ioSphere, navigate to the Settings page and click the link. Remote Access Key

On the host machine running the agent, click and copy the key to:Download Remote Access Key

C:\Windows\System32\config\systemprofile\AppData\Roaming\fio\agent_keys


To disconnect the Agent from the server manually, delete the Access Key ( ) from the followinghostname.keylocation:

C:\Windows\System32\config\systemprofile\AppData\Roaming\fio\agent_keys\[hostname].key


The Agent uses the Windows and environment variables for proxy connections. If youhttp_proxy https_proxywant the Agent to use a proxy server, consult your OS documentation on how to modify these environment variables.

Agent Mac Installation and Configuration

The Agent requires the ioMemory VSL (ioMemory driver) to run. Make sure you have installed version 2.2.1 or

later of the driver package before installing the Agent.



1.

2.

1.

2.

Install fio-agent

Double-click the installation package. The installation program will assist you with the installation process.

Restart your computer.

Configuration

The Agent is configured to automatically find and connect to a Management Server.

To connect the agent to the server manually:

Using ioSphere, navigate to Settings/Remote Access Key.

On the host machine where the Agent is running, click and save the copy to:Download Remote Access Key

/var/lib/fio/agent_keys/


To disconnect the Agent from the server manually, delete the Access Key ( ) from the following[hostname].keylocation on the machine where the Agent is running:

/var/lib/fio/agent_keys/[hostname].key


The Agent uses the Linux and environment variables for proxy connections. If youhttp_proxy https_proxywant the Agent to use a proxy server, consult your OS documentation on how to modify these environment variables.

Agent Config OptionsThe following settings can be modified in , located at:fio-agent-cfg.xml

Linux and Mac: /var/lib/fio/

Windows:

C:\Windows\System32\config\systemprofile\AppData\Roaming\fio\fio-agent-cfg.xml

Auto-Discover Management Server <iomanager-discovery-enabled>

Enabling this causes an Agent to locate a management server and to automatically connect with it.


True=Enable(Default)

False=Disabled

Why would you disable?

Multiple Management Servers - An Agent does not try to connect with any server beyond the first one it

finds. You will have to manually connect an agent to multiple services.

Security

You must delete the XML "comment" tags (" " and " ") in order for this parameter to take effect.<!- ->


Fusion Powered SupportWe offer Fusion Customer Services and Support by phone, e-mail and on the Web. For the most up-to-date contact

information visit .http://support.fusionio.com

E-Mail

Our support e-mail address is: [email protected]

E-mail is the fastest way to get simple questions answered. Please give a detailed description of your problem with your

complete contact information (name, phone number, email address, location address).

Warranty Support

Warranty Support is available via and [email protected] http://support.fusionio.com

Telephone Support

ioFX Support

North America: (855) 322-5767

Enterprise Support

North America: (877) 816-5740

Country Numbers

For product support outside of North America, please use the number for the country/region closest to you. If that is

not possible, please contact North America at (801) 424 5474.

Australia

(02) 8278 1489

Belgium

02 700 74 86

China

40-08866109

Denmark

4331 4999

Finland

097 251 9979

France

01 57 32 48 90

Germany

(069) 17 07 76 790

Hong Kong

3071 3587

Italy

02 23331509

Japan

(03) 6743-9765

Luxembourg

(224) 87 19 84

Mexico

01 882 816 5740

Netherlands

070 7703993

Norway

23 02 49 99

Singapore

6818 5692

South Korea

02 3483 6689

Sweden

08 593 663 99

United Kingdom

(020) 3564 9935




Web

Go online to find tips, FAQs, and troubleshooting help, or download the latest user guides, software, and support

packages at: .http://support.fusionio.com


ioSphere Software Installation Guide | 1

Fusion Powered SupportWe offer ioDrive Customer Support by phone, e-mail and on the Web.

E-Mail

Please use the contact form at:http://support.ts.fujitsu.com/contact/ For the Japanese market, please use the following URL: http://primeserver.fujitsu.com/primergy/support/ Telephone Support

For customer support phone numbers, please refer to the Fujitsu TechnologySolutions service desk at http://ts.fujitsu.com/support/servicedesk.html For the Japanese market, please use the following URL: http://primeserver.fujitsu.com/primergy/support/supportdesk.html

Web

It is recommended to use the latest firmware / driver / BIOS versions on servers and components. Software packages are available for download at : http://support.ts.fujitsu.com > Server > Drivers & Downloads For the Japanese market, please use the following URL: http://primeserver.fujitsu.com/primergy/downloads Corresponding user documentation for servers and optional components can be found online athttp://manuals.ts.fujitsu.com > Industry Standard Servers > Expansion Cards > PCIe SSD Cardsor on the ServerView Suite Documentation DVD. For the Japanese market, please use the following URL: http://primeserver.fujitsu.com/primergy/manual.html

http://support.ts.fujitsu.com

installation guide - fujitsumanuals.ts.fujitsu.com/file/11048/iosphere-ig-en.pdf · fio-msrv*.rpm...

Documents