EndRun Ninja User manual

"Smarter Timing Solutions"
USM3210-0000-000 Revision 3
August 2021
Ninja Time Server
GPS-Synchronized
User Manual

Ninja User Manual
Ninja
Time Server User Manual
Preface
Thank you for purchasing the Ninja Time Server. Our goal in developing this product is to provide
Our goal in developing this product is to bring precise, Coordinated Universal Time (UTC) into your
network quickly, easily and reliably. Your new Ninja is fabricated using the highest quality materials
and manufacturing processes available today, and will give you years of troublefree service.
About EndRun Technologies
EndRun Technologies has been dedicated to the development and renement of the technologies
required to fulll the demanding needs of the time and frequency community since 1998.
The instruments produced by EndRun Technologies have been selected as the time and frequency
reference for such rigorous applications as enterprise computer synchronization, research institutions,
aerospace, network quality-of-service monitoring, satellite earth stations, and calibration laboratories.
Trademark Acknowledgements
Linux and Windows are registered trademarks of the respective holders.
EndRun Contact Information
Address: EndRun Technologies
2270 Northpoint Parkway
Santa Rosa, CA 95407
U.S.A.
Phone: [phone]
Fax: [phone]
Sales: 1-877-749-3878 or [phone]
[email protected]
Support: 1-877-749-3878 or [phone]
[email protected]
Part No. USM3210-0000-000 Revision 3
August 2021
Copyright © EndRun Technologies 2021

Ninja User Manual
Ninja User Manual
About This Manual
This manual will guide you through simple installation and set up procedures.
Introduction – The Ninja, how it works, where to use it, its main features.
Basic Installation – How to connect, congure and test your Ninja with your network.
NTP Server and Client Set-Up – Two client sections; one for Unix-like platforms and one for Windows.
Network Protocols - Covers Security, SNMP, HTTP/HTTPS, IPv6 and optional PTP/IEEE-1588.
Console Port – Description of the console commands for use over the network and serial ports.
Options – Description of any optional features that your Ninja might have.
If you detect any inaccuracies or omissions, please inform us. EndRun Technologies cannot be held
responsible for any technical or typographical errors and reserves the right to make changes to the
product and manuals without prior notice.
Warranty
This product, manufactured by EndRun Technologies, is warranted against defects in material and
workmanship for a period of two years from date of shipment, under normal use and service. During
the warranty period, EndRun will repair or replace, at its option, products which prove to be defec-
tive. Products not manufactured by EndRun Technologies are warranted for ninety days or longer, as
provided by the original equipment manufacturer, from date of shipment.
Extended Warranty
EndRun products are supported by a strong, comprehensive standard warranty (see paragraph above).
Extended warranties are available to expand the coverage period. The extended warranty can be
purchased at the time of order, or during the last year of the standard warranty period.
Limitation of Warranty
The foregoing express warranty shall not apply to defects resulting from improper or inadequate
maintenance by Buyer or User, Buyer-supplied software or interfacing, unauthorized modication or
misuse, operation outside of the environmental specications for the product, or improper site prepa-
ration or maintenance.
TO THE EXTENT PERMITTED BY LAW, THIS WARRANTY AND REMEDIES SET FORTH
ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL OTHER WARRANTIES, REMEDIES AND
CONDITIONS, WHETHER ORAL OR WRITTEN, STATUTORY, EXPRESS, OR IMPLIED. AS
PERMITTED BY APPLICABLE LAW, ENDRUN SPECIFICALLY DISCLAIMS THE IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Ninja User Manual
Ninja User Manual
Warranty Repair
If you believe your equipment is in need of repair, contact EndRun Customer Support. It is important
to contact us rst as many problems may be resolved by phone or email. Please provide the serial
number of the unit and the nature of the problem. If it is determined that your equipment will require
service, we will issue an RMA number and specic shipping instructions.
Ship the unit prepaid in the original container or a container of sufcient strength and protection
to EndRun Technologies. EndRun will not be responsible for damage incurred during shipment to
us. Buyer shall prepay shipping charges to send product to EndRun and EndRun shall pay shipping
charges to return product to Buyer. However, if returned product proves to be operating normally
(not defective) then Buyer shall pay for all shipping charges. If Buyer is located outside the U.S.A.
then Buyer shall pay all duties and taxes, if any.
Be sure the RMA number is clearly identied on the outside of the shipping container. Our policy
is to repair the unit within 5 business days. If it is necessary to order parts or if other circumstances
arise that require more than 5 days, an EndRun service technician will contact you.
Loaner units are not included as part of the standard warranty.
Repair After Warranty Expiration
If the warranty period has expired, we offer repair services for equipment you have purchased from
EndRun. Contact EndRun Customer Support. It is important to contact us rst as many problems
may be resolved by phone or email. Please provide the serial number of the unit and the nature of
the problem. If it is determined that the equipment has failed and you want EndRun to perform the
repairs, we will issue you an RMA number and specic shipping instructions.
Ship the unit prepaid in the original container or a container of sufcient strength and protection to
EndRun Technologies. EndRun will not be responsible for damage incurred during shipment to us.
Customer is responsible for shipping costs to and from EndRun Technologies. Be sure the RMA
number is clearly identied on the outside of the shipping container. After the equipment has been
received we will evaluate the nature of the problem and contact you with the cost to repair (parts and
labor) and an estimate of the time necessary to complete the work.
Limitation of Liability
The remedies provided herein are Buyer’s sole and exclusive remedies. EndRun Technologies shall
not be liable for any direct, indirect, special, incidental or consequential damages, whether based on
contract, tort or any other legal theory.

