manualshive.com logo in svg

artisan MDR, User Manual

Share
Download
artisan MDR User Manual Download Page 52

MDR User Guide 

45 

 

8   MDR API Functions 

To communicate with the MDR Server, the user has the possibility to use either the 
MDR Shell or his own program linked with the MDR API library, the MDR Shell 
program including the MDR API library. 
The API functions are implemented as C++ functions that can be used in C++ programs. 
Below is an alphabetic list of all the MDR API functions available:  
 

Name

 

Description

 

AddDisksToDiskGroup 

Add a list of disks to a disk group 

AllocateMemory 

Allocate memory buffer 

ClearDiskInfo 

Clear the disk group information on a list of disks 

ClearRecordingTable

 

Clear the recording table 

ConnectToDiskGroup 

Connect to a disk group 

ConnectedToDiskGroup 

Check a disk group connection 

ConnectToServer

 

Set up an MDR client/server connection 

ConnectedToServer 

Check an MDR client/server connection 

CopyRecording 

Copy a recording 

CreateDiskGroup 

Create a new disk group 

CreateNewRecording 

Create a new recording 

DeleteDiskGroup 

Delete a disk group 

DeleteRecording 

Delete a recording 

DisconnectFromDiskGroup 

Disconnect from a disk group 

DisconnectFromServer 

Disconnect from the MDR server(s) 

DiskSpeedTest 

Test the MDR recording speed 

FormatDisk 

Format a disk 

FreeMemory 

Free memory buffer 

GetDiskGroupName 

Get the name of the current disk group 

GetRecordingInfo 

Get information from a recording 

GetRecordingsInfo 

Get information from all recordings 

GetRecordingTableInfoString 

Get the recording table information (as a string) 

GetRecTableInfo 

Get the recording table information 

GetServerName 

Get the server name 

GetServerStatus 

Get the server status 

PrepareTransfer 

Prepare a transfer 

ReadRecorderBlock 

Read block(s) from the storage device 

ReadRecordingBlock 

Read block(s) of a recording 

RemoveDisksFromDiskGroup 

Remove a list of disks from a disk group 

ResetServer 

Reset the MDR server(s) 

Scan 

Scan for fibre channel devices (disks and disk groups) 

SelfTest 

Test the MDR server system 

SetRecordingInfo 

Set information to a recording 

SetRecTableInfo 

Set the recording table information 

StartTransfer 

Start a transfer 

StopTransfer 

Stop a transfer 

WaitTransfer 

Wait for the current transfer to finish 

WriteRecorderBlock 

Write block(s) to the storage device 

WriteRecordingBlock 

Write block(s) of a recording 

 

8.1 Header Files 

In order to add the API functions into a C++ program, some MDR header files, located 
in the 

mdr-host-sw/include

 directory, have to be included. Some dependencies 

already exist between these files. Therefore, it is not required to add all the MDR header 
files but only those that are directly needed by the user’s program. 

Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Summary of Contents for MDR

Page 1: ...l service in house repair center WE BUY USED EQUIPMENT Sell your excess underutilized and idle used equipment We also offer credit for buy backs and trade ins www artisantg com WeBuyEquipment REMOTE INSPECTION Remotely inspect equipment before purchasing with our interactive website at www instraview com LOOKING FOR MORE INFORMATION Visit us on the web at www artisantg com for more information on ...

Page 2: ...MDR MIDAS Data Recorder User Guide Doc version 1 4 7 27 November 2001 for software from version 1 4 4 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com ...

Page 3: ...ay appear in this document ii MDR User s Guide Copyright 1998 2001 VMETRO This document may not be furnished or disclosed to any third party and may not be copied or reproduced in any form electronic mechanical or otherwise in whole or in part without the prior written consent of VMETRO Inc Houston TX USA or VMETRO asa Oslo Norway Artisan Technology Group Quality Instrumentation Guaranteed 888 88 ...

Page 4: ...he use of their products Limited Liability VMETRO does not assume any liability arising out of the application or use of any product de scribed herein neither does it convey any license under its patent rights nor the rights of others VMETRO products are not designed intended or authorized for use as components in systems in tended to support or sustain life or for any application in which failure...

Page 5: ...ot crucial information Still you should take notice if you want to use all capabilities built into the MDR IEC Prefixes for binary multiples Symbol Name Origin Derivation Ki Kibi Kilobinary kilo Mi Mebi Megabinary mega Gi Gibi Gigabinary giga Example 1 Kibit 1024 bit 1 MiB 1 048 576 bytes Related Documentation MDR 220 Quick Guide MDR 250 Quick Guide MDR Release Notes iv MDR User s Guide Artisan Te...

Page 6: ...r Standalone Operation 15 3 4 Connecting to the MDR Server from the MDR Shell 16 3 5 Converting from Network to Standalone MDR 17 4 Host Network Based MDR 18 4 1 MDR Host Software 18 4 2 Host MDR Shell and API Installation 19 4 3 Configuring the MDR Shell 20 4 4 Configuring the MDR for Ethernet Operation 21 4 5 Configuring the MDR for Shared Memory Network Operation 22 4 6 Connecting to the MDR Se...

Page 7: ...orks boot parameters file vxbp txt 80 10 6 MIDAS Monitor configuration file mmon ini 81 10 7 Configuring an MDR Unit by Preloading the Boot Parameter Files 82 A Troubleshooting 85 B Error Messages 86 C Upgrading the MDR System Software 89 MDR Firmware mdrvxst hex 89 Version Upgrade Matrix 89 Restoring Corrupt FLASH 92 D Supported PMCs Documentation 94 Fibre Channel Storage 94 FPDP Digital I O 97 E...

Page 8: ...bre Channel disk arrays o RAID Redundant Array of Inexpensive Disks o JBOD Just a Bunch of Disks 4 PCI Module plugged directly into Host Computer o VMFC 2100P or VMFC 2200P Fiber Channel Disk Interface Adapter All main components of an MDR system are based on industry standards VME PMC PCI Fibre Channel and commercial off the shelf COTS modules such as the VMETRO MIDAS board and selected PMC modul...

