---
title: Charmhub | Deploy storage-connector using Charmhub - The Open Operator Collection
description: Deploy the latest version of storage-connector on any cloud.
url: https://charmhub.io/bootstack-charmers-storage-connector/configurations
---

# storage-connector

[Canonical BootStack Charmers](https://charmhub.io/publisher/bootstack-charmers "View all packages from Canonical BootStack Charmers")

* [Canonical BootStack Charmers](https://charmhub.io/publisher/bootstack-charmers "View all packages from Canonical BootStack Charmers")

Platform:

22.04

20.04

18.04

stable 13

```
juju deploy bootstack-charmers-storage-connector
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

* [enable-auto-restarts](https://charmhub.io/bootstack-charmers-storage-connector/configurations#enable-auto-restarts)
* [fc-lun-alias](https://charmhub.io/bootstack-charmers-storage-connector/configurations#fc-lun-alias)
* [initiator-dictionary](https://charmhub.io/bootstack-charmers-storage-connector/configurations#initiator-dictionary)
* [iscsi-discovery-and-login](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-discovery-and-login)
* [iscsi-node-session-auth-authmethod](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-node-session-auth-authmethod)
* [iscsi-node-session-auth-password](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-node-session-auth-password)
* [iscsi-node-session-auth-password-in](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-node-session-auth-password-in)
* [iscsi-node-session-auth-username](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-node-session-auth-username)
* [iscsi-node-session-auth-username-in](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-node-session-auth-username-in)
* [iscsi-node-session-iscsi-fastabort](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-node-session-iscsi-fastabort)
* [iscsi-node-session-scan](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-node-session-scan)
* [iscsi-node-startup](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-node-startup)
* [iscsi-port](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-port)
* [iscsi-target](https://charmhub.io/bootstack-charmers-storage-connector/configurations#iscsi-target)
* [multipath-blacklist](https://charmhub.io/bootstack-charmers-storage-connector/configurations#multipath-blacklist)
* [multipath-defaults](https://charmhub.io/bootstack-charmers-storage-connector/configurations#multipath-defaults)
* [multipath-devices](https://charmhub.io/bootstack-charmers-storage-connector/configurations#multipath-devices)
* [nagios\_context](https://charmhub.io/bootstack-charmers-storage-connector/configurations#nagios_context)
* [nagios\_multipath\_paths\_per\_volume](https://charmhub.io/bootstack-charmers-storage-connector/configurations#nagios_multipath_paths_per_volume)
* [storage-type](https://charmhub.io/bootstack-charmers-storage-connector/configurations#storage-type)

[Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration)

* enable-auto-restarts | boolean

  Allow the charm and packages to restart services automatically when
  required.
* fc-lun-alias | string

  Default: data1

  LUN alias to give to the WWID for the mapping of the device. It is used in the path of the new mounted device, i.e /dev/mapper/<FC-LUN-ALIAS>.
* initiator-dictionary | string

  Default: {}

  Dictionary of hostnames (FQDN) and initiator names, surrounded by
  single quotes. The charm compares the machine hostname to
  the list, and provide the correct initiator associated to
  it. If not defined, the initiator name will be provided
  randomly. Format :
  '{"hostname1": "iqn.yyyy-mm.naming-authority:uniquename1",
  "hostname2": "iqn.yyyy-mm.naming-authority:uniquename2}'
* iscsi-discovery-and-login | boolean

  Default: True

  If set to True (default) and storage-type is iscsi, the charm will run an
  iscsiadm discovery and login against the target after charm-managed iscsi
  services restart (triggered by either config changes or by the restart-services
  action). If set to False, the charm will not automatically run the discovery
  and login against the target.
* iscsi-node-session-auth-authmethod | string

  Authentication method (CHAP or None). Default is None.
* iscsi-node-session-auth-password | string

  CHAP password for initiator authentication by the target
* iscsi-node-session-auth-password-in | string

  CHAP password for target authentication by the initiator
* iscsi-node-session-auth-username | string

  CHAP username for initiator authentication by the target
* iscsi-node-session-auth-username-in | string

  CHAP username for target authentication by the initiator
* iscsi-node-session-iscsi-fastabort | string

  Default: Yes

  Some targets like IET prefer after an initiator has sent a task
  management function like an ABORT TASK or LOGICAL UNIT RESET, that
  it does not respond to PDUs like R2Ts. To enable this behavior, set
  this config option to 'Yes'. To disable it, set it to 'No'.
* iscsi-node-session-scan | string

  Default: auto

  Automatic scans are performed on startup, on login, and on AEN/AER
  reception on devices supporting it. To prevent doing automatic scans
  that would add unwanted luns to the system, set to 'manual'. Default
  is 'auto'.
* iscsi-node-startup | string

  Default: automatic

  Startup setting for sessions. Either 'automatic' or 'manual'
* iscsi-port | string

  ISCSI target port
* iscsi-target | string

  ISCSI target IP
* multipath-blacklist | string

  In multipath config, add a blacklist device section to exclude local disks from being handled by multipath-tools. It is possible
  to blacklist by vendor/product, by devnode or WWID. String should be of JSON dictionary format. Double quotes are essential to the correct format of this JSON string.
  Example:
  value: '{"vendor": "QEMU", "product": "*"}'
  Which will produce this configuration:
  blacklist {
  device {
  vendor "QEMU"
  product "*"
  }
  }
* multipath-defaults | string

  Default: {"user\_friendly\_names": "yes"}

  In multipath config, sets the defaults configuration. String should be of JSON dictionary format.
  Double quotes are essential to the correct format of this JSON string.
  Example:
  value : '{"user\_friendly\_names":"yes", "find\_multipaths":"yes", "polling\_interval":"10"}'
  Which will produce this configuration:
  defaults {
  user\_friendly\_names yes
  find\_multipaths yes
  polling\_interval 10
  }
* multipath-devices | string

  In multipath config, add a device specific configuration. String should be of JSON dictionary format.
  Double quotes are essential to the correct format of this JSON string.
  Example:
  value : '{"vendor":"PURE","product": "FlashArray","fast\_io\_fail\_tmo": "10", "path\_grouping\_policy":"group\_by\_prio"}'
  Which will produce this configuration:
  device {
  vendor "PURE"
  product "FlashArray"
  fast\_io\_fail\_tmo 10
  path\_grouping\_policy "group\_by\_prio"
  }
* nagios\_context | string

  Default: juju

  A string that will be prepended to instance name to set the host name
  in nagios. So for instance the hostname would be something like:
  juju-myservice-0
  If you're running multiple environments with the same services in them
  this allows you to differentiate between them.
* nagios\_multipath\_paths\_per\_volume | int

  Default: 4

  Number of expected paths per volume. Any number other than this will
  raise a CRITICAL nagios alert.
* storage-type | string

  Default: None

  Type of storage connection. Can either be "iscsi" or "fc" for fibre channel. The storage type cannot be changed after deployment.
