ETERNUS Oracle VM Storage Connect Plug-in 1.3 User’s Guide · 2015-03-05 · 3.1 Installation Procedure ... If a version earlier than Oracle VM 3.1 is used, the terms that are listed

ETERNUS Oracle VM Storage Connect Plug-in 1.3User's Guide

P2X0-1280-02ENZ0

This page is intentionally left blank.

ETERNUS Oracle VM Storage Connect Plug-in 1.3 User's Guide

Copyright 2015 FUJITSU LIMITED P2X0-1280-02ENZ0

3

Preface

This manual provides the overview and description on usage of the ETERNUS Oracle VM Storage Connect Plug-in.This manual is intended for Oracle VM administrators who utilize the ETERNUS DX Disk storage system as aninfrastructure for a virtualized environment. The readers are assumed to have basic knowledge of thefunctions and terms of Oracle VM and ETERNUS DX Disk storage systems.

Second EditionFebruary 2015

Oracle and Java are registered trademarks of Oracle and/or its affiliates.The company names, product names and service names mentioned in this document are registeredtrademarks or trademarks of their respective companies.

About this Manual

Organization

This manual is composed of the following eight chapters and appendices:Read through this manual before installing the ETERNUS Oracle VM Storage Connect Plug-in.

● Chapter 1 Introduction

This chapter provides an overview of the ETERNUS Oracle VM Storage Connect Plug-in.

● Chapter 2 Operating Environment

This chapter describes the supported range, required resources, and preset configurations for the ETERNUSOracle VM Storage Connect Plug-in.

● Chapter 3 Installation

This chapter explains how to install the ETERNUS Oracle VM Storage Connect Plug-in.

● Chapter 4 Operation during Linkage with Oracle VM

This chapter describes the operation of the ETERNUS DX Disk storage system during linkage with OracleVM.

● Chapter 5 Uninstallation

This chapter explains how to uninstall the ETERNUS Oracle VM Storage Connect Plug-in.

● Chapter 6 Restrictions and Cautions

This chapter describes restrictions and cautions for the ETERNUS Oracle VM Storage Connect Plug-in.

● Chapter 7 Messages

This chapter describes the messages displayed by the ETERNUS Oracle VM Storage Connect Plug-in as wellas their meaning and corresponding actions to take.

● Chapter 8 Troubleshooting

This chapter explains how to collect information that is required for troubleshooting when an error occursin the ETERNUS Oracle VM Storage Connect Plug-in.

"Setup for CHAP Authentication with an iSCSI Host Interface", "JRE Use Conditions", and "Ganymed SSH-2 forJava Use Conditions" are described in the appendices.



4

About this Manual

Naming Conventions

• The following abbreviations are used for ETERNUS DX Disk storage system names.

For the supported storage systems, refer to the following:http://www.fujitsu.com/global/support/products/computing/storage/disk/download/oraclevm.html

Reference

• ETERNUS storage system product informationhttp://www.fujitsu.com/global/products/computing/storage/

• ETERNUS Oracle VM Storage Connect Plug-in product information and download pagehttp://www.fujitsu.com/global/support/products/computing/storage/disk/download/oraclevm.html

Official name Abbreviation

FUJITSU Storage ETERNUS DX60 S3/DX100 S3/DX200 S3FUJITSU Storage ETERNUS DX500 S3/DX600 S3

ETERNUS DX S3 series

ETERNUS DX Disk storage systemFUJITSU Storage ETERNUS DX80 S2/DX90 S2FUJITSU Storage ETERNUS DX400 S2 seriesFUJITSU Storage ETERNUS DX8000 S2 series

ETERNUS DX S2 series



5

http://www.fujitsu.com/global/support/products/computing/storage/disk/download/oraclevm.html

http://www.fujitsu.com/global/products/computing/storage/

http://www.fujitsu.com/global/support/products/computing/storage/disk/download/oraclevm.html

Table of Contents

Chapter 1 Introduction 8

1.1 About Oracle VM ................................................................................................................. 8

1.2 About ETERNUS Oracle VM Storage Connect Plug-in ............................................................ 8

