Page History

...

Section

Column

width	35%

Panel

borderColor	#CCCCCC
bgColor	#FFFFFF
titleBGColor	#F0F0F0
borderStyle	solid
title	On this page:

Table of Contents

Column

Creating

...

an archive entity

Code Block

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
      "added": [ {
          "uid": "hosts/server",
          "units": [ {
              "type": "MultimediaStorage",
              "properties": [
                { "id": "display_name", "properties": [], "value_string": "ArchiveStorageArchive Storage" },
                { "id": "color", "properties": [], "value_string": "Gray" },
                { "id": "storage_type", "value_string": "object" }
      ] } ] } ],
      "changed": [],
      "removed": []
    }
}

where

uid − Server on which the archive is created;
units − properties;
volumestorage_type − archive type: block − old archive type; object − new archive type (object archive). If the parameter is not explicitly specified, then an archive of old type is created.

Creating an archive volume

Possible ArchiveVolume parameters in the properties section:

Parameter	Description
format	true if it is necessary to format the created volume. The default is false.
volume_size_gb	Volume size in

bytes

GB. Applicable if format = true.
auto_mount	true if it is necessary to mount the created volume. The default is false.
label	Volume label
Parameters for object archives only (storage_type = object):
max_block_size_mb	Maximum block size in MB. The default is 64, the range of valid values is [16; 512].
optimal_read_size_mb	Optimal size of blocks reading in MB. The default is 4, the range of valid values is [1; max_block_size_mb / 2].
incoming_buffer_size_mb	The incoming buffer size in MB. The default is 3 * max_block_size_mb. The minimum value should be greater than 2 * max_block_size_mb.
block_flush_period_seconds	Block recording period in seconds. The default is 60, the range of valid values is [30; 300].
index_snapshot_max_block_distance	The maximum number of blocks between indexing operations. The default is 256, the minimum is 16.
sequence_flush_period_seconds	Sequences recording period in seconds. The default is 60, the minimum is 32.

At the ArchiveVolume level, the connection_params property is also added, with the following parameters:

Parameter

Required

Description

schema

Yes

Volume type. Possible values:

file − local archive on the Server;

smb − network archive with an SMB protocol connection;

azure − archive in Microsoft Azure cloud storage;

s3

_amazon

− archive in cloud storage Amazon S3

cloud storage

(aws.amazon.com/s3)

.s3_wasabi − archive in Wasabi cloud storage

, Wasabi (wasabi.com)

.s3_huawei − archive in Huawei Cloud cloud storage

, Huawei Cloud (huaweicloud.com)

.s3_seagate − archive in Seagate

, or Seagate Lyve Cloud

cloud storage

(seagate.com).
Parameters for the file type:
path	Yes	The path to the file/disk with the archive.
Parameters for the smb type:
host	Yes	Name of the server with network repository.
smb_share	Yes	Network repository.
path	Yes	Folder in network repository, where the archive will be stored.
smb_domain	No	Network repository domain.
user	No	User name.
password	No	Password.
Parameters for the

azure

Azure type:
protocol	Yes	Connection protocol: HTTP or HTTPS.

This parameter is located in the properties of the created container.
host	Yes	Azure server address.

This parameter is located in the properties of the created container.
access_key	Yes	Access key in base64.

This parameter is located in the Access keys section.
container	Yes	Azure container.

This parameter is located in the properties of the created container.
user	Yes	User name.

This parameter is located in the Access keys section (Storage account name).
path	No

Do not specify the location of

Location of the volume folder in Azure

— the parameter should be empty

.
port	No	Azure server port.
Parameters for the s3

_amazon

