lustre/doc/lustre_routes_conversion.8

   1 .TH lustre_routes_conversion 8 "Apr 23, 2013" Lustre "utilities"
   2 .SH NAME
   3 lustre_routes_conversion \- converts a legacy routes configuration file to
   4 the new syntax.
   5 .SH SYNOPSIS
   6 .B "lustre_routes_conversion"
   7 .SH DESCRIPTION
   8 lustre_route_conversion takes as a first parameter a file with routes
   9 configured as follows:
  10 .LP
  11 <network> [<hop>] <gateway>@<exit network>[:<priority>];
  12 .LP
  13 Then converts it to:
  14 .LP
  15 <network>: { gateway: <gateway>@<exit network> [hop: <hop>]
  16              [priority: <prioirty>] }
  17 .LP
  18 and appends it to the output file passed in as the second parameter to
  19 the script.
  20 .LP
  21 Usage:
  22 .br
  23 lustre_routes_conversion <legacy file> <new file>
  24 .SH EXAMPLE
  25 An example of legacy configuration file:
  26 .LP
  27 tcp1 10.1.1.2@tcp0:1;
  28 .br
  29 tcp1 1 10.1.1.2@tcp0;
  30 .LP
  31
  32 An example of script output:
  33 .LP
  34 tcp1: {gateway: 10.1.1.2@tcp0 priority: 1}
  35 .br
  36 tcp1: {gateway: 10.1.1.2@tcp0 hop: 1}
  37 .LP
  38 An example of script execution:
  39 .LP
  40 lustre_routes_conversion <path/to/legacy_config_file> <path/to/new_config_file>
  41 .SH SEE ALSO
  42 .BR lustre (7)
  43 .BR nids (5)
  44 .BR lctl (8)
  45 .BR lustre_routes_config (8)
  46 .SH AUTHOR
  47 Amir Shehata