Skip to Content
JACEHow to gain access to the Serial Shell on a JACE

How to gain access to the Serial Shell on a JACE

The serial shell provides direct console access to JACE controllers, allowing advanced configuration, troubleshooting, and recovery when network access is unavailable. This guide covers accessing the serial shell on various JACE models.

Overview

Serial shell access provides:

  • Direct Console Access: Bypass network configuration issues
  • Recovery Access: Access when network is unavailable
  • Advanced Configuration: Low-level configuration capabilities
  • Troubleshooting: Debug network and system issues
  • Factory Reset: Perform factory reset operations

Prerequisites

Before accessing serial shell, ensure you have:

  • Serial Cable: Appropriate serial cable for JACE model
  • Serial Terminal Software: Terminal emulator (PuTTY, Tera Term, etc.)
  • Serial Port: Computer with serial port or USB-to-serial adapter
  • JACE Access: Physical access to JACE unit
  • Documentation: JACE model-specific documentation

Serial Connection Specifications

Connection Parameters

Standard Serial Settings:

  • Baud Rate: 9600 (most common) or 115200
  • Data Bits: 8
  • Stop Bits: 1
  • Parity: None
  • Flow Control: None

Note: Some JACE models may use different settings. Check model documentation.

Physical Connection

JACE Serial Port:

  • Connector Type: Typically DB9 or terminal block
  • Pin Configuration: Varies by JACE model
  • Cable Type: Straight-through or null modem cable
  • Voltage Levels: RS-232 standard levels

Step-by-Step Access Process

Step 1: Identify Serial Port

On JACE Unit:

  1. Locate Serial Port: Find serial port connector on JACE
  2. Port Type: Identify connector type (DB9, terminal block, etc.)
  3. Port Label: Check for port labels or markings
  4. Documentation: Refer to JACE documentation for port location

Common Locations:

  • Front Panel: Some models have front panel serial port
  • Rear Panel: Most models have rear panel serial port
  • Terminal Block: Some models use terminal block connections

Step 2: Connect Serial Cable

Physical Connection:

  1. Power Off: Power off JACE if required (check documentation)
  2. Connect Cable: Connect serial cable to JACE serial port
  3. Secure Connection: Ensure connection is secure
  4. Power On: Power on JACE unit

Cable Types:

  • DB9 to DB9: Standard serial cable
  • USB to Serial: USB-to-serial adapter for computers without serial ports
  • Terminal Block: Direct wire connections for terminal block models

Step 3: Configure Serial Port on Computer

Windows:

  1. Device Manager: Open Device Manager
  2. Serial Ports: Expand "Ports (COM & LPT)"
  3. Identify Port: Note COM port number (e.g., COM3, COM4)
  4. Port Properties: Configure port if needed (usually default settings work)

Linux/Mac:

  1. Identify Device: Identify serial device (e.g., /dev/ttyUSB0, /dev/ttyS0)
  2. Permissions: Ensure user has permissions to access serial port
  3. Device Check: Verify device is recognised by system

Step 4: Configure Terminal Software

Using PuTTY (Windows):

  1. Open PuTTY: Launch PuTTY application
  2. Connection Type: Select "Serial"
  3. Serial Line: Enter COM port (e.g., COM3)
  4. Speed: Set baud rate (typically 9600)
  5. Settings: Configure other settings:
    • Data bits: 8
    • Stop bits: 1
    • Parity: None
    • Flow control: None
  6. Open: Click "Open" to connect

Using Tera Term (Windows):

  1. Open Tera Term: Launch Tera Term
  2. New Connection: Select "Serial"
  3. Port: Select COM port
  4. Settings: Configure serial settings (9600, 8, N, 1)
  5. OK: Click OK to connect

Using Screen (Linux/Mac):

screen /dev/ttyUSB0 9600

Using Minicom (Linux):

minicom -s
# Configure serial port and settings

Step 5: Access Serial Shell

After Connection:

  1. Press Enter: Press Enter key to wake up console
  2. Login Prompt: You should see login prompt
  3. Enter Credentials: Enter username and password
    • Default username: admin or root
    • Default password: admin or check documentation
  4. Shell Access: You should now have shell access

If No Prompt:

  1. Wait: Wait a few seconds for JACE to boot
  2. Press Enter: Press Enter multiple times
  3. Check Settings: Verify serial settings are correct
  4. Check Connection: Verify cable connection is secure

Step 6: Navigate Shell

Basic Shell Commands:

  • Help: Type help or ? for available commands
  • List Commands: Use tab completion or command list
  • Exit: Type exit or logout to exit shell
  • Reboot: Use reboot command to restart JACE

Common Serial Shell Commands

System Information

# System information
uname -a
cat /proc/version
cat /proc/cpuinfo

# Memory information
free
cat /proc/meminfo

# Network configuration
ifconfig
ip addr show

Network Configuration

# View network settings
ifconfig eth0
cat /etc/network/interfaces

# Configure network (varies by JACE model)
# Use appropriate network configuration commands

Platform Commands

# Platform status
platform status

# Platform restart
platform restart

# Platform configuration
platform config

Factory Reset

# Factory reset commands (varies by model)
factory-reset
# or
reset-config
# or
restore-defaults

Warning: Factory reset will erase all configuration. Use with caution.

Troubleshooting

No Connection

If unable to establish connection:

  1. Cable Check: Verify serial cable is connected properly
  2. Port Settings: Verify serial port settings are correct
  3. Port Selection: Ensure correct COM port is selected
  4. Driver Installation: Verify USB-to-serial drivers are installed
  5. Cable Type: Try different cable (straight vs null modem)

No Response

If JACE doesn't respond:

  1. Baud Rate: Try different baud rates (9600, 115200, etc.)
  2. Connection Timing: Connect before or after power-on
  3. Boot Process: Wait for JACE to complete boot process
  4. Reset: Try power cycling JACE
  5. Alternative Access: Consider alternative access methods

Wrong Characters

If seeing garbled characters:

  1. Baud Rate: Verify baud rate matches JACE settings
  2. Data Bits: Check data bits setting (usually 8)
  3. Parity: Verify parity setting (usually None)
  4. Stop Bits: Check stop bits setting (usually 1)
  5. Flow Control: Verify flow control settings

Login Issues

If unable to login:

  1. Credentials: Verify username and password
  2. Default Credentials: Try default credentials (see related topics)
  3. Case Sensitivity: Check case sensitivity
  4. Multiple Attempts: Some systems lock after failed attempts
  5. Reset: Consider factory reset if credentials unknown

Model-Specific Notes

JACE-8000 Series

  • Serial Port: DB9 connector typically on rear panel
  • Baud Rate: Usually 9600
  • Access: May require specific boot sequence

JACE-9000 Series

  • Serial Port: May use USB or DB9 connector
  • Baud Rate: Typically 115200 or 9600
  • Access: Modern models may have enhanced serial access

JACE-7000 Series

  • Serial Port: DB9 connector
  • Baud Rate: Usually 9600
  • Access: Standard serial shell access

Security Considerations

Serial Access Security

  • Physical Security: Protect physical access to JACE
  • Serial Port: Consider disabling serial port if not needed
  • Access Control: Implement access control for serial shell
  • Audit Logging: Enable audit logging for serial access
  • Documentation: Document serial access procedures securely

Best Practices

Connection Management

  • Document Settings: Document serial settings for each JACE model
  • Cable Management: Keep serial cables organised and labelled
  • Port Documentation: Document which ports are used
  • Backup Access: Serial access provides backup when network fails

Troubleshooting

  • Serial First: Try serial access when network access fails
  • Document Issues: Document serial access issues and solutions
  • Test Regularly: Periodically test serial access
  • Training: Ensure team members know how to access serial shell

Additional Resources

  • JACE Serial Access Documentation
  • Terminal Emulator Guides
  • Serial Communication Standards
  • JACE Model-Specific Technical Manuals
How to restore connectivity on older JACE8000s after performing a Factory ResetModbus