<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub CX solbook(>
<refentry id="create-file-user-1">
<!-- @(#)create-file-user.1 1.10 07/04/25 SMI; -->
<refmeta><refentrytitle>create-file-user</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">30 Jan 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>create-file-user</primary></indexterm>
<indexterm><primary>creates a new file user</primary></indexterm>
<refname>create-file-user</refname><refpurpose>creates a new file user</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-file-user </command>&synopsis-common; [<option
role="double-dash">target</option> <replaceable>target</replaceable>]
 [<option role="double-dash">passwordfile</option><replaceable> passwordfile</replaceable>] [<option
role="double-dash">authrealmname</option><replaceable> auth_realm_name</replaceable>]
 [<option role="double-dash">groups</option> <replaceable>user_groups[:</replaceable><replaceable>
user_groups]</replaceable>*]
 <replaceable>user_name</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>Creates an entry in the keyfile with the specified username, password,
and groups. Multiple groups can be created by separating them with a colon
(:). If <replaceable>auth_realm_name</replaceable> is not specified, an entry
is created in the keyfile for the default realm. If <replaceable>auth_realm_name</replaceable> is
specified, an entry is created in the keyfile using the <classname>auth_realm_name
</classname>.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para>This option helps specify the target on which you are creating
the file user. Valid values are: </para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as the target for creating the file user. <literal>server</literal> is
the name of the default server instance and is the default value for this
option.</para></listitem>
<listitem><para><replaceable>configuration_name</replaceable>&hyphen; Specifies
a particular configuration as the target for creating the file user. </para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
a particular cluster as the target  for creating the file user. </para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>&hyphen; Specifies
a particular instance as the target  for creating the file user. </para><?Pub
Caret1></listitem>
</itemizedlist>
<para>&se-ee-only;</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">groups</option></term>
<listitem><para>This is the group associated with this file user.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">authrealmname</option></term>
<listitem><para>This is the file where the file users are stored.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>user_name</replaceable></term>
<listitem><para>This is the name of file user to be created.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>Using the create-file-user command</title>
<para>It is assumed that an authentication realm has already been created
using the <command>create-auth-realm</command> command.</para>
<screen>asadmin> <userinput>create-file-user --user admin --passwordfile passwords.txt
--host pigeon --port 5001 --groups staff:manager 
--authrealmname auth-realm1 sample_user</userinput>
Command create-file-user executed successfully</screen>
<para>Where, the <filename>sample_user</filename> is the file user created.</para>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="medium">
<varlistentry><term>0</term>
<listitem><para>command executed successfully</para>
</listitem>
</varlistentry>
<varlistentry><term>1</term>
<listitem><para>error in executing the command</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetdoc="asrefman" targetptr="create-auth-realm-1">create-auth-realm(1)
</olink>, <olink targetdoc="asrefman" targetptr="delete-file-user-1">delete-file-user(1)
</olink>, <olink targetdoc="asrefman" targetptr="list-file-users-1">list-file-users(1)
</olink>, <olink targetdoc="asrefman" targetptr="update-file-user-1">update-file-user(1)
</olink>, <olink targetdoc="asrefman" targetptr="list-file-groups-1">list-file-groups(1)
</olink></para>
</refsect1>
</refentry>
<?Pub *0000005110 0>
