D-Series DALinux v3.4

Transcription

1 D-Series DALinux v3.4 9-April-2014 Revision: Release

2 Publication Information 2014 Imagine Communications Corp. Proprietary and Confidential. Imagine Communications considers this document and its contents to be proprietary and confidential. Except for making a reasonable number of copies for your own internal use, you may not reproduce this publication, or any part thereof, in any form, by any method, for any purpose, or in any language other than English without the written consent of Imagine Communications. All others uses are illegal. This publication is designed to assist in the use of the product as it exists on the date of publication of this manual, and may not reflect the product at the current time or an unknown time in the future. This publication does not in any way warrant description accuracy or guarantee the use for the product to which it refers. Imagine Communications reserves the right, without notice to make such changes in equipment, design, specifications, components, or documentation as progress may warrant to improve the performance of the product. Trademarks Product names and other brands (such as ADC, D-Series, Nexio, Nexio Insight, Nexio Motion, PowerSmart, Versio ) are trademarks or trade names of Imagine Communications or its subsidiaries. Microsoft and Windows are registered trademarks of Microsoft Corporation. All other trademarks and trade names are the property of their respective companies. Contact Information Imagine Communications has office locations around the world. For domestic and international location and contact information see: Support Contact Information For domestic and international support contact information see: Support Contacts: ecustomer Portal: Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 2 of 112

3 Contents Contents About this Document... 8 Introduction... 8 The Intended Audience... 8 Applicability... 8 Recommended Reference... 8 DALinux Installation and Configuration... 9 Before you Begin... 9 About Navigating Linux Screens... 9 About Selecting Screen Options and Fields... 9 DALinux Command Reference... 9 Create a Bootable USB Flash drive Creating a Bootable USB Flash Drive (Option) Create CDs from ISO Images Confirm Computer BIOS Settings Set BIOS for Local Drive Boot Set BIOS Clock to UTC About Hyper-threading Install DALinux Perform the Initial Startup Prepare the System Partition the Hard Disk Configure Destination Partitions Configure Swap Partitions Install the Software Configure the System Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 3 of 112

4 Contents Configure System Clock and Timezone Configure Network Binding an Interface to Specific Hardware Configure Bootloader (GRUB) Setup User Accounts Set Administrator Password Finalize the Install and Reboot the System Alternate Password Assignment Method (Optional) Mount the Drives CDROM Drive USB Drive Configuring SAMBA/SWAT on DALinux V4 Systems About Samba To Configure SAMBA/SWAT Log on the DALinux Set the SAMBA Password Access the Samba Web Administration Tool Create Shares on SAMBA Set Share Parameters Conclude the SAMBA Configuration Accessing DALinux (Samba Server) from a Windows Machine DALinux Tools Installation and Setup Introduction Contents of the DALinux Supplementary Tools D-Series Tools Installing D-Series Tools Installing Drivers Determining Which Kernels are Installed Driver Compatibility Driver Version Identification Installing SER 12 Drivers Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 4 of 112

5 Contents Installing SER 16 Drivers Installing SER 24 Drivers Installing SER 4-LTC Driver Installing the PCIe-TC Timecode Driver Installing the AEC PCI-TC Timecode Driver Reviewing Installed Kernels HP Smart Array P400 Controller Card Support for the Intel 82579LM NIC Support for the Intel & I-350 "igb" Ethernet controller Driver Serial Port Configuration Configuring the Serial Ports About Serial Port Device File Allocation Installing ntp clock To Install ntpclock ntpclock configuration ntp configuration Starting the ntpclock Installing MySQL To install MySQL Installing DALterm for DALinux To Install DALterm for Linuxv Configuring Auto start DALterm for DALinux Automatically Starting DALterm at Linux Login (OPTION) DALterm for Windows hwtrap Installation serial-utils Installation open-vm-tools Installing open-vm-tools Shared Folders Using DALinux Tools Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 5 of 112

6 Contents About the Kernel Watchdog Using DALterm Starting DALterm Command-line Options DALterm Operation Modes Mouse Support DALterm Fonts Logging Troubleshooting Using SER-4 Drivers Using SER 12 Drivers Using SER-16 Drivers Using SER-24 Drivers Using the AEC PCI-TC Driver Using the PCIe-TC Driver Supported Features/Functions Using D-Series Tools Using the D-Series Tools --help Option Using the dseries configuration utility Using the dseries utility Using the dseries-bug-reporter Using the dseries-crash-search utility PCI Utilities The lspci command Network Time Protocol About Time Synchronization DALinux Timezone Rules Validating Timezone Rules Using hwtrap About Hardware Traps Using the hwtrap Utility Using serial-utils About lsserial Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 6 of 112

7 Contents About serstress Using tcpdump Common Basic Usage DALinux Reference Section Using RPM Package Manager Installing Packages with RPM Erasing Packages with RPM Updating Packages with RPM Using Midnight Commander To Start Midnight Commander Main Screen Components Directory Navigation File Viewer File Editing Using PuTTY About dosfstools utilities D-Series Application Configuration Reference Configuring Material Management Support in Version 4 and 5 Products D-MAS Configuration D-AIS Configuration Appendix DALinux Package Versions PCIe Timecode Reader Device Driver Module Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 7 of 112

8 About this Document About this Document Introduction This document outlines the processes for installing and setting up / configuring DALinux and DALinux supplementary toolsets. The initial DALinux installation contains a standard Linux distribution with all of the tools associated with it. The DALinux Tools add-on package contains tools that are required for proper functioning of D-Series v4 and higher products (e.g. A7500, A7800, and D-FCS). The Intended Audience The intended audience of this document is Imagine Communications engineers and station engineers. The instructions presented in this document assume an engineering familiarity with: Linux or Unix Operating System installation and setup preferably a previously successful installation of DALinux, The installation and setup of D-Series automation products. Applicability This document applies to DALinux version 3 and DALinux Tools version 3. Recommended Reference For information on RPM Manager see Reference Section: Using RPM Package Manager Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 8 of 112

9 DALinux Installation and Configuration DALinux Installation and Configuration Before you Begin Before beginning the Linux install, below are a few tips on navigating Linux screens and selecting options on those screens. About Navigating Linux Screens Navigation of Linux screens is typically performed using the arrow keys (,,, ), but may when noted in the procedures require the use of the Tab key. About Selecting Screen Options and Fields Selection of screen options and fields is typically performed by: Using the arrow keys (,,, ), or when noted in the procedures the Tab key, to navigate to and highlight/choose an entry. Press <Enter> to accept the selection. DALinux Command Reference The following command subset is useful to know for managing DALinux. These commands are by no means exhaustive and are provided here in advance for your convenience. Command line hints The following table list DALinux command line hints. Command cp rm cd cd.. Description Copy Remove/Delete Change directories move up one directory --? (This is an option on some commands) The safe way to get help is using man and info (i.e. man ls or info cp ) Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 9 of 112

10 DALinux Installation and Configuration Command ls chmod passwd pwd ps Tab during command entry Description List contents by ls, with l or a for more information This command is not typically used during installation. It is used to alter a file's permission, e.g. whether it is executable, read, write or a directory, etc. Examples: chmod +w <filename> to make a file writeable chmod +x <filename> to make a file executable. Used to assign a password to a user account. Print working directory. This command is useful if you forget where you are, or are confused by the ~. lists all the processes that are running, so you know what to kill There is an autocomplete feature on the command line, and a command history (like doskey). Once you have typed in as much of the command to make it unique then you can use <Tab>, and the full command autocompletes. For Example: If you have three folders: /drives, /disks, /dentures, then cd de <Tab> completes as cd dentures. OR cd d<tab> lists all of the entries staring with d (i.e. drives, disks, dentures). Identify the entry you want (e.g. drives) and continue typing: cd dr <Tab> completes as cd drives. More on AutoComplete: Auto complete will also work when the command (e.g. pass<tab> will complete to passwd ). Auto complete will also work complete as much as possible, when ambiguity arises. For example, with folders dents, dentures, and dentry, d<tab> will complete to dent, awaiting for further input. vi hints:- You can do most of what you need in vi with a few helping hints:- Look at the bottom LHS of the screen, to see if you are in command mode (blank. Or with some message like file saved, etc), INSERT, or REPLACE mode. Move the cursor using the cursor keys to where you wish to edit. Press the i key to get it to say INSERT or REPLACE for what you want to do. Make the edit Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 10 of 112

11 DALinux Installation and Configuration Press the escape key to get the LH bottom line to be blank. Then do :w (colon) w for write, :q (colon q) to quit, :wq writes and quits, :q! quits without writing. Midnight Commander This is a text based GUI for managing the operating system which allows you to copy, move delete and edit files in a similar manner XTree Gold. It is installed with DALinux. mc: launches Midnight commander. Allows: Multi-pane display of different paths. Easy selection and File copy between panes. Edit, view, copy, etc. of files. Displays a command toolbar along the bottom of the application screen. For more information see DALinux Reference Section: Using Midnight Commander. Create a Bootable USB Flash drive The DALinux v3.3 software supports installing DALinux from a USB flash drive. Now the "Install Software" option of the installer has the "Install USB Flash" suboption, which makes it possible to select the USB Drive as the source of installation. The config-util package has been updated. Creating a Bootable USB Flash Drive YUMI (Your Universal Multiboot Installer) software creates a Multiboot USB Flash Drive containing multiple operating systems. This software is used for creating the USB Drive containing DALinux. 1. Download YUMI Multiboot USB Creator: 2. Run the YUMI.exe file (YUMI exe was used in development) following the onscreen instructions. 3. Select your USB Device. 4. Set the "We Will Fat32 Format" check. 5. Select the Try an Unlisted ISO item from the list box. 6. Select the ISO-image of DALinux in the edit box. 7. Click the Create button Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 11 of 112

12 DALinux Installation and Configuration (Option) Create CDs from ISO Images Optionally, DALinux can be installed from CD. The DALinux-Install-CD and DALinux-Tools are distributed as CD images (ISO9660 file system). DALinux-Install-CD-#.#.iso: This image contains all of the DALinux installation software. DALinux-Tools-#.#.iso: This image contains all of the DALinux tools and D-Series toolsets. Warning: Do not simply create a Data CD with the.iso file on it. It will not work! Creating the DALinux Install CD Step Action 1 Burn the DALinux-Install ISO image onto a CD using software that supports "Burn from ISO image" or "Create from.iso image." For example: On Roxio Easy CD Creator 5 choose to Make a Data CD, then from the menu select File>Record CD for CD Image Under Files of type select ISO Image Files (*.iso). Creating the DALinux Tools CD Step Action 1 Burn the DALinux Tools.ISO image onto a CD using software that supports "Burn from ISO image" or "Create from ISO image." For example: On Roxio Easy CD Creator 5 choose to Make a Data CD, then from the menu select File>Record CD for CD Image Under Files of type select ISO Image 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 12 of 112

