CX-One Installation Upgrading from CX-Programmer v5

James Nishida11 min read
OmronOther TopicTutorial / How-to
Licensed PE Working through this on a live machine? A Maine-licensed engineer can take it from here — included with IMD hardware, by the hour for everything else. Book an engineer

Overview

Omron's CX-One integrates the full portfolio of OMRON support software into one installer using one license: CX-Programmer, CX-Server, CX-Designer, CX-Simulator, CX-Drive, CX-Motion, CX-Process, CX-Thermo, CX-FLnet, CX-Profibus, and CX-Integrator. Installation media is shipped under catalog numbers such as CXONE-ALDLC-E (multilingual site DVD for Europe), CXONE-AL01C-E (single-seat DVD), and the CXONE-AL__C_E_UP SKU family used for upgrade kits issued to existing owners. The official procedure is documented in the CX-One Setup Manual W444-E1.

This guide consolidates two issues repeatedly encountered in the field when migrating from a standalone CX-Programmer v5 install to a full CX-One deployment:

  1. Whether to clean-install or perform an in-place upgrade over CX-Programmer v5/CX-Server.
  2. CX-One v1.1 silently disabling the Ethernet service of FinsGateway 2003, breaking the CJ1M-CPU22 pass-through path through an NS-series Touchpanel.

Both problems are tractable; the second is documented and reproducible, and the corrective procedure restores routed programming without full reinstallation of the PLC project.

Prerequisites

Verify before installing. An incompatible host environment causes the installer to abort halfway through (typical total runtime 30–45 minutes on Windows XP SP3 with 2 GB RAM, longer on Windows 10/11). Do not interrupt the installer once it begins; it does not checkpoint rollback.
Item Requirement Notes
OS Windows XP SP3 / Vista / 7 / 8 / 10 / 11 For CX-One v1.1 use Windows XP/7. CX-One v4.x supports Windows 10/11.
Disk space ~3.0 GB free After install grows to ~5 GB with help files and component docs.
RAM 1 GB minimum, 2 GB recommended CX-Programmer + CX-Simulator + CX-Designer running concurrently needs ≥ 2 GB.
Display 1024 × 768 minimum, 1280 × 1024 recommended CX-Designer ladder editing requires extra horizontal resolution.
Existing OMRON software CX-Programmer v5.x, CX-Server, FinsGateway 2003 Note exact build numbers before the install.
Administrator rights Required (local account, Run as Administrator) The installer registers OMRON FinsGateway services and COM+ components.
Network port UDP 9600 (FINS), TCP 9600 (FINS/TCP), UDP 9999 (CX-Server routing) Open on Windows Firewall before install.

CX-One Component Architecture and Catalogue Mapping

CX-One ships a complete tool-chain that replaces single-purpose CD installs. Knowing the mapping matters because the installer toggles which registration keys and COM+ services get overwritten on top of legacy CX-Programmer v5 files.

Legacy Install CX-One Equivalent Function
CX-Programmer v5.x CX-Programmer v6.1+ (CX-One) Ladder/ST programming for CS/CJ/CP/NJ/NX PLCs
CX-Server v2.x CX-Server v3.x+ (CX-One) Routing engine and OPC bridge
CX-Designer v2.x CX-Designer v3.x (CX-One) NS/NSJ HMI screen development
CX-Motion / MNH CX-Motion (CX-One) Motion Control for CS1W-MC221/MC421
CX-Drive CX-Drive (CX-One) MX2/RX/JX/3G3MX2 VFD commissioning
FinsGateway 2003 FINS Service integrated into CX-One installer Ethernet FINS gateway for routing

The CX-One Ver.4 Update Information page lists the minimum component versions: Sysmac Studio (bundled), CX-Motion Pro Ver.1.43 or higher, CX-Drive Ver.2.92 or higher. If you cross-grade between v3.x and v4.x media, the v4 update is applied after the base CX-One DVD install completes.

Decision Matrix: Clean Install vs In-Place Upgrade

Both paths are supported by the installer; the correct choice depends on whether legacy CX-Server or FinsGateway 2003 is in active use on the host machine.