Ninja User Manual
Ninja User Manual
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .i
About EndRun Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . i
Trademark Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . i
EndRun Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .i
About This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii
Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii
Extended Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii
Limitation of Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii
Warranty Repair . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .iii
Repair After Warranty Expiration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .iii
Limitation of Liability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .iii
Chapter One - Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Main Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Robust GPS Receiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Highly-Reliable Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Standard Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Additional Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Secure Network Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Free FLASH Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Time Synchronization Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
GPS Timing-How It Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Where to Use It . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Client/Slave Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Chapter Two - Basic Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Checking and Identifying the Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Ninja Physical Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Configuration Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Performing a Site Survey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Ninja User Manual
Ninja User Manual
Installing the Ninja . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Mount the Ninja . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Connecting the DC Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Connecting the AC Power Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Connecting and Configuring Ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Configuring Ethernet with the Serial Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Connect the RS-232 Serial I/O Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Test the Serial Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Using netconfig to Set Up Your IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Verify Network Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Check Network Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Using SSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Using Telnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Using HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Connecting Instruments to the Ninja . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Chapter Three - Console Port Control and Status . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Console Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
General Linux Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Available User Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Detailed Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
accessconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
antfltmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
caldelay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
clearalmanac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
cpuio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
cpuioconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
cpustat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
dumpalmanac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
dumpephemeris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
faultstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
gpsdynmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
gpsionoinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
gpslastfix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Ninja User Manual
Ninja User Manual
gpsrefpos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
gpsrefpos_ecef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
gpsreset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
gpsstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
gpstrkstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
gpsutcinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
gpsversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
inetdconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
kernelversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
netconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
ntpconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
ntpstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
oscctrlstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
passwd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
rcvrserialnumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
rcvrstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
resetlastgpswn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
resetleaphistory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
setantfltmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
setcaldelay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
setgpsdynmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
setgpsrefpos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
setsigfltmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
settfomfltlvl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
sigfltmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
syskernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
sysosctype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
sysrootfs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
sysstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
systemio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
systemioconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
systimemode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Ninja User Manual
Ninja User Manual
systimemodeconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
sysversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
tfomfltlvl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
triggerppo (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
updatekernelflag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
updaterootflag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
upgradekernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
upgradercvr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
upgradercvrfpga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
upgraderootfs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Chapter Four - Hyper Text Transport Protocol (HTTP/HTTPS) . . . . . . . . . . . . . . 41
Interface Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Configure HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Configure HTTPS only for IPv4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Configure HTTPS only for IPv6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Restrict Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Configure Certificate and Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Chapter Five Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Linux Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Restrict Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Restrict Access - Telnet, SSH and SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Enable/Disable Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Enable/Disable Telnet, Time and Daytime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Disable SNMP, SSH and HTTP/HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Enable SNMP, SSH and HTTP/HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Is the Protocol Disabled? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
OpenSSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Configure Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
HTTP/HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Ninja User Manual
Ninja User Manual
NTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Network Security Vulnerabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Chapter Six - Simple Network Management Protocol (SNMP) . . . . . . . . . . . . . . 53
SNMPv3 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Enterprise Management Information Base (MIB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Invocation of the SNMP daemon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Quick Start Configuration -- SNMPv1/v2c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Change Default Community Strings (Passwords) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configuring SNMPv1 Trap Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configuring SNMPv2c Notifications and Informs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configuration of SNMPv3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Configuring SNMPv3 Notifications and Informs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Example of usmUser Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Disable or Restrict Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Chapter Seven - Network Time Protocol (NTP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Configuring the NTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Configuring the Ninja as a Stratum 1 Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Configuring NTP Using the Network Interface or Serial Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Configuring the Ninja as a Stratum 2 Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Edit ntp.conf File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Mask Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Setting Up NTP Clients on Unix-like Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Unix-like Platforms: Basic NTP Client Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Configure NTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Unix-like Platforms: MD5 Authenticated NTP Client Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Create the ntp.keys File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Configure NTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Unix-like Platforms: Broadcast/Multicast NTP Client Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Configure NTP Client for Broadcast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Configure NTP Client for Multicast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Test Broadcast/Multicast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Ninja User Manual
Ninja User Manual
Setting Up NTP Clients on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Windows: W32Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Chapter Eight - IPv6 Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
IPv6 Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
OpenSSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Hiawatha HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Net-SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
NTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
IPv4-Only Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Chapter Nine - Inputs/Outputs (I/O) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Standard I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Antenna Jack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Ethernet Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Serial I/O Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
DC Power Input Jack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Output Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Configuration Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
1 PPS Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
IRIG-AM Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Programmable Pulse Output (PPO) Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Trigger PPO Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Alarm Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Chapter Ten - Optional Precision Time Protocol (PTP/IEEE-1588) . . . . . . . . . . . 79
Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
About PTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
PTP Configuration and Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Default PTP Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
PTP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
PTP Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
PTP Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Ninja User Manual
Ninja User Manual
About PTP Seconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Disable the PTP Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Re-Enable PTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Appendix A - Time Figure of Merit (TFOM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Appendix B - Upgrading the Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Upgrade via the Console Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Performing the Linux RFS Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Transfer File to Ninja . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Recovering from a Failed RFS Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Performing the Linux Kernel Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Transfer File to Ninja . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Recovering from a Failed Kernel Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Performing the GPS Receiver Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Problems with the GPS Receiver Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Performing the GPS Receiver FPGA Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Appendix C - Helpful Linux Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Linux Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Linux Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Detailed Information Is Available . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Change Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
List Active Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
NTP Monitoring and Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Text Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Change Log-In Banners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Query and Change Ethernet Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Redirect Syslog Files to Remote Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Appendix D - Third-Party Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
GNU General Public License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
NTP Software License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Hiawatha Software License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Linuxptp Software License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Ninja User Manual
Ninja User Manual
Appendix E - Installing the GPS Antenna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Antenna Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
GPS Antenna Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
About Coax Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Long Cable Runs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Recommended Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Using GPS Low-Noise Amplifiers (LNAs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Using Two or Three LNAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Other Accessories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Lightning Arrestor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Signal Splitters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Calibrate Your Receiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Mounting On A Rooftop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Obtaining A Reference Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
About WGS-84 Height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Appendix F - Leap Seconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Automatic Leap Second Insertion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Background Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Appendix G - System Faults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Masking Faults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Fault Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Appendix H - Time Code Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
IRIG-B122/002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
IRIG-B123/003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
IRIG-B120/000 (IEEE-Standard 1344-1995) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
NASA-36 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
2137 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
IEEE-1344 Bit Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Ninja User Manual
Appendix I - Operation with a GPS Simulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Console Port Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
clearalmanac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
resetlastgpswn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
resetleaphistory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Appendix J - Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Optional Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Compliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Special Modifications - Changes for Customer Requirements . . . . . . . . . . . . . . . 133

Ninja User Manual
1
"Smarter Timing Solutions"
Chapter One
Introduction
This chapter introduces the GPS-Synchronized Ninja Time Server and gives a brief overview. Ninja
is a compact, portable module. Optimized for size, weight and power (SWaP), the Ninja requires only
35 cubic inches of mounting space and consumes less than 6 watts of power.
Ninja is a precision server of Coordinated Universal Time (UTC) that can be connected via an Eth-
ernet port to any TCP/IP network. Available timing protocols include Network Time Protocol (NTP)
and Simple Network Time Protocol (SNTP). The Precision Time Protocol (PTP/IEEE-1588) is avail-
able as an option.
In its most basic operation, Ninja sends NTP reply packets in response to NTP request packets which
it has received from clients. The timestamps it sends in its NTP reply packets are accurate to 10 mi-
croseconds, typical. For an introductory paper on NTP see:
endruntechnologies.com/pdf/NTP-Intro.pdf
For more detailed information that is not included in this manual, and links to other sites, please visit
our website: endruntechnologies.com. There you can also download rmware upgrades, the latest
manuals and other documentation.
Main Features
Robust GPS Receiver
Ninja is a GPS-based network time server designed to support mission critical applications. The pro-
prietary GPS timing receiver in Ninja has many safeguards to protect against false GPS signals. The
receiver strictly adheres to the GPS Interface Specication and performs low-level integrity checks to
protect against weak corrupted signals, jamming, spoong and accidental GPS control system errors.
EndRun’s GPS timing receiver technology has evolved to be highly robust against these threats to
provide time and frequency outputs you can trust.
Highly-Reliable Design
The Ninja provides high performance and reliability combined with small size and low power con-
sumption. Its internal sub-assemblies are fabricated using state-of-the-art components and processes
and are integrated in a solid, high-quality chassis. Since it uses highly efcient ARM microproces-
sors, the Ninja is convection-cooled and the chassis is sealed to eliminate the maintenance and reli-
ability issues associated with fan-cooled architectures. Up to ve outputs can be customer congured

Ninja User Manual
2
CHAPTER ONE
3Ninja User Manual
at the time of order supporting a range of analog and digital outputs. Details on the various outputs
are described in Chapter 9 - Inputs/Outputs (I/O) and Appendix J - Specifications.
Standard Features
The basic Ninja provides an RS-232 serial port and an Ethernet port with a Network Time Protocol
(NTP) server. The Ninja can be managed via the network port or the serial port. See Chapter 3
- Console Port Control and Status, and Chapter 7 - NTP for more information.
Additional Outputs
Up to ve optional outputs are available via SMA connectors. Outputs supported include 1 PPS,
pulse rates to 10 MPPS, time code (AM and DCLS), and an open-collector alarm.
Secure Network Interface
A single 10/100Base-T Ethernet port is provided with a wide variety of protocols including NTP,
SNMP with Enterprise MIB, SSH, Telnet, FTP, HTTPS, and SNTP. Refer to Chapter 2 - Basic
Installation for information to help you set up your network interface. The inclusion of SNMP v3
and SSH provides a very secure network interface and allows you to safely perform monitoring
and maintenance activities over the network. For security-conscious users, risky protocols such as
HTTP/HTTPS, Telnet, Time and Daytime are disabled by default. To enable, see Chapter 5 - Secu-
rity, Enable/Disable Protocols. In addition, access via SSH, SNMP and Telnet can be restricted to
specic hosts. Refer to Chapter 5 - Security, Restrict Access for further information.
Free FLASH Upgrades
Firmware and congurable hardware parameters are stored in non-volatile FLASH memory, so the
Ninja can be easily and securely upgraded in the eld using SSH and SCP or the local RS-232 serial
port. Upgrades via FTP and Telnet are also possible although these protocols are not secure. We
make all rmware upgrades to our products available to our customers free of charge. For rmware
upgrade procedures refer to Appendix B - Upgrading the Firmware.
Time Synchronization
Components
The Ninja contains a GPS Subsystem composed of EndRun Technologies’ proprietary GPS Receiver
and a system oscillator. The GPS Subsystem is integrated with a fanless, convection-cooled high per-
formance ARM CPU with an Ethernet port that provides NTP. This is called the Linux Subsystem.
Figure 1 shows Ninja’s time synchronization components.

Ninja User Manual
2
CHAPTER ONE
3Ninja User Manual
Ninja GPS System Timebase
System
Oscillator
Receiver
Oscillator
PLL
GPS Receiver Module
Receiver
Processor
EFC
Linux NTP/PTP Subsystem
1PPS 10MHz
GPS Receiver Subsystem
10MHz
GPS Timing-How It Works
The time and frequency engine in the Ninja receives transmissions from satellites that are operating
in compliance with the Navstar GPS Interface Specication known as IS-GPS-200. It species the
receiver interface needed to receive and demodulate the navigation and time transfer data contained
in the GPS satellite transmissions. The GPS navigation system requires a means of synchronizing
the satellite transmissions throughout the constellation so that accurate receiver-to-satellite range
measurements can be performed via time-of-arrival measurements made at the receiver. For the
purposes of locating the receiver, measurements of the times-of-arrival of transmissions from at least
four satellites are needed for maximum timing accuracy. Time transfer to a receiver at a known posi-
tion from a single satellite is supported,
The GPS system designers dened system time to be GPS time. GPS time is a monotonic time scale
consisting of an ensemble of high-performance cesium beam and rubidium vapor atomic frequency
standards located in the monitoring stations and satellites. GPS time is measured relative to UTC,
as maintained by the United States Naval Observatory (USNO), and maintained synchronous with
UTC(USNO) except that it does not suffer from the periodic insertion of leap seconds. Such dis-
continuities would unnecessarily complicate the system’s navigation mission. Contained in the data
transmitted from each satellite is the current offset between GPS time and UTC(USNO). This offset
is composed of the current integer number of leap seconds difference and a small residual error that is
typically less than +/- 10 nanoseconds.
Each satellite in the constellation contains redundant cesium beam or rubidium vapor atomic frequen-
cy standards. These provide the timebase for all transmissions from each satellite. These transmis-
sions are monitored from ground stations located around the world and carefully measured relative to
GPS time. The results of these measurements for each satellite (i.e. correction to GPS time) are then
uploaded to that satellite so that they may be incorporated into the data contained in its transmissions.
The receiver can use this data to relate the time-of-arrival of the received transmissions from that
satellite to GPS time and by using the transmitted UTC parameters, to UTC(USNO).
FIGURE 1 - NINJA GPS SYSTEM TIMEBASE

Ninja User Manual
4
CHAPTER ONE
All of this means that during normal operation, the source of the timing information being transmitted
from each of the satellites is directly traceable to UTC(USNO). Due to the nature of the GPS spread
spectrum Code Division Multiple Access (CDMA) modulation scheme, this timing information may
be extracted by a well-designed receiver with a precision of a few nanoseconds. The GPS time and
frequency engine in the Ninja does just that.
Where to Use It
Since signals from the GPS satellites are available at all locations on the globe, you may deploy the
Ninja virtually anywhere. However, you must be able to install an antenna with good sky visibility,
preferably on the rooftop.
Client/Slave Software
Ninja has been designed to operate in conjunction with existing public domain NTP/SNTP client
software and may be used in any network environment that is using TCP/IP protocols. Although cli-
ent software is available for all platforms, for the most precise applications, the Unix-like operating
systems are best supported. For more information see Chapter 7 - NTP, Setting Up NTP Clients on
Unix-like Platforms and Setting Up NTP Clients on Windows. There is additional information about
NTP Client software at this link:
endruntechnologies.com/products/ntp-time-servers/ntp-client-software

Ninja User Manual
5
"Smarter Timing Solutions"
Chapter Two
Basic Installation
This chapter will guide you through the most basic checkout and physical installation of your Ninja
Time Server. See Chapter 7 - NTP for instructions on how to congure your unit as an NTP Server.
Other chapters and appendices will give you the information needed to congure your installation for
the maximum performance in your operating environment.
Basic familiarity with TCP/IP networking protocols like ping, telnet and ftp is required. Though
some familiarity with Linux or other Unix-like operating systems would be helpful, it is not essen-
tial. If you satisfy these conditions, the instructions provided herein should guide you to a successful
installation. For a brief description of some helpful Linux commands and utilities see Appendix C
- Helpful Linux Information.
Checking and Identifying
the Hardware
Unpack and check all the items using the shipment packing list. Contact the factory if anything is
missing or damaged. The Ninja Time Server shipment typically contains:
• Ninja Time Server (part #3210-xxxx-xxx, where x is a variable number)
• Ninja User Manual (part #USM3210-0000-000) on CD (part #5102-0001-000)
• Basic Cable Kit (part # 0648-0002-000) including:
- RJ-45 to RJ-45 CAT-5 patch cable, 2 meters
- DB9F-to-DB9F null-modem serial I/O cable
• Starter Kit (part # 0608-0009-000) including:
- SMA/TNC antenna connector adapter
- DC power connector and crimp pins
- 36” DC power cable
Ninja can ship with many different options. The most common are:
• External AC Power Supply (part #0623-0004-000)
• Antenna Kit (part # 0610-0009-001) including:
- GPS antenna
- Pipe/clamps for outside antenna mounting
- 50’ TNC/TNC RG-59/U coaxial cable assembly

Ninja User Manual
6
CHAPTER TWO
7Ninja User Manual
BASIC INSTALLATION
Ninja Physical
Description
The drawings above show the Ninja Time Server front and rear-panels with optional outputs E and
F being used. (Unused outputs are plugged.) For more information see Chapter 9 - Inputs/Outputs
and Appendix J - Specifications. Descriptions below briey describe the standard and optional I/O
connectors:
Sync LED This amber LED ashes to indicate synchronization status.
Alarm LED This red LED illuminates briey at power-up, and thereafter whenever
a serious fault condition exists.
GPS Antenna Input This SMA connector mates with the downlead cable from the external
antenna.
RS-232 Port This DB9M connector provides the RS-232 serial I/O console
interface to the Ninja. This console allows you to initialize
and maintain the Ninja. See Chapter 3 - Console Port Control
and Status for more information and Appendix J - Specifications for
the RS-232 pin assignments.
10/100Base-T Jack This RJ-45 connector mates with the Ethernet twisted pair cable from
the network. It is labeled “ETH0” with the MAC address. There is one
green LED that indicates network activity. This port provides a console
interface to the Ninja. See Chapter 3 - Console Port Control and
Status for more information.