Page 9: ...rms the disk array management although in Direct Connection the disk array is accessed and can be managed directly using a Fiber Channel adapter in the host workstation Typically in the system development phase the MDR is controlled from a host computer using the C C API or a text based user interface MDR Shell The host may communicate with the MDR using standard TCP IP over Ethernet or with a hig...

Page 10: ...nd DSPs Fibre Channel disk interface High speed very scalable convenient cabling JBOD disk arrays Very cost effective high capacity scalable RAID disk arrays Redundancy offers protection against disk failure Controlled with User I F or C API Ready to run or control from user application Host access via Ethernet or VMEbus Use workstation or an embedded VME host Direct Fibre Channel host access to d...

Page 11: ... Sub System for maximum data throughput These are MIDAS boards with the necessary software embedded in on board FLASH memory to support the MDR PMC combinations 1 2 1MDR 220 Two PMCs positions one for FPDP data source and the other for the Fibre Channel connection to the disk array Typically used for standalone or Shared Memory Network 4 MDR User Guide Artisan Technology Group Quality Instrumentat...

Page 12: ...i386 or higher PC with Windows NT 2000 and Ethernet interface MIDAS with VxWorks 5 4 Power PC SBC with VxWorks 5 3 1 5 4 1 5 Host Computer Software SDK CD ROM The MDR can be connected to the host computer via the RS 232 port or via Ethernet requires an Ethernet PMC on the MDR 250 base unit or VME SBC for network gateway All the software needed to run the MDR system from any of the above hosts is c...

Page 13: ... Disks units with built in redundancy The disk units are connected to MDR with Fibre Channel Arbitrated Loop FC AL op erating at 1 062 Gbit sec using the SCSI protocol and command set to communicate with the disk system Up to 125 disks units may be connected to the same physical loop MDR supports Fibre Channel both with fiber optic or differential twinax copper cables and hubs and switches can be ...

Page 14: ...s than 32 bit without losing bandwidth various data packing and unpacking options are available in the data interface This is a very useful feature when connecting to ADC and DAC boards which often have sample widths of only 8 to 16 bits For example if a 10 bit ADC is used the MDR can pack three 10 bit samples in a 32 bit word before it gets recorded wasting only two bits rather than 22 if no pack...

Page 15: ...fer DMA controllers this is associated with a certain perform ance degradation For example 500 KB s host traffic may result in approx 20 reduc tion in maximum recording speed 1 9 4Disk Array Physically Moved to a Different Host The RAID or JBOD disk storage system may also be attached to a different host equipped with a VMFC 2x00x xx Fibre Channel adapter than the one used during re cording i e th...

Page 16: ...e FPDP interface is a 32 bit synchronous input output parallel interface which is specified to operate at clock rates of 20 MHz TTL 32 bits 25 MHz PECL 32 bits and 40 MHz PECL 16 bits The FPDP interface is used by a variety of third party vendors with products such as A D converters D A converters and DSP boards 1 10 3 Ethernet Host Interface The MDR system utilizes an Ethernet PMC module to provi...

Page 17: ...its shipping package Verify that no damage has occurred in the shipment Refer to the packing list and verify that all items are accounted for Items may vary according to the MDR 2x0 product purchased Each shipment of an MDR board assembly comprises 1 MDR Board PMC Module s preinstalled on MDR board and firmware in FLASH Cables RS 232 cable Fibre Channel cable 3m 10 FPDP 80 pin Ribbon cable w KEL c...

Page 18: ...odule s already mounted on the MDR 220 or MDR 250 board MDR 220 Top View Front Panel with typical PMC population MDR 250 Front Panel with typical PMC population MDR User Guide 11 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com ...

Page 19: ... JP11 SW1 RST DIS BASE ADDR BOOT SFAIL AUTO ID VRAI FLASH RACEway INT ASIZE PMC 2 PMC 1 INTERRUPT JUMPERS RACEway JUMPERS FLASH JUMPERS VMEbus CONFIGURATION JUMPERS SWITCH BOOT MODE SELECTION Note that darkened rectangles indicate the jumper is installed For a complete discussion of each jumper and switch refer to the MIDAS 100 200 Series User s Manual 12 MDR User Guide Artisan Technology Group Qu...

Page 20: ...own FPDP module s 4 The Ethernet cable between the Ethernet PMC module slot 5 and your own Ethernet cable 5 The SCSI cable between the SCSI PMC module slot 4 and your tape drive 2 6 Power Consumption WARNING Due to its power consumption the MDR hardware requires forced air cooling for reliable operation Operation on extender boards is not recommended MDR 220 Typical 3 5A 17 5W MDR 250 Typical 3 5A...

Page 21: ...xWorks several boot parameters must be provided Each of the boot parameters is described below More details may be obtained in the Wind River Systems Tornado Users Guide boot device Type of device to boot from For standalone operation this must be set to a period If a master controller is present entry should be set to mdcX where X is the slot number Processor number A unique identifier for the ta...

Page 22: ...BOOTP to get boot parameters 0x80 Use TFTP to get boot image 0x100 Use proxy ARP target name tn name of target to be added to host table startup script s path of startup script to execute after boot available only if target resident shell is included in download image other o Normally not used 3 3 Configuring the MDR for Standalone Operation To configure any MDR unit to operate as a standalone sys...

Page 23: ...ameter must be set to a period 3 4 Connecting to the MDR Server from the MDR Shell Make sure that the RS 232 terminal or PC with a terminal emulator program is con nected to the MDR To start the mdrshell program on the standalone MDR system 1 Boot up the MDR and wait for the user prompt to appear 2 At the user prompt type mdrshell 3 At the mdrshell prompt type period Specify the MDR Server name IP...

Page 24: ... etc and retrieve the size of the file vxbp nonet txt in bytes 3 On the MDR board type the following at the Midas Monitor prompt mgf vxbp txt size Note Use vxbp txt and not vxbp nonet txt This is because vxbp txt is the name of the target file on the board while vxbp nonet txt is the file on the Host to be copied 4 Within HyperTerminal click on Transfer Send set Protocol Xmodem and Browse your com...

Page 25: ...tions we mean functions such as setting parameters of a recording starting a recording showing the state of the recorder and copying recordings The MDR API is an Application Programming Interface for application programs that need to control the MDR The MDR API consists of essentially the same functions as the MDR shell and communicates with the MDR server in a client server fashion Software struc...