Scenario Recommended Method Reason
Workstation without prior OMRON software Clean install Fastest, no registry/COM+ conflicts.
CX-Programmer v5 only, no FinsGateway in use In-place upgrade Installer removes CX-Programmer v5 and replaces with CX-One equivalent. Tested "clean" removal.
CX-Server + FinsGateway 2003 actively routing to NS panel via Ethernet In-place upgrade, then verify FinsGateway Ethernet service CX-One 1.1 disables the FinsGateway Ethernet service during install. Plan to re-register it.
SySMAC Studio already installed (mixed ecosystem) In-place upgrade to CX-One v4.x v4 keeps Sysmac Studio alongside CX-One; they coexist.
Migrating to a new PC Clean install Avoid dragging partially-corrupt OMRON registrations across machines.

Step-by-Step: Performing the CX-One Installation

  1. Insert the CX-One DVD (or mount the ISO). The SETUP.EXE autoruns.
  2. Choose Install / Reinstall CX-One.
  3. Accept the license agreement; supply the Product Key printed on the sleeve of the DVD case.
  4. Select Custom Install to deselect components you do not need (this reduces disk consumption and shortens install time from ~45 min to ~20 min).
  5. When prompted for Existing Components Detected, choose Replace / Upgrade to overwrite CX-Programmer v5 with the bundled CX-One equivalent. Choose Keep only if you have a documented reason to retain v5 (none for routine deployments).
  6. Monitor the install screen for the dialog Configuring FinsGateway Service. This is where CX-One 1.1 overwrites the FinsGateway 2003 Ethernet driver. Do not skip this step. It is mandatory for proper comm architecture.
  7. When install completes, do not reboot immediately. Proceed directly to the verification procedure below if your site depends on FinsGateway 2003 routing.
  8. After verification, reboot. The installer registers FinsGateway, CX-Server, and CX-Net as auto-start Windows services.

Troubleshooting: FinsGateway 2003 Ethernet Service Disabled by CX-One 1.1

Problem Description

After installing CX-One v1.1 over a host previously running FinsGateway 2003, the Ethernet service of FinsGateway stops. The result is that routing from an Ethernet-attached PC to a serial-attached PLC through an NS Touchpanel fails. A typical layout is:

PC ---Ethernet--- NS Touchpanel (NS15/NS12/NS10) --- RS-232C Port A --- CJ1M-CPU22
             ^                                                           ^
             |                                                           |
       IP: 192.168.250.10                                       CPU serial port

The NS Touchpanel acts as a pass-through gateway. CX-Programmer opens an Ethernet socket to the NS (UDP 9600), and the NS passes the FINS message out Port A as ToolBus/RS-232C frames to the CJ1M-CPU22. Without the FinsGateway Ethernet service on the host, the CX-Server routing layer cannot dispatch FINS responses back to CX-Programmer.

Root Cause

CX-One 1.1 installs a newer FinsGateway service component (file FgwEther.dll, version ≥ 1.5) but, on hosts where FinsGateway 2003 was previously installed, it disables rather than migrates the Ethernet-driver registration. The behavior was confirmed reproducible on Windows XP SP3 with FinsGateway 2003 (build 2.7.0.1) prior to the CX-One install. Service status observed post-install:

Service Pre-CX-One Post-CX-One 1.1 Required for Pass-Through
FinsGateway Running Running Yes
FinsGateway Ethernet Service Running Stopped / Disabled Yes
CX-Server Running Running Yes
CX-Net Routing Running Running Yes

Solution

Re-register the FinsGateway 2003 Ethernet service. Two viable procedures exist; choose the one that matches your site.

Method A — Reinstall FinsGateway 2003 Service Component

  1. Open Control Panel → Add/Remove Programs (Windows XP) or Programs and Features (Windows 7/10).
  2. Select FinsGateway 2003; choose Repair if offered, else Uninstall.
  3. If uninstalled, re-run the original FinsGateway 2003 installer (or run the silent repair: msiexec /fa FinsGateway2003.msi) using the same product key.
  4. Reboot.
  5. Confirm FinsGateway Ethernet Service is Started and Startup Type is Automatic.

