<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <HTML> <HEAD> <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1"> <TITLE>Auto Install for Mandrakelinux</TITLE> <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.0 (Linux)"> <META NAME="AUTHOR" CONTENT="David Eastcott"> <META NAME="CREATED" CONTENT="20040221;10385500"> <META NAME="CHANGEDBY" CONTENT="David Eastcott"> <META NAME="CHANGED" CONTENT="20040502;8530300"> <META NAME="CLASSIFICATION" CONTENT="DrakX Auto Install Reference"> <META NAME="KEYWORDS" CONTENT="DrakX Autoinstall"> <STYLE> <!-- @page { size: 8.5in 11in; margin: 1in } P { margin-left: 0.5in; margin-bottom: 0.08in; page-break-before: auto } P.western { font-size: 10pt; font-weight: medium } P.text-body-indent-western { margin-left: 0.2in; font-size: 10pt; font-weight: medium } P.text-body-indent-cjk { margin-left: 0.2in } P.text-body-indent-ctl { margin-left: 0.2in } H1 { margin-bottom: 0.08in; page-break-before: always } H1.western { font-family: "Times" } H1.cjk { font-family: "Mincho"; font-size: 16pt } H1.ctl { font-family: "Lucidasans"; font-size: 16pt } H2 { margin-bottom: 0.08in; page-break-before: auto } H2.western { font-family: "Times"; font-style: normal } H2.cjk { font-family: "Mincho"; font-size: 14pt; font-style: italic } H2.ctl { font-size: 14pt; font-style: italic } H3 { margin-bottom: 0.08in; page-break-before: auto } H3.western { font-family: "Times" } H3.cjk { font-family: "Mincho" } H4 { margin-left: 0.5in; margin-bottom: 0.08in; page-break-before: auto } H4.western { font-family: "Times"; font-style: normal } H4.cjk { font-family: "Mincho"; font-size: 11pt; font-style: italic } H4.ctl { font-size: 11pt; font-style: italic } TD P { margin-left: 0.5in; margin-bottom: 0.08in; page-break-before: auto } TD P.western { font-size: 10pt; font-weight: medium } TH P { margin-left: 0.5in; margin-bottom: 0.08in; page-break-before: auto } TH P.western { font-size: 10pt; font-style: italic } TH P.cjk { font-style: italic } TH P.ctl { font-style: italic } P.headings-special-western { margin-top: 0.3in; margin-bottom: 0.1in; font-size: 10pt; font-weight: bold; page-break-after: avoid } P.headings-special-cjk { margin-top: 0.3in; margin-bottom: 0.1in; page-break-after: avoid } P.headings-special-ctl { margin-top: 0.3in; margin-bottom: 0.1in; page-break-after: avoid } P.closecode-western { margin-left: 1in; margin-bottom: 0in; font-family: "Courier", monospace; font-size: 9pt; font-weight: medium } P.closecode-cjk { margin-left: 1in; margin-bottom: 0in } P.closecode-ctl { margin-left: 1in; margin-bottom: 0in } P.coderef-western { margin-left: 1in; margin-bottom: 0.08in; font-family: "Courier", monospace; font-size: 10pt; font-weight: medium } P.coderef-cjk { margin-left: 1in; margin-bottom: 0.08in } P.coderef-ctl { margin-left: 1in; margin-bottom: 0.08in } --> </STYLE> </HEAD> <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF"> <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0"> <TR><TH COLSPAN="3" ALIGN="CENTER"> Auto Install for Mandrakelinux</TH></TR><TR> <TD WIDTH="10%" ALIGN="LEFT" VALIGN="BOTTOM"> <A HREF="section4-31.html">Prev</A></TD><TD WIDTH="80%" ALIGN="CENTER" VALIGN="BOTTOM"></TD> <TD WIDTH="10%" ALIGN="RIGHT" VALIGN="BOTTOM"> <A HREF="section4-33.html">Next</A></TD></TR></TABLE><HR ALIGN="LEFT" WIDTH="100%"> <H2 CLASS="western" STYLE="page-break-before: always"><A NAME="users"></A> users</H2> <P CLASS="western" STYLE="margin-bottom: 0.15in">This option is used to add users to the system.</P> <TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0> <COL WIDTH=256*> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western">'users' => [</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.2in">{</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'name' => 'tom',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'uid' => '5000',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'gid' => '5000',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'realname' => 'Tomas Wild',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'pw' => '$1$XHDtOdGw$kBibHl2otqOVEnBIumdgR/',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.2in"><FONT FACE="Times, serif">or</FONT></P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'password' => 'psbcr!',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'shell' => '/bin/bash',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'home' => '/home/tom',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'icon' => 'ic-bird',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.4in">'groups' => []</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western" STYLE="margin-left: 1.2in">}</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6ff"> <P CLASS="coderef-western">],</P> </TD> </TR> </TABLE> <P CLASS="headings-special-western">Descriptions:</P> <TABLE WIDTH=847 BORDER=0 CELLPADDING=0 CELLSPACING=0> <COL WIDTH=241> <COL WIDTH=606> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=65> <P CLASS="western"><FONT FACE="Courier, monospace">'name' </FONT> </P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">the log in user name (REQUIRED). DrakX adds an entry to the <FONT FACE="Courier, monospace">/etc/passwd</FONT> file using the value specified here, along with <FONT FACE="Courier, monospace">uid</FONT>, <FONT FACE="Courier, monospace">gid</FONT>, <FONT FACE="Courier, monospace">realname</FONT>, <FONT FACE="Courier, monospace">home</FONT> and <FONT FACE="Courier, monospace">shell</FONT>. See <FONT FACE="Courier, monospace">man passwd</FONT>.</P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=48> <P CLASS="western"><FONT FACE="Courier, monospace">'uid'</FONT></P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">user id number (optional, if omitted then the default begins at the value for <FONT FACE="Courier, monospace">USER</FONT> in the file <FONT FACE="Courier, monospace">/etc/defaults/useradd</FONT> and increments for each successive user). </P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=83> <P CLASS="western"><FONT FACE="Courier, monospace">'gid' </FONT> </P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">group ID number (optional, if omitted then the default begins at the value for <FONT FACE="Courier, monospace">GROUP</FONT><FONT FACE="Times, serif"> </FONT>in the file <FONT FACE="Courier, monospace">/etc/defaults/useradd</FONT> and increments for each successive user). DrakX updates the <FONT FACE="Courier, monospace">/etc/group</FONT> file with an entry containing a group name, the same as <FONT FACE="Courier, monospace">'name'</FONT> above, and the <FONT FACE="Courier, monospace">'gid'</FONT> specified here or automatically generated.</P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=30> <P CLASS="western"><FONT FACE="Courier, monospace">'realname'</FONT></P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">usually the user's full name, but can be anything you want. (optional, can be omitted)</P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=30> <P CLASS="western" STYLE="margin-left: 0in"><IMG SRC="AutoInstall-10.0.3_html_m199b468e.png" NAME="Graphic42" ALIGN=LEFT WIDTH=29 HEIGHT=28 BORDER=0><BR CLEAR=LEFT><BR> </P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in"><B>NOTE</B>: use either <FONT FACE="Courier, monospace">'pw'</FONT><FONT FACE="Times, serif"> o</FONT>r <FONT FACE="Courier, monospace">'password'</FONT> - but <B>NOT</B> both.</P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=48> <P CLASS="western"><FONT FACE="Courier, monospace">'pw'</FONT></P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">this is the encrypted form of the password. Its contents are dependent on the <A HREF="section4-2.html#authentication"><B><I>authentication</I></B></A> used. If using MD5 and Shadow, then copy it from <FONT FACE="Courier, monospace">/etc/shadow</FONT>.</P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=30> <P CLASS="western"><FONT FACE="Courier, monospace">'password'</FONT></P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">this is the clear text form of the password. Just what ever you want. </P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=119> <P CLASS="western"><FONT FACE="Courier, monospace">'shell'</FONT></P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">the path name and shell program to use when a user logs in. (Optional, defaults to <BR><FONT FACE="Courier, monospace">/bin/bash</FONT>) but may be one of:</P> <P CLASS="western" STYLE="margin-left: 0.4in; margin-bottom: 0in"><FONT FACE="Courier, monospace">/bin/bash</FONT></P> <P CLASS="western" STYLE="margin-left: 0.4in; margin-bottom: 0in"><FONT FACE="Courier, monospace">/bin/csh</FONT></P> <P CLASS="western" STYLE="margin-left: 0.4in; margin-bottom: 0in"><FONT FACE="Courier, monospace">/bin/sh</FONT></P> <P CLASS="western" STYLE="margin-left: 0.4in"><FONT FACE="Courier, monospace">/bin/ksh</FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=30> <P CLASS="western"><FONT FACE="Courier, monospace">'home'</FONT></P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">where the users home directory is. (Optional, defaults to <FONT FACE="Courier, monospace">/home/<name></FONT> ).</P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=48> <P CLASS="western"><FONT FACE="Courier, monospace">'icon'</FONT></P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">if present, is the filename (no extension) containing the desired icon. These icons are located in: <FONT FACE="Courier, monospace">/usr/share/mdk/faces</FONT><FONT FACE="Times, serif">.</FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD WIDTH=241 HEIGHT=101> <P CLASS="western"><FONT FACE="Courier, monospace">'groups' </FONT> </P> </TD> <TD WIDTH=606> <P CLASS="western" STYLE="margin-left: 0in">if present, is a list of supplemental groups that this user is to be added to. You may specify either numeric gid's or text group names. DrakX will automatically add the user to the groups listed and remove the user from any groups not listed. <B>NOTE</B>: the group name or gid listed must already exist in the <FONT FACE="Courier, monospace">/etc/group</FONT> file.</P> </TD> </TR> </TABLE> <P CLASS="western">DrakX's default for the text group name is to use the <FONT FACE="Courier, monospace">'name' </FONT>value. This option works OK if you do not want specific text names for the GID. However, if you do want specific text names, then add the users that you want and modify the <FONT FACE="Courier, monospace">/etc/group</FONT> file manually after the system is started. Alternately, you could use the <A HREF="section4-25.html#postInstall_and_postInstallNonRooted"><B><I><FONT FACE="Courier, monospace">'postInstall'</FONT></I></B></A> option to automate the fix up.</P> <P CLASS="headings-special-western">Examples:</P> <TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0> <COL WIDTH=256*> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western">'users' => [], means do not create any user accounts.</P> </TD> </TR> </TABLE> <P CLASS="western"><BR><BR> </P> <TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0> <COL WIDTH=256*> <TR> <TD WIDTH=100% VALIGN=TOP> <P CLASS="western">An example to illustrate the <FONT FACE="Courier, monospace">'groups'</FONT> feature:</P> </TD> </TR> </TABLE> <P CLASS="western"><BR><BR> </P> <TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0> <COL WIDTH=256*> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western">'users' => [</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.2in">{</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.4in">'name' => 'tom',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.4in">'uid' => '5000',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.4in">'gid' => '5000',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.4in">'realname' => 'Tomas Wild',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.4in">'pw' => '$1$XHDtOdGw$kBibHl2otqOVEnBIumdgR/',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.4in">'shell' => '/bin/bash',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.4in">'home' => '/home/tom',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.4in">'icon' => 'ic-fish',</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.4in">'groups' => [ 'disk', '80' ]</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.2in">}</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western">],</P> </TD> </TR> </TABLE> <P CLASS="western" STYLE="margin-top: 0.15in; margin-bottom: 0.15in">A simple example to add new groups (no user) and then add a user to the new groups, change and existing group name to a different name:</P> <TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0> <COL WIDTH=256*> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western" STYLE="margin-left: 1.2in">'postInstall' => "</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western"># add some groups</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western">groupadd -g 4001 g_special</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western">groupadd -g 4002 g_new_special</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western">usermod -G special,new_special,disk,80 tom</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western">groupmod -n g_david david</P> </TD> </TR> <TR> <TD WIDTH=100% VALIGN=TOP BGCOLOR="#e6e6e6"> <P CLASS="closecode-western">"</P> </TD> </TR> </TABLE> <P CLASS="headings-special-western">Related Option Entries:</P> <P CLASS="western"><A HREF="section4-2.html#authentication"><B><I>authentication</I></B></A>, <A HREF="section4-4.html#autologin"><B><I>autologin</I></B></A>, <A HREF="#superuser"><B><I>superuser</I></B></A>, <A HREF="section4-25.html#postInstall_and_postInstallNonRooted"><B><I>postInstall</I></B></A></P> <P CLASS="western"><BR><BR> </P> <HR ALIGN="LEFT" WIDTH="100%"> <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0"> <TR><TD WIDTH="33%" ALIGN="LEFT" VALIGN="TOP"><A HREF="section4-31.html">Prev</A></TD><TD WIDTH="34%" ALIGN="CENTER" VALIGN="TOP"><A HREF="index.html">Home</A></TD> <TD WIDTH="33%" ALIGN="RIGHT" VALIGN="TOP"><A HREF="section4-33.html">Next</A></TD></TR> <TR><TD WIDTH="33%" ALIGN="LEFT" VALIGN="TOP">timezone</TD> <TD WIDTH="34%" ALIGN="CENTER" VALIGN="TOP"> </TD> <TD WIDTH="33%" ALIGN="RIGHT" VALIGN="TOP">useSupermount</TD></TR></TABLE> </BODY> </HTML>