Page 26: ...CD ROM All necessary files will be copied to a specified directory Inside this directory the structure is as follows documents contains the MDR documentation and example programs mdr server bin contains the MDR Server binary file for all the supported platforms mdr server etc contains the configuration files for MDR Server mdr ini mmon ini vxbsp ini vxbsp min txt vxbsp netif txt and vxbsp nonet tx...

Page 27: ... the file libmdrapi so 0 present in mdr host sw lib sun solaris libs must be added to the LD_LIBRARY_PATH environment variable In the Windows environment the path to the files mdrapi dll and cygwin32 dll pre sent in mdr host sw lib x86 win32 must be added to the PATH environment vari able The MDR is shipped without any server lines defined in the mdr ini file because the layout of the network is u...

Page 28: ...R shell will not prompt the user for the hostname of the MDR server before trying to connect to the MDR server 4 4 Configuring the MDR for Ethernet Operation To configure an MDR 250 xxxxE unit with Ethernet operation start up the MDR system and then use the bootChange command to set the boot parameters as follows bootChange clear field go to previous field D quit boot device mdc5 processor number ...

Page 29: ...10001100 processor number 1 host name file name inet on ethernet e inet on backplane b 192 168 0 101 host inet h gateway inet g 192 168 0 100 user u ftp password pw blank use rsh flags f target name tn Target name startup script s other o The value sm 0x10001100 for boot device is just an example procnum processor number which is only used in Shared Memory network should be set to a unique integer...

Page 30: ... the MDR system Ethernet IP address the IP address of the MIDAS 120 network gateway as seen from the Host Computer Verify that the VmeA32SlaveBase item in the vxbsp ini file is set correctly If this item is missing then the VME A32 slave base address will be computed by the BSP The default BSP computation puts the VME A32 slave base of a MIDAS acting as a SM master with a processor number of 0 at ...

Page 31: ...If the hostname IP address is not specified in the mdr ini file the mdrshell program will prompt the user for the hostname IP address of the MDR Servers until the user enters an empty hostname IP address This hostname needs to be a part of the host database on your system in order for the mdrshell program to resolve the IP address of the MDR Server If you do not know how to determine the hostname ...

Page 32: ... data from to the disk storage system the storage device RAID or JBOD may be attached directly to the host as indicated by the black line in the figure above This mode is available ONLY for Solaris and Windows NT 2000 Hosts not available for VxWorks Hosts Also Direct Connection requires that the host is equipped with a Fibre Channel adapter VMFC 2x00x xx For more details on how to install the VMFC...

Page 33: ...llow the procedure below to reprogram your VMFC 2X00 P board On a Windows PC install the VMFC 2X00 P you want to reprogram Got to the directory called mdr mdr host sw fibre channel drivers vmfc update Insert a blank floppy disk in the floppy disk drive and execute the program called RawWrite In the Write tab select the image file called vmfc update img and click on the Write button This will copy ...

Page 34: ... readme pdf file When the system comes back make sure that the driver is running To verify it perform the following actions Windows NT go to the Control Panel SCSI Adapters Drivers tab Check that the driver corresponding to your board QLogic QLA2000 2100 PCI Fibre Channel or QLogic QLA2200 PCI Fibre Channel is marked as started Windows 2000 go to the Control Panel System Hardware tab Device Manage...

Page 35: ... or pkgadd d path qla2200 and follow the prompts The default answers for the questions the installation program asks can be accepted If the installation program asks to perform some actions accept them In the etc driver_aliases file add the line qla2100 pci129a 2100 if you have a VMFC 2100 P board or qla2200 pci129a 2200 if you have a VMFC 2200 P board 5 2 3 2 Prepare MDR Disk s for Solaris Connec...

Page 36: ...sk subsystem and the prompt will appear in dicating that it is now connected to the MDR disk subsystem and ready to receive com mands from the user If the configuration file items do not match the physical MDR disk subsystem configura tion then an appropriate error message will be shown 5 3 1Unavailable MDR Shell commands Because the MDR Shell is connected directly to the disk subsystem the user d...

Page 37: ...cAdapter parameter in the Host mdr ini file be set to 1 Because of the lack of VxWorks support of Direct Connection this mode is available ONLY for Solaris and Windows NT Hosts not available for VxWorks Hosts It is possible to simultaneously record to and readback from a disk array using the Host Network Direct Connection MDR mode The MDR board records data to the disks while the Direct Connect re...

Page 38: ...xit Exit the MDR Shell program Y Y Y Y format disk Low level format the MDR disk subsystem Y Y N Y help or Display help information for MDR shell commands Y Y Y Y list fc devices List the fibre channel FC devices P P Y Y new recording Allocate disk space for a new recording Y Y Y Y playback Start playback operation MDR 250 Y Y N Y prepare Prepare a transfer record or playback Y Y N Y record Start ...

Page 39: ...k group MyDiskGroup 1 2 4 7 add disks to disk group 4 8 clear recording table Syntax clear recording table Description Clear the MDR recording table The clear recording table command will format the recording table to an initial known state Therefore all the recordings will be lost Example clear connect disk group Syntax connect disk group DiskGroupId Description Connect the MDR Shell to an existi...

Page 40: ... a recording affects the recording performance The MDR Server may stop recording due to this Currently only the following copy recording commands are allowed copy recording Disks Host FileNamePathAndPrefix RecordingName FirstRecordingBlock LastRecordingBlock Copy data from the MDR disk subsystem recording specified by RecName to the host The data will be written to one or more files in a locally m...

Page 41: ...Block Copy data from the MDR disk subsystem recording specified by RecordingName to SCSI tapes one or several tapes according to the recording length and the internal drive compression rate FirstRecordingBlock and LastRecordingBlock specify the range of user blocks to copy first and last user blocks included If this range is not specified then the entire recording data is copied copy recording Tap...

Page 42: ...s containing their number or identifier The identifier of a disk can be retrieved using the list fc devices command it corresponds to the number written in the first column If this command is applied to a disk included in a group then the disk group information contained on this disk is destroyed Therefore the disk cannot be used in the disk group as is it has to be re added in the disk group usin...

