Version Differences for Preparation for Capturing Install Output

Revision as of 15 April 2013 14:14 n

(Copied from Anthill section.)

                 The installation of anthillpro does not provide a log of everything that is occurring (except for what you will see in the command prompt window).  Because of this, it may be necessary to prepare your command prompt window beforehand so you can retrieve any debugging information should the installation go awry.
                 <font size=3>'''IT IS BEST PRACTICE NOT to double-click''' </font> the installation script, and instead run it from the command line, as the installation script will exit and history will be lost!
                 There are a few options (depending on OS) to help with debugging.
                 = General =
                 The following should be able to work regardless of vendor.
                 == Redirect to File ==
                 Any output from a script/prompt can be redirected to a file.  This can be achieved by invoking the ">" key while typing a script to execute.  For example, the following will redirect to a file:  <pre>install.sh > install.out</pre>
                 <br/>
                 <br/>
                 = Operating System Specific =
                 The following are specific to each OS.  Regardless of whichever method you use, you may need to copy ['''CTRL'''+'''C'''] and paste ['''CTRL'''+'''V'''] results.
                 == *nix ==
                 When installing on *nix systems, the '''install.sh''' script should be used as the *.bat file is for Windows installations only.  If already in the installer directory, the file needs to be called as '''./install.sh''' as just '''install.sh''' will not execute.
                 === script Command ===
                 The [http://unixhelp.ed.ac.uk/CGI/man-cgi?script man page for script] has more details on '''script''', but basically script will capture every keystroke that is performed within the terminal.  It also captures the current screen output.  Therefore, you can potentially redirect the entire installation to file as well as any keys you may hit, while also rendering to the screen.  After script is invoked and the installation has completed (whether in error or success), type '''<font face="monospace">exit</font>''' to finish the script (which will then be saved to a file).  You can then upload the script output to Supportal for further analysis if you wish.
                 <br/>
                 <br/>
                 == Windows ==
                 When installing on Windows systems, the '''install.bat''' script should be used as the *.sh file is for *nix-based installations only.  Please make sure to '''not double-click''' the installer script, and instead call it from the command prompt as noted above in the intro.
                 === Increase Command Prompt Buffer ===
                 To increase the command prompt buffer, first you will need to locate the '''command prompt'''.  To do this, either navigate to '''%SYSTEMROOT%\system32\cmd.exe''' or type '''cmd.exe''' in the search bar of the Start menu.  Then, right-click the file and select ''Properties''.  From here, visit the following tabs, and make selections as needed (you can view the recommendations below, in the next [http://wiki.urbancode.com/AnthillPro/Customizing_Command_Prompt_to_be_Install_Ready#Defaults_.26_Recommendations sub-section]):
                 * Options
                 ** Cursor Size
                 ** Edit Options
                 * Layout
                 ** Screen buffer size
                 ** Window Size
                 After the command prompt is properly set up, from the command prompt navigate to the installer directory, and run '''install-server.bat'''.  Proceed with the installation as normal and continue to either error or success.  Afterwards you can copy all the information within the lines of the command buffer by doing the following:
                 * Right-Click the title bar and hover over '''Edit'''
                 * Click on ''Select All''
                 * Press ['''ENTER'''] to "Mark" the text
                 * Open up your favorite word processor and paste the data.
                 ==== Defaults & Recommendations ====
                 Listed below are the defaults & recommendations for the command prompt buffer:
                 <table border="4" bordercolor="yellow" cellpadding="3" cellspacing="3">
                 <th>Item</th>
                 <th>Default</th>
                 <th>Recommended</th>
                 <tr>
                 <td>Cursor Size</td>
                 <td align="center" bgcolor="#FFFFA3">Small</td>
                 <td align="center" bgcolor="#FFFFA3">'''Large'''</td>
                 </tr>
                 <tr>
                 <td>QuickEdit Mode</td>
                 <td align="center" bgcolor="#FFFFA3">false</td>
                 <td align="center" bgcolor="#FFFFA3">'''true'''</td>
                 </tr>
                 <tr>
                 <td>Insert Mode</td>
                 <td align="center" bgcolor="#FFFFA3">false</td>
                 <td align="center" bgcolor="#FFFFA3">'''true'''</td>
                 </tr>
                 <tr>
                 <td>Buffer - Width</td>
                 <td align="center" bgcolor="#FFFFA3">80</td>
                 <td align="center" bgcolor="#FFFFA3">'''160'''</td>
                 </tr>
                 <tr>
                 <td>Buffer - Height</td>
                 <td align="center" bgcolor="#FFFFA3">300</td>
                 <td align="center" bgcolor="#FFFFA3">'''9999'''</td>
                 </tr>
                 <tr>
                 <td>Window - Width</td>
                 <td align="center" bgcolor="#FFFFA3">80</td>
                 <td align="center" bgcolor="#FFFFA3">'''160'''</td>
                 </tr>
                 <tr>
                 <td>Window - Height</td>
                 <td align="center">25</td>
                 <td align="center">25</td>
                 </tr>
                 <tr>
                 <td>Position - System Decide</td>
                 <td align="center">true</td>
                 <td align="center">true</td>
                 </tr>
                 </table>
                 <br/>
                 <br/>
                 ==== Screenshot ====
                 [[Image:install-screenshot.png|center|656x656px|alt=Screenshot of the command prompt ready to cut/paste into notepad++ along with properties|Screenshot of the command prompt ready to cut/paste into notepad++ along with properties]]