Method B — Re-enable the Existing Service

  1. Open services.msc.
  2. Locate FinsGateway Ethernet Service.
  3. Set Startup type to Automatic; click Start; click Apply.
  4. If the Start button fails with error 1053, re-register the COM+ application: at an admin command prompt run FgwEther /RegServer followed by net start "FinsGateway Ethernet Service".
  5. Reboot and verify the service stays Started after reboot.

Verification

  1. From the host, open CX-Programmer → PLC → Auto Online → Direct Online with the network type Ethernet (FINS/UDP).
  2. Confirm the CJ1M-CPU22 is detected through the NS Touchpanel IP address (e.g. 192.168.250.10).
  3. Poll the PLC. A typical handshake round-trip is < 80 ms on a 100 Mbit LAN with no other routing hops.
  4. Download a small W0.00 = 1 test rung to confirm read/write two-way communication, not just passive connection.
  5. Run CX-Net → Route Table and confirm route (Network 0, Node 0) → (Network 0, Node [NS IP]) is defined with the unit number 0 (default).
Field tip: If pass-through works for online monitoring but fails when you attempt a program download, the issue is most likely the FINS destination unit number mismatch on the NS Touchpanel. The PLC FINS node must be an integer matching the CPU's Unit Number rotary switch (CJ1M-CPU22 default = 0).

NS Touchpanel Pass-Through Routing Deep Dive

Cabling and Port A Settings

The NS Touchpanel's Port A is an RS-232C D-sub 9-pin male connector. To pass-through to a CJ1M-CPU22:

NS Port A Pin CJ1M-CPU22 Serial Port Pin Signal
2 (RXD) 3 (TXD) Data out from PLC
3 (TXD) 2 (RXD) Data into PLC
5 (GND) 5 (GND) Ground
4 (RTS) 8 (CTS) Flow control
7 (CTS) 7 (RTS) Flow control

Use Omron's XW2Z-200S-CV (2 m) or XW2Z-500S-CV (5 m) pre-built cable; do not home-wire the shield.

CX-Designer Configuration to Enable Pass-Through

  1. Open the NS project in CX-Designer v3.x (bundled with CX-One).
  2. Select NS → System Settings → Ethernet → Port Settings and assign an IP in the PLC subnet (192.168.250.10 / 255.255.255.0 default).
  3. Select Comm. Settings → Serial Port A and set Baud = 19,200 bps, Data 7, Parity Even, Stop 2, Protocol = ToolBus to match the CJ1M-CPU22 default Host Link settings. Switch to FINS protocol only if the application mixes NS ↔ PLC + remote CJ1M-CPU22 routing in the same network.
  4. Under System Settings → Comm. Settings → Pass-Through, enable Allow pass-through CX-Programmer; assign the FINS source network number from the host PC (typically 0) and unit 0.
  5. Save and transfer the project to the NS. Power-cycle once so the new pass-through table is committed.

CX-One / CX-Programmer v5 Version Compatibility Matrix

CX-One Version CX-Programmer Build CX-Server Build FinsGateway Compat. Windows
1.1 6.1 3.0 Disables FinsGateway 2003 Ethernet XP / Vista
1.2 6.2 3.1 Migrates FinsGateway 2003 in place XP / Vista
2.0 7.0 3.5 Coexists with FinsGateway 2003 XP / 7
3.0 9.0 4.0 Coexists with FinsGateway 2003 7 / 8
4.0 (current) 9.7x (NJ/NX), 9.4x (CJ) 5.0 FinsGateway integrated; legacy 2003 unsupported 10 / 11

If you are installing CX-One 1.1 and need FinsGateway 2003, the safest sequence is to immediately apply the v1.2 service update, which migrates rather than disables the Ethernet service.

Network and Firewall Configuration

FINS/UDP default port is 9600; FINS/TCP is 9600; CX-Server routing uses UDP 9999. On Windows Firewall add these inbound exceptions or disable the firewall on a controlled engineering subnet during pass-through work:

netsh advfirewall firewall add rule name="FINS/UDP" dir=in action=allow protocol=UDP localport=9600
netsh advfirewall firewall add rule name="FINS/TCP" dir=in action=allow protocol=TCP localport=9600
netsh advfirewall firewall add rule name="CX-Server" dir=in action=allow protocol=UDP localport=9999