Page 43: ...oding 0 Recording_1 exit Syntax exit Description Exit the MDR Shell program A confirmation from the user is required Example exit format disk Syntax format disk DiskIdList Description Low level format for the MDR disk subsystem This command performs a low level format of one or several disks This operation may help to correct bad sectors on disks The disks to be formatted are specified using a lis...

Page 44: ...he size is given in Blocks as a decimal number of size BlockSize The possible values for BlockSize are K or k for KiB M or m for MiB G or g for GiB If BlockSize is omitted then the block size is set by default to one mega binary byte 1MiB The argument InsertTag specifies if tags should be inserted during record operation The possible values for InsertTag are TAG Insert tags during record operation...

Page 45: ...k playback WAIT playback NOWAIT NONINF playback 4 0x80004 prepare Syntax prepare RecordingName TransferType Wait Infinite StartOffset EndOffset Description Prepare a transfer record or playback operation The RecordingName parameter specifies the name or number of the recording to prepare The TransferType parameter specifies the type of transfer to prepare A value of RECORD will prepare the specifi...

Page 46: ...arameter specifies if the record operation is infinite or not A value of INF will make the record command to be infinite whilst a value of NONINF will make the record command to be non infinite If Infinite is not specified the record command will be started in non infinite mode Examples record record WAIT record NOWAIT NONINF remove disks from disk group Syntax remove disks from disk group DiskGro...

Page 47: ...to communicate with the MDR host software because of a defective state When trying to reset the MDR system using the front panel reset button the action of this jumper will be the following Jumper RST DIS removed Pushing the reset button will perform both a local reset i e reset the MDR system by resetting the i960 processor and a global reset i e also potentially reset all the boards present on t...

Page 48: ... on the MDR Server s Executing the reset I960_RESET command from the MDR Shell will reset the MDR system but not the other boards present on the same VME backplane Jumper setting out Pushing the reset button on the front panel will reset the MDR system and the other boards present on the same VME backplane Executing the reset VME_RESET command from the MDR Shell will have ex actly the same effect ...

Page 49: ...e MDR will tests only the first stripe of all the disks This command is used in that case to test the disk accesses not the entire surface of the disks With the argument Disks only the MDR will test the same area as described above With the argument Disks StartBlock LastBlock where StartBlock represents the block where the test begins and LastBlock the block where the test ends For example to test...

Page 50: ...block of current recording The start block is given by the BlockNo argument Example set start block 400 Use caution when executing the set start block command as the recording may be inadvertently deleted To avoid this when using the set start block command always execute the commands for recording in the following sequence new recording 10 set start block BlockNo record show recording table Synta...

Page 51: ... using the option NOWAIT specifying that the MDR Shell should not wait for the record playback operation to finish Example stop The end of the recording data may contain garbage data The user has the responsibility to determine which part of the recording data is valid or not tag disable Syntax tag disable RecordingName Description Disable tags for a recording The RecordingName parameter specifies...

Page 52: ... Get the name of the current disk group GetRecordingInfo Get information from a recording GetRecordingsInfo Get information from all recordings GetRecordingTableInfoString Get the recording table information as a string GetRecTableInfo Get the recording table information GetServerName Get the server name GetServerStatus Get the server status PrepareTransfer Prepare a transfer ReadRecorderBlock Rea...

Page 53: ... adding a list of disks to an existing disk group the recording table contained on the disk group is cleared or kept intact according to the value or the parameter ClearRecordingTable If the recording table is cleared then any recording data present on the initial disk group or on the disks to add will be LOST Returned value OK or ERROR If ERROR is returned then the errno variable will be set acco...

Page 54: ... table by deleting all the recordings Returned value OK or ERROR If ERROR is returned then the errno variable will be set accordingly See MdrDefs h for MDR errno values ConnectToDiskGroup Declaration STATUS ConnectToDiskGroup char DiskGroupId UINT Options MDR_DISK_GROUP_CONNECT_CLIENT UINT DiskStripeSize 0 Description Connect to an MDR Disk Group ConnectToDiskGroup tries to establish a connection ...

Page 55: ...LIENT object and the MDR server specified by ServerHostname Returned value OK or ERROR If ERROR is returned then the errno variable will be set accordingly See MdrDefs h for MDR errno values ConnectedToServer Declaration BOOL ConnectedToServer void Description Check the connection to the MDR server ConnectedToServer checks if the client is connected to an MDR server Returned value TRUE if the clie...

Page 56: ...e set accordingly See MdrDefs h for MDR errno values CreateDiskGroup Declaration STATUS CreateDiskgroup char DiskGroupName DISK_INFO DiskInfoTbl UINT DiskInfoTblSize UINT DiskStripeSize BOOL ClearRecordingTable Description Create a new disk group This function creates a new disk group named DiskGroupName The new disk group will contain the disks whose information is located in the DiskInfoTbl para...

Page 57: ...TATUS DeleteRecording UINT RecordingNo and STATUS DeleteRecording char RecordingName Description Delete a recording This function deletes the recording specified Either of the recording number or name can be used to specify the recording in the recording table Returned value OK or ERROR If ERROR is returned then the errno variable will be set accordingly See MdrDefs h for MDR errno values Disconne...

Page 58: ...tem The number of the recording to test the MDR recording speed on is given by the RecordingNo argument TransferRate represents the recording rate in bytes per second reached by the MDR system Returned value OK or ERROR If ERROR is returned then the errno variable will be set accordingly See MdrDefs h for MDR errno values FormatDisk Declaration STATUS FormatDisk DISK_INFO DiskInfoTbl UINT DiskInfo...

Page 59: ...GetDiskGroupName Declaration const char GetDiskGroupName void Description Get the disk group name This function returns the name of the current disk group the MDR client is connected to Returned value A string or NULL If NULL is returned then the errno variable will be set accordingly See MdrDefs h for MDR errno values GetRecordingInfo Declaration STATUS GetRecordingInfo UINT RecordingNo RECORDING...