type (Amazon storage):
access_key_id	Yes	Access key identifier (create access keys at https://console.aws.amazon.com/iam/home?#/security_credentials$access_key, authorization required).
secret_access_key	Yes	Access key password (available after creating an access key).
bucket	Yes	Archive volume in Amazon S3 account (bucket). Different volumes can be located in different regions. On the Amazon S3 server, the volume name should be unique, and for the Axxon Next operation, it should be pre-created by the user according to the rules (see https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html).
region	Yes	The region where the volume is located. To reduce the delay when writing and reading an archive, specify the closest region to the Axxon Next Server. For the list of possible regions, see https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints.
path	Yes	Location of the Axxon Next volume folder inside the bucket.
protocol	Yes	Connection protocol: HTTP or HTTPS.
host	Yes

Server address:

Amazon S3 server address in the format: <bucket_name>.s3.amazonaws.com.
Parameters for the s3

_wasabi

type (Wasabi storage):
bucket	Yes	Archive volume name (Bucket Name), predefined by the user at https://console.wasabisys.com/#/file_manager.
region	Yes	The region where the corresponding volume is located, as specified at https://console.wasabisys.com/#/file_manager.
access_key_id	Yes	Access key identifier, which should be pre-created at https://console.wasabisys.com/#/access_keys.
secret_access_key	Yes	Access key password (available after creating an access key).
protocol	Yes	Connection protocol: HTTP or HTTPS.
path	Yes	Location of the folder created inside the bucket (Folder object in Bucket).
host	Yes

Server

Wasabi server address in the format: s3.<region>.wasabisys.com.
Parameters for the s3

_huawei

type (Huawei Cloud storage):
bucket	Yes	Archive volume name (Bucket Name), predefined by the user at the Object Storage Service tab.
region	Yes	The region where the corresponding volume is located, as specified when it was created. Specified in the Endpoint parameter in the Bucket properties.
access_key_id	Yes	Access key identifier, which should be created by clicking on the link "Obtain access keys (AK and SK)".
secret_access_key	Yes	Access key password (available after creating an access key).
path	Yes	Location of the folder created inside the bucket.
protocol	Yes	Connection protocol: HTTP or HTTPS.
host	Yes	Server address

: myhuaweicloud.com

. Corresponds to the Endpoint parameter in the Bucket properties.
Parameters for the s3

_seagate

type (Seagate Lyve Cloud storage):
bucket	Yes	Archive volume name (Bucket Name), predefined by the user. Corresponds to the Name parameter in the Bucket properties.
region	Yes	The region where the corresponding volume is located, as specified when it was created. Corresponds to the Region parameter in the Bucket properties.
access_key_id	Yes	Access key identifier, which is generated when creating an account in the Create Service Account window.
secret_access_key	Yes	Access key password (available after creating an access key).
path	Yes	Location of the folder created inside the bucket.
protocol	Yes	Connection protocol: HTTP or HTTPS.
host	Yes	Server address

: lyvecloud.seagate.com

. Corresponds to the Virtual Host URL parameter in the Bucket properties.

Example of creating an object archive volume as files on a local disk:

Expand

title	Click to expand...

Code Block

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
        "added": [
            {
                "uid": "hosts/server/MultimediaStorage.Gray",
                "units": [
                    {
                        "type"type": "ArchiveVolume",
                        "properties": [
                            {
                                "id": "volumeconnection_typeparams",
                                "value_stringproperties": "object",
        {
                        "properties": [
                            { "id": "schema", "value_string":     {"file" },
                                        { "id": "connection_paramspath",
 "value_string": "D:/Dev/!temp/Archive" }
                ] } },
                { "id": "label", "value_propertiesstring": {
"Test archive" },
                { "id": "volume_size_gb", "value_uint64": 5 },
                {     "properties"id": "format", "value_bool": [
true },
                                               {{ "id": "schemaauto_mount", "value_stringbool": true "file"},
      ] } ] } ],
      "changed": [],
      "removed": []
                        {"id": "path","value_string": "D:/archives"}}
}

Example of creating an object archive on a network resource:

Expand

title	Click to expand...

Code Block

{
  "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
      "added": [
        {
          "uid": "hosts/server/MultimediaStorage.Gray",
          "units": [
            {
  ]}}]},
              "type": "ArchiveVolume",
              {"idproperties": "label","value_string": "test"},
 [
                {
                  {  "id": "volumeconnection_sizeparams",
                    "value_uint64properties": "1073741824"},{
                            {"idproperties": "format","value_bool": true}[
                            { "id": "auto_mountschema", "value_boolstring": "smb" true},
                        ]}]}
        ]
    }
}

Example of creating an archive volume on a network resource:

...

title	Click to expand...

