ib_acme(7)							      ib_acme								ib_acme(7)

NAME

       ib_acme - test and configuration utility for the IB ACM

SYNOPSIS

       ib_acme [-f addr_format] [-s src_addr] -d dest_addr [-v] [-c] [-P] [-S svc_addr] [-C repetitions]
       ib_acme [-A [addr_file]] [-O [opt_file]] [-D dest_dir] [-V]

DESCRIPTION

       ib_acme	provides assistance configuring and testing the ibacm service.	The first usage of the service will test that the ibacm is running
       and operating correctly.  The second usage model will automatically create address and configuration files for the ibacm service.

OPTIONS

       -f addr_format
	      Specifies the format of the src_addr and dest_addr parameters.  Valid address formats are: 'i' ip address, 'n' host name,  'l'  lid,
	      'g'  gid, and 'u' unspecified.  If the -f option is omitted, an unspecified address format is assumed.  ib_acme will use getaddrinfo
	      or other mechanisms to determine which format the address uses.

       -s src_addr
	      Specifies the local source address of the path to resolve.  The source address can be an IP address, system network name, or LID, as
	      indicated by the addr_format option.

       -d dest_addr
	      Specifies  the  destination  address  of the path to resolve.  The destination address can be an IP address, system network name, or
	      LID, as indicated by the addr_format option.

       -v     Indicates that the resolved path information should be verified with the active IB SA.  Use of the -v option provides a sanity check
	      that resolved path information is usable given the current cluster configuration.

       -c     Instructs the ACM service to only returned information that currently resides in its local cache.

       -P     Queries performance data from the destination service

       -S svc_addr
	      address of ACM service, default: local service

       -C repetitions
	      number of repetitions to perform resolution.  Used to measure performance of ACM cache lookups.  Defaults to 1.

       -A [addr_file]
	      With  this option, the ib_acme utility automatically generates the address configuration file ibacm_addr.cfg.  The generated file is
	      constructed using the system host name and any IP addresses that are assigned to IPoIB device instances.

       -O [opt_file]
	      With this option, the ib_acme utility automatically generates the option configuration file ibacm_opts.cfg.  The generated  file	is
	      currently generated using static information.

       -D dest_dir
	      Specify the destination directory for the output files.

       -V     Enables  verbose	output.   When	combined with -A or -O options, ib_acme will display additional details, such as generated address
	      information saved to the ibacm_addr.cfg file.

NOTES

       The ib_acme utility performs two main functions.  With the -A and -O options, it automatically generates address or  options  configuration
       files.	The generated files are text based and may be edited.  These options are intended to provide a simple way to configure address and
       option information on all nodes on a cluster.

       The other function of the ib_acme utility is to test the ibacm service, including helping to verify that the service is	usable	given  the
       current	cluster  configuration.   The ib_acme utility can resolve IP addresses, network names, or IB LIDs into a path record.  It can then
       compare that path record against one obtained by the SA.  When used to test the ibacm service, the ib_acme utility has the side	effect	of
       loading the ibacm caches.

       Multiple,  numerical destinations can be specified by adding brackets [] to the end of a base destination name or address.  Users may spec-
       ify a list of numerical ranges inside the brackets using the following example as a guide: node[1-3,5,7-8].  This will  result  in  testing
       node1, node2, node3, node5, node7, and node8.

SEE ALSO

       ibacm(7), ibacm(1)

ib_acme 							    2013-06-21								ib_acme(7)