iosphere software installation guide -...

Installation Guide

ioSphere Software Installation Guide for Version 3.2.1 English

ioSphere Software InstallationGuideVersion 3.2.1

ioSphere Software Installation Guide | _________________________________ ___ ___ 2

ioSphere Software Installation Guide for Version 3.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Download Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Management Server Firewall Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Management Server Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

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

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

Agent Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Agent Linux Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Agent Windows Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Agent Config Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Fusion Powered Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19


ioSphere Software Installation Guide for Version 3.2.1

Legal Notices

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

Copyright © 2012 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

Part Number D0003080-005_1

6.28.12


Installation Overview

Introduction

ioSphere 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

directCache driver (if you want 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.ts.fujitsu.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.

http://support.ts.fujitsu.com


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.

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.ts.fujitsu.com

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



Download FilesTo install the Management Server and Agent applications, go to and download and installhttp://support.ts.fujitsu.com

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

Windows

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

Fusion-io_Agent_Setup_*_x64.exe (Agent only)

Installation and configuration procedures for Linux and Windows are described on the following pages.



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.


1.

a.

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.


1.

a.

2.

Install Management Server ( )fio-msrv

Run the following command:

sudo rpm -i fio-msrv*.rpm


sudo dpkg -i fio-msrv*.deb

When 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.

a.

1.

2.

3.

4.

5.

6.

7.

8.

Uninstalling 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/

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.

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

(requires Avahi on Linux or Bonjour on Windows).

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

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).

http://localhost:9051/


1.

2.

3.

4.

5.

6.

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>

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

https://hostname:9051/index.html


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:\Windows\System32\config\systemprofile\AppData\Roaming\fio

Before installing ioSphere 3.x:

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-screenFusion-io_Management_Server_Setup_*_x64.exeinstructions.

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.


1.

2.

3.

4.

5.

6.

7.

8.

9.

First Time Setup

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


Set the admin password. Click Next.

Optionally, enter the . 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). Allows remote access to the Management Server from Agent processes not

located on the same machine as the Management Server.

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.

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.

Use the pre-configured Fusion-io 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.

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

certificate.



1.

a.

Agent Installation and ConfigurationFollow the instructions based on your platform.

Agent Linux 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 and the package before installing the Agent.libfio

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

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


sudo dpkg -i fio-common*.deb


1.

a.

2.

1.

a.

1.

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

Install fio-agent

Run the following command:

sudo rpm -i fio-agent*.rpm


sudo dpkg -i fio-agent*.deb

When 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:

Using ioSphere, navigate to Settings/Remote Access Key.


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

/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.

(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_Agent_Setup_*_x64.exe

During the installation, you will be asked if you are willing to agree to send anonymous information to Fusion-io,

which is the FMS (Fusion-io Monitoring System). This option sends data to Fusion-io at a specified time each day.

You can specify when the data is sent; see for more information.Agent Config Options

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 go 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

Once copied, the Agent should connect within 15 seconds.

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

Proxy (ioSphere only)

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 Config Options

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

Linux: /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.<!- ->

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


iosphere software installation guide -...

Documents