13 DALinux Installation and Configuration Step Action Files (*.iso). 2 Once burned, you can access the tools and installation guide files as you normally would. Confirm Computer BIOS Settings Confirm the following settings are made on the computer BIOS. Set BIOS for Local Drive Boot Note: With DALinux v3.3 and higher it is possible to install DALinux using USB Flash drives. The first step in the installation of DALinux is to boot the computer from the installation USB Flash Drive. This requires a recent computer with BIOS that supports booting from a USB or local drive. If it is necessary to reconfigure the BIOS to search the USB Flash drive for bootable media, reference the manufacturer documentation for your BIOS for correct configuration instructions. When configuring the BIOS, ensure the USB Flash drive location precedes any hard disks in the configured boot sequence, otherwise an existing operating system may boot instead of the USB Flash Drive. (Optional) Set BIOS for CD Boot Optionally, DALinux can be installed from CD. The first step in the installation of DALinux is to boot the computer from the installation CD. This requires a recent computer with BIOS that supports booting from a CD and a CD ROM drive. Most computers built after approximately 1998 support booting from the CD ROM drive. If it is necessary to reconfigure the BIOS to search the CD ROM drive for bootable media, reference the manufacturer documentation for your BIOS for correct configuration instructions. When configuring the BIOS, ensure the CD ROM drive precedes any hard disks in the configured boot sequence, otherwise an existing operating system may boot instead of the CD. Note: With DALinux v3.1 and higher it is possible to install DALinux using any CD ROM drive on systems including multiple CD ROM drives Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 13 of 112

14 DALinux Installation and Configuration Set BIOS Clock to UTC DALinux requires/expects the BIOS clock to be in local time (e.g. Microsoft Windows or MS- DOS), set the BIOS clock to UTC. If forced to set the BIOS clock to local time, be aware of the consequences of this choice (e.g. manually updating the BIOS clock to handle daylight savings time changes). About Hyper-threading The following settings are mandatory for the respective version levels: Systems running DALinux versions 2.1 and below must have Hyper-Threading disabled and be run on a single cored processor. i.e. where the CPU has multi-core capability then only a single core must be enabled in the BIOS. DALinux V3.2 and above enables multi-cored, multi-threaded processing but only V5 automation versions are able to take advantage of this, so the following settings should be maintained:-,all V4 automation versions running on DALinux V3.2 and above must have only a single processor enabled in the BIOS and Hyper Threading must be disabled. All V5 automation versions running on DALinux V3.2 and above should have all cores and Hyper Threading enabled. Example settings locations: On the IBM Computers it is located under Advanced Settings. In the 3GHz machines using the Super Micro motherboards it is located in Power Settings. Install DALinux Linux provides fairly clear built-in instructions during the course of the installation. The following topics provide additional hints as to what to do while you are following the on-screen instructions. Installing DALinux requires the operator to: Perform the Initial Startup Prepare the System Partition the Hard Disk Configure Destination Partitions Configure Swap Partitions Install the Software 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 14 of 112

15 DALinux Installation and Configuration Perform the Initial Startup Depending on the installation approach used initial startup is performed via USB or CD. Start up from a USB Device 1. Insert the USB into the computer on which you wish to install DALinux. Note: Ensure the computer s BIOS is setup to allow USB first on boot. The system prompts for all needed information. 2. Restart your PC, boot from the USB device. The "Install Software" option of the installer has the "Install USB Flash" sub-option, which makes it possible to select the USB Drive as the source of installation. 3. Select the Directly Bootable ISO item: 4. Select the Boot DALinux-x.x.x.iso item: 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 15 of 112

16 DALinux Installation and Configuration 5. The DALinux installation procedure is started. IMPORTANT: Since it is extremely likely that the user need only press ENTER (to select the default options, see optional Step 6), Linux will boot automatically after 10 seconds without any keyboard input. If this approach is taken, skip to Step (Optional) Read the Welcome to Linux Installation screen and determine if you want/need to: (Recommended) Perform a Typical Installation. At the prompt, Boot: press <Enter> The system specifically recommends this installation type. This is the installation that will almost always be performed. Perform a special boot operation (The Welcome screen provides specific instructions and commands for these boot operations.) Pass parameters to the kernel. (Rarely necessary, but available if required.) Install a specific kernel for computers running older processors: Pentium M and Pentium (pre Pentium PRO). (Highly unlikely, but available if ever encountered.) Start the computer with reduced services for each Linux kernel installed. When this option is chosen, services such as D-Series will not start automatically. Result: The system boots and automatically logs in to the root, (i.e. root@linux:). 7. At the prompt type: setup (i.e. root@linux: setup). The setup utility presents a brief overview of the installation process. 8. Review the setup instructions in full and then press Escape <Esc> IMPORTANT: The system recommends that you have a copy of the documentation at hand Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 16 of 112

17 DALinux Installation and Configuration Start up from from a CD Step Action 1 Insert the burned DALinux CD into the computer on which you wish to install DALinux. Note: Ensure the computer s BIOS is setup to allow CD first on boot. The system prompts for all needed information. 2 Turn on the computer and /or Boot from the CD. Result: The system displays the Welcome to Linux Installation CD screen. Once the system cycles through the Welcome, a Boot: prompt appears. 3 IMPORTANT: Since it is extremely likely that the user need only press ENTER (to select the default options, see optional Step 4), Linux will boot automatically after 10 seconds without any keyboard input. If this approach is taken, skip to Step 5 4 (Optional) Read the Welcome to Linux Installation screen and determine if you want/need to: (Recommended) Perform a Typical Installation. At the prompt, Boot: press <Enter> The system specifically recommends this installation type. This is the installation that will almost always be performed. Perform a special boot operation (The Welcome screen provides specific instructions and commands for these boot operations.) Pass parameters to the kernel. (Rarely necessary, but available if required.) Install a specific kernel for computers running older processors: Pentium M and Pentium (pre Pentium PRO). (Highly unlikely, but available if ever encountered.) Start the computer with reduced services for each Linux kernel installed. When this option is chosen, services such as D-Series will not start automatically. Result: The system boots and automatically logs in to the root, (i.e. root@linux:). 5 At the prompt type: setup (i.e. root@linux: setup). The setup utility presents a brief overview of the installation process. 6 Review the setup instructions in full and then press Escape <Esc> IMPORTANT: The system recommends that you have a copy of the documentation at hand. Prepare the System The system preparation utility configures the hard disks and completes the general installation configuration. Select Prepare the System, and then press <Enter> Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 17 of 112

18 DALinux Installation and Configuration Partition the Hard Disk The first step in preparing the system for installation is to partition the installed hard disk(s) using the Create Partition(s) menu item. Note: These procedures assume an installation on an IDE drives. However, when installing on a system with SCSI drivers, the disks are called sda, sdb, etc. instead of hda, hdb, etc. Required Information During this procedure it is very important to make wise decisions, as repartitioning the hard disk at a later stage is often difficult. Before proceeding, here are some questions that should be considered: How many hard disks are present? What are their capacities? The answer to these questions is straightforward, but how it is used may not be. For Example If more than one operating system is present, perhaps each operating system should get its own disk. (IMPORTANT: Multiple operating systems is not recommended.) If only Linux is present, perhaps it uses only one disk (despite the presence of multiple disks). How much disk space does each operating system need? For Example DOS cannot handle partitions larger than 2GB, although it can handle several 2GB partitions. DOS can only access the first 8 GB of any single disk. A DALinux installation consumes less than 500MB, but easily supports drives Terabytes in capacity. Create Partition(s) The "Create Partition(s)" menu item is used to create 2 partitions on your hard disk, one for the system disk and one for the swap partition. Step Action 1 Select Create Partitions, and then press <Enter>. 2 From the Disk Partitioning menu, select the disk to partition, and then press <Enter>. This must be done one disk at a time as selecting a partition launches cfdisk: a third party disk partitioning utility. This menu includes the manufacture and capacity of the drive to assist in identifying the drives. The installation utility does not automatically partition the hard disk. A third-party disk partitioning utility, cfdisk, will assist in partitioning the hard disk Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 18 of 112

19 DALinux Installation and Configuration About Using cfdisk The interface to cfdisk is a little cumbersome. Screen navigation. The up and down arrow keys select a partition (or un-partitioned space) from the list near the top of the screen. The left and right arrow keys select a command from the list at the bottom of the screen. Commands: New, Type, Write, Quit, and Help. New: creates a new partition from un-partitioned disk space. Type: changes the type of an existing partition. Write: writes the partition table to disk Quit exits cfdisk. Help: cfdisk has an online help section accessible though the Help command. To write the partition table and exit, issue a Write command followed by a Quit command. To install DALinux on a disk: The following example installs DALinux (only) on a 2 GB partition with a 512 MB swap space: Step Action 1 If you have an empty disk: When partitioning a previously un-partitioned disk, cfdisk prompts: No partition table or unknown signature on partition table. Do you wish to start with a zero table [y/n]? Enter y (yes). If you are using an existing disk, Skip to Step 2. 2 hda1: On the cfdisk screen: Make Partition 1: [make partition 1, disk size the entire disk, except for the last 2 GB, = type 83 (Linux Type) bootable] a) Use and to select the free disk space item in the menu (on an empty drive, this should be selected) and then press <Enter> b) Use and to select New, and then press <Enter> c) Select Primary, and then press <Enter> d) Enter 2000, and then press <Enter> (This sets partition to 2 GB) e) Select Bootable, and then press <Enter> [This defaults/sets LinuxType: 83 (Bootable)] 3 hda2: Make Partition 2: [make partition 2, disk size -2gb, = type 82 (linux swap)] a) Down arrow to select remaining free space and then press <Enter> b) Select New, and then press <Enter> 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 19 of 112

20 DALinux Installation and Configuration Step Action c) Select Logical, and then press <Enter> d) Enter 512, and then press enter (This sets partition to 512 MB) e) Select Beginning, and then press <Enter> f) Select Type, and then press <Enter> (Displays a list of available entries.) g) Press <Enter> (Defaults/sets LinuxType: 82 (linux swap)) h) Press <Enter> 4 Select Write, and then press <Enter> 5 If required, type (yes), and then press <Enter>. Result: The system writes the partition table. 6 Select Quit, and then press <Enter> 7 Select Done, and then press <Enter> Configure Destination Partitions Use the "Configure Destination Partition(s)" menu item to format and mount the partition(s) you just created. This formats hda1 with ext3. Step Action 1 Select Configure Destination Partition, and then press <Enter> Displays a list of the partitions available. 2 Select Linux Partition, and then press <Enter> 3 Select Make a File System, and then press <Enter> 4 Select ext3 (recommended), and then press <Enter> The system formats the partition. When formatting completes the System prompts to accept. 5 Press <Enter> to accept OK 6 On the Configure System Hierarchy menu, select Mount the Partition (as the root partition), and then press <Enter> Note: Notice that the Set Mount Point menu item is inaccessible. This is because the first file system mounted must be the root file system mounted on / (pronounced root ). Once / is mounted, subsequent file systems can be mounted anywhere in the file system hierarchy. 7 Select Done, and then press <Enter> 8 Select Done, and then press <Enter> 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 20 of 112