1.3 Release Information ........................................................................................................... 9

Chapter 2 Operating Environment 10

2.1 Supported Range .............................................................................................................. 10

2.2 Required Resources ........................................................................................................... 10

2.3 Preliminary Settings .......................................................................................................... 11

Chapter 3 Installation 12

3.1 Installation Procedure ....................................................................................................... 12

3.2 Confirmation after Installation .......................................................................................... 13

3.3 Version Upgrade ............................................................................................................... 14

Chapter 4 Operation during Linkage with Oracle VM 15

Chapter 5 Uninstallation 17

5.1 Uninstallation Procedure .................................................................................................. 17

5.2 Cancelling the ETERNUS Oracle VM Storage Connect Plug-in Settings ............................... 17

Chapter 6 Restrictions and Cautions 18

6.1 Restrictions ....................................................................................................................... 18

6.2 Cautions ............................................................................................................................ 19



6

Table of Contents

Chapter 7 Messages 20

Chapter 8 Troubleshooting 26

8.1 Required Information for Troubleshooting ........................................................................ 26

Appendix A Setup for CHAP Authentication with an iSCSI Host Interface 27

Appendix B JRE Use Conditions 29

Appendix C Ganymed SSH-2 for Java Use Conditions 30



7

Chapter 1

Introduction

This chapter provides an overview of the ETERNUS Oracle VM Storage Connect Plug-in.

1.1 About Oracle VM

The screen configuration and descriptions may vary according to the version of Oracle VM that is used.If a version earlier than Oracle VM 3.1 is used, the terms that are listed in the following table apply.

1.2 About ETERNUS Oracle VM Storage Connect Plug-in

ETERNUS DX Disk storage systems provide the ETERNUS Oracle VM Storage Connect Plug-in for linkage withOracle VM.The Oracle VM Storage Connect framework supports creation, deletion, and expansion of Logical Unit Number(LUN) and snapshot native storage service, so that Oracle VM Manager can directly use the resources andfunctions of the storage system existing in the Oracle VM environment. If a storage vendor enables the OracleVM Storage Connect Plug-in, users can provision the vendor's storage via Oracle VM Manager.

No. Oracle VM 3.1 or later Oracle VM 3.0 or earlier

1 Servers and VMs Hardware

2 Restart Restart Server

3 SAN Server(s) Storage Array(s)

4 Discover SAN Server Register Storage Array

5 Edit SAN Server Edit Storage Array

6 Delete San Server Delete Storage Array

7 Refresh SAN Server Refresh Storage Array



8

Chapter 1 Introduction 1.3 Release Information

1.3 Release Information

The revisions that are made for each edition of the ETERNUS Oracle VM Storage Connect Plug-in are shown inthe following table.

Edition Changes

1.0(September 2011)

First edition

1.1(June 2012)

Added support for the ETERNUS DX8000 S2 series

1.2(January 2014)

• Added support for the ETERNUS DX S3 series

• Added the Volume Group filtering function

• Added support for iSCSI multipathing

1.3(February 2015)

Added support for the ETERNUS DX60 S3



9

Chapter 2

Operating Environment

This chapter describes the supported range, required resources, and preset configurations for the ETERNUSOracle VM Storage Connect Plug-in. Be sure to read the descriptions before starting installation.

2.1 Supported Range

For details about the storage systems, firmware versions, and OS supported by the ETERNUS Oracle VMStorage Connect Plug-in, refer to the following page:

http://www.fujitsu.com/global/services/computing/storage/eternus/tools/oraclevm.html

2.2 Required Resources

■ Disk capacity

The disk capacity shown below is required for each directory in order to install the ETERNUS Oracle VM StorageConnect Plug-in.

No. Directory Disk capacity

1 /opt 272MB

2 /etc 5MB

3 /var 2MB



10

Chapter 2 Operating Environment 2.3 Preliminary Settings

2.3 Preliminary Settings

■ License

An Advanced Copy license is required. Purchase the license separately and register the license to the ETERNUSDX Disk storage system. Setting the Advanced Copy table size is also required. For details about how toregister the license and how to set the Advanced Copy table size, refer to the "ETERNUS Web GUI User's Guide".

