admhostmod(1M)

NAME
admhostmod - modifies an existing host entry

SYNOPSIS

admhostmod [-e ethernet_addr] [-f]
[-x type=host_type] [-x tz=timezone]
[-x term=type] [-x fileserv=file_server]
[-x root=directory] [-x swap=swap_file]
[-x swapsize=size] [-x disconn=Y|N]
[-x diskconf=configuration] [-x pw=Y]
[-x passwd=root_password] [-x install=Y|N]
[-x installpath=host:/path]
[-x bootpath=server:/path] [-x profile=server:/path]
[-x os=version] [-x mediapath=host:/path]
[-x platform=platform] [-x rmplatform=platform]
[-x cluster=cluster] [-x locale=locale_list]
[-x premod=script] [-x postmod=script]
[-x predisk=script] [-x postdisk=script]
[-x ns=NIS+|NIS|NONE] [-x domain=domain|rhost=host]
host

DESCRIPTION
The Solstice admhostmod command modifies an existing host entry in the system databases. The admhostmod command can also be used to add or remove OS services to/from a server. You can use this command with the -x type=client.type option to convert a system from one type of system to another. You can use this command with the -x platform=platform, -x rmplatform=platform, -x cluster=cluster, and -x mediapath=mediapath options.

AVAILABILITY

SUNWsacb package.

OPTIONS

-e ethernet_addr
    The Ethernet address.

-f
    Forces a conversion. This prevents admhostmod from prompting for confirmation before converting the host.

-x  Indicates that extended, nonstandard options follow.

    type=host_type
        The new type of the host. Specifying a type causes the host to be converted to the new type. Values are:
        STANDALONE
            If "type=" is not specified, STANDALONE is the default.

        DISKLESS
            Diskless host.

        DATALESS
            Dataless host.

        AUTOCLIENT
            AutoClient host.

        JAVASTATION
            JavaStation host.

        OS_SERVER
            Operating system software server for diskless or Autoclient hosts.

        GENERIC
            For systems you just want to add to the configuration tables to enable network access, but you don't intend to manage.

    tz=timezone
        The timezone is the path of a timezone file, relative to /usr/share/lib/zoneinfo. The default is US/Pacific.

    term=type
        The terminal type of the client console. The default is sun. This option applies only to SunOS 4.x diskless clients.

    fileserv=file_server
        The name of the server on which the file systems will reside. Used only for dataless, diskless, and AutoClient clients.

    root=directory
        The location of the root directory for diskless and AutoClient clients.

    swap=swap_file
        The location of the swap file for diskless clients.

    swapsize=size
        The size, in megabytes, of the swap file for diskless clients.

    disconn=Y|N
        Enables or disables disconnected operation for the client's CacheFS mounts. The option only applies when modifying the system type to be AUTOCLIENT and the client is running Solaris 2.5 or later. When this feature is enabled, the client can run using the cache when the server is unavailable.

    diskconf=configuration
        Specifies the Autoclient's disk configuration. The value for configuration is usually 1disk, 2disks, local200 or local400. The option is only valid when the type is AUTOCLIENT.

    pw=Y
        Prompt for the system's root password. This option is only valid when converting the system to a diskless client or AutoClient.

    passwd=root_password
        Specify the system's root password. This option is only valid when converting the system to a diskless client or AutoClient.

    install=Y|N
        Enables or disables remote install.

    installpath=host:/path
        The name of the install server and the path on that server to the install media.

    bootpath=server:/path
        The name of the boot server and the path on that server to the install root.

    profile=server:/path
        The name of the profile server and the path on that server to the JumpStart profile directory.

    os=version
        Specifies the operating system version for remote installs, diskless, dataless, and AutoClient clients. The version is specified using the format instruction_set.implementation.Solaris_version. In this syntax:

        instruction_set
            is one of sparc, i386, or ppc.

        implementation
            is the implementation architecture. Examples include i86pc, sun4m and prep.

        version is the Solaris 2 version number.

        For example, the following is a sample os version entry: sparc.sun4d.Solaris_2.5.

    mediapath=host:/path
        The name of a server and the path on that server to the media to be used to add a service. host is the hostname of the host being modified. This option is only used when adding a service to a system of type OS_SERVER. The default value is host:/cdrom/cdrom0/s0.

    platform=platform
        The name of a platform service to be added from the mediapath. This option is only used when adding a service to a system of type OS_SERVER. platform is specified using the same format as the os option. For example, sparc.sun4d.Solaris_2.5.

        Note: This option can not be used with the rmplatform option.

    rmplatform=platform
        The name of a platform service to be removed. This option is only used when removing a service from a system of type OS_SERVER. rmplatform is specified using the same format as the os option with the exception that the 2nd field (implementation) must be all. For example, sparc.all.Solaris_2.5.

        Note: This option can not be used with the platform option.

    cluster=cluster
        The name of the cluster to use when adding a platform service through the platform option. This option is used only when adding a service to a system of type OS_SERVER. The default value is SUNWCall, which uses the entire software distribution. Valid values are:
        SUNWCall - entire distribution (default)
        SUNWCXall - entire distribution plus OEM support
            (available only for SPARC services)
        SUNWCprog - developers system support
        SUNWCuser - end user system support
        SUNWCreq - core Solaris

    locale=locale_list
        A list of locales to use when adding a platform service using the platform option. This option is used only when adding a service to a system of type OS_SERVER. The format of locale_list is a comma-separated list of locale names. For example, it,de,sv. This would add the Italian, German, and Swedish locales when adding the service. The default is to add no locales.

    premod=script
        Specifies the name of a script in the /opt/SUNWadmd/Scripts directory which will be run on the AutoClient server before the modification is performed. The script has to be executable. The option is only valid if the modification involves an AutoClient. See admenviron(5) for a description of the script environment.

    postmod=script
        Specifies the name of a script in the /opt/SUNWadmd/Scripts directory which will be run on the AutoClient server after the modification is performed. The script has to be executable. The option is only valid if the modification involves an AutoClient. See admenviron(5) for a description of the script environment.

    predisk=script
        Specifies the name of a script in the /opt/SUNWadmd/Scripts directory which will be run on the AutoClient during its next boot, before the cache is configured. It is run only once. The option is only valid when the modification results in an AutoClient. See admenviron(5) for a description of the script environment.

    postdisk=script
        Specifies the name of a script in the /opt/SUNWadmd/Scripts directory which will be run on the AutoClient during its next boot, after the cache is configured. It is run only once. The option is only valid when the modification results in an AutoClient. See admenviron(5) for a description of the script environment.

    ns=NIS+|NIS|NONE
        Sets name service. The default is to use the name service configured on the host on which the command is run. The precedence is NIS+, NIS, then NONE.
        NIS+
            Updates the NIS+ host configuration tables for the current domain.

        NIS Updates the NIS host configuration tables for the current domain.

        NONE
            Updates the local host configuration files.

    domain=domain|rhost=host
        Specifies domain or remote host. The domain can be specified when the value for the ns parameter is NIS+ or NIS. The domain defaults to the current systems domain. The rhost can be specified when the value for the ns parameter is NONE. The rhost defaults to the current system. The rhost parameter can be used to perform the operation on the specified host. The host specified as an argument to rhost must be running AdminSuite 2.1 or later for the command to complete successfully.

