![](media/image1.png){width="5.999305555555556in"
height="3.7493055555555554in"}

**Customer Service Toolkit**

**Service Pack 2 Installation Guide**

**Version 1.1**

January 5, 2006

+--------------------+-------------------------------------------------+
| ![](media/imag     | Natural Resources Conservation Service          |
| e2.png){width="3.7 |                                                 |
| 888888888888888in" | Information Technology Center                   |
| height="0.53       |                                                 |
| 61111111111111in"} | Fort Collins, Colorado                          |
|                    |                                                 |
|                    | http://www.itc.nrcs.usda.gov/                   |
+--------------------+-------------------------------------------------+

Version 1.1

Date last modified 1/5/06

Microsoft, Access, Excel, and WordPad are either registered trademarks\
or trademarks of Microsoft Corporation in the United States and/or other
countries.

Adobe and Acrobat are registered trademarks of Adobe Systems
Incorporated.

ArcGIS and ESRI are registered trademarks of Environmental Systems
Research Institute, Inc.

The U.S. Department of Agriculture (USDA) prohibits discrimination\
in all its programs and activities on the basis of race, color, national
origin, gender, religion,\
age, disability, political beliefs, sexual orientation, or marital or
family status. (Not all prohibited bases\
apply to all programs.) Persons with disabilities who require
alternative means for communication\
of program information (Braille, large print, audiotape, etc.) should
contact USDA's TARGET Center\
at 202-720-2600 (voice and TDD). To file a complaint of discrimination,
write USDA, Director,\
Office of Civil Rights, Room 326W, Whitten Building, 14th and
Independence Avenue, SW,\
Washington, DC 20250-9410, or call (202) 720-5964 (voice and TDD).\
USDA is an equal opportunity provider and employer.

[]{#__RefHeading___Toc124139191 .anchor}Revision History

  ------------- ----------------- ------------------------------------------
  **Version**   **Document Date** **Change Summary**

  1.0           January 4, 2006   Initial release of the Toolkit Service
                                  Pack 2 Installation Guide.

  1.1           January 5, 2006   Minor editorial changes to Section 3.
  ------------- ----------------- ------------------------------------------

[]{#__RefHeading___Toc124139192 .anchor}Scope

This document contains installation instructions for Customer Service
Toolkit 5.2 Service Pack 2. Information on installing Toolkit Utilities
(Export Layout Utility and Toolkit APR Utility), installing Check In
Wizard Version 1.0, installing Soil Data Viewer, preparing for
installation, registering endpoints, and setting up Toolkit permissions
for users, is provided in the current version of the *Customer Service
Toolkit Installation Guide* (available on the Toolkit Web site).

[]{#__RefHeading___Toc124139193 .anchor}Technical Support

**Contacts**

For assistance in installing Toolkit, send email to
ToolkitSupport@ftc.usda.gov, or contact the ITS Help Desk at
1-888-311-1444, or https://merlin.sc.egov.usda.gov/magicsshd/.

**Toolkit Online Help**

**Toolkit Online Help** is available to Toolkit users at all times at
the following Web site, regardless of whether Toolkit is running:
**http://cst.nrcs.usda.gov/Toolkit/Help/.** Alternatively, users may
access **Toolkit** **Online Help** by clicking **Help**  Contents in
Toolkit.

Hundreds of help topics are included in **Toolkit** **Online Help**,
which features an easy-to-browse index and a comprehensive search tool.
Simply type in a keyword or phrase in the Search field (and depress
Enter) to generate a list of Toolkit help pages related to that topic.
To navigate to a specific Help page, click on a topic title listed in
the left-hand frame.

**Online Troubleshooting Guide**

The latest Toolkit Troubleshooting information is available online at
the following Web site:
**http://www.itc.nrcs.usda.gov/Toolkit/Troubleshooting/troubleshooting.htm**.

**Toolkit Web Site**

For the latest information on Toolkit, visit the Toolkit Web site at:

-   **http://www.itc.nrcs.usda.gov/toolkit/**

In addition to Frequently Asked Questions, training resources, and
installation information, the Toolkit user guides, release notes, and
tech notes are available for download from the Training and Support
page. Helpful Hints developed by Toolkit Coordinators, trainers, and
users can be found on the Community page.

Table of Contents

[Revision History iii](#__RefHeading___Toc124139191)

[Scope iii](#__RefHeading___Toc124139192)

[Technical Support iii](#__RefHeading___Toc124139193)

[1. Toolkit Service Pack Installation
1](#toolkit-service-pack-installation)

[1.1. Team Effort 1](#team-effort)

[1.2. Silent Installation 1](#silent-installation)

[1.3. Interactive Installation 2](#interactive-installation)

[2. ITS System Administrator Responsibilities
2](#its-system-administrator-responsibilities)

[2.1. Download Toolkit Service Pack 2](#download-toolkit-service-pack)

[2.1.1. Position Files for Installation
3](#position-files-for-installation)

[2.1.2. Position Files on a Workstation Hard Drive, CD Drive, or USB
Drive
7](#position-files-on-a-workstation-hard-drive-cd-drive-or-usb-drive)

[2.2. Install Toolkit Service Pack 2 on a Workstation
8](#install-toolkit-service-pack-2-on-a-workstation)

[2.2.1. Silent Installation from the Server
8](#silent-installation-from-the-server)

[2.2.2. Silent Installation from the Workstation Hard Drive, CD Drive,
or USB Drive
10](#silent-installation-from-the-workstation-hard-drive-cd-drive-or-usb-drive)

[2.2.3. Interactive Installation 11](#interactive-installation-1)

[2.2.4. Manually Remove Toolkit 11](#manually-remove-toolkit)

[2.2.5. Interactive Installation Instructions
12](#interactive-installation-instructions)

[2.3. Verify Toolkit Installation 15](#verify-toolkit-installation)

[2.3.1. Verify Toolkit Installation is Complete
15](#verify-toolkit-installation-is-complete)

[2.3.2. Verify Permissions to C:\\Customer_Files_Toolkit
16](#verify-permissions-to-ccustomer_files_toolkit)

[2.4. Reinstall Toolkit Service Pack
17](#reinstall-toolkit-service-pack)

[2.4.1. Check In Customer Files before Reinstalling Toolkit Service Pack
17](#check-in-customer-files-before-reinstalling-toolkit-service-pack)

[2.4.2. Manually Remove Toolkit 17](#manually-remove-toolkit-1)

[2.4.3. Reinstall Toolkit Service Pack
17](#reinstall-toolkit-service-pack-1)

[3. Toolkit User Responsibilities 18](#toolkit-user-responsibilities)

[3.1. Reset Toolkit GIS User Level to Advanced
18](#reset-toolkit-gis-user-level-to-advanced)

[3.2. Save Toolkit Preferences 18](#save-toolkit-preferences)

# Toolkit Service Pack Installation

The Toolkit 5.2 Client - Service Pack 2 installation package contains
files for installing Toolkit 5.2 SP-2, Check In Wizard v1.0, and Toolkit
Utilities.

## Team Effort

Installing Toolkit requires a team effort by ITS System Administrators,
State Toolkit Coordinators, State GIS Coordinators, and Local Field
Office Staff. More information on the specific responsibilities of
Toolkit/GIS Coordinators and ITS System Administrators for
[initially]{.underline} installing Toolkit is provided in the *Toolkit
Installation Guide v1.9*, Sections 2 and 3, at
[www.itc.nrcs.usda.gov/toolkit/training.htm#User_Documentation](http://www.itc.nrcs.usda.gov/toolkit/training.htm#User_Documentation).
Subsequent installation of a Toolkit Service Pack to update an existing
Toolkit installation is a simpler process, as described in this
document.

## Silent Installation

The Toolkit 5.2 SP-2 installation package is intended to run as a
[silent installation]{.underline}. A silent installation requires that
the previous build of Toolkit 5.1 SP-1 or build 66 is installed on the
workstation. If it is not, you will need to perform an interactive
installation according to the instructions in this document. See Section
1.3, "Interactive Installation" for other cases that require an
interactive installation rather than a silent installation.

Silent installation differs from interactive installation in that it is
intended to upgrade the workstation from a previous build to a new
build, without modifying the original **type of installation** (i.e.,
**production** or **training**). Consequently, a workstation previously
configured for training will remain configured for training after the
silent installation.

**Note:** In order to change the type of installation (i.e.,
**production** or **training**) on a given workstation, you will need
to: (1) uninstall the version of Toolkit that currently resides on that
workstation, and (2) complete the interactive installation of Toolkit
according to the instructions in this document.

Some of the features of a silent installation are as follows:

-   Automatically uninstalls the previous build of Toolkit 5.1 SP-1 or
    build 66.

-   Suppresses interactive user interface screens which the
    InstallShield Wizard displays during an interactive installation.

-   Does not suppress errors. If an error occurs during installation, it
    will be displayed and the installation will stop.

-   Displays the InstallShield logo in the Taskbar to indicate the
    installation is running. When this logo disappears, the installation
    is complete.

-   Uses the configuration file from the previous Toolkit 5.1 SP-1 build
    or build 66 installation. If the previous installation was for
    **production**, the silent installation will be for **production**.
    If the previous installation was for training, the silent
    installation will be for training.

-   Only silently installs over the previous Toolkit 5.1 SP-1 or build
    66 installation. It will not silently install over SP-2 after SP-2
    was successfully installed. In this case, run the interactive
    installation.

## Interactive Installation

The following cases require an interactive installation rather than a
silent installation. Use an interactive installation:

-   If installing on a workstation that connects to the USDA network via
    a VPN Connection.

-   If problems were encountered previously when installing Toolkit SP-1
    on a particular workstation.

-   To change the type of installation on a given workstation. For
    example, if you want to change a workstation that was previously
    configured for **training** to be configured for use in
    **production**.

-   If Toolkit Build 63, 64, or 65 is currently installed.

-   To reinstall SP-2, if SP-2 is currently installed.

    For these cases: (1) manually uninstall Toolkit, and (2) complete
    the interactive installation of Toolkit SP-2 according to the
    instructions in Section 2.2.3. Contact ToolkitSupport@ftc.usda.gov
    for assistance if the uninstall of the previous Toolkit build does
    not work properly.

**Note:** If you are installing Toolkit in the AGLO domain, please
contact ToolkitSupport@ftc.usda.gov for specific instructions and
assistance.

# ITS System Administrator Responsibilities

Installing Toolkit is a multi-step process to be completed by ITS System
Administrators. Installation tasks include:

-   **Download** Toolkit Service Pack (Section 2.1)

-   **Install** Toolkit Service Pack on a workstation (Section 2.2)

-   **Verify** that the installation completed successfully (Section
    2.3)

## Download Toolkit Service Pack

This section contains instructions for downloading the Customer Service
Toolkit software.

1.  Log on to the client machine.

```{=html}
<!-- -->
```
1.  Using Internet Explorer, access the ITS Team Services Web site.

-   **http://century.itc.nrcs.usda.gov/cce-states/Default.htm**

2.  Log on using your userid and password.

3.  Click on **Supplemental Applications and Instructions** on the left
    menu to access the software download page.

4.  Find the item "**CSToolkitV05.02.01.xxx_PKG.zip**" located in this
    list,\
    where **xxx** is the build number for Toolkit (e.g.,
    **CSToolkitV05.02.01.035_PKG.zip**).

5.  Click on **CSToolkitV05.02.01.xxx_PKG.zip**.

6.  Click on **Save**.

7.  Browse to the **C:\\temp** folder and click on **Save**.

8.  Once the download has completed, click on **Close**.

9.  Close the Internet Explorer window.

10. Click on **Start \> Run \> Browse** to **C:\\temp**.

11. Change "**Files of Type:**" to **All Files** to view all files.

12. Select **CSToolkitV05.02.01.xxx_PKG.zip** and then click **Open**.

13. Click **OK**. The WinZip window will appear.

14. Click on the **Extract** icon.

15. In the Extract dialog window, check that **Extract to:** is set to
    **C:\\temp**.\
    (If not, change to **C:\\temp**.)

16. Click **Extract**.

17. Wait for the file extraction to complete.

18. Close the WinZip window.

### Position Files for Installation

To prepare for installation, the Toolkit installation package can be
placed on the server, or if your work site has no server, on the
workstation hard drive, CD, or USB Device. The steps for positioning
files for server-based installation are provided below. These
instructions assume that you have downloaded the Toolkit Software as
detailed at the beginning of Section 2.1.

If you have a server at your location and plan to perform server-based
installation of the software, the instructions for mapping a drive to a
server will only need to be performed one time (as the software will be
available on the server, where it can be used for all installations on
client machines that have access to that server).

If you are installing the software at a work site that does not have a
server, proceed to Section 2.1.2.

Map Drive to Server

To map a drive on the client machine to a server, follow these
instructions.

1.  Click on **Start** \> **All Programs** \> **Administrative Tools**
    \> **IEAdmin**.

```{=html}
<!-- -->
```
19. Click on **The following user:** radio button and enter your
    **domain administrative account** and **password** then click
    **OK**.

![](media/image3.png){width="2.9916666666666667in"
height="2.452777777777778in"}

20. An Internet Explorer (IE) window will open. In the "**Address**"
    field, type: **c:\\temp**, then press **\<Enter\>**.

![](media/image4.png){width="5.241666666666666in"
height="2.782638888888889in"}

> Example IE window displaying files that reside in C:\\temp. The
> specific files listed in\
> this window will vary between client machines.

21. When the following window appears, click on **Tools** \> **Map
    Network Drive**.

22. Select **Z:** for the drive letter and type:
    **\\\\Server\\workstation** for the folder location, *where*
    **Server** *is either the Server IP or Server Name*. Make sure there
    is **[no]{.underline}** check mark next to **Reconnect at Logon**,
    then click on **Finish**.

![](media/image5.png){width="3.501388888888889in"
height="2.5805555555555557in"}

23. The drive is now mapped to the server on which the Supplemental
    Applications reside.

Extract Application Files to the Server

Follow the instructions below to extract the Toolkit software (including
Check In Wizard and Toolkit Utilities) to the XP directory of the
server.

1.  With the Internet Explorer window open and showing the **C:\\temp**
    folder in the "Location" field, locate and double-click on
    **CSToolkitV05.02.01.xxx_Setup.cmd**.

```{=html}
<!-- -->
```
24. A Command window should open, followed by a WinZip window.

25. If the following message appears to inform that no packages were
    found, click **OK**.

![](media/image6.png){width="3.579861111111111in"
height="1.1104166666666666in"}

26. In the WinZip window, click on **Extract**.

27. Change the "**Extract to:**" field to **Z:\\**.

![](media/image7.png){width="4.125694444444444in"
height="2.3652777777777776in"}

28. Click on **Extract** to initiate the extraction of files to the
    server.

29. Wait until the file extraction completes. Close the WinZip window.

30. In the Command window, you will see "Press any key to continue..."
    Press **\<Enter\>** to close the screen.

![](media/image8.png){width="4.118055555555555in"
height="1.1965277777777779in"}

**Note:** If any errors occurred during the extraction process, an error
message describing the issue will be displayed in the Command window.

31. In the Internet Explorer window showing the **C:\\temp** folder,
    click on\
    **Tools \> Disconnect Network Drive**.

32. Select the **Z:\\** drive and click **OK**.

33. Close the Internet Explorer window.

The necessary files for installing Toolkit 5.2, the Check In Wizard, and
the Toolkit Utilities are now staged on the server in the folder:

> **Z:\\XP\\NRCS\\CustomerServiceToolkit\\Client\\V05.02.01.xxx\\**

Proceed to Section 2.2 to install Toolkit Service Pack 2 on a
workstation.

### Position Files on a Workstation Hard Drive, CD Drive, or USB Drive

If it is not possible to perform server-based installations at your
location, Toolkit can be installed from a local storage device, such as
workstation hard drive, CD drive, or USB device.

**Note:** If you performed the instructions in Section 2.1.1 to prepare
for server-based installation of Toolkit, you do not need to complete
this section. Proceed to Section 2.2.

Extract Application Files to a Location Other than the Server

Follow the instructions below to extract the Toolkit installation
package to a local storage device.

1.  Click on **Start \> Run**.

```{=html}
<!-- -->
```
34. **Browse** to **C:\\temp** then change "**Files of Type:**" to **All
    Files** to view all files.

35. Select **CSToolkitV05.02.01.xxx.zip** and click **Open**.

36. Click **OK**.

37. A WinZip window will open.

38. In the WinZip window, click on **Extract**.

39. In the WinZip window, for a Workstation Hard Drive Installation, set
    the "Extract to:" field to **C:\\temp**. For a CD-RW drive, set the
    "Extract to:" field to **\[drive letter\]:\\** of the CD-RW drive.
    For USB Device installation, set the "Extract to:" field to
    **\[drive letter\]**:\\ of the Removable Disk.

40. Click **Extract** to initiate the extraction of files.

41. Wait until the WinZip completes the extraction of files.

42. Close the WinZip window.

The necessary files for installing Toolkit 5.2, the Check In Wizard, and
the Toolkit Utilities are now staged on the local storage device in the
folder:

> **\[Path\]\\XP\\NRCS\\CustomerServiceToolkit\\Client\\V05.02.01.xxx\\**

**Note:** **\[Path\]** is the location (i.e., C:\\temp, CD-RW drive, or
USB drive) that you selected in step 7. **\[Path\]**
[cannot]{.underline} have embedded spaces (e.g., D:\\my folder).

Proceed to Section 2.2 to install Toolkit Service Pack 2 on a
workstation.

## Install Toolkit Service Pack 2 on a Workstation

The ITS System Administrator installs Toolkit on the target workstations
and laptops at each office location. On the client machine, Toolkit will
be installed in C:\\Program Files\\USDA\\Toolkit5\\ for each user.

Select one of two available methods of silent installation (i.e., from a
server or from a drive on a local workstation)

-   **From a server** -- Section 2.2.1 will guide you through a
    server-based installation. The instructions assume that you will use
    drive **Z:\\** and that it is mapped to the Server's
    **G:\\workstation** folder before you continue.

-   **From the local workstation hard drive, CD drive, or USB drive** --
    The instructions in Section 2.2.2 assume that you do not have a
    server and will be installing the application from a local storage
    device, including a RW-CD drive, USB drive, or a local drive and
    folder (e.g., C:\\temp).

**Note:** We recommend the server-based installation for offices that
will be installing Toolkit on numerous client machines.

If one of the following conditions exist, you must perform an
interactive installation as described in Section 2.2.3.

-   **No Build Exists** -- If no build is detected on the workstation,
    an interactive installation will be initiated.

-   **Incompatible Build Exists** -- If an incompatible build is
    detected on the workstation, then an error message will be
    displayed, you must manually remove the incompatible build and
    complete the interactive installation.

-   **Current Build Exists** -- If the current build Toolkit 5.2 SP-2
    has already been installed on the workstation, you must manually
    remove the current build and complete the interactive installation.

-   **VPN Connection** -- If you are installing on a workstation that
    connects to the USDA network via a VPN Connection, you must manually
    remove Toolkit and complete the interactive installation.

### Silent Installation from the Server

1.  Log in to the workstation with an account that has **administrative
    privileges** to complete these tasks, if you're not already logged
    on with these privileges.

**Note:** If you have already mapped the **Z:** drive to the server
(step 2.1.1), you'll need to open Explorer (right-click **Start**, click
**Explore**) and skip ahead to step 5.

43. Right-click on **My Computer**, then click on **Map Network Drive**.

44. Select **Z:** for the drive letter and type:
    **\\\\Server\\workstation** for the folder location, *where*
    **Server** *is either the Server IP or Server Name*.

![](media/image5.png){width="3.2777777777777777in"
height="2.4055555555555554in"}

45. Make sure there is **[no]{.underline}** check mark next to
    **Reconnect at Logon**, then click on **Finish**. You now have a
    drive mapped to the Server where the Supplemental Applications
    reside.

46. Click on **Start \> Run**.

47. **Browse** to or type in:\
    **Z:\\XP\\NRCS\\CustomerServiceToolkit\\Client\\V05.02.01.xxx**

48. Select **install.cmd**, click **Open**, and then click **OK**.

49. A DOS window will appear and run several scripts automatically.

![](media/image9.png){width="4.933333333333334in"
height="2.4993055555555554in"}

> The Toolkit service pack installation will check for the existence of
> a Toolkit build on the workstation to determine whether it can proceed
> with a silent installation. If the previous Toolkit build is installed
> on the workstation, a [silent installation]{.underline} will start
> automatically.

50. Wait for the silent installation to complete. Upon completion, the
    DOS window closes. Proceed to Section 2.3 to verify that the Toolkit
    installation was successful.

**Note:** If an error occurs and a message is displayed, proceed as
follows.

-   If a silent installation cannot be completed because of an existing
    incompatible build, a message will appear to "Please uninstall the
    existing version of Toolkit 5.0 and then install the new version."
    Click **OK** to dismiss the message. Click **Finish** on the window
    "Toolkit 5.2 Client -- Service Pack 2 Uninstall Has Been Stopped."
    Go to Section 2.2.3 to complete an [interactive
    installation]{.underline}.

-   If a silent installation cannot be completed because you are
    installing on a workstation that connects to the USDA network via a
    VPN Connection, a Toolkit 5.0 Installation Error will appear stating
    that Toolkit cannot be installed silently without a valid domain
    present. Close the WordPad window. Go to Section 2.2.3 to complete
    an [interactive installation]{.underline}.

-   If an error occurs and a different message is displayed, click
    **OK** and **Finish** to exit the installation. Contact the Help
    Desk for assistance.

### Silent Installation from the Workstation Hard Drive, CD Drive, or USB Drive

If you performed the steps in Section 2.1.2, you will use the
instructions in this section to install Toolkit 5.2 SP-2 on the various
client machines. To install Toolkit from a local storage device:

1.  Log in with an account that has administrative privileges to
    complete these tasks.

```{=html}
<!-- -->
```
51. Click **Start \> Run**.

52. **Browse** to or type in:\
    **\[Path\]\\XP\\NRCS\\CustomerServiceToolkit\\Client\\V05.02.01.xxx**

**Note:** **\[Path\]** is the location (i.e., C:\\temp, CD drive, or USB
drive) you selected in Section 2.1.2. **\[Path\]** [cannot]{.underline}
have embedded spaces (e.g., D:\\my folder).

53. Select **install.cmd**, click **Open**, and then click **OK**.

![](media/image9.png){width="4.933333333333334in"
height="2.4993055555555554in"}

> The Toolkit service pack installation will check for the existence of
> a Toolkit build on the workstation to determine whether it can proceed
> with a silent installation. If the previous Toolkit build is installed
> on the workstation, a [silent installation]{.underline} will start
> automatically.

54. Wait for the silent installation to complete. Upon completion, the
    DOS window closes. Proceed to Section 2.3 to verify that the Toolkit
    installation was successful.

**Note:** If an error occurs and a message is displayed, proceed as
follows.

-   If a silent installation cannot be completed because of an existing
    incompatible build, a message will appear to "Please uninstall the
    existing version of Toolkit 5.0 and then install the new version."
    Click **OK** to dismiss the message. Click **Finish** on the window
    "Toolkit 5.2 Client -- Service Pack 2 Uninstall Has Been Stopped."
    Go to Section 2.2.3 to complete an [interactive
    installation]{.underline}.

-   If a silent installation cannot be completed because you are
    installing on a workstation that connects to the USDA network via a
    VPN Connection, a Toolkit 5.0 Installation Error will appear stating
    that Toolkit cannot be installed silently without a valid domain
    present. Close the WordPad window. Go to Section 2.2.3 to complete
    an [interactive installation]{.underline}.

-   If an error occurs and a different message is displayed, click
    **OK** and **Finish** to exit the installation. Contact the Help
    Desk for assistance.

### Interactive Installation

For those cases that require an interactive installation of Toolkit
SP-2: (1) manually uninstall Toolkit, and (2) complete the interactive
installation according to the instructions below.

### Manually Remove Toolkit

When interactively installing the Toolkit Service Pack, the existing
version of Toolkit should be removed from the workstation. To remove
Toolkit manually, follow these instructions:

1.  Log on to the workstation with an account that has administrative
    privileges if not already logged on with these privileges.

```{=html}
<!-- -->
```
55. Close all Windows applications.

56. Click on **Start \>Control Panel \> Add or Remove Programs**.

57. Find and select Toolkit in the list of software.

![](media/image10.png){width="5.021527777777778in"
height="0.7486111111111111in"}

58. Click the **Change/Remove** button.

59. When the following dialog window appears, click **OK** to uninstall.

![](media/image11.png){width="3.511111111111111in"
height="0.8298611111111112in"}

60. Click **Finish** and close the **Add or Remove Programs** window.

**Note:** Do [not]{.underline} uninstall the ESRI Hot Fix (listed as
'NRCS ESRI QFE-DT-83-CQ00261837 ArcGIS SP3 patch') from the workstation.
By design, the ArcGIS hot fix will not be uninstalled if Toolkit is
removed from the workstation.

### Interactive Installation Instructions

1.  Click **Start \> Run** then **Browse** or type in:\
    **\[Path\]\\XP\\NRCS\\CustomerServiceToolkit\\Client\\V05.02.01.xxx**

**Note:** **\[Path\]** is the location of your unzipped files that will
be **Z:** when installing from the server. When installing from the
workstation it will be the pathname of the local storage device (i.e.,
C:\\temp, RW-CD drive letter, or USB drive letter).

61. Select **install.cmd** and click **Open**. Click **OK**.

62. A DOS window will appear and run several scripts automatically.

![](media/image9.png){width="4.870833333333334in"
height="2.4604166666666667in"}

63. When the Toolkit 5.2 Client -- Service Pack - InstallShield Wizard
    dialog window is displayed, click **Next**.

![](media/image12.png){width="4.220138888888889in"
height="3.1694444444444443in"}

**Note:** If instead, the following "USDA Domain not found" dialog
window appears, your workstation is connected over a Virtual Private
Network (VPN). Select the appropriate USDA domain (AGEAST, AGCENTRAL, or
AGWEST) and click **Next**.

![](media/image13.png){width="4.199305555555555in"
height="3.161111111111111in"}

**Note:** If you are installing Toolkit in the AGLO domain, please
contact ToolkitSupport@ftc.usda.gov for specific instructions and
assistance.

64. When the following dialog window appears, select either **Training
    Installation** or **Production Installation** as your setup type and
    click **Next**.

![](media/image14.png){width="4.199305555555555in"
height="3.161111111111111in"}

65. Wait for the installation to finish.

66. The wizard will display a message confirming that the installation
    completed. Click **Finish** to exit.

![](media/image15.png){width="4.199305555555555in"
height="3.1534722222222222in"}

**Note:** If an error occurs, a message is displayed. Click **OK** and
**Finish** to exit. Contact the help desk for assistance.

Proceed to Section 2.3 to verify that the Toolkit installation was
successful.

## Verify Toolkit Installation

The following will provide verification that Toolkit was successfully
installed.

### Verify Toolkit Installation is Complete

Verify that the installation completed successfully by starting Toolkit
SP-2.

1.  Log in with an account that has **administrative privileges** to
    complete these tasks, if you're not already logged on with these
    privileges.

```{=html}
<!-- -->
```
67. Click on **Start \> All Programs \> Customer Service Toolkit \>
    Toolkit**.

68. In the Toolkit menu bar, click on **Help \> About Customer Service
    Toolkit** to display the following information window.

![](media/image16.png){width="4.197916666666667in"
height="4.2652777777777775in"}

69. Verify that "**Version: 5.2 SP-2**" is displayed, indicating that
    the installation completed successfully.

70. If "v**ersion missing**" appears instead of "**5.2 SP-2**," then the
    installation did not complete successfully. Contact
    <ToolkitSupport@ftc.usda.gov> for assistance.

### Verify Permissions to C:\\Customer_Files_Toolkit

There have been instances where read/write permissions (required for
Toolkit data check-in) were removed from C:\\Customer_Files_Toolkit
after installing "ITS Windows XP Update2" on a Toolkit workstation. If
"ITS Windows XP Update2" is being installed along with Toolkit SP-2,
verify that users have read/write permissions on the
C:\\Customer_Files_Toolkit folder following the updates. Insufficient
permissions on this folder will likely result in loss of customer data
during data check-in/check-out.

Return to the appropriate section to continue installing Toolkit on
additional workstations:

-   Section 2.2.1 for silent server-based installation

-   Section 2.2.2 for silent workstation-based installation

-   Section 2.2.3 for interactive installation

## Reinstall Toolkit Service Pack

This section provides instructions for reinstalling the Toolkit Service
Pack SP-2.

### Check In Customer Files before Reinstalling Toolkit Service Pack

**Note:** It is a recommended practice for Toolkit users to check in
customer files on a regular basis. Some users routinely check in their
customer files each day. Such a procedure helps prevent accidental loss
of data due to hardware failure. By checking in the customer files, the
latest work is saved to the NCPDB.

If the user is available when the ITS System Administrator is ready to
reinstall the Toolkit Service Pack, we recommend that the user check in
all customer files before the software is reinstalled. However, this is
[not]{.underline} a requirement; the installation package allows Toolkit
to be installed with customer files checked out. When the reinstallation
is complete, the customer files will still show as being checked out.

### Manually Remove Toolkit

When reinstalling the Toolkit Service Pack, the existing version of
Toolkit should be removed from the workstation. To remove Toolkit
manually, follow these instructions:

1.  Log on to the workstation with an account that has administrative
    privileges.

```{=html}
<!-- -->
```
71. Close all Windows applications.

72. Click the **Start \> Control Panel \> Add/Remove Programs**.

73. Find and select Toolkit in the list of software.

![](media/image10.png){width="5.021527777777778in"
height="0.7486111111111111in"}

74. Click the **Change/Remove** button.

75. When the following dialog window appears, click **OK** to uninstall.

![](media/image11.png){width="3.511111111111111in"
height="0.8298611111111112in"}

**Note:** Do [not]{.underline} uninstall the ESRI Hot Fix (listed as
'NRCS ESRI QFE-DT-83-CQ00261837 ArcGIS SP3 patch') from the workstation.
By design, the ArcGIS hot fix will not be uninstalled if Toolkit is
removed from the workstation.

### Reinstall Toolkit Service Pack

Repeat the instructions for installing the Toolkit Service Pack provided
in Sections 2.2.

# Toolkit User Responsibilities

Installing a Toolkit Service Pack resets specific user preferences. The
first time that Toolkit is run after a Toolkit Service Pack is
installed, the user should open Toolkit Preferences to review, revise,
and save the settings.

## Reset Toolkit GIS User Level to Advanced

The Toolkit installation package writes over the **normal.mxt** that
exists in the user's account with the **normal.mxt** template for a
"Basic" GIS user. Thus, installing SP-2 automatically will reset the
**Toolkit GIS user level** from "Advanced" to "Basic."

To reset the GIS preferences, the advanced user should run Toolkit
Preferences and reset the **Toolkit GIS User Level** to "Advanced."
After the preferences are saved, the normal.mxt template for a "Basic"
GIS user will be replaced with the normal.mxt template for an "Advanced"
GIS user in the user's account.

## Save Toolkit Preferences

A user can save the preferences settings by clicking on the Preferences
menu and selecting **Save All**.