■ Account for ETERNUS DX Disk storage systems

Accessing an ETERNUS DX Disk storage system from the ETERNUS Oracle VM Storage Connect Plug-in requiresa user account with a "Software" role. Register a user account to the ETERNUS DX Disk storage system usingETERNUS Web GUI or ETERNUS CLI. For details about registering a user account, refer to the "ETERNUS Web GUIUser's Guide" or the "ETERNUS CLI User's Guide".

■ Creation of RAID groups and Thin Provisioning Pools

A RAID group or Thin Provisioning Pool in the ETERNUS DX Disk storage system is used as a Volume Group thatis specified when a Physical Disk (LUN) is created using Oracle VM Manager.Volume Groups cannot be created using the ETERNUS Oracle VM Storage Connect Plug-in. RAID groups or ThinProvisioning Pools must be designed and created beforehand in the ETERNUS DX Disk storage system usingETERNUS Web GUI or ETERNUS CLI. For details about creating RAID groups or Thin Provisioning Pools, refer tothe "ETERNUS Web GUI User's Guide" or the "ETERNUS CLI User's Guide".Volume Groups that are operated with Oracle VM can be restricted by using the filtering settings. For moredetails, refer to the Volume Group section in "Chapter 4 Operation during Linkage with Oracle VM" (page 15).

■ Connection to the LAN for operation management

Accessing an ETERNUS DX Disk storage system from the ETERNUS Oracle VM Storage Connect Plug-in requiresa connection to a LAN for operation management. Connect Oracle VM Server to the ETERNUS DX Disk storagesystem via the LAN for operation management in the same way as ETERNUS Web GUI or ETERNUS CLI. Fordetails, refer to the "User Guide" or "User's Guide -Site Planning-" of the ETERNUS DX Disk storage system that is to be used.

■ Connection to a SAN

FC, iSCSI, and FCoE are available as host interfaces. Oracle VM Server and the ETERNUS DX Disk storage system must be connected to a SAN using cablesbeforehand. When a FC switch is used, zoning must be set for the FC switch.In addition, the host affinity function must be enabled for the ports on the ETERNUS DX Disk storage systemthat are to be used. For details about these settings, refer to the "ETERNUS Web GUI User's Guide" or the"ETERNUS CLI User's Guide".



11

Chapter 3

Installation

This chapter explains how to install the ETERNUS Oracle VM Storage Connect Plug-in.

3.1 Installation Procedure

This section describes the installation procedure for the ETERNUS Oracle VM Storage Connect Plug-in.

Procedure

1 Download the ETERNUS Oracle VM Storage Connect Plug-in package (osc-fujitsu-eternussa.tar.gz) from the download site and transfer the package to the working directory for Oracle VM Server.

2 Log in to Oracle VM Server as a "root" user and move to the working directory.

3 Extract the ETERNUS Oracle VM Storage Connect Plug-in package using the following command:

4 Specify the "install" option for the "setup.sh" script to install the subpackages.

If a subpackage of the same version level is already installed, the message below appears. If re-instal-lation is required, uninstall the subpackage.

5 Enter "y" to execute the installation in response to the message to confirm whether to execute installation. Enter "q" or "n" to cancel the process.

*1: The version level of the product is displayed.

# /bin/tar xvfz ./osc-fujitsu-eternussa.tar.gz <RETURN>

# ./setup.sh install <RETURN>

setup.sh: INFO: osc-fujitsu-eternussa is already installed. (skip)setup.sh: INFO: FJSVstxs is already installed. (skip)setup.sh: INFO: FJSVstxc is already installed. (skip)

# ./setup.sh install <RETURN>

ETERNUS Oracle VM Storage Connect Plug-in1.3.0 (*1)Copyright FUJITSU LIMITED 2011-2015

Do you want to continue with the installation of this package? [y,n,q] y <RETURN>



12

Chapter 3 Installation 3.2 Confirmation after Installation

The installation process starts.

The following message appears when the installation process is completed successfully.

End of procedure

3.2 Confirmation after Installation