Page 60: ...able This function creates an information string of the recording table Returned value OK or ERROR If ERROR is returned then the errno variable will be set accordingly See MdrDefs h for MDR errno values GetRecTableInfo Declaration STATUS GetRecTableInfo REC_TABLE_INFO RecTableInfo Description Get the recording table information This function returns the REC_TABLE_INFO structure of the MDR and copi...

Page 61: ...arget devices in MdrDefs h file BlocksToTransfer Number of blocks to be transferred during the current running transfer operation if the current server operation is a transfer BlocksTransferred Number of blocks transferred so far during the current running transfer operation if the current server operation is a transfer BlockSize Size of each block to be transferred during the current running tran...

Page 62: ...of the last byte to be transferred only valid for playback operation Refer to the header files for more information about the MDR_TRANSFER structure A transfer identifier pointed to by TransferId is used to identify a transfer while starting it stopping it etc This identifier is computed by the MDR API and is an output parameter of this function Returned value OK or ERROR If ERROR is returned then...

Page 63: ...lock function while making a recording affects the recording performance The MDR Server may stop recording due to this Reading back data of a recording being recorded in infinite mode may end up in reading back data that will be very soon overwritten by the MDR RemoveDisksFromDiskGroup Declaration STATUS RemoveDisksFromDiskGroup char DiskGroupName UINT DiskPortIdTbl UINT DiskPortIdTblSize BOOL Cle...

Page 64: ...ackplane In this case the SYSRST signal on the VMEbus is asserted causing all the VME boards to reset if these boards are setup to reset when SYSRST is asserted Jumper RST DIS inserted Pushing the reset button will only perform a local reset PCI bus reset This means that only the MDR system will be reset and this reset will not be propagated to the other VME boards present on the same VME back pla...

Page 65: ...om the MDR Shell will reset the MDR system but not the other boards present on the same VME backplane Scan Declaration STATUS Scan DISK_INFO DiskInfoTbl UINT DiskInfoTblSize UINT DisksFound DISK_GROUP_INFO DiskGroupInfoTbl UINT DiskGroupInfoTblSize UINT DiskGroupsFound UINT Options Description Scan for new disk and or disk groups This function scans for new Fibre Channel devices disks and or disk ...

Page 66: ... errno values SetRecTableInfo Declaration STATUS SetRecTableInfo REC_TABLE_INFO RecTableInfo Description Set the recording table information This function sets the recording table information as specified in the REC_TABLE_INFO structure pointed to by the RecTableInfo parameter Not all parameters in the REC_TABLE_INFO can be changed The parameter CurrentRecording can be changed so that the current ...

Page 67: ...ERROR If ERROR is returned then the errno variable will be set accordingly See MdrDefs h for MDR errno values WriteRecorderBlock Declaration STATUS WriteRecorderBlock UINT FirstRecorderBlockToWrite void DataBuffer UINT DataBufferSize Description Write recorder block s to the storage device This function writes one or more recorder blocks to the storage device If the recording data located in the r...

Page 68: ...ram performs some basic operations Create an MDR Client object Create some recordings Record data Rename a recording This scenario may be used as a first communication test between a user s program and the MDR Server All the structures needed inside the API functions are allocated in this program In fact all the API functions check the input parameter s in order to avoid some unexpected and fatal ...

Page 69: ...1 Note It is possible to read data back from tape to the workstation using the UNIX dd command dd if dev rmt 0 of Recording_1 bs 1m 8 5 MDR API Limitation In order to use the direct access to storage device API functions on Windows systems the QLogic Driver has to be installed first The QLogic Driver must be installed on systems running Windows NT4 0 or 2000 Therefore it is not possible to access ...

Page 70: ... platforms Note The MDR API is not thread safe 8 7 Externals Libraries Some external libraries are required to compile the MDR API demo program or a project Please refer to the project settings Windows platform or the mdr host sw doc ApiExamples type of platform Makefile item LIBS other platforms Note When linking a program using the MDR API sun solaris platform it is required to add the library l...

Page 71: ...arameter Disks disk group name i e Disks vmetro 1 Run the Host MDR Shell and create disk group vmetro 1 which includes the disks where the recordings reside When asked if you want to clear the Recording Table on the disks choose n The MDR Shell can now access all recordings within disk group vmetro 1 When using the MDR Shell on an MDR board the command connect disk group is available In this case ...

Page 72: ...oup information to the disks included in the disk group Part of the management The user cannot create or destroy disk groups add or re move disks from a disk group The user has only the possibility of connecting to a disk group using the port id list of the disks to be included in the disk group and disconnecting from a disk group Disk group scan operation as no information is saved on the disks I...

Page 73: ...yback WAIT Prepare start a playback operation and wait for the MDR sys tem to complete the playback 9 2 2 2 No Wait NOWAIT Mode The second mode NOWAIT can be selected using the following commands record NOWAIT Prepare start a record operation and do not wait for the MDR system to complete the record playback NOWAIT Prepare start a playback operation and do not wait for the MDR system to complete t...

Page 74: ...ted by the user and without any time out or a power loss when reaching the last block of the recording 9 2 3 2 Infinite Mode In the Infinite mode a record playback operation behaves as follows record INF Prepare start a record operation from the first block of the re cording on the MDR disk subsystem in infinite mode The record operation does not stop unless interrupted by the user a time out or a...

Page 75: ...describing the transfer to be carried out and Trans ferId the transfer identification number used to identify the transfer in future function calls The field TransferType of the MDR_TRANSFER structure is used to specify the transfer type When a transfer is prepared it can be started using the function STATUS StartTransfer MDR_TRANSFER_ID TransferId And stopped using the function STATUS StopTransfe...

Page 76: ...ing the tag information in serted inside the recording data 2 The recording is resized according to the number of recorded blocks found Therefore the recording contains only valid data no garbage data The rest of the data on the MDR disk subsystem may be retrieved using the ReadRecorder Block function 3 The recording is set as stored and recorded 9 3 2 Tag Insertion The MDR system is able to inser...

Page 77: ...insertion for a recording 9 3 2 1 2 MDR API Like the MDR Shell the MDR API also allows to enable the tag insertion during the creation of a recording and to enable disable the tag insertion for a recording afterwards As described in the chapter related to the MDR API functions CreateNewRecording is used to create a new recording The recording field TagInfo specifies the recording tag information C...