21 DALinux Installation and Configuration Configure Swap Partitions Use the "Configure Swap Partition(s)" menu item to configure the virtual memory and activate swap on hda2. This menu permits the activation and deactivation of swap partitions. The Linux kernel uses swap space to provide a feature called virtual memory. Virtual memory allows Linux to provide applications the illusion that there is more physical memory (RAM) than what is pre-sent in the system. It does this by temporarily copying (swapping out) RAM that has been allocated to a process - but not currently used - to disk, and reallocating that RAM to another application. Linux supports two types of swap spaces: swap partitions and swap files. A swap partition is a partition on a hard disk used exclusively for swapping. A swap file is an ordinary file, located somewhere on a hard disk, that is used for swapping. <Note: Swap files are not supported for D-Series automation.> Step Action 1 On the Linux System Preparation (expert mode) screen, select Configure Swap Partition(s), and then press <Enter> 2 Select Activate a Swap Partition/File, and then press <Enter> 3 Select the system swap partition (e.g. /dev/hda2), and then press <Enter> Note: Unless you were required to spread the swap space over several partitions, the installation utility displays the single swap partition you created. 4 Select Done, and then press <Enter> 5 Select Done, and then press <Enter> Install the Software Use the "Install Software" menu item to install the system software by selecting the following menu items as you are presented with them: Select Package Source Probe all removable media drives Select Packages to Install Typical / Standard Installation Install Selected Packages Step Action 1 Select Install Software, and then press <Enter> 2 Select Select Package Source, and then press <Enter> 3 Select Install CD, and then press <Enter> 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 21 of 112

22 DALinux Installation and Configuration Step Action Note: DALinux currently supports installation from the installation CD (likely used to boot the system). 4 Select Probe all installed CD Rom drives, and then press <Enter> Each installed CD-ROM drive (including CD burners, DVD-ROM drives and DVD burners) is successively scanned until one is found that contains the installation CD. When the probing is complete, a confirmation dialog, containing either an error message or the name of the device that contains the installation CD, appears. When complete a dialog appears: Using /dev/hdd as package. source CD 5 Press <Enter> to accept OK. 6 Select Select Packages to Install, and then press <Enter> DALinux can perform any one of four installations, used under various circumstances. Installation Set Description Minimal This installs the most basic software packages required to run a DALinux installation. This does not contain very much useful software and is for very small systems that will have a custom set of packages installed manually after the initial installation). Typical (Recommended Selection) Development Full This installs the most typical software required for running D- Series products. This is the software set to install under most circumstances. This installs software typical for development systems. It includes all software packages available in the Typical installation, plus additional packages for developing software (such as compilers, development libraries, and other development tools). This installation set is not recommended as it installs several software packages that are not useful in a broadcast environment. This installs all of the software packages. This installation set is not recommended as it in-stalls several software packages that are not useful in a production environment. 7 Select Typical Installation, and then press <Enter> The system displays a progress bar for Determining inter-package dependencies. 8 Select Install Selected Packages, and then press <Enter>. The software packages are copied from the source medium (likely the installation CD) onto the configured destination partition(s). Depending on the computer, this process can take several minutes to complete. The system shows each package as it s processed and displays a brief description of each package Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 22 of 112

23 DALinux Installation and Configuration Step Action 9 When installation completes the System prompts to accept. Press <Enter> to accept OK. Configure the System From the main menu, use the "Configure the System" menu item to configure the system. Configure the components in this order: Clock, Network, Bootloader. Configuring the system requires the operator to: Configure System Clock and Timezone Configure Network Set Bootloader Manage User Accounts Set Administrator Password Finalize the Install and Reboot the System Configure System Clock and Timezone Configure the system clock to ensure the system displays the correct time. This consists of two components: the time reported by the hardware clock and the local time zone. Modern PCs have a hardware clock (also called the real time clock, or RTC) that keeps time, even when the PC is turned off. Reading the real time clock is a very expensive operation, so most modern operating systems initialize the system time by reading the real time clock when the system starts up and maintaining the system time in parallel with the hardware clock. The hardware clock is, in general, updated when the system shuts down, or periodically to ensure that the clock doesn t drift dramatically from the system time. This is exactly how DALinux uses the real time clock. The real time clock has no concept of time zones. It simply keeps time in an arbitrary time zone and leaves the responsibility of interpreting this time to the operating system. DALinux supports storing the time in two different time zones: the local time zone and UTC (Universal Time Coordinated). Step Action 1 Select Configure the System, and then press <Enter>. 2 Select System Clock, and then press <Enter>. 3 Select Set Clock Mode, and then press <Enter> Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 23 of 112

24 DALinux Installation and Configuration Step Action 4 If House Clock/Feed is set to: UTC, then choose UTC Local Time, then choose Local Timezone Note: The selection should always be UTC. 5 A dialog containing the time read from the real time clock appears. This selection can be accepted or rejected, so it is possible to change the clock mode if the initial choice is incorrect. To accept select YES, then press <Enter>. Note: If the time displayed is neither the correct local time nor the correct UTC, pick one of these two time zones and proceed with the installation. When you reboot the system next, simply adjust the real time clock (through the BIOS) to match. You may also switch to another console (e.g. ALT+F2) and set the time using the hwclock command: # hwclock --set --date HH:MM:SS # Note: DALinux version 3 and higher disables the hardware clock update from within the kernel (the update method used in earlier versions). It synchronizes the hardware clock by running a script every hour that uses hwclock to set the hardware clock, and also sets it when shutdown cleanly. This utility has full knowledge of the local time zone and the hardware clock time zone and updates all fields of the hardware clock, not just minutes and seconds. 6 Set the Timezone. a) Select Set Local Timezone b) Select the Timezone Region c) Select the Timezone County d) When the time zone has been resolved a confirmation dialog is displayed showing the current time in both the local time zone and UTC. System prompts to confirm current time - If OK, select Yes. - If incorrect, select No and then correct. Note: If the real time clock was not in a supported time zone and you elected change the time after rebooting, the times presented will likely be incorrect. 7 Select Done, and then press <Enter> About DALinux Timezone Rules DALinux contains up-to-date timezone rules for daylight / standard transitions; making then consistent with rules currently distributed with other major Linux distributions. This includes 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 24 of 112

25 DALinux Installation and Configuration correct transitions as of May 10, 2010, plus any future changes that were known at that time. There are many other changes to timezone rules that are too numerous to mention. For information on how to ensure the timezone rules are correct for the region DALinux is being installed in, see section Using DALinux Tools: DALinux Timezone Rules. If the times of these transitions change in the future, a revised file for the appropriate time zone can be requested. For details see Using DALinux Tools: Fixing DALinux Daylight Time Problems. Removing Sethwclock Important: To avoid a freeze in DMAS operations manually remove sethwclock from the /etc/cron.d/hourly directory. Otherwise, sethwclock will run every hour and incur the risk of stopping the CPU BIOS/HW clock so nothing ever runs in DMAS. Configure Network In order to allow network connections into or from the new DALinux installation, configure the network. This consists of configuring three components, the Network Interface Cards (or NICs), the host-name, and binding or unbinding the configuration for an interface with specific hardware based on MAC addresses. To configure the networks requires the operator perform the following procedures: Configuring Adapters Set Host Name Configuring Adapters DALinux does not support the Dynamic Host Configuration Protocol (DHCP) used by many networks to centralize IP address configuration. DALinux only supports static IP addresses. From the Network menu, perform the following steps for each adapter. Step Action 1 Select Network, and then press <Enter>. Note: Use the Tab key to navigate this screen set. 2 Select Configure Network Adapters, and then press <Enter>. 3 The configuration of a NIC consists of 4 items: The IP address, the netmask, the gateway, and whether the card is enabled. Most configurations require specification of the IP address and whether the enabled state of the card. Interfaces are listed along with properties of the interface (such as IP address, whether it is enabled, or whether the corresponding hardware is installed). For example: eth0 ( /24,01:23:45:67:89:AB,Not Present) Network interfaces that are configured, but not present (i.e. the hardware has been removed from the system), are included in the list. Perform the following steps for each network card (eth0, eth1, eth2): 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 25 of 112

26 DALinux Installation and Configuration Step Set Host Name Action a) Select the network card b) Enable: Y c) Set IP Address d) Set the Netmask appropriately for each eth# based on the type of IP address - 10.x.y.z, set to x.y to x.y, set to x.y, set to Note: If the specified IP address is a standard class A, B, or C network address, the netmask is automatically selected. However, if this computer does not use standard netmasks, change the netmask to be correct for the network. Example: For D-Series CPU1: - eth0: eth1: eth2: e) Set the Gateway - If no Gateway is in use, leave this field blank. - If a Network Gateway is in use, set the Gateway field to the IP address of the gateway computer for that NIC. A common practice for isolating networks is to use a gateway computer to segregate two or more subnets. Computers within a subnet will communicate without using the gateway. When a computer on one subnet must communicate with a computer on another subnet, the originator sends the data to the gateway computer; the gateway computer forwards the traffic to the appropriate subnet. For IP addresses reference: Preferred D-Series System TCP/IP Assignments at the end of this document. (e.g. For D-Series - eth0: Automation LAN, eth1: Information LAN, eth2: Real Time LAN) 4 Tab to OK, and then press <Enter> 5 Select Done, and then press <Enter> The hostname, along with the domain name, identifies the computer. The hostname is the name of the individual computer. It is always a good idea to select a unique host name as the login prompt and all system logging uses it Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 26 of 112

27 DALinux Installation and Configuration Important: Once the MySQL software package has been installed, do not change the hostname. Changing the hostname after MySQL is installed will result in MySQL not working. Step Action 1 Select Set Host Name, and then press <Enter>. 2 Set this to something reasonable. For Example: Prompt>A7500CPU1 Recommendations: - Since the hostname is used on the prompt, it is helpful to specify a name to identify the machine (i.e. GCRCPU1 etc.) - If possible, specify a name no longer than 7 characters. 3 Press <Enter> Binding an Interface to Specific Hardware The network configuration dialog supports binding the configuration for an interface with specific hardware, based on MAC addresses. This ensures each time the system is restarted a network adapter has a deterministic interface name, even if hardware was relocated within the machine. Interface binding provides a much more flexible interface than previously available. Instead of adapters being assigned to interfaces based on type (e.g. manufacture and model) and motherboard bus topology, they can be assigned interface names based on other arbitrary criteria (e.g. adapters are assigned interfaces from left to right, with onboard adapters being assigned last). NOTE: There is no requirement to bind interfaces to specific hardware (and the configuration dialog allows interfaces to not be bound). However, normally, all interfaces are bound. Adding Network Adapters When a network adapter is added to a computer, it is assigned an unused interface name (e.g. eth4). When configured using the network configuration dialog, the interface is automatically bound to the assigned hardware. Unless unbound, the interface name assigned to the network adapter (e.g. eth4) is always associated with that network adapter (even if physically removed). Removing Network Adapters When a network adapter is removed from a computer, the interface that was bound to it (e.g. eth4) is not reassigned to any other network adapters and the configuration is retained for when the network interface is reinstalled. If another network adapter replaces the one being removed, it is assigned an unused interface name (e.g. eth6), unless explicitly changed. See the Example below Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 27 of 112