This section explains how to check if the ETERNUS Oracle VM Storage Connect Plug-in is properly installed.

Using the "setup.sh" script that was executed during installation allows the user to check the installationstatus of the product.

Procedure

1 Specify the "check" option for the "setup.sh" script.

*1: The version level of the product is displayed.*2: The version level of each subpackage is displayed. This may be different from the product version.

2 Confirm that all the subpackages have been installed. If there is a subpackage that is not installed, re-execute the installation procedure to install the subpackage.

End of procedure

Preparing... ########################################### [100%] 1:osc-fujitsu-eternussa ########################################### [100%]Preparing... ########################################### [100%] 1:FJSVstxs ########################################### [100%]Preparing... ########################################### [100%] 1:FJSVstxc ########################################### [100%]

Installation of ETERNUS Oracle VM Storage Connect Plug-in completed.

# ./setup.sh check <RETURN>

ETERNUS Oracle VM Storage Connect Plug-in1.3.0 (*1)Copyright FUJITSU LIMITED 2011-2015

setup.sh: INFO: osc-fujitsu.eternussa is already installed. VERSION: 1.3.0 (*2)setup.sh: INFO: FJSVstxc is already installed. VERSION: 2.4.2 (*2)setup.sh: INFO: FJSVstxs is already installed. VERSION: 2.8.0 (*2)



13

Chapter 3 Installation 3.3 Version Upgrade

3.3 Version Upgrade

The ETERNUS Oracle VM Storage Connect Plug-in can be upgraded by following the procedure that is describedin "3.1 Installation Procedure" (page 12).



14

Chapter 4

Operation during Linkage with Oracle VM

This chapter describes the operation of the ETERNUS DX Disk storage system during linkage with Oracle VM.

■ Volume Group

A Volume Group in Oracle VM is a RAID group or Thin Provisioning Pool in the ETERNUS DX Disk storagesystem.Volume Groups cannot be created using the ETERNUS Oracle VM Storage Connect Plug-in. RAID groups or ThinProvisioning Pools must be designed and created beforehand in the ETERNUS DX Disk storage system usingETERNUS Web GUI or ETERNUS CLI.

RAID groups and Thin Provisioning Pools are displayed in the following formats for Volume Groups:

• RAID groupGroup + RAID group number + : + RAID group name

• Thin Provisioning PoolGroup + Thin Provisioning Pool number + tp: + Thin Provisioning Pool name

When an operation such as [Create Physical Disk] or [Delete Physical Disk] is performed for the specifiedVolume Group, a volume is created in or deleted from the corresponding RAID group or Thin Provisioning Poolin the ETERNUS DX Disk storage system.

■ Access Group

The ETERNUS DX Disk storage system uses the following resources:

• Host• Affinity Group• Host Affinity

When an operation such as [Present Physical Disk] or [Unpresent Physical Disk] is performed for the specifiedAccess Group, the resources that are listed above are created or deleted.

By using the filtering settings, Volume Groups that are operated with Oracle VM can be restricted.Specify "VolGrpPrefix=prefix" for [Plug-in Private Data] to discover a SAN server with Oracle VM ("prefix" is a filtering string. "VolGrpPrefix" and the filtering string are case sensitive.) Once the filtering string is specified, only the RAID groups or Thin Provision Pools in the ETERNUS DX Disk storage systems that have a name start-ing with the specified filtering string ("prefix") are available as targets for Oracle VM.

Do not use Edit Volume Group to change the information of a Volume Group. Doing so will result in abnormal operation. When information is changed, delete the ETERNUS DX Disk storage system and then register the ETERNUS DX Disk storage system again.



15

Chapter 4 Operation during Linkage with Oracle VM

■ Clone (When [Storage Array] is Selected as the Clone Target Type)

A Clone in Oracle VM performs a copy using the OPC function in the ETERNUS DX Disk storage system.The copy destination volume name will be "OVM01# + Name specified in Oracle VM Manager". However, ifName was not specified in Oracle VM Manager, the copy destination volume name will be "OVM01#clone + d"(d is a decimal number).The copy destination volume is created in a RAID group or Thin Provisioning Pool to which the copy sourcevolume belongs. If a volume cannot be created due to insufficient capacity or other reasons, a ThinProvisioning Pool or RAID group with the same RAID level as the copy source is automatically selected andused.

