JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Sun ZFS Appliance Monitor

Configuration Guide, Version 1.0

search filter icon
search icon

Document Information

Using This Documentation

1.  Configuring the Sun ZFS Appliance Monitor

Before You Begin

Configure Monitoring

Enter Host Connection Data

Create a Configuration File

Encrypt the Configuration File

Enter Configuration File Location

Configure Monitoring

You can configure monitoring by entering connection data manually on the Configuration screen, or you can create a configuration file.

Enter Host Connection Data

  1. On the iPhone Home screen, tap the Sun ZFS Appliance Monitor icon.
  2. On the Configuration screen, tap the + button.
    image:Screen capture of the Configuration screen.
  3. On the New Host screen, enter the following connection data:
    image:Screen capture of the New Host screen where you enter connection data.
    • Host name of the storage appliance
    • IP address of the storage appliance
    • Port number on which the administrative service is running. Default is 215.
    • User name and Password for logging into the storage appliance
    • (Optional) Host-specific note

Create a Configuration File

You can create a configuration file to hold connection data for one or more storage appliances. After saving your configuration file, you must encrypt the configuration file.

  1. Create a spreadsheet using OpenOffice.
  2. Save the file in the /tmp directory or another directory created on a memory based filesystem.
  3. Change the permissions of the file to read and write for the owner only.
  4. Format each column as a text field:
    • Select all cells, right click, and select Format Cells.
    • From the Numbers tab, select Text from the Category field and click OK.
  5. For each server, enter a row containing the following data in columns A-F.
    Column
    Description
    A
    Host name of the storage appliance
    B
    IP address of the storage appliance
    C
    Network port number on which the administrative service is running. Default is 215.
    D
    User name for logging into the storage appliance
    E
    Password for username
    F
    Optional host-specific note

    Note - Do not enter column headings or any additional information in other rows or columns.


  6. Save the configuration file as type Text CSV (comma-separated values):
    1. Select File > Save as.. and enter a file name.
    2. Select File type: Text CSV (.csv) and click Save.
    3. In the Export of text files window, select the following:

      Character Set: Unicode UTF-8 (recommended)

      Field Delimiter: , (comma)

      Text Delimiter: " (quote)

  7. Click OK.

    The configuration file is formatted as shown in this example:

    "host1","10.10.xx.xx","215","canopy","password","host note"
    "host2","10.10.xx.xx","215","canopy","password","host note"
    "host3","10.10.xx.xx","215","canopy","password","host note"
    "host4","10.10.xx.xx","215","canopy","password","host note"
    "host5","10.10.xx.xx","215","canopy","password","host note"
    "host6","10.10.xx.xx","215","canopy","password","host note"
    "host7","10.10.xx.xx","215","canopy","password","host note"
    "host8","10.10.xx.xx","215","canopy","password","host note"
    "host9","10.10.xx.xx","215","canopy","password","host note"

Encrypt the Configuration File


Note - You must encrypt the configuration file. The appliance monitor will not accept an unencrypted file.


  1. Create an encrypted version of the CSV configuration file, using the openssl command:

    openssl aes-128-cbc -md sha512 -in <input file> -out <output file>

  2. When prompted, enter a password for the encrypted file, as shown in this example:
    openssl aes-128-cbc -md sha512 -in canopy.csv -out canopy_ae.csv
    enter aes-128-cbc encryption password: test
    Verifying - enter aes-128-cbc encryption password: test
  3. Store the configuration file on a web server that can be accessed by the application.
  4. Securely delete the old unencrypted file using a program that overwrites the data. The shred program is part of the GNU Core Utilities and is highly recommended for this task.

Enter Configuration File Location

  1. On the Configuration screen, tap the Remote Config File button.
    image:Screen capture of the Configuration screen and Remote Config File button.
  2. Enter the following information:
    • URL of the configuration file
    • User name and password of the web server
    • Password for the encrypted configuration file

    image:Screen capture showing where you enter the name of the configuration file and login information.
  3. Set Auto Accept Self-Signed Certificate to ON and the self-signed certificate for each appliance you connect to will be accepted automatically. Change the setting to OFF, and you will be prompted to accept the self-signed certificate the first time you connect to each appliance.

    Note - The auto accept setting pertains only to the first self-signed certificate exchange. If the public key changes, you will be prompted again regardless of the setting.


  4. Tap Process Config File.