Reconfigure
Updates array manager name and connection parameters for the SRA. Performs array
discovery as part of reconfigure operation. Ensures that all existing configured array pairs
are not affected by the connection specs changes and are still discovered. Array discovery
is not performed if only name change is requested and connection specs are
unchanged.
Synopsis
@task void reconfigure( String name, @optional AdapterConnectionSpec[] connectionSpec)
reconfigure
returns a
task instance to monitor the asynchronous operation of this method. It has the
following parameters:
Field | Description |
|---|---|
name | New name. |
connectionSpec | New connection parameters. |
AdapterConnectionSpec | Connection parameters for the SRA provided by
the user. For more information, see GetAdapterConnectionSpec. |
If a task fails, its error field may contain one of the following:
- drextapi.fault.ArrayPairNotFound- if arrays are not found for already configured array pair.
- drextapi.fault.CommandFailed- if SRA failed to execute discoverArrays command.
- drextapi.fault.DuplicateName- if an array manager with the same name already exists.
- drextapi.fault.DuplicateArray- if array, which is already discovered by another array manager with the same SRA, was discovered
- drextapi.fault.InvalidAdapterConnectionSpec- if connectionSpec doesn't match the internal StorageAdapter connection spec typically, a more specific fault is thrown.
- drextapi.fault.StringArgumentTooLong- if the size of the name parameter is too long.
- drextapi.fault.StorageAdapterNotFound- if SRA was not found for this array manager.