■ Physical Disk

A Physical Disk in Oracle VM is a volume in the ETERNUS DX Disk storage system.When a volume is created, "OVM01# + Name specified in Oracle VM Manager" is the name that is given for thevolume.The following method is used to expand volumes when the Physical Disk Size is changed.

• RAID group volumeLUN Concatenation

• Thin Provisioning Pool volumeExpand Thin Provisioning Volume

Volumes that are expanded by LUN Concatenation use RAID groups in the following order:

(1) RAID group to which the source volume belongs when the volume can be expanded within the RAID group

(2) RAID group with the same RAID level as the copy source



16

Chapter 5

Uninstallation

This chapter explains how to uninstall the ETERNUS Oracle VM Storage Connect Plug-in.

5.1 Uninstallation Procedure

This section describes the uninstallation procedure for the ETERNUS Oracle VM Storage Connect Plug-in.

Procedure

1 Log in to Oracle VM Server as a "root" user.

2 Move to the directory where the "setup.sh" script is stored.

3 Specify the "uninstall" option for the "setup.sh" script to delete the package.

4 Enter "y" to execute the uninstallation in response to the message to confirm whether to execute uninstallation. Enter "n" or "q" to not execute uninstallation.

The following message appears when the uninstallation process is completed successfully.

End of procedure

5.2 Cancelling the ETERNUS Oracle VM Storage Connect Plug-in Settings

Cancel the environment settings after uninstalling the ETERNUS Oracle VM Storage Connect Plug-in.

# ./setup.sh uninstall <RETURN>

# ./setup.sh uninstall <RETURN>

ETERNUS Oracle VM Storage Connect Plug-in1.3.0Copyright FUJITSU LIMITED 2011-2015

Do you want to remove this package? [y,n,q] y <RETURN>

Uninstallation of ETERNUS Oracle VM Storage Connect Plug-in completed.



17

Chapter 6

Restrictions and Cautions

This chapter describes restrictions and cautions for the ETERNUS Oracle VM Storage Connect Plug-in.

6.1 Restrictions

■ Volume Groups in Oracle VM Manager

New Volume Groups cannot be created. RAID groups or Thin Provisioning Pools must be designed and createdbeforehand in the ETERNUS DX Disk storage system.

■ SAS host interfaces

SAS host interfaces cannot be used. Use FC, iSCSI, or FCoE for host interfaces.

■ CHAP authentication with an iSCSI host interface

Operation via Oracle VM Manager and manual settings in the ETERNUS DX Disk storage system are requiredfor CHAP authentication with an iSCSI host interface. For details about the procedure, refer to "Appendix ASetup for CHAP Authentication with an iSCSI Host Interface" (page 27).

■ Physical Disk Name

The number of characters that can be set for a physical disk name is as follows:ETERNUS DX S2 series: up to 10 charactersETERNUS DX S3 series: up to 26 characters

■ Access Group Name

Up to 12 characters can be set for a Access Group name.

■ Deleting an Access Group

When physical disks and initiators are assigned to an Access Group, the Access Group cannot be deleted. Per-form [Unpresent Physical Disk] for all of the physical disks or delete all of the assigned initiators and then tryagain.



18

Chapter 6 Restrictions and Cautions 6.2 Cautions

6.2 Cautions

■ ETERNUS DX Disk storage system resources created with Oracle VM Manager

The following ETERNUS DX Disk storage system resources that are created using Oracle VM Manager are usedas information that is managed by the ETERNUS Oracle VM Storage Connect Plug-in. If the information ischanged, the ETERNUS Oracle VM Storage Connect Plug-in does not operate correctly. Do not change theinformation using ETERNUS Web GUI or ETERNUS CLI.In addition, do not create resources with the following settings using ETERNUS Web GUI or ETERNUS CLI. Ifresources are created with the following settings, the ETERNUS Oracle VM Storage Connect Plug-in does notoperate correctly.

● Volumes