Page 78: ... the user in order for the MDR system to adapt its configuration with network connection standalone acting as a gateway etc Do not change these items unless you are sure of what you are doing In the following item list any item related to a PMC slot should be set up according to the following values 1 or 6 for MIDAS 220S 1 to 5 for MIDAS 250 Note The mmon ini file included in the software distribu...

Page 79: ...aseAdrs X X User Medium StorageInfo Disks X X User Low VMFC 2100UnitXPmcSlot X User Low VMFC 2100UnitXPortId X User Low DiskTransferBlockSize X X User Low FcLoopRetryTime X X User Low UseHostFcAdapter X User Low DpioInfo SuspendSignal X User Low DPIO InputUnits X User Low DPIO OutputUnits X User Low DPIO InputUnitXPmcSlot X User Low DPIO OutputUnitXPmcSlot X User Low StartInputWaitTime X User Low ...

Page 80: ...ard s self test the MDR unit will present a short countdown to permit you to enter the MIDAS monitor Press any key to interrupt the countdown and then press the Enter key 2 or 3 times within 2 seconds to perform autobaud The MIDAS monitor prompt should then appear Update an item with the iset command iset section item text file For instance to change the number of disks used to 8 by the MDR system...

Page 81: ...nformation on the MDR Server program signature version numbers and MDR model name and some addresses which indicate where to read the monitor and control data structures on the VMEbus Therefore during a recording reading the SHARED_MEMORY_HEADER structure on the VMEbus at the SharedMemoryDataVmeBaseAdrs will provide the recording progress indication data For example to read this structure on the V...

Page 82: ...125 If this item is set undefined whereas X is in the range 0 125 then the MDR Server exits returning an error Also the VMFC 2100 Port Id should be less than any disk Port id FcLoopRetryTime Time in seconds the MDR server should try and retry to establish a connection with the MDR disk subsystem This time includes the time needed to initialize the SCSI controller s and the time to detect inquiry t...

Page 83: ... OutputUnitXPmcSlot PMC slot of DPIO output unit X where X is a decimal number in the range 1 6 This value should be 1 or 2 for performance reasons If the DPIO OutputUnits item is set to 0 or not defined then this item is not used If this item is missing then the DPIO output module X is ignored StartInputWaitTime Maximum time the MDR server will wait before receiving the first recorder block of da...

Page 84: ...ime OutputWaitTime divided by 60 represent the number of seconds the MDR server will wait before stopping the current playback operation ByteSwap Enables if set to Enable or disables if set to Disable the byte swapping If this item is missing then the byte swapping is disabled OutputFreqDivisor Output oscillator frequency divisor This item specified the value by which the frequency of the oscillat...

Page 85: ...s option is only valid when the SuspendSignal item is set to Enable Servers This section contains information the MDR Shell needs to know about the servers it should try to connect to sX Hostname of server X where X is a decimal number This parameter is only needed by the MDR Shell program If any sX items are defined then the MDR Shell will prompt the user for the MDR Server hostname SCSI This sec...

Page 86: ...the AutoSense option must not be used EthSpeed must be set to 10Mb or 100Mb as appropriate for the network to which the MDR will be connected VmeInterface This section contains information the BSP needs to know about the VME interface on the MIDAS board VmeA32SlaveDisable VME A32 slave image enabled flag If this item is set to 1 respectively 0 then the VME A32 slave image is disabled respectively ...

Page 87: ...Cs installed on the MIDAS board SCSIUnitXPmcSlot PMC slot where the SCSI PMC module number X is installed X is a decimal number starting at 1 2 3 4 If no items are specified then the MIDAS BSP will not try to detect SCSI PMCs In the MDR application this item is used currently to connect a SCSI tape drive It should be setup as reference in the MDR standard configurations SCSIUnitXPciBaseAdrs PCI ba...

Page 88: ...oard itself SerialNo MIDAS Board serial number This number can be read on the MIDAS board itself BootInfo This section contains information the MIDAS Monitor needs to know how to boot TestUart UART test indicator The MIDAS Monitor tests the UART if this item is set to 1 doesn t test it if this item is set to 0 This item should be set to 0 UartLbBytes Number of bytes sent each time for the UART loo...

Page 89: ...formation the MIDAS Monitor needs to know about the start up procedure ProcessPriority This item should be set to 16 StartAddr DRAM address where the MIDAS Monitor jumps after performing all the tests This item should be set to 0xfe000000 WaitTime MIDAS Monitor countdown time in seconds before jumping to StartAddr If this item is missing then a default time will be used 5 seconds 10 7 Configuring ...

Page 90: ...Change examples above and the value is whatever is appropriate for your system vxbp nonet txt is used when no external network is required vxbp nonet txt may also be used as a starting point to get the MDR unit up so that the bootChange command can be used To install vxbp nonet txt use the following procedure 1 Enter the Midas Monitor and delete vxbp txt midel vxbp txt 2 On the Host computer go to...

Page 91: ... the size of the desired boot parameter file to be uploaded The MIDAS monitor will begin an XMODEM receive Instruct your terminal program to begin an XMODEM send of the file containing the boot parameters you wish to use Once the file is sent there will be a pause while the new vxbp txt file is written to FLASH When the MIDAS Monitor prompt returns check the contents of the file use the more comma...

Page 92: ...to handle Also check that the expected number of disks is being used by the MDR server The MDR system only uses X out of Y expected disks with X Y Check that the value of the item Disks in section StorageInfo in mdr ini is set to X The MDR system reports that it is unable to configure a VMFC 2100 card Check that the VMFC 2100 card is positioned in the PMC slot specified by the item VMFC 2100UnitXP...

Page 93: ... FIFO of DPIO device The data source is sending data faster than what the DPIO input module is able to transfer If the data path is FPDP and the data source supports the Suspend signal then the configuration item SuspendEnable section DpioInfo in the configuration file mdr ini should be set to 1 i e enabled S_mdr_ILLEGAL_OPERATION 0x5550000D Illegal operation The current state does not allow the c...

