Home
TMA - Free
Contents
1. Reference manual 205 Telindus Memory Loader TML 11 3 Starting TML from the command line examples Downloading to a local device TMA Suppose PC running TMA e you want to download new firmware to a local Crocus HDSL is modem I poe e your computer its COM2 is connected to the auxiliary connector oo SS of the local Crocus HDSL modem e you want to download the firmware to the flash bank 1 or 2 that is currently non active e you want to see the download progress In this case the TML syntax is tml y c2 fT2114014 000CONTROL Downloading to a local device with a password Crocus HDSL Suppose PC running TMA e you want to download new firmware to a local Crocus HDSL modem protected with a password _ S CMe e your computer its COM2 is connected to the auxiliary connector of the local Crocus HDSL modem e you want to download the firmware to flash bank 2 e you want to see the download progress In this case the TML syntax is tml y c2 f T2114014 000CONTROL2 7pass123 Downloading to a remote device specifying its relative address SUPPOSE PC running TMA e you want to download new firmware to a remote Crocus HDSL modem specifying its __ Va COM2 ee ee e Crocus HDSL password pass123 relative address 2 bytes hexadecimal i l _Gaa e your computer its COM2 is connected to the central remote auxiliary connector of the local Crocus H
2. then this is not detected Because the attribute syContact does not exist no user defined value will appear Remark 2 As mentioned before a definition can span multiple lines If an error is detected in the definition then the returned line number is the line that contains the closing semicolon character This is not necessarily the line that contains the actual error Example 1 Consider the following custom txt file common sysContact ISP Tel 784512 Helpdesk Tel 1100 SysAdmin sysLocation Main building equipment room Remote building management alarmFilter lowSenseFilter 0 C mediumSenseFilter 5 highSenseFilter 10 As you can see on line 5 of the file a comma is missing However when you start TMA the custom log file will contain the following message 16 40 49 parsing file C Program Files TMA config custom txt line 7 error in valuelist of definition As you can see in the custom log file line 7 is indicated as the erroneous line This because this line contains the closing semicolon character for the definition of the alarmFilter attribute value The real error however is located 2 lines higher This is due to the way the parser works Continued on next page 148 Reference manual TMA User defining values using the custom txt file Remarks on the custom log file continued Example 2 Consider the following custom txt file commo
3. Select device window The Connect Select device window selections User manual 45 Opening a TMA session TMA 4 3 1 When does the Connect Select device window appear As said before the Connect Select device window only appears if the device through which you are accessing your network gives the possibility to open a TMA session on a device located further on in the network To clarify this two examples are given The first example shows you a situation where you will get a Connect Select device window The second example shows you a situation where you will not Example 1 Suppose you have the following set up E tin men EE I A ES PC running modem 1 modem 2 modem 3 modem 4 TMA Your computer running TMA is connected on COM1 via a direct connection to the control port of modem 1 So in the Connect Device window you select Serial com1 enter a Password if necessary and press on the Next button In this situation the Connect Select device window appears This window allows you to open a TMA session on e the modem through which you are accessing your network i e modem 1 e the modems located after modem 1 i e modem 2 3 and 4 Suppose you open a TMA session on modem 1 by selecting On device in the Connect Select device window Suppose that after a while you want to open a TMA session on modem 3 In that case you can call the Connect
4. e clicking on the bit string in order to select it e dragging the mouse pointer over the bit string By doing so you can make the separate bits e bold which represents a 1 enabled or on e greyed out which represents a 0 disabled or off In the following example the bits O up to 16 are set to 1 f timeSlots 012345676901 23456 Continued on next page 106 User manual TMA The TMA window Attribute value continued Structured value A structured value is a list of values which is displayed in the structured value window In the attribute window they are represented as the strings lt Struct gt or lt Table gt The following table displays these structured values Structured Description value structure The lt Struct gt string indicates that there are underlying Name Value values These underlying values are visible in the b highBitErondlanm lt Struct gt structured value window They are located next to each other i e in one row a F highBitE ror larm averagingPeriod onThreshold offfhreshald 1e 004 The lt Table gt string indicates that there are underlying anc We he values These underlying values are visible in the b security Table structured value window They are placed in rows and columns l F Security _ password accessRights_ P fullaccess 111 P 2 access 011 P3 readonly O01 Continued on next page User manual 107 The TMA
5. c comport com port can be 1 2 3 or 4 uluser address user address for remote unit tany hex address gt xLextra address extra address for remote unit Foxxxx or FHxXxxx hex alahbs address absolute addres s amp s for remote unit 2 bytes in hex r rel address relative address for remote unit 2 bytes in hex llipfddress Lan ip address of the device plpassword password as strapped on the modem f Filename Filename of download software maximum 5 t telephone number for remote maintenance yyverbose mode graphical information uwlwindows ize maximum windowsize is h perform boot before download aster4 must be specified if the device is an aster4 running in boot code Default options are a96 ci ug e f you want to execute the TML command in a directory different from the TMA bin directory typically C Program Files TMA bin then make sure you define the correct path to the TML executable on your system On Windows 95 and 98 this is typically done with the set path command in the autoexec bat file On Windows NT 4 0 and 2000 this is typically done with the path string in the Environment tab of the System Properties window e TML versions 80003 01000 and lower operated completely independent from TMA From version S0003 01100 onwards TML uses the TMA comms handler for its communication handling This means that when TML is started from the command line the
6. fou might specity a password to connect to the device IF not the network password will be used iF arn lt Back Cancel Password Continued on next page 47 Opening a TMA session TMA Displaying the Connect Select device window continued If you already opened a TMA session on a device but you want to open one on a device further on in the network proceed as follows In the TMA window either a e press on the Select device button e or press the shortcut key Ctrl D e or select from the menu bar Connect gt Select device The Connect Select device window appears Make your selection in the Connect Select device window Refer to Section 4 3 3 The Connect Select device window selections Press on the Next button A TMA session opens on the device 48 User manual TMA Opening a TMA session 4 3 3 The Connect Select device window selections This section shows the Connect Select device window All the different selection possibilities are numbered They are explained in the following paragraphs The Connect Select device window is depicted below Connect Address Choose whether to connect on the network device itself or a device thereap r it so specity its address On device modern After device f Configured device NMS address lo i Relative C Absolute E sitport C
7. H bridge b 128 Reference manual TMA User instantiatable object 7 3 Removing a user instantiatable object To remove a user instantiatable object from the containment tree proceed as follows a Left click the user instantiatable object you added earlier By doing so the object is selected highlighted blue E g left click the routingFilter filter1 object of the Telindus 1421 SHDSL Router you added in the example of Section 7 2 Adding a user instantiatable object While the object remains selected right click it A pop up menu appears In the pop up menu select Delete The user instantiatable object is deleted ache filter T tunnels defaulty at Retieve F5 Reload T management ced proxy 1O U lr tele Berle Reference manual 129 User defining values using the custom txt file TMA 8 User defining values using the custom txt file This chapter explains how you can user define values for attributes that have a string or an integer as value You can do this using the custom txt file The following table gives an overview of this chapter cseton OCC What is user defining values Creating the custom txt file The structure of the custom txt file The sections of the custom txt file The definitions of the custom txt file 8 6 142 An example of a custom txt file Reading the custom log file 144 130 Reference manual TMA User defining values using th
8. In the Export configuration parameters window tick the Recurse submodels selection 5 In the Export configuration parameters window enter a file name a destination and press on the Save button 96 User manual TMA The TMA window b The mport configuration window selections This section shows the mport configuration window All the different selection possibilities are numbered They are explained in the following paragraphs The Import configuration window is depicted below Import Configuration P Look in 2 bin Sa Bt SS Import selection 1 G DSL configuration cm z SOSL configuration cms k SOSL_ configurations cms a SOSL configuration cms File name SDSL_configurationt Em esa Import selection 2 Files of tupe Crs file crs See Import selection 3 User manual 97 The TMA window TMA Import selection 1 Look in Look ir E bin 41 Desktop a My Computer a 3H Floppy A ga Telndus C Program Files Locate with this selection the file you want to import Import selection 2 File name File name DSL TT_contiguration cms Enter here the name of the file you want to import Import selection 3 Files of type Crs file crng Select whether the file you want to import is a CMS or a CLI file For more information on these file types refer to Paragraph Export selection 3 Save as type on page 91 After importing a configuration file you still have to
9. Syntax SEND Ye Cli conmmand gt Description This command is meant to be used in combination with a CLI command that sends information to the device e g the set command the action command etc Since such commands normally do not produce output no output is written to the action output window Except when the CLI command causes an error The send command can be followed by e a CLI command between quotes e the FROMFILE command followed by a quoted string specifying the file The file is then interpreted as a CLI script For more on scripting in CLI refer to the Maintenance tools manual Read Section 9 9 1 Important remarks on action commands for some important issues concerning the use of quotes backslashes etc Important remark As said before the SEND command is used in combination with a CLI command Do not confuse CLI with TMA CLI Whereas CLI is a management tool which runs on the Telindus access devices themselves TMA CLI is a program which you have to install on a computer TMA CLI is a more elaborate command line interface with more features and commands then CLI Whereas most of the TMA CLI commands are the same as the CLI commands some commands that exist in TMA CLI do not exist in CLI Hence you can not use these commands in the interactive sub system scripts These commands are exit logging exec cfgload memload and source It is also best to avoid the disconnect command Else the sessio
10. TEL NDUS TMA USER and REFERENCE MANUAL Version 5 6 182086 Telindus Technical Publications Geldenaaksebaan 335 B 3001 Leuven Belgium tel 32 16 382011 Copyright notice TMA Copyright notice The information and descriptions contained in this publication are the property of Telindus Such information and descriptions must not be copied or reproduced by any means or disseminated or distributed without the express prior written permission of Telindus This publication could include technical inaccuracies or typographical errors for which Telindus never can or shall be held liable Changes are made periodically to the information herein these changes will be incorporated in new editions of this publication Telindus may make improvements and or changes in the product s described in this publication at any time without prior notice Version 5 6 24 December 2002 MRP 182086 Telindus TMA Preface Preface Organisation of this manual This manual contains two main parts User manual introduces TMA and explains how to install it It also shows you the basic functions of TMA teaches you more about the advanced functions of TMA gives some additional information User manual The following table gives an overview of the chapters in the user manual Chapter This chapter gives an introduction on the Telindus Maintenance Application TMA shows you how to install TMA on your computer Telindus dev
11. Delete Aow Del Select All Ctrl 4 80 User manual TMA The TMA window a The containment tree Edit menu Display this menu by selecting an object in the containment tree and pressing the right mouse button Containment tree crocusSDOSLTT der Reload Pelete Addled nMS wh nye The following table lists and describes the underlying commands Retrieve This command retrieves all the attribute values of the currently selected object from the device The shortcut key for this command is F5 Reload This command reloads the currently selected object from the device If you select the top object and perform a reload the complete containment tree is reloaded A reload is necessary when during a TMA session objects appear disappear or change in the containment tree This is the case when for instance a V35 Nx64k interface module of a Telindus modem is replaced by a RS530 interface module Delete This command deletes a previously added child object A child object is also called a user instantiatable object For more information on user instantiatable objects refer to Chapter 7 User instantiatable objects Add child This command adds a child object A child object is also called a user instantiatable object For more information on user instantiatable objects refer to Chapter 7 User instantiatable objects User manual 81 The TMA window TMA b The attribute Edit menu Display this
12. SEND action startPing pingData ipAddress 1 iterations 0 TMA ARG IP Address PRINT The ping results are n click on End Loop to stop pinging n LOOP SHOW get pingResults SEND action stopPing PRINT nPing action stopped 190 Reference manual TMA The interactive sub system picture showPolling PRINT The devices that are defined in the object table nand that can be polled are n SEND select 01003 nmsgroup SEND selgrp Status SHOW get s objectTable f pollState polling showNoAnswer PRINT The devices that are defined in the object table nand that do not answer when polled SEND select 01003 nmsgroup SEND selgrp Status SHOW get s objectTable f pollState not answering showRoutingTable PRINT The status of the routing table is n SHOW get 01003 router routingTable Status This usr file results in the following sub system picture Orchid JOf x zoomia 200m Wnt Options Identification Show polling devices Show nok answering devices Show routing table Ping PORTISCTRL g D COHTROL ORCHID 1003 LAH Reference manual 191 The interactive sub system picture TMA 9 12 Reading the picture log file The usr file is loaded and parsed when the sub system picture is evoked When an error is encountered TMA displays an error message and writes the error in the picture og file Th
13. The help text Make sure the necessary curled brackets commas quotes and semicolons are present else the syntax is incorrect Continued on next page Reference manual 163 The interactive sub system picture TMA The ALARMPORTS sub section continued Example The following example assigns the action showLineStatus to the line connector Also a tooltip is assigned to this connector REAR ALARMPORTS modem line ACTION showLineStatus HELP Click to display the line status i This results in the following i p SERER PWR TET ERR THO 9 EXD ET 4L ROL OL na na Pur E ai Click to display the line status D Output OFX te Ei AutoScrall Bnd Loop Help k iFSpeed 0 iFOperStatus down lineState idle lineathenuation 62 0 dB e noiseMargin 16 0 dB E timeSinceLastRetrain Od 00h 00m 00s E Close 164 Reference manual TMA The interactive sub system picture 9 6 The BUTTONS section of the usr file For an introduction on the BUTTONS section of the usr file refer to Section 9 4 The sections of the usr file A Do not confuse this BUTTONS section with the BUTTONS sub section in the FRONT section Whereas this BUTTONS section defines the customised buttons located at the left hand side of the sub system picture the BUTTONS sub section in the FRONT section defines the interactive function of the test buttons on the front panel of the device
14. annannannennanennnnnnnsnnonnsnrerrerrsrrernsrrererrerrerrerrenn gt 6 23 Stalling TMA from TOD DY dISK Sree E E T 2 4 Installing TMA Trom CD ROM si cestiescnsds seen i aie ods enecbewbeuxindsiwenensendeees 10 2 5 Installing TMA from the Telindus web Site ccccccccccccececececeeeeaeeeceeeeeeeeseeesaeeeseesaees 13 20 EOCATION OF Ne TMA MCS isu cacescxauss cute cs E E E E 16 2 f Remarks on updating and uninstalling TMA cccccccceecceceeeeeee eee eeseeeeeeeeeeeeeesaeeees 17 2 8 What TMA changes in the registry ccccccccsecceeccneeceeeceeeseeeceeceeceeceeeseueseeseesaeesas 20 3 COMNECUING to AvAGVICE iariionicecsccrs ters cetacericee renee nec hace nacenacewelenicewateniceetierah teehee 21 3 1 What are IP proxied IP and non IP devices ccccccceccceecceeeeeeeeeeeeeeeseeceeeeeeeteeeeaeeees 22 SZ JOIRECECONNMECHON IO a deV CE nuni aa NA 23 O20 JF GONMECHON an lP devi Erens cued atau 26 3 4 Proxied IP connection to a NON IP device 1 00 ccc cece ecceeeeeeteeceeeceeeeeeaeeteesseeeeeseeeeees 29 4 Opening a VIMIA SESS IO Me sircerecere sere ence cncsenescnes ones enccencsencesnce eeceeecexeee se aieeeestereewecsgeee 34 AT SANNO TMA en a eae laae sanbca cee eceteoacepiseuenaouene 35 AZ COMMCCUUMG 10 a CSV CC sonei a onde spheet iseetesued 36 Ai 3 SeCIOCUNG at OC VICE feic tr dasa A 45 44 The TMA command NAS icres censactrsetexeue tenet cpa a usual a aS ttl seats shoes oleae 61 5
15. internal COMMUNICATION SIONS srecna oran retener A AEON Eee aTe AE 248 Annex Cr prod ctiniormatlOM iinta ae anwbaeeaneebeteeneahbiwks 249 User manual User manual TMA User manual TMA Introduction 1 Introduction This chapter gives an introduction to the Telindus Maintenance Application TMA First it describes what TMA is Then it gives the main features of TMA What is TMA Due to the continuous evolution in the domain of data communication technology data communication devices become more and more complex to install and control This results in a need for an easy maintenance tool The Telindus Maintenance Application TMA is such a tool It offers you full control over any Telindus device in your network in combination with a user friendly man machine interface MMI Features of TMA The most important features of TMA are e direct connection via the device its control port e remote connection over the network e password protected access to the device e reading and changing the device configuration e configuration profiles can be stored on hard disk for re use e instant status performance and alarm information e real time monitoring of the interchange circuits RS 530 V 35 V 36 X 21 G 703 IP Router etc e real time monitoring of modem line parameters e execution of diagnostic tests e downloading software to the device e sub system picture User manual 3 Installing TMA TMA 2 Installing
16. preceded by two dashes They make the current line inactive i e the line is not parsed when you evoke the sub system If you want to activate this line remove the two dashes and the line will be parsed when you evoke the sub system The following shows an example of a usr file for the Orchid 1003 LAN CV orchidO1003CV usr COMPONENT orchid01003CV FRONT LEDS LEDPower ACTION showUpTime HELP Click to see the system up time interfaces lanInterface 1lEDLnk ACTION showAlarmLanPort HELP Click to see the alarms of the LAN interface interfaces lanInterface 1lEDCol HELP interfaces lanInterface 1EDTx ACTION showPerfLanPort HELP Click to see the performance of the LAN interface interfaces lanInterface 1EDRx ACTION showPerfLanPort HELP Click to see the performance of the LAN interface ALARMPORTS interfaces portA ACTION showStatusPortA HELP Click to see the status of port A interfaces portB ACTION showStatusPortB HELP Click to see the status of port B interfaces lanInterface ACTION showStatusLanPort HELP Click to see the status of the LAN interface BUTTONS Identification ACTION showID HELP Click to see the identification of the Orchid Show polling devices ACTION showPolling HELP Click to see which devices that are defined nin the object table can be polled Show not answering devices ACTION showNoAnswer HELP Click to see which d
17. sysContact System admin tel 2154 Setting the channel to central Arguments Close Cancel OK 180 Reference manual TMA The interactive sub system picture 9 9 8 The show command Syntax SHOW lt cli_ get command gt Description This command is meant to be used in combination with the CLI command that retrieves information from the device e g the get command The output is written to the action output window The show command can be followed by e the CLI get command between quotes e the FROMFILE command followed by a quoted string specifying the file The file is then interpreted as a CLI script For more on scripting in CLI refer to the Maintenance tools manual Read Section 9 9 1 Important remarks on action commands for some important issues concerning the use of quotes backslashes etc Example Suppose you want to see the complete configuration of the device This action would look as follows ACTIONS seeCompleteConfig PRINT The complete configuration of the device is n SHOW get r An example with a FROMFILE construction can be found in Section 9 9 4 The from file command Reference manual 181 The interactive sub system picture TMA 9 9 9 The start and stop refresh command Syntax STOPREFRESH STARTREFRESH Description The sub system picture is refreshed every n 10 seconds as configured by the user refer to Section 9 2 The sub system picture win
18. to select does not correspond with the model file of that device l e the model file has become obsolete and you need a new model file for the device Solution Go to the Telindus web site at http www telindusproducts com tma download the latest version of the TMA model files and re install them 224 Reference manual TMA Troubleshooting 13 2 5 You get an Unknown modules in containment tree error message You try to select a device on the network but you get the following error message Error x Unknown modules in containment tree This is somewhat similar to the previous error message l e it means that the revision of the firmware which is stored in the active flash bank of the device you try to select does not correspond with the model file of that device l e the model file has become obsolete and you need a new model file for the device Solution Go to the Telindus web site at http www telindusproducts com tma download the latest version of the TMA model files and re install them Reference manual 225 Troubleshooting TMA 13 2 6 You get an Unknown type of device error message You try to select a device on the network but you get the following error message Error x Unknown type of device This means that the models nms file situated in the C Program Files TMA model directory on your computer does not contain a reference to the model files of the device Solution Go to the Telindus
19. After device f Configured device Dial out C No f PSTN modem cr Renate matitenance maden NMS address fi Telm 282499 Relative C Absolute C IP address S E itport 3 5 E amp esion to MAC a ce Non configured device Subnet mask T AS address ao Security Security Specify the password for connecting to this device You might specify a password to connect to the device Thig field may be left open IF not the network password will be used if any Password Password a 4 Back Cancel lt Back Cancel 70 User manual TMA Opening a TMA session examples 5 5 Some remarks on dial out connections This section gives some remarks on dial out connections More particular on the speed of the connection negotiated by the two PSTN modems Also the data format is important Also connection messages such as ring and echo off must be turned off The following table gives an overview of this section ew e 5 9 1 Adding AT commands to the Tel nr field Speed data format and connection messages User manual 71 Opening a TMA session examples TMA 5 5 1 Adding AT commands to the Tel nr field Consider the example in Section 5 4 Example 4 a dial out connection In the Tel nr field of the Connect Device window you can add supplementary AT commands Example As default pulse dialling is used to dial out This because the parameter DialPrefix in the TMA ini file has the following val
20. Connect Select device window For more information refer to Section 4 3 3 The Connect Select device window selections Press this button to reconnect to the current device or application Press this button to send the configuration attributes to the device lf you made changes in the configuration of the device press the Send all attributes to device button It sends the new configuration to the device and this configuration is then activated Press this button to retrieve all the attributes from the device Provided that the upload functionality is activated the read only attributes status performance and alarms are automatically retrieved from the device This is not so for the configuration attributes Pressing the Retrieve all attributes from device button however retrieves all attributes from the device Press this button to export data to a file Pressing this button brings up the Export configuration parameters window For more information refer to Section 6 2 4 The Tools menu Press this button to import data from a file Pressing this button brings up the mport configuration window For more information refer to Section 6 2 4 The Tools menu Continued on next page User manual TMA The toolbar continued Switch to basic advanced view Sub system picture Cancel all pending requests User manual The TMA window Toggling this button displays or hides the advanced confi
21. Connecting to a device TMA 3 1 What are IP proxied IP and non IP devices Because in this and the following chapters the terms P device proxied IP device and non P device are often used they are explained in this section The following table gives a definition of each term together with an example IP device An IP device is a Telindus access device e in which you can configure an IP address e that has a dedicated LAN port through which you can connect the device to a LAN Example The Crocus Inverse Multiplexer is an IP device You can configure an IP address in the Crocus Inverse Multiplexer using the crocusInvMux lanInterface ipAddress attribute The Crocus Inverse Multiplexer can be connected to a LAN through its TPI port located at the back of the device Other IP devices are for instance Orchid 1003 LAN Crocus Router Interface Crocus Router 2M Telindus 1421 SHDSL Router non IP device A non IP device is a Telindus access device e in which you can not configure an IP address e has no dedicated LAN port and therefore can not be connected directly to a LAN Example The Crocus SDSL F baseband modem is a non IP device You can not configure an IP address in the Crocus SDSL F and you can not connect it to a LAN through a dedicated LAN port Other non IP devices are for instance Aster 4 F Crocus HDSL F Crocus SDSL F Crocus FO10M proxied IP device A proxied IP device is actually a non IP device This means it is
22. Donottype SEND action Activate Configuration buttype SEND action Activate Configuration Reference manual 171 The interactive sub system picture TMA 9 9 2 The clear command Syntax CLEAR Description This command clears the action output window Example Suppose that for a certain modem you want to display the modem status wait for 5 seconds clear the window and display the line status This action would look as follows ACTIONS showModemLineStatus SEND selgrp Status SEND Select SEND select modem SHOW get WAIT 5 CLEAR SEND select line SHOW get 172 Reference manual TMA The interactive sub system picture 9 9 3 The execute command Syntax EXEC lt application path gt lt application argument gt Description This command starts an external application The command has to be followed by a quoted string containing e the path to the application optional e the application executable name e an application argument optional If no path is specified then TMA looks for the application in the directory TMA bin typically C Program Files TMA bin unless the path to the application is known by the operating system On Windows 95 and 98 this is typically done with the set path command in the autoexec bat file On Windows NT 4 0 and 2000 this is typically done with the path string in the Environment tab of the System Properties window Ex
23. ESIN modem E Hemot maintenance modem NMS address f S Relative Mel C Absolute F address 10 0 11 5 Exitport port 5 T Assign to MAC ee Non configured device Subnetmask MEET HS address O Security Security Specify the password for connecting to this device You might specify a password to connect to the device Thig field may be left open IF not the network password will be used if any Password a Password ee 00 4 Hack Cancel lt Back Cancel 68 User manual TMA Opening a TMA session examples 5 3 Example 3 a proxied IP connection Suppose you have a set up as described in the figure below port 5 TPI port a Orchid 1003 LAN PC running ENI control port modem proxied IP address 10 0 11 15 password access2 Suppose you want to open a TMA session on the modem In this example the Orchid 1003 LAN acts as an IP proxy device for the modem l e the modem is configured in the object table of the Orchid 1003 LAN IP address exit port etc For more information refer to Section 3 4 Proxied IP connection to a non IP device The Connect Device and Connect Select device windows look as follows Connect Device window Connect Select device window Connecting to a non IP device over a proxied IP connection does not bring up the Connect Address Select device window This because such a Please specify how to
24. Non configured device He address Security You might specify a password to connect to the device IF not the network password will be used if ary Password lt Back Cancel This selection is only visible when connecting to a modem Card Version with more than one modem on it 2 This selection is only visible when connecting to a management concentrator that supports this feature Select device selection 1 Select device selection 2 Select device selection 3 Select device selection 4 Select device selection 5 Select device selection 6 Select device selection 7 Select device selection 8 User manual 49 Opening a TMA session TMA Select device selection 1 On device f On device Using the Connect Device window you connected to a Telindus device through which you want to access your network If you now want to open a TMA session on the device itself then select On device Select device selection 2 On device ModemX On device modem If you are connecting to a modem Card Version with more than one modem on the card e g Crocus HDSL CV Twin Crocus FO10M CV Twin a drop down box appears after the On device selection Use this drop down box to specify on which modem you want to open the TMA session 50 User manual TMA Opening a TMA session Select device selection 3 After device After device Using the Connect Device
25. Opening a TMA session examples ccceceeeeeeeeeeeeneeeeeeneeneeeeseneeeeseneeneeeesonees 66 5 1 Example 1 a direct connection ccc cccccecceeceeeeeeceeceeeceeeaeeseeceeceeeceeseeesenseseeeeeeeaes 67 92 Example 2 all IP CONNEC UO MNs E A S 68 99 Example s a Droxied IP COMECON nerna inaanet aie 69 5 4 Example 4 a dial out connection nnnonnanennenonnnnonrnnonnsrnnrsnrnrrnrnrrnrnrrnrsrrnrnernrnnrnrrnre 70 5 5 Some remarks On dial OUt CONNECTIONS ccccecceecceece cece cece eeceeceecaueeeeeeeeeeeteeneeenes 71 6 The TMA WWI OW oaessisecis esti sccetateacenatewatauaaeeecawatenedawaceneaenatawetenwbawacenstanabensieatauaeesecs 74 6 1 The TMA window StrUCTUIe ccc ccc secs eccceeceeceeeeeeeeecseeceeteeesgeceecseeseeeseeceeseeeseeseeeeenaes 15 cayman 1 Tl geet eer a Re SI Ce 76 659 TACITO erea a E ace 102 6 4 The containment tree WiNdOW ccccccececceeeceeceecseeceeeceeceececseeseeesseceeeeeeseeseeeeenaess 104 60 TNeaAbLUE WING OW sinian aR TN 105 66 Theaction WNGOW cera ecatedadedaeennateb etek ain ie Pea eas 112 6 7 Thestructured Valle WINGOW is ciesxindacsecsiceiecsilacs iecesaeeaucans oxy oedia ee dante fed Beri ienstuctaceonaneutee 114 OO WINS SIAlS Oa ursencciaiee tapi a a 122 Continued on next page Vil Preface TMA Table of contents continued Rercrence Manual sisirin a aaa E 124 7 User instantiatable objects ccccccceeeceeceeeseeeceeeeesen
26. Router Interface is inserted in a Crocus baseband modem the Router Interface can be reached on relative address 0 and the modem itself on relative address 1 for more information on the relative addressing method refer to Section 4 3 3 The Connect Select device window selections Select device selection 5 NMS address Connecting TMA Crocus HS An exception to this rule is the Crocus HS baseband modem In that case you can only connect to the Crocus HS through one of the exit ports of a management concentrator refer to Section 4 3 3 The Connect Select device window selections Select device selection 6 Exitport What is more when a Crocus Router Interface is inserted in a Crocus HS modem only the modem can be accessed with TMA This would imply that a non configured Router Interface i e a Router Interface that has not been assigned an IP address yet is not accessible by TMA when it is present in a Crocus HS modem This would also mean that you are unable to configure the Router Interface Hence you would be unable to assign an IP address to it That is why the Assign to MAC option is present in TMA temporarily assign an IP address to the Crocus Router Interface to enable you to configure the interface Continued on next page 42 User manual TMA Opening a TMA session Device selection 5 Assign to MAC continued How does the Assign to MAC option work Suppose you have a Crocus HS equi
27. SevrerelyErroredSecond alarm applies on line 1 only line falarmLe vel LinkDown Priority low 0 Priority medium 5 Priority high 10 fmodem line 1 falarmLe vel SeverelyErroredSecond low 0 medium 5 high 10 Reference manual 133 User defining values using the custom txt file TMA 8 4 The sections of the custom txt file What is a section The custom txt file is divided into a number of sections Each section consists of a section header followed by a number of definitions lt SeCElCn gt lt Seclion headers lt defintition gt j Section header syntax The syntax for the section header is lt section header gt IDENTIFIER Section types There are two types of sections common This is a common section Hence the name of this section is common All definitions in this section apply if possible to all devices specific This is a device specific section The name of this section is the name of the top object in the containment tree of the device All definitions in this section apply to one specific device only The top object name can also be found in the ERFT EHTE ofk second column of the model nms file E g for a Edit Crocus HDSL TT this is crocusHDSLTT for a sdsl hdsl 134 Crocus DXC this is crocusDxc etc crocusH Chs crocusHDSLChs aster 4cths crocuskouter crocusInulMux crocusInvbHux crocusFOMITATT crocusFOMI6cy crocussDS LQuad unknownDevice
28. TMA 9 9 6 The print command Syntax PRINT lt text gt Description This command writes text to the action output window If the print command is followed by e only two quotes then only an empty line is written to the output window e atext between quotes then this text is written to the output window This text may be a multi line text lf you want to start a new line use n as line separator e the FROMFILE command followed by a quoted string specifying the file then the text that is contained in the file is written to the output window Example This writes one line to the output window PRINT This is an output text The result is e This is an output text This writes several lines to the output window use n as line separator PRINT This is an output text nThis is a new line nThis is another new line The result is e This is an output text b This is a new line This is another new line This writes the contents of the file fext txt to the output window a new line in the file is also a new line in the output window PRINT FROMFILE text txt The contents of the file text txt is This 1S an output text froma file This is a new lane in the file This is another new line The result is This is an output text From a File This is a new line in the File b This is another new line 176 Reference manual TMA The interactive sub system picture 9 9 7 The send command
29. TMA This chapter explains how to install TMA First it gives you the system requirements Read these requirements carefully to make sure your computer will be able to run TMA Then it explains the difference between the TMA application and the TMA model files After that the installation procedure is given starting from three different media floppy disks CD ROM and the Telindus web site The following table gives an overview of this chapter secon e Oe Location of the TMA files ae ramennen 4 User manual TMA Installing TMA 2 1 System requirements This section states the minimum system requirements to allow a successful installation of TMA These requirements are System component Minimum requirement operating system Microsoft Windows 95 Microsoft Windows 98 Microsoft Windows NT 4 0 Microsoft Windows 2000 Microsoft Windows XP data input device Depending on how TMA is delivered to you e 37 floppy drive CD ROM drive internet access free disk space 4 MB without model files 30 MB with model files total amount of RAM 16 MB for Windows 95 98 32 MB for Windows NT 4 0 64 MB for Windows 2000 communication port serial COM port 9600 8 N and or e Ethernet card networking TCP IP networking installed and configured G Because the model files delivered with TMA evolve as the devices evolve their size tends to increase with each new release The figure specified in the table above is the
30. TMA comms handler is started as well Reference manual 203 Telindus Memory Loader TML TMA 11 2 Starting TML from the command line The following table lists and explains the different TML command line options Command Description option Displays the TML command line help refer to Section 11 1 Displaying the TML command line help ct 3 Specifies the initial download speed This is the speed the download begins with Possible values are 24 48 96 192 384 576 and 1152 which is respectively 2400 4800 9600 19200 38400 57600 and 115200 bps If you do not specify the initial download speed 9600 bps is taken by default Specifies the maximum download speed The download begins at the initial speed but during handshaking the maximum download speed is negotiated In case you experience a lot of retransmissions try lowering the maximum download speed Possible values are 24 48 96 192 384 576 and 1152 which is respectively 2400 4800 9600 19200 38400 57600 and 115200 bps If you do not specify the initial download speed 115200 bps is taken by default Specifies the COM port through which your computer is connected to the Telindus device Possible values are 1 2 3 and 4 which is respectively COM1 COM2 COM3 and COM4 If you do not specify the COM port COM1 is taken by default User address and extra address These options are reserved for test purposes Specifies the absolute address of
31. The BUTTONS section syntax A customised button interactivity specification has the following syntax BUTTONS lt buttom name gt ACTION lt action name gt HELP lt help text gt where e BUTTONS Is the customised button section header e lt button name gt Is the text that has to appear on the customised button e ACTION assigns a certain action to the customised button e lt action_ name gt is the name of an action that is defined in the ACTIONS section refer to Section 9 7 The ACTIONS section of the usr file It is this action that is assigned to the corresponding customised button The action name may not contain spaces and may not be quoted e HELP assigns a tooltip to the customised button The tooltip pops up when you move the arrow over the customised button e lt help text gt is the text of the tooltip You can also refer to a file For more information refer to Section 9 10 The help text Make sure the necessary curled brackets commas quotes and semicolons are present else the syntax is incorrect Continued on next page Reference manual 165 The interactive sub system picture TMA The BUTTONS section of the usr file continued Example The following example creates a customised button Show ID and assigns the action showID to it Also a tooltip is assigned to this customised button BUTTONS Show ID ACTION showID HELP Click to display the system
32. The Exitport parameter contains different elements for a management concentrator than for other Telindus devices For a management concentrator the Configured device Non configured device selections only appear in case the management concentrator supports this feature User manual 51 Opening a TMA session TMA Select device selection 4 Configured device io Configured device Make this selection if you want to open a TMA session on a device that is connected to a management concentrator and that is configured in the object table of the management concentrator For more information on the object table refer to Section 3 4 Proxied IP connection to a non IP device and the user manual of the management concentrator Now specify the NMS address of the device you want to access with TMA and the exit port of the management concentrator the device is connected to Refer to Select device selection 5 NMS address and Select device selection 6 Exitporrt 52 User manual TMA Opening a TMA session Select device selection 5 NMS address NMS address 2 i Relative C Absolute If you want to open a TMA session on a device you have to specify the address of the device You can apply three types of addressing methods relative This type of addressing is meant for a network topology where the modems are connected in line on management level E g with extended management links between two modems An extended manageme
33. To Default This command sets the value of the currently selected attribute to its default value Optional This command clears an optional value l e it clears a value which was entered by the user but for which it was not mandatory to enter a value The string lt Opt gt re appears InSddress deviceType addressT ype ee Modis F2 Set To Default Continued on next page 82 User manual TMA The TMA window The attribute Edit menu continued Set To Type This command allows you to select a value type in case of a choice value For more information on choice values refer to Section 6 5 The attribute window Paragraph c Attribute value Select All This command selects all the attributes in the attribute window The shortcut key for this command is CTRL A If you execute the Select All command and then the Set To Default command all the attributes in the attribute window are selected and their values are reset to their default value G When selecting an attribute which is present in a structure or table one extra command is listed Set To This Choice Type Also this command allows you to select a value type in case of a choice value For more information on choice values refer to Section 6 5 The attribute window Paragraph c Attribute value User manual 83 The TMA window TMA c The text Edit menu Display this menu by selecting an attribute in the attribute window performing the Modify command and pressing
34. activate the configuration Do this by pressing the Send all attributes to device button gj 98 User manual TMA The TMA window c The Options window selection This section shows the two Options windows All the different selection possibilities are numbered They are explained in the following paragraphs The Options Display window is depicted below TMA Options Options selection 1 The Options Auto Upload window is depicted below Options selection 2 Options selection 3 User manual 99 The TMA window TMA Options selection 1 Use automatic column resizing in list controls Tick this box if you want that the columns in the TMA window are automatically resized to fit the displayed strings Options selection 2 Period Period i 10 sec Here you can specify the upload period for the status performance and alarm attributes E g a period of 1x10 sec means that every 10 seconds TMA will retrieve the values of the status performance and alarm attributes from the device Options selection 3 Auto upload readonly attributes M Auto upload readonly attributes If this box is ticked the status performance and alarm attributes are automatically retrieved from the device with an interval as specified in Options selection 2 Period If this box is not ticked the status performance and alarm attributes are not automatically retrieved from the device G Only the read only attributes status
35. alarmman crocussDSsLit crocussDSLey cCrocusHDSLit crocusHDSLey ocms orcms hscms hdsilcms acms router inumuxz invmux2 Fomtt Fomcy Sdslquad unknown alrnmo sds1tt sdslcy hdsltt hdsicy dxc a4cms Pomux router J H Z Reference manual TMA User defining values using the custom txt file 8 5 The definitions of the custom txt file What is a definition One section can contain one or several definitions With these definitions you create the user defined values Definition syntax A definition has the following global syntax lt del inition lt attribute speciticalion gt T lt value Jist gt y with lt attribute specification gt lt path gt lt attribute name gt lt element name gt Definition description A definition can span multiple lines The end of the definition is marked with a character The other elements of the definition are listed below i rr re lt path gt Refer to Section 8 5 1 The path page 136 lt attribute_name gt Refer to Section 8 5 2 The attribute and element name page 139 lt element name gt Refer to Section 8 5 3 The value list page 140 Reference manual 135 User defining values using the custom txt file TMA 8 5 1 The path What is a path A path specifies the way to reach a certain attribute or element through the containment tree of a device Path syntax A path has the following syntax lt absolure path
36. as follows a In the containment tree window select the amame modem object E crocusSDSLTT gt EM In the attribute window select the crocusSDSLTT mader Performance tab Configuration Status 2 Performance ch Alarme fitaa he Hold the CTRL key down and select the crocusSDSLTT modem h2Modem and h24Modem attributes in the af Configuration Status 2 Performance cpl Alarme attribute window errorlournt hT imeSinceLastl pdate ae 00h Om 20s h z ha oO d em Ahe4TimeSinceLastUpdate 00000d 01h Sem 20s h2dhodem Release the CTRL key oe In the Tools menu select Export E ee Cee Save in a Tma In the Export configuration parameters window the Selected attributes selection is Fiename Modem info a a a ave as ESV flees 0 ance automatically ticked Enter a file name a OOO B Tor i J Append destination and press on the Save button i G Fulliconfiquration Selected attributes All attributes of modem Jo Recurse submodules 94 User manual TMA The TMA window Export selection 7 All attributes of lt object gt f All attributes of line You don t necessarily have to export the complete configuration of a device You are able to export the configuration attribute settings of one object only Example Suppose you only want to export the configuration attributes of the line object of a Crocus SDSL modem Proceed as follows In the containment tree win
37. bracket of the showUpTime action The parser thinks that the string showStatus and the following bracket are still part of the showUpTime action Obviously it does not recognise these as valid commands Note that the parser did not detect the error of the undefined startET action yet This because there were more fundamental syntax errors and therefore it was unable to even start processing the usr file You will first have to correct the syntax errors as described above and then evoke the sub system picture again The remaining errors will then be detected in the second run To detect all errors in a usr file it is possible that you might have to go through several loops of correcting the usr file and evoking the sub system picture to see whether all errors have been solved This because some errors cause that only part of the usr file can be parsed Now correct the errors as detected above the missing help the missing and missing Then evoke the sub system picture again Again an error message is displayed and the following is added to the picture log file ERROR action StartET used but not defined in component crocusSDSLTT Now the parser noticed the undefined startET action and gives an error If you also solve this error the sub system picture will display as expected Reference manual 195 Downloading software TMA 10 Downloading software This section explains how to download softwa
38. e g a different value the interactive function as defined in the customised usr file is used Save the usr file and start the sub system picture If the sub system picture starts and no error message is displayed then the usr file is correct the following error message is displayed Warming Error in the user file Only the non mteracthiwe parts of the picture will be available Please check the logfile for more information then an error is present in the usr file Read the picture log file to find out more about the nature of the error For more information refer to Section 9 12 Reading the picture log file Reference manual 153 The interactive sub system picture TMA 9 4 The sections of the usr file For an introduction on the usr file refer to Section 9 1 What is an interactive sub system picture There are four main sections that make up the usr file Le rr This section resembles the FRONT section in the definition file def file of the sub system picture While the FRONT section of the def file defines which LEDs buttons and alarm ports are present on the front of the device in the sub system picture the usr file defines which of these have an interactive function This means that every LED button or alarm port that you want to give an interactive function has to be repeated in the usr file followed by an action and or a help text Not all devices have test buttons on the front pa
39. errors Solution Read the custom og file to determine the nature of the error Then fix the error in the custom txt file and start TMA again For more information on the custom txt file and the custom l og file refer to Chapter 8 User defining values using the custom txt file 234 Reference manual Annexes Annexes 235 TMA 236 Annexes TMA Annex A abbreviations Annex A abbreviations The following table gives a list of abbreviations and their description BitMaP bps bits per second CN4 Card Nest 4 ConTRoL Card Version CV A Card Version modem A lt CV B Card Version modem B DCE Data Communications Equipment DTE Data Terminal Equipment gt interface Internet Protocol LA Local Area Network MIB Management Information Base MMI Man Machine Interface NMS Network Management System AJ Receive SNMP Simple Network Management Protocol TFTP Trivial File Transfer Protocol lt x gt Telindus Maintenance Application lt Telindus Memory Loader X lt Table Top Transmit Z Wide Area Network N Annexes 23 Annex B TMA error messages TMA Annex B TMA error messages The following paragraphs give an overview of the error messages you may encounter in TMA They also try to give a general solution TMA start errors The following table lists the error messages you may encounter when starting TMA Error message Coul
40. gt lt object name index gt lt relative path gt lt object name gt with lt object name _index gt IDENTIFIER NUM IDENTIFIER lt object name gt IDENTIFIER Path types There are two types of paths 22 rr a absolute An absolute path starts with a character and specifies the full path to an object and so to an attribute or element This means the definition applies to one specific object of the containment tree Example modem line 1 alarmLevel LinkDown In this example the definition only applies to the LinkDown element of the alarmLevel attribute in the object line 1 The definition does not apply to the LinkDown element in the object line 2 or line 3 relative A relative path starts with the name of an object followed by a character and followed by another object or an attribute or element This means the definition applies to every object in the containment tree with this name and containing the attribute or element Example line alarmLevel LinkDown In this example the definition applies to the LinkDown element of the alarmLevel attribute in all line objects l e the objects line 1 line 2 and line 3 Continued on next page 136 Reference manual TMA User defining values using the custom txt file The path continued Indexed objects As you can see in the examples above some objects in the containment tree are indexed e g the objects line 1
41. identification This results in the following 10 0 11 111 o i ari Zoomin lt oor ut Options Show ID 3 Ea TEL NDUS crocus sDsL Click to display the system identification O lam E T cue so RHD ET aL RDL DL TELCCCHEHECLHA l pio l fies P AutoSerall End Loop Help ABE 2 b syshame Crocus SDSL TT b sys Contact Administrator Tel 2143 b svsLocation Main building Room 21 b sysDesc Crocus SDSL TT V35 Nx 64 T2122 01500 E systemUpTime Od 04h 46m 235 P devicelD b bookversion T2121 00800 E flashiYersion b Flash Version T2122 01500 b activeFlash Flash z Close 166 Reference manual TMA The interactive sub system picture 9 7 The ACTIONS section of the usr file For an introduction on the ACTIONS section of the usr file refer to Section 9 4 The sections of the usr file The ACTIONS section syntax An action definition has the following syntax ACTIONS lt action name gt HELP lt help text gt lt action command gt lt action command gt where e ACTIONS Is the action section header e lt action_ name gt is the name of the action This name is used in the other sections to assign an action to a LED button or alarm port The action name may not contain spaces and may not be quoted e HELP defines that a help text is available in the action output window If you click the help button in the acti
42. line 2 and line 3 of a 3 pair Crocus HDSL As mentioned before the following applies to indexed objects to one of the indexed objects specifically also specify the index number in the path E g modem line 1 alarmLevel LinkDown to all indexed objects just omit the index number in the path E g modem line alarmLevel LinkDown e Omitting the index number of indexed objects is possible for both absolute and relative paths e Including the index number of indexed objects is only possible for absolute paths In other words relative paths with indexed objects are not allowed Example modem line 1 alarmLevel LinkDown gt ALLOWED line 1 alarmLevel LinkDown gt NOT ALLOWED Continued on next page Reference manual 137 User defining values using the custom txt file TMA The path continued Path priority rules You may have written more than one definition with paths that all refer to the same attribute or element of an attribute Moreover these definitions may appear in the common section and in a device specific section For example modem line 1 alarmLevel LinkDown modem line alarmLevel LinkDown and line alarmLevel LinkDown all apply to the LinkDown element of the alarmLevel attribute Therefore priorities are assigned to the different paths These are based on three criteria Path type The path type priorities are as follows a highest Absolute path indexed m Example modem line 1 alar
43. menu by selecting an attribute in the attribute window and pressing the right mouse button crocusS DSLT T modern line Configuration Status Performance chl Alarme 1152000 bps Retrieve i alarmMask o00000 i er Reeve Henrie P alarmLevel lt Struct gt P alarmContactHighMask OO0000 Modify F2 P alarmContactLowMask OD0000 Set To Default Hptional Seb ior poe F Select All Ctrl The following table lists and describes the underlying commands Retrieve This command retrieves the value of the currently selected attribute from the device The shortcut key for this command is F5 Retrieve Recursive Whereas the Retrieve command retrieves the value of the currently selected attribute on the first level the Retrieve Recursive command retrieves the value of the currently selected attribute and all its possible sub values This means that in case a table is selected in which structures and other tables i e nested tables appear the Retrieve Recursive command retrieves all the values present in these structures and tables TMA does not do this by default as some tables can be very complex and might take a very long time to retrieve Modify This command allows you to modify the value of the currently selected attribute The shortcut key for this command is F2 Depending on the attribute a drop down box appears in which you can select a value or a field appears in which you can enter characters Set
44. modem e you want to see the download progress In this case the TML syntax is tml v c2 b T72136007 00 CONTROL Downloading to a device specifying its IP address Suppose e you want to download new firmware to a Telindus device specifying its IP address mn SS e your computer its LAN connector is connected to the PC running LAN TMA e your Telindus device its LAN connector is connected to the LAN e you want to download the firmware to flash bank 1 e you want to see the download progress In this case the TML syntax is tmil y 11040 11 100 fTI234001 000CONTROLI Telindus device 10 0 11 100 Continued on next page Reference manual 207 Telindus Memory Loader TML TMA Starting TML from the command line examples continued Downloading a file to the Orchid 1003 LAN specifying its IP address Suppose C you want to download a file to the Orchid 1003 LAN specifying its IP address your computer its LAN connector is connected to Orchid 1003 LAN PC running the LAN TMA 10 0 11 123 your Orchid its LAN connector is connected to the LAN you want to download the models nms file to the file system of the Orchid 1003 LAN you want to see the download progress In this case the TML syntax is tml 7v 110 0 11 123 fmodels nms models nms 208 Reference manual TMA The Cms2Serv ini file 12 The Cms2Serv ini file The Cms2Serv ini file contains the comm
45. object Cause e Not answer object You tried to connect to a device through the management concentrator but the device is not configured in the object table or the Orchid can not reach the device Solution Define the device in the Orchid its object table Check the connection between the Orchid and the device Also refer to Section 13 2 7 You get an Unknown object error message and Section 13 2 8 You get a Not answer object error message e No response Cause You tried to connect to a device but you get no response Solution Check the connection between your computer and the device Also refer to Section 13 1 Failing network connection and Section 13 2 Failing device selection e Wrong password Cause This message indicates that a password is configured in the device but that you entered the wrong password when connecting to the device Solution Enter the correct password For more information on what to do when you forgot the password refer to the manual of the device itself Also refer to Section 13 1 5 You get a Wrong password message and Section 13 2 2 You get a Wrong password message Annexes 247 Annex B TMA error messages TMA Internal communication errors The following table lists some internal communication error messages Error message Cause Solution Client not available Cause Internal communication problem Internal communication timeout Server not available Unknown
46. the Cms2Serv ini file Reference manual 221 Troubleshooting TMA 13 2 2 You get a Wrong password message You try to select a device on the network but you get the following error message A password is configured in the device you are trying to select You get this message because you entered no password or an invalid password 222 Reference manual TMA Troubleshooting 13 2 3 You get a No valid model file found error message You try to select a device on the network but you get the following error message Error x Mo valid modelfile found for tome This means that the model file which corresponds with the device you try to select is not present on your computer Example In case you want to select a Crocus SDSL Table Top modem the sdsitt mod file has to be present in the C Program Files TMA model directory on your computer The models nms file situated in the same directory should contain a reference to this model file Solution Go to the Telindus web site at http www telindusproducts com tma download the latest version of the TMA model files and re install them Reference manual 223 Troubleshooting TMA 13 2 4 You get an Unknown revision of device error message You try to select a device on the network but you get the following error message Error x Unknown revision of device This means that the revision of the firmware which is stored in the active flash bank of the device you try
47. the Crocus SDSL Twin modem B which is Crocus SDSL TT 2 In that case select in the Exitport drop down box Exitport gt line B The following figure clarifies this Crocus SDSL TT 1 Crocus SDSL TT 2 TMA Crocus SDSL Twin Continued on next page User manual 55 Opening a TMA session TMA Select device selection 6 Exitport continued If you want to address a device connected to one of the asynchronous ports of a management concentrator you have to specify to which asynchronous port it is connected Example The Orchid 1003 LAN TT has 14 asynchronous ports located at the back You can connect the control port of a Telindus device to one of these ports Table Top Orchid For more information on connections to a management concentrator refer to the user manual of the management concentrator Continued on next page 56 User manual TMA Opening a TMA session Select device selection 6 Exitport continued hardware address lf you want to address a Card Version device which is located in a CN4 card HWA nest you have to specify the hardware address This address consists of three fields separated with a dot ae 1 rack address The rack address can be set by means of DIP switches located at the back of the card nest The address range goes from 0 to 6 Check the rack address of the card nest containing the Card Version modem you want to address Enter it in the first field For exam
48. the Telindus device to which the software has to be downloaded This address has to be entered in hexadecimal format and has to be 2 bytes long Example Suppose you want to download software to a Telindus device with absolute address 111 The hexadecimal value of 111 is 6F Because the absolute address has to be 2 bytes long you also have to add 2 zeroes Specify the option a006F Specifies the relative address of the Telindus device to which the software has to be downloaded This address has to be entered in hexadecimal format and has to be 2 bytes long Specifies the IP address of the Telindus device to which the software has to be downloaded Continued on next page N 04 Reference manual MA Telindus Memory Loader TML Starting TML from the command line continued Command Description option This option applies on the Aster 4 modem only It specifies the password as configured in the Aster 4 modem Specifies the filename and destination of the file to download The syntax is as follows lt filename gt lt destination gt lt password gt where f is the filename option lt filename gt Is the name of the file to download e is the filename destination separator lt destination gt Is the destination of the file Possible destinations are lt filename gt in case you want to download a file to the file system of a Telindus device CONTROL In case you want to do
49. the coloured symbols in front of an attribute mean The coloured symbols in front of an attribute reflect the status of the attribute The following table clarifies The attribute is a configuration attribute and can be modified l e you have write access to the device The value of the configuration attribute has been changed but has not yet been sent to the device To send and activate the new configuration press the Send all attributes to device jn EJ this The attribute is read only This means the attribute is e a status performance or alarm attribute e a configuration attribute but you have no write access to the device only read access The attribute is being retrieved from or send to the device 110 User manual TMA The TMA window e Attribute group What is an attribute group An attribute group assembles a set of attributes related by functionality There are four attribute groups in TMA which correspond with the four tabs in the attribute window e ee configuration In this group all the configuration attributes of the device can be found Use these to configure the device to accommodate your needs ay Configuration o l l l S E g retrain in the modem object speed in the line object clocking in the lt interface gt object etc status This group displays the status of the device i e its current situation Should a problem occur you can immediately check several status attributes to
50. the command line ExaMples cccccccseccceeeeeeeeseeeeaeeeeeeeaeees 206 12 the CMS ZS SPV MAE NG arein a 209 120 Pants Ofthe CMSZSCFVINI MEss nna uncles Godin e ean bere oere wi etshcecsludaees 210 12 2 Adding parts to the Cms2Serv ini FIC cece ccc ceccccececeeeceeeeceeeceueeseeeeueeseeeseueesaeeseeeegs 212 Continued on next page viii TMA Preface Table of contents continued TS Troubleshooting sidencccnccewseccsdenidinidanedanedamevenstonidenndanidensconeveravends dawavadudasedadedaredicedeas 213 132 Failing MEWWOFK COMMCCUON icc cccc cent etscersce ee cess erst sce veset ES 214 13 2 Failing device SelectioN sssri a a EE O 220 13 3 Falling Sotware COW NI OAC aeien oari e A R 229 134 OMEMDOSSIDIS DODIES masaren a E 230 ANNEI OS aeann a vanesans peste penesienes ae cn aoeeaceteieeates 235 PATATIOX PAS AI DIO VIAUIOINS saciceiese eee eset a a eaedaeen 237 Annex B TMA error messages ssnnsnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnna 238 TMAS SIONS serari aan A A A ecluen abides 238 TMA GLrcommand Ine Nors inire a a 239 PASS OS aa a a une senne enemies 240 SONIMECE CONS tae ries ahent cas tuner neni tacaatadasbeinanee a desma 241 EAILENO S erene i nane EAE EEEE EAE E EEEN 242 EXPO OMO S oana N E E A a A 243 IMPOTENT OT aa N OEE T E eee ey eee ee 244 DOW MIOAC ENO S aaen aeran E a Re 245 SU D syStem PICIU ErrOlS messene ea E E T E E E EE 246 NACK Messages norin ee iee aa e a a a a a 247
51. the custom txt file TMA 8 5 3 The value list What is a value list Using the value list you actually define the values for the corresponding attribute or element as you want to see them Value list syntax A value list has the following syntax Value list lt string value Jist gt lt integer value ligt y with lt string value list gt lt string value gt lt string value gt where lt StEing value gt IDENTIFIER STRING with lt integer value list gt lt integer value gt lt integer value gt where lt integer value gt IDENTIFIER STRING 7c NUM String and integer values As mentioned before you can only user define values for attribute values that are string or integer values For those two value types the following applies string There are two ways to encode a string e S e STRING The value starts with a double quote character The end of the string is the next double quote character Within these two delimiters any character is allowed even the character i e it will not be considered as comment The closing double quote should appear before the end of the line Else the string is interpreted incorrectly Example sysContact ISP Tel 784512 IDENTIFIER The value does not start with a double quote The end of the string is the first space tab or end of line character that is encountered Note that using this encoding you can not use charac
52. the management concentrator able to poll the non IP device check the status of the non IP device in the object table 218 Reference manual TMA Troubleshooting 13 1 5 You get a Wrong password message You try to connect to a device but you get the following error message A password is configured in the device you are trying to connect to You get this message because you entered no password or an invalid password Reference manual 219 Troubleshooting TMA 13 2 Failing device selection The following sections list some problems you may encounter when selecting a device The following table gives an overview of this section sen o You get a No valid model file found error message You get an Unknown revision of device error message 220 Reference manual TMA Troubleshooting 13 2 1 You have problems selecting a remote device You have established a direct connection to a local device Then you try to select a remote device on the network but the connection fails Error 3 No response Solution Check the following e ls there a physical connection between the local and the remote device l e is the line connected e ls the remote device switched on e ls there a data link between the local and the remote device l e is data transfer possible e Did you enter the correct address e Did you supply the correct device password e Try to enlarge the value of the ExtTimeOut communication parameter in
53. the right mouse button crocusSDSLiT Configuration Status gt Performance af Alarme alarmContactH ight ask OUOOOO000 alarmLontactLowM ask OOOUU0000 sushame Table Top il P susContact Unde P eysLocation Cut P security Tables P bootFromFlash Auto anes b fomvarndTMAToNMSPoart enabled Pi P fomwardTMAToLine enabled P alarmbiask 111111111 Select ll P alarmLevel lt Struct gt p p G This Edit menu does not appear for all attribute values Only for those values where characters have to be edited The following table lists and describes the underlying commands Cancels the previous action Cut Removes the current selection This selection is placed in the clipboard and therefore can be paste somewhere else Copies the current selection to the clipboard 84 User manual TMA The TMA window d The action Edit menu Display this menu by selecting an action in the action window and pressing the right mouse button action ArqumentName Argument Value p Test Actrvation test chyation ppe i t Heche b Force Full Retrain Modify Fi Set To Default The following table lists and describes the underlying commands Execute This command executes an action For some actions you first have to set an argument value before you can execute the action Modify This command allows you to modify the argument value of the currently selected action A drop down bo
54. the system asks you whether to remove the common files You may answer Yes To All Remove Shared File The system indicates that the following shared file is no longer used by any programs If any programs are shill using this file and its removed those programs may not function Are you sure you want to remove the shared file Leaving this file wall not harm your system fF you are not sure what to do it is suggested that you choose to not remove this shared component File name TMA ini Located irr C Program Files T MA contig Yes Toall No No to All Uninstalling the TMA model files In order to uninstall the TMA model files do the following e On the taskbar select Start gt Control Panel gt Add Remove Programs gt in the list of programs that appears select TMA Model Files gt click on the Add Remove button User manual 19 Installing TMA TMA 2 8 What TMA changes in the registry When you install TMA some entries are added to the Microsoft Windows registry This section lists these entries This might be interesting e for documentation purposes e should you experience troubles installing different TMA products and or versions In that case a solution might be to uninstall TMA remove all possible TMA references from the registry and reinstall TMA Browsing the registry In order to browse the registry proceed as follows a On the taskbar select Start gt Run In
55. to a non IP device 3 3 9 Basic IP device settings to enable an IP connection To establish an IP connection between the computer running TMA and the IP device a few basic parameters called attributes have to be set in the IP device These attributes are IP address This is a unique address which is assigned to the IP device By doing this other devices on the IP network can contact the IP device Examples The following examples display the IP address attribute location in the containment tree of some Telindus IP devices e Orchid 1003 LAN 01003 interfaces laninterface ipAddress e Crocus Router 2M or Router Interface crocusRouter laninterface ipAddress e Crocus Inverse Multiplexer crocusInvMux lanInterface ipAddress default gateway This is the gateway of the IP segment the IP device is connected to l e the IP address of the router which handles packets destined for another network Examples The following examples display the default gateway attribute location in the containment tree of some Telindus IP devices e Orchid 1003 LAN 01003 router defaultRoute gateway e Crocus Router 2M or Router Interface crocusRouter router defaultRoute gateway e Crocus Inverse Multiplexer crocusInvMux laninterface defaultRoute Once these attributes are set then the computer running TMA is able to reach the IP device over an IP network 28 User manual TMA Connecting to a device 3 4 Proxied IP connection to a non IP device As st
56. want to save the option settings Undo press this button if you want to revert to the previous option settings The Options tab is only present in case of a direct connection not in case of an IP connection Continued on next page Reference manual TMA Downloading firmware continued In the Download window select the Configuration tab and press the Add button The Remote filename window appears In the Remote filename window 1 Select a firmware file you want to download In the Remote file field type CONTROL to download the firmware into the non active flash bank CONTROL1 to download the firmware into flash bank 1 CONTROL2 to download the firmware into flash bank 2 3 Press the Open button Look in SD File name When the Download window reappears press the OK button A window appears and shows the download progress Reference manual Crog25 ery inl Crng2Sery inl_java Downloading software THA Download Password Configuration Options The download list box specifies the files that will be sent to the device Use the Add and Remove buttons to edit the list Remove Remote filename E Tma aa T2752011 00 Tdebug exe T TMA exe TMA ini n Uninet isu J onfiguration cms O09 i N E TmaCh exe Tmal ttp exe gt T2114009 00 Files of type All files ba Cancel Remote file CONTROL TH
57. web site at http www telindusproducts com tma download the latest version of the TMA model files and re install them 226 Reference manual TMA Troubleshooting 13 2 7 You get an Unknown object error message You try to select a device that is connected to the management concentrator l e you try to connect to the device through the management concentrator but you get the following error message Error 3 Unknown object This means that the device is not configured in the object table of the management concentrator Solution Configure the device in the object table of the management concentrator For more information refer to Section 3 4 Proxied IP connection to a non IP device Paragraph Basic Orchid settings to enable a proxied IP connection For detailed information on configuring the object table refer to the manual of the management concentrator Reference manual 227 Troubleshooting TMA 13 2 8 You get a Not answer object error message You try to select a device which is connected to the management concentrator and which is configured in the object table of the management concentrator but you get the following error message Error x Not answer object This means that the device does not respond on the polls of the management concentrator In other words the connection between the Orchid and the device is down check the status of the device in the object table Solution Check the fo
58. 150 Reference manual TMA The interactive sub system picture 9 1 What is an interactive sub system picture What is a sub system picture The sub system picture is a TMA tool which CHL iSe L of x visualises the status information of the device TELAANDUS crocus sos The front panel LED indications of the sub Baa system picture are the same as those of the wk TST ERR THO s9 ROD eT aL ADL oL device The sub system picture also displays 2S SE the status of the front panel test buttons if present the interface connection the line connection etc oo DB E E E E E 5 What is an interactive sub system picture Whereas the plain sub system picture a salt merely offers you a visual representation of Zoomin 25 Options the status of the Telindus device the identification EE interactive sub system picture offers you a aeres ae ae lee more controllable sub system picture What __RleTtest COC k is more you can customise the interactive Start an End to End test functions to suit your needs U How to customise the interactive sub system picture In order to customise the interactive functions of the interactive sub system picture you have to edit a usr file What is the usr file The usr file is a plain text file containing special syntax which defines the interactive functions you want As each device has its own sub system picture each device also has its
59. A Download Password Configuration Options ila The download list bos specifies the files that will be sent to the device Use the Add and Remove buttons to edit the list T2174003 00 CONTROL Remove 199 Downloading software 10 2 Downloading files to the file system TMA some Telindus devices not only need firmware but also other software or files have to be downloaded to their file system e g in case of the Orchid 1003 LAN Telindus 1030 Router series explains how to download files to the file system etc This section The file download procedure is very similar to the firmware download procedure Therefore the following procedure shows only the differences Execute step 1 2 3 and 4 of the firmware download procedure Refer to Section 10 1 Downloading firmware In the Remote filename window Remote filename 1 Selecta file you want to Lookin E Tma amp download The name appears in a 72114009 00 E CmeZServ ini a T2122009 00 the File name neid a Cms2Serv ini_java ka T2752011 00 In the Remote file field type the models nm P Tdebug ere remote file name HE SL_TT_configuration cme T TMA exe sddeltt mod 3 TMA ini If you leave this field blank then the name entered in the File name field is used as remote file name a TmaCh exe Trmal ftp exi A tml exe ua tral n Uninst tsu E File name sdsltt mod Files of type Al fil
60. DSL Crocus HDSL Crocus HDSL modem gt relative 0 gt relative 1 e you want to download the firmware to the flash bank 1 or 2 that is currently non active e you want to see the download progress In this case the TML syntax is tml y 2 r000 7T2114014 00 GCONTROL 206 Continued on next page Reference manual TMA Telindus Memory Loader TML Starting TML from the command line examples continued Downloading to a remote device specifying its absolute address Suppose PC running TMA e you want to download new firmware to a B remote Crocus HDSL modem specifying its SOMS absolute address 2 bytes hexadecimal Lai e your computer its COM2 is connected to the central auxiliary connector of the local Crocus HDSL Crocus HDSL modem gt absolute 111 e you want to download the firmware to the flash bank 1 or 2 that is currently non active e you want to see the download progress In this case the TML syntax is tml y c2 a0Q0DE T2114014 00 GCONTROL Downloading to a local device that only has 1 flash bank koo O remote Crocus HDSL gt absolute 222 Suppose PC running TMA e you want to download new firmware to a local Crocus SHDSL E modem Because the Crocus SHDSL only has 1 flash bank you _ pore have to force the Crocus SHDSL in loader mode using the p Vi option Crocus SHDSL e your computer its COM2 is connected to the auxiliary connector of the local Crocus SHDSL
61. DSLTT and the group Configuration then the action window displays the following actions e Activate Configuration e Load Saved Configuration e Load Default Configuration e Cold Boot If you select the object modem and the group Performance then the action window displays the following actions e Test Activation e Force Full Retrain 112 User manual TMA The TMA window b Execute action How to execute an action Actions can have an argument value or not This has an impact on how to execute the action The following table clarifies this without an In this case no argument values have to Aetion argument value _ be selected l e you can immediately bo Activate Configuration execute this action P Load Saved Configuration P Load Default Configuration P Cold Boot To execute this action either e select the action gt click the right mouse button gt select Execute or e double click the left mouse button on the action with an Before executing this action E we l Aroument Mame argument value you have to select an P Test Activation testActivation ype argument value Then you can execute the action As an attribute value an argument value can be a simple or a structured value RLET test To execute this action either e select an argument value gt select the action gt click the right mouse button gt select Execute or e select an argument value gt double click the left mouse
62. FORMATION QUALITY COMMENT FORM INFO REQUEST d OO USER AND REFERENCE MANUALS INSTALL TMA MODEL FILES FROM CD Welcome x a AAN 1 ATECT TMA EROM THE WWI Welcome to the TMA Setup program This program will install TMA on your computer It is strongly recommended that you exit all Windows programs before running this Setup program Click Cancel to quit Setup and then close any programs you have running Click Next to continue with the Setup program WARNING This program is protected by copyright law and international treaties Unauthorized reproduction or distribution of this program or any portion of it may result in severe civil and criminal penalties and will be prosecuted to the maximum extent possible under law User manual 11 Installing TMA TMA 2 4 2 Installing the model files from CD ROM To install the TMA model files from the CD ROM proceed as follows EEN Insert the CD ROM in the CD ROM drive Windows automatically displays a HTML page as shown below TeLINDUS WE v TELINDUS COM PRODUCT INFORMATION QUALITY COMMENT FORM INFO REQUEST el USER AND REFERENCE MANUALS INSTALL TMA ENGINE FROM CD INSTALL TMA MODEL FILES FROM CD DOWNLOAD LATEST TMA FROMTHE WEB CREATE FLOPPIES FOR TMA The InstallShield Wizard guides you through the set up process 12 User manual TMA Installing TMA 2 5 Installing TMA from the Telindus web site The latest version of th
63. IP Address Iterations PRINT The ping results are n click on End Loop to stop monitoring PRINT LOOP SHOW get pingResults When executing this action a dialog box appears asking you Arguments to fill in the fields IP address and Iterations These values IP Address 10 011 250 OOO are then used as argument for the startPing action The result of the ping action is monitored until the End Loop button is Metations 5 clicked Output OFX I tx Autoscroll End Loop Help b Ping action e specify IP address and number of iterations ie e The ping results are e iclick on End Loop to stop monitoring a pingResults ip ddress 10 0 11 250 nbrOFTxPackets 2 nbrarhxPackets 2 minkeply Tine Od 00h 00m 00s 003m maxReplyTime Od 00h 00m 00s 005ms avrgReplyTime Od 00h 00m 00s 004s Continued on next page Reference manual 179 The interactive sub system picture TMA The send command continued Example Suppose you want to create an action that sets the basic attributes of a Crocus SDSL TT Suppose you want to set the e sysName sysContact and sysLocation attributes to a value of your choice e channel attribute to central e the speed attribute to 2304000 bps e and the clocking attribute to external This action would look as follows ACTIONS setBasicConfig i PRINT Basic configuration of the Crocus SDSL TT n SEND action Load Defa
64. Lm StartUp To Microsoft Binder pi Uninstall TMA AE Microsoft Excel cal User manual doc THA Connect View Tools Help a Documents akaka EJ Ey aint m _ x Favontes Si Configuration Status Performance cl Alarms Name ooo Value OOO O O Action Argument Name Argument Value User manual 35 Opening a TMA session TMA 4 2 Connecting to a device After you made the necessary hardware connections you have to establish a software connection l e you have to establish a link between the computer running TMA and the Telindus device through which you want to access the network First this section explains how to display the Connect Device window Then it describes in detail the different connection possibilities The following table gives an overview of this section a e Displaying the Connect Device window The Connect Device window selections 36 User manual TMA Opening a TMA session 4 2 1 Displaying the Connect Device window To display the Connect Device window proceed as follows Start the TMA application Refer to Section 4 1 Starting TMA gt The TMA window appears In the TMA window either i e press on the Connect to a device sutton e or press the shortcut key Ctrl N e or select from the menu bar Connect gt Device The Connect Device window appears Connect Address P
65. MA Updating the TMA engine If you want to install a newer version of the TMA engine then it is not necessary to uninstall the previous version first You can just install the new version on top of the previous one Updating the TMA model files If you want to install a newer version of the TMA model files then it is not necessary to uninstall the previous version first You can just install the new version on top of the previous one i Should you try to install an older version of the TMA model files on top of a newer one then you get the following message Warning you are trying to install an older version of the TMA Model Files S0004 03200 over a more recent version 90004 03300 If you really want to do SO please uninstall the current version and then run this installer again 18 User manual TMA Installing TMA 2 2 Uninstalling TMA Uninstalling the TMA engine In order to uninstall the TMA engine do the following e On the taskbar select Start gt Programs gt TMA gt Uninstall TMA or e On the taskbar select Start gt Control Panel gt Add Remove Programs gt in the list of programs that appears select TMA gt click on the Add Remove button In case several TMA applications are installed on your computer for instance TMA and TMA CLI the common files remain on your system as long as at least one TMA application remains on your computer If also this last TMA application is uninstalled then
66. MA bin directory Export selection 2 File name File name eds _tt_configuration Enter here the name of the export file It is not necessary to enter the file extension it is added automatically 90 User manual TMA The TMA window Export selection 3 Save as type Cms file cme Save as type esv file csv Choose here the type of the export file The table below shows the different file types File Can be used to Description type export the CMS configuration You can export the configuration attributes of a Telindus device to a CMS attributes file This means that the configuration attribute settings are saved in a file Later you can import this configuration in the same or another device This is particularly interesting when a lot of devices need the same configuration TXT configuration You can export the configuration status and alarm attributes to a plain status text file This is particularly interesting for documentation purposes alarm YD In contrast with the configuration attributes the status and alarm attributes attributes can only be exported to a TXT file CLI configuration You can export the configuration attributes of a Telindus device to a CLI attributes file Analogue to the CMS file this allows you to distribute configuration files amongst several devices Some advantages of using a CLI file are e you can still edit the file using the CLI syntax e you can use
67. MEE a subnebmask ian Secutty Secuty Specify the password for connecting to this device You might specify a password to connect to the device This field ray be lett oper IF not the network password will be used if arny Password an Passiword lai 4 Back Cancel lt Back Cancel E itpart line User manual 67 Opening a TMA session examples TMA 5 2 Example 2 an IP connection Suppose you have a set up as described in the figure below an port port 5 TPI port Via Orchid 1003 LAN IP address 10 0 11 5 password 123 PC running TMA ne control port modem A modem B relative address 0 relative address 1 password access2 Suppose you want to open a TMA session on modem B In this example both modem A and B are configured in the object table of the Orchid 1003 LAN However they are not assigned an IP address l e you can not connect to the modem over a proxied IP connection You have to connect over IP to the Orchid first The Connect Device and Connect Select device windows look as follows Connect Device window Connect Select device window Address Address Please specify how to reach the device you wish to Choose whether to connect on the network device itself connect to or a device thereatter if so specify its address C Serial cont C On device if After device f Configured device ral out fo T
68. OpenView The Connect to application window is split up in two parts These are described in the following table 7 e Address In the address field enter the address of the application you want to connect to In case of the Alarm Manager for example the address is 6fbf Host Even if the application resides on another machine than the one you are running TMA on you can still connect to the application Do this by ticking the Remote host box and entering the IP address of the remote machine running the application you want to connect to 78 User manual TMA The TMA window b Creating aliases Use the Add Alias command to create an alias for the currently active connection to a device or application Selecting this command brings up the Add Alias window Add Alias Specifying a name alias for this device will allow pou to reconnect later without re entering the device Alias com relativel SDSL 2 Cancel Using an alias allows you to reconnect to the device or application without having to re enter the address parameters However for security reasons the alias does not include the passwords l e even when an alias is selected TMA will ask you to enter the network and or device password You can find the four most recently used aliases under Connect in the menu bar To display the rest of the aliases click on More or press the shortcut key Ctrl M In this window the amount of aliases is unlimited It also
69. Select device window by selecting Select device in the Connect menu For more information refer to Section 4 3 2 Displaying the Connect Select device window For more information on the selection possibilities in the Connect Select device window refer to Section 4 3 3 The Connect Select device window selections Example 2 Suppose you have the following set up G oh ay PC running a 11 15 B 10 0 11 Orchid 1003 LAN Your computer running TMA is connected over an IP network to an Orchid 1003 LAN One of the ports of the Orchid is connected to the control port of a modem This modem is configured in the object table of the Orchid It is assigned IP address 10 0 11 15 So in the Connect Device window you select P address 10 0 11 15 enter a Password if necessary and press on the Next button In this situation the Connect Select device window does not appear The TMA session is automatically opened on the modem itself This because connecting to a modem over IP does not allow you to open TMA sessions on devices behind this modem even if they are present In that case the Select device in the Connect menu is not selectable 46 User manual TMA Opening a TMA session 4 3 2 Displaying the Connect Select device window As said in the previous section the Connect Select device window only appears if the device through which you are accessin
70. Suppose you want to connect to an Orchid 1003 LAN via a dial out connection A possible setup is given in the figure below Orchid 1003 LAN COM 1 4 r u control port PC running A TMA PSTN modem 1 Ca modem 2 DTE interface DTE The following table gives an overview of the connections shown in the figure above The overview starts at the computer running TMA COM port of the computer a interface of PSTN modem a DTE DCE interface cable PSTN port of PSTN modem 1 PSTN port of PSTN modem 2 a dial out connection over the PSTN network DTE interface of PSTN modem control port of the Orchid 1003 a DTE DCE interface cable 2 LAN Ci if the computer has an internal PSTN modem verify which COM port it uses 40 User manual TMA Opening a TMA session Device selection 4 IP address IF address 10 0 11 250 Make this selection if you want to make a connection over an IP network as described in Section 3 3 IP connection to an IP device and Section 3 4 Proxied IP connection to a non IP device Enter the IP address of the Telindus device you want to connect to User manual 41 Opening a TMA session TMA Device selection 5 Assign to MAC IP address 10 0 11 250 M Assign to MAC oo CO 7 89 00 6A A4 Subnet mask 255 255 252 0 Connecting TMA normal situation Normally it is possible to make a direct connection with TMA to every Telindus device that has a control port Also when a Crocus
71. The device password field can be left blank network password 12345 device password lt blank gt PC running d d TMA modem password 12345 2 It is possible that the device through which you connect to the network has the same password as the device on which you want to open a TMA session In that case you only have to enter the network password The device password field can be left blank network password device password 12345 lt blank gt PC running modem Ee modem password 12345 12345 It is possible that the device through which you connect to the network has a different password than the device on which you want to open a TMA session In that case you both have to enter network and device password network password device password 12345 67890 abies modem a c modem password 12345 67890 When you connect to a device over IP i e by entering its IP address in the Connect Device window you only have to enter the device password This because you immediately open a TMA session on the device itself There are some exceptions The Crocus Router and Orchid 1003 LAN for instance This because with these devices you still have the possibility to connect on the device or after the device 60 User manual TMA Opening a TMA session 4 4 The TMA command line The three previous sections explained how to open a TMA session on a device using the TMA graphical user interface However it is possible to s
72. Troubleshooting TMA 13 4 Other possible problems The following sections list some more possible problems you may encounter The following table gives an overview of this section secon o 234 13 4 4 You get a custom txt file error message 230 Reference manual TMA Troubleshooting 13 4 1 You get a Server not available error message At a certain point you get the following error message Error x Server not available This indicates that the TMA application is unable to communicate with the TMA comms handler Solution e Check whether the TMA comms handler button is present on the taskbar If itis not it means that the TMA comms handler has been closed at some point as a result of which the TMA application can no longer communicate with the comms handler Close the TMA application and then restart it If itis close the TMA application Make sure the TMA comms handler also closes Restart TMA e lf the problem persists re install and restart TMA e Ultimately go to the Telindus web site at http www telindusproducts com tma download the latest TMA version and install it Reference manual 231 Troubleshooting TMA 13 4 2 You are unable to start TMA You want to start TMA but you get the following or other to the model files related error messages THA Error x Could not open C Program Files TMA smodel models nms This means that the models nms file is not present on your comp
73. Use this command to connect to an application For more information refer to Paragraph a Connecting to an application page 78 Use this command to disconnect from the current device or application Use this command to reconnect to the current device or application Add Alias Use this command to create an alias for the current connection Creating an alias allows you to reconnect to the device or application without having to re enter the address parameters The shortcut key for this command is CTRL L For more information refer to Paragraph b Creating aliases page 79 These are the four most recently used aliases Mor This command displays the rest of the aliases The shortcut key for this command is CTRL M This command closes the TMA application IA IW IN gt User manual TT The TMA window TMA a Connecting to an application Use the Application command to connect to an application e g the Alarm Manager of TMA for HP OpenView Selecting this command brings up the Connect to application window Connect to application Address Please specify the address In hes notation of the application you wish to connect to Address Ebi Host IF the application resides on a remote host specify its IP address 10 0 11 250 wae k Cancel k This feature allows you to open a TMA session on for example the Alarm Manager of TMA for HP OpenView and this on a machine that does not run HP
74. a Telindus access device e in which you can not configure an IP address However you can assign an IP address to the device using a management concentrator as proxy IP device refer to Section 3 4 Proxied IP connection to a non IP device has no dedicated LAN port and therefore can not be connected directly to a LAN This is done through a management concentrator which is an IP device and therefore can be connected to a LAN through its dedicated LAN port Example The Crocus SDSL F baseband modem is a non IP device However by connecting the Orchid 1003 LAN to the modem and by assigning an IP address to it in the Orchid 1003 LAN the modem becomes a proxied IP device The Orchid 1003 LAN on its turn is connected through its LAN port to a LAN l e it is as if the modem is connected to the LAN although not directly 22 User manual TMA Connecting to a device 3 2 Direct connection to a device This section explains how to make a direct connection between the computer running TMA and a Telindus device The following table gives an overview of this section E A What is a direct connection To which Telindus devices can you make a direct connection DB25 DB9 interconnection cable User manual 23 Connecting to a device TMA 3 2 1 What is a direct connection A direct connection is a connection between a COM port of the computer and the auxiliary port also called control port of a Telindus device Such a conne
75. ample Suppose you want to open Notepad exe in order to edit the usr file crocusSDSLTT usr This action would look as follows ACTIONS editUsrFile EXEC notepad exe C program files tma picture usr crocusSDSLTT usr Reference manual 173 The interactive sub system picture TMA 9 9 4 The from file command Syntax lt command gt FROMFILE lt file path gt Description This command can only be used in combination with another command It specifies that the command has to use the contents of the specified file as argument If no path is specified then TMA looks for the file in the directory TMA bin typically C Program Files TMA bin Example Suppose you want to execute a CLI script that has been saved in the file C Program Files TMA scripts getAlarms cli This action would look as follows ACTIONS getAlarmStatus SHOW FROMFILE C Program Files TMA scripts getAlarms cli The getAlarms cli file could contain something like the following select selgrp Alarms get select modem get select line get select select v35 get select select powerOffDetection get 174 Reference manual TMA The interactive sub system picture 9 9 5 The loop command Syntax LOOP lt command gt lt command gt Description This command allows that one or more commands are executed in a loop The commands that have to be looped have to be included between curled brackets whi
76. and code examples e g NOK 1 1 Invalid command text you have to enter at the prompt e g Get sysName objects and attributes in the containment tree of a device when they are mentioned in the normal text l e when they are not a part of computer input or output references to other parts in the manual e g refer to Chapter xx Technical specifications a hyperlink to a web site e g http www telindus com The following icons are used throughout the manual Con ee O o e O O Useful information or tips Read the text that follows carefully in order to insure correct operation Preface TMA Software version This manual describes the features of TMA version S0004 02000 Your feedback Your satisfaction about this purchase is an extremely important priority to all of us at Telindus Accordingly all electronic functional and cosmetic aspects of this new unit have been carefully and thoroughly tested and inspected If any fault is found with this unit or should you have any other quality related comment concerning this delivery please submit the Quality Comment Form on our web page at http www telindusproducts com quality yi TMA Preface Table of contents User A tl ace deetcceca ce ceneans seu smmenaccieuesecaacenwesaswursseassazescepeecctaeaauscsteet aeeaniese 1 Ve AERO CUG COIN niini a 3 2 MSANDO TMA 4 Zak System FECQUIFEIMEINS rissies a a a Ea 5 2 2 The TMA application and model files
77. aragraph b The Import configuration window selections page 97 Download This command enables you to download new firmware to the device Because this is quite an important feature it is discussed in a separate section Refer to Chapter 10 Downloading software Options This command enables you to set display and upload options Refer to Paragraph c The Options window selection page 99 88 User manual TMA The TMA window a The Export configuration parameters window selections This section shows the Export configuration parameters window All the different selection possibilities are numbered They are explained in the following paragraphs The Export configuration parameters window is depicted below Export configuration parameters EES a SO SL_ configuration cms SOSL configuration crs SOSL configurations cms SOSL_ configuration cms File name SDSL_configuration4 cms aS Export selection 2 Save az type Crs file cms eae Export selection 3 T Append Export selection 4 Full configuration Export selection 5 C Selected attributes Export selection 6 f All attributes of crocusSOSLTT Export selection 7 Recurse submodules Export selection 8 User manual 89 The TMA window TMA Export selection 1 Save in Save ini E bin 41 Desktop a My Computer a 3H Floppy A ga Telndus C Program Files Choose here the location for the export file As default the file is saved in the T
78. ated in Section 3 3 IP connection to an IP device it is not possible to make a true IP connection to a non IP device This because non IP devices do not have a dedicated LAN port through which you can connect them to a LAN However using a management concentrator you can make a proxied P connection to a non IP device This is explained in this section The following table gives an overview of this section ee What is a management concentrator Which Telindus devices are management concentrators A proxied IP connection to a non IP device example Basic management concentrator settings to enable a proxied IP connection A management concentrator as a proxy IP device User manual 29 Connecting to a device TMA 3 4 1 What is a management concentrator A management concentrator is a device that collects management information from the network units i e the Telindus devices in the network and passes it to a network management system e g HP OpenView SO a management concentrator is situated between the network units and the network management system In other words it is a key element for centralised network management 3 4 2 Which Telindus devices are management concentrators Examples of management concentrator are e the Orchid 1003 LAN the predecessor of the Telindus 1035 Orchid e the Telindus 1031 1032 1033 and 1034 Router note that their management concentrator capabilities are limited due to hardware limitati
79. ation attributes of the currently selected object e CMS or CLI file things are a bit different than for a TXT file In this case a load default configuration action is inserted at the beginning of the file Then only those attributes which have a different value than the default value are stored in the file This results in a compact file D When you want a CMS or CLI file with the complete configuration instead of only the non default configuration then proceed as follows In the containment tree window select the top object J powerD ffDetection In the attribute window select the ereus DSLT S S Configuration tab Configuration Status p Performance cfi Alarme Hame Value In the Tools menu select Export H 4 ave in confi ie The Export configuration parameters aoe a window appears Tick the All attributes of lt top object gt and Recurse submodules selection Filename Save as type Ci flete f Cancel Append Enter a file name a destination and press Full configuration Selected attributes on the Save button All altibutes of crocusSDSLTT User manual 93 The TMA window TMA Export selection 6 Selected attributes amp Selected attributes Tick this selection if you only want to export the attributes you selected in the attribute window Example Suppose you only want to export the h2Modem and h24Modem performance attributes of a Crocus SDSL modem Proceed
80. ble is sorted based on the name column Sorted ascending Sorted descending objectT able kd objectT able name a central emote name central emote l central 222 central modem central hdslSource central 123 central hdslSink remote tt central Bcy central ett central central Ary central ett central Bev central tt central hdelS ink remote 123 central hdslSource central madem central 277 central p10 le central Continued on next page 118 User manual TMA The TMA window Sort expand and collapse tools continued Expanding and collapsing structures What is the expand and collapse tool Some tables contain structures You can enter these structures by double clicking on the lt Struct gt string The structured value window then displays the structure However the expand tool allows you to expand such a structure in such a way that it becomes a part of the table The following example clarifies this double click on the displays the structure separately in the structured value window lt Struct gt string F object able row 1 exitPort Struct portNumber cardnestaddress cardPaosition modem a port 2 T T A click on the expand expands the structure in such a way that it becomes a part of the table tool gt Eni F objectT able g Struct address alue exitPort 4 exitPort 4 exitPort 4 exitPort 4 exitPort 4 exitPortT ype port umber cardnest ddress cardPasition modern m ort T
81. button on the action User manual 113 The TMA window TMA 6 7 The structured value window This section describes the structured value window It explains what a structured value is and shows how to navigate in this window The following figure shows the different components of a structured value window Configuration Status Performance af Alarme Bit string lt Struct gt lt Table gt P alarmMMask P alarmLevel Add delete row tools Filter tool Sort expand and collapse tools ne Structured value Navigation tool p Readdccess WriteAccess on Sub value p Secuntwaccess on a Structured value b 1 fullaccess p 2 access b3 readonly What is a structured value Some attribute values contain underlying values These underlying values are called a structured value These values are displayed in the structured value window Example The configuration attribute security has a structured value which contains the device passwords the performance attribute lineParameters has a structured value which contains line status information etc b Bit string lt Struct gt lt Table gt How to determine which attribute has a structured value When a bit string e g 101 or the string lt Struct gt or lt Table gt is displayed in the value field of an attribute it means that it has a structured value Selecting this string will reveal the underlying values in the structured value wind
82. cation for HP Openview on HP UX SNMP Up to 250 IP Adresses supported 3 years Maintenance contract for TMA_HP OV mandatory 162842 TMA_HP OV HP UX UNLIMITED VER Telindus Management Application for HP Openview on HP UX SNMP No limit on IP Adresses supported 3 years Maintenance contract for TMA_HP OV mandatory 156688 TMA_CLI WINDOWS NT Command Line Interface application for WINDOWS NT 3 years Maintenance contract for TMA_HP OV mandatory 156687 TMA_CLI SUN SOLARIS Command Line Interface application for SUN SOLARIS 3 years Maintenance contract for TMA_HP OV mandatory Continued on next page Annexes 249 Annex C product information TMA Annex C product information continued The following table displays the product information on the maintenance contracts for TMA related products 158673 TMA_HP OV ENTRY LEVEL MAINT Yearly maintenance contract for TMA _HP OV Entry Level CONTRACT 3Y Versions with a minimum duration of 3 years 158674 TMA_HP OV UNLIMITED MAINT Yearly maintenance contract for TMA _HP OV_ Unlimited CONTRACT 3Y Versions with a minimum duration of 3 years 163135 TMA_CLI MAINT CONTRACT 3Y Yearly maintenance contract for TMA_CLI with a minimum duration of 3 years 163131 TMA_HP OV ENTRY LEVEL TMA_CLI Yearly maintenance contract for TMA_HP OV Entry Level MAINT CONTRACT 3Y Versions combined with TMA_CLI with a minimum duration of 3 years 163133 TMA_HP OV UNLIMITED TMA_CLI Yearly maintenance contract
83. ch device you are connected to Examples For a device that has only one exit port the drop down box is not activated In that case the only possible selection is displayed in grey Etman For a device with several exit ports the drop down box is activated For instance for a modem Card Version with more than one modem on the card e g Crocus HDSL CV Twin Crocus FO10M CV Twin the drop down box may appear as follows E sitport For a management concentrator the drop down box looks as follows Exitport line E fine B Continued on next page 54 User manual TMA Opening a TMA session Select device selection 6 Exitport continued The different Exitport values are explained in the following table line x Some Telindus devices incorporate several devices on one card This is called a multi device The different devices on a multi device are referred to using A B C D etc Examples of multi devices are e Crocus SHDSL CV Twin incorporates 2 SHDSL modems on one card e Crocus 2M CNV CV Twin incorporates 2 interface converters on one card e Crocus SDSL CV Quad incorporates 4 SDSL modems on one card Such multi devices consequently have several different exit ports Actually they have as many exit ports as there are devices on the card Example Suppose you have a Crocus SDSL Twin this is a Card Version with two SDSL modems on it You want to connect to the remote counterpart of
84. ction is made by means of a straight male female DB9 cable There are some exceptions The Orchid 1003 LAN for instance This device has an RJ45 control port Consequently the connection is made by means of a DBY RJ45 cable This cable is delivered with the Orchid 1003 LAN The following figure shows an example of a direct connection to a Table Top and Card Version modem computer running TMA Card Version modem Table Top modem auxiliary port o F fi eee straight male female DB9 cable Once the connection is made then the computer running TMA is able to reach the modem 24 User manual TMA Connecting to a device 3 2 2 To which Telindus devices can you make a direct connection Every Telindus device that is manageable with TMA has a control port Hence you can make a direct connection to any of these devices regardless of the fact it is a non IP IP or proxied IP device 3 2 5 DB25 DB9 interconnection cable If the COM port you want to use has a DB25 connector then a different cable has to be used Such a cable has the following layout Female DB25 connector Male DB9 connector for connection towards the computer for connection towards the Telindus device Sn f e f o a i e D a User manual 25 Connecting to a device TMA 3 3 IP connection to an IP device This section explains how to make an IP connection between the computer running TMA and a Telindus IP device The following table gi
85. cularly useful within the loop command Example Consider the following action ACTIONS startAL PRINT Starting AL test SEND select SEND select modem SEND selgrp Performance SEND action Test Activation testActivationType AL test WAIT 2 SHOW get testType Status SHOW get testOriginator Status PRINT Press End Loop to terminate action LOOP SHOW get testStatus Status WAIT 5 PRINT Stopping Aly tests SEND action Test Activation testActivationType NO test WAIT 2 SHOW get testStatus SsStatus The first wait command makes the action wait for 2 seconds after initiating the AL test before retrieving the status of the test This because immediately after the test the correct status information may not be available yet Therefore it is best to wait a while The wait command in the loop avoids that the status of the test is retrieved continuously Instead it is polled every 5 seconds The last wait command serves the same purpose as the first one to make sure the status of the test is stable before retrieving it Reference manual 183 The interactive sub system picture 9 10 The help text TMA You can assign a help text to a LED button or alarm port of the sub system picture and to an action Depending to which item you assigned the help text the help text appears as a e tool tip e ahelp window The source of the help text can be e a quo
86. custom log file This section explains how to interpret the custom log file It also includes an example of such a file The following table gives an overview of this section ew 148 8 7 4 Remarks on the custom log file 144 Reference manual TMA User defining values using the custom txt file 8 7 1 What is the custom log file What is the custom log file The custom txt file is loaded and parsed when TMA starts When an error is encountered TMA displays an error message and writes the error in the custom l og file What is the location of the custom log file The custom log file is created in the TMA og directory typically C Program Files TMA log The TMA error message When an error is encountered in the custom txt file the following error message is displayed Warming x The file C Prograrn Files TMA Scontig lt custor tet contains errors Please check C Program FilesS ThA Slogscustonm log for more information Reference manual 145 User defining values using the custom txt file TMA 8 7 2 Reading the custom log file There are three main elements that make up the custom l og file Cs ee time stamp In the custom log file a time stamp is given every time TMA is started with an erroneous custom l og file The most recent time stamp is at the end of the file where the oldest time stamp is located at the beginning of the file Example 14 33 53 directory Immediately after the time stamp t
87. d in a loop To stop the loop click on the End Loop button In that case the current loop will be completed but no new loop is started Click on this button to display the help text that is associated with the action For more information refer to Section 9 7 The ACTIONS section of the usr file and Section 9 10 The help text Click on this button to close the action output window This button is only available when the action has completely ended You can also use the I button of the output window to close the window However if you executed an action containing a diagnostic test e g an ET AL DL test and you close the output window using the x button then the diagnostic test will keep running This because an action containing a diagnostic test usually also contains the command lines to stop this test These command lines are executed when you click the End Loop button but not when you click the X button In that case you have to stop the diagnostic test yourself or start the action again and then properly stop the action using the End Loop button Reference manual 169 The interactive sub system picture TMA 9 9 The action commands As said before an action is made up of one or several action commands This section explains these commands The following table gives an overview of this section w e The from file command oee emoa O 808 resero enno 170 Reference manual TMA The interactive
88. d not find ini file Could not open Tma_Path model model nms Model_File_Name is not a valid model file Model files not installed correctly No valid model file found for Device_ Name Please install the TMA model files first TMA model files not installed Tma_Path not found Please reinstall TMA Unknown modules in containment tree Unknown type of device Could not read the user configuration file The configuration file has a bad entry for this user e The custom txt file contains errors 238 Cause Solution Cause These error messages indicate that something has gone wrong with the installation of TMA that some of the TMA files are not present on your system or that the model files are not present or incorrect Solution Go to the Telindus web site at http www telindusproducts com tma download the latest version of the TMA engine and or the model files and re install Cause These error messages only apply on TMA CLI and TMA for HP OpenView They indicate that there is no user configuration file present on your system or a bad entry is made in it Solution Use the application TmaUserConf exe to create or correct the user configuration file For more information refer to the manuals of TMA CLI and TMA for HP OpenView Cause This means that the custom txt file you created contains syntax errors Solution Read the custom log file to determine the nature of the error Then fix the error in the custo
89. dem ranges from A up to D Refer to the explanation of hardware address in the Paragraph Select device selection 6 Exitport 58 User manual TMA Opening a TMA session Select device selection 8 Password Security fou might specify a password to connect to the device IF not the network password will be used if any Passed ee Enter here the device its password This is the password of the Telindus device on which you want to open a TMA session If you enter nothing in this field the previously entered network password is taken as device password see below for more information on these two passwords If no password is specified in the Telindus device anything may be entered in the device password field ci A Telindus device which is used for the first time has no password Continued on next page User manual 59 Opening a TMA session TMA Select device selection 8 Password continued As you can see there are two different passwords located on two different levels e the network password in order to connect to your network through a Telindus device e the device password in order to open a TMA session on a Telindus device Some examples of combinations of network and device passwords are given below J a It is possible that the device through which you connect to the network is the device on which you want to open a TMA session In that case you only have to enter the network password
90. dow If this period elapses then the sub system picture is refreshed If this happens during the execution of an action you may experience some delay in the execution of the action commands If you find this interfering then you can stop the refresh with the stop refresh command The refresh can be started again with the start refresh command In any case the refresh is started again when the execution of the action is completed Example When executing an action the refresh can cause annoying delays in the execution flow In that case you can temporally stop the refresh cycle For example ACTIONS setSysAttributes STOPREFRESH PRINT Set the sysName sysContact and sysLocation n SEND set crocusSDSLTT sysName 1 ARG System Name PRINT The sysName set to SHOW get crocusSDSLTT sysName SEND set crocusSDSLTT sysContact 1 ARG System Contact PRINT The sysContact set to SHOW get crocusSDSLTT sysContact SEND set crocusSDSLTT sysLocation 1 ARG System Location PRINT The sysLocation set to SHOW get crocusSDSLTT sysLocation SEND action Activate Configuration J The refresh is started again after execution of this action 182 Reference manual TMA The interactive sub system picture 9 9 10 The wait command Syntax WAIT lt seconds gt Description This command sets a time out period in seconds before proceeding with the next action command This command is parti
91. dow select the line object In the attribute window select the crocusSDSLTT madem line Configuration tab Configuration Status Performance af Alarms speed 11752000 bps alarmbl ask 111111 alarmLevel Struct alarmContactHighkiask 00gop alarmContactLowM ask nagad In the Tools menu select Export Export configuration parameters Save in The Export configuration parameters window appears Manuals Tick the All attributes of line selection Filename _Line_attributes_SDSL Save as type Cms file cms bad Cancel Append Enter a file name a destination and press _ Full configuration on the Save button Selected athibutes All attributes of line jz Recurse submadules User manual 95 The TMA window TMA Export selection 8 Recurse submodules If Recue submodules Tick this selection if you want to export the attributes of the currently selected object and the attributes of the underlying objects Example In most Telindus modems the modem object has one or more underlying line objects To export the attributes of the modem object together with the attributes of the line object s proceed as follows es In the containment tree window select the modem object 3 In the attribute window select one of the tabs depending on which type of attribute you want to export In the Tools menu select Export The Export configuration parameters window appears
92. e e BUTTONS Is the front panel test button section header e lt button identifier gt is the identification of the front panel test button in the sub system picture as defined in the definition file def file e ACTION assigns a certain action to the front panel test button e lt action_ name gt is the name of an action that is defined in the ACTIONS section refer to Section 9 7 The ACTIONS section of the usr file It is this action that is assigned to the corresponding front panel test button The action name may not contain spaces and may not be quoted e HELP assigns a tooltip to the front panel test button The tooltip pops up when you move the arrow over the front panel test button e lt help text gt is the text of the tooltip You can also refer to a file For more information refer to Section 9 10 The help text Make sure the necessary curled brackets commas quotes and semicolons are present else the syntax is incorrect Continued on next page Reference manual 161 The interactive sub system picture TMA The BUTTONS sub section continued Example The following example assigns the action startET to the first front panel test button Also a tooltip is assigned to this front panel test button FRONT BUTTONS keyboardState 0 ACTION startET HELP Click to start an error test This results in the following Click to start an error test to stark Click to start an error
93. e the following warning appears THA The TML command line is too long There iz a limit of 126 characters Remove some file names from the download list and try again Refer to step 3 of the file download procedure Remark 2 When downloading files to the Telindus device over an IP connection TMA uses TFTP In that case e there is no command limit of 126 characters e the Options tab in the Download window is not present Reference manual 201 Telindus Memory Loader TML TMA 11 Telindus Memory Loader TML When downloading software with TMA as explained in the previous chapter you actually evoke TML Telindus Memory Loader through TMA You can also evoke TML from the command line i e without opening TMA This chapter explains how to do this It also lists the different TML options The following table gives an overview of this chapter a o OOOO O Displaying the TML command line help Starting TML from the command line Starting TML from the command line examples 202 Reference manual TMA Telindus Memory Loader TML 11 1 Displaying the TML command line help In order to display the different TML command line options open a DOS window and type tml The following is returned a H3 DOS Lema TIENE EET Landen S6663 701108 14 24 37 Mov 23 2601 Options are s speed speed can be 24 48 96 192 384 576 or 1152 mnCmaximum speed maximum speed can be negotiated
94. e TMA application and of the TMA model files is always available on the Telindus web site This section explains how to download and install the application and the model files from the web site The following table gives an overview of this section ew e 2 5 1 Installing the application from the web site Installing the model files from the web site User manual 13 Installing TMA TMA 2 5 1 Installing the application from the web site To install the TMA application from the Telindus web site proceed as follows Open your web browser and enter the following address http www telindusproducts com tma Read the License Agreement for Telindus software carefully e If you agree with the terms stated in the agreement click on agree e If you do not agree with the terms stated in the agreement click on don t agree Click on the link TMA part 1 engine manual included rev xxx xxxx KByte 4 Save the executable file SOO04xxx exe where xxx stands for the revision to a temporary directory on your hard disk For instance C temp S0004010 exe In this temporary directory double click on the executable file SOO04xxx exe The InstallShield Wizard guides you through the set up process The following figure displays a few steps of the installation procedure Save As Ei E Temporary Save IF Press Setup to start the setup procedure of TMA or Cancel to exit Telindus Access Prod
95. e are three main elements that make up the custom txt file ce ee section The file is divided into a number of sections Each section consists of a section header followed by a number of definitions For more information on sections refer to Section 8 4 The sections of the custom txt file definition One section can contain one or several definitions With these definitions you create the user defined values For more information on definitions refer to Section 8 5 The definitions of the custom txt file comment Everything that is typed after a character is considered as comment until the end of the line This allows you to add personal comments to clarify the custom txt file Example The following figure shows an example of the structure of a custom txt file section Syshdmin hi gh enseFilte Helpdesk Tel 1100 pent falarmilter lowSenseFilter 0 mediumSenseFPilter 5 01003 megroupfobjectTable name HDSL CY Central x HDSL TT Central x HDSL TT Remote x meygroup obj ectTable configFileHame HDSLOYCentral cm HDSLTTCentral cms HDSLTTRemote cms devicesSoftware downloadTable name HDSL CY Central x HDSL TT Central x HDSL TT Remote xX devicesoftware fdownloadTable sourcePile T1234567 00 T9876543 00 T9638527 00 crocus HDSLTT The definition of the LinkDown alarm applies on both lines The definition of the
96. e custom txt file 8 1 What is user defining values What is user defining values User defining values has two main advantages e You are able to predefine a set of values for a string value Values which can then be selected from a drop down box instead of typing the complete string e You are able to give a sensible name to an otherwise very cryptic integer value You can only user define values for string and integer attribute values Not for enumerated values IP addresses etc Examples of string values are the values of the attributes sysName sysContact sysLocation etc Examples of integer values are the values of the attributes cms2Address alarmFilter broadcastTimer etc How to user define values In order to user define values you have to create and edit a custom txt file this file is not created when TMA is installed What is the custom txt file The custom txt file is a plain text file containing special syntax which defines the values you want This custom txt file is loaded and parsed when TMA starts When an error is encountered TMA displays an error message and writes the error in the custom l og file What is the location of the custom txt file You have to place the custom txt file in the TMA config directory typically C Program Files TMA config Reference manual 131 User defining values using the custom txt file TMA 8 2 Creating the custom txt file In order to create the custom txt file proc
97. ect cable e ls the PSTN modem connected to the PSTN network e Did you select the correct COM port e Is the PSTN modem switched on e Make sure that the communication parameter settings in the Cms2Serv ini file are adapted for a dial out connection Typical values are Retries 5 ExtTimeOut 10 216 Reference manual TMA Troubleshooting 13 1 3 You have problems with an IP connection You try to establish an IP connection but the connection fails Error x No response Solution Check the following e ls the cable between the PC running TMA and the IP network connected at both ends e ls it the correct cable e ls the cable between the IP network and the Telindus IP device connected at both ends e ls it the correct cable e ls the Telindus IP device switched on Try to ping it Reference manual 217 Troubleshooting TMA 13 1 4 You have problems with a proxied IP connection You try to establish a proxied IP connection but the connection fails Error x Mo response Solution Check the following e ls the cable between the PC running TMA and the IP network connected at both ends e ls it the correct cable e ls the cable between the IP network and the management concentrator connected at both ends e ls it the correct cable e ls the management concentrator switched on Try to ping it e ls there a physical connection between the management concentrator and the non IP device e ls
98. eed as follows Go to the directory TMA config typically C Program Files TMA config Create a new plain text document in this directory ba View Customize this Folder Arrange cons Cime Op lcans Refresh Faste Faste Shortcut Undo Move O Froperties g Shortcut Text Document cal Microsoft Word Document Ey Briefcase al Microzort Excel Worksheet Hal Microsoft Office Binder 7 Other Office Documents a Microsoft PowerPoint Presentation a Corel Media Folder Rename this text document to custom txt Open the custom txt file and edit it with a plain text editor using the syntax as described in Section 8 3 The structure of the custom txt file Section 8 4 The sections of the custom txt file and Section 8 5 The definitions of the custom txt file Save the custom txt file and start TMA If TMA starts and e no error message is displayed then the custom txt file is correct e the following error message is displayed Warming The file C Program Files TMAScontig custom tet containg errors Please check C Program FilesS TMA logscustom log for more information then an error is present in the custom txt file Read the custom log file to find out more about the nature of the error For more information refer to Section 8 7 Reading the custom log file 132 Reference manual TMA User defining values using the custom txt file 8 3 The structure of the custom txt file Ther
99. eeeeseesceseeeseneeneseesonesneseneoes 126 7 1 What is a user instantiatable object 20 0 cccccececeeeceneeseeeseeeeeeeeseeeseeeeseeeseeseaaeees 127 7 2 Adding a user instantiatable object cc ccceccceccseeceeeceeeseeececeeeeeeeseeceeeseeecaeeseeeaaes 128 7 3 Removing a user instantiatable object ccc cccccscccseccseeceeceuecaeecesecaeecseeceeecseseeesaess 129 8 User defining values using the Custom txt file ccc cececeeee esse eeeeeeeeeneeeneeeeees 130 6 1 Whatisuserdetinng vales fee cenes dcncsces desu eaectuere ues A 131 82 Creating he custom PIIG arcean ne R uemeenmens E E 132 8 3 Thestr cture ofthe CUstom Xi TING srein ee r A E EE 133 8 4 The sections of the custom txt fil cc cccccccececeeeeeeeeceeecseeeseeeeeaeeseeeseeeseesseeeseees 134 8 5 The definitions of the CUSfOM EXE Me eii i 135 8 6 An example of a CUSLOMLEXE FIO enisinia Era a ini 142 8 7 Reading the CUStOM IOG FIlC ccccccccecccceccceeeeeeeeceeeeeceseeecsuceceeeesaeeseeesgeesaeesseseseees 144 9 The interactive sub system picture ccceeecceceeeceeeeeeeeeseeeeeeseneceeseesoneeeeseneees 150 9 1 What is an interactive sub system PICtUre ccc ccccceececeeeceeeeeeeeceeeseeeeeaeesaeeeeeeees 151 9 2 The sub system picture WINKOW ccccccceccseecseeceeeseeeseeecaceceeceeeceeeseeeseeeseeesaeesaeenaes 152 g3 CREAUMO A UST ME seroso a escrecaetcaaetedve AE 153 OA Thesections ofthe SUS fil Esenin rle aa adea
100. er The TMA Comms Handler is a part of the TMA software that handles the communication towards the connected devices If you connect through one of the COM ports of your computer the TMA Comms Handler locks this COM port for other applications If you close all TMA sessions and even if you close the TMA application the TMA Comms Handler waits a certain period before it releases the previously used COM port s You can change this timeout with the WaitClose parameter in the Cms2Serv ini file As default this timeout period is set to 5 minutes For more information on this and other communication parameters refer to Section 12 1 Parts of the Cms2Serv ini file However you can force the TMA Comms Handler to close even if the WaitClose time is not elapsed yet To do so proceed as follows Move the Windows arrow to the TMA Comms Handler icon on the taskbar Press on the right mouse button From the pop up menu choose Close Hestore M AG WE SEE Minze kasme F THA comms handler Close Alt F User manual 39 Opening a TMA session TMA Device selection 2 Dial out No Dial out No PSTN modem Make this selection if you do not wish to establish a dial out connection Device selection 3 Dial out PSTN modem Dial out C Ho PSTN modem Remote mantenance modem Tel ri on 6302499 Make this selection if you wish to establish a dial out connection An example of a dial out connection is given below Example
101. es Press the Open button AN ies El Cancel Remote File lsdsttmod The Download window reappears If you want download more than one file press Add again and select another file as Password Configuration Options described in step 2 iit The download list box specifies the files that will be sent to the device Use the Add and Remove buttons to edit the list If you selected a wrong file by accident you TETEE can remove this file from the list 1 Select the file in the list 2 Press the Remove button When you selected all the necessary files THA Download press the OK button in the Download window Password Configuration Options A window appears and shows the Be download progress buttons to edit the list models nmstamodels nms dalt modtsdsltt mod Remove Cancel The download list bos species the files that will be sent to the device Use the Add and Remove T2114003 007 211 4005 00 T21 22003 007 21 22003 00 Remove Reference manual TMA Downloading software 10 3 Remarks on downloading files to the file system Remark 1 When downloading files to a Telindus device over a serial connection TMA uses a small DOS based program called TML Due to the fact that DOS commands are limited to 126 characters the number of files you can download in one go is limited Selecting too many files at once results in a too long command line In that cas
102. evices that are defined nin the object table do not answer on when polled Show routing table ACTION showRoutingTable HELP Click to see the status of the routing table Ping ACTION ping HELP Click to start a ping action Reference manual 189 The interactive sub system picture ACTIONS showUpTime SEND select SEND sSelgrp Status SHOW get LIST date time sysUpTime showAlarmLanPort PRINT The alarms of the LAN interface are n SHOW get 01003 interfaces lanInterface Alarms showPerfLanPort PRINT The performance of the LAN interface is n SHOW get 01003 interfaces lanInterface Performance showStatusPortA PRINT The current status of port A is n SHOW get 01003 interfaces portA Status showStatusPortB PRINT The current status of port B is n SHOW get o01003 interfaces portB Status showStatusLanPort PRINT The current status of the LAN interface is n SHOW get o01003 interfaces lanInterface Status showID SEND select SEND selgrp Edit Configuration SHOW get sysName SHOW get sysContact SHOW get sysLocation SEND selgrp Status SHOW get sysDescr SHOW get sysUpTime SHOW get deviceID SHOW get bootVersion SHOW get flashlVersion SHOW get flash2Version SHOW get activeFlash ping PRINT Specify the IP address you want to ping n SEND select 01003 router SEND selgrp Performance
103. ex B TMA error messages Import errors TMA The following table lists some error messages you may encounter when importing a file Error message Cause Solution e The file FileName could not be opened You might check its permissions Or the file might be in use by another application The file FileName is an exported cms file but contains a configuration for a different device or revision than the current one The file FileName is not an exported cms file It might be corrupt The import succeeded However some modules were not imported since no model information for them was available 244 Cause These messages indicate that you have no access to the file you tried to import a file of another device or another firmware revision the file is corrupt Solution Make sure you have full access to the file Make sure it is a file for the current device If you are unable to import the file export a new file and try to import this new file Annexes TMA Annex B TMA error messages Download errors The following table lists some error messages you may encounter when downloading firmware to a device Error message Cause Solution The local filename may not contain the Cause character The remote filename may not contain the character The TML command line is too long There is a limit of 126 characters Solution These messages indicate that you used characters in the filename that are not allo
104. f objects that are ordered in a tree This tree resembles a Windows directory structure e itis also a levelled structure with nodes which can be expanded or reduced e the containment tree objects can be compared with file folders e the objects contain attributes like file folders contain files b Object What is an object An object represents a physical interface an application or a combination of both Each object has its own set of attributes Example The top object crocusSDSL contains the sub object modem On its turn the sub object modem contains the sub object line This object contains all the attributes concerning the line pair E g the status attribute lineAttenuation dB c Node How to navigate in the containment tree In the containment tree window you can e click on the nodes to expand or reduce the containment tree or parts of it e select an object in the containment tree The corresponding attributes are displayed in the attribute window 104 User manual TMA The TMA window 6 5 The attribute window This section describes the attribute window It explains what an attribute is and shows the different attribute value types It also explains the difference between the configuration status performance and alarm attributes The following figure shows the attribute window Ores SLT T e a _ Attribute position Configuration Status k3 Performance chl Alarms Attribute group ie e
105. for TMA HP OV Unlimited MAINT CONTRACT 3Y Versions combined with TMA_CLI with a minimum duration of 3 years The following table displays the product information of the TMA applications manuals 169440 MANUAL TMA E Manuals are delivered with the product in electronic format CD ROM for environmental reasons If however a hardcopy print out of the manual is required this sales item can be used Between brackets an indication of the language 169441 MANUAL TMA FOR HP OPENVIEW E Manuals are delivered with the product in electronic format CD ROM for environmental reasons If however a hardcopy print out of the manual is required this sales item can be used Between brackets an indication of the language 169442 MANUAL TMA CLI E Manuals are delivered with the product in electronic format CD ROM for environmental reasons If however a hardcopy print out of the manual is required this sales item can be used Between brackets an indication of the language 250 Annexes
106. g your network allows this If this is the case then you will see the following when connecting to such a device User manual Start the TMA application Refer to Section 4 1 Starting TMA gt The TMA window appears Display the Connect Device window Refer to Section 4 2 1 Displaying the Connect Device window Make your selection in the Connect Device window Refer to Section 4 2 2 The Connect Device window selections If the connection to the device was successful and if the device allows to open a TMA session on other devices further on in the network then the Connect Select device window appears Depending on whether you are connected to a management concentrator or not one of the following Connect Select device windows appears In case you connected to a management concentrator Connect Address Choose whether to connect on the network device itself or a device thereafter if so specity its address On device C After device ontigquied device Security fou might specify a password to connect to the device IF not the network password will be used if any i Password i Cancel In case you connected to any other Telindus device Connect Address Choose whether to connect on the network device itself or a device thereafter if so specify its address moder X s ecurity
107. gives you the possibility to remove old aliases eae Edt View Tools Device Ctrl Select device Ctrl D Application Disconnect Reconnect Chrl F Add Alias Chrl L THA Aliases 1 com reli 2 10 0 11 250 comen 3 con rel 10 0 11 250 corn rel Soe comerell More Die ORE E xi pote p tome _ coe User manual 79 The TMA window TMA 6 2 2 The Edit menu The Edit menu is not only available in the menu bar but can also be displayed as pop up menu This is done by selecting an element in the TMA window and pressing the right mouse button The contents of the Edit menu depends on which element is currently selected The following paragraphs explain how to display the different Edit menus They also list and describe the underlying commands The following table gives an overview of the different Edit menus Figure Click on the link below to jump to the corresponding paragraph Retieve F5 Reload Paragraph a The containment tree Edit menu page 81 Delete Sdad eile Retrieve F5 Reeve HecUEkre Modify Be 2 Ve Wisin Paragraph b The attribute Edit menu page 82 mptional Serio Ippe Select All Cirl 4 Unda Cut Copy Baste Delete Paragraph c The text Edit menu page 84 selecte Execute Modity Fe Set To Default Paragraph d The action Edit menu page 85 Set To Default Insert Row Before Insert Row After Paragraph e The table Edit menu page 86
108. guration parameters Hiding the advanced configuration parameters might be useful when you first start using the device It makes the configuration attributes overview less complex It also shows you only those configuration attributes which are really necessary to establish a basic connection Press this button to display the sub system picture of the device For more information refer to Section 6 2 3 The View menu Press this button to cancel all requests that are currently pending When you browse through the containment tree of a device it sometimes can take a while before all attribute values of the current object are retrieved from the device this is especially true when the Performance group is selected and even more so when connected to a remote device If for some reason you prematurely want to cancel the retrieving of the attribute values then press the Cancel all pending requests button 103 The TMA window TMA 6 4 The containment tree window This section describes the containment tree window It displays the containment tree and explains what it contains It also shows how to navigate in this window The following figure shows the containment tree window Containment tree Containment tree erocusSDSLTT Object modern Node a Containment tree What is a containment tree The containment tree represents the hierarchical structure of the Telindus device It is composed of a number o
109. he string parsing file lt custom txt path gt path appears The is the directory path where the custom txt file that was parsed is located Example parsing file C Program Files TMA config custom txt errors After the time stamp and directory path the errors that were encountered in the custom txt file are listed First the line on which the error occurs is displayed then the nature of the error is described Example e line 5 error in valuelist of definition means an error is present in the values that are listed after the equal sign of the definition line 15 error in definition means an error is present in the path that is listed before the equal sign or the equal sign itself is not present of the definition Example directory path error in definition error in definition ne 6 ine 7 fl5 17 55 parsing file C Program Files THA config custom txt line 5 error in valuelist of definition line 6 error in definition line 7 error in definition line 15 error in attribute part of definition 15 18 26 parsing file C Program Files THA configs custom txt line 5 error in valuelist of definition line 6 error in definition line ff error in definition line l5 error in attribute part of definition 146 Reference manual TMA User defining values using the custom txt file 8 7 3 Example of a custom log file Consider the following example of a custom txt file This files contains several syntax e
110. howConfig HELP This action shows you the complete configuration of the device PRINT The complete configuration of the device is n SHOW get r In the action output window this help window would appear as follows z i ig AutoSerall cad Loop Help b alarmContactHighMask d T Herp Pel Es 4 This action shows you the complete configuration of the device Close Short circuit disabled alarmLevel Open line 3 FFRYFFFFFTFFTYrTrTrTTTTF Remote power Fail 3 Short circuit 3 alarm ConkactHighMask Open line disabled Remote power Fail disabled Short circuit disabled alarnmicontactLowMask Open line disabled Remote power Fail disabled Short circuit disabled F Close 186 Reference manual TMA The interactive sub system picture 9 10 3 A quoted string as help text source In this case the help text is typed between quotes immediately after the HELP command The syntax can be seen in the example below LEDS lEDPower ACTION getUpTime HELP Click to see sysUpTime This text may be a multi line text If you want to start a new line use n as line separator The syntax can be seen in the example below LEDS lLEDPower ACTION getUpTime HELP Click to see sysUpTime nThis is the elapsed time since the last npower on or cold boot of the device For this example the tool tip looks as follows Click to see syvsUpTime This is the elapsed time si
111. i file is AT amp D1X4E0V0Q0 link PSTN The modems are not allowed to negotiate their speed since this speed can then modem 1 lt 2 differ from the COM speed DTE interface and control port speed Therefore set a fixed speed for the link being 9600 bps DTE interface 2 Because the speed of the control port is 9600 bps also set the DTE interface 2 speed to 9600 bps Set the data format to 8 N The AT commands on DTE interface 2 have to be result codes off ATQ1 echo off ATEO You have to send these AT commands to on DTE interface 2 Control port There is nothing to configure on the control port It uses a fixed speed of 9600 bps and a data format of 8 N User manual 73 The TMA window TMA 6 The TMA window After you have opened a TMA session on a device on the network you are able to control the device This chapter explains every item of the TMA window which enables you to do this First the different parts of the TMA window are displayed and labelled Then all these parts are explained one by one The following table gives an overview of this chapter se o O The attribute window 6 6 The action window 112 The structured value window The status bar 14 User manual TMA 6 1 The TMA window structure This section displays and labels the different parts of the TMA window The following figure shows the TMA window and labels the main parts THA Crocus SDSL TT 1 Zoja Connect Edit V
112. ice teaches you how to open a TMA session presents some practical examples on opening a TMA session on a device thoroughly describes all elements of the TMA window such as the pull down and pop up menus the toolbar buttons etc Reference manual Chapter This chapter T shows you how to add a user instantiatable object to the containment tree explains how you can define your own values for attributes that have a string or an integer as value You can do this using the custom txt file describes what the TMA sub system picture is and how you can make it interactive 0 introduces the Telindus Memory Loader TML the tool that actually takes care of the software download It shows you how to evoke it from the command line Continued on next page Preface TMA Organisation of this manual continued Annexes The following table gives an overview of the annexes Annex This annex AnnexA gives a list of abbreviations gives a quick overview of the most important TMA error messages shows ordering information TMA Preface Conventions used in this manual Typographical conventions The following typographical conventions are used in this manual The format Normal Italic Computer Computer Bold Narrow Blue Blue underlined Icons is used to indicate e new or emphasised words e file names and directory paths e g C Program Files TMA bin Tma exe computer output
113. iew Tools Help Aelel 515 oot ki Containment tree crocusSOSLTT Bae crocussDOLTT Configuration Status Performance cpl Alarms modem a Name de OoOO O bo sysN ame Crocus SDSL TT 1 aps Contact System Administrator Tel 12 34 56 ssLocation Main building Equipment room security Tables bogtFromF lash Auto forvandTMAToNMSPort enabled tormardT MAT oLine enabled alarmh ask MO eee alarmLevel lt Struct gt a larmLontactH ighM ask OOOUO0000 alarmContactLowM ask OO0000000 Argument Walue b Activate Configuration b Load Saved Configuration H Load Default Configuration b Cold Boot F alarm ask BitName S Value P NotResponding enabled P AlamnSwncLoss enabled H StrapChanged disabled b Access disabled b Remotedlarnn disabled P UnkrownState disabled P Bogt disabled b CodeConsistencyF ail disabled gt ConfiglonsistencyFaill disabled T User manual The TMA window The menu bar The toolbar The containment tree window The attribute window The action window The structured value window The status bar 19 The TMA window TMA 6 2 The menu bar This section describes the pull down menus located in the menu bar It displays the pull down menus and explains the underlying commandos The following table gives an overview of this section es o The Connect menu The Edit menu 6 2 4 The Tools menu 88 The following figure depicts the menu ba
114. irectories and files can be found in the directory C Program Files TMA This directory has the following subdirectories This directory contains manuals the executables This comprises the TMA executable and some extra executables TMA sometimes summons such as TML TmaTftp the configuration files These are the ini files If you create a custom txt file you should also place it here the log files Sometimes errors are logged to a file These files can be found in this directory the user manual of TMA this manual the model files TMA needs the model files to be able to communicate with the Telindus devices These mod files are located in this directory the sub system picture files These are the omp and def files that are necessary to display the sub system picture of a Telindus device the Telindus MIB files When using an SNMP browser you need the MIB files of the Telindus devices These mib files are located in this directory the SUM files The sum files give the relationship between the attributes as they are displayed in TMA and the parameters you can see using an SNMP browser User manual TMA Installing TMA 2 Remarks on updating and uninstalling TMA This section gives some remarks on updating and uninstalling TMA The following table gives an overview of this section Le o e 2 7 1 Updating TMA User manual 17 Installing TMA TMA 2 1 Updating T
115. is section explains how to interpret the picture og file It also includes an example of such a file The following table gives an overview of this section 9 12 1 What is the picture log file 193 9 12 2 Example of a picture log file 194 192 Reference manual TMA The interactive sub system picture 9 12 1 What is the picture log file What is the picture log file The usr file is loaded and parsed when the sub system picture is evoked When an error is encountered TMA displays an error message and writes the error in the picture og file What is the location of the picture log file The picture log file is created in the TMA og directory typically C Program Files TMA og The TMA error message When an error is encountered in the usr file the following error message is displayed Warming Error in the user file Orly the non interactive parts of the picture will be available Please check the logfile for more information What is the result on the sub system picture The result of en erroneous usr file is that the sub system picture will be displayed but without any interactive function l e TMA just displays the plain sub system picture Reference manual 193 The interactive sub system picture TMA 9 12 2 Example of a picture log file Consider the following example of a usr file This files contains several syntax errors COMPONENT crocusSDSLTT FRONT LEDS TEN Help tex
116. layed in the structured value window Simple value A simple value is displayed in the attribute window The following table gives some examples of simple values direct editable This simple value can be edited immediately in the Name Value attribute window When you click on it a cursor appears p cme ddress 14 and you can enter your value There are no underlying values in a drop down box or in the structured value window drop down box This simple value is selected from a drop down box Only configuration attributes can have drop down box speed M1520000 bps selectable values Dee FESOO0 bps 1152000 bps bit string This simple value gives a bit string representation of the aa Value underlying values e g 101 These underlying values are p alamMask 000000011 visible in the structured value window They can only adopt two different states F alarmntask e 1 enabled or on Bit Name 0 disabled or off b NotResponding enabled po AlarnSyncloss enabled The bit string is a special case of a simple value It does StrapChanged disabled have underlying values which are visible in the structured value window but only to increase readability and clarity The real value i e the bit string itself is visible in the attribute window direct editable This is a special case of a bit string In this case there are no underlying values in bit string the structured value window Instead this bit string is edited by
117. le each command line has to be terminated by a semicolon When the DOP is running the End Loop Punon Dutput Pijal E on the action output window becomes active SNNN When you click this button the current loop is be 7 completed but no new loop is started E g if a Sutercrl Endioop Hop loop consists of 10 commands and during amp Continuous operational status monitor of modem and line e Click End Loop to interrupt the loop execution of the second command the End Operational status of the modem Loop button is clicked then the remaining 8 ifOperStatus down commands are executed but the loop does not eros ue Ort aemne restart afterwards Also in the action output window the red algse triangle in front of the output generated by the looped commands gives an indication of the progress of the loop iFOperStatus down Example Suppose that for a certain modem you continuously want to monitor the operational status of the modem and the line This action would look as follows ACTIONS modemLineStatus PRINT Continuous operational status monitor of modem and line nClick End Loop to interrupt the loop LOOP SEND select SEND selgrp Status SEND select modem PRINT Operational status of the modem SHOW get ifOperStatus WAIT 2 SEND select line PRINT Operational status of the line SHOW get ifOperStatus WAIT 2 Reference manual 175 The interactive sub system picture
118. lease specify how to reach the device you wish to connect to f Serial com Dial out No C PSTN modem ay Remote mattenance madem Telir E P address a P Sesion to MA ia ae Subnetmask Eo Security Specity the password for connecting to this device This field may be left open Password Cancel User manual 37 Opening a TMA session 4 2 2 The Connect Device window selections TMA The following figure displays the Connect Device window All the different selection possibilities are numbered They are explained in the following paragraphs 38 M Assign tate lahre m gsl SA L L ah Me PSTN mode a F eT Ole matntenanrce moden ari Device Device Device Device Device Device selection 1 selection 2 selection 3 selection 4 selection 5 selection 6 User manual TMA Opening a TMA session Device selection 1 Serial Address Please specify how to reach the device you wish to connect to i Serial Make this selection if you want to make a direct also called serial connection as described in Section 3 2 Direct connection to a device In that case you have to specify which COM port of the computer is connected to the control port of the Telindus device Select one of the four possibilities displayed in the drop down box e COM 1 e COM 2 e COM 3 e COM 4 The TMA Comms Handl
119. lgrp Performance SEND action Test Activation testActivationType ET test WAIT 2 SHOW get testType Status SHOW get testOriginator Status PRINT Press End Loop to terminate action LOOP SHOW get testStatus Status SHOW get errorCount WAIT 5 PRINT Stopping ET test SEND action Test Activation testActivationType NO test WAIT 2 SHOW get Testotatus Status 7 SHOW Get Srrorcount SEND select SEND select modem line SEND selgrp Status SHOW get showID HELP This displays the system identification SEND select SEND selqrp Edit Configuration SHOW get sysName SHOW get sysContact SHOW get sysLocation SEND selgrp Status SHOW get Reference manual TMA The interactive sub system picture 9 8 The action output window When an action is executed the output of this action if any is displayed in the action output window tx P AutoSerall End Loop Help Starting ET test E testType ET test P testOriginator nmstst E Press End Loop to terminate action b bestStatus running E errorCount 65535 The action output window has the following buttons AutoScroll Click on this button to enable or disable the auto scrolling End Loop Click on this button to end a loop This button is only available when a loop is being executed Some actions contain a loop i e a number of commands are execute
120. llowing e ls the physical connection between the management concentrator and the device OK Incase of a Table Top device is its NMS port connected to an asynchronous port of the Orchid Incase of a Card Version device is it inserted well in the CN4 card nest Is the high speed NMS bus of the CN4 card nest connected to the high speed NMS bus of the Orchid e Do you use the correct cables to connect the device to the management concentrator e ls the device switched on e Try to reboot the device 228 Reference manual TMA Troubleshooting 13 3 Failing software download You get a NACK received error message You have a direct connection to a device and a TMA session is running on that device Then you try to download software to the device but you get the following error message TMA Tml download status MACK recened Solution Check the following e Make sure the connection between the PC running TMA and the device is OK e Did you select the correct firmware e is the firmware you selected the firmware intended for that device e Do you have write access to the device e lf you have read only access did you enter the write access password e Did you enter the correct password e Did you select the correct initial soeed Make sure it is set to 9600 bps e What maximum speed did you select Try reducing this speed e What window size did you select Try reducing the window size Reference manual 229
121. locate the Status problem E g errorCount in the modem object noiseMargin in the line object ifOperStatus in the lt interface gt object etc performance This group gives a history of the device its performance This information allows you for instance to trace bottlenecks in the network to determine overall Performance network performance etc E g h2Modem in the modem object h2BitError or h24LineParameters in the line object etc alarms This group displays the device alarms which are currently active As the status attributes the alarm attributes enable you to locate a problem quickly cl Alarm E g SyncLoss in the modem object LinkDown in the line object etc User manual 111 The TMA window 6 6 The action window TMA This section describes the action window It explains what an action is and shows the different action types The following figure shows the action window Action ArgumentName Argument Value Action b Test Activation tesh4ctivationT ype NO test a Force Full Retrain Execute Modity Serio Perault Execute action a Action What is an action An action is an executable parameter which causes the device to do something E g Cold Boot Load Default Configuration Test Activation etc The actions are not always visible in the action window They are assigned to a combination of a group with an object Example If you select the top object e g CrocusS
122. m txt file and start TMA again For more information on the custom txt file and the custom log file refer to Chapter 8 User defining values using the custom txt file Annexes TMA Annex B TMA error messages TMA CLI command line errors The following error messages only apply on TMA CLI They list the possible error messages when starting TMA CLI Error message Cause Solution Invalid argument after IP address Cause Invalid Argument_Type argument Missing exit port or hardware address These error messages indicate that you entered ae an incorrect argument value after the TmaCli Missing NMS address argument command or that you mistyped it Unexpected Argument_ Type argument Unknown argument Solution Unknown alias Carefully recheck the arguments you typed after the TmaCli command For a quick help on the possible options and arguments type TmaCli h Annexes 239 Annex B TMA error messages TMA Alias errors The following table lists the error messages concerning aliases Error message Cause Solution e Alias not found or entry corrupt Cause e Already an alias with that name These error messages indicate that you wanted to e Invalid alias use an alias that does not exist or that you tried to create an alias that already existed Solution Carefully check your aliases Refer to Section 6 2 1 The Connect menu Paragraph b Creating aliases 240 Annexes TMA Annex B TMA error mes
123. mLevel LinkDown medium Absolute path non indexed Example modem line alarmLevel LinkDown lowest Relative path only non indexed allowed Example line alarmLevel LinkDown Presence of In case two or more absolute paths containing one or more indexed objects exist indexed objects then the path that contains the indexed object with the highest location in the containment tree has the highest priority Example quadE1 1 g703 1 alarmLevel linkDown has a higher priority than quadE1 g703 1 alarmLevel linkDown Located in Definitions located in specific device sections have a higher priority than definitions which section located in the common section 138 Reference manual TMA User defining values using the custom txt file 8 5 2 The attribute and element name Besides the path you also have to specify the attribute or element of an attribute in the definition Attribute and element syntax Attributes are separated from the path by a character Elements of an attribute are separated from the attribute and each other by a character Examples Suppose you have an Orchid 1003 LAN and you want to user define values for the attributes sysContact alarmFilter and the element portNumber sysContact management alarmFilter namsgroup objectTable exitPort portNumber i Note that attributes located in the top object have to be preceded by a character Reference manual 139 User defining values using
124. manual 127 User instantiatable object TMA 7 2 Adding a user instantiatable object To add a user instantiatable object to the containment tree proceed as follows Left click on the object under which you want to add a user instantiatable object By doing so the object is selected highlighted blue E g left click the router object of the Telindus 1421 SHDSL Router While the object remains selected right click it A pop up menu appears In the pop up menu select Add Child Possibly a new menu appears in which you can choose from several child objects Choose a child object E g in our example select the child object routingFilter The Add module window appears In the Add module window type the name you want to appear after the child object name l e you have to type the index name also called instance name Then click on OK E g in our example type for instance filter1 The child object is added under the parent object with the specified instance name b sendPortUnreac Add module Soya 5 b send4dminUnre b ripUpdatelnterv lt gt Add module routingFilter J 5 Reload i die aciei sta Inparent router bridg Delete bono Secret T able With name filtet Add Child management priority Policy The syntax description tor the index can S CJ filesystem raffe Policy be found on the statusbar OK Cancel The result is router i tunnels J defaulth at a ey routingFilter filter
125. n These are some common definitions sysContact ISP Tel 784512 Helpdesk Tel 1100 SysAdmin sysLocation Main building equipment room Remote building management alarmFilter lowSenseFilter 0 mediumSenseFilter 5 highSenseFilter 10 As you can see the remark is preceded by an incorrect remark character it is preceded by a instead of a character Therefore the parser thinks this line is already part of a definition As a consequence the custom log file will contain the following message 16 40 49 parsing file C Program Files TMA config custom txt line 3 error in attribute part of definition As you can see in the custom l og file line 3 is indicated as the erroneous line This because the parser thinks that line 2 is already part of a definition that spans two lines and is ended by the semicolon character on line 3 Reference manual 149 The interactive sub system picture TMA 9 The interactive sub system picture This chapter describes what a sub system picture is It also explains how you can make it interactive using the usr file The following table gives an overview of this chapter oe What is an interactive sub system picture The sub system picture window Creating a usr file The sections of the usr file The FRONT and REAR section of the usr file 96 The BUTTONS section of the usr file 165 The ACTIONS section of the usr file
126. n 154 9 5 The FRONT and REAR section of the usr file 2 0 0 0 ccc cece ceccceeceeeeeceeeeeeeeseeesaeeeeeeees 156 9 6 The BUTTONS section of the usr file cc ecccccccceccceseeceeeseeeeeeeeseeeseeeseeeaeeeseees 165 9 7 The ACTIONS section of the USP fil 2 0 ce ccccccceecceseeceeeseeeeeeeeseeeseeeseeesseeeneeees 167 9 3 TNE AClOMOULDUL WIMGOW cruna an a E E A EAA 169 99 TMeactionrcomMmMNnaNdS sseni a E ad Getoteatass 170 J10 Wikies Me lpr IE e a eect oh Ge ea te cate edt eo ease hee dee 184 Fea Fal el Example ola UST oer ne ree ee ee ore ee 189 9 12 Reading the PICIUIE IOP Me oraren Giese oe olas pede ceetheccadebsiigugiaee dads 192 10 Downloading software cccceecceeeeeeeeceeeeeeeeneeeneeenscaeeeeeseneseneeenseaesenesenesanesanes 196 10 1 Downloading firmware to the flash memory ccccccccsececeeeceeeeeeeeeeeeseeeeaeeeseeeeseeees 197 10 2 Downloading files to the file system c ccc ccccccescecececeeeeeeeeceeeeeeeseeeseuseseeeseeeeseess 200 10 3 Remarks on downloading files to the file system ccccceccceeceeeeeceeeeeeeeeeeeseeeeeeeees 201 11 Telindus Memory Loader TML ccccsceeeeeeeeeeeeneeeeeenseneeeesoneeeesenseneseesones 202 11 1 Displaying the TML command line help ccc cece eeeeeeeeeeeeeeeeeeeeeeeseeeseeeaeeeaeeeaees 203 112 Starting TME from the COMmimanG ING xxtec cc occ cece acetast ance aiec aE a teeth etee 204 11 3 Starting TML from
127. n IP device The IP address should belong to the sub network of the management concentrator For example if the IP address of the management concentrator is 192 168 4 5 with subnetmask 255 255 255 0 then the IP address of the network unit should also be within the range from 192 168 4 1 to 192 168 4 254 addressType The management concentrator has to know how it can contact the connected non IP device Therefore use the addressType attribute to specify the type of address e arelative address e an absolute address For more information on these address types refer to Section 4 3 3 The Connect Select device window selections Select device selection 5 NMS address addressValue If you set the addressType attribute to absolute then use the addressValue attribute to specify the absolute address value Continued on next page 32 User manual TMA Connecting to a device Proxied IP connection to a non IP device continued Attribute Description port The exit port specifies through which port of the management concentrator the or network unit can be reached exitPort In case of the exitPort attribute the underlying attributes are exitPortType Use this attribute to specify whether the non IP device is reachable through e one of the asynchronous ports of the management concentrator port In this case also set the attribute portNumber the high speed bus of the CN4 Card Nest rack In this case al
128. n between the interactive sub system picture and the Telindus access device is closed and the interactive sub system picture freezes Continued on next page Reference manual 177 The interactive sub system picture TMA The send command continued The send command and one argument The send command can also be used with an argument To do so use the ARG keyword For example ACTIONS setsSysName SEND set crocusSDSLTT sysName 1 ARG System Name When executing this action a dialog box appears asking you to fill in the field labelled System Name The value l l l l System Name SDSL TT 2 you enter is put in a CLI environment variable 1 and then used as value for the sysName attribute Cancel OK Also in the dialog box do not forget to use quotes when the value contains characters that conflict with the normal CLI syntax such as a comma a space an equal sign etc Continued on next page 178 Reference manual TMA The interactive sub system picture The send command continued The send command and multiple arguments If you need multiple arguments then use the arc keyword followed by a comma separated list of argument names For example ACTIONS Ping l PRINT Ping action nspecify IP address and number of iterations PRINT SEND select 01003 router SEND selgrp Performance SEND action startPing pingData ipAddress 1 iterations 2 ARG
129. nce the last power on or cold boot of the device Reference manual 187 The interactive sub system picture TMA 9 10 4 A file as help text source In this case the help text is retrieved from a file using the HELP command in combination with the FROMFILE command followed by a quoted string specifying the file The syntax can be seen in the example below LEDS lEDPower ACTION getUpTime HELP FROMFILE pwrLedHelp txt If no path is specified then TMA looks for the file in the directory TMA bin typically C Program Files TMA bin The text may also be a multi line text If you want to start a new line just start a new line in the file Suppose the file pwrLedHelp txt contains the following Click to see sysUpTime This is the elapsed time since the last power on or cold boot of the device Then the tool tip would look as follows Click to see sysUpTime This is the elapsed time since the last power on or cold boot of the device 188 Reference manual TMA The interactive sub system picture 9 11 Example of a usr file This section gives an example of a usr file You can find more examples for almost every Telindus device in the directory TMA picture usrdefault typically C Program Files TMA picture usrdefault You can use these files as a template for your customised version of the usr file a EE Note that in the usr files that are present in the directory TMA picture usrdefault some lines are
130. nection 13 2 Failing device selection 13 3 Failing software download 13 4 Other possible problems i Annex B TMA error messages gives a quick overview of the most important TMA error messages Reference manual 213 Troubleshooting TMA 13 1 Failing network connection The following sections list some problems you may encounter when connecting to a device The following table gives an overview of this section rs O OO O 13 1 1 You have problems with a direct connection 13 1 2 You have problems with a dial out connection tata You have problems with an IP connection You have problems with a proxied IP connection 13 1 5 You get a Wrong password message 214 Reference manual TMA 13 1 1 You have problems with a direct connection You try to establish a direct connection but the connection fails Error x Ho response Solution Check the following e ls the cable between the PC running TMA and the device connected at both ends e ls it the correct cable e Did you select the correct COM port e ls the device you are connecting to switched on Reference manual Troubleshooting 215 Troubleshooting TMA 13 1 2 You have problems with a dial out connection You try to establish a dial out connection but the connection fails Error x Mo response Solution Check the following e ls the cable between the PC running TMA and the PSTN modem connected at both ends e ls it the corr
131. nel hence not all FRONT sections have a BUTTONS sub section For more information refer to Section 9 5 The FRONT and REAR section of the usr file This section is the same as the FRONT section but then for the back of the device in the sub system picture For more information refer to Section 9 5 The FRONT and REAR section of the usr file BUTTONS This section defines the extra buttons that can be found at the left hand side of the interactive sub system picture You can add buttons and assign an action to them A Do not confuse this BUTTONS section with the BUTTONS sub section in the FRONT section Whereas this BUTTONS section defines the customised buttons located at the left hand side of the sub system picture the BUTTONS sub section in the FRONT section defines the interactive function of the test buttons on the front panel of the device For more information refer to Section 9 6 The BUTTONS section of the usr file ACTIONS All actions referred to in the sections above are defined in the ACTIONS section For more information refer to Section 9 7 The ACTIONS section of the usr file The definition file def file together with the bitmap files bmp files make up the plain i e without interactivity sub system picture Continued on next page 154 Reference manual TMA The interactive sub system picture The sections of the usr file continued The following figure shows an example of
132. nt link is realised with a cross connect cable between the auxiliary connectors of two modems extended link Se PC running relative 0 relative 1 relative 2 relative 3 TMA To enable relative addressing no address has to be specified in the modem absolute This type of addressing is meant for a network topology where the modems are not connected in line on management level E g when there is a digital multipoint device present digital multipoint example oo V absolute 10 Par Eh J _ example l absolute 20 PC running example example TMA absolute 0 absolute 1 O example absolute 30 To enable absolute addressing an address has to be specified in the modem The absolute addressing range goes from 0 up to 65535 Refer to the user manual of the modem for more information relative and Relative and absolute addressing can be mixed E g use relative addressing for the absolute modems which are connected in line Use absolute addressing for the modems located after a digital multipoint device digital multipoint example oo absolute 1 example absolute 2 Sy Es S A PC running relative 0 relative 1 TMA O example absolute 3 User manual 53 Opening a TMA session Select device selection 6 Exitport E itport TMA If a device has more than one possible way to pass through it to another device the Exitport drop down box is activated The values displayed in the box vary depending to whi
133. o collapse the structure again click on the collapse tool 4 Sorting an expanded structure You can also sort a structure that has been expanded However pay attention where to click in order to sort the table or collapse the structure upper column header collapse the structure extPort 4 exitPiort otNumb Struct gt g Struck lower column header sort the table based on that column exitPort 4 exitPort 4 ortNurnber pF orNurmber User manual 119 The TMA window TMA f Sub value What is a sub value In a structured value you can also encounter a bit lt Struct gt or lt Table gt string This means that there is yet another underlying value also called sub value Example a Select the modem The alarminfo attribute appears in the attribute window object in combination cracusSDSLTT modem Wila the Alain tab Configuration Status 2 Perhormance cl Alarms E Mame Value P oalarmnfo lt Struct gt Select the alarmlnfo The structured value appears in the structured value window attribute alamna 5 curent amp lam previous4larms alarmMask alarmLewel 101 O01 111 z Struct Double click the left The sub value appears in the sub value window mouse button on the F alaminfo currentAlarms structured value currentAlarms BitName Value b LinkDown E P Test ctiwe off P SpnecLoss on 120 User manual TMA The TMA window g Navigation tool H
134. of a device ExtTimeOut 10 This is the timeout in seconds for opening and closing a session The timeout is used during Connect to network and Select device actions When there is no response from the device after this timeout the open and close frames are retransmitted the number of times which is specified in the Retries parameters PollPeriod 30 Once you are connected to a device it is regularly polled to see whether it is still there PollPeriod sets the poll interval in seconds ServerPort 31416 This is the TCP port on which the TMA Comms Handler listens WaitClose 300 The TMA Comms Handler normally closes when all TMA sessions are closed However with WaitClose you can set a timeout in seconds for which the TMA Comms Handler will wait before it really closes down If you restart anew TMA session within this timeout period the rebooting of the TMA Comms Handler will be accelerated This because the TMA Comms Handler was not yet closed down completely The Tftp part The Tftp part contains the following parameters Rexmt 30 Retransmission timeout in seconds for a TFTP connection Timeout 60 Total timeout in seconds for a TFTP connection l e retransmission continues until Timeout has expired Continued on next page 210 Reference manual TMA The Cms2Serv ini file Parts of the Cms2Serv ini file continued The Comm part The Comm part contains the following parameters Speed 9600 This i
135. of the Download window connected ta the device with The download password can be changed below and enter the write access password Password Configuration Options Password Cancel Continued on next page Reference manual 197 Downloading software TMA Downloading firmware continued 198 In the Download window select the TMA Download Options tab Here you can set the following options Password Configuration Options iia Initial speed Maximum speed Window size e Initial speed set the initial transfer speed to 9600 bps i Serial port Maximum speed if you set the neme 9 maximum transfer speed to 115200 bps the actual transfer speed will be negotiated between the computer and i o dees the device and will be between 9600 save Undo bps and 115200 bps Cancel Window size can be set between 1 and 8 Reboot device tick this box when downloading firmware to an Aster 4 Flash any Telindus devices containing only one flash memory bank To verify the amount of flash banks of your device check the status attribute flashVersion in the top object The value of this attribute can be 1 or 2 i e the amount of flash banks This reboot device option is necessary to force the Aster to reboot from the EPROM The Telindus device with one flash bank to go to loader mode before downloading the firmware to the flash bank Save press this button if you
136. om our web site at http www telindusproducts com tma The application and the model files can be installed from three different media e 37 floppy disks e aCD ROM e the Telindus World Wide Web site The following sections give an installation procedure for each medium 6 User manual TMA Installing TMA 2 3 Installing TMA from floppy disks Normally TMA is delivered on CD ROM Exceptionally it is delivered on 3 1 floppy disks This section explains how to install TMA from these disks The following table gives an overview of this section a e Installing the application from floppy disk 8o Installing the model files from floppy disk EM User manual 7 Installing TMA TMA 2 3 1 Installing the application from floppy disk To install the TMA application from the floppy disks proceed as follows Insert the floppy disk labelled TMA in the floppy drive On the taskbar select Start gt Run In the Run window type A setup and click on OK The InstallShield Wizard guides you through the set up process The following figure displays a few steps of the installation procedure Run Type the name of a program folder document or Internet resource and Windows will open it for yau Oper Jac setupl Cancel Browse yaa Aun 8 User manual TMA Installing TMA 2 3 2 Installing the model files from floppy disk To install the TMA model files from the floppy di
137. on output window the help text appears e lt help text gt is the help text You can also refer to a file For more information refer to Section 9 10 The help text e lt action command gt this is the action command that makes up the actual action You can use several action commands in one action Each action command has to be terminated by a semicolon except the loop command For more information refer to Section 9 9 The action commands Make sure the necessary curled brackets commas quotes and semicolons are present else the syntax is incorrect Continued on next page Reference manual 167 The interactive sub system picture The ACTIONS section of the usr file continued Example TMA The following example shows the actions that are used in the examples of the previous sections These actions are e showUpTime refer to Section 9 5 3 The LEDS sub section e startET refer to Section 9 5 4 The BUTTONS sub section e showLineStatus refer to Section 9 5 5 The ALARMPORTS sub section e showID refer to Section 9 6 The BUTTONS section of the usr file ACTIONS 168 showUpTime HELP This displays the system up time SEND select SEND selgrp Status SHOW get systemUpTime startET HELP This starts an error test showLineStatus HELP This displays the status of the line PRINT Starting ET test SEND select SEND select modem SEND se
138. on the shortcut immediately opens a TMA session on the corresponding device User manual 65 Opening a TMA session examples TMA 5 Opening a TMA session examples This chapter gives two examples of how to open a TMA session It gives the screenshots of a filled in Connect Device and Connect Select device window The following table gives an overview of this chapter see Example 1 a direct connection Example 2 an IP connection Example 3 a proxied IP connection Example 4 a dial out connection Some remarks on dial out connections 66 User manual TMA Opening a TMA session examples 5 1 Example 1 a direct connection Suppose you have a set up as described in the figure below 4A a PC running TMA modem A modem B COM port COM2 relative address 0 relative address 1 password 123 password access2 Suppose you want to open a TMA session on modem B The Connect Device and Connect Select device windows look as follows Connect Device window Connect Select device window Address Address Please specify how to reach the device you wish to Choose whether to connect on the network device itself connect to or a device thereafter if so specify its address Serial comz C Dn device f After device Dial out i No T Remote mantenance modem Relative Tel rr a C Absolute C IF address ie Sesion to
139. onfiguration by setting the appropriate DIP switch refer to the user manual of the Crocus Router Interface For additional information on the Crocus HS or Crocus Router Interface refer to the corresponding user manual User manual 43 Opening a TMA session TMA Device selection 6 Password Security Specify the password for connecting to this device This field may be lett open Password ial Enter here the device its password This is the password of the Telindus device through which you want to access the network If no password is specified in the Telindus device leave this field blank 44 User manual TMA Opening a TMA session 4 3 Selecting a device After you established a connection to the Telindus device through which you want to access the network you can choose to open a TMA session on e the device itself e adevice located after the device through which you are accessing your network However the device has to allow this Therefore this chapter first explains when the Connect Select device window appears and when it does not Then it shows how you can open the Connect Select device window in case the currently connected device allows you to do so This chapter also describes in detail the different selection possibilities The following table gives an overview of this section sa oe a When does the Connect Select device window appear Displaying the Connect
140. ons e the Telindus 1035 Orchid the successor of the Orchid 1003 LAN 3 4 3 A management concentrator as a proxy IP device You can connect a Telindus non IP device e g a Crocus modem to a management concentrator In the management concentrator configuration you can assign an IP address to this non IP device In that case the non P device becomes a proxied IP device e you can now access the non IP device over an IP network through the management concentrator In other words the management concentrator acts as proxy IP device for the non IP device This implies that as opposed to the management concentrator the non IP device is not directly connected through a dedicated LAN port to the IP network An example of an IP connection between the computer running TMA and a non IP device is given in the following paragraph 30 User manual TMA Connecting to a device 3 4 4 A proxied IP connection to a non IP device example Consider the following components which have to be interconnected e the computer running TMA e the IP network e aCN4 card nest e a Card Version modem e a Card Version Orchid 1003 LAN The following figure shows the interconnection between these components computer running TMA on an 4 Card Version Orchid fa aa aa ae E pe EEEE HEP ee ET e fam Bee E E r A ata oe eee ee eee eee a ee a iz anaes E pi E Paa ay network port network port 7 r J The following table gives an overvie
141. ow For more information on these structured value types refer to Section 6 5 The attribute window Paragraph c Attribute value 114 User manual TMA The TMA window c Add delete row tools How to add or delete rows in a table Some configuration attributes have a table as structured value In this table you can filter add or delete rows This is done with the structured value tools The following table shows these tools Inserts a row before the current selected row To insert a row proceed as follows e if there are no rows in the table yet just press the nsert row before button if there are already rows in the table select the entire row by clicking on the blue triangle gt press the Insert row before button Insert row after Inserts a row after the current selected row To insert a row proceed as follows e if there are no rows in the table yet just press the nsert row after button if there are already rows in the table select the entire row by clicking on the blue triangle gt press the Insert row after button Delete row Deletes an entire row To delete a row select the entire row by clicking on the blue triangle gt press the Delete row button User manual 115 The TMA window TMA d Filter tool What does the filter tool do The filter tool allows you to filter out rows from a table For example in very long and complex tables it is very useful when you can filter out only those r
142. ow to navigate in the structured value window The example in Paragraph f Sub value shows how to display a sub value Once you reach the lowest possible level you can move up again level by level This is done by the One level up button as shown in the following figure kd alamlnfo currentAlamms n h gt LinkDown E P Test amp ctive off P Synclass on ENE User manual 121 The TMA window TMA 6 8 The status bar This section describes the status bar It explains the status information which is displayed in the status bar The following figure shows the status bar Status message Please walt Retrieving performance attributes of line Busy indication a Status message What is a status message A status message is a message which communicates status information to the user Three different types of messages are displayed in the status bar status message This message gives information about the status of TMA l e it displays what the application is doing Examples Please wait Connecting to network Please walt Retrieving performance attributes of maderi information If you open a menu in the menu bar and place the arrow on a certain command message a short explanation of this command appears in the status bar Example Import l Download Options Exports configuration attributes to file value message If you modify a direct configuration value the status ba
143. own usr file This usr file is loaded and parsed when the sub system picture is evoked When an error is encountered TMA displays an error message and writes the error in the picture og file What is the location of the usr file When TMA is installed a default usr file is installed for each device This offers some standard interactivity to the sub system picture You can find these default usr files in the TMA picture usrdefault directory typically C Program Files TMA picture usrdefault When you want to customise the interactive functions of the interactive sub system picture place a file with the same name as the default usr file in the TMA picture usr directory typically C Program Files TMA picture usr The advantage of this is two fold e The default usr file is separated from the customised usr file which enhances the clarity e Your customised usr file is not overwritten when you install a new version of TMA whereas the default usr files are When the interactive sub system picture is started both files are loaded and parsed Reference manual 151 The interactive sub system picture TMA 9 2 The sub system picture window When you evoke the sub system picture e g by clicking the Subsystem picture button al in the toolbar then the sub system picture window appears 10 0 11 111 OF el A ad oomin oor ut Options Identification ALET test RLET test ABBE M amp S The sub
144. ows that are of interest to you How to filter rows from a table In order to filter rows from a table proceed as follows Click on the filter button An empty row appears at the top of the table In this empty row you can specify the filter criteria As soon as a criterion is entered the row s that meet s this criterion is are filtered Example F objectTable 2 le name centralRemote contigFileName ip4ddress devicel ype hds central hi b1 hdsiSource HI Anei MN eae 10 0 11 101 cme p2 hdzlSink 10 0 11 102 cms pa oAdslbvCernt central lt Upt gt cmse P4 AdelTtRen remote Opt cms p5 wdelTtRene remote Upt gt cmse HE hdltRema remote lt Upt gt cmse The different filter criteria are given below To undo the filtering just press the filter button again The table is displayed completely again Continued on next page 116 User manual TMA The TMA window Filter tool continued What are the possible filter criteria It is possible to filter on character strings integers enumerated values and IP addresses character Either you enter the exact character string or you use the character as wildcard string The latter allows you to filter on parts of a character string Example Before filtering After character wildcard filtering centralA emote i centralA emote hdslSource central hdl them remote hdzlSink remote hdl tRemz remote hdslCvCent central hdl tRema remote hdl tRem
145. pe z i ath e select the choice value gt press the keyboard key F2 gt select a value type THC from the drop down box gt edit the resulting value type F _ TR al e double click on the choice value gt select a value type from the drop down box gt edit the resulting value type e select the choice value gt press the right mouse pdh gt lt Structs button gt select Set To Type gt select a value type pene F from the drop down box gt edit the resulting value piara niee type Modify F2 Set To Default Optional Set lig ne nice Ippe set To Type bandwidth 4 speed Mxb4k E e expand the choice value gt select a value type in the expanded structure gt press the right mouse button gt select Set To This matings Ei Choice Type gt edit the resulting value type Fletrieve Recursive feat F2 Set fio Weal Continued on next page Giptionel Set To This Choice Type Set lig ppe 108 User manual TMA The TMA window Attribute value continued How to edit a configuration attribute value If you have write access to the device you are able to edit the configuration of the device To edit a configuration attribute value either e select the value gt click the right mouse button gt select Modify or e select the value gt press the keyboard key F2 or e double click the left mouse button on the value User manual 109 The TMA window TMA d Attribute status What do
146. performance and alarm are retrieved automatically from the device The configuration attributes are not retrieved automatically 100 User manual TMA The TMA window 6 2 5 The Help menu About displays version information of TMA An example of an About TMA window is given below About TMA Model displays version information of the model files An example of an About model files window is given below THA About Model Files User manual 101 The TMA window 6 3 The toolbar TMA This section describes the icons located in the toolbar It displays the icons and explains their function The toolbar contains the most important TMA commandos represented as icons This enables quick access to these commands The following table lists the icons Connect to device Disconnect from device or application Select device Reconnect to device or application Send all attributes to device Retrieve all attributes from device e ae wa a Export data to file Import data from file Be o_o 02 Press this button to connect to a device Pressing this button brings up the Connect Device window For more information refer to Section 4 2 2 The Connect Device window selections Press this button to disconnect from the current device or application Press this button to select another device on the network you are currently connected to Pressing this button brings up the
147. ple 2 2 card position Also the position of the card in the card nest has to be known for addressing purposes The card slot range goes from 0 up to 14 Check the position of the card in the card nest Enter it in the second field For example 12 3 modem If you want to address a certain device on a multi device you have to specify which device you want to address device A B C or D Verify which device you want to address Enter it in the third field For example B YD For more information on the card nest address and card position refer to the user manual of the CN4 card nest User manual 57 Opening a TMA session TMA Select device selection 7 Non configured device Non configured device HS address 2 12 E Make this selection if you want to open a TMA session on a device Card Version which is inserted in a CN4 card nest connected to a management concentrator through the CN4 its high speed bus but which is not yet configured in the object table of the management concentrator For more information the object table refer to Section 3 4 Proxied IP connection to a non IP device and the user manual of the management concentrator Now specify the hardware address of the device you want to access with TMA This is of the same form as the hardware address HWA in the Exitport drop down box e field 1 rack address ranges from 0 up to 6 e field 2 card position ranges from 0 up to 14 e field 3 mo
148. pped with a Crocus Router Interface The configuration of the Router Interface is still in its default state i e no IP address no subnet mask etc You want to access the Router Interface with TMA in order to edit its configuration Proceed as follows In the Connect Device window make the IP address selection Enter the IP address you want to temporarily assign to the Crocus Router Interface Tick the Assign to MAC selection box Enter the MAC address of the Crocus Router Interface Enter the subnet mask that corresponds with the previously entered IP address Hit the Next button gt The TMA window opens and displays the containment tree of the Crocus Router Interface The previously entered IP address is now temporarily assigned to the Crocus Router Interface Temporarily because you will see the IP address in the Status group but not in the Configuration group When the Router Interface reboots the IP address is lost You now permanently assigned an IP address to the Crocus Router Interface From now on you are able to access the Router Interface just by typing its IP address in the Connect Device window In order for the Assign to MAC option to work e your computer running TMA has to be connected to the same IP segment as the Crocus Router Interface e the configuration of the Crocus Router Interface has to be in its default state as it leaves the factory If it is not reload its default c
149. r and the underlying pull down menus THA comi rel About Connect Edit View Tools Helbp p Model Export Import Download Options w Toolbar W Statusbar W Structured Values W Advanced Subsystem Picture Ctrl F Retrieve F5 Modify F2 Set To Default Select All Chrl 4 Device Ctre Select device Ctrl D Application Disconnect Reconnect Chrl F Add Alias Chrl L 1 10 0 11 250 2 com rel 3 comerell 4 comlrell More Ctrl E xit 76 User manual TMA The TMA window 6 2 1 The Connect menu Device Ctrl Select device Ctrl D Application Disconnect Reconnect Chrl F Add Alias Chrl L 1 10 0 11 250 2 cond rely 3 comerell 4 comi reli More Chrl h Exit The following table lists and describes all the commands of the Connect menu Device Use this command to connect to a device Selecting this command brings up the Connect Device window The shortcut key for this command is CTRL N For more information refer to Section 4 2 2 The Connect Device window selections Select device Use this command to select another device on the network you are currently connected to Selecting this command brings up the Connect Select device window The shortcut key for this command is CTRL D For more information refer to Section 4 3 3 The Connect Select device window selections Application
150. r displays e which type of value you have to enter character string integer real e the value range Examples Character String Size 0 64 Integer Walue 1 255 Real Walue 2e 003 12 005 122 User manual TMA The TMA window b Busy indication This square lights up when the application is busy During that time you can not work in the TMA window l e you can not change groups change an attribute value Once the colour disappears TMA is available again User manual 123 124 Reference manual Reference manual TMA Reference manual 125 User instantiatable object TMA 7 User instantiatable objects This chapter explains what user instantiatable objects are It also explains how to add and remove user instantiatable objects The following table gives an overview of this chapter ce O O e What is a user instantiatable object Adding a user instantiatable object Removing a user instantiatable object 126 Reference manual TMA User instantiatable object 7 1 What is a user instantiatable object On some device e g the Telindus 1421 SHDSL Router some objects are not present in the containment tree by default If you want to use the features associated with such an object then you have to add the object first An object that can be added by the user is called a user instantiatable object Also referred to as a child object because it is added under a parent object Reference
151. re to a Telindus device using TMA First it explains how to download new firmware in the flash memory of a device Then it shows how to download files to the file system of a device The following table gives an overview of this chapter Downloading firmware to the flash memory Downloading files to the file system 200 Remarks on downloading files to the file system 196 Reference manual TMA Downloading software 10 1 Downloading firmware to the flash memory The Telindus devices have a flash memory containing firmware This firmware gives the devices their features This firmware evolves continuously as new features are added or changed You may want to download new firmware to a Telindus device to give this device the latest features This section explains how to download new firmware You can not download firmware to a non IP device over a proxied IP connection Use the firmware distribution feature of the Orchid for this purpose refer to the user manual of the Orchid Supposing a connection is present between the computer running TMA and the Telindus device the download procedure is as follows In the menu bar select Tools gt Download gt The Download window appears If you are connected to the device with TMA Download e write access then immediately go to step 3 read only access then first select the Downloading files ta a device may require a password that is different from the password you Password tab
152. reach the device you wish to connection does not allow you to open TMA connect to r i sessions on devices behind the non IP device in C Serial com il question Mial out fE flo T ESIN modem T Remote mamtenance modem ellr f Paddress 10 0 11 15 T Assign to MAC T ee a E Subnet mask Security Specity the password for connecting to this device This field may be left open Password Back Cancel User manual 69 Opening a TMA session examples TMA 5 4 Example 4 a dial out connection Suppose you have a set up as described in the figure below built in PSTN modem on J coma DTE interface PSTN modem 1 Orchid 1003 LAN high speed bus ie _ connection control port rack address lt 3M E EEEE EEEE Card Version modem position 5 modem B Table T relative address 0 ADA TOP MAARN password 123 relative address 1 password access2 Suppose you want to open a TMA session on the Table Top modem The Connect Device and Connect Select device windows look as follows Connect Device window Connect Select device window Address Address Please specify how to reach the device you wish to Choose whether to connect on the network device itself connect to or a device thereatter if so specify its address Serial coma C Dn device f
153. remote AsterT ba remote hdl them remote p 10 sterTtB remote hdelTtRems remote Asker CvA central AsherT ba remote AsterlyB central p 10 AsterTtB remote Enter the integer based upon which you want to filter You cannot use a wildcard enumerated Select a value from the drop down box value Example Y object able Ga centralfemate b1 hdalSouce MIENNE O H3 hdalCvCent Lente Pro Asterlva central IP address Enter the IP address based upon which you want to filter You cannot use a wildcard l e you have to enter the complete exact IP address User manual 117 The TMA window TMA e Sort expand and collapse tools Sorting a table What is the sort tool When clicking on a column header in a table the table is sorted based on that column When the following indication appears e athen the column and hence the table is sorted ascending This means the entries that begin with special characters come first then those with numbers from 0 to 9 and finally those with letters from a to Z e w then the column and hence the table is sorted descending This means the entries that begin with letters from z to a come first then those with numbers from 9 to 0 and finally those with special characters Just by clicking the column header you can switch between ascending or descending sorting To undo the sorting just click on another attribute and then click on the table again Example The following ta
154. rrors common These are some common definitions sysContact ISP Tel 784512 _ Helpdesk Tel 1100 SysAdmin sysLocation Main building equipment room Remote building management alarmFilte lt lowFilter 0 mediumFilter 5 highFilter 10 crocusHDSLTT The definition of the LinkDown alarm applies on both lines The definition of the SeverelyErroredSecond alarm applies on line 1 only line 1 alarmLevel LinkDown low 0 medium 5 high 10 modem line 1 alarmLevel SeverelyErroredSecond low 0 medium 5 high 10 This results in the following custom l og file 14 33 53 parsing file C Program Files TMA config custom txt line 3 error in valuelist of definition line 4 error in definition line 5 error in definition line 9 error in attribute part of definition The following table describes the errors FS a a There is no comma between the two consecutive values The double point has to be an equal sign The equal sign is not present It is not allowed to use an indexed object in a relative path line 1 alarmLevel LinkDown should be line alarmLevel LinkDown Reference manual 147 User defining values using the custom txt file TMA 8 7 4 Remarks on the custom log file Remark 1 TMA is unable to detect errors in the syntax of the object attribute or element names Example If you type syContact instead of sysContact
155. s using TMA TMA CLI ATWIN CLI Web Interface etc has been reached on the device Solution Close one or more management sessions Annexes 241 Annex B TMA error messages TMA Edit errors The following table lists some error messages you may encounter when editing values Error message Cause Solution Invalid IP Address Cause Invalid number of Days Invalid number of hours These error messages indicate that the value you tried to enter is incorrect or out of range or you Invalid number of minutes tried to change a read only attribute Invalid number of seconds Invalid value Solution Value is out of range Carefully check the value you entered Attribute is read only 242 Annexes TMA Annex B TMA error messages Export errors The following table lists some error messages you may encounter when exporting to a file Error message Cause Solution Export failed Could not create the export file Cause Nothing to export Permission denied These messages indicate that something went wrong during the export process you did not The specified file could not be opened select any attributes for export you only have read only access to the device or that the file you want to export to is read only Solution Retry to export the file Make sure you make a selection Make sure you have full access to the device Make sure you have write access to the file you want to export to Annexes 243 Ann
156. s the COM port speed in bits per second NormTimeOut 8 Normal CMS2 retransmission and reply timeout in seconds for a serial connection The LAN part The LAN part contains the following parameters Parameter Pp Description ee 10 Normal ee retransmission and reply timeout in seconds for an IP connection Reference manual 211 The Cms2Serv ini file TMA 12 2 Adding parts to the Cms2Serv ini file You can set specific communication parameters for each IP address or COM port The communication parameters in this specific part overrule those in the general part of the Cms2Serv ini file Example Suppose you want to change the following parameters e NormTimeOut for IP address 194 7 26 4 e Speed for COM port 2 Proceed as follows For the part Proceed as follows Copy the Comm part and paste it at the end of the Cms2Serv ini file Rename Comm to Comm_2 Delete all the parameters except Speed Change the Speed value from 9600 to for instance 57600 The added parts are then as follows LAN_194 7 26 4 NormTimeOut 30 Comm_2 Speed 57600 212 Reference manual TMA Troubleshooting 13 Troubleshooting This chapter lists some problems you may encounter with a TMA session It also gives a possible solution to the problem If this chapter does not help to fix your problem contact your distributor The following table gives an overview of this chapter be Failing network con
157. sages Connect errors The following table lists the error messages you may encounter when connecting to a device Error message Cause Solution Bad hardware address Cause Bad HS address These error messages indicate that you made an Bad IP address incorrect entry in the Connect Device Bad MAC address window or the Connect Select device Bad NMS address window Bad subnet mask Invalid or missing IP address Missing NMS address Carefully recheck the entries you made in these Missing telephone number windows Refer to Section 4 2 2 The Connect Not a valid application address Device window selections and Section 4 3 3 Please choose serial or IP The Connect Select device window Solution Please specify an application address or selections choose Cancel Unknown error Please reconnect Cause The connection to the device was lost Please reconnect The connection to the network was lost Please reconnect These error messages indicate that at a certain moment the connection towards the device or network was lost Solution Try to reconnect by using the Reconnect button If this does not work close and restart TMA Then try to reconnect If you still have problems refer to Section 13 1 Failing network connection and Section 13 2 Failing device selection e Session open by someone else Cause This error message indicates that the maximum number of management session
158. se the command syntax is tma test device tma alias Connects you to the device for which this alias was created Use this command DEE when the network password and the device password are the same For more information on passwords refer to Section 4 3 3 The Connect Select device window selections Paragraph Select device selection 8 Example Suppose you created for a certain device the alias Test device Suppose the password 12 34 is defined in this device In this case the command syntax is tma test device 12 34 tma alias Connects you to the device for which this alias was created Use this command A Caen when the network password differs from the device password For more information on passwords refer to Section 4 3 3 The Connect Select device window selections Paragraph Select device selection 8 Example Suppose you created for a certain device the alias Test device Suppose the password 12 34 is defined in this device Suppose you connect to the network through a device with password 56 78 In this case the command syntax is tma test device 5678 12 34 64 User manual TMA Opening a TMA session 4 4 4 Creating TMA command line shortcuts The command line syntax allows you to create shortcuts This means that you have immediate access to a device just by clicking on its icon on your desktop The following procedure explains how to create such shortcuts Go to
159. service Solution Close TMA and the TMA comms handler and restart TMA If this does not help try to re install TMA This indicates that the TMA application is unable to communicate with the TMA comms handler Also refer to Section 13 4 1 You get a Server not available error message 248 Annexes TMA Annex C product information Annex C product information The following table displays the product information of TMA related products 156986 TMA_HP OV WINDOWS SOLARIS HP UX Demo version for SUN Solaris Windows NT and HP UX max DEMO VER 8 IP Adresses supported 156689 TMA_HP OV WINDOWS NT ENTRY Telindus Management Application for HP Openview on LEVEL VER Windows NT SNMP Up to 250 IP Adresses supported 3 years Maintenance contract for TMA_HP OV mandatory 156690 TMA_HP OV WINDOWS NT UNLIMITED Telindus Management Application for HP Openview on VER Windows NT SNMP No limit on IP Adresses supported 3 years Maintenance contract for TMA_HP OV mandatory 156685 TMA_HP OV SUN SOLARIS ENTRY Telindus Management Application for HP Openview on SUN LEVEL VER Solaris SNMP Up to 250 IP Adresses supported 3 years Maintenance contract for TMA_HP OV mandatory 156686 TMA_HP OV SUN SOLARIS UNLIMITED Telindus Management Application for HP Openview on SUN VER Solaris SNMP No limit on IP Adresses supported 3 years Maintenance contract for TMA_HP OV mandatory 162845 TMA_HP OV HP UX ENTRY LEVEL VER Telindus Management Appli
160. size of TMA and the model files as it was when this manual was written For future releases of TMA this figure may be incorrect User manual 5 Installing TMA TMA 2 2 The TMA application and model files The Telindus Maintenance Application comprises two components This section introduces these components TMA can be divided into two components re e the application This is the TMA program itself also called TMA engine By default the application is installed in the following directory and its subdirectories C Program Files TMA the model files Each Telindus device has its own model file This file contains the information TMA needs to connect to the device and exchange information with the device The model files are installed separately from the application This because the model files evolve as the device evolves The model files delivered with the device correspond with the latest firmware of the device This means that if you add devices to your network containing more recent firmware than the current devices then the model files may have to be re installed The model files are backwards compatible This means that the latest model files support not only the latest but also all previous firmware revisions of the device By default the model files are installed in the following directory and its subdirectories C Program Files TMA QG The latest versions of TMA and the model files can always be downloaded fr
161. sks proceed as follows Insert the floppy disk labelled TMA Model Files in the floppy drive 2 On the taskbar select Start gt Run In the Run window type A setup and click on OK The InstallShield Wizard guides you through the set up process User manual 9 Installing TMA TMA 2 4 Installing TMA from CD ROM This section explains how to install TMA from the CD ROM The following table gives an overview of this section Le e 2 4 1 Installing the application from CD ROM Installing the model files from CD ROM 10 User manual TMA Installing TMA 2 4 1 Installing the application from CD ROM To install the TMA application from the CD ROM proceed as follows Insert the CD ROM in the CD ROM drive Windows automatically displays a HTML page where you can select from the following onion ates tivopiontes DOWNLOAD LATEST TMA FROM THE WEB download the most recent TMA program and or model files from the Telindus web site CREATE FLOPPIES FOR TMA create installation floppies for TMA This enables you to distribute TMA on floppy disks for installation purposes 1 On the taskbar select Start gt Run 2 In the Run window type X StartHtml where X is the letter of your CD ROM drive 3 Click on the OK button The InstallShield Wizard guides you through the set up process The following figure displays a few steps of the installation procedure TELiNDUS Www TELINDUS COM PRODUCT IN
162. so set the attributes cardnestAddress cardPosition and modem portNumber Use this attribute to specify through which asynchronous port of the management concentrator the non IP device can be reached cardnestAddress_ Use this attribute to specify the CN4 Card Nest address in which the non IP device Card Version resides cardPosition Use this attribute to specify the position of the non IP device Card Version in the CN4 Card Nest modem Use this attribute to select the device on the non IP multi device Card Version Twin Quad etc A B C or D Once these attributes are set then the computer running TMA is able to reach the non IP device over an IP network E User manual 33 Opening a TMA session TMA 4 Opening a TMA session Once the physical connections are made you are able to open a TMA session on a Telindus device First this chapter explains how to start TMA Then it describes how to connect to the network and how to select a device on this network The following table gives an overview of this chapter Title 34 User manual TMA Opening a TMA session 4 1 Starting TMA Before a TMA session can be opened the application itself has to be started To start TMA proceed as follows a On the taskbar select Start A In the start menu select Programs 3o In the program menu select the program group TMA 4 In the program group TMA select TMA gt The TMA window appears A ACCeSsOnes k
163. sub system picture 9 9 1 Important remarks on action commands The commands are case sensitive Every command line has to be terminated by a semicolon some commands have to be used in combination with CLI Command Line Interface commands Also see the next remark For more information on CLI and its syntax refer to the Maintenance tools manual lf a CLI command has a value that contains characters that conflict with the normal CLI syntax such as a comma a Space an equal sign etc then you have to surround the value by a set of double quote characters Also see the next remark E g set crocusSDSLTT sysLocation Main building room 21D Interactive sub system picture command values always have to be surrounded by a set of double quote characters E g SEND set crocusSDSLTT modem channel central However as seen in the previous remark sometimes you have to use quotes within the value string This is only possible by placing a backslash before each quote within the value string Example If you want to set the sysLocation attribute with a value that contains special characters then you have to quote the sysLocation value These quotes on their turn have to be preceded by a backslash In other words donottype SEND set crocusSDSLTT sysLocation Main building room 21D buttype SEND set crocusSDSLTT sysLocation Main building room 21D Another example
164. system picture window has the following buttons Click on this button to double the size of the sub system picture Zoom Out When you are zoomed in click on this button to reduce the sub system picture to its original size Options Click on this button to display the Options window Here you can specify the interval between two consecutive refreshes of the sub system picture E g a period of 1x10 sec means that every 10 seconds TMA will refresh the picture Click on this button to close the sub system picture window 152 Reference manual TMA The interactive sub system picture 9 3 Creating a usr file The best way to create your customised usr file is as follows Go to the directory TMA picture usrdefault typically C Program Files TMA picture usrdefault Search the default usr file that belongs to the Telindus device for which you want to customise the interactive sub system picture E g if you want to customise the sub system picture of the Crocus SDSL Table Top then crocusSDSLTT usr is the file you are looking for Copy this file and paste it in the directory 7MA picture usr typically C Program Files TMA picture usr Open the usr file and edit it with a plain text editor using the syntax as described in the following sections The customised usr file has priority over the default usr file So if the default usr file and the customised usr file define a similar interactive function but with
165. t alarm status Important remark The sub system picture only displays the unmasked alarm status l e only alarms that are unmasked in other words the alarm is set to enabled in the alarm mask of a certain object are shown in the sub system picture The following shows you the sub system picture of the Crocus SDSL TT and indicates which elements are alarm ports and which not alarm port line object BREE a g not an alarm port because no alarm port alarm port alarm status is associated lt interface gt object modem object with these interfaces e g v35 object 158 Reference manual TMA The interactive sub system picture 9 5 3 The LEDS sub section For an introduction on the LEDS sub section refer to Section 9 5 1 Sub sections of the FRONT and REAR section The LEDS sub section syntax A LED interactivity specification has the following syntax LEDS lt hED 10entirier gt ACTION lt action name gt HELP lt xhelp text where e LEDS is the front panel LEDs section header e lt LED identifier gt Is the identification of the LED in the sub system picture as defined in the definition file def file e ACTION assigns a certain action to the LED e lt action name gt is the name of an action that is defined in the ACTIONS section refer to Section 9 7 The ACTIONS section of the usr file It is this action that is assigned to the corresponding LED The action name may no
166. t contain spaces and may not be quoted e HELP assigns a tooltip to the LED The tooltip pops up when you move the arrow over the LED e lt help text gt is the text of the tooltip You can also refer to a file For more information refer to Section 9 10 The help text Make sure the necessary curled brackets commas quotes and semicolons are present else the syntax is incorrect Continued on next page Reference manual 159 The interactive sub system picture TMA The LEDS sub section continued Example The following example assigns the action showUpTime to the power LED Also a tooltip is assigned to this LED FRONT LEDS LEDPower ACTION showUpTime HELP Click to display the system up time i This results in the following TEL NDUIS crocus sos 142 aI 105 PWR TST ERR TsO 20 FAD aay Om Click to display the system up time CEL Ml E PWR j ira L AutoScrall End Loop Help e systemUpTime 0d 01h 48m 175 Close 160 Reference manual TMA The interactive sub system picture 9 5 4 The BUTTONS sub section For an introduction on the BUTTONS sub section refer to Section 9 5 1 Sub sections of the FRONT and REAR section The BUTTONS sub section syntax A front panel test button interactivity specification has the following syntax BUTTONS lt SULCOM tdentilraer gt ACTION lt xaction name gt HELP lt nelp text gt wher
167. t is missing LEDPower ACTION showUpTime HELK BUTTONS keyboardState 0 ACTION GtartED HELP Start an End to End test REAR ALARMPORTS i TO IS missing modem ACTION showStatus HELP View ala info and status of the een s BUTTONS Identification ACTION showID HELP View identification parameters ACTIONS showUpTime SEND select SEND selgrp Status SHOW get systemUpTime is missing showStatus startET action is not defined in ACTIONS section SEND select SEND Selgrp Status SEND select modem SHOW get SEND select line SHOW get showID SEND select SEND selgrp Status SHOW get Continued on next page 194 Reference manual i TMA The interactive sub system picture Example of a picture log file continued When evoking the sub system picture you get an error message and the following is written into the picture log file 7 ERROR bad argument for HELP expected FROMFILE or string 19 ERROR missing 33 ERROR unknown command 33 ERROR unknown command 34 ERROR unknown command The following table describes the errors The HELP command is present but no source text This should either be a quoted string or a FROMFILE Command with a reference to a file containing the help text This line should be ended with a semicolon 33 and 34 These errors are a result of the missing closing
168. tart TMA from the command line This section explains how you can do this But before you can actually start TMA from the command line you have to do some preparatory work The following table gives an overview of this section es e Before starting TMA from the command line User manual 61 Opening a TMA session TMA 4 4 1 Before starting TMA from the command line To start TMA from the command line you have to use aliases When you install TMA for the first time no aliases are present This means you have to create them The following procedure explains how to create aliases Start the TMA application as explained in Section 4 1 Starting TMA Connect to a device as explained in Section 4 2 Connecting to a device Create an alias e g Test device for this device as explained in Section 6 2 1 The Connect menu Paragraph b Creating aliases on page 79 Select a device as explained in Section 4 3 Selecting a device Now you are ready to start TMA from the command line 62 User manual TMA Opening a TMA session 4 4 2 Displaying the TMA command line help In order to display the different TMA command line possibilities open a DOS window and type tma h The following is returned z interactive use show this help message Calso H zh 779 connect to this alias using empty passwords netpw connect with this network password alias netpuw devpw connect with this network and device password an
169. tate apah ame Crocus SDSL Table Top 1 apsLontact System Administrator telephone 362499 ssLocation Main building room 210 security lt Tabler bootFromFlash Auto forwardTMATONMSPart enabled Attribute value forward MAT oLine alarmbl ask alarmLewel alarmContactHighhl ask alarmContactLowh ask enabled 111111111 lt Struck OOOO00000 OOOO00000 Attribute status a Attribute What is an attribute An attribute is a parameter which is related to a certain object It has a certain value which e can be changed in case of a configuration attribute provided you have write access e is read only in case of a status performance and alarm attribute Example The object modem contains the configuration attribute channel Its value can be set to central or to remote b Attribute position Here you can see the position of the attribute in the containment tree Example If the attribute position displays CrocusSDSLTT modemiline it means that the attribute window currently displays the attributes of the line object which is part of the modem object which is part of the top object CrocusSDSLTT User manual 105 The TMA window TMA c Attribute value What is an attribute value An attribute value is located behind the attribute name Basically there are two different value types e asimple value this is a value which is displayed in the attribute window e a structured value this is a list of values which is disp
170. te alarmFilter Suppose you want to do this for all devices that have the attribute alarmFilter in their management object In that case include the definition in the common section and format it as in the example Suppose that you have an Orchid 1003 LAN to which only a limited number of different types of devices are connected e g only Crocus HDSL modems In that case you could predefine the names of these Crocus HDSL modems as in the example In that case you can quickly fill in the objectlable by selecting the names from the drop down box and just changing the x in an integer e g HDSL cv central 1 Or HDSL TT Remote 5 Also the name element in the downloadTable can be formatted in this way For the sourceFile element of the downloadTable you can predefine several firmware file names crocusHDSLTT Suppose that for the Crocus HDSL TTs you want to give an understandable name to the values of the elements LinkDown and SeverelyErroredSecond of the alarmLevel attribute of the line objects However suppose you want the LinkDown definition to apply to all line objects but the SeverelyErroredSecond definition to apply to line 1 only In that case format the definition as in the example Reference manual 143 User defining values using the custom txt file TMA 8 7 Reading the custom log file The custom txt file is loaded and parsed when TMA starts When an error is encountered TMA displays an error message and writes the error in the
171. ted string e arfile The following table gives an overview of this section 9 10 1 Help as a tool tip 9 10 2 Help in a help window 9 10 3 A quoted string as help text source 9 10 4 A file as help text source Page 185 186 187 188 184 Reference manual TMA The interactive sub system picture 9 10 1 Help as a tool tip In this case the help is assigned to a LED button or alarm port It appears when you move the pointer over such an item The syntax can be seen in the example below FRONT LEDS lEDPower ACTION getUpTime HELP Click to see sysUpTime BUTTONS keyboardState 0 ACTION startET HELP Click to start ET test REAR ALARMPORTS modem ACTION showModemStatus HELP Click to see modem status In the sub system picture these tool tips would appear as follows 10 0 11 111 Iof x oh Si 4 oomin oom ut Options eee CERTE PWE TST ERR THO 20 FESO ET aL FDOL OL Click to see sysUpTime Click to start ET test Click bo see modem status Reference manual 185 The interactive sub system picture TMA 9 10 2 Help in a help window In this case the help is assigned to an action which on its turn is assigned to a LED button or alarm port of the sub system picture It appears when you click the Help button in the output action window refer to Section 9 8 The action output window The syntax can be seen in the example below ACTIONS s
172. ters that conflict with the normal syntax such as a comma a space an equal sign etc Use the STRING encoding instead Example sysContact sysAdmin Make sure that the length of the string does not exceed the maximum allowed length as defined in the model Continued on next page 140 Reference manual TMA User defining values using the custom txt file String and integer values continued integer For integers the value consists of two parts e auser defined name which can again be a STRING or IDENTIFIER see above e the actual value for which this name is defined Examples management alarmFilter low 0 management alarmFilter low Sensitivity filter 0 management alarmFilter lows i 0 Reference manual 141 User defining values using the custom txt file TMA 8 6 An example of a custom txt file The following shows an example of a custom txt file common These are some common definitions sysContact ISP Tel 784512 Helpdesk Tel 1100 SysAdmin sysLocation Main building equipment room Remote building management alarmFilter lowSenseFilter 0 mediumSenseFilter 5 highSenseFilter 10 01003 nmsgroup objectTable name HDSL CV Central x HDSL TT Central x HDSL TT Remote x nmsgroup objectTable configFileName HDSLCVCentral cms HDSLTTCentral cms HDSLTTRemote cms deviceSoftware downloadTable name HDSL CV Central
173. test error best ee MEE 7 Output AEE X a bk pooo 7 hace coll End Loop Help E Starting ET test E testType ET test P FestOriginator nmstst b Press End Loop to terminate action b testStakus running E errorlount 65535 162 Reference manual TMA The interactive sub system picture 9 5 5 The ALARMPORTS sub section For an introduction on the ALARMPORTS sub section refer to Section 9 5 1 Sub sections of the FRONT and REAR section The ALARMPORTS sub section syntax A alarm port interactivity specification has the following syntax ALARMPORTS lt alarmport identifier gt ACTION lt action name gt HELP lt help text gt where e ALARMPORTS Is the alarm port section header e lt alarmport identifier gt Is the identification of the alarm port in the sub system picture as defined in the definition file def file e ACTION assigns a certain action to the alarm port e lt action name gt is the name of an action that is defined in the ACTIONS section refer to Section 9 7 The ACTIONS section of the usr file It is this action that is assigned to the corresponding alarm port The action name may not contain spaces and may not be quoted e HELP assigns a tooltip to the alarm port The tooltip pops up when you move the arrow over the alarm port e lt help text gt is the text of the tooltip You can also refer to a file For more information refer to Section 9 10
174. the Run window type regedit and click on OK The registry editor opens The TMA entries in the registry The following entries are added to the Microsoft Windows registry when TMA installs e HKEY LOCAL MACHINE gt SOFTWARE gt Microsoft gt Windows gt CurrentVersion gt App Paths es TMA Model Files TMA exe possible other TMA related applications e g TmaCli exe e HKEY LOCAL MACHINE gt SOFTWARE gt Microsoft gt Windows gt CurrentVersion gt Uninstall gt TMA Model Files IMA exe possible other TMA related applications e g TmaCli exe e HKEY LOCAL MACHINE gt SOFTWARE gt Telindus gt TMA gt lt version e g S0004 xxx00 gt TMA Model Files gt lt version e g S0011 xxx00 gt possible other TMA related applications e g Tmacli gt lt version e g S0106 xxx00 gt 20 User manual TMA Connecting to a device 3 Connecting to a device Once the TMA application and the model files are installed you are ready to interconnect the computer running TMA and a Telindus device This is explained in this chapter First the terms P device proxied IP device and non P device are explained for they are used in this and the following chapters The following table gives an overview of this chapter What are IP proxied IP and non IP devices IP connection to an IP device 4 Proxied IP connection to a non IP device a User manual 21
175. the directory where the TMA executables are located If you did not change the default file location during the set up then this directory is C Program Files TMA bin Make a shortcut of the TMA exe file and E Ga C Program Files TMA bin for instance place it on your desktop Open Scan for Viruses AE Quick View Tmathe Add to Zip ET mal tee add to TMA 2p C tmlexe E Zip and E Mail TMA zip A trl d 3 Floppy A Desktop create shortcut Create Shortcut Delete Rename Properties Display the properties of the shortcut TMA exe Properties General Shortcut aj TMA exe Target type Application Target location bin Target Start in C Program Files TMA bin Shortcut key None Bun Normal window sO Find Target Change Icon Edit the Target field of the Properties window as follows 1 Before editing the Target field displays the following string C Program Files TMA bin TMA exe 2 Add the TMA command line syntax to this string C Program Files TMA bin TMA exe alias netpw devpw Example Suppose you created for a certain device the alias Test device Suppose the password 12 34 is defined in this device Suppose you connect to the network through a device with password 56 78 In this case the Target field string has to edited as follows C Program Files TMA bin TMA exe test device 56 78 12 34 Rename the shortcut E g Test device Double clicking
176. the file when running CLI on the devices themselves through a terminal or Telnet session you can use the file when running TMA CLI on your computer Important remarks e The purpose of the CLI import is to distribute configurations Not to run scripts as in CLI or TMA CLI When you edit the CLI file yourself make sure that you never use the commands disconnect and exit This closes the CLI core and gives unexpected results CSV performance You can export the performance attributes to a text file This is particularly attributes interesting for documentation purposes In contrast with the TXT file the CSV file is not a plain text file It is a comma separated value file This because performance information consists of a lot of tables which could result in a very complex text file A CSV file has the advantage that it can be easily imported in a spreadsheet or database for further processing User manual 91 The TMA window TMA Export selection 4 Append M Append Tick this box if you want to add the data you are about to export to an existing export file The new export data is inserted at the end of the file 92 User manual TMA The TMA window Export selection 5 Full configuration f Full configuration This selection is only available when you export the configuration attributes When exporting toa e TXT file tick this box if you want to export all the configuration attributes instead of only the configur
177. the structure of a usr file COMPONENT crocussDSLTtT FRONT LEDS lEDPower HELP lLEDL42Test HELP Off No test is active nln A front panel or interface test is active nBlinking A test iniated by the management system is active nFlashing A front panel test has been terminated by the management system a ot BUTTONS keyboardstate 0O ACTION startET HELP Start an End to End test SiC x REAR ALARHPORTS modem ACTION showStatusModem HELF View alarm info and status of modem moden line ACTION showStatusLine HELP View alarm info and status of line BUTTONS Identification ACTION showIdentification HELP View identification parameters Pils au ACTIONS showidentification HELP You can customise yourself the behaviour of the ninteractive subsystem picture To make changes nplease consult the THA user manual and edit the nfile 4 TMA picture usricrocusspSLTT usry SEND select sT SEND selgrp Edit Configuration SHOW get SEND selqrp Status SHOW qet etc l Reference manual 155 The interactive sub system picture TMA 9 5 The FRONT and REAR section of the usr file For an introduction on the FRONT and REAR section of the usr file refer to Section 9 4 The sections of the usr file This section describes the front and rear section of the usr file It lists the possible sub sections and what the syntax is wi
178. thin such a sub section The following table gives an overview of this section 9 5 4 The BUTTONS sub section 161 9 5 5 The ALARMPORTS sub section 163 156 Reference manual TMA The interactive sub system picture 9 5 1 Sub sections of the FRONT and REAR section The front and rear section can contain up to three sub sections re ee In this sub section you can assign an interactive function to each LED of the sub system picture For more information refer to Section 9 5 3 The LEDS sub section BUTTONS In this sub section you can assign an interactive function to each front panel test button of the sub system picture G Not all devices have test buttons on the front panel hence not all FRONT sections have a BUTTONS sub section For more information refer to Section 9 5 4 The BUTTONS sub section ALARMPORTS _ In this sub section you can assign an interactive function to each alarm port of the sub system picture For more information refer to Section 9 5 2 What is an alarm port and Section 9 5 5 The ALARMPORTS sub section Reference manual 157 The interactive sub system picture TMA 9 5 2 What is an alarm port An alarm port e basically is an interface of the device e often associated with a connector e always associated with a certain object in the containment tree e has an alarm status Hence an alarm port can be given a colour in the sub system picture corresponding to its curren
179. ucts HOME PRODUCTS amp SERVICES NEWS EVEN Telindus Maintenance Application Winzip Selt Extractor Nico Mak Computing Inc http iws winzip com e Functional description File name S0004010 exe Save e Software Download ere a Save as type Application Cancel agree s MA part 2 e MA software part 1 mnanda ncldedi rey UT 174 FEYTE e TMA software part dt idata files UNIS rev 015 2565 KByte 14 User manual TMA Installing TMA 2 5 2 Installing the model files from the web site To install the TMA model files from the Telindus web site proceed as follows Open your web browser and enter the following address http www telindusproducts com tma Read the License Agreement for Telindus software carefully e lf you agree with the terms stated in the agreement click on agree e lf you do not agree with the terms stated in the agreement click on dont agree Save the executable file S007 1xxx exe where xxx stands for the revision to a temporary directory on your hard disk For instance C femp S0011020 exe 5 In this temporary directory double click on the executable file S0011xxx exe The InstallShield Wizard guides you through the set up process 1 Click on the link TMA part 2 data files rev xxx xxxx KByte User manual 15 Installing TMA TMA 2 6 Location of the TMA files If you did not change the default file location during the set up then the TMA related d
180. ue AT amp D1X4E0V0Q0 where D specifies pulse dialling However it is possible to overrule this by adding the AT command T before the telephone number entered in the Tel nr field This is shown in the following figure Dial out C No f PSTN modem i Remote maintenance modern Telnr T382499 i Depending on the AT command you can place the command before or behind the telephone number 72 User manual TMA Opening a TMA session examples 5 5 2 Speed data format and connection messages To make sure the dial out connection is established successfully some parameters have to be set to a certain value This is explained by means of the following example Example Suppose you have a set up as shown in the figure below link speed negotiation COM 1 PSTN modem 1 PSTN modem 2 Ly x gm oe S E PC running TMA DTE interface 1 DTE interface 2 Orchid 1003 LAN control port Going from local side utmost left side to the remote side utmost right side the following things have to be configured COM1 As default the speed parameter for COM1 in the Cms2Serv ini file is 9600 bps DTE interface 1 Because the speed of COM1 is 9600 bps also set the DTE interface 1 speed to 9600 bps Set the data format to 8 N The AT commands on DTE interface 1 have to be result codes on ATQO short result codes ATVO echo off ATEO By default this is so because the DialPrefix parameter in the TMA in
181. ult Configuration SEND set crocusSDSLTT sysName 1 ARG System Name PRINT The sysName set to SHOW get crocusSDSLTT sysName SEND set crocusSDSLTT sysContact 1 ARG System Contact PRINT The sysContact set to SHOW get CcrocusSDSLIT sysContact SEND set crocusSDSLTT sysLocation 1 ARG System Location PRINT The sysLocation set to SHOW get crocusSDSLTT sysLocation PRINT Setting the channel to central SEND set crocusSDSLTT modem channel central PRINT Setting the speed to 2304000 bps SEND set crocusSDSLTT modem line speed 2304000 bps PRINT Setting the clocking to external SEND set crocusSDSLTT v35 clocking External PRINT Activating the configuration and rebooting SEND action Activate Configuration SEND action Cold Boot The result looks as follows Arguments System Mame Crocus SOSL TT 1 Output OFX i Pe 7 AutoSerall End Loop Help F j a a F a a F The sysMWame set to System admin tel 2154 System Contact Syst d tel 2154 sy hame Crocus SDSL_TT_1 ial aaa idee EL as The s sLocation set to Setting the speed to 2304000 bps cet oe The s sContack set to Cancel sysLocation Main building room 21D Setting the clocking to external l System Location Main building room 21D Activating the configuration and rebooting e Basic configuration of the Crocus SDSL TT Arguments
182. unication parameters of TMA In some cases it may be necessary to change some of these parameters Therefore this section lists and explains the different Cms2Serv ini file parameters It also explains how to add parameters to the Cms2Serv ini file The following table gives an overview of this chapter Parts of the Cms2Serv ini file Adding parts to the Cms2Serv ini file p 212 Reference manual 209 The Cms2Serv ini file TMA 12 1 Parts of the Cms2Serv ini file The Cms2Serv ini file is divided into several parts Each part and its parameters is explained below The values behind the parameters are the default values The Cms2 part The Cms2 part contains the following parameters WindowSize 4 TMA sends a number of frames to the device Then TMA has to receive an acknowledgement from the device before it sends the following frames WindowSize is the number of frames which TMA may send before it has to receive an acknowledgement from the device BufferSize 250 This is the number of bytes in one frame Retries 1 When there is no response from the device TMA will retransmit the current frame a number of times before ending the session Retries sets the number of retransmissions LocalPollDelay 2 The local polling mechanism on itself has nothing to do with TMA Fact is that TMA is not allowed to send anything during a local polling session That is way the LocalPollDelay is used It gives an extra delay in seconds on the reply
183. uter Solution Go to the Telindus web site at http www telindusproducts com tma download the latest version of the TMA model files and re install them 232 Reference manual TMA Troubleshooting 13 4 3 You have problems with the sub system picture You have a TMA session running on a device Then you try to open the sub system picture but you get one of the following error messages Error Could not open picture definition file C Program Files TMASpicturecracusSO SLT T det Error x Could not open C Program Files MASpictureCrocusSO SLT T Front brp This means that either that e the definition file def of the device file is not present on you computer Normally this file is located in the C Program Files TMA picture directory or e the bitmap files bmp of the device are not present on you computer Normally these files are located in the C Program Files TMA picture directory Solution Go to the Telindus web site at http www telindusproducts com tma download the latest version of the TMA model files and re install them Reference manual 233 Troubleshooting TMA 13 4 4 You get a custom txt file error message You start TMA and get the following error message Warning The file C Program Files MASconfig custom tet contains errors Please check C Program Files TMASlogscustom log for more information This means that the custom txt file you created contains syntax
184. vanced Subsystem Picture Ctrl F The following table lists and describes all the commands of the View menu Advanced Toggling this command displays or hides the advanced attributes Subsystem Picture This command displays the sub system picture The shortcut key for this command is CTRL P E THA comtrel0 OI i H BENNE id 105 ind PYRE TET ERR TSO 20 FAD ET L ROL OL Loe I eeehe The sub system picture is a TMA tool which visualises the status information of the device The front panel LED indications of the sub system picture are the same as those of the device The sub system picture also displays the status of the front panel test buttons if present the interface connection the line connection etc For more information on the sub system picture of the Telindus device refer to its user manual User manual 87 The TMA window TMA 6 2 4 The Tools menu Export Import Download Options The following table lists and describes all the commands of the Tools menu This command enables you to export configuration status performance and alarm information towards a file Selecting this command brings up the Export configuration parameters window Refer to Paragraph a The Export configuration parameters window selections page 89 This command enables you to import configuration information from a file Selecting this command brings up the Import configuration window Refer to P
185. ves an overview of this section a o O What is an IP connection 3 To which Telindus devices can you make an IP connection Basic IP device settings to enable an IP connection 26 User manual TMA Connecting to a device 3 3 1 What is an IP connection A connection via IP is a connection between e the LAN port of the IP device and the IP network at one side e the network port of the computer and the IP network at the other side The following figure shows an example of a connection via IP to an Orchid 1003 LAN Table Top and Card Version computer running TMA Table Top Orchid Card Version Orchid As opposed to a direct connection making the physical connection alone is not sufficient to establish an IP connection between the computer and the IP device A few basic settings have to be made in the IP device User manual 27 E Connecting to a device TMA 3 3 2 To which Telindus devices can you make an IP connection You can make an IP connection to every Telindus device that has a dedicated LAN port through which you can connect the device to a LAN Hence you can only make a connection via IP to a Telindus IP device not to a non IP device There is a way to make an IP connection to a non IP device However this involves using a management concentrator with a particular configuration In that case the non IP device becomes a proxied IP device For more information refer to Section 3 4 Proxied IP connection
186. w of the connections shown in the figure above The overview starts at the computer running TMA network port of the computer IP network an RJ45 network cable TPI TPI port of the Orchid 1003 LAN of the Orchid 1003 LAN IP IP network an an RJ45 network cable network cable cn port of the Orchid 1003 ee port of the CN4 card nest a Ca RJ45 cable NMS port of the CN4 card nest high speed NMS bus of the the high speed NMS bus on the Card Version modem backplane of the CN4 card nest As opposed to a direct connection making the physical connection alone is not sufficient to establish a proxied IP connection between the computer and the non IP device A few basic settings have to be made in the Orchid 1003 LAN These are shown in the following paragraph User manual 31 Connecting to a device TMA 3 4 5 Basic management concentrator settings to enable a proxied IP connection To establish an IP connection between the computer running TMA and the non IP device a few basic parameters called attributes have to be set in the management concentrator e The first two attributes are the IP address and default gateway of the management concentrator itself These parameters are already explained in Section 3 3 IP connection to an IP device e The other attributes are located in the object table of the management concentrator nmsgroup objectTable The relevant attributes are ipAddress Use this attribute to assign an IP address to the no
187. wed or that you selected to much files for download Recheck the filenames Select fewer files Also refer to Section 10 3 Remarks on downloading files to the Annexes 245 Annex B TMA error messages Sub system picture errors TMA The following table lists some error messages you may encounter when opening the sub system picture Error message Cause Solution e Could not open BitmapFileName e Could not open picture definition file DefFileName e No picture available e Error in the user file 246 Cause These messages indicate that some files needed for the sub system picture are not present on your system Solution Go to the Telindus web site at http www telindusproducts com tma download the latest version of the model files and reinstall them Also refer to Section 13 4 3 You have problems with the sub system picture Cause There is no sub system picture for this device Cause This means that the usr file you created contains syntax errors Solution Read the picture og file to determine the nature of the error Then fix the error in the usr file and start TMA again For more information on the usr file and the picture log file refer to Chapter 9 The interactive sub system picture Annexes TMA Annex B TMA error messages NACK messages The following table lists some NACK messages you may receive from a device Error message Cause Solution e Unknown
188. window you connected to a Telindus device through which you want to access your network As said before if you now want to open a TMA session on the device itself then select On device However if you want to open a TMA session on a device located after the device through which you are accessing your network then select After device The After device parameters lf you make the After device selection you have to specify the location of the device you want to open the TMA session on Do this by means of the parameters NMS address and Exitport These are explained in the following paragraphs However there is a difference in these parameters depending you connected to a management concentrator or to any other Telindus device The differences are shown in the following figures The After device parameters for The After device parameters for a management concentrator any other Telindus device After device After device T Configured device NMS address Poo NMS address fo Relative Relative C Absolute C Absolute Eritpot line T E sitport port 1 hi C Non configured device HG address i The differences are the following e The management concentrator makes a distinction between devices that are already configured in the object table Configured device devices that are not yet configured in the object table Non configured device Other Telindus devices do not have these two options e
189. window TMA Attribute value continued Choice value A choice value is a value which has two or more possible value types In other words you first have to make a pre selection which determines the value type e g direct editable drop down box bit string structured value etc and then you can edit the value itself The following example clarifies this Suppose you have an attribute bandwidth for which depending on the application you have to specify a speed or timeslots So you first make a selection between the choice value speed or timeslots In case you select the choice value e speed then you get for example a direct editable value in which the default of 128 kbps appears You can change the value by editing the direct editable value bandwidth e timeslots then you get for example a direct editable bit string in which all bits are selected by default You can change the value by editing the direct editable value 01234567890123456789012345678901 timezlots l b Because editing a choice value is somewhat more complicated than editing other values it is explained thoroughly below bandwidth Suppose you have an attribute bandwidth which is present in a table This attribute has a choice value Edit this attribute as follows e select the choice value gt click the right mouse button gt select Modify gt select a value type from the drop down box gt edit the resulting value ty
190. wnload software to the non active flash memory bank of a Telindus device CONTROL1 in case you want to download software to the flash memory bank 1 of a Telindus device CONTROL2 in case you want to download software to the flash memory bank 2 of a Telindus device DSP in case you want to download DSP software to the flash memory bank of an Aster modem is the password separator lt password gt Is the optional password as configured in the Telindus device except for Aster 4 Flash gt use the p option instead Specifies the telephone number for remote maintenance Displays graphical information verbose mode When you specify this option a window shows you the download progress Specifies the window size TML sends a number of frames to the Telindus device Then TML has to receive an acknowledgement from the device before it sends the following frames The window size sets is the number of frames which TML may send before it has to receive an acknowledgement from the device Possible values are from 1 up to 8 If you do not specify the window size 8 is taken by default Forces the Telindus device in loader mode Telindus devices that have only 1 flash memory bank have to be forced in loader mode before software can be downloaded to such a device Check the manual of your Telindus device for more information aster4 Specify this option in case you want to download software to an Aster 4 modem running in boot code
191. x HDSL TT Central x HDSL TT Remote x deviceSoftware downloadTable sourceFile T1234567 00 T9876543 00 T9638527 00 crocusHDSLTT The definition of the LinkDown alarm applies on both lines The definition of the SeverelyErroredSecond alarm applies on line 1 only line alarmLevel LinkDown Priority low 0 Priority medium 5 Priority high 10 modem line 1 alarmLevel SeverelyErroredSecond low 0 medium 5 high 10 Sections The sections in this example are common 01003 and crocusHDSLTT The common section applies to all devices The sections 01003 and crocusHDSLTT apply to the Orchid 1003 LAN and the Crocus HDSL F TT respectively Remarks In the sections common and crocusHDSLTT Some remarks are given These remarks are preceded by a 4 Character Continued on next page 142 Reference manual TMA User defining values using the custom txt file An example of a custom txt file continued Definitions eee ee common Suppose that in your case the attributes sysContact and sysLocation on all your devices can only have a limited number of possibilities You can define these files in the common section of the custom txt file However if necessary it is still possible to type another value instead of selecting one from the drop down box Suppose that you want to give an understandable name to an otherwise very cryptic integer value such as the value of the attribu
192. x appears in which you can select a value The shortcut key for this command is F2 Set To Default This command sets the argument value of the currently selected action to its default value Set To Type This command allows you to select a value type in case of a choice value For more information on choice values refer to Section 6 5 The attribute window Paragraph c Attribute value User manual 85 The TMA window TMA e The table Edit menu Display this menu by selecting an attribute which has lt able gt as value and pressing the right mouse button in the structured value window F Security password _ accessRights _ SeCUrity P 2 security 101 Set To Default Insert Row Before Insert Row After Delete Row Del Select All Ctrl 4 G This Edit menu does not appear for all structured values Only for those values where the attribute is followed by the string lt Table gt The following table lists and describes the underlying commands Delete Row This command deletes an entire row Select All This command selects all the values in the structured value window The shortcut key for this command is CTRL A If you execute the Select All command and then the Set To Default commana all the values in the structured value window are selected and are reset to their default value 86 User manual TMA The TMA window 6 2 3 The View menu w Toolbar w Statusbar W Structured Values W Ad
193. y key to exit e lf the alias name or password contains characters that conflict with the normal DOS syntax such as a comma a space an equal sign etc then you have to surround the alias by a set of double quote Gh J characters e Neither the TMA command nor the alias name are case sensitive e lf you want to execute the TMA command in a directory different from the TMA bin directory typically C Program Files TMA bin then make sure you define the correct path to the TMA executable on your system On Windows 95 and 98 this is typically done with the set path command in the autoexec bat file On Windows NT 4 0 and 2000 this is typically done with the path string in the Environment tab of the System Properties window User manual 63 Opening a TMA session TMA 4 4 3 Starting TMA from the command line The following table lists and explains the different TMA command line possibilities tma Starts the TMA application You still have to fill in the Connect windows as described in Section 4 2 Connecting to a device and Section 4 3 Selecting a device tma h Displays the TMA command line help refer to Section 4 4 2 Displaying the TMA command line help tma alias Connects you to the device for which this alias was created Use this command when no password is defined in the device Example Suppose you created for a certain device the alias Test device Suppose no password is defined in this device In this ca
Download Pdf Manuals
Related Search
Related Contents
取扱説明書 - パナソニック PROF SOCIO_1a_1bi_10.indd HP VF210AA NVIDIA Tesla C1060 4GB graphics card SSeeerrrvvviiiccceee MMaaannnuuuaaall Manuel d`utilisation BOMAG TELEMATIC 2015–2016 DCAS Science, Social Studies and EOC Dialoque 5 – prendre rendez-vous par téléphone - L-Pack Copyright © All rights reserved.
Failed to retrieve file