Volumes with a name that begins with "OVMdd#" (dd is a two-digit decimal number)

● FC hosts and iSCSI hosts

FC hosts or iSCSI hosts with "dddd + Access Group name specified in Oracle VM Manager" (dddd is a four-digit decimal number) as the name

● Affinity groups

Affinity groups with "Access Group name specified in Oracle VM Manager" as the name



19

Chapter 7

Messages

This chapter describes the messages displayed by the ETERNUS Oracle VM Storage Connect Plug-in as well astheir meaning and corresponding actions to take.

Messages are displayed in Details for Jobs.

■ ETERNUS Disk storage system operation command terminated due to an error. [error code=%d, message=%s]

Meaning

Detailed message is displayed in "%s".

- When the detailed message begins with STXS4xxx, STXS8xxx, or STXSDxxx:The ETERNUS DX Disk storage system cannot be operated due to a reason as described in the detailedmessage.

- When the detailed message begins with STXS5xxx, STXS6xxx, or STXS7xxx:The ETERNUS DX Disk storage system cannot be operated due to a communication error as described inthe detailed message.

Action

- When the detailed message begins with STXS4xxx, STXS8xxx, or STXSDxxx:Check the value that is set by using Oracle VM Manager.If there is no problem with the value that is set, check the status of the ETERNUS DX Disk storage systemby using ETERNUS Web GUI or ETERNUS CLI.

- When the detailed message begins with STXS5xxx, STXS6xxx, or STXS7xxx:Check the network environment.If there is no problem with the network environment, check the status of the ETERNUS DX Disk storagesystem by using ETERNUS Web GUI or ETERNUS CLI.If an ETERNUS DX Disk storage system that is not supported is specified, no action can be taken to solvethe problem.

■ An improper user name or password was specified.

Meaning

The specified user name or password is incorrect or unavailable.

Action

Specify a correct user name and password.



20

Chapter 7 Messages

■ An unsupported device was specified.

Meaning

An unsupported device was specified.

Action

Specify another device.

■ Cannot operate with the specified Storage Type. [Storage Type=%s]

Meaning

Cannot operate with the specified Storage Type.

Action

Check if the device is equipped with a channel adapter of the type displayed in Storage Type in "%s".

■ The firmware is not supported.

Meaning

Cannot operate the device because the firmware version of the specified device is not supported.

Action

Specify a device with a supported version of firmware.

■ The function of the device is disabled. [%s]

Meaning

Cannot operate the device because the function displayed in "%s" of the specified device is disabled.

Action

Enable the function of the device.

■ The specified operation is not supported. [%s]

Meaning

The specified operation is not supported.

Action

No actions.



21

Chapter 7 Messages

■ A required value is not specified. [%s]

Meaning

A required value is not specified.

Action

Check the value for Oracle VM Manager.

■ The specified value is incorrect. [%s]

Meaning

The specified value is incorrect.

Action

Check the value specified with Oracle VM Manager.

■ The specified value is already registered. [%s]

Meaning

The specified value is already registered.

Action

Check the status of the ETERNUS DX Disk storage system using ETERNUS Web GUI or ETERNUS CLI.

■ The specified value is not registered. [%s]

Meaning

The specified value is not registered.

Action


■ The device limit is reached. [%s]

Meaning

The device limit is reached.

Action

No actions.



22

Chapter 7 Messages

■ The specified item cannot be operated. [%s]

Meaning

The specified item cannot be operated.

Action


■ The Access Group cannot be found or has not been created. [Access Group Name=%s]

Meaning

The specified Access Group cannot be found or has not been created.

Action


■ LUN exists in the Access Group. [Access Group Name=%s]

Meaning

LUN exists in the specified Access Group.

Action

Unpresent all LUNs from the Access Group in Oracle VM Manager.

■ No paths in the access entry. [Access entry=%s]

Meaning

There are no paths in the specified access entry.

Action

Check the status of the ETERNUS DX Disk storage system, and the path status between the device and theserver using ETERNUS Web GUI or ETERNUS CLI.

■ No paths available for the access entry. [Access entry=%s]

Meaning

There are no paths available for the specified access entry.

