To run an application, you must install the zFCP HBA API library that is provided by the
libzfcphbaapi0 package. You can set environment variables to log any errors in
the library, and use tools to investigate the SAN configuration.
Before you begin
To use the HBA API support, you need the zFCP HBA API library,
libzfcphbaapi0. Installing libzfcphbaapi0 automatically
installs all dependent packages. The application must be developed to use the zFCP HBA API
library, see Developing applications.
Procedure
Follow these steps to access the library from a client application:
-
Install the libzfcphbaapi0 package with apt-get.
For example:
# apt-get install libzfcphbaapi0
- Optional:
Set the environment variables for logging errors.
The zfcp HBA API support uses the following environment variables to log errors in the zfcp
HBA API library:
- LIB_ZFCP_HBAAPI_LOG_LEVEL
- specifies the log level. If not set or set to zero, there is no logging (default). If set to an
integer value greater than 1, logging is enabled.
- LIB_ZFCP_HBAAPI_LOG_FILE
- specifies a file for the logging output. If not specified, stderr is used.
What to do next
You can use the zfcp_ping and zfcp_show commands to
investigate your SAN configuration. These commands are available with the
zfcp-hbaapi-utils package.