| 1 | <HTML |
|---|
| 2 | ><HEAD |
|---|
| 3 | ><TITLE |
|---|
| 4 | > Developer Tools |
|---|
| 5 | </TITLE |
|---|
| 6 | ><META |
|---|
| 7 | NAME="GENERATOR" |
|---|
| 8 | CONTENT="Modular DocBook HTML Stylesheet Version 1.59"><LINK |
|---|
| 9 | REL="HOME" |
|---|
| 10 | TITLE=" eGroupWare Setup |
|---|
| 11 | " |
|---|
| 12 | HREF="setup3.html"><LINK |
|---|
| 13 | REL="PREVIOUS" |
|---|
| 14 | TITLE=" Application setup files |
|---|
| 15 | " |
|---|
| 16 | HREF="setup3-1.html"><LINK |
|---|
| 17 | REL="NEXT" |
|---|
| 18 | TITLE=" The install/upgrade process |
|---|
| 19 | " |
|---|
| 20 | HREF="setup3-3.html"></HEAD |
|---|
| 21 | ><BODY |
|---|
| 22 | CLASS="SECT1" |
|---|
| 23 | ><DIV |
|---|
| 24 | CLASS="NAVHEADER" |
|---|
| 25 | ><TABLE |
|---|
| 26 | WIDTH="100%" |
|---|
| 27 | BORDER="0" |
|---|
| 28 | CELLPADDING="0" |
|---|
| 29 | CELLSPACING="0" |
|---|
| 30 | ><TR |
|---|
| 31 | ><TH |
|---|
| 32 | COLSPAN="3" |
|---|
| 33 | ALIGN="center" |
|---|
| 34 | >eGroupWare Setup</TH |
|---|
| 35 | ></TR |
|---|
| 36 | ><TR |
|---|
| 37 | ><TD |
|---|
| 38 | WIDTH="10%" |
|---|
| 39 | ALIGN="left" |
|---|
| 40 | VALIGN="bottom" |
|---|
| 41 | ><A |
|---|
| 42 | HREF="setup3-1.html" |
|---|
| 43 | >Prev</A |
|---|
| 44 | ></TD |
|---|
| 45 | ><TD |
|---|
| 46 | WIDTH="80%" |
|---|
| 47 | ALIGN="center" |
|---|
| 48 | VALIGN="bottom" |
|---|
| 49 | ></TD |
|---|
| 50 | ><TD |
|---|
| 51 | WIDTH="10%" |
|---|
| 52 | ALIGN="right" |
|---|
| 53 | VALIGN="bottom" |
|---|
| 54 | ><A |
|---|
| 55 | HREF="setup3-3.html" |
|---|
| 56 | >Next</A |
|---|
| 57 | ></TD |
|---|
| 58 | ></TR |
|---|
| 59 | ></TABLE |
|---|
| 60 | ><HR |
|---|
| 61 | ALIGN="LEFT" |
|---|
| 62 | WIDTH="100%"></DIV |
|---|
| 63 | ><DIV |
|---|
| 64 | CLASS="SECT1" |
|---|
| 65 | ><H1 |
|---|
| 66 | CLASS="SECT1" |
|---|
| 67 | ><A |
|---|
| 68 | NAME="AEN148" |
|---|
| 69 | >Developer Tools</A |
|---|
| 70 | ></H1 |
|---|
| 71 | ><DIV |
|---|
| 72 | CLASS="SECT2" |
|---|
| 73 | ><H2 |
|---|
| 74 | CLASS="SECT2" |
|---|
| 75 | ><A |
|---|
| 76 | NAME="AEN150" |
|---|
| 77 | >sqltoarray.php</A |
|---|
| 78 | ></H2 |
|---|
| 79 | ><DIV |
|---|
| 80 | CLASS="SECT3" |
|---|
| 81 | ><H3 |
|---|
| 82 | CLASS="SECT3" |
|---|
| 83 | ><A |
|---|
| 84 | NAME="AEN152" |
|---|
| 85 | >Displays the current schema_proc array defining an application's tables.</A |
|---|
| 86 | ></H3 |
|---|
| 87 | ><P |
|---|
| 88 | > This web application reads the current table status live from the database. It then parses this information into a hopefully correct table definition array for schema_proc. Upon visiting this app, you are shown a list of currently installed applications with defined tables. You may then select one app or all apps, and then submit the form. From this form you may then download a tables_current file, suitable for commission to cvs. Please do check the format to make sure the definitions are correct. |
|---|
| 89 | </P |
|---|
| 90 | ></DIV |
|---|
| 91 | ></DIV |
|---|
| 92 | ><DIV |
|---|
| 93 | CLASS="SECT2" |
|---|
| 94 | ><H2 |
|---|
| 95 | CLASS="SECT2" |
|---|
| 96 | ><A |
|---|
| 97 | NAME="AEN155" |
|---|
| 98 | >schematoy.php</A |
|---|
| 99 | ></H2 |
|---|
| 100 | ><DIV |
|---|
| 101 | CLASS="SECT3" |
|---|
| 102 | ><H3 |
|---|
| 103 | CLASS="SECT3" |
|---|
| 104 | ><A |
|---|
| 105 | NAME="AEN157" |
|---|
| 106 | >Runs the full cycle of upgrades, including optional test_data.</A |
|---|
| 107 | ></H3 |
|---|
| 108 | ><P |
|---|
| 109 | > This app is not beautiful, may bomb on you, and will definitely drop your application's tables. The display is similar to the user/admin tool, applications.php. You are shown a list of apps with tables. Select one app, and enter a target version. Upon submission of the form: |
|---|
| 110 | </P |
|---|
| 111 | ><P |
|---|
| 112 | ></P |
|---|
| 113 | ><UL |
|---|
| 114 | ><LI |
|---|
| 115 | ><P |
|---|
| 116 | > All application tables are dropped. |
|---|
| 117 | </P |
|---|
| 118 | ></LI |
|---|
| 119 | ><LI |
|---|
| 120 | ><P |
|---|
| 121 | > tables_baseline.inc.php is loaded. |
|---|
| 122 | </P |
|---|
| 123 | ></LI |
|---|
| 124 | ><LI |
|---|
| 125 | ><P |
|---|
| 126 | > test_data.inc.php is loaded |
|---|
| 127 | </P |
|---|
| 128 | ></LI |
|---|
| 129 | ><LI |
|---|
| 130 | ><P |
|---|
| 131 | > tables_update.inc.php is loaded. |
|---|
| 132 | </P |
|---|
| 133 | ></LI |
|---|
| 134 | ><LI |
|---|
| 135 | ><P |
|---|
| 136 | > a full application upgrade test begins. |
|---|
| 137 | </P |
|---|
| 138 | ></LI |
|---|
| 139 | ></UL |
|---|
| 140 | ><P |
|---|
| 141 | > This will give a LOT of debugging output. Depending on your database, the process may take quite awhile. This tool should be considered as a destructive test of the full upgrade cycle. If the upgrade process is successful, you can then check the loaded test_data to see that it is still in place as expected after all the table modifications, etc. If not, it should be clear where the error has occurred. Look for the usual INVALID SQL warnings, among others. |
|---|
| 142 | </P |
|---|
| 143 | ></DIV |
|---|
| 144 | ></DIV |
|---|
| 145 | ><DIV |
|---|
| 146 | CLASS="SECT2" |
|---|
| 147 | ><H2 |
|---|
| 148 | CLASS="SECT2" |
|---|
| 149 | ><A |
|---|
| 150 | NAME="AEN172" |
|---|
| 151 | >tools subdirectory</A |
|---|
| 152 | ></H2 |
|---|
| 153 | ><DIV |
|---|
| 154 | CLASS="SECT3" |
|---|
| 155 | ><H3 |
|---|
| 156 | CLASS="SECT3" |
|---|
| 157 | ><A |
|---|
| 158 | NAME="AEN174" |
|---|
| 159 | >some utilities for sql file conversion, etc.</A |
|---|
| 160 | ></H3 |
|---|
| 161 | ><P |
|---|
| 162 | > In the tools directory under setup3, there should be at least a couple of hopefully handy perl or shell scripts. These are for running on the commandline only, and might apply to converting SQL files into lang files, etc. They are not expected to be perfect, but might offer some assistance or ideas for additional utilities. Use these at your own risk or benefit. |
|---|
| 163 | </P |
|---|
| 164 | ></DIV |
|---|
| 165 | ></DIV |
|---|
| 166 | ></DIV |
|---|
| 167 | ><DIV |
|---|
| 168 | CLASS="NAVFOOTER" |
|---|
| 169 | ><HR |
|---|
| 170 | ALIGN="LEFT" |
|---|
| 171 | WIDTH="100%"><TABLE |
|---|
| 172 | WIDTH="100%" |
|---|
| 173 | BORDER="0" |
|---|
| 174 | CELLPADDING="0" |
|---|
| 175 | CELLSPACING="0" |
|---|
| 176 | ><TR |
|---|
| 177 | ><TD |
|---|
| 178 | WIDTH="33%" |
|---|
| 179 | ALIGN="left" |
|---|
| 180 | VALIGN="top" |
|---|
| 181 | ><A |
|---|
| 182 | HREF="setup3-1.html" |
|---|
| 183 | >Prev</A |
|---|
| 184 | ></TD |
|---|
| 185 | ><TD |
|---|
| 186 | WIDTH="34%" |
|---|
| 187 | ALIGN="center" |
|---|
| 188 | VALIGN="top" |
|---|
| 189 | ><A |
|---|
| 190 | HREF="setup3.html" |
|---|
| 191 | >Home</A |
|---|
| 192 | ></TD |
|---|
| 193 | ><TD |
|---|
| 194 | WIDTH="33%" |
|---|
| 195 | ALIGN="right" |
|---|
| 196 | VALIGN="top" |
|---|
| 197 | ><A |
|---|
| 198 | HREF="setup3-3.html" |
|---|
| 199 | >Next</A |
|---|
| 200 | ></TD |
|---|
| 201 | ></TR |
|---|
| 202 | ><TR |
|---|
| 203 | ><TD |
|---|
| 204 | WIDTH="33%" |
|---|
| 205 | ALIGN="left" |
|---|
| 206 | VALIGN="top" |
|---|
| 207 | >Application setup files</TD |
|---|
| 208 | ><TD |
|---|
| 209 | WIDTH="34%" |
|---|
| 210 | ALIGN="center" |
|---|
| 211 | VALIGN="top" |
|---|
| 212 | > </TD |
|---|
| 213 | ><TD |
|---|
| 214 | WIDTH="33%" |
|---|
| 215 | ALIGN="right" |
|---|
| 216 | VALIGN="top" |
|---|
| 217 | >The install/upgrade process</TD |
|---|
| 218 | ></TR |
|---|
| 219 | ></TABLE |
|---|
| 220 | ></DIV |
|---|
| 221 | ></BODY |
|---|
| 222 | ></HTML |
|---|
| 223 | > |
|---|