Action

Check the status of the ETERNUS DX Disk storage system, and the path status between the device and theserver using ETERNUS Web GUI or ETERNUS CLI.



23

Chapter 7 Messages

■ Improper Host Response settings. [Host Response Number="%d", Sense Code Conversion="%d"]

Meaning

The Host Response settings that are to be used for Oracle VM Manager are incorrect.

Action

Check if Sense Code Conversion of Host Response used for Oracle VM Manager is set to [1: Linuxrecommended (when the ETERNUS multipath driver is not used)] using ETERNUS Web GUI or ETERNUS CLI.

■ An error occurred under the PlugIn environment.

Meaning

An error occurred under the PlugIn environment.

Action

Re-install PlugIn.

■ An error occurred in the communication process with the ETERNUS Disk storage system.

Meaning

An error occurred in the communication process with the ETERNUS DX Disk storage system.

Action

Check if the user ID and password of the ETERNUS DX Disk storage system are correct.Check if the IP address of the ETERNUS DX Disk storage system is correct.Check if an error occurred in the communication process with the ETERNUS DX Disk storage system.

■ An error occurred during creation of a clone or snapshot. Copy source volume number ="%d1", Copy destination volume number ="%d2"

Meaning

An error occurred during creation of a clone or snapshot.

Action

Check if an error occurred in the communication process with the ETERNUS DX Disk storage system.Check the status of the copy source volume and copy destination volume using ETERNUS Web GUI.Check the copy session status of the ETERNUS DX Disk storage system using ETERNUS Web GUI.



24

Chapter 7 Messages

■ An error occurred due to a stopped copy session. Copy source volume number ="%d1", Copy destination volume number ="%d2"

Meaning

An error occurred due to a stopped copy session.

Action

Check if an error occurred in the communication process with the ETERNUS DX Disk storage system.Check the status of the copy source volume and copy destination volume using ETERNUS Web GUI.Check the copy session status of the ETERNUS DX Disk storage system using ETERNUS Web GUI.

■ An error occurred in the status check process for the ETERNUS Disk storage system.

Meaning

An error occurred in the status check process for the ETERNUS DX Disk storage system.

Action

Check if an error occurred in the communication process with the ETERNUS DX Disk storage system.Check if an error occurred in the ETERNUS DX Disk storage system using ETERNUS Web GUI.

■ A hardware failure occurred.

Meaning

A hardware failure occurred in the ETERNUS DX Disk storage system.

Action

Check if an error occurred in the communication process with the ETERNUS DX Disk storage system.Check if an error occurred in the ETERNUS DX Disk storage system using ETERNUS Web GUI.



25

Chapter 8

Troubleshooting

8.1 Required Information for Troubleshooting

Prepare the following files when an error occurs and contact a Fujitsu engineer.

■ OS information

Collect the following files:

■ Trace log

Collect the files in the following folders:

■ Management file

Collect the files in the following folder:

■ Version information

Collect the following OS command result:

/var/log/messages*/var/log/ovs-agent.log*

/var/opt/FJSVstxc/log/var/opt/FJSVstxs/log/

/etc/opt/FJSVstxc/etc

rpm -qa



26

Appendix A

Setup for CHAP Authentication with an iSCSI Host Interface

This appendix explains how to set up CHAP authentication with an iSCSI host Interface. The followingprocedure may be changed for new versions of Oracle VM.

Procedure

1 Perform [Discover SAN Server] from [SAN Servers] in Oracle VM Manager without selecting [Use Chap] for [Access Information] to register the ETERNUS DX Disk storage system.

2 Select the ETERNUS DX Disk storage system that was registered using Oracle VM Manager and perform [Refresh SAN Server].

3 Check that [Access Groups] in Oracle VM Manager includes an Access Group in which the Oracle VM Manager Initiator that uses CHAP authentication and Physical Disks are registered.If the Access Group is not included in [Access Groups], create an Access Group in which the Oracle VMManager Initiator that uses CHAP authentication and Physical Disks are registered.

4 Use ETERNUS Web GUI or ETERNUS CLI to set the CHAP user name and CHAP password of the Oracle VM Manager Initiator that is set in the ETERNUS DX Disk storage system.