28 DALinux Installation and Configuration Associating a Network Interface with an Adapter Example In addition to the usual network configuration settings (IP address, network mask, gateway, etc.), the network configuration dialog allows the hardware address of the interface to be specified. The prompt for doing so is a simple list, whose selected item can be changed by using the and arrow keys. No two network interfaces can be assigned to the same adapter. As such, assigning a network adapter to an interface removes the association that network adapter had with any other interface. For convenience, the list of MAC addresses includes the interface currently assigned to the network adapter (enclosed in parentheses to the left of the MAC address). The following example helps explain how network adapters are assigned to interfaces and how this impacts binding interfaces to names. In this example, two adapter with MAC addresses 11:11:11:11:11:11 and 22:22:22:22:22:22 are present when the system is initially installed. Later, the adapter with MAC address 11:11:11:11:11:11 is replaced with a third adapter with MAC address 33:33:33:33:33:33. When the system is initially installed, one of the two adapters is assigned to the interface eth0 while the other is assigned eth1; assume 11:11:11:11:11:11 is assigned eth0 and 22:22:22:22:22:22 is assigned eth1. Configure eth0 and eth1 as usual. Later, the first adapter (with MAC address 11:11:11:11:11:11) fails and is replaced by a third adapter (with MAC address 33:33:33:33:33:33). When the system is restarted, the third adapter is assigned the interface eth2 (since eth1 is being used with the second adapter and eth0 is being reserved for the first adapter that was removed), making eth1 (assigned to the adapter with MAC address 22:22:22:22:22:22) and eth2 (assigned to the adapter with MAC address 33:33:33:33:33:33) the names of the available interfaces. Since the first adapter (with MAC address 11:11:11:11:11:11) is faulty and will not be used again, it is safe to reuse this interface name. The network configuration dialog can be used to rebind eth0 to the third adapter (with MAC address 33:33:33:33:33:33), preserving all configuration. When the network configuration is saved, eth2 will be renamed to eth0, making eth0 (assigned to the adapter with MAC address 33:33:33:33:33:33) and eth1 (assigned to the adapter with MAC address 11:11:11:11:11:11) the names of the available interfaces. Configure Bootloader (GRUB) The bootloader is a small program used to bootstrap the system; DALinux uses the GRUB bootloader. GRUB is a fully configurable bootloader that supports custom boot menus. On the System Configuration screen, select the Bootloader menu item to install and configure the bootloader. Note: The bootloader only needs to be installed once, but it is completely safe to install the bootloader multiple times. The installation of the bootloader may occur before or after configuration Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 28 of 112

29 DALinux Installation and Configuration WARNING: During the automatic configuration, several options may be available. For example, if both a DOS and Linux installation are present, the automatic configuration will prompt for which operating system to boot by default. If None is selected from this menu, GRUB will always wait for input before starting an operating system. Do not select the NONE option in a broadcast environment! This is because in the event of a system reboot, user intervention is required to restart the system. Step Action 1 On the System Configuration screen, select the Bootloader, and then press <Enter>. 2 Select Automatic Configuration, and then press <Enter>. The bootloader configuration can probe the system for installed operating systems and generate a default configuration based on the results. This item is used to automatically configure the bootloader (this also detects any DOS installations). (ALTERNATE) If Automatic Configuration fails to correctly configure GRUB, or the defaults chosen (e.g. the timeout) select Manual Configuration from the menu item to make these manual adjustments. 3 When the automatic configuration is complete, a confirmation dialog appears. It is possible to view the generated configuration file from this dialog. To view the Bootloader GRUB Configuration file: Select Yes, and then press <Enter>. Review the Bootloader file Select <Esc> to close. To skip viewing the Bootloader GRUB Configuration file: Select No Press <Enter> 4 The bootloader resides on a special section of the hard disk so that the BIOS can load it. In order to place the bootloader in the correct location on the hard disk and make the system bootable: Select Install Bootloader, and then press <Enter>. 5 When done, the system prompts for acceptance. Press <Enter> to accept OK. 6 Select Done, and then press <Enter> Setup User Accounts At this point in the configuration, the only usable account on the system is the root (Administrator) account. The administrator account has unrestricted access to the entire system. So it is necessary to create a user account to log into the system Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 29 of 112

30 DALinux Installation and Configuration The creation of the new user is straightforward; the only necessary information to provide is the name and password of the account. Use the default values provided for all other values. In the "Configure the System" menu, select the "User Accounts" menu item to set up default user accounts. Use the following procedures to: Setup a 'harris' User Account Setup Customer-related User Accounts About Alternate Password Assignment Method: If during user account creation you are not prompted to specify a password (i.e. after entering the account user name you press <Enter> instead of TAB), specify passwords for the admin and user accounts after the installation is complete. For details see Alternate Password Assignment Method. Setup a harris User Account Use this procedure to setup the default harris user account. This account (Username: harris, login: harris) is used for performing Telnet / FTP Access. It is necessary because Linux will not allow access via Telnet / FTP using the System Admin account (Username: root, login: harris). IMPORTANT NOTE ON PASSWORD ENTRY: Ensure keyboard Caps Lock is off. When entering the password the cursor does not move and you are unable to see the text you are entering. Step Action 1 On the System Configuration screen, select the User Accounts, and then press <Enter>. Result: The Manage User Account dialog appears. 2 On the Manage User Account dialog, select Add a New User, and then press <Enter>. Result: A dialog appears requesting specification of Username:, Shell:, and Home: 3 Enter the standard/default user name for this account: harris 4 Press <Enter>. Result: The system populates the Shell:, and Home: fields with default values, and automatically accepts all of the default values. On completion, the system notifies that a new user was successfully added. A Note in Manual Entry: If manual entry of fields is required, you can instead Tab through the fields to make specific entries and then select OK when done. 5 Press <Enter> to accept OK. 6 Enter the standard password for this account: harris (all lowercase), and then press <Enter>. 7 To confirm, reenter this password, and then press <Enter> Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 30 of 112

31 DALinux Installation and Configuration Step Action 8 Press <Enter> to accept OK 9 If you are Setting Up customer-related user accounts, continue with the following procedure Manage User Accounts: Setup Customer-related User Accounts. If you are NOT Setting Up any customer-related user accounts: Select Done, and then press <Enter>. Select Done, and then press <Enter>. Continue with the procedure: Setting Administrator Password Setup Customer-related User Accounts Use this procedure to setup any customer-related user accounts. These accounts (Username: customer related, login: customer-defined ) are used for logging in and starting DALterm. IMPORTANT NOTE ON PASSWORD ENTRY: Ensure keyboard Caps Lock is off. When entering the password the cursor does not move and you are unable to see the text you are entering. Step Action 1 On the Manage User Account dialog, select Add a New User A dialog appears requesting specification of Username:, Shell:, and Home: 2 Enter the customer-related user name for this account. (recommend all lowercase). 4 Press <Enter>. Result: The system populates the Shell:, and Home: fields with default values, and automatically accepts all of the default values. On completion, the system notifies that a new user was successfully added. A Note in Manual Entry: If manual entry of fields is required, you can instead Tab through the fields to make specific entries and then select OK when done. 3 Press <Enter> to accept OK. 4 Enter the customer-defined password for this account (recommend all lowercase), and then press <Enter>. 5 To confirm, reenter this password, and then press <Enter>. 6 Select OK. 7 Repeat steps 1-6 for each required Customer-related User Account. 8 Select Done, and then press <Enter>. 9 Select Done, and then press <Enter> Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 31 of 112

32 DALinux Installation and Configuration Step Action The system returns to the main Linux installation and Configuration screen. Set Administrator Password From the main menu, use the "Set Administrator (root) password" menu item to set the administrator's password. This is an important password as using it will gain full access to the system. Select a password that is easy to remember (so it doesn t have to be written down), but hard to guess. WARNING: When the system reboots, you will need to log on as root (using the password) to do anything, so DON'T FORGET IT. This password is not retrievable, and is very difficult to change. IMPORTANT NOTE ON PASSWORD ENTRY: Ensure keyboard Caps Lock is off. When entering the password the cursor does not move and you are unable to see the text you are entering. Password Guidelines IMPORTANT: Imagine Communications has strict guidelines regarding the standard root password used for DALinux installations. Use the standard root password, even if it doesn t follow these guidelines! Passwords are case sensitive and can contain any character (including punctuation). A good root password will contain both upper and lower case characters, numbers, and punctuation. Step Action 1 On the main Linux installation and Configuration screen, select Set Administrator (root) password, and then press <Enter>. 2 Enter the standard / default administrator's password for this account: harris (all lowercase), and then press <Enter>. 3 To confirm, reenter this password, and then press <Enter>. 4 Select OK 5 On the main Linux installation and Configuration screen, Select Quit, and then press <Enter>. Finalize the Install and Reboot the System Step Action 1 Remove the CD from the drive 2 Reboot the computer with (CTRL+ALT+DEL) or typing: shutdown -r now Result: The Linux system reboots Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 32 of 112

33 DALinux Installation and Configuration Step Action 3 After reboot log back into the system. At prompt Linux Login: root Enter password: harris (all lowercase) About Starting with Reduced Services at Boot At boot time DALinux allows an operator can select to Start the computer with reduced services for each Linux kernel installed. When this option is chosen, services such as D-Series will not start automatically. To start D-Series or other service not started when the reduced services option is selected, execute the following command as the user root: telinit 5 This command changes the current run level from 3 to 5, starting the remaining services. Alternate Password Assignment Method If during user account creation you were not prompted to specify a password (i.e. after entering the account user name you press <Enter> instead of TAB), specify passwords for the admin and user accounts after the installation is complete. Once default users have been created in the config tool, use the command passwd to assign each user a password. Step Action 1 At the prompt type passwd <user>. Result: The system prompts you to change the password for that user. (e.g. passwd harris, would prompt for harris password change.) 2 Enter the password for this account (recommend all lowercase), and then press <Enter>. User Name Password Use / Rights root harris System Wide Access harris harris Telnet / FTP Access dais daispwd User for logging in and receiving reports (Customer Related Users) (Customer Defined) 3 To confirm, reenter this password, and then press <Enter>. User for logging in and starting DALterm 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 33 of 112

34 DALinux Installation and Configuration (Optional) Mount the Drives Most D-Series Automation engineers use samba to copy files in/out. The following information is provided those situations where this approach is required. Drives cannot be recognized until they are mounted. Drive cannot be mounted until there is media in the drive. DVD Interface Enhancement Note: DALinux v3 and higher recognizes additional PCI device IDs for newer optical drive interfaces. This was required to support the DVD drive interface on the HP Proliant G6. CDROM Drive Step USB Drive Action 1 Put media in the CDRom Drive. 2 At system prompt: modprobe ide_cd Note: If no media is in the drive the system displays the message: You must specify the file system. 3 At system prompt: mount /media/cdrom 4 To Unmount the drive: umount /media/cdrom This unmounts the file system and allows you to remove the CD. Note: If you change CDs, you must mount the cdrom. To remove the CD you must unmount the cdrom. Hint: Ensure the USB Port is enabled in the computer BIOS. Step Action 1 Plug the USB Stick or USB drive cable into the USB port. Note: No modprobe required. 2 At system prompt: mount /dev/sda1 /media/usbdrive Note: The USB drive is not always /dev/sda1. It depends heavily on the other drives in the system. The easiest way to determine the name of the drive is to look at the contents of /sys/block before and after the USB driver is inserted. A new directory will be created for the USB drive. 3 You can now 'ls' (list) the /media/usbdrive 4 To Unmount the USB Stick: umount /media/sda Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 34 of 112

35 Configuring SAMBA/SWAT on DALinux V4 Systems Configuring SAMBA/SWAT on DALinux V4 Systems About Samba Some software packages require configuration before they become useful. Configuration of these software packages cannot occur during the installation phase, but can occur after the initial boot of the installation. This section outlines the configuration for those software packages. Samba is a software package designed to allow a non-windows computer participate in a Windows network. Samba provides both a client (to view other computers from the Sambaenabled computer) and a server (to view the Samba-enabled computer from other computers). The client does not require any configuration but the server does. Samba also includes a webbased configuration program called SWAT (Samba Web Administration Tool). This section describes how to set up Samba using SWAT. To Configure SAMBA/SWAT Assumptions: The following procedures provide instruction on configuring SAMBA on DALinux v3. DALinux is already installed on the appropriate computer The DALinux machine has a network card that s been allocated an IP address and is on the INFO LAN. DALinux v3 and higher includes a bootscript for the winbindd daemon, making it possible to authenticate users against a Microsoft Windows NT Domain controller. The winbindd daemon is disabled by default. Log on the DALinux Step Action 1 Log on the DALinux system. 2 At the prompt enter Linux Login Username: root 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 35 of 112