Page 94: ...o the recording table has timed out This may indicate a problem with a several disk s or that the disk s has have been removed from the FC loop S_mdr_RECTBL_INVALID 0x55500022 Recording table is invalid should be cleared The recording table can be set to invalid for several reasons The recording table checksum is not consistent with the recording table content The recording table contains too many...

Page 95: ...ransfer phase has been stopped by the MDR Shell command stop or by a call to the MDR API function StopTransfer If the transfer was a recording then the recording has been truncated and it contains the recorded data so far Recording stored and recorded S_mdr_TRANSFER_TIMEOUT 0x55500032 Transfer timed out The MDR Server has not been able to transfer record in this case the entire recording size beca...

Page 96: ...mdrvxst hex needed for updating the MDR system mdr server etc contains the configuration files mdr ini vxbsp ini documents contains the documentation including the Re lease Notes Version Upgrade Matrix The following matrix identifies the software that must be upgraded when migrating from past versions of MDR Software to the current version At a minimum the software indi cated with a Y must be upgr...

Page 97: ...rminal program to 38400 Then hit Enter a few times and wait for the MIDAS Monitor prompt to appear The output of the terminal program should be very similar to the following one Start of output Midas i960RP 1 booting i960RP 2 Detected Device ID 0x1960 Vendor ID 0x8086 i960RP 2 is in Reset i960RP 2 Test Passed Universe Chip Detected Device ID 0x0000 Vendor ID 0x10e3 Universe Status Dis A24 0 SysCon...

Page 98: ... updated mgf mdr ini 766 only if mdr ini needs to be updated Note The file sizes used above are given as examples and should not be used The real sizes of the configuration files present on the VMETRO Software Products CD ROM may differ Please find out the size of these files before trying to download them The mmon ini file supplied by VMETRO is a generic file and must NOT be up loaded in any case...

Page 99: ...0 Universe Chip Test Passed PMC slot 1 Occupied Device ID 0x2100 Vendor ID 0x1077 Boot Test Passed BDW 00007c00 Connection established Hit any key to enter Midas Monitor 3 Starting Midas Monitor AutoBaud Detection Please hit enter a few times Midas Monitor 1 02 Jun 4 1998 Copyright 1996 98 VMETRO asa Board Model M220SR Processor i960RP at 33 MHz RP step number 01 JF step number 02 System Informati...

Page 100: ...h the new version 1 Locate the directory where the old MDR host software has been installed For in stance usr mdr host sw bin sun solaris if the selected platform is sun solaris and the MDR root directory is usr 2 On the VMETRO Software Products CD ROM locate the MDR host software bi nary file This file can be found in mdr host sw bin platform and is called mdrshell or mdrshell exe for the x86 win...

Page 101: ...ained throughput are essential This includes areas such as multi processor communications telecommunications radar signal processor sensor I O radar sonar image processing and ultra high performance computer networks digital broadcasting subsystems data links For further information on the VMFC 2100 PMC module see the VMFC 2100 Fibre Channel PMC Module User s Guide Current Models VMFC 2100 DC Fibr...

Page 102: ... Local Port Port C Intergrated Hub block diagram Redundant Arbitrated Loop RAID JBOD connection With redundant connections from the VMFC 2X00 to the RAID JBOD the OmniPort automatically switches to the alternate loop when the current loop fails The alternate loop is looped back to the disk array The OmniPort will park on the last known good loop and only switch upon failure detection Redundant con...

Page 103: ...nel controller is active P1 Valid Fibre Channel signaling is detected on external port 1 P2 Valid Fibre Channel signaling is detected on external port 2 Fibre Channel Cables The following cables can be ordered directly from VMETRO Part Number Description FCC HD 03 3 meter Fibre Channel HSSDC to 9 Pin DB9 Copper Cable FCC HD 05 5 meter Fibre Channel HSSDC to DB9 Copper Cable FCC HD 10 10 meter Fibr...

Page 104: ... For more detailed information about the DPIO PMC module see the DPIO PMC Module User s Manual DPIO Features 32 bit input output FIFOs Synchronous port with FPDP interface Linked list DMA controller on PCI Personality module for proprietary and user defined I O interfaces PLD allows customization data packing Optional byte swapping 16 bit 10 bit 8 bit or 4 bit data packing Up to 108 MiB sec PCI da...

Page 105: ...ogramming Kit part no PLD KIT DPIO for this purpose The kit contains everything that is needed a PC parallel port cable JEDEC files for all packing options and software Input Output port Packing PCI 32 bit D31 D00 No packing 32 bit 16 bit D15 D00 2 to 1 packing 32 bit 10 bit D09 D00 3 to 1 packing 30 bit databits 31 or 30 not in use 8 bit D07 D00 4 to 1 packing 32 bit 4 bit D03 D00 8 to 1 packing ...

Page 106: ...ndensing Storage Humidity 5 to 95 non condensing Power consumption Typical 1 0A max 1 5A at 5V Weight 100 grams DPIO FI FO FPDP The most common interface for the DPIO is the FPDP Front Panel Data Port The FPDP bus is intended to provide data transfer between two or more VMEbus boards at up to 160 MiB s with the lowest possible latency without compromising existing VMEbus and other connections on t...

Page 107: ...ESERVED RES2 GND RESERVED RES3 GND 7 PSTROB GND PSTROB GND 8 SYNC GND DVALID GND 9 D31 D30 GND D29 10 D28 GND D27 D26 11 GND D25 D24 GND 12 D23 D22 GND D21 13 D20 GND D19 D18 14 GND D17 D16 GND 15 D15 D14 GND D13 16 D12 GND D11 D10 17 GND D09 D08 GND 18 D07 D06 GND D05 19 D04 GND D03 D02 20 GND D01 D00 GND Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com ...

Page 108: ...es RES2 1 27Ω series 27Ω series NA NA NA NA when connected FPDP Options The FPDP standard defines a number of signals which may be used differently in different modes of operation This section describes their usage in the MDR Clocking Input module DPIO FI Two separate clocks are provided on the FPDP STROB is a single ended clock conforming to TTL levels while PSTROB and PSTROB is a differential Po...

Page 109: ...IO input module to signal the data source that the MDR is ready to start recording receiving data The data source is responsible for not sending data until the PIO signal has been asserted logical level 1 When the recording has finished the MDR will de assert PIO logical level 1 to 0 to signal that it is so In future versions the MDR will support functions in the API to allow the user to control t...

