Quick Start: MOCA Network Checker

Quick Start: MOCA Network Checker

Summary


We have created a small network utility to help diagnose MOCA connectivity issues in customer environments. It performs a battery of diagnostic checks and creates output that we can review after a user provides it to us. Details on how to get the utility, run it, and extract the output are outlined below.


How To Get The Utility


The utility can either be downloaded directly from our website (link), or comes bundled with Cycle (as of version 2.24.0).


How To Run The Utility 


It can be run either through its GUI by double-clicking on the application executable, or run through the command line.


GUI


Double-click on the executable file for the utility. It’s called moca-checker. If running from the Cycle install directory, it is located in C:\Program Files (x86)\CycleLabs\Cycle\moca-checker.



Once open, you need to provide a few configuration details.


NOTE: Configuration details provided in the utility are not stored. If you close and re-open the utility, it will look just like the first time you open it (read: you will need to provide the configuration details again on subsequent use if you need to run the utility again later).


Step 1: Provide the host for the MOCA instance. It needs to be without a prefix (E.g., no http or https) and without any sub-paths (E.g., no /service). So in practice, it would be prod-wm202111-moca.wm-servers.com instead of https://prod-wm202111-moca.wm-servers.com/service.


Step 2: Choose http or https.


Step 3: Specify a port if you know it to be different from the default (which is 4600).


Step 4: Provide a valid Username & Password to connect to the MOCA instance.


Now to run it…


Step 5: Click the Run button.


NOTE: If the utility is unable to establish a connection immediately, it will display an error informing of this and give you the option to Stop or Continue. It usually means you have something misconfigured. Click Stop, double-check your configuration settings, and click Run again.


Once the run completes you will be able to copy the results out of the utility and send them to us for review.



Step 6: Click the Copy results button.


Step 7: Open Notepad (E.g., click the Start button, type Notepad, and hit Enter), paste the results into it, click File from the top-menu, then click Save, name the file (E.g., moca-results.txt), and click the Save button.


Step 8: Attach the results text file to an email and send it to R&D for review.



Command-Line


You can also run the utility from the command line.

Step 1: Open the command prompt (E.g., Click the Start button, type Command, and choose Command Prompt)


Step 2: Run the utility by specifying the file path to it, along with the necessary configuration.


  1. "C:\Program Files (x86)\CycleLabs\Cycle\moca-checker\moca-checker.exe" --cli --scheme https --host YOUR-HOST-GOES-HERE --port 4600 --username YOUR-USERNAME-GOES-HERE --password YOUR-PASSWORD-GOES-HERE --results moca-results.json


Step 3: Grab the output file (E.g., moca-results.json) and send it to R&D for review. The file will be outputted to the directory where you ran the com​​​​​mand from. The default directory is typically your user directory (E.g., C:\Users\YourUserName).


Example Output


You can download and see what the output from a successful run with the utility looks like from here.


A summary readout of the checks is listed at the bottom of the file.


  "summary": {

    "total": 171,

    "passed": 171,

    "failed": 0

  }

}


Questions or Problems?


Send an email to help@cyclelabs.io and let us know how we can assist.



    • Related Articles

    • Cycle Release Notes

      Cycle 2.25.0 / 2025-11-19 New Features and Enhancements Deprecate Steps and Add Replacement Steps Cycle has deprecated 3 steps that work against result sets for both moca and sql. The deprecated steps are: Given I assign row <ROW_NUMBER> column ...

    • Cycle 2.23 Deprecated Steps

      The Cycle Labs team is rolling out improvements to our steps using our new Step Plugin Architecture. As a result, we will be removing support for some long time deprecated steps. The deprecated steps listed below will be removed from the Cycle ...

    • BY WMS Library Release Notes

      BY WMS Library Release v 3.4 / 2024-07-01 Here’s what’s new in Version 3.4 of the BY WMS Library Cycle Version Dependency: 2.15 or newer Email help@cyclelabs.io for access to the BY WMS Library download Support for 2021 The WMS Library test cases ...