36 Configuring SAMBA/SWAT on DALinux V4 Systems Step Action 3 Enter password: harris (all lowercase) Set the SAMBA Password In order to use SWAT, root must have a samba account. Use the following procedure to set the password for the user root on SAMBA. Note: Samba uses its own user and password database separate from the system's database (found in /etc/passwd); however, all Samba users must have a system account. Step Action 1 At the command prompt, type the following: smbpasswd a root 2 The system prompts: New SMB passwd: ******** Note: The asterisks are not displayed, but are shown to indicate the required typing. The password should always be harris. 3 The system prompts: Retype new SMB passwd: ******** Note: The asterisks are not displayed, but are shown to indicate the required typing. 4 If successful, a message similar to the following should appear: startsmbfilepwent_internal: file /etc/samba/private/smbpasswd did not exist. File successfully created. Added user root. Note: Don't worry about the warning of /etc/samba/private/smbpasswd not existing, smbpasswd creates it for you. Note: This warning is not shown if the password file already exists. About Passwords: The password need not be the same as root's system account. It is more secure to have these passwords different. Changing the system password using passwd will not change the Samba password. Use smbpasswd to change the Samba password. Like the root password for the system, Imagine Communications has strict guidelines regarding the root password for samba. Use the standard root password for SAMBA, even if it doesn t follow these guidelines! Access the Samba Web Administration Tool Step Action 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 36 of 112

37 Configuring SAMBA/SWAT on DALinux V4 Systems Step Action 1 Connect your laptop/machine (Windows based) to the same INFO LAN that the DALinux machine is on. Note: At this stage, it is assumed that the DALinux machine has a network card that s been allocated an IP address and is on the INFO LAN. For illustration purposes, let s assume the DALinux machine has an IP address of On your laptop/machine (configured to be on the same network), open an IE and type the following in the address bar: This opens the SAMBA / SWAT Web Administration Tool page. Create Shares on SAMBA Use this procedure to create a share on SAMBA. Step 1 Action On the Samba Web Administration Tool page, select the SHARES icon. 2 Create a folder where all the sub folders on the DALinux machine will reside Next to the Create Share button, type any name you want. (For this example we ll use All ). 3 Select the Create Share button. This creates the All folder. 4 DALinux v3.1 and higher includes a Samba package which contains a default path for shares, inherited by newly created shares. This default path, /change-this-value, 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 37 of 112

38 Configuring SAMBA/SWAT on DALinux V4 Systems Step Action must be changed by the user before the share will work correctly. Set Share Parameters Use this procedure to set the Base Options and Security Options for the share on SAMBA. Step 1 Action Click the drop-down arrow to display al list of available Shares. This dropdown is located beside the Choose Share button 2 From the list select the appropriate share. (For this example select the previouslycreated folder All.) 3 After choosing the correct share (in this example the All folder), click on the Advanced button. The application shows an expanded view of the Advanced Share Parameters for the selected share (e.g. the All folder). Since there are more parameters than can fit on a screen, this display is spread across two screen sections. - The first showing the Base Options. - The second showing the Security Options. 4 Set the Base Options. In the path, remove what is there by default and type /. 5 Set the Security Options. Scroll down to the next section (Security Options) and ensure the 'read only' is set to 'No Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 38 of 112

39 Configuring SAMBA/SWAT on DALinux V4 Systems Step Action 6 Set the Miscellaneous Options: Scroll down further to the section called Miscellaneous Options and ensure the available field is set to YES 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 39 of 112

40 Configuring SAMBA/SWAT on DALinux V4 Systems Step Action Conclude the SAMBA Configuration Use this procedure to conclude the SAMBA configuration. Step Action 1 From the Security Options section scroll back up to the Share Parameters display (Base Options section) 2 Click on the Commit Changes button Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 40 of 112

41 Configuring SAMBA/SWAT on DALinux V4 Systems Accessing DALinux (Samba Server) from a Windows Machine Step Action 1 Ensure your computer is on the same LAN as the Samba Server (For this section - the DALinux machine running V4 software) 2 Configure your laptop to be on the same network by assigning an IP Address such as (this IP Address should be available and not taken by any other clients on the network) 3 On your laptop/machine, from the Windows desktop select Start>Run (Note: There are other ways of accessing another machine on the same network. You can use any of those methods if you like.) 4 On the Run dialog, in the Open line type: \\ IP address of the Automation running DALinux (with the Samba Server running) (For example: \\ ) 5 Press <OK> Internet Explorer opens to that address. The Connect to Linux dialog box prompts for Username and Password. 6 On the Connect to Linux dialog box, Enter Username: root Enter password: harris (all lowercase), Press OK A window opens displaying all the folders you are allowed to view. The share set up when configuring SAMBA is listed (e.g. the All folder). For example: 7 Select the share folder (e.g. the All folder) to display all the sub folders that can also be found on DALinux machine. Those familiar with DALinux will recognize all the above folders Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 41 of 112

42 Configuring SAMBA/SWAT on DALinux V4 Systems Step Action 8 From there you can copy, paste, create new folders in the usual Windows way. WARNING: Do not edit files on a running system Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 42 of 112

43 DALinux Tools Installation and Setup DALinux Tools Installation and Setup Introduction This section provides a brief overview of each tool and outlines procedures for installing DALinux supplementary tools on a previously installed and configured DALinux system. Information on using these tools is addressed in reference section: Using DALinux Tools. You can also reference documentation that accompanies the tools. For information on RPM Manager see Reference Section: Using RPM Package Manager. Contents of the DALinux Supplementary Tools The initial DALinux installation contains a standard Linux distribution with all associated tools. The DALinux Tools add-on package contains tools that are required for proper functioning of D- Series v4 products. DALinux-Tools is distributed as a CD image (ISO9660 filesystem). To access the tools and installation guide, burn image onto a CD and access the files as you normally would. DALinux Add-on Tools are comprised of the following RPM packages: Package Version Description aec-pci-tc 3.1 Drivers for the Adrienne Electronics Corporation (AEC) PCI- TC family of PCI bus plug-in cards harris-pci-tc Drivers for the Harris PCIe Timecode card DALterm for DALinux DALterm for Windows 1.2 DALterm remote or local console for D Series products that runs on DALinux. This provides access to text-based interface of a D-Series product from the Linux console. This has a similar functionality as DALterm for windows. 1.3 DALterm remote console for D Series products that runs on Microsoft Windows. dseries-tools 1.1 A set of tools essential for the maintenance of D-Series products. hwtrap 1.2 A debugging utility for setting hardware breakpoints and watch-points. mccurdy-ser A driver for McCurdy SER 12 highspeed, multiport, ISA serial cards Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 43 of 112

44 DALinux Tools Installation and Setup Package Version Description mccurdy-ser12- config 3.1 A tool for configuring McCurdy SER 12 highspeed, multiport, ISA serial cards. ntpclock 1.2 Application that provides time from reference timecode to NTP serial utils 1.2 A collection of utilities for managing serial ports. timecode-config 3.1 Configuration for (LTC) timecode readers (such as those provided by the AEC PCI-TC) About rpm File Naming Conventions For Example: DALinux tool filenames follow the same naming convention syntax: <package name> <version> <revision> <architecture> <.rpm format> dseries-tools i386.rpm is the name of the file that contains the D-Series tools package dseries-tools is the name of the package 1.1 is the version 3 is the revision i386 is the architecture. rpm is the file format D-Series Tools The D-Series Tools package contains a set of tools essential for managing installed D-Series products. The following tools are included: Utility Description dseries Simplifies the process of starting/stopping installed versions of D- Series products. dseries-bug-reporter dseries-crash-search Dseries config utility Generates an archive containing the necessary information that must accompany all SPR reports. Searches for crashes involving D-Series products and creates bugreport archives. The configuration utility accessible using the config command 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 44 of 112

45 DALinux Tools Installation and Setup Installing D-Series Tools Since the dseries-tools package only depends on packages installed by the Typical Installation, no additional software is required. Once you have installed dseries-tools, you can then configure everything by doing config. Step Action 1 Before installing, copy all rpm files to a directory call /opt/dal/packages 2 At the prompt type cd / Result: Resets directory to root. 3 Set path to /media/cdrom/tools 4 Install the dseries-tools package as a normal RPM package. Enter the command: rpm -ihv dseries-tools i386.rpm Result: Install tools in the /opt/bin directory Installing Drivers The drivers you install must be compatible with the kernel, so it is important to know how to identify which drivers apply the various kernels. IMPORTANT: The rt29 kernel is not compatible with add-on drivers not compiled specifically for this kernel. Be sure to install the appropriate drivers. Determining Which Kernels are Installed Unless additional kernels were installed manually, only the up variant of DALinux will have been installed. This variant of the kernel is intended for uniprocessor (UP) computers supporting no more than 4 GB of RAM (small memory model). To be certain, use the following command to acquire an authoritative list. For example: # rpm qa grep ^kernelkernel-standard rt29-1 Only a single kernel that is compatible with all i386 CPUs and newer is available on the boot CD. This removes the potential of booting with a kernel that does not support the CPU available. Kernel Package Name Structure The package name of each kernel contains information about the features it includes. The format is as follows: 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 45 of 112

46 DALinux Tools Installation and Setup kernel-<variant>-<version>-<release> (e.g.: kernel-standard rt29-1) Where, <VARIANT> denotes the kernel variant (standard in this example). <VERSION> is the kernel version ( rt29 in this example); <RELEASE> is the RPM package version (1 in this example). The kernel variants supported by DALinux are as follows: DALinux Kernel Variants In most cases, the standard kernel should be installed. Variant standard pae Description A multiprocessor kernel, suitable for systems with multiple processors and/or multi-core processors with less than 4 GB or RAM. This kernel supports up to 8 (logical) processors. This variant does not have suffix. A multiprocessor kernel, suitable for systems with multiple processors and/or multi-core processors with more than 4 GB or RAM. This kernel supports up to 64 GB of RAM using Intel s PAE (Physical Address Extension) support and up to 8 (logical) processors. This variant uses the pae suffix. PREEMPT_RT real time extensions to the kernel These extensions improve the real time response of the Linux kernel from less than two milliseconds to several tens of microseconds. For example: rt29 To Determine the Kernel Version To determine which version of the kernel is currently running, use the uname command. For example: # uname r rt29-standard Driver Compatibility Linux drivers are built against specific kernels. Certain compile-time features must be consistent between drivers and kernels; otherwise they are not compatible. These features are specified by kernel variant (e.g., up or smp) and version (e.g., for DALinux version 2.0). Because of this restriction, each driver requires a separate version for each of the supported kernels. Fortunately, each driver knows which kernel it is compatible with and ensures that the appropriate kernel is present before it can be installed. However, if multiple kernels are 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 46 of 112