Page 110: ...g command at the MIDAS Monitor prompt iset DpioInfo WaitForSync Enable mdr ini FPDP Clocks Two separate clocks are provided on the FPDP STROB is a single ended clock confirming to TTL levels while PSTROB and PSTROB is a differential positive Emitter Coupled Logic ECL version of the same clock Either of these signals may be used However the PSTROB PSTROB signal pair is preferable especially at high...

Page 111: ...ed Pair 80 pin Ribbon Cable w connectors 10m CBL PECL 30 PECL Twisted Pair 50 pin Ribbon Cable w connectors 30cm CBL PECL 60 PECL Twisted Pair 50 pin Ribbon Cable w connectors 60cm CBL PECL 90 PECL Twisted Pair 50 pin Ribbon Cable w connectors 90cm Proprietary Interfaces PECL LVDS RS422 The DPIO is available also in models with proprietary front panel interfaces These are DPIO EI EO High speed dif...

Page 112: ...res High performance full speed 32 bit DMA bus transfers at 132 MiB s Single shielded or unshielded RJ 45 connection Automatic sensing of speed and change to that speed Powerful parallel cut through architecture and other patented features to maximize data throughput and minimize CPU use 100BASE TX 100 Mb s with UTP Category 5 cabling or 10BASE T 10 Mb s with UTP Category 3 4 5 cabling Configurabl...

Page 113: ...1 2 3 4 5 6 7 8 RJ 45 Connector Front View 106 MDR User Guide Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com ...

Page 114: ...performance 32 bit DMA bus transfers at 110 MiB s SCSI II Ultra Wide single ended interface Asynchronous or synchronous operation Active termination and signal negation Utilizing NCR s 53C875 SCSI I O Synchronous SCSI data rates up to 40MiB sec Supported tape drives The MDR has been tested successfully with the following tape drives Seagate Sidewinder 50 AIT 1 2 Quantum DLT 7000 SCSI Tape Format T...

Page 115: ...e Recording data saved as raw and compressed data Data is send to the drive uncompressed compressed internally inside the drive if possible then saved to the tape Reading a recording to host Reading a recording from tape s to host can be done using SCSI commands to 1 Open and configure the tape drive the current block size used is 1kbytes 2 Read the Tape Header structure from tape 3 Read raw data ...

Page 116: ...0 0V 64 SCSIIO 31 0V 65 SCSID8 32 0V 66 SCSID9 33 0V 67 SCSID10 34 0V 68 SCSID11 Denotes signal active low SC PMC 875 Specifications SCSI SCSI I and SCSI II Narrow 8 bit wide 16 bit or ultra wide 32 bit single ended interface PMC PMC Host Bus PCI Local Bus revision 2 1 PMC IEEE P1386 1 CMC IEEE P1386 Operating Temperature 0 to 55 C with 200LFM air flow Storage Temperature 40 to 70 C Operating Humi...

Page 117: ...Data Recorder Module FPDP Input Dual Copper FC Ethernet MDR 250 1050E MDR 250 Data Recorder Module FPDP Input Dual Copper FC SCSI MDR 250 105S0 MDR 250 Data Recorder Module FPDP Input Dual Copper FC SCSI and Ethernet MDR 250 105SE MDR 250 Data Playback Module FPDP Output Dual Copper FC Ethernet MDR 250 0350E MDR 250 Data Playback Module FPDP Output Dual Copper FC SCSI MDR 250 035S0 MDR 250 Data Pl...

Page 118: ... defined in the mdr ini file and MDR_MODEL_NAME_MAXSIZE is defined in the MdrDefs h file ProgressIndicatorEnabled is a flag indicating if TRUE that the progress indicator structure mapped to the VMEbus contains valid data and is updated by the MDR Server If FALSE the progress indicator structure contains invalid data and should be ignored MonitorDataStructureOffset pointed to a structure which is ...

Page 119: ... BDW MDR Tests 0 20 25 MIDAS board BDW MDR Tests 0 20 25 19 0 15 14 8 9 MIDAS Board Elements i960 DRAM MIDAS Board PMC slots Reserved 19 0 15 14 8 9 MIDAS Board Elements i960 DRAM MIDAS Board PMC slots Reserved Reserved Universe PCI to VME Bridge Reserved I960 1 Serial EEPROM Not Used Rest of DRAM DRAM BANK 0 UART 2 1 4 3 0 5 6 7 8 Bit 0 PMC present Bit 1 No PMC or ERROR Reserved Universe PCI to V...

Page 120: ...4 23 25 22 Bit 0 OK Bit 1 ERROR Example MDR 250 135SE There are two different options Using a VME host read the BDW via the VMEbus Boot Diagnostic Word 0000 0000 0000 0000 0100 0001 0000 0000 0 0 0 0 4 1 0 0 Reading back the MDR Server Boot Status Using an application based on the MDR API read the BDW using the Get ServerStatus function MDR User Guide 113 Artisan Technology Group Quality Instrumen...

Page 121: ... to the VMEbus by the MDR Server MDR with processor number 0 the BDW is mapped at the VME address 0x18 MDR with processor number greater than 0 the BDW is mapped at the VME address 0x400000 ProcessorNumber 0x10000 0x18 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com ...

Page 122: ...erconnect PMC PCI Mezzanine Card RAID Redundant Arrays of Inexpensive Disks Recorder Block Data block of size Recorder Block Size The space available to the user to store data on the storage device is divided into a number of blocks called recorder blocks The number of recorder blocks can be retrieved using the MDR Shell or MDR API Recorder Block Size Block size of the MDR This size can be retriev...

Page 123: ...l service in house repair center WE BUY USED EQUIPMENT Sell your excess underutilized and idle used equipment We also offer credit for buy backs and trade ins www artisantg com WeBuyEquipment REMOTE INSPECTION Remotely inspect equipment before purchasing with our interactive website at www instraview com LOOKING FOR MORE INFORMATION Visit us on the web at www artisantg com for more information on ...

Reviews:

No comments

Brands by name

Popular brands

Load more brands