Code Block

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
        "added": [
            {
                "uid": "hosts/server/MultimediaStorage.Gray",
                "units": [
                    {
                        "type": "ArchiveVolume",
                        "properties": [
                            {
                                "id": "volume_type",
                                "value_string": "object",
                                "properties": [
                                    {
                                        "id": "connection_params",
                                        "value_properties": {
                                            "properties": [
                                                { "id": "schema", "value_string": "smb" },
                                                { "id": "host", "value_string": "qa-t9" },
                                                { "id": "smb_share", "value_string": "incoming" },
                                                { "id": "path", "value_string": "video" },
                                                { "id": "user", "value_string": "Tester" },
                                                { "id": "password", "value_string": "Testing321" }
                                            ]}}]},
                            {"id": "label","value_string": "test"},
                            {"id": "volume_size","value_uint64": "1073741824"},
                            {"id": "format","value_bool": true}
                        ]}]}
        ]
    }
}

Example of creating an object archive volume in Microsoft Azure:

...

title	Click to expand...

Code Block

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
        "added": [
            {
                "uid": "hosts/server/MultimediaStorage.Gray",
                "units": [
                    {
                        "type": "ArchiveVolume",
                        "properties": [
                            {
                                "id": "volume_type",
                                "value_string": "object",
                                "properties": [
                                    {
                                        "id": "connection_params",
                                        "value_properties": {
                                            "properties": [
                                                { "id": "schema", "value_string": "azure" },
                                                { "id": "protocol", "value_string": "https" },
                                                { "id": "host", "value_string": "axxonsoft.blob.core.windows.net" },
                                                { "id": "access_key", "value_string": "youraccesskey==" },
                                                { "id": "container", "value_string": "container" },
                                                { "id": "user", "value_string": "axxonsoft" },
                                                { "id": "path", "value_string": "" }
                                            ]}}]},
                            {"id": "label","value_string": "test"},
                            {"id": "volume_size","value_uint64": "1073741824"},
                            {"id": "format","value_bool": true}
                        ]}]}
        ]
    }
}

Example of creating an object archive volume in Amazon S3:

Expand

title	Click to expand...

Code Block

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
        "added": [
            {
                "uid": "hosts/server/MultimediaStorage.Gray",
                "units": [
                    {
                        "type": "ArchiveVolume",
                        "properties": [
                            {
                                "id": "volume_type",
                                "value_string": "object",
                                "properties": [
                                    {
                                        "id": "connection_params",
                                        "value_properties": {
                                            "properties": [
                                                { "id": "schema", "value_string": "s3_amazon" },
                                                { "id": "bucket", "value_string": "axxonsoft-test1" },
                                                { "id": "region", "value_string": "us-west-1" },
                                                { "id": "access_key_id", "value_string": "youraccesskeyid" },
                                                { "id": "secret_access_key", "value_string": "yoursecretaccesskey" },
                                                { "id": "path", "value_string": "path" },
                                                { "id": "protocol", "value_string": "https" },
                                                { "id": "host", "value_string": "amazonaws.com" }
                                            ]}}]}": "host", "value_string": "qa-t9" },
                            { "id": "labelsmb_share", "value_string": "testincoming" },
                            { "id": "volume_sizepath", "value_uint64string": "1073741824video" },
                            { "id": "formatuser", "value_boolstring": "Tester" true},
                        ]}]}
        ]
    }
}

Example of creating an object archive volume in Wasabi:

Expand

title	Click to expand...

Code Block

{
       { "methodid": "axxonsoft.bl.config.ConfigurationService.ChangeConfigpassword",
    "data": { "value_string": "123456" }
        "added": [
       ] } },
   {
             { "id": "label", "uidvalue_string": "hosts/server/MultimediaStorage.Gray"Test archive" },
                { "unitsid": [
     "volume_size_gb", "value_uint64": 5 },
               {
  { "id": "format", "value_bool": true },
                { "typeid": "ArchiveVolumeauto_mount", "value_bool": true }
      ] } ] } ],
        "changed": [],
      "propertiesremoved": []
    }
}

Example of creating an object archive in Microsoft Azure:

Expand

title	Click to expand...