47 DALinux Tools Installation and Setup installed, multiple versions of the driver must be installed (one for each kernel). Information about kernel compatibility can be extracted from the names of driver packages. Driver Naming Scheme The name of each driver package contains information about the features it includes. The format is as follows: <DRIVER>-<VARIANT>-<VERSION>-<RELEASE>_<KERNEL_VERSION> Where: <DRIVER> is the name of the driver; <VARIANT> is the name of the kernel variant against which the driver was built; <VERSION> is the version of the driver; <RELEASE> is the RPM package version; If standard is present in the name, the kernel supports multiple processors. If pae is present in the name, the kernel supports up to 64 GB of RAM. The kernels supported by DALinux are: Kernel Standard pae Description multiple processors with up to 4 GB of RAM multiple processors with up to 64 GB of RAM For Example: <KERNEL_VERSION> is the version of the kernel against which the driver was built. For example, in the case of the driver, mccurdy-ser12-standard-3.1-1_ rt29: mccurdy-ser12 is the driver name (McCurdy SER-12 driver); standard is the kernel variant; 3.1 is the driver version; 1 is the package release; rt29 is the kernel version (i.e., DALinux version 3.1). Driver Version Identification The driver includes its version number, which can be displayed using the modinfo command once the driver is installed. Example: SER 12 Driver: # modinfo mccurdy-ser12 author: Kerr Vayne Systems Ltd. license: GPL 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 47 of 112

48 DALinux Tools Installation and Setup description: McCurdy SER-12 Multiport Highspeed Serial Card version: 3.1 parm: port:base i/o address parm: card:i/o address select number parm: irq:irq alias: char-major-4-* vermagic: rt29-up preempt PENTIUM4 gcc-3.4 depends: Example: AEC-PCI-TC Driver: # modinfo aec-pci-tc parm: major:major device number. (Default=242) author: Kerr Vayne Systems Ltd. description: Adrienne Electronics Corporation PCI-TC driver license: Proprietary version: 3.1 vermagic: rt29-up preempt PENTIUM4 gcc-3.4 depends: Installing SER 12 Drivers McCurdy SER-12 ISA Multiport Serial Adapter cards require custom drivers. In order to use these highspeed SER 12 cards with D-Series products, the SER-12 driver must be installed. This driver supports all of the features of the SER-12 card including: Auto turnaround on half duplex lines Custom receive FIFO trigger levels A multiplexed I/O address space Install SER 12 drivers only if SER 12 cards are present. To Install a SER 12 Driver(s) The SER 12 driver consists of two packages: a configuration utility (mccurdy-ser12-config utility) and the drivers. There is only one configuration utility, but there is one driver for each kernel supported by DALinux. It is only necessary (and possible) to install SER-12 drivers for installed kernels. Along with the kernel, the drivers also require the mccurdy-ser12-config utility. Step Action 1 At the prompt type cd / Result: Resets directory to root. 2 Set path to /media/cdrom/drivers/ser Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 48 of 112

49 DALinux Tools Installation and Setup Step Action 3 Install the mccurdy-ser12-config package as a normal RPM package. # rpm ihv mccurdy-ser12-config i386.rpm 4 Select an appropriate driver based on the installed kernel. 5 Use the following command line to install the selected McCurdy SER-12 driver as a normal RPM package. To install the driver for the: rt29-standard kernel, execute the command # rpm i mccurdy-ser12-standard-3.1-1_ rt29.i386.rpm rt29-pae kernel, execute the command Configuring the SER 12 Driver # rpm i mccurdy-ser12-pae-3.1-1_ rt29.i386.rpm SER-12 cards and drivers are configured using the serial port configuration utility (mccurdyser12-config). Step Action 1 At the prompt type: config Result: This launches the configuration utility (mccurdy-ser12-config). 2 Select SER 12 Multiport Serial Cards item from the menu. Result: This opens the configuration utility. Follow the prompts to configure the cards. 3 Use the menus to: Add a new SER 12 card Configure the card s I/O address space, IRQ and card index. Select OK Note: Cards that are already added can easily be modified by selecting them from the list. 4 After all cards are configured, select Done 5 Select Quit to exit the configuration utility. Result: When this utility is exited, the cards are available for use. Importance of Using the Correct Configuration It is very important to specify the correct configuration of the SER 12 driver. The SER 12 adaptors are not plug-and-play so there is no way for the driver to verify the settings provided. The driver assumes that the information provided is accurate and uses it blindly. If the 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 49 of 112

50 DALinux Tools Installation and Setup configuration provided is inaccurate - this is particularly true with IRQs it can result in the system freezing. About Sharing I/O Address Space There are some restrictions to sharing I/O address space between two or more SER 12 cards. These restrictions are enforced by the driver. If these conditions are not met, it will fail to load. If two cards share the same I/O address space, they must also share an IRQ line. If two cards share the same base I/O address space, they must have different IRQs. The configuration utility prohibits the configuration of an base I/O address of 0x1340 as it is known to cause the SER 12 adaptors to misbehave Important: IRQ =10 and base address of 1000 along with IRQ=11 and base address of 1400 work with the Linux OS. However 1100 and 1200 will not work in Linux. Installing SER 16 Drivers SER 16 highspeed, multiport PCI serial cards contain standard UARTs and are supported by the standard Linux kernel; thus, DALinux supports SER 16 cards as is. Support for the SER 16 Multiport PCI Serial Adapter programmed with custom PCI IDs has been added to the kernel. These custom PCI IDs allow the Linux kernel to correctly configure the quirks associated with these custom serial adapters. To accommodate the additional hardware, the number of ports has been increased to 100, allowing for six SER 16 adapters and 4 legacy (COM) ports. Configuring Serial Ports The Linux kernel requires the configuration of the number of standard serial ports; these include legacy on-board serial ports (i.e. COM1 and COM2), SER 4 ports, and SER 16 ports. For details on this configuration see below, Serial Port Configuration. Installing SER 24 Drivers DALinux v3.1 and higher supports the SER-24PCIe 24-port serial card. Configuring Serial Ports The Linux kernel requires the configuration of the number of standard serial ports. For details on this configuration see below, Serial Port Configuration. Installing SER 4-LTC Driver <<This is the same as the PCIe-TC driver.>> 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 50 of 112

51 DALinux Tools Installation and Setup Installing the PCIe-TC Timecode Driver This version of the harris-pci-tc driver was built against the DALinux version kernel, namely: Linux kernel version rt29 to support PCIe Timecode Reader Card. This driver exposes exactly the same LTC timecode reader interface to D-MAS and other applications as the existing aec-pci-tc driver. For more information see Using the PCIe-TC Driver. To Install the PCIe-TC Driver In order to use PCIe timecode reader cards, the harris-pci-tc driver must be installed. The harrispci-tc drivers are distributed as RPM packages and can be installed with the rpm command. Step Action 1 At the prompt type cd / Result: Resets directory to root. 2 Set path to /media/cdrom/drivers/ time code card location 3 Install the Adrienne timecode-config package as a normal RPM package. For example: # rpm ihv timecode-config i386.rpm 4 Select an appropriate driver based on the installed kernel. Unless additional kernels were installed manually, choose the harris-pci-tc-up package. 5 Use the following command line to install the selected harris-pci-tc driver as a normal RPM package. To install the driver for the: harris-pci-tc-standard kernel, execute the command # rpm i harris-pci-tc rt i386.rpm harris-pci-tc-pae kernel, execute the command # rpm i harris-pci-tc rt29pae i386.rpm Loading the Driver The harris-pci-tc driver is automatically installed at system boot upon discovery of PCIe TC cards. To avoid rebooting, load the driver manually by executing the following: # modprobe harris-pci-tc Note: Rebooting the system provides the same results, but replacing the Linux serial driver is faster Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 51 of 112

52 DALinux Tools Installation and Setup Device Files Diagnostics Device file names are chosen for the device driver that does not conflict with any of the standard device file names. The device files representing LTC readers have names of the form /dev/timecode/htcrn, where n is 0, 1, 2, to denote different PCIe TC boards. Thus, /dev/timecode/htcr0 represent the LTC reader on the first PCIe TC board; /dev/timecode/htcr1 represent the LTC reader on the second PCIe TC board; and so on. Once the driver is installed, it is possible to obtain information about the driver using the modinfo command. For example: # modinfo harris-pci-tc.ko filename: harris-pci-tc.ko version: 0.1 license: GPL description: Harris PCIe TC driver author: Sergey Samoylenko srcversion: 902CCE126E3C1B28EA803AA alias: pci:v d csv*sd*bc*sc*i* depends: vermagic: rt29 SMP preempt mod_unload modversions PENTIUM4 parm: major:major device number. (Default=243) (uint) parm: max_open_device:maximum number of open device. (Default=1000) (int) To obtain diagnostics on the currently installed PCI-TC boards, read the virtual file: /proc/driver/harris-pci-tc. The output from this file should be self-explanatory. For example: # cat /proc/driver/harris-pci-tc Board : 0 Version : 0x01 Feature : 0x01 I/O Base : 0xCD00 IRQ : 16 Mode : LTC Reader LTC Reader : yes Video Sync : yes (not used) 1588 TC Reader : no 1588 Video Sync : no (not used) 1588 Management : no (not used) 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 52 of 112

53 DALinux Tools Installation and Setup Open devices : 2 LTC (irq) : TC (irq) : 0 The driver also records important events (in particular, error conditions and hardware malfunctions) in the system log. Such messages can be identified by the prefix harris-pci-tc. For example: $ grep harris-pci-tc /var/log/sys.log Upgrading the Driver To upgrade the driver from a previous version, run the following commands as root with automation shut down. service ntpclock stop rmmod harris-pci-tc rpm -Uvh harris-pci-tc-standard _ rt29.i386.rpm harris-pci-tc-standard-3.1-1_ rt29.i386.rpm timecodeconfig i386.rpm modprobe harris-pci-tc service ntpclock start Verifying the Version of the Driver To verify that the new version of the driver is running, run the following command. $ dmesg grep 'harris-pci-tc: version' tail -n 1 The output should be: harris-pci-tc: Harris PCIe TC driver 0.1 loaded Installing the AEC PCI-TC Timecode Driver The AEC PCI-TC driver was built against the DALinux version 3.1 kernel, namely: Linux kernel version rt29. To Install the PCI-TC Driver Adrienne Electronics Corporation (AEC) PCI-TC PCI bus cards require customer drivers. In order to use AEC PCI-TC timecode readers, the PCI-TC driver must be installed. The AEC PCI-TC drivers are distributed as RPM packages and can be installed with the rpm command. Step Action 1 At the prompt type cd / Result: Resets directory to root. 2 Set path to /media/cdrom/drivers/ time code card location 3 Install the Adrienne timecode-config package as a normal RPM package. For 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 53 of 112