FINS network number and node must match. For a single-network single-PLC bench: Network = 0, Node = IP last octet if all devices are on the same subnet. For multi-segment configurations use CX-Net → Routing Table Editor.

License and AutoUpdate Management

CX-One uses OMRON's AutoUpdate utility to deliver maintenance releases free of charge. The CX-One product page and the European CX-One product page document that the suite is on online AutoUpdate. To configure:

  1. Launch CX-One AutoUpdate from the Start menu.
  2. Enter the Product Key when prompted. Activation is stored in %PROGRAMDATA%\OMRON\CX-One\licenses\ as a per-seat entitlement.
  3. Click Check for Updates; accept any maintenance updates for installed components only.
  4. Schedule updates to occur after hours when CX-One components are not actively driving a runtime project.
License note: Moving a license to a new machine invalidates the old seat. Use CX-Server License Manager → Deactivate on the old host before reinstalling the suite on a new one. Reusing the same machine simply keeps the license active.

Field-Commissioning Checklist

  1. Confirm CX-One installs without error; record install log at C:\OMRON\CX-One\Logs\Install.log.
  2. Verify FinsGateway Ethernet Service is started; restore via Method A or B if stopped.
  3. Ping the NS Touchpanel from the host: ping 192.168.250.10 -n 4. Round-trip time should be < 5 ms on a clean engineering subnet.
  4. Open CX-Programmer, go Direct Online → Ethernet (FINS/UDP); confirm the CJ1M-CPU22 is found.
  5. Download a 1-rung test program; verify it executes by reading back W0.00.
  6. Update the FINS routing in CX-Net, save and export to .fr2 file for the next engineer.
  7. Document the CX-One build, CX-Programmer build, CX-Server build, and FinsGateway service version in the site's software baseline register.

Related Procedure Summary

If you need to… Do this
Clean install Uninstall CX-Programmer v5 + CX-Server + FinsGateway 2003 first; reboot; install CX-One from DVD.
In-place upgrade Run SETUP.EXE; choose Replace/Upgrade on detected components; verify FinsGateway Ethernet Service post-install.
Restore FinsGateway 2003 Ethernet Repair the FinsGateway 2003 install via Programs and Features; restart FinsGateway Ethernet Service.
Add a unit number rotation Use the CJ-series Unit Number Switch (default 0) and update the CX-Net routing table.
Coexist with Sysmac Studio Apply CX-One v4 update; Sysmac Studio ships alongside the suite.
Update offline From CX-One Ver.4 Update Information download the patch and run with elevated rights.

Does CX-One require CX-Programmer v5 to already be installed?

No. CX-One includes its own build of CX-Programmer. The installer can detect and overwrite an existing v5 install, but a clean install without any prior OMRON software is the most predictable path.

Why did my FinsGateway 2003 Ethernet service stop after installing CX-One 1.1?

CX-One 1.1's installer disables the FinsGateway 2003 Ethernet driver during the registration step. Re-enable it via services.msc (Startup type = Automatic, Start) or repair FinsGateway 2003 in Programs and Features. Upgrading to CX-One v1.2 or later migrates the service cleanly without manual repair.

How do I confirm pass-through routing through an NS Touchpanel is working?

In CX-Programmer choose PLC → Auto Online → Direct Online → Ethernet (FINS/UDP). Enter the NS Touchpanel IP, set FINS destination network = 0, node = CPU serial node (default 0). The CJ1M-CPU22 should appear in the device list within a few seconds.

What cable connects an NS Touchpanel Port A to a CJ1M-CPU22 serial port?

Use the OMRON cross cable XW2Z-200S-CV (2 m) or XW2Z-500S-CV (5 m). These implement ToolBus/RS-232C cross-over with full hardware flow control. Pin cross-over is RXD↔TXD, RTS↔CTS, GND↔GND.

Which CX-One version should I install for Windows 10 / 11?

CX-One v4.x (current release). Versions 1.x through 3.x were tested on Windows XP/Vista/7/8 and are not supported on Windows 10/11. Always apply the latest v4 update (CX-Motion Pro ≥ 1.43, CX-Drive ≥ 2.92) from the CX-One Ver.4 Update Information page.

Back to blog