Code Block

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
      "added": [
        {
          "uid": "hosts/server/MultimediaStorage.Gray",
                     "id"units": "volume_type",[
             {
                   "value_string"type": "objectArchiveVolume",
                                "properties": [
                {
                    {
    "id": "connection_params",
                    "value_properties": {
               "id": "connection_params",
        "properties": [
                            { "id": "schema", "value_propertiesstring": {"azure" },
                            { "id": "protocol", "value_string": "https" },
           "properties": [
                 { "id": "host", "value_string":   "axxonsoft.blob.core.windows.net" },
                            { "id": "schemaaccess_key", "value_string": "s3_wasabiyouraccesskey==" },
                            { "id": "container", "value_string": "container" },
                            { "id": "bucketuser", "value_string": "axxontest-1axxonsoft" },
                                                { "id": "regionpath", "value_string": "eu-central-1" },
                ] } },
                { "id": "label", "value_string": "Test archive"  },
                { "id": "accessvolume_keysize_idgb", "value_stringuint64": "youraccesskeyid"5 },
                { "id": "format", "value_bool": true }
      ] } ] } ],
      "changed": [],
      "removed": []
    }
}

Example of creating an object archive in Amazon S3:

Expand

title	Click to expand...

Code Block

{
  "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig"{ "id": "secret_access_key", "value_string": "yoursecretaccesskey" },
    "data": {
      "added": [
        {
                            { "id"uid": "path", "value_string": "path" }hosts/server/MultimediaStorage.Gray",
                       "units": [
            {
             { "idtype": "protocolArchiveVolume",
 "value_string": "http" },
           "properties": [
                 {
                   { "id": "hostconnection_params",
 "value_string": "wasabisys.com" }
                 "value_properties": {
                          ]}}]},"properties": [
                            { "id": "labelschema", "value_string": "tests3" },
                            { "id": "volume_sizebucket", "value_uint64string": "1073741824bucketname" },
                            { "id": "formatregion", "value_boolstring": true}
   "eu-central-1" },
                      ]}]}
        ]
    }
}

Example of creating an object archive volume in Huawei Cloud:

Expand

title	Click to expand...

Code Block

{
    "methodid": "axxonsoft.bl.config.ConfigurationService.ChangeConfigaccess_key_id",
    "value_string": "datayouraccesskeyid": {},
        "added": [
            {
       {         "uid"id": "secret_access_key", "value_string": "hosts/server/MultimediaStorage.Gray"yoursecretaccesskey" },
                "units": [
            { "id": "path", "value_string": "path" },
       {
                     { "id": "protocol", "typevalue_string": "ArchiveVolumehttps" },
                            { "propertiesid": [
  "host", "value_string": "bucketname.s3.amazonaws.com" }
                ] } },
        {
        { "id": "label", "value_string": "Test archive" },
                {  "id": "volume_typesize_gb",
 "value_uint64": 1 },
                             "value_string{ "id": "objectformat",
 "value_bool": true }
      ] } ] } ],
                   "properties"changed": [],
        "removed": []
    }
}

Example of creating an object archive in Wasabi:

Expand

title	Click to expand...

Code Block

{
  "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
      "added": [
        {
          "uid": "hosts/server/MultimediaStorage.Tan",
          "units": [
            {
      "id": "connection_params",
         "type": "ArchiveVolume",
              "properties": [
               "value_properties": {
                    "id": "connection_params",
                       "value_properties": [{
                        "properties": [
                            { "id": "schema", "value_string": "s3_huawei" },
                                                { "id": "bucket", "value_string": "axxon-test-1" },
                   archive-wasabi" },
                             { "id": "region", "value_string": "naeu-mexicocentral-1" },
                                                { "id": "access_key_id", "value_string": "youraccesskeyid" },
                                                { "id": "secret_access_key", "value_string": "yoursecretaccesskey" },
                                                { "id": "path", "value_string": "path" },
                    , "value_string": "path" },
                            { "id": "protocol", "value_string": "https" },
                                                { "id": "host", "value_string": "myhuaweiclouds3.eu-central-1.wasabisys.com" }
                ] } },
                { "id": "label", "value_string": "Test archive" },
            ]}}]},
    { "id": "volume_size_gb", "value_uint64": 1 },
                    { {"id": "labelformat", "value_stringbool": true "test"},
      ] } ] } ],
      "changed": [],
      "removed": []
    {"id": "volume_size","value_uint64": "1073741824"}}
}

Example of creating an object archive in Huawei Cloud:

Expand

title	Click to expand...