54 DALinux Tools Installation and Setup Step Action example: # rpm ihv timecode-config i386.rpm 4 Select an appropriate driver based on the installed kernel. Unless additional kernels were installed manually, choose the aec-pci-tc-up package. 5 Use the following command line to install the selected aec-pci-tc driver as a normal RPM package. To install the driver for the: aec-pci-tc kernel, execute the command # rpm i aec-pci-tc rt i386.rpm aec-pci-tc-pae kernel, execute the command # rpm i aec-pci-tc rt29pae i386.rpm Loading the Driver The AEC PCI-TC driver is automatically installed at system boot upon discovery of AEC PCI-TC cards. To avoid rebooting, load the driver manually by executing the following: # modprobe aec-pci-tc Note: Rebooting the system provides the same results, but replacing the Linux serial driver is faster. Device Files Diagnostics The AEC PCI-TC driver uses the device files /dev/timecode/ltcr# (where # denotes the number of the board, starting from 0) to allow applications to obtain LTC timecode using the PCI-TC. These files are automatically created by Linux upon discovery of AEC PCI-TC cards, provided the timecode-config package has been installed. Board numbering depends on the Linux PCI bus subsystem, and as such is unpredictable. In practice, only one PCI-TC need be installed on a D-Series computer, and as a result, only /dev/timecode/ltcr0 will be created. To obtain diagnostics on the currently installed PCI-TC boards, simply read the dynamic /proc/driver/aec-pci-tc file. The output from this file should be self-explanatory. For example: $ cat /proc/driver/aec-pci-tc Board : 0 Revision : C2 Signaling : 5.0V (Universal 5.0/3.3V board) I/O base : 0xd000 IRQ : 9 (in use) 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 54 of 112

55 DALinux Tools Installation and Setup Diagnostics : not active Mode : SMPTE VITC Generator : not installed VITC Reader : off LTC Generator : not installed LTC Reader : on OSD Option : not installed L21 Reader : not installed SERIAL Option : not installed The driver also records important events (in particular, error conditions and hardware malfunctions) in the system log. Such messages can be identified by the prefix aec-pci-tc. For example: $ grep aec-pci-tc /var/log/sys.log Upgrading the Driver To upgrade the driver from a previous version, run the following commands as root with automation shut down. service ntpclock stop rmmod aec-pci-tc rpm -Uvh aec-pci-tc rt i386.rpm timecodeconfig i386.rpm modprobe aec-pci-tc service ntpclock start Verifying the Version of the Driver To verify that the new version of the driver is running, run the following command. $ dmesg grep 'aec-pci-tc: version' tail -n 1 The output should be: aec-pci-tc: version 3.1 loaded Reviewing Installed Kernels It is only necessary (and possible) to install drivers for installed kernels. To determine which kernels are installed, rpm can be used. rpm qa grep "^kernel-" kernel rt29-1 kernel-pae rt Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 55 of 112

56 DALinux Tools Installation and Setup HP Smart Array P400 Controller Card DALinux v3 and higher can be installed on systems with disk controllers that use the Compaq Smart Array interface, such as the Hewlett Packard Smart Array P400. This interface is sometimes referred to as CCISS. The Hewlett Packard Smart Array P400 disk controller permits drives to be configured as RAID arrays. If this is done DALinux will see only the logical drives that have been configured; the number of physical drives may be greater than that. During the installation process the logical drives are designated as devices with names of the form /dev/cciss0a, and partitions on the drives have an additional digit, such as /dev/cciss0a1 for the first partition. The first digit designates the controller (0, 1, 2,...), the next letter designates the drive (a, b, c, ), and the last digit designates the partition (1, 2, 3, ). These are not the HP standard names, which use an additional directory level such as /dev/cciss/c0d0 for the first controller and first drive, and /dev/cciss/c0d0p1 for the first partition. The names were changed from the HP standard in order to avoid extensive changes to some of the DALinux scripts. This naming scheme limits the number of logical drives to 26, which should not be an issue for DALinux installations. Support for this interface is implemented as a module, similar to IDE or SCSI support, so it is only included when an interface of this type is installed. Support for the Intel 82579LM NIC The e1000e driver has been updated from k2 to NAPI to support the Intel 82579LM NIC on the ichp 4RU quad core Device Controller chassis. Support for the Intel & I-350 "igb" Ethernet controller Driver DALinux v3.3 adds support for a x4 PCIe quad port Ethernet adapter. The Intel igb driver supports all 82575, 82576, 82580, and I350-based gigabit network connections. The IGB driver has been updated to version and integrated in DALinux. The driver has been taken from the Intel site. Test the igb driver by checking to ensure the correct driver version (version should be 4.1.2, see dmesg output). Serial Port Configuration The Linux kernel requires the configuration of the number of standard serial ports; these include legacy on-board serial ports (i.e. COM1 and COM2), SER 4 ports, SER 16 ports, and SER 24 ports Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 56 of 112

57 DALinux Tools Installation and Setup Serial Port Support Note: The 8250 driver (used to control SER-4, SER-16, and COM ports) has been updated to enable the low-latency feature by default. IMPORTANT: The low-latency workaround script used on previous versions of DALinux to enable to the low-latency feature on all serial ports should not be used on this version of DALinux! To assist in this configuration, a new menu item has been added to the config, accessed through the Serial Ports submenu. This configuration utility can be used to update the configuration by either detect installed serial ports or by manually specifying serial ports. If there are no legacy on-board serial ports available (e.g. because they are disabled in the BIOS), the automatic configuration utility will not attempt to configure them. This may lead to confusing serial port device file assignment (For more information see About Serial Port Device File Allocation). So, when legacy on-board serial ports are not present, manually add four (4) serial ports to those automatically detected by the config utility. NOTE: Unless this utility is used, only four (4) serial ports will be available. This does not affect SER-12 serial ports. Configuring the Serial Ports On-board serial ports (i.e. COM1 and COM2), SER 4 ports, SER 16, and SER 24 ports are configured using the serial port configuration utility. Step Action 1 At the prompt type: config Result: This launches the configuration utility. 2 Select Serial Ports submenu. Result: This opens the configuration utility. Follow the prompts to configure the required number of serial ports. When legacy on-board serial ports are not present, manually add four (4) serial ports to those automatically detected by the config utility. 3 Use the menus to: Add a new Serial Port Configure the ports I/O address space. Select OK Note: Ports that are already added can easily be modified by selecting them from the list. 4 After all ports are configured, select Done 5 Select Quit to exit the configuration utility. Result: When this utility is exited, the ports are available for use Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 57 of 112

