# Macrosan Driver for OpenStack Manila

The Macrosan driver provides NFS and CIFS shared file systems to Openstack.

## Requirements

- The following service should be enabled on NAS system:

  - CIFS

  - NFS

## Supported Operations

The following operations are supported:

- Create CIFS/NFS Share

- Delete CIFS/NFS Share

- Allow CIFS/NFS Share access

  - Only IP access type is supported for NFS (ro/rw).

  - Only USER access type is supported for CIFS (ro/rw).

- Deny CIFS/NFS Share access

- Extend a share.

- Shrink a share.

## Backend Configuration

The following parameters need to be configured in the [DEFAULT] section of manila configuration (/etc/manila/manila.conf):

- enabled_share_backends - Name of the section on manila.conf used to specify a backend i.e. enabled_share_backends = macrosan

- enabled_share_protocols - Specify a list of protocols to be allowed for share creation. The VPSA driver support the following options: NFS or CIFS or NFS, CIFS

The following parameters need to be configured in the [backend] section of manila configuration (/etc/manila/manila.conf):

- share_backend_name = <backend name to enable>

- share_driver = manila.share.drivers.macrosan.macrosan_nas.MacrosanNasDriver

- driver_handles_share_servers = False

- macrosan_nas_ip = <IP address for access to the NAS controller>

- macrosan_nas_port = <Port number for access to the NAS controller>

- macrosan_nas_user = <username for access>

- macrosan_nas_password = <password for the user specified in macrosan_nas_user>

- macrosan_share_pools = <Poolname of the NAS controller>

## Share Types

When creating a share, a share type can be specified to determine where and how the share will be created. If a share type is not specified, the default_share_type set in the manila configuration file is used.

Manila requires that the share type includes the driver_handles_share_servers extra-spec. This ensures that the share will be created on a backend that supports the requested driver_handles_share_servers (share networks) capability. For the Macrosan driver, this must be set to False.

## Back-end configuration example

    [DEFAULT]
    enabled_share_backends = macrosan
    enabled_share_protocols = NFS, CIFS

    [macrosan]
    share_backend_name = MACROSAN
    share_driver = manila.share.drivers.macrosan.macrosan_nas.MacrosanNasDriver
    driver_handles_share_servers = False
    macrosan_nas_ip = FAKE_IP
    macrosan_nas_port = 8443
    macrosan_nas_user = FAKE_USER
    macrosan_nas_password = FAKE_PASSWORD
    macrosan_share_pools = fake_pool1, fake_pool2

this page last updated: 2026-03-20 00:20:57

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug