Search <book_title>...

InfoScale™ 9.0 Solutions Guide - Linux

Last Published: 2025-04-14

Product(s): InfoScale & Storage Foundation (9.0)

Platform: Linux

Section I. Introducing Veritas InfoScale
1. Introducing Veritas InfoScale
  1. About the Arctera InfoScale product suite
  2. Components of the Arctera InfoScale product suite
Section II. Solutions for Veritas InfoScale products
1. Solutions for Veritas InfoScale products
Section III. Stack-level migration to IPv6 or dual stack
1. Stack-level migration to IPv6 or dual stack
  1. Migrating Veritas InfoScale products to support IPv6/dual-stack
Section IV. Improving database performance
Section V. Using point-in-time copies
Section VI. Maximizing storage utilization
1. Optimizing storage tiering with SmartTier
2. Optimizing storage with Flexible Storage Sharing
Section VII. Migrating data
Section VIII. Veritas InfoScale 4K sector device support solution
1. Veritas InfoScale 4k sector device support solution
Section IX. REST API support
1. Support for configurations and operations using REST APIs
Section X. Reference
1. Appendix A. Veritas AppProtect logs and operation states
  1. Log files
  2. Plan states
2. Appendix B. Troubleshooting Veritas AppProtect
  1. Troubleshooting Just In Time Availability

Configuring the REST server

The REST server is configured on one of the nodes of an InfoScale cluster, and the RestServer agent manages the high availability of this component.

In case of Cluster Volume Manager (CVM) environments, the REST server is bound to the CVM master server.

You can configure the REST server by using the product installer at the following instances:

While a new cluster configuration is in progress
# ./installer -configure
On a cluster configured with InfoScale 9.0
# /opt/VRTS/install/installer -rest_server
After upgrading a cluster from any earlier version to InfoScale 9.0
# ./installer -upgrade
# /opt/VRTS/install/installer -rest_server

You can also perform the same operations using response files.

Note:

This section does not describe REST server configurations in container environments. For details, refer to the Veritas InfoScale Support for Containers document.

Prerequisites

The cluster must be configured in the secure mode.
A dedicated, unused virtual IP address must be available.
This requirement does not apply to single-node clusters where the public IP of the system is used.

Installer prompts for configuring the REST server

During a new installation (# ./installer -configure), when you specify that you want to the configure a REST server, the installer first configures a secure cluster.
When a cluster is already configured (# /opt/VRTS/install/installer -rest_server), the installer continues with the further prompts.
Next, it asks you to provide the following values associated with the cluster nodes:
- A NIC for each node; the same NIC can be used for all the nodes
- A virtual IP address and a network mask
- A port number associated with the IP address (default: 5636)
Next, it asks you whether to use a Veritas-provided security certificate or a third-party CA certificate. In case of a Veritas-provided security certificate, no further input is required. In case of a third-party CA certificate, the installer prompts you to provide the following information associated:
- A valid server key file path
- A valid server certificate file path
- A valid CA certificate file path
- Confirmation on whether the REST server key certificate is encrypted
- A passphrase to decrypt the key in case the server key is encrypted
Next, it asks you for the domain name and the IP address of the LDAP server from which the REST server can fetch user data for authentication.
Next, the installer displays the information that you provided and prompts you to verify its accuracy.
Next, it prompts you to provide the name (default: admin) of a user and the roles to be assigned to that user. This activity is required only for the first user of the REST server. Other users can be added later.
See Authorization of users for performing operations using REST APIs.
At this point, any ongoing InfoScale processes need to be stopped. The installer prompts you confirm your agreement.

After gathering all the required input and stopping the InfoScale processes, the installer bring the RestSG service group online.

Note:

If any issues occur during the configuration, the installer rolls back all the changes that are relevant to the REST server configuration.

Response-file based REST server configuration

InfoScale lets you configure the REST server using response files. The command used is:

# ./installer -responsefile /tmp/full_response_file_path_and_name

A sample response is as follows:

our %CFG;
$CFG{REST_server}=1;
$CFG{REST_server_cacert_file}="/certs/server.crt";
$CFG{REST_server_cert_file}="/certs/server.crt";
$CFG{REST_server_ip}="xx.xxx.xxx.xxx";
$CFG{REST_server_key}="/certs/server.key";
$CFG{REST_server_ldap_admin}="Manager";
$CFG{REST_server_ldap_domain}="myveritas.com";
$CFG{REST_server_ldap_domain_password}="ldppassword";
$CFG{REST_server_ldap_ip}="xx.xxx.xxx.xxx";
$CFG{REST_server_netmask}="255.255.240.0";
$CFG{REST_server_nic}{all}="nicdevice";
$CFG{REST_server_passphrase}="****";
$CFG{REST_server_port}=5637;
$CFG{REST_server_third_party_cert}=1;
$CFG{REST_server_username}="adam";
$CFG{opt}{rest_server}=1;
$CFG{prod}="ENTERPRISE802";
$CFG{systems}=[ "infoscale_sys1","infoscale_sys1" ];
$CFG{vcs_clusterid}=11111;
$CFG{vcs_clustername}="Cluster01";

1;