|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> <HTML DIR="ltr"> <HEAD> <TITLE>Managing UDDI Services from the Command Line</TITLE> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=Windows-1252"> <META HTTP-EQUIV="MSThemeCompatible" CONTENT="Yes"> <META NAME="MS.LOCALE" CONTENT="EN-US"> <LINK REL="stylesheet" MEDIA="screen" TYPE="text/css" HREF="coUA.css"> <LINK REL="stylesheet" MEDIA="print" TYPE="text/css" HREF="coUAprint.css"> <SCRIPT LANGUAGE="JScript" SRC="shared.js"></SCRIPT> </HEAD> <BODY> <DIV CLASS="UAbrand"><SPAN CLASS="webonly"><IMG SRC="UAbrand.gif" CLASS="UAbrand" ALT="Microsoft Windows Graphic"></SPAN></DIV> <H1>Managing UDDI Services from the Command-Line</H1> <P> You can invoke many UDDI Services administrative utilities from the command line. For example, you can import categorization schemes or other XML data, backup or restore a UDDI Services database, or reset the cryptography key used to generate UDDI authentication tickets. The following table lists the UDDI Services administrative utilities. </P> <TABLE WIDTH="100%"> <TR> <!--Column 1--><TH>Command</TH> <!--Column 2--><TH>Function</TH> </TR> <TR> <!--Column 1--><TD height="19"><a href="#bootstrap">bootstrap</a></TD> <!--Column 2--><TD height="19">Imports XML data into a UDDI Services site.</TD> </TR> <TR> <!--Column 1--><TD><a href="#resetkey">resetkey</a></TD> <!--Column 2--><TD>Resets the cryptography key used to generate UDDI authentication tickets.</TD> </TR> <TR> <!--Column 1--><TD><a href="#recalc">recalcstats</a></TD> <!--Column 2--><TD>Recalculates statistics for a UDDI Services site.</TD> </TR> <TR> <!--Column 1--><TD><a href="#backup">uddi.database.backup.cmd</a></TD> <!--Column 2--><TD>Creates a backup of a local UDDI Services database.</TD> </TR> <TR> <!--Column 1--><TD><a href="#restore">uddi.database.restore.cmd</a></TD> <!--Column 2--><TD>Restores a database backup to a local UDDI Services database.</TD> </TR> </TABLE> <p></p> <h1><a name="bootstrap"></a>bootstrap</h1> <p>Imports XML data into a UDDI Services site. Any information you import must first be validated against the appropriate XML schema definition (XSD). For more information about importing data and obtaining the appropriate XSDs for validation, see <a href="http://go.microsoft.com/fwlink/?linkid=5202" target="_blank"> UDDI Resources</a>.</p> <h2>Syntax</h2> <P><NOBR><B>bootstrap</B> <wbr><B>/f </B>[<I>drive:</I>][<I>path</I>]<i>filename</i> <wbr> [<b>/u </b>[<i>user</i>]]</NOBR></P> <H2>Parameters</H2> <DL> <DT><B>/f </B>[<I>drive:</I>][<I>path</I>]<i>filename</i> <DD> Specifies the drive (optional), directory (optional), and file to import. <DT>[<b>/u </b> [<i>user</i>]] <DD> The user name (publisher) under which the data is imported and owned by. If none is specified, defaults to <i>System</i>. <DT><B>/?</B> <DD> Displays help at the command prompt.</DD> </DL> <h2>Remarks</h2> <ul> <LI> By default, this command is installed to <i>%systemdrive%</i>\Inetpub\Uddi\Bin. <LI> This command is available only if the <B>UDDI Services Database Components </B> are installed. <LI> This command must be run from the computer hosting the UDDI Services database component for the site to which you want to import XML data. <LI> Only administrators can use the <b>bootstrap</b> command. </LI> </ul> <h2>Examples</h2> <p>To import an XML file named mydata.xml under the <i>System</i> user, type:</p> <p><b>bootstrap /f mydata.xml</b></p> <p>To import an XML file named mydata.xml under a user named <i>John</i>, type:</p> <p><b>bootstrap /f mydata.xml /u John</b></p> <p>To import an XML file located in C:\Data named mydata.xml under a user named <i>John</i>, type:</p> <p><b>bootstrap /f C:\Data\mydata.xml /u John</b></p> <p><A ID="specLoc" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p> <h1><a name="resetkey"></a>resetkey</h1> <p>Resets the cryptography key used to generate UDDI authentication tickets.</p> <h2>Syntax</h2> <P><NOBR><B>resetkey</B> <wbr>[<B>/now</B>]</NOBR></P> <H2>Parameters</H2> <DL> <DT>[<B>/now</B>] <DD> Forces an immediate reset of the cryptography key. <DT><B>/?</B> <DD> Displays help at the command prompt.</DD> </DL> <h2>Remarks</h2> <ul> <LI> By default, this command is installed to <I>%systemdrive%</I> \Inetpub\Uddi\Bin. <LI> This command is available only if the <B>UDDI Services Database Components </B> are installed. <LI> Only administrators can use the <b>resetkey</b> command. </LI> </ul> <h2>Examples</h2> <p>To view the current cryptography key timeout settings, type:</p> <p><b>resetkey</b></p> <p>To immediately reset the cryptography key, type:</p> <p><b>resetkey /now</b></p> <p><A ID="specLoc" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p> <h1><a name="recalc"></a>recalcstats</h1> <p>Recalculates statistics for a UDDI Services site.</p> <h2>Syntax</h2> <P><NOBR><B>recalcstats</B></NOBR></P> <H2>Parameters</H2> <DL> <DT><B>/?</B> <DD> Displays help at the command prompt.</DD> </DL> <h2>Remarks</h2> <UL> <LI> By default, this command is installed to <I>%systemdrive%</I> \Inetpub\Uddi\Bin. <LI> This command is available only if the <B>UDDI Services Database Components </B> are installed. <LI> This command must be run from the computer hosting the UDDI Services database component for the site you want to recalculate statistics. <LI> Only administrators can use the <b>recalcstats</b>command. </LI></UL> <p><A ID="A1" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p> <h1><a name="backup"></a>uddi.database.backup.cmd</h1> <p>Creates a backup of a local UDDI Services database to a file (Uddi.Database.bak).</p> <h2>Syntax</h2> <P><NOBR><B>uddi.database.backup.cmd</B> <wbr>[<i>Database Instance Name</i>]</NOBR></P> <H2>Parameters</H2> <DL> <DT>[<i>Database Instance Name</i>] <DD> The name of the local MSDE2000 or Microsoft SQL Server database instance where the UDDI Services database component is installed. If none is specified, the default database instance is used. <DT><B>/?</B> <DD> Displays help at the command prompt.</DD> </DL> <h2>Remarks</h2> <ul> <LI> By default, this command is installed to <I>%systemdrive%</I> \Inetpub\Uddi\Bin. <LI> This command is available only if the <b>UDDI Services Database Components</b> are installed. <LI> This command must be run from the computer hosting the UDDI Services database component of which you want to create a backup. <LI> Only administrators can use the <b>uddi.database.backup.cmd</b> command. <LI> Data is backed up to Inetpub\Uddi\Data\Uddi.Database.bak <LI> Backups created using this tool contain physical paths and file names for UDDI data files specific to the current installation. For this reason, you cannot use this tool to migrate data from one UDDI Services site to another.</LI> </ul> <h2>Examples</h2> <p>To back up a UDDI Services database hosted in the default database instance, type:</p> <p><b>uddi.database.backup.cmd</b></p> <p>To back up a UDDI Services database hosted in a database instance named "UDDI", type:</p> <p><b>uddi.database.backup.cmd UDDI</b></p> <p><A ID="specLoc" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p> <h1><a name="restore"></a>uddi.database.restore.cmd</h1> <p>Restores a UDDI Services database backup created with the uddi.database.restore.cmd command.</p> <h2>Syntax</h2> <P><NOBR><B>uddi.database.restore.cmd</B> <wbr>[<i>Database Instance Name</i>]</NOBR></P> <H2>Parameters</H2> <DL> <DT>[<i>Database Instance Name</i>] <DD> The name of the local MSDE2000 or Microsoft SQL Server database instance where the UDDI Services database component is installed and to which you want to restore the backup. If none is specified, the default database instance is used. <DT><B>/?</B> <DD> Displays help at the command prompt.</DD> </DL> <h2>Remarks</h2> <ul> <LI> By default, this command is installed to <I>%systemdrive%</I> \Inetpub\Uddi\Bin. <LI> This command is available only if the <B>UDDI Services Database Components </B> are installed. <LI> This command must be run from the computer hosting the UDDI Services database component to which you want to restore the data and from the same directory where the database backup file (Uddi.Database.bak) is located. <LI> Only administrators can use the <b>uddi.database.restore.cmd</b> command. <LI> Backups created using the uddi.database.backup.cmd tool contain physical paths and file names for UDDI data files specific to the current installation. For this reason, you cannot use this tool to migrate data from one UDDI Services site to another.</LI> </ul> <h2>Examples</h2> <p>To restore a UDDI Services database hosted in the default database instance, type:</p> <p><b>uddi.database.backup.cmd</b></p> <p>To restore a UDDI Services database hosted in a database instance named "UDDI", type:</p> <p><b>uddi.database.restore.cmd UDDI</b></p> <p><A ID="specLoc" HREF="MS-ITS:uddi.mmc.chm::/uddi.mmc.admintools.htm">Back to top</A></p> <H2>Formatting legend</H2> <TABLE width="100%" ID="Table1"> <TBODY> <TR> <TH> Format</TH> <TH> Meaning</TH></TR> <TR> <TD><I>Italic</I></TD> <TD>Information that the user must supply</TD> </TR> <TR> <TD><B>Bold</B></TD> <TD>Elements that the user must type exactly as shown</TD> </TR> <TR> <TD>Ellipsis (...)</TD> <TD>Parameter that can be repeated several times in a command line</TD> </TR> <TR> <TD>Between brackets ([])</TD> <TD>Optional items</TD> </TR> <TR> <TD>Between braces ({}); choices separated by pipe (|). Example: {even|odd}</TD> <TD>Set of choices from which the user must choose only one</TD> </TR> <TR> <TD><CODE>Courier font</CODE></TD> <TD>Code or program output</TD> </TR> </TBODY></TABLE> <SPAN class="anything" id="Span1"></SPAN> <hr class="iis" size="1"> <p align="center"><i><a href="colegal.htm">� 1997-2002 Microsoft Corporation. All rights reserved</a>.</i></p> </BODY> </HTML>
|