Contents

Timezone Configuration

• Change the Timezone Configuration

DNS Server Configuration

• Specify DNS Servers Using Horizon
• Specify DNS Servers Using the CLI

User Host Entries Configuration

• User-Defined Host Entries Configuration
  • Configure User-Defined Host Entries During Bootstrap
  • Configure User-Defined Host Entries via System Inventory API/CLI
  • Configure User-Defined Local DNS Scope Entries

NTP Server Configuration

• Configure NTP Servers Using Horizon
• Configure NTP Servers Using the CLI
• Resynchronize a Host to the NTP Server

PTP Server Configuration

• PTP Introduction
  • Overview of the StarlingX configuration units
  • General information
• Configure PTP Service Using the CLI
  • PTP Instance Configuration
    • Create an instance and assigning parameters
    • Create an interface and assign to ports
    • PTP Limitations
• PTP Interfaces
• Instance Specific Considerations
  • ptp4l
  • phc2sys
  • ts2phc
  • clock
  • gnss-monitor
  • synce4l
• Configure PTP Partial Timing Support
  • Configure Unicast Master Tables
  • Verify the Configuration
  • Remove Unicast Master Table Configuration
  • Example: T-BC PTS Deployment
  • Example: T-GM PTS Deployment
• PTP Instance Monitoring Parameters
  • Supported Parameters
  • Configure Monitoring Parameters
  • Verify the Configuration
  • Remove Monitoring Parameters
  • Holdover Behavior
  • Out-of-Tolerance Alarms
• PTP Servo Tuning Parameters
  • Clock Servo Overview
  • Configure the Clock Servo
  • PI Servo Parameters
    • Core Parameters
    • Auto-Calculation Parameters
  • PI Servo Tuning for PTS Networks
    • Recommended PTS Tuning
    • PTS Timing Budget
  • Network Considerations for Tuning
    • Packet Delay Variation (PDV)
    • Asymmetric Path Delay
    • Network Topology Changes
    • Temperature and Oscillator Drift
  • Observing Timing Performance
    • ptp4l Log Output
    • Diagnosing Servo Overcorrection
    • phc2sys Log Output
    • collectd Alarms
• Remove PTP Configurations
  • Disable a PTP instance
  • Remove a PTP Instance
• Advanced PTP Configuration
  • Configure BMCA Tiebreaker for Site Boot/Reboot Scenarios
  • Configure ITU-T G.8275.1 Grandmaster Settings Fields
    • Apply PTP configuration
    • Verify Announce Message Attributes
  • Ts2phc Offset Spike Mitigation
    • Offset Spike Characterization
    • Configure Offset Spike Mitigation
    • Disable Offset Spike Mitigation
  • Adjust ts2phc Holdover Interval
  • T-BC Clock Class Compliance
  • phc2sys Out-of-Tolerance Monitoring
• Update ts2phc gnss_uart_disable Default Setting
  • Overview
  • Re-enable the Disable UART Behavior
  • Restore Default Behavior
• Redundant System Clock Synchronization
  • HA Phc2sys configuration
    • HA Phc2sys Configuration Parameters
    • Example Configuration File
  • Manage Phc2sys
    • Informational Commands
    • Management Operations
  • HA Phc2sys Alarms
  • Phc2sys Source Selection Behavior
• Configure PTP on Silicom TimeSync (STS) Server Adapter
• Example PTP Instance Configurations
  • T-BC - Simple PTP configuration
    • ptp4l
    • phc2sys
  • T-GM - Alternate PTP Configuration
    • ts2phc
    • phc2sys
    • ptp4l
    • clock
  • T-GM - Dual NIC Deployment with GNSS and Timing Modules
    • clock
    • ts2phc
    • ptp4l
    • phc2sys
  • T-BC - Dual NIC Deployment with Timing Module
    • clock
    • ts2phc
    • ptp4l
    • phc2sys
• PTP Instance Troubleshooting
  • Example
  • Additional Tools
  • PTS Troubleshooting
    • Verify Network Connectivity to the Grandmaster
    • Capture PTP Traffic on Unicast Interfaces
    • Check PTP Port and Parent Clock State
    • Enable Debug Logging for ptp4l
• Update Leap Seconds File
  • Review Leap Seconds File and Check Expiration Date
  • Replace the Outdated Leap Seconds File
• Configure TAI Offset for T-GM PTP Deployments
  • Background
  • Automated Behavior
  • Startup Behavior
  • Configure TAI Offset
  • Leap Second Lifecycle
  • Verify TAI Offset
  • Verify Leap Second Handling
  • Manual Override
  • Upgrade Considerations
  • Operational Considerations

GNSS and SyncE Support

• SyncE Introduction
  • Basic ‘clock’ instance configuration
  • GNSS Receiver Control (Granite Rapids-D)
