| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|---|
| 2 | <html>
|
|---|
| 3 | <head>
|
|---|
| 4 | <title>Ant Installer</title>
|
|---|
| 5 | <link href="style.css" type="text/css" rel="stylesheet">
|
|---|
| 6 | <link href="css/nav.css" rel="stylesheet" type="text/css">
|
|---|
| 7 | <link rel="SHORTCUT ICON" type="image/png" href="images/antinstaller-icon.png">
|
|---|
| 8 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|---|
| 9 | <meta name="keywords"
|
|---|
| 10 | content="Ant, installer, AntInstall, gui, console, input, parameters, properties, swing, user interface, validation, configuration">
|
|---|
| 11 | <script type="text/javascript" src="js/menu.js"></script>
|
|---|
| 12 | <script type="text/javascript" src="js/sstree.js"></script>
|
|---|
| 13 | <script type="text/javascript" src="js/winfix.js"></script>
|
|---|
| 14 | </head>
|
|---|
| 15 | <body onload="collapseAll('contents-panel', ['ol']); "><div id="tpallcontent">
|
|---|
| 16 | <table cellspacing="0" width="100%">
|
|---|
| 17 | <tbody>
|
|---|
| 18 | <tr class="tpheader">
|
|---|
| 19 | <th class="tpleft">
|
|---|
| 20 | <a target="_top" href="index.html" title="home"><img src="images/ant-install-small.png" alt="AntInstaller" id="logo" width="76" height="50"/></a>
|
|---|
| 21 | <script type="text/javascript">winFix();</script>
|
|---|
| 22 | </th>
|
|---|
| 23 | <th class="tptop" valign="bottom">
|
|---|
| 24 | <img src="space.gif" height="1" width="440" alt="spacer"/><br/>
|
|---|
| 25 |
|
|---|
| 26 | <table>
|
|---|
| 27 | <tr>
|
|---|
| 28 | <td valign="top">
|
|---|
| 29 | <div class="tpheadertitle">AntInstaller</div>
|
|---|
| 30 | <!--img src="images/ant-install-title.png" alt="AntInstaller"/-->
|
|---|
| 31 | </td>
|
|---|
| 32 | <td width="100%" align="right" valign="bottom" nowrap="NOWRAP">
|
|---|
| 33 | <div class="tpraised">
|
|---|
| 34 | <a class="tpbutton" target="_top" href="index.html">home</a>
|
|---|
| 35 | <a class="tpbutton" target="_top" href="http://sourceforge.net/project/showfiles.php?group_id=123466&package_id=134917">download</a>
|
|---|
| 36 | <a class="tpbutton" target="_top" href="http://sf.net">sourceforge</a>
|
|---|
| 37 | <a class="tpbutton" target="_top" href="manual-ant.html">antmanual</a>
|
|---|
| 38 | <a class="tpbutton" target="_top" href="http://sourceforge.net/tracker/?group_id=123466&atid=696615">RFEs</a>
|
|---|
| 39 | <a class="tpbutton" target="_top" href="http://sourceforge.net/tracker/?group_id=123466&atid=696612">Bugs</a></div>
|
|---|
| 40 | </td>
|
|---|
| 41 | </tr>
|
|---|
| 42 | </table>
|
|---|
| 43 | </th>
|
|---|
| 44 | </tr>
|
|---|
| 45 | <tr class="tpbody">
|
|---|
| 46 | <td class="tpleft" valign="bottom">
|
|---|
| 47 | <br/>
|
|---|
| 48 | <div id="logoset">
|
|---|
| 49 | <a target="_top" href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=123466&type=2" alt="SourceForge.net Logo" border="0" height="37" width="125"></a>
|
|---|
| 50 | <br/><br/>
|
|---|
| 51 | <a target="_top" href="http://sourceforge.net/donate/index.php?group_id=123466">
|
|---|
| 52 | <img src="http://sourceforge.net/images/project-support.jpg" alt="donate to AntInstaller"/>
|
|---|
| 53 | </a>
|
|---|
| 54 | </div>
|
|---|
| 55 | </td>
|
|---|
| 56 | <td class="tpright" valign="top">
|
|---|
| 57 | <div class="tpcontent">
|
|---|
| 58 | <!--[segment-content] page content start -->
|
|---|
| 59 | <h2>Automated installations</h2>
|
|---|
| 60 |
|
|---|
| 61 | <i>``The great thing about text-auto is it gives you completely silent builds just like Ant. The downside to text-auto is that it gives you completely silent builds just like Ant.''</i><br/>
|
|---|
| 62 | <div align="right">
|
|---|
| 63 | -- Paul Hinds<br>
|
|---|
| 64 | Ant Installer Group
|
|---|
| 65 | </div><br/>
|
|---|
| 66 |
|
|---|
| 67 | Welcome to Automated installations, how to take the user interaction out of your user interactive installs!<br/><br/>
|
|---|
| 68 |
|
|---|
| 69 |
|
|---|
| 70 | A much requested feature is automated installations. Generally it is expected that programs would be delivered with AntInstaller specifically to be able to configure the installations manually, however it is useful to be able to reinstall in a particular environment without having to manually re-enter the properties. The defaults in the <code>antinstall-config.xml</code> file may not be the correct defaults for the specific environment on which the installation is performed. <br/><br/>
|
|---|
| 71 |
|
|---|
| 72 | Be carefull if delivering installers that can be fully automated to third parties, you should fully understand the consequences of the options before using this feature. That said, this feature can prevent making human errors with repeated installations in a controlled environment such as reinstalling software on a series of servers. It is generally safest to use the prompt options when delivering to third parties. <br/><br/>
|
|---|
| 73 |
|
|---|
| 74 | To handle these use cases an additional attribute has been added to the installer element and two new UI overrides have been added. <br/><br/>
|
|---|
| 75 |
|
|---|
| 76 | The loadDefaults attribute of the installer element can be set to <i>true</i>, <i>false</i>, <i>prompt</i> or <i>prompt-auto</i>.
|
|---|
| 77 | <ul>
|
|---|
| 78 |
|
|---|
| 79 | <li>When loadDefaults is <i>true</i> the current directory is searched for <code>ant.install.properties</code> and, if found, it is used to reset the default values for all properties and targets. </li>
|
|---|
| 80 | <li>When loadDefaults is <i>prompt</i> the user is prompted if the file is found and has the option to load the properties or not. Automatic installs without loaded properties sets are not permitted with this option.</li>
|
|---|
| 81 | <li>The <i>prompt-auto</i> loadDefaults option is not expected to be used often. It caters for the situation when it is required that the installer can be run with out any user interaction using only the default values provided in <code>antinstall-config.xml</code> or run with configured properties. If existing properties are found they can be loaded, but if not loaded and either <i>text-auto</i> or <i>swing-auto</i> is selected on the command line the installer will run with no user defined properties.</li>
|
|---|
| 82 | <li>When loadDefaults is <i>false</i> the current directory is not checked for exiszting properties files.</li>
|
|---|
| 83 | </ul>
|
|---|
| 84 |
|
|---|
| 85 | When the installer is run <code>ant.install.properties</code> is written to the current directory, if the current directory is not writable no warning message is given since repeatable installs are not always required. <br/><br/>
|
|---|
| 86 |
|
|---|
| 87 | Two additional UI overrides have been added <i>swing-auto</i> and <i>text-auto</i> which can be specified as the first parameter on the command line. <i>swing-auto</i> loads the swing GUI and skips directly to the progress page with all default values set. <i>text-auto</i> runs the installer with default values with no questions asked except, potentially, the loadDefaults prompt. To enable these UI overrides the ui attribute of the installer element must be set in <code>antinstall-config.xml</code>. <br/>
|
|---|
| 88 | for example
|
|---|
| 89 | <pre>
|
|---|
| 90 | <installer
|
|---|
| 91 | ui="swing,text,swing-auto"
|
|---|
| 92 | ...
|
|---|
| 93 | </pre>
|
|---|
| 94 | Be careful if setting loadDefaults to <i>true</i>, if <i>text-auto</i> is enabled, selected by the user on the command line and the <code>ant.install.properties</code> file is missing or out of date, an incorrect install will be performed with no oportunity to prevent it. This is permitted because it may be requried to run the installer with no prompts using the default values specifed in the <code>antinstall-config.xml</code> file. Completely silent, repeatable, installs on the command line are possible with this option.<br/><br/>
|
|---|
| 95 |
|
|---|
| 96 | The "automated installations" feature is not compatible with <a href="installtypes.html" title="multiple install types">multiple install types</a> without care. If a specific -type is used when repeating the install the same -type should be specified, antinstaller does not currently check this. <br/><br/>
|
|---|
| 97 |
|
|---|
| 98 | <h2>Version control</h2>
|
|---|
| 99 | Version control is provided by setting the version attribute of the installer element of <code>antinstall-config.xml</code>. Increment the major version to indicate that old properties files are no longer valid. Increment the minor version to indicate that old properties are valid but some additional manual entering of properties is required. -auto builds are only permitted if the major and minor versions match.
|
|---|
| 100 |
|
|---|
| 101 | The version numbers support the following syntax. <code>1.4.2</code> where 1 is the major version and 4 then 2 are minor versions. For each major or minor version the strings <code>alpha</code>, <code>beta</code> and <code>gamma</code> can be appended with or with out a <code>-</code> (as required by java) to indicate the state of the code. No additional string is considered to be the best version. <code>1.4.2 > 1.4 > 1.4beta.2 == 1.4-beta.2</code>
|
|---|
| 102 |
|
|---|
| 103 | <h2>Simple use cases</h2>
|
|---|
| 104 | To help explain the options provided some simple use cases are described here.<br/><br/>
|
|---|
| 105 |
|
|---|
| 106 | To enable end users to reload the values they used in a previous install set <code>ui="swing,text"</code> and set <code>loadDefaults="prompt"</code>.<br/><br/>
|
|---|
| 107 |
|
|---|
| 108 | To enable end users to reload the values they used in a previous install and not have to click through the pages set <code>ui="swing,text,swing-auto,text-auto"</code> and set <code>loadDefaults="prompt"</code>.<br/><br/>
|
|---|
| 109 |
|
|---|
| 110 | To run repeatable silent server installations set <code>ui="text,text-auto"</code> and <code>loadDefaults="true"</code>. First time run <code>java -jar myinstaller.jar</code> and enter the properties. When the installer has finished hard code any passwords.<br/>
|
|---|
| 111 | When you wish to update the code create a new myinstaller.jar and run <code>java -jar myinstaller.jar text-auto</code>.<br/>
|
|---|
| 112 | Should you wish to change the property values or add additional properties delete <code>ant.install.properties</code> from the current directory and run the installer with <code>java -jar myinstaller.jar</code>.<br/><br/>
|
|---|
| 113 |
|
|---|
| 114 |
|
|---|
| 115 | <h2>antinstaller- targets</h2>
|
|---|
| 116 | antinstaller- targets that are run when pages are shown are run in the -auto modes depending on the current state if ifProperty and ifTarget tests. If you want to use antinstaller- tasks and support -auto modes you have to work out what the consequences are for your installer. You can also set appropriate properties and use the <code>if</code> attribute in Ant target elements to specify additional process to compensate for -auto builds.<br/><br/>
|
|---|
| 117 |
|
|---|
| 118 | You should notice that also if the antinstaller- targets render messages they will be run automatically during swing-auto builds causing (probably unwanted) popups.
|
|---|
| 119 |
|
|---|
| 120 | <h2>Password handling</h2>
|
|---|
| 121 | Passwords are not written to <code>ant.install.properties</code>, if a password field is missing the user is warned that the defaults from <code>antinstall-config.xml</code> will be used. This can be avoided by entering the password in plain text into <code>ant.install.properties</code> with a text editor provided that does not create security risks.
|
|---|
| 122 |
|
|---|
| 123 | <!-- content end [segment-end]-->
|
|---|
| 124 | </div>
|
|---|
| 125 | </td>
|
|---|
| 126 | </tr>
|
|---|
| 127 | </tbody>
|
|---|
| 128 | </table>
|
|---|
| 129 | <div id="contents-panel">
|
|---|
| 130 | <!--[segment-file://contents-include.html] menu start -->
|
|---|
| 131 | <div id="contents-menu">
|
|---|
| 132 | <ol class="sidebar" id="root">
|
|---|
| 133 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><b>Site map</b>
|
|---|
| 134 | <ol>
|
|---|
| 135 | <li class="sidebar"><a href="introduction.html">Introduction</a></li>
|
|---|
| 136 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><b>Developer References</b>
|
|---|
| 137 | <ol>
|
|---|
| 138 | <li class="sidebar"><a href="quickstart.html">Quick Start</a></li>
|
|---|
| 139 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html">Manual</a>
|
|---|
| 140 | <ol class="init-hidden">
|
|---|
| 141 | <li class="sidebar"><a href="manual.html#config">antinstall-config.xml</a></li>
|
|---|
| 142 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html#page">Pages</a>
|
|---|
| 143 | <ol class="init-hidden">
|
|---|
| 144 | <li class="sidebar"><a href="manual.html#pagesplash">Splash Page</a></li>
|
|---|
| 145 | <li class="sidebar"><a href="manual.html#pagetext">Text Page</a></li>
|
|---|
| 146 | <li class="sidebar"><a href="manual.html#pagelicense">License Page</a></li>
|
|---|
| 147 | <li class="sidebar"><a href="manual.html#pageinput">Input Page</a></li>
|
|---|
| 148 | <li class="sidebar"><a href="manual.html#pageprogress">Progress Page</a></li>
|
|---|
| 149 | </ol>
|
|---|
| 150 | </li>
|
|---|
| 151 | <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html#inputtypes">Input types</a>
|
|---|
| 152 | <ol class="init-hidden">
|
|---|
| 153 | <li class="sidebar"><a href="manual.html#app-root">Application Root</a></li>
|
|---|
| 154 | <li class="sidebar"><a href="manual.html#checkbox">Checkbox</a></li>
|
|---|
| 155 | <li class="sidebar"><a href="manual.html#comment">Comment</a></li>
|
|---|
| 156 | <li class="sidebar"><a href="manual.html#date">Date</a></li>
|
|---|
| 157 | <li class="sidebar"><a href="manual.html#directory">Directory</a></li>
|
|---|
| 158 | <li class="sidebar"><a href="manual.html#file">File</a></li>
|
|---|
| 159 | <li class="sidebar"><a href="manual.html#large-select">Large Select</a></li>
|
|---|
| 160 | <li class="sidebar"><a href="manual.html#password">Password Text</a></li>
|
|---|
| 161 | <li class="sidebar"><a href="manual.html#password-confirm">Confirm Password</a></li>
|
|---|
| 162 | <li class="sidebar"><a href="manual.html#select">Select</a></li>
|
|---|
| 163 | <li class="sidebar"><a href="manual.html#target">Target</a></li>
|
|---|
| 164 | <li class="sidebar"><a href="manual.html#target-select">Target Select</a></li>
|
|---|
| 165 | <li class="sidebar"><a href="manual.html#text">Unvalidated Text</a></li>
|
|---|
| 166 | <li class="sidebar"><a href="manual.html#validated">Validated Text</a></li>
|
|---|
| 167 | <li class="sidebar"><a href="manual.html#extvalidated">Externally Validated Text</a></li>
|
|---|
| 168 | </ol>
|
|---|
| 169 | </li>
|
|---|
| 170 | <li class="sidebar"><a href="manual.html#extractor">Self Extractor</a></li>
|
|---|
| 171 | <li class="sidebar"><a href="manual.html#non-extractor">Non Extractor</a></li>
|
|---|
| 172 | <li class="sidebar"><a href="manual.html#scripts">Start Scripts</a></li>
|
|---|
| 173 | <li class="sidebar"><a href="manual.html#refs">Dynamic References</a></li>
|
|---|
| 174 | <li class="sidebar"><a href="manual.html#pagedisplay">Page Displaying</a></li>
|
|---|
| 175 | </ol>
|
|---|
| 176 | </li>
|
|---|
| 177 | <li class="sidebar"><a href="installertask.html">Installer Ant task</a></li>
|
|---|
| 178 | <li class="sidebar"><a href="validationofconfig.html">Validation of config</a></li>
|
|---|
| 179 | <li class="sidebar"><a href="lookandfeels.html">LookAndFeels</a> <br/>(inc screenshots)</li>
|
|---|
| 180 | <li class="sidebar"><a href="classpathresources.html">Resources/Classpath issues</a></li>
|
|---|
| 181 | <li class="sidebar"><a href="i18n.html">Internationalisation</a></li>
|
|---|
| 182 | <li class="sidebar"><a href="auto.html">Automated installs</a></li>
|
|---|
| 183 | <li class="sidebar"><a href="installtypes.html">Multiple install types</a></li>
|
|---|
| 184 | <li class="sidebar"><a href="posttargets.html">Post display targets</a></li>
|
|---|
| 185 | <li class="sidebar"><a href="icons.html">Button Icons</a></li>
|
|---|
| 186 | <li class="sidebar"><a href="antinstall-config-example.html">Example antinstall-config.xml</a></li>
|
|---|
| 187 | </ol>
|
|---|
| 188 | </li>
|
|---|
| 189 | <li class="sidebar"><a href="manual-ant.html">Ant Manual</a></li>
|
|---|
| 190 | <li class="sidebar"><a href="antlinks.html">Ant links</a></li>
|
|---|
| 191 | <li class="sidebar"><a href="userusage.html">User usage</a></li>
|
|---|
| 192 | <li class="sidebar"><a href="licenses.html">Licenses</a></li>
|
|---|
| 193 | <li class="sidebar"><a href="potentialuses.html">Potential uses</a></li>
|
|---|
| 194 | <li class="sidebar"><a href="roadmap.html">Road Map</a></li>
|
|---|
| 195 | <li class="sidebar"><a href="wanted.html">Wanted</a></li>
|
|---|
| 196 | <li class="sidebar"><a href="dtds.html">DTDs</a></li>
|
|---|
| 197 | <li class="sidebar"><a href="changelog.html">Changelog</a></li>
|
|---|
| 198 | <li class="sidebar"><a href="http://sourceforge.net/projects/antinstaller">Project page on SourceForge</a></li>
|
|---|
| 199 | <li class="sidebar"><a href="java2html/antinstaller/index.html">Java2HTML (main)</a></li>
|
|---|
| 200 | <li class="sidebar"><a href="java2html/ext/index.html">Java2HTML (extensions)</a></li>
|
|---|
| 201 | <li class="sidebar"><a href="http://antinstaller.cvs.sourceforge.net/antinstaller">Public CVS over HTTP</a></li>
|
|---|
| 202 | <li class="sidebar"><a href="http://sourceforge.net/sendmessage.php?touser=616485">Contact AntInstaller Admin</a></li>
|
|---|
| 203 | </ol>
|
|---|
| 204 | </li>
|
|---|
| 205 | </ol>
|
|---|
| 206 | <br/>
|
|---|
| 207 | <br/>
|
|---|
| 208 | </div>
|
|---|
| 209 |
|
|---|
| 210 |
|
|---|
| 211 | <!-- menu end [segment-end]-->
|
|---|
| 212 | </div>
|
|---|
| 213 | <div id="contents-options">
|
|---|
| 214 | <a id="toggle" href="#" onclick="toggleMenu(); return false;">show menu</a>
|
|---|
| 215 | </div>
|
|---|
| 216 |
|
|---|
| 217 | </div>
|
|---|
| 218 | </body>
|
|---|
| 219 | </html>
|
|---|