5 Use ETERNUS Web GUI or ETERNUS CLI to set CHAP for the security of the iSCSI port that is connected with the Oracle VM Manager Initiator.Do not set the CHAP user name and CHAP password in this step.

6 Select the ETERNUS DX Disk storage system using Oracle VM Manager and perform [Delete SAN Server] to delete the ETERNUS DX Disk storage system.

7 Perform [Discover SAN Server] from [SAN Servers] in Oracle VM Manager with [Use Chap] selected for [Access Information] and specify the CHAP user name and CHAP password that were set in Step 4 for [Access Username] and [Access Password] to register the ETERNUS DX Disk storage system.

8 Select the ETERNUS DX Disk storage system that was registered using Oracle VM Manager and perform [Refresh SAN Server].

9 Select the server from [Unassigned Servers] in [Servers and VMs] of Oracle VM Manager. Select [Restart] to reboot the server and apply CHAP authentication with an iSCSI host interface.

End of procedure



27

Appendix A Setup for CHAP Authentication with an iSCSI Host Interface

When the Initiator is added to an Access Group, perform Step 4, Step 5, and Step 8 from the procedure above.

Do not delete the Initiator from the Access Group. At least one Physical Disk must be assigned to the Access Group.If the Initiator is deleted from an Access Group, the procedure above must be performed again from Step 1 to use CHAP authentication.If no Physical Disks are assigned, [Refresh SAN Server] fails. When a Physical Disk is assigned again, [Refresh SAN Server] can be performed.



28

Appendix B

JRE Use Conditions

Before using the ETERNUS Oracle VM Storage Connect Plug-in, you must agree to the following articlesregarding the handling of the JRE that is packaged together with this product.If you do not agree to these articles, you cannot use the ETERNUS Oracle VM Storage Connect Plug-in.

(1) Observe the JRE use conditions that are described in the license text file.The license text is stored in the following directory or file:/opt/FJSVstxs/jre/(version of JRE)/LICENSE/opt/FJSVstxs/jre/(version of JRE)/THIRDPARTYLICENSEREADME.txt

(2) The JRE that is packaged together with the ETERNUS Oracle VM Storage Connect Plug-in cannot be used for any purposes other than the operation of this product.

(3) Fujitsu shall not be liable for loss or damage caused by using JRE under conditions other than (1) and (2) above.



29

Appendix C

Ganymed SSH-2 for Java Use Conditions

Before using the ETERNUS Oracle VM Storage Connect Plug-in, you must agree to the following articlesregarding the handling of the Ganymed SSH-2 for Java that is packaged together with this product. If you do not agree to these articles, you cannot use the ETERNUS Oracle VM Storage Connect Plug-in.

(1) Observe the Ganymed SSH-2 for Java use conditions that are described in the license text file. The license text is stored in the following file:/opt/FJSVstxs/jars/LICENSE.txt

(2) The Ganymed SSH-2 for Java that is packaged together with the ETERNUS Oracle VM Storage Connect Plug-in cannot be used for any purposes other than the operation of this product.

(3) Fujitsu shall not be liable for loss or damage caused by using Ganymed SSH-2 for Java under conditions other than (1) and (2) above.



30

ETERNUS Oracle VM Storage Connect Plug-in 1.3User's Guide

P2X0-1280-02ENZ0

Date of issuance: February 2015Issuance responsibility: FUJITSU LIMITED

• The content of this manual is subject to change without notice.

• This manual was prepared with the utmost attention to detail.However, Fujitsu shall assume no responsibility for any operational problems as the result of errors, omissions, or the use of information in this manual.

• Fujitsu assumes no liability for damages to third party copyrights or other rights arising from the use of any information in this manual.

• The content of this manual may not be reproduced or distributed in part or in its entirety without prior permission from Fujitsu.

Documents

ETERNUS Oracle VM Storage Connect Plug-in 1.3 User’s Guide · 2015-03-05 · 3.1 Installation Procedure ... If a version earlier than Oracle VM 3.1 is used, the terms that are listed