Site Utilities Tool (Preinst.exe)

The Site Utilities tool passes commands to Hierarchy Manager while Hierarchy Manager is running. Use this tool to diagnose problems in a site, repair a site, or stop all SMS services at a site. For example, suppose that you incorrectly removed an SMS site by removing a child site from its parent site without detaching it first. You can use the Site Utilities tool to bypass the SMS Administrator console and delete the incorrectly removed site from the parent site database.

Site Utilities Runs On

Processors: i386, Alpha
Operating systems: Windows NT 4.0

Installing Site Utilities

You must install the Site Utilities tool on an SMS primary or secondary site. If you run the Microsoft BackOffice 4.5 Resource Kit Setup program on a computer that does not meet this requirement, this tool will not be installed.

Files Required for Site Utilities

Preinst.exe

Site Utilities Syntax

preinst options

Where options are:

/deinstall:{sitecode}

Sends a command to remove a specific secondary site from a site hierarchy. The sitecode parameter specifies the site to remove. Note that the braces are required.

If you want to remove a secondary site from the site hierarchy, you should first try to remove it by using SMS Administrator console. If this approach fails for any reason, use the /deinstall command.

/deljob:sitecode

Deletes all jobs, or commands, that are targeted to the specified site. The sitecode parameter specifies the site to remove jobs for.

/delsite: {sitecode, parentsite}

Deletes incorrectly removed sites from the SMS site database at the parent site. Use this option if you removed a site before you detached it from its parent site. Note that the braces are required.

The sitecode parameter specifies the site to delete; parentsite is the SMS site code of the parent site of the site you are deleting. When you specify parentsite, this parameter prevents the unwanted deletion of a site that was previously relocated under a different parent site in another part of the site tree. For example, typing preinst /delsite:{chl,par} deletes site CHL only if it has a parent site of PAR. This transaction propagates up the site hierarchy to all parent sites of the current site.

---

Note   This command does not remove the target site. It only removes the site and its SMS domains from the local SMS site database and propagates the change up the site hierarchy.

---

/dump

Writes site control images for all sites to the SMS\Site.srv\Sitecfg.box directory. (An image is a binary representation of the site control file, which is stored in the SMS site database.)

/stopsite

Stops all the SMS services at the site.

/syncchild:sitecode

Synchronizes a child site with the parent site. The sitecode parameter specifies the site to synchronize with.

/syncparent

Forces all site control images in the SMS site database to simultaneously propagate up to the parent site of the current site and all its subsites or child sites. Use this option when sites are out of synchronization due to time lags or other failures.

/upgrade:{sitecode}

Selectively upgrades a specific secondary site. The sitecode parameter specifies the site to upgrade. If a global upgrade fails to upgrade all secondary sites, use this option to upgrade the failed sites. Note that the braces are required.