sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

File Formats | nma.properties(4)

- NAME
- SYNOPSIS
- DESCRIPTION
- NMA Properties
- RFC 2573 Properties
- Java DMK and JMX Properties
- ATTRIBUTES
- SEE ALSO

## NAME

> nma.properties - Node Management Agent (NMA) configuration file.

## SYNOPSIS

> `/etc/opt/SUNWcgha/nma.properties`

## DESCRIPTION

> The `` file .

> The `installDir/etc/opt/SUNWcgha/nma.properties` file defines the communication, implementation, and accessibility configuration of the NMA. By default this file is located at `/etc/opt/SUNWcgha/nma.properties`. Replace installDir with the root installation directory if the root installation directory is not `/`.

> The `nma.properties` file contains configuration options for the NMA, RFC 2573, and Java Dynamic Management Kit (Java DMK) and Java Managemetn eXtensions (JMX).

> This file is in ASCII format. Comment lines begin with the comment mark (#). Properties consist of a keyword followed by an equals (=) sign followed by the parameter value, of the form:

> >     Keyword=Value

## NMA Properties

> The following properties enable you to configure the NMA.

> `com.sun.nhas.ma.adaptors.html.enabled`

>   Enable the HTML adaptor. Options are `true` or `false`. By default, the value is `true`. For example:

>   >     com.sun.nhas.ma.adaptors.html.enabled=true

> `com.sun.nhas.ma.adaptors.html.port`

>   Define the HTML adaptor port. By default, the port is `8082`. For example:

>   >     com.sun.nhas.ma.adaptors.html.port=8082

> `com.sun.nhas.ma.adaptors.snmp.enabled`

>   Enable the SNMP adaptor. Options are `true` or `false`. By default, the value is `true`. For example:

>   >     com.sun.nhas.ma.adaptors.snmp.enabled=true

> `com.sun.nhas.ma.adaptors.snmp.port`

>   Define the SNMP adaptor port number. By default, this value is `8085`. For example:

>   >     com.sun.nhas.ma.adaptors.snmp.port=8085

> `com.sun.nhas.ma.adaptors.snmp.trap.port`

>   Define the UDP port to which the SNMP agent sends traps if the `adaptors.snmp.rfc2573.enabled` property is set to `false`. By deault, the value is `8086`. For example:

>   >     com.sun.nhas.ma.adaptors.snmp.trap.port=8086

> `com.sun.nhas.ma.connectors.rmi.enabled`

>   Enable the RMI connector. Options are `true` or `false`. By default, the value is `true`. For example:

>   >     com.sun.nhas.ma.connectors.rmi.enabled=true

> `com.sun.nhas.ma.connectors.rmi.port`

>   Define the RMI connector port. By default, the port is `1098`. For example:

>   >     com.sun.nhas.ma.connectors.rmi.port=8082

> `com.sun.nhas.ma.connectors.http.enabled`

>   Enable the HTTP connector. Options are `true` or `false`. By default, the value is `true`. For example:

>   >     com.sun.nhas.ma.connectors.http.enabled=true

> `com.sun.nhas.ma.connectors.http.port`

>   Define the HTTP connector port. By default, the port is `8081`. For example:

>   >     com.sun.nhas.ma.connectors.http.port=8081

> `com.sun.nhas.ma.connectors.http.client`

>   Define the maximum number of HTTP connector clients. By default, the value is `9999`. For example:

>   >     com.sun.nhas.ma.connectors.http.client=9999

> `com.sun.nhas.ma.nhas.configuration.path`

>   Define the path to the `nhfs.conf` file. By default, the path is `/etc/opt/SUNWcgha/nhfs.conf`. For example:

>   >     com.sun.nhas.ma.nhas.configuration.path=/etc/opt/SUNWcgha/nhfs.conf

> `com.sun.nhas.ma.cgtp.polling`

>   Define the period of CGTP information refresh, expressed in milliseconds. By default, the value is `20000`. The minimum value is `5000`. Set this property to `-1` to disable polling. For example:

>   >     com.sun.nhas.ma.cgtp.polling=20000

> `com.sun.nhas.ma.pmd.polling`

>   Define the period of Daemon Monitor information refresh, expressed in milliseconds. Set to `-1` to disable polling. By default, the value is `20000`. For example:

>   >     com.sun.nhas.ma.pmd.polling=20000

> `com.sun.nhas.ma.pmd.cache.validity`

>   Define the time for which cached Daemon Monitor data is valid, expressed in milliseconds. Set to `-1` to disable the use of the cache. By default the value is `2000`. For example:

>   >     com.sun.nhas.ma.pmd.cache.validity=2000

> `com.sun.nhas.ma.operation.flag`

>   Enable the access to the MBeans operations provided by the NMA. Options are `true` or `false`. By default, the value is `true`. For example:

>   >     com.sun.nhas.ma.operation.flag=true

> `com.sun.nhas.ma.cascading.enabled`

>   Enable cascading. Options are `true` or `false`. To disable cascading, By default, this property is disabled and cascading is enabled. To disable cascading, uncomment this property. For example:

>   >     com.sun.nhas.ma.cascading.enabled=false

> `com.sun.nhas.ma.cascading.retries.max`

>   Define the maximum number of retries to be made before aborting the attempt to activate a cascading agent. By default, the value is `50`. For example:

>   >     com.sun.nhas.ma.cascading.retries.max=50

> `com.sun.nhas.ma.cascading.retries.delay`

>   Define the delay period between each retry of the attempted activation of a cascading agent, expressed in milliseconds. By default, the value is `2000`. For example:

>   >     com.sun.nhas.ma.cascading.retries.delay=2000

> `com.sun.nhas.ma.cascading.comm.protocol`

>   Define the communication protocol to be used when cascading to sub-agents. By default, the value is `rmi`. For example:

>   >     com.sun.nhas.ma.cascading.comm.protocol=rmi

> `java.rmi.server.hostname`

>   When using RMI to connect to the agent, set this property to the hostname or IP address that the manager uses to communicate to the agent. RMI is normally reserved for cascading, and the default value is the CGTP address of the node. Note that changing this property may affect cascading. By default, this property is disabled and there is no default value. Uncomment this line and provide an IP address to set this property. For example:

>   >     java.rmi.server.hostname=10.250.1.10

## RFC 2573 Properties

> The following properties control the NMA implementation of Internet Engineering Task Force (IETF) RFC 2573. Details of RFC 2573 are accessible at `http://www.ietf.org/rfc/rfc2573.txt`

> `adaptors.snmp.rfc2573.enabled`

>   Enable `RFC2573` support. Options are `true` or `false`. By default, the value is `true`. For example:

>   >     adaptors.snmp.rfc2573.enabled=true

> `adaptors.snmp.rfc2573.v1v2set.enabled`

>   Enable SNMPv1 or SNMPv3 requests to be made to the MIB. Options are `true` or `false`. By default, the value is `false`. For example:

>   >     adaptors.snmp.rfc2573.v1v2set.enabled=false

> `adaptors.snmp.rfc2573.target.addr.file`

>   Define the path to the `nma.targets.txt` file. By default, the value is `/etc/opt/SUNWcgha/nma.targets.txt`. For example:

>   >     adaptors.snmp.rfc2573.target.addr.file=/etc/opt/SUNWcgha/nma.targets.txt

>   See `nma.targets.txt`(4) for more information.

> `adaptors.snmp.rfc2573.target.params.file`

>   Define the location of the `nma.params.txt` file. By default, the value is `/etc/opt/SUNWcgha/nma.params.txt`.

>   See `nma.params.txt`(4) for more information.

> `adaptors.snmp.rfc2573.notification.file`

>   Define the location of the `nma.notifs.txt` file. By default, the value is `/etc/opt/SUNWcgha/nma.notifs.txt`. For example:

>   >     adaptors.snmp.rfc2573.notification.file=/etc/opt/SUNWcgha/nma.notifs.txt

>   See `nma.notifs.txt`(4) for more information.

## Java DMK and JMX Properties

> The following properties define the Java DMK and JMX configuration file locations.

> `jdmk.security.file`

>   Define the location of the file that defines the SNMPv3 security parameters. This path is local to each node. By default, the value is `/etc/opt/SUNWcgha/nma.security`. For example:

>   >     jdmk.security.file=/etc/opt/SUNWcgha/nma.security

>   See `nma.security`(4) for more information.

> `jdmk.uacl.file`

>   Define a specific user-based ACL file for SNMPv3 requests. A template is available at `/etc/opt/SUNWcgha/nma.uacl.template`. By default, this property is disabled. To define a user-based ACL file, uncomment this property and provide the path to the file. For example:

>   >     jdmk.uacl.file=/etc/opt/SUNWcgha/nma.uacl

> `jdmk.acl.file`

>   Define a specific ACL file for trap destination and access control configuration. A template is available at `/etc/opt/SUNWcgha/nma.acl.template`. By default, this property is disabled. To define an ACL file, uncomment this property and provide the path to the file. For example:

>   >     jdmk.acl.file=/etc/opt/SUNWcgha/nma.acl

> `jmx.serial.form`

>   Enable compatibility with clients using JMX 1.0 serialization. This property is required when using an agent or client based on Java DMK versions older than 5.0. By default, this property is disabled. To enable compatibility, uncomment this property and proviude a serial number. For example:

>   >     jmx.serial.form=1.0

## ATTRIBUTES

> See `attributes`(5) for descriptions of the following attributes:

> ATTRIBUTE TYPE | ATTRIBUTE VALUE
> --- | ---
> Architecture | SPARC
> Availability | SUNWnhmas
> Interface Stability | Evolving

## SEE ALSO

> `nma`(1M), `nma.notifs.txt`(4), `nma.params.txt`(4), `nma.security`(4), `nma.targets.txt`(4)

Netra HAS FS 2.1 | Go To Top | Last Changed September 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.