Chat with us, powered by LiveChat
arrow_back_ios

Main Menu

See All Acoustic End-of-Line Test Systems See All DAQ and instruments See All Electroacoustic application See All Software See All Transducers See All Vibration Testing Equipment See All Electroacousticsb - OLD unpublished See All Academy See All Resource Center See All Services See All Support See All Applications See All Industries See All Our Business
arrow_back_ios

Main Menu

See All Actuators See All Combustion Engines See All Durability See All eDrive See All Transmission Gearboxes See All Turbo Charger See All DAQ systems See All High precision and calibration systems See All Industrial electronics See All Power Analyser See All S&V Handheld devices See All S&V Signal conditioner See All Accessories for electroacoustic application See All DAQ See All Drivers API See All nCode - Durability and Fatigue Analysis See All ReliaSoft - Reliability Analysis and Management See All Test Data Management See All Utility See All Vibration Control See All Acoustic See All Current / voltage See All Displacement See All Load cells See All Pressure See All Strain Gauges See All Torque See All Vibration See All Temperature See All LDS Shaker Systems See All Power Amplifiers See All Vibration Controllers See All Accessories for modal exciters See All Test Solutions See All Training Courses See All Primers and Handbooks See All Calibration See All Installation, Maintenance & Repair See All Support Brüel & Kjær See All Acoustics See All Asset & Process Monitoring See All Electric Power See All NVH See All OEM Custom Sensors See All Structural Integrity See All Vibration See All Automotive & Ground Transportation See All Business Ethics
arrow_back_ios

Main Menu

See All CANHEAD See All GenHS See All LAN-XI See All MGCplus See All Optical Interrogators See All QuantumX See All SomatXR See All Fusion-LN See All Accessories for industrial electronics See All Handheld Software See All Accessories for S&V handheld devices See All BK Connect / PULSE See All API See All Microphone sets See All Microphone Cartridges See All Acoustic calibrators See All Special microphones See All Microphone Pre-amplifiers See All Sound Sources See All Accessories for acoustic transducers See All Experimental testing See All Transducer Manufacturing (OEM) See All Accessories for strain gauges See All Non-rotating (calibration) See All Rotating See All CCLD (IEPE) accelerometer See All Charge accelerometer See All Impulse hammers / impedance heads See All Cables See All Accessories See All Calibration Services for Transducers See All Calibration Services for Handheld Instruments See All Calibration Services for Instruments & DAQ See All Resources See All Electroacoustics See All Environmental Noise See All Noise Source Identification See All Product Noise See All Sound Power and Sound Pressure See All Vehicle Pass-by Noise See All Production Testing and Quality Assurance See All Machine Analysis and Diagnostics See All Structural Health Monitoring See All High Voltage See All OEM Sensors for the Agriculture Industry See All OEM Sensors for Robotics and Torque Applications See All Structural Dynamics See All Material Properties Testing

ReliaSoft API Ante Service

 

The ReliaSoft API is installed with your ReliaSoft desktop applications. If you plan to run the API on a Windows desktop environment, no additional setup is required. However, if you plan to run the API on a Windows server, you must use locally hosted licensing and you'll need to install the ReliaSoft API Ante Service on the server. The service acts as a bridge between your license server and API clients, allowing the implementation to scale up.

There are three architectural components to making the server-based API calls work: the license server, the API Ante service, and your API client program. All of these components may run on the same machine or on separate networked machines.

 

Prerequisites

The API Ante service is based on WCF technology and requires .NET Framework 4.6.1 or greater to run. Communication between the service and clients is done over TCP and is secured point-to-point via Windows authentication; therefore, the service and any clients must have domain user credentials to run successfully. Also, your server OS and .NET Framework 4.6.1 must be 64-bit.

Before installing the API Ante service, be sure to have configured your license server according to these instructions.

 

Installing the ReliaSoft API Ante Service

 

You may need assistance from a system administrator to complete the installation.

 

  1. Run ReliaSoftAPIAnteService64Pack_1.0.0.0.exe and extract the Ante service files to a location of your choice.

  2. On the computer where the API Ante service will run, create or configure a domain user that has permission to log on as a service and to access the network.

    For this user, set the environment variable HBMUK_LICENSE_PATH to the value PORT@HOST where PORT and HOST are the port and hostname for the license server. (See DistributionFiles\set-license-path.bat for an example of setting this environment variable.)

  3. In the DistributionFiles\ directory, right-click the install-service64.bat file and choose Run as administrator[1]

    You will be prompted for a login name and password. Provide the credentials of the user configured in step 2. Prepend the domain name like so: DOMAIN\USER.

    To check whether the installation was successful, look for the following output:

     

    ...
    Beginning the Install phase of the installation.
    ...
    Service RSAPIAnteService has been successfully installed.
    ...
    The Install phase completed successfully, and the Commit phase is beginning.
    ...
    The Commit phase completed successfully.

    The transacted install has completed.

  4. Start the service. The following case-sensitive arguments may also be provided:

    • /P - The port on which the service will listen for API clients. Default is 64132.

    • /V - Verbose logging. Some messages will not be published to the Windows event log without this flag.

    An example usage: /P 8532 /V

  5. Make a firewall rule to open the port used in step 4.

  6. Optional admin settings:

    • To create a simple filter for capturing messages from the service, open the Windows Event Viewer, then choose Action > Import Custom View and select RSAPIAnteService_CustomView.xml from the provided distribution files.

    • To configure automatic restart upon error/failure, open the Windows Services tool. Find the ReliaSoft API Ante Service in the list and view its properties. On the Recovery tab, choose Restart the Service in the First failureSecond failure and Subsequent failures fields, and select the Enable actions for stops with errors check box.

    • Consider configuring the service to automatically launch at startup.

  7. On the computer where the API client will run, two environment variables must be set:

    • The API client must be able to find the license server. Set the HBMUK_LICENSE_PATH variable to the same value used in step 2 for the API user. (See DistributionFiles\set-license-path.bat for an example of setting this environment variable.)

    • The RS_ANTESERV_PATH variable tells the API client where to find the Ante service. Use the PORT@HOST format where PORT is the value from step 4 and HOST is the hostname of the computer where the service was installed in step 3. (See DistributionFiles\set-anteserv-path.bat for an example of setting this environment variable.)

       

[1] The install scripts assume that the installer program (InstallUtil.exe) is located at the default .NET Framework install location. If the install fails, first open the script and make sure the supplied path is correct for your .NET Framework installation. If the path is incorrect, find the location of InstallUtil.exe and copy its full path into the script. Then save and try running again.