Page Comparison

Introduction

The steps to install the USAS and/or USPS SIF Agent on a Windows server are described in this chapter.  It may be necessary to run some of the steps "As Administrator".

The Ohio SOAP USAS and USPS Agents will be shipped as a separate zip filefiles. When  When the files are extracted, they should be placed in a separate folder for each agent and version. It is recommended that they extracted into a directory including the version number of the agent. For example: C:\SIFAgents\USPS-SIF-2-0-0To install the agent, follow this steps:also recommended that the Agent(s) be installed as a Windows Service.

Upgrading

• If a previous version of the Agent is running, stop the current running Agent prior to completing the installation steps
• If the previous version of the Agent was installed as a Windows Service, uninstall the Service

  • The service name may be found by double clicking on the Service in "Services" and look at "Service Name"

    Code Block
    language bash
    sc delete {servicename}

    
    

• SSDT recommends you install into a clean directory for each version of the Agent. Installing into a clean directory ensures that obsolete files do not remain from a prior version and allow you to revert to an earlier version if necessary.

Download and Unpack the Kit

1. Create a directory to contain the new USAS or USPS agent using a pattern such as USxS-SIF-n-n-n. It is common practice to place the version specific agent . For directory inside a directory named /SIFAgents.  For example: C:\SIFAgents\usps-sif-2-soap-n.n.n.0-2
2. Download the kit from SSDT download web site (as described in the Release page) and place it in the new directory
3. Unzip the kit
4. If upgrading from a previous version, copy the agent.cfg file from the previous install directory into the new directory. This will preserve zone and SOAP settings from the earlier configuration.
5. It is recommended that a shared keystore (Configuring Agent SSL keys) be used. If a shared keystore has not been setup, it will also be necessary to copy the Trusted.ks and agent.ks files from the previous install directory into the new directory.

6. From a command prompt, launch the agent standalone:

   Code Block
   language bash
   > cd C:\SIFAgents\{installdirectory} > java -jar RunAgentStandalone.jar

   
   

7. If the agent starts without

...

1. error,

...

1. press CTRL-C to terminate the agent

...

2. Install the agent as a service, type the following in a command line prompt:

   Code Block
   language bash
   > USPS.exe --install > USAS.exe --install

   
   

Running the Agent Console GUI

...

To execute the Agent Console, do:

$ cd C:\SIFAgents\{agent_install}
$ java -jar RunConsole.jar

...