host
    The existing host entry to modify.

ENVIRONMENT

See environ(5) for descriptions of the following environment variables that affect the execution of admhostmod: LANG, LC_ALL, LC_CTYPE, and LC_MESSAGES.

ERRORS

The admhostmod command exits with one of the following values:

0   Success.

1   Invalid command syntax. A usage message for the admhostmod command is displayed.

2   An error occurred while executing the command. An exception code and error message are displayed.

RESTRICTIONS
You must be a member of UNIX group 14, the sysadmin group, to execute this command. Also, if ns=NIS+, you must be a member of the NIS+ admin group (See nisgrpadm(1)). Interrupt signal handling is disabled while modifying the host to insure that the system is in a consistent state. Dataless clients are not supported with operating systems greater than Solaris 2.5.1; if you try to add a dataless client serviced by an OS server running an operating system greater than Solaris 2.5.1, you will receive an error message.

EXAMPLES
The following command converts an existing standalone system to an OS server. admhostmod -x type=OS_SERVER osserver The following command adds OS services for sparc sun4c clients to the new OS server named osserver.The mediapath specifies the source of a Solaris CD image. In this case that image is on the disk (in /export/install/Solaris_2.5) of a system or host named inst. admhostmod -x mediapath=inst:/export/install/Solaris_2.5 -x cluster=SUNWCreq -x platform=sparc.sun4c.Solaris_2.5 osserver The following command removes the sunos 4.1.1 sun4 OS service from the OS Server named osserver. admhostmod -x rmplatform=sun4.all.sunos_4.1.1 osserver The following command modifies the ethernet address of the AutoClient ac. After the modification the script /opt/SUNWadmd/Scripts/ethrmod will be run. The script /opt/SUNWadmd/Scripts/customize_ac is executed when the AutoClient boots. admhostmod -e 8:0:20:34:56:78 -x postmod=ethrmod -x postdisk=customize_ac ac

FILES
/etc/inet/hosts
/etc/ethers
/etc/timezone
/etc/bootparams

SEE ALSO
admhostadd(1M), admhostdel(1M), admhostls(1M), admenviron(5)