config_fabrics | Teradata DSA Commands - 17.20 - config_fabrics - BAR - Data Stream Architecture

Teradata® DSA User Guide

Product
BAR
Data Stream Architecture
Release Number
17.20
Release Date
October 2021
Content Type
User Guide
Publication ID
B035-3150-101K
Language
English (United States)

Purpose

Beginning with DSA 16.10.01, the config_fabrics command defines the routing data path between TPA nodes and media servers using a parameter file. For best performance when using network fabric, make sure dsc.properties has validate.fabric=on.

Network fabric is not supported for repository backup and restore.

Syntax

config_fabrics -n|-name -f|-file FILE

Example

config_fabrics -f file1.xml

Parameters

n|name fabric_name
[Optional] Name of the fabric configuration.
f|file filename
The full path and name of the file containing the necessary configuration parameters.
u|user_authentication User
Required when security management is enabled. Supplies the command with the Viewpoint user, and triggers a password prompt for authentication.

Permissions required: Administrator role

Usage Notes

You can define multiple fabrics but each must be unique. For example, System A can have two fabrics for two target systems B and C, fabricAB and fabricAC. The information is saved into the repository and can be edited if new media servers or nodes are added.
  • All media servers in a target group should be available in a single fabric.
  • The correct fabric is chosen based on the media servers in the target group.
  • Update dsc.properties for the number of fabrics allowed per Teradata system: maxlimit.fabric=number-fabrics. Default is 64.

The target group must define at least one media server that belongs to the fabric.

If a fabric is defined, job submission skips the logical net mask and selects the existing fabric when defining job data paths.

XML File Example

A representative XML file is shown below. To use the prefix name as a folder, follow it with "/".

<?xml version="1.0" encoding="UTF-8"?>

          <!--****The command below must be on one line.****-->
<dscConfigFabrics xmlns="http://schemas.teradata.com/v2012/DSC" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
   xsi:schemaLocation="http://schemas.teradata.com/v2012/DSC DSC.xsd ">

<!-- 'fabric_name' Required, max characters 32, alphanumeric and "-","_", first character must be alphanumeric --> 
<fabric_name>fabric1</fabric_name>
	
<!-- 'system_name' Required, max characters 32, alphanumeric and "-","_", first character must be alphanumeric --> 
<system_name>sdlc1955MMP</system_name>
	
<!-- 'is_enabled' Optional, accepted values: true/false. Default: false -->
<is_enabled>true</is_enabled>

<tpa_to_ms>
   <!-- Name of TPA node -->
   <node_name>sdlc1955001-01</node_name>
   <!-- 'ms_info' Required, one or more --> 
   <ms_info>

     <!-- Required, max characters 32, alphanumeric plus "-","_", ".", first character can only be alphanumeric -->
     <media_server>sdld0351</media_server>

     <!-- list of 'ip_address' - Required (min: one) , Only supporting IPV4 and IPV6 standards. No DNS support. Do not use link-local IPv6 addresses (beginning with fe80) for media servers. -->
     <ip_address>10.25.34.237</ip_address>
   </ms_info>
</tpa_to_ms>
<tpa_to_ms>
   <node_name>sdlc1955001-02</node_name>
     <ms_info>
       <media_server>sdlc1955</media_server>
       <ip_address>153.64.24.236</ip_address>
     </ms_info>
</tpa_to_ms>
</dscConfigFabrics>