IBM Aspera HST User Manual

| Configure the Server from the Command Line | 82
Note: If a validator does not update the file status within the validation timeout, the file status is reset to
"to_be_validated" and the file is released from the validator so that the file can be validated by a different
validator. The default timeout is 5 minutes. To edit the validation timeout, run the following command:
# asconfigurator -x "set_central_server_data;validation_timeout,seconds"
c) Update the status of each file as validation completes or fails:
If a file passes validation, update its status to "completed":
curl -X PUT -u node_user:password -d '{ "validator_id": "validator_id",
"files": [{ "session_uuid": "session_uuid", "file_id": "file_id",
"status": "completed" } ] }' https://server_name:9092/services/rest/
transfers/v1/files
If the file fails validation, update its status to "error" and provide an error code (as a number) and error
description (as a string):
curl -X PUT -u node_user:password -d '{ "validator_id": "validator_id",
"files": [{ "session_uuid": "session_uuid", "file_id": "file_id",
"status": "error", "error_code": error_number, "error_description":
"error_string" } ] }' https://server_name:9092/services/rest/transfers/
v1/files
For example, the body of a PUT request could contain the following information for three files:
{
"validator_id": "my identifier",
"files": [
{
"session_uuid": "1425c741-32bb-492d-b5e1-724c8bdb1fbf",
"file_id": "11111111-11422dfb-5b8ed464-239783b8-09c78597",
"status": "validating",
"bytes_processed": 3
},
{
"session_uuid": "1425c741-32bb-492d-b5e1-724c8bdb1fbf",
"file_id": "22222222-11422dfb-5b8ed464-239783b8-09c78597",
"status": "completed"
},
{
"session_uuid": "1425c741-32bb-492d-b5e1-724c8bdb1fbf",
"file_id": "33333333-11422dfb-5b8ed464-239783b8-09c78597",
"status": "error",
"error_code": 2,
"error_description": "File not found"
}
]
}
If all files validate and update successfully, HTTP 204 is returned. If one or more files have failed validation,
HTTP 200 is returned. For each failed file, an entry is added to the result. If another HTTP code is returned, then a
more general error, such as invalid JSON, has occurred.
3.
Confirm that persistent storage is enabled (the default setting).
From the command line, run the following command:
# /opt/aspera/bin/asuserdata -c

IBM Aspera HST Specifications

General

Brand	IBM
Model	Aspera HST
Category	Server
Language	English