58 DALinux Tools Installation and Setup To Avoid Unpredictable Assignment of MotherBoard Ports Specify the number of serial ports in "config utility" (Serial Ports - Standard Serial Ports - Manual Configuration - Number of Ports) as N + 4, where N is number of ports on installed PCI boards. Then ports /dev/ttys4 - /dev/ttys{n+4} are assigned. If the number is less then this value, the names reserved for motherboard ports may be assigned (in unpredicted order). IMPORTANT: On the ichp 4RU quad core Device Controller ensure the Number of Ports assigned with the i7 SBC is 5 more than the number RS422 automation ports About Serial Port Device File Allocation Always Create Four Devices for COM Ports In DALinux v3 and higher the automatic configuration option (config Serial Ports This simplifies the assignment of device files to hardware such as the SER-16, because the assignment always starts at /dev/ttys4. The ports 1 through 16 are assigned /dev/ttys4 through /dev/ttys19. Previous Functionality Note: Previous versions of DALinux (those earlier than v3) would create 4 device files for COM ports if any ports existed, but did not create any if there were no COM ports present and enabled. The ports 1 through 12 would be assigned /dev/ttys4 through /dev/ttys15 and ports 13 through 16 would be assigned /dev/ttys0 through /dev/ttys3. To avoid any issues The order in which the cards are detected is hardware dependent, so if an additional card is added, the device files corresponding to the old card may change. To avoid any issues, use the lsserial utility to determine the mapping and generate device.cfg configuration files. lsserial takes into consideration all of these issues and provides consistent ordering of device files based on physical hardware. Se rialp o rts Stan s. Autom atic Configurat Installing ntp clock The ntpclock software is used in conjunction with ntp and a timecode reference. By correctly configuring ntpclock and ntp, this application: Reads time from a timecode reader card driver (Adrienne Electronics Corporation PCI-TC timecode reader card), Translates it into a form usable by ntp and Posts this time to be consumed by ntp. ntp uses this time to keep the system time synchronized with the timecode reference Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 58 of 112

59 DALinux Tools Installation and Setup Note: A separate document concerning the use of NTP to synchronize the system time on D- Series computers is provided. To Install ntpclock ntpclock is distributed as an RPM package. It can be installed using the rpm utility. Install ntpclock using the following command: rpm ivh ntpclock i386.rpm Preparing... ########################################### [100%] 1:ntpclock ########################################### [100%] This installs and enables the ntpclock application. CAUTION: Do Not start the service until ntp and ntpclock have been configured. ntpclock configuration The ntpclock utility reads timecode from a device file and writes it to a shared memory location where the ntp daemon can read it and use it to update the internal system clock. ntpclock is capable of reading the time from the computer s real time clock, however this should only be used for testing purposes. ntpclock.conf file changes The /etc/ntpclock.conf file contains configuration for the ntpclock utility. broadcast timecode reader card: To configure ntpclock to read from a broadcast timecode reader card, ensure the file contains a line in the [clock] section specifying: type=timecode. A sample /etc/ntpclock.conf file is installed with the rpm package which has this setting as a default. timecode defaults: The device used to access the timecode defaults to /dev/timecode/ltcr0. To change or explicitly set this device, modify the refclock_device parameter setting. A sample /etc/ntpclock.conf file is installed with the rpm package which should have these settings as a default. shared memory locations: ntpclock can write the timecode as read to one of four shared memory locations that can be read by the ntp daemon. The location is specified as an integer between 0 and 3 (inclusive) and is set through the ntp_clock parameter in the configuration file. Once set, the ntp daemon must then be configured to read from the same shared memory location. (See ntp configuration section below.) UTC time vs. local timezone: ntpclock assumes that the timecode read is in UTC time. To specify that the timecode is in the local timezone, set the refclock_timezone parameter in the [clock] section to local Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 59 of 112

60 DALinux Tools Installation and Setup ntp configuration The file /etc/ntp.conf contains a configuration read by the ntp daemon. The server line specifies what time source should be used for synchronization. Synchronizing with the timecode card being read by ntpclock, requires the time source be specified to be the same shared memory location as being written to by ntpclock. To do this, set the server parameter to the special value x, where x is an integer between 0 and 3 giving the specific shared memory location to be read. For more details on ntp configuration, see the ntp man pages and also review the DALinux release notes. Starting the ntpclock The ntpclock is started automatically when the computer is rebooted. To manually start ntpclock without rebooting, enter the following command: # service ntpclock start CAUTION: Do Not start the service until ntp and ntpclock have been configured. Reloading the Utility If the configuration file has changed after the ntpclock utility has been started, use the following command to reload the utility so the changes take effect: # service ntpclock reload For details on logging and other configuration file parameters, see the ntpclock.conf man page. Installing MySQL DALinux v3.1 and higher includes support for MySQL. By default, MySQL is not installed with DALinux, but it is available on the DALinux CD ISO image. To install MySQL 1. Log on as root 2. mount /media/cdrom 3. rpm ihv /media/cdrom/packages/libmysql i386.rpm 4. rpm ihv /media/cdrom/packages/mysql-server i386.rpm 5. rpm ihv /media/cdrom/packages/mysql-client i386.rpm 6. mysql_install_db --user=mysql 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 60 of 112

61 DALinux Tools Installation and Setup MySQL is now installed and the required default databases are setup, but it is not yet running. 7. Start the MySQL server: service mysql start 8. Set the MySQL root user password. Please ensure you pick a secure password; the password given in the example below is strictly for demonstrative purposes. mysqladmin u root password=password MySQL should now be ready to use. 9. If MySQL is to be started every time DALinux boots, execute the following command: service mysql enable Installing DALterm for DALinux DALterm allows access to the character-based interface of D-Series products. A version that runs on the Linux console is included in the DALinux add-on tools. If it is not installed, DALterm for Windows must be used to access the character-based interface of v4.xx.xx.xx D-Series products. IMPORTANT: To function, DALterm requires a valid D-Series system be installed and operating. To Install DALterm for Linuxv1.1 DALterm only depends on packages installed by the Typical Installation so no additional software is required. Step Action 1 At the prompt type cd / Result: Resets directory to root. 2 Set path to /media/cdrom/dalterm 3 Install DALterm as a normal RPM package using the following command: # rpm ihv DALterm.rpm Notes: The command is case-sensitive. (i.e. you must enter DALterm, not dalterm) Use -ivh to display install progress Use -i to install without indicating progress Configuring Auto start DALterm for DALinux Auto start DALterm for DALinux can be configured to autostart on lost connection. Note: This enhancement requires a corresponding enhancement to D-Series products Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 61 of 112

62 DALinux Tools Installation and Setup Autoconnect (Command line switch) DALterm for Linuxv1.1 supports a command line switch: autoconnect (-o for short). When specified, DALterm does not exit due to a lost connection, but displays Not Connected! and try reconnecting every 5 seconds. If not specified, then the previous behavior remains in effect: On loss of connection, DALterm shuts down. Configuration File This version obtain its (default) configuration from a file called.dalterm in the user s home directory, if that file is present. This file may contain the long form of the DALterm command switches, (omitting the --), with at most one switch setting per line. Comments can be inserted into the configuration file using the hash (#) and extend to the end of the line. For example, a typical.dalterm file might contain the following: #Default username and password username=operator password=999 #Attempt to reconnect if connection fails autoconnect Overriding the Configuration File Any switches specified on the DALterm command line override those specified in the.dalterm file. Thus, the following command $ DALterm username=maintenance would override the username=operator setting in the above.dalterm file. Automatically Starting DALterm at Linux Login DALterm may be specified as the shell for a Linux user account. Users logging in under such an account would be restricted to using DALterm, and would be automatically logged out when DALterm is shut down. Warning: Use of this feature requires DALinux version 2.0. Step Action 1 Create such a user account Log in as root Specify the following on a single command line: 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 62 of 112

63 DALinux Tools Installation and Setup Step Action Invoke the useradd command, Specify the name of the account (e.g., DALterm or operator) Set the shell to DALterm by means of the s command line switch. Include the m command line switch to have the system create this new user s home directory if desired, specify a description for the user account by means of the c command line switch. Example Command Line: # useradd m s /opt/bin/dalterm c "D-FCS operator console" operator 2 Create a.dalterm file in this user s home directory (e.g., /home/operator in the above example) containing the appropriate DALterm settings. For Example: # vi ~operator/.dalterm Note: This file must specify the username and password, at very least. 3 Assign ownership of this newly created.dalterm file to the newly created user account. For Example: # chown operator:users ~operator/.dalterm 4 Set the Linux password for this user account using the passwd command. For Example: # passwd operator Enter new UNIX password: Retype new UNIX password: # Notes: The Linux password specified in this step need not be the same as the D-Series login password specified in the.dalterm file. More than one such user account may be created, each having its own.dalterm file. (OPTION) DALterm for Windows DALterm allows access to the character-based interface of D-Series products. If DALterm for Linux is not installed, then DALterm for Windows must be used to access the character-based interface of v4.xx.xx.xx D-Series products. DALterm is a diagnostic tool to allow remote viewing and control of the Automation Servers. This DALterm software is Windows based and typically resides on an Automation Support Engineer s laptop Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 63 of 112

64 DALinux Tools Installation and Setup An Automation Support Engineer can remotely dial in to the resident System Server and can then take control of the local Automation Servers. This tool allows Automation Support Engineers to remotely interrogate customer systems for troubleshooting purposes. Dial-in access to a system requires a station permit Automation Support Engineer s to use the station s modem link. How to Set Up DALterm for Windows Step Procedure 1 Install DALterm on your laptop Or any Windows based machine like the System Server. 2 On each Automation Server in the SYSTEM.CFG file insert the line: REMOTE_SOCKET_PORT=15500 Note: The port number can be changed, but is the typical number we use. 3 Set up the PASSWORD.TBL to allow remote access. Note: Ensure Maintenance has a Y in the Remote Login parameter. (PASSWORD.TBL) 4 Set your laptop IP address to be the same as the Information LAN and make sure your node number is away from devices (222 is normally good) Note: Typically Run DALterm and specify a connection. This consists of the IP address of the Automation Server you want to log into, and the port number as specified in SYSTEM.CFG The system prompts for the login. Specify an entry that appears in PASSWORD.TBL. Typically, it is MAINTENANCE. Then enter the correct password. 6 For dial up access, you normally dial in through the System Server, because it manages the modem. Network connections are established in a similar way. Note: The System Server must have a modem installed, and must have the RAS started as a Network Service Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 64 of 112

65 DALinux Tools Installation and Setup hwtrap The hwtrap debugging utility is designed to assist debugging efforts by providing access to the hardware traps (breakpoints and watchpoints) supported by Intel ix86 processors (i386 and later). These traps are an efficient way to detect access to specific memory locations. This utility is not typically used by support engineers and would be implemented only under circumstances, such as when directed by Imagine Communications Automation Development. Installation hwtrap is distributed as an RPM package and can be installed using the rpm utility. Install hwtrap using the following command: # rpm ivh hwtrap i386.rpm Preparing... ########################################### [100%] 1:hwtrap ########################################### [100%] serial-utils The standard serial port utilities (serial-utils) is intended as an aid in configuring and diagnosing problems with a D-Series installation. This package includes a collection of tools suitable for managing serial ports, and comprises the following commands: lsserial: Lists serial ports in the system serstress: Tests communication between pairs of serial ports connected to each other via a null modem cable. When stress testing serial ports, the serstress program is used with loopback cables. In this scenario is could be used to stress test serial cards when a problem is suspected, or to test serial cards whenever new serial cards are installed in an automation computer. This utility is not typically used by support engineers and would be implemented only under circumstances, such as when setting the number of ports using the config utility requires listing all serial ports in the system (lsserial), or to stress test serial ports (serstress), or when directed by Imagine Communications Automation Development. Installation serial-utils is distributed as an RPM package and can be installed using the rpm utility. The following command installs the standard serial port utilities (serial-utils) and associated documentation. # rpm ivh serial-utils i386.rpm 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 65 of 112

66 DALinux Tools Installation and Setup Preparing... ########################################### [100%] 1:serial-utils ########################################### [100%] open-vm-tools DALinux supports the open-vm-tools package. The open-vm-tools packages contain the open source VMware Tools used to improve the experience of guest operating system when installed on a VMware virtual machine. The open-vm-tools package makes it easier to use DALinux when installed on a VMware virtual machine. Note: open-vm-tools is not required for a standard on-site installation and should only be installed if running DALinux in a VM environment for diagnosis or pre-configuration purposes. open-vm-tools supports the following features of VMware : Shared Folders. Fast network interface. Synchronizing system time with the host. Memory usage optimizations. Installing open-vm-tools open-vm-tools may be used in D-MAS software development and build environments to provide hgfs access to the host file system from a development install of DALinux running in a virtual machine. DALinux 3.1 introduced upgraded open-vm-tools packages that are compatible with the new kernel included in the distribution. Due to the limited environment under which open-vm-tools are useful, they are not installed by default (even when performing a full install). To install the tools, copy them from the packages directory on the installation CD and run the following RPM command to install the new openvm-tools packages: rpm -ivh open-vm-tools i386.rpm libguestlib i386.rpm kmod-open-vm-tools _2.6.33_7.1.rt29.i386.rpm Note: Be sure you install the version of kmod-open-vm-tools that matches the running kernel. After installing the tools, reboot the virtual machine. Shared Folders To access shared folders from the guest (assuming the host software supports shared folders), execute: mount.host:/ /mnt/hgfs t vmhgfs 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 66 of 112

67 DALinux Tools Installation and Setup Replacing /mnt/hgfs with the directory you wish to mount the host-guest filesystem (this directory must exist apriori) Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 67 of 112

68 Using DALinux Tools Using DALinux Tools About the Kernel Watchdog DALinux includes a Linux kernel with a built-in watchdog. When enabled, if the kernel causes the computer to lock up, the watchdog detects this and writes useful debugging information to the console. Catastrophic system failures may not be detected and system failures affecting the console may be detected, but debugging information may not be displayed. IMPORTANT: This feature is not available with all hardware and must be explicitly enabled. All multiprocessor and hyper-threaded machines have the necessary support, as do recent uniprocessor machines. Contact Automation Technical Support for information on enabling this feature. Reporting Lock-ups If a lockup is detected by the watchdog, important debugging information is written to the screen. Acquire this information in any way available (such screen capture from a software remote KVM, digital photograph, or by copying it out). If the information is copied manually, exercise extreme care to ensure no errors are introduced. Triple check the copy since it is very important that the crash information be accurate. Provide this information to Automation Technical Support. Using DALterm Starting DALterm DALterm is started by executing: # DALterm This starts DALterm with default options (connect the application running on the same computer with a blank username and password). Most of the time it should not be necessary to start DALterm directly. It can be started by using the -console option when starting a DALterm enabled application (e.g. D-MAS and D-FCS) Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 68 of 112

69 Using DALinux Tools Command-line Options DALterm supports an optional configuration file that can be used to override the default values for the command line options. For detailed information, pass the --help option to DALterm: # DALterm --help usage: DALterm [OPTIONS] Informational Options Step Informational Options Action -h, --help -V, --version display this help and exit output version information and exit Login Options -u, --username LOGIN use LOGIN as user category -p, --password PASS -a, --ipaddress ADDR -t, --port PORT -y, --retry N use PASS as user category password use ADDR as the IP address of the remote host use PORT as the port of the remote host retry N times if server reports "connection refused" Display Options -r, --rows N use N rows to display the remote host -c, --cols N -f, --font FONT use N columns to display the remote host use FONT for the display DALterm Operation Modes Menu Mode DALterm has two modes of operation, menu mode and echo mode. Menu mode is denoted by a pink header overlaying the remote host s screen (circled in the figure below). When in menu mode, all keystrokes (save the right ALT key) are processed by the menu. ESC terminates DALterm The right ALT key is used to toggle between Menu and Echo modes. The left ALT key is not special and is treated like a normal ALT key Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 69 of 112

70 Using DALinux Tools Echo Mode When in echo mode, all keystrokes (save the right ALT key) are echoed to the remote host. ESC terminates DALterm The right ALT key is used to toggle between Menu and Echo modes. The left ALT key is not special and is treated like a normal ALT key. Shutting down DALterm To shut down DALterm, press right ALT key to put DALterm in menu mode (only required if in echo mode). Then press ESC to shutdown the application. Response Time The response time of a Linux DALterm client that is running on the same machine as a real-time application (e.g. D-MAS or D-FCS) may be significantly slower than a DALterm client running on a remote machine. This is due to the DALterm client having lower priority than the real-time application. Mouse Support This version of DALterm for Linux supports the use of a mouse input device. The effect of a mouse click depends on the current DALterm mode (menu or remote) and the location of the pointer (mouse cursor). The following table lists the possible effects of a mouse click on the DALterm display: Mode Click On Effect 2014 Imagine Communciations Corp. Proprietary and Confidential 9-April-2014 Page 70 of 112