Leaked source code of windows server 2003
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

280 lines
11 KiB

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
  2. <HTML DIR="ltr">
  3. <HEAD>
  4. <TITLE>Managing UDDI Services from the Command Line</TITLE>
  5. <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=Windows-1252">
  6. <META HTTP-EQUIV="MSThemeCompatible" CONTENT="Yes">
  7. <META NAME="MS.LOCALE" CONTENT="EN-US">
  8. <LINK REL="stylesheet" MEDIA="screen" TYPE="text/css" HREF="coUA.css">
  9. <LINK REL="stylesheet" MEDIA="print" TYPE="text/css" HREF="coUAprint.css">
  10. <SCRIPT LANGUAGE="JScript" SRC="shared.js"></SCRIPT>
  11. </HEAD>
  12. <BODY>
  13. <DIV CLASS="UAbrand"><SPAN CLASS="webonly"><IMG SRC="UAbrand.gif" CLASS="UAbrand" ALT="Microsoft Windows Graphic"></SPAN></DIV>
  14. <H1>Managing UDDI&nbsp;Services from the Command-Line</H1>
  15. <P>
  16. You can invoke many UDDI&nbsp;Services administrative utilities from the
  17. command line. For example, you can import categorization schemes or other XML
  18. data, backup or restore a UDDI&nbsp;Services database, or reset the
  19. cryptography key used to generate UDDI authentication tickets. The following
  20. table lists the UDDI&nbsp;Services administrative utilities.
  21. </P>
  22. <TABLE WIDTH="100%">
  23. <TR>
  24. <!--Column 1--><TH>Command</TH>
  25. <!--Column 2--><TH>Function</TH>
  26. </TR>
  27. <TR>
  28. <!--Column 1--><TD height="19"><a href="#bootstrap">bootstrap</a></TD>
  29. <!--Column 2--><TD height="19">Imports XML data into a UDDI&nbsp;Services site.</TD>
  30. </TR>
  31. <TR>
  32. <!--Column 1--><TD><a href="#resetkey">resetkey</a></TD>
  33. <!--Column 2--><TD>Resets the cryptography key used to generate UDDI authentication
  34. tickets.</TD>
  35. </TR>
  36. <TR>
  37. <!--Column 1--><TD><a href="#recalc">recalcstats</a></TD>
  38. <!--Column 2--><TD>Recalculates statistics for a UDDI&nbsp;Services site.</TD>
  39. </TR>
  40. <TR>
  41. <!--Column 1--><TD><a href="#backup">uddi.database.backup.cmd</a></TD>
  42. <!--Column 2--><TD>Creates a backup of a local UDDI&nbsp;Services database.</TD>
  43. </TR>
  44. <TR>
  45. <!--Column 1--><TD><a href="#restore">uddi.database.restore.cmd</a></TD>
  46. <!--Column 2--><TD>Restores a database backup to a local UDDI&nbsp;Services
  47. database.</TD>
  48. </TR>
  49. </TABLE>
  50. <p></p>
  51. <h1><a name="bootstrap"></a>bootstrap</h1>
  52. <p>Imports XML data into a UDDI&nbsp;Services site. Any information you import must
  53. first be validated against the appropriate XML schema definition (XSD). For
  54. more information about importing data and obtaining the appropriate XSDs for
  55. validation, see <a href="http://go.microsoft.com/fwlink/?linkid=5202" target="_blank">
  56. UDDI Resources</a>.</p>
  57. <h2>Syntax</h2>
  58. <P><NOBR><B>bootstrap</B> <wbr><B>/f </B>[<I>drive:</I>][<I>path</I>]<i>filename</i> <wbr>
  59. [<b>/u </b>[<i>user</i>]]</NOBR></P>
  60. <H2>Parameters</H2>
  61. <DL>
  62. <DT><B>/f </B>[<I>drive:</I>][<I>path</I>]<i>filename</i>
  63. <DD>
  64. Specifies the drive (optional), directory (optional), and file to import. <DT>[<b>/u </b>
  65. [<i>user</i>]]
  66. <DD>
  67. The user name (publisher) under which the data is imported and owned by. If
  68. none is specified, defaults to <i>System</i>. <DT><B>/?</B>
  69. <DD>
  70. Displays help at the command prompt.</DD>
  71. </DL>
  72. <h2>Remarks</h2>
  73. <ul>
  74. <LI>
  75. By default, this command is installed to <i>%systemdrive%</i>\Inetpub\Uddi\Bin.&nbsp;
  76. <LI>
  77. This command is available only if the&nbsp;<B>UDDI&nbsp;Services Database
  78. Components </B>
  79. are installed.
  80. <LI>
  81. This command must be run from the computer hosting the UDDI&nbsp;Services
  82. database component for the site to which you want to import XML data.
  83. <LI>
  84. Only administrators can use the <b>bootstrap</b> command.
  85. </LI>
  86. </ul>
  87. <h2>Examples</h2>
  88. <p>To import an XML file named mydata.xml under the <i>System</i> user, type:</p>
  89. <p><b>bootstrap /f mydata.xml</b></p>
  90. <p>To import an XML file named mydata.xml under a user named <i>John</i>, type:</p>
  91. <p><b>bootstrap /f mydata.xml /u John</b></p>
  92. <p>To import an XML file located in C:\Data named mydata.xml under a user named <i>John</i>,
  93. type:</p>
  94. <p><b>bootstrap /f C:\Data\mydata.xml /u John</b></p>
  95. <p><A ID="specLoc" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p>
  96. <h1><a name="resetkey"></a>resetkey</h1>
  97. <p>Resets the cryptography key used to generate UDDI authentication tickets.</p>
  98. <h2>Syntax</h2>
  99. <P><NOBR><B>resetkey</B> <wbr>[<B>/now</B>]</NOBR></P>
  100. <H2>Parameters</H2>
  101. <DL>
  102. <DT>[<B>/now</B>]
  103. <DD>
  104. Forces an immediate reset of the cryptography key. <DT><B>/?</B>
  105. <DD>
  106. Displays help at the command prompt.</DD>
  107. </DL>
  108. <h2>Remarks</h2>
  109. <ul>
  110. <LI>
  111. By default, this command is installed to <I>%systemdrive%</I>
  112. \Inetpub\Uddi\Bin.
  113. <LI>
  114. This command is available only if the&nbsp;<B>UDDI&nbsp;Services Database
  115. Components </B>
  116. are installed.
  117. <LI>
  118. Only administrators can use the <b>resetkey</b> command.
  119. </LI>
  120. </ul>
  121. <h2>Examples</h2>
  122. <p>To view the current cryptography key timeout settings, type:</p>
  123. <p><b>resetkey</b></p>
  124. <p>To immediately reset the cryptography key, type:</p>
  125. <p><b>resetkey /now</b></p>
  126. <p><A ID="specLoc" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p>
  127. <h1><a name="recalc"></a>recalcstats</h1>
  128. <p>Recalculates statistics for a UDDI&nbsp;Services site.</p>
  129. <h2>Syntax</h2>
  130. <P><NOBR><B>recalcstats</B></NOBR></P>
  131. <H2>Parameters</H2>
  132. <DL>
  133. <DT><B>/?</B>
  134. <DD>
  135. Displays help at the command prompt.</DD>
  136. </DL>
  137. <h2>Remarks</h2>
  138. <UL>
  139. <LI>
  140. By default, this command is installed to <I>%systemdrive%</I>
  141. \Inetpub\Uddi\Bin.
  142. <LI>
  143. This command is available only if the&nbsp;<B>UDDI&nbsp;Services Database
  144. Components </B>
  145. are installed.
  146. <LI>
  147. This command must be run from the computer hosting the UDDI&nbsp;Services
  148. database component&nbsp;for the site you want to recalculate statistics.
  149. <LI>
  150. Only administrators can use the <b>recalcstats</b>command.&nbsp;&nbsp;</LI></UL>
  151. <p><A ID="A1" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p>
  152. <h1><a name="backup"></a>uddi.database.backup.cmd</h1>
  153. <p>Creates a backup of a local UDDI&nbsp;Services database to a file
  154. (Uddi.Database.bak).</p>
  155. <h2>Syntax</h2>
  156. <P><NOBR><B>uddi.database.backup.cmd</B> <wbr>[<i>Database Instance Name</i>]</NOBR></P>
  157. <H2>Parameters</H2>
  158. <DL>
  159. <DT>[<i>Database Instance Name</i>]
  160. <DD>
  161. The name of the local MSDE2000 or Microsoft SQL Server database instance where
  162. the UDDI&nbsp;Services database component is installed. If none is specified,
  163. the default database instance is used. <DT><B>/?</B>
  164. <DD>
  165. Displays help at the command prompt.</DD>
  166. </DL>
  167. <h2>Remarks</h2>
  168. <ul>
  169. <LI>
  170. By default, this command is installed to <I>%systemdrive%</I>
  171. \Inetpub\Uddi\Bin.
  172. <LI>
  173. This command is available only if the <b>UDDI&nbsp;Services Database Components</b>
  174. are&nbsp;installed.
  175. <LI>
  176. This command must be run from the computer hosting the UDDI&nbsp;Services
  177. database component of which you want to create a backup.
  178. <LI>
  179. Only administrators can use the <b>uddi.database.backup.cmd</b>
  180. command.
  181. <LI>
  182. Data is backed up to Inetpub\Uddi\Data\Uddi.Database.bak
  183. <LI>
  184. Backups created using this tool contain physical paths and file names for UDDI
  185. data files specific to the current installation. For this reason, you cannot
  186. use this tool to migrate data from one UDDI&nbsp;Services site to another.</LI>
  187. </ul>
  188. <h2>Examples</h2>
  189. <p>To back up a UDDI&nbsp;Services database hosted in the default database
  190. instance, type:</p>
  191. <p><b>uddi.database.backup.cmd</b></p>
  192. <p>To back up a UDDI&nbsp;Services database hosted in a database instance named
  193. "UDDI", type:</p>
  194. <p><b>uddi.database.backup.cmd UDDI</b></p>
  195. <p><A ID="specLoc" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p>
  196. <h1><a name="restore"></a>uddi.database.restore.cmd</h1>
  197. <p>Restores a UDDI&nbsp;Services database backup created with the
  198. uddi.database.restore.cmd command.</p>
  199. <h2>Syntax</h2>
  200. <P><NOBR><B>uddi.database.restore.cmd</B> <wbr>[<i>Database Instance Name</i>]</NOBR></P>
  201. <H2>Parameters</H2>
  202. <DL>
  203. <DT>[<i>Database Instance Name</i>]
  204. <DD>
  205. The name of the local MSDE2000 or Microsoft SQL Server database instance where
  206. the UDDI&nbsp;Services database component is installed and&nbsp;to which you
  207. want to restore the backup. If none is specified, the default database instance
  208. is used. <DT><B>/?</B>
  209. <DD>
  210. Displays help at the command prompt.</DD>
  211. </DL>
  212. <h2>Remarks</h2>
  213. <ul>
  214. <LI>
  215. By default, this command is installed to <I>%systemdrive%</I>
  216. \Inetpub\Uddi\Bin.&nbsp;
  217. <LI>
  218. This command is available only if the&nbsp;<B>UDDI&nbsp;Services Database
  219. Components </B>
  220. are installed.
  221. <LI>
  222. This command must be run from the computer hosting the UDDI&nbsp;Services
  223. database component to which you want to restore the data and from the same
  224. directory where the database backup file (Uddi.Database.bak) is located.
  225. <LI>
  226. Only administrators can use the <b>uddi.database.restore.cmd</b>
  227. command.
  228. <LI>
  229. Backups created using the uddi.database.backup.cmd tool contain physical paths
  230. and file names for UDDI data files specific to the current installation. For
  231. this reason, you cannot use this tool to migrate data from one
  232. UDDI&nbsp;Services site to another.</LI>
  233. </ul>
  234. <h2>Examples</h2>
  235. <p>To restore a UDDI&nbsp;Services database hosted in the default database
  236. instance, type:</p>
  237. <p><b>uddi.database.backup.cmd</b></p>
  238. <p>To restore a UDDI&nbsp;Services database hosted in a database instance named
  239. "UDDI", type:</p>
  240. <p><b>uddi.database.restore.cmd UDDI</b></p>
  241. <p><A ID="specLoc" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p>
  242. <H2>Formatting legend</H2>
  243. <TABLE width="100%" ID="Table1">
  244. <TBODY>
  245. <TR>
  246. <TH>
  247. Format</TH>
  248. <TH>
  249. Meaning</TH></TR>
  250. <TR>
  251. <TD><I>Italic</I></TD>
  252. <TD>Information that the user must supply</TD>
  253. </TR>
  254. <TR>
  255. <TD><B>Bold</B></TD>
  256. <TD>Elements that the user must type exactly as shown</TD>
  257. </TR>
  258. <TR>
  259. <TD>Ellipsis (...)</TD>
  260. <TD>Parameter that can be repeated several times in a command line</TD>
  261. </TR>
  262. <TR>
  263. <TD>Between brackets ([])</TD>
  264. <TD>Optional items</TD>
  265. </TR>
  266. <TR>
  267. <TD>Between braces ({}); choices separated by pipe (|). Example: {even|odd}</TD>
  268. <TD>Set of choices from which the user must choose only one</TD>
  269. </TR>
  270. <TR>
  271. <TD><CODE>Courier font</CODE></TD>
  272. <TD>Code or program output</TD>
  273. </TR>
  274. </TBODY></TABLE>
  275. <SPAN class="anything" id="Span1"></SPAN>
  276. <hr class="iis" size="1">
  277. <p align="center"><i><a href="colegal.htm">� 1997-2002 Microsoft Corporation. All rights
  278. reserved</a>.</i></p>
  279. </BODY>
  280. </HTML>