Skip to main content

Obtaining and Installing the AMPS C#/.NET Client

Obtaining the Client​

You must first download and install the client on your development computer. This can be accomplished through any of the following methods:

Use the AMPS Client executable installer

For this option, download the amps-csharp-client-<version>.exe, where <version> is replaced by the version of the client (such as amps-csharp-client-3.3.0.exe). Double-click the *.exe file to launch the installation wizard. Once the installation completes, you will be able to find the installed client under your computer's Program Files directory, in a subdirectory entitled AMPS.

Unpack the AMPS Client zip file

For this option, download the amps-csharp-client-<version>.zip file from the 60East Technologies website or copy it from the AMPS server installation directory. Save the zip file to your development computer. Right-click the amps-csharp-client.zip file, and choose Extract to extract the contents of the zip file. You're welcome to extract the AMPS client to wherever suits your needs; we'll refer to that directory as the AMPS directory for the remainder of this guide.

Use nuget to install the client

For this option, use nuget to install the AMPS.Client package. This option provides less control over the installation, and does not include the source code for the client, samples, or documentation, which makes it a less-preferable option for many installations.

The documentation for the client is available in the AMPS.Docs package. The AMPS.Docs package includes only documentation, and is intended for use at sites with policies that do not allow download of archives from the 60East website.

Test Connectivity to AMPS​

Before writing programs using AMPS, make sure connectivity to an AMPS server from this computer is working. Launch a terminal window and change the directory to the AMPS directory in your AMPS installation, and use spark to test connectivity to your server, for example:

./bin/spark ping -type fix -server 192.168.1.2:9004

If you receive an error message, verify that your AMPS server is up and running, and work with your systems administrator to determine the cause of the connectivity issues. Without connectivity to AMPS, you will be unable to make the best use of this guide.