Code Block
{ "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { {"iduid": "formathosts/server/MultimediaStorage.Gray","value_bool": true} "units": [ ]}]}{ ] } }

Example of creating an object archive volume in Seagate Lyve Cloud:

Expand

title	Click to expand...

Code Block

{
    "methodtype": "axxonsoft.bl.config.ConfigurationService.ChangeConfigArchiveVolume",
    "data": {
          "addedproperties": [
                {
                    "uidid": "hosts/server/MultimediaStorage.Grayconnection_params",
                    "unitsvalue_properties": [{
                    {
    "properties": [
                         "type   { "id": "schema", "value_string": "ArchiveVolumes3" },
                            { "properties": ["id": "bucket", "value_string": "axxon-test" },
                            {
 "id": "region", "value_string": "na-mexico-1" },
                            { "id": "volume_type"access_key_id", "value_string": "youraccesskeyid" },
                            {   "id": "secret_access_key", "value_string": "objectyoursecretaccesskey" },
                            { "id": "path", "value_string": "propertiespath": [
              },
                      {
      { "id": "protocol", "value_string": "https" },
                            { "id": "connection_paramshost",
 "value_string": "obs.na-mexico-1.myhuaweicloud.com" }
                ] } },
                { "id": "label", "value_propertiesstring": {
"Test archive" },
                                          "properties": [{ "id": "volume_size_gb", "value_uint64": 5 },
                { "id": "format", "value_bool": true }
      ] } ] } ],
      "changed": [],
      "removed": []
    }
}

Example of creating an object archive in Seagate Lyve Cloud:

Expand

title	Click to expand...

Code Block

{
  "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig"{ "id": "schema", "value_string": "s3_seagate" },
    "data": {
      "added": [
        {
        { "id": "bucket", "value_string"uid": "axxonsoft-test" }hosts/server/MultimediaStorage.Tan",
                            { "id": "region", "value_string": "us-west-1" },
  "units": [
            {
              { "idtype": "access_key_idArchiveVolume",
  "value_string": "youraccesskeyid" },
            "properties": [
                {
                   { "id": "secretconnection_access_keyparams", "value_string": "yoursecretaccesskey" },

                    "value_properties": {
                    { "id": "path", "value_string": "pathproperties": },[
                            { "id": "protocolschema", "value_string": "httpss3" },
                            { "id": "hostbucket", "value_string": "lyvecloud.seagate.comaxxonsoft-test" },
                            { "id": "region",              ]}}]}"value_string": "us-west-1" },
                            { "id": "labelaccess_key_id", "value_string": "testyouraccesskeyid" },
                            { "id": "volumesecret_access_sizekey", "value_uint64string": "1073741824yoursecretaccesskey" },
                            { "id": "formatpath", "value_boolstring": true"path" },
                        ]}]}
        ]
    }
}

Changing an archive volume

To change the archive volume, the same parameters are used as when creating it.

Code Block

method

id": "

axxonsoft.bl.config.ConfigurationService.ChangeConfig

protocol",

data

value_string":

{

"changed": [

"https" },

{

{ "

uid

id": "

hosts/server/MultimediaStorage.Blue/ArchiveVolume.a28b6639-645c-4b0d-88ba-ffa2d2adc0e3",

host", "value_string": "s3.us-west-1.lyvecloud.seagate.com" }
                ]

"properties": [

} },

 "id": "label", "value_string": "Test archive" },
                {

"id": "

label

volume_size_gb",

 "value_uint64": 1 },
                {

"id": "format", "value_

string

bool": true

"test3"

}
      ]

} ] } ],

}

"changed": [],
      "removed": []
    }
}

Changing an archive volume

To change the archive volume, the same parameters are used as when creating it.

Code Block

{
  "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
     "data": {
      "added": [
        {
          "iduid": "readonly"hosts/server/MultimediaStorage.Gray/ArchiveVolume.495c3ef4-043f-4890-a4e0-c66f4fa252e7",
          "units": [
             "value_bool": false{
              "type": "ArchiveVolume",
     },
         "properties": [
          {
      {
                  "id": "connection_params",
                        "value_properties": {
                            "properties": [
                       { "id": "schema", "value_string":      {"file" },
                                    { "id": "path", "value_string": "D:/archiveAliceBlueBlock" }
                       ] }
        }
        },
                { "id": "label",  ]
   "value_string": "Test archive block" },
                { "id": "volume_size_gb", "value_uint64": 100 },
                { "id": "format", "value_bool": true }
      ] } ]        ]} ],
            }"changed": [],
      "removed":  []
    }
}

Page tree

Versions Compared

Old Version 19

New Version Current

Key

Creating

an archive entity

Creating an archive volume

Changing an archive volume

Changing an archive volume