• Configure synce4l Service
  • Overview
  • Prerequisites
  • Configure a synce4l Instance
  • T-GM Configuration (GNSS Source)
  • T-BC Configuration (Relay)
  • External Source Board Labels
  • Enable Extended QL
  • Filter Received Quality Levels
  • Advertise a Quality Level in Holdover
  • Monitoring and Notification Parameters
  • SyncE Notifications (O-RAN)
  • Override Auto-Detected Values
  • Remove a Synce4l Configuration
• synce4l Instance Parameters
  • Global Parameters
  • Device Parameters
  • Port Parameters
  • External Source Parameters
  • QL Values Quick Reference
  • Parameter Routing Summary
• synce4l Monitoring and Alarms
  • Alarm 100.119
  • Resolution Steps for Alarm 100.119
  • Monitor ESMC Traffic
  • Check Service Logs
  • Verify DPLL Lock Status

Granite Rapids-D GNSS Monitoring and Quality Metrics

• Granite Rapids-D GNSS Monitoring and Quality Metrics
  • Configure a gnss-monitor Instance
  • Co-existence of ts2phc and gnss-monitor
  • Set Threshold on GNSS Device

Timing Module Firmware Updates

• Update ZL3073x Firmware Using Devlink
  • Identify Devlink Device Name
  • Verify Current Firmware Information
  • Perform Firmware Update
  • Verify Firmware Update
  • Troubleshooting - ZL3073x Firmware Update

IPv4/IPv6 Dual Stack Networking

• IPv4/IPv6 Dual-Stack Network
  • API and Command Line Interface Considerations
  • Install a System in Dual-Stack Mode
  • Configure DNS Server
  • Distributed Cloud Operations
  • Public Endpoint Considerations
  • Modify Network Addresses
  • External API and Command Line Interface Considerations
  • Enable Kubernetes in Dual-stack
  • ingress-nginx Dual-stack Support
  • Runtime Configuration
  • Configure OAM Network
  • Configure Cluster (pod/service/host) Network
  • Configure Management Network
  • Configure Admin Network
  • Revert to Single-stack

NIC Queue Configuration

• NIC Queue Configuration

OAM IP Configuration

• Change the OAM IP Configuration Using Horizon
• Change the OAM IP Configuration Using the CLI
  • OAM Address Pool Configuration
  • Legacy OAM Configuration
• Change the MTU of an OAM Interface Using Horizon
• Change the MTU of an OAM Interface Using the CLI

collectd Configuration

• Configure collectd to Store Host Performance Data
  • Add collectd configuration parameters
  • Edit collectd configuration parameters
  • Remove collectd configuration parameters

Intel Driver Versions

• Intel Driver Versions

Direct vs Switch-Based AIO Configuration

• Convert a Duplex System to Direct Connection
• Convert a Duplex System to Switch-Based Connection

Customize Horizon Branding

• Create a Custom Horizon Branding Tarball
• Apply a Custom Horizon Branding Tarball to Newly Installed Systems
• Apply a Custom Horizon Branding Tarball to Running Systems

Customize Login Banner Branding

• Brand the Login Banner During Commissioning
• Brand the Login Banner on a Commissioned System

Console Keyboard Mapping

• Console Keyboard Mapping

Kubernetes Configuration

• Kubernetes Custom Configuration
  • Introduction
  • kube-apiserver configuration
  • kube-controller-manager configuration
  • kube-scheduler configuration
  • kubelet configurations
  • kube-apiserver, kube-controller-manager and kube-scheduler extra-volumes configuration
  • Complex Example configuration
• Limit Number of Processes per Pod
• About Changing External Registries for StarlingX Installation

Apply Registries’ Auth-Secret Changes

• Change the Registries’ URLs
• Display Updated Registries’ URLs and Auth-Secrets
• Create the Registries’ Auth-Secrets
• Update the Registries’ Auth-Secrets
• Verify the Registries’ Secret Configuration Changes
• Add the CA Certificate for New Registry
• Check New Registry and Reapply Application

Calico Networking

• Calico Network Operator Overview (Tigera Operator)
  • Calico Operator Architecture and Namespaces
  • Upgrading Calico with the Tigera Operator
  • Calico Operator Limitations
  • Related Calico Configuration Tasks
• Customize Calico Networking at Bootstrap
  • Configurable Parameters
  • Apply Custom Options at Bootstrap
• Reconfigure Calico Networking After Deployment
  • View the Current Configuration
  • Modify the Installation CR
  • Examples of Post-Deployment Changes
  • Verify Changes
• Roll Back a Calico Networking Change

Customize Core Dumps

• Change the Default Coredump Configuration
• Kubernetes Pod Core Dump Handler

Customize Crash Dump Manager

• Customize Crash-dump-manager

Cgroup Version Configuration

• Cgroup Version Configuration

Disable SCTP Autoload in the Kernel

• Disable SCTP Autoload in the Kernel

Modify Runtime Kernel Parameters

• Modify Runtime Kernel Parameters

Configure stall daemon

• Configure stall daemon