Home

XACS User`s Manual - Xnet Communications GmbH

1. E com receive file remote local hexzs sting OO O system string __ write dba strng write log EventCode Severity Message DebugLevel 82 Chapter 8 Troubleshooting Problem lt takes a long time for a page to be displayed i e XACS Log in my browser and a loaded page is incomplete Missing information on the page Solution This may happen when default settings for maximum memory used by one page in PHP3 and timeout parameters are too small in your PHP3 INI file You should change the values of the following parameters max_execution_time memory_limit These parameters should have at least the following settings max execution time 300 set time on 300 seconds memory_limit 20971520 set amount of consumed memory to 20 MB Problem You are in Setup option of the X Configurator and cannot change anything Solution You don t have the rights to modify this option You can log into X Configurator as other user or ask the admin to give you the appropriate rights Problem can t see all options in the left menu of the X Configurator When log in Task Manager window appears Solution You don t have the user right Admin Only users with the admin have access to all options of the X Configurator Problem can t see information about ta
2. When you set up the appropriate filter criterion then click on Run filtering and the selected messages from XACS Log will be listed on the screen Not all messages are displayed at once Contents of XACS Log will be displayed in small portions on the page You will see buttons that help you navigate in pages with XACS Log For example you will see buttons Next and Previous that will be listed appropriate portion of the XACS Log 57 Lag d Event Task irztanca ira Tues termunatad nm mnnon terminsted TEZ1 hmrnan started TREO Session rriad Berson Ta e tpmminatad THIS Session started TLL Seman rated pp D n W terminalad Sewarity Time Inf Ina Info Ifa ini Infig Infa Eor reading meta p dain run iere Log Source Tas id premi it hu 2000 Login LB 2T 32 Scheduler Test n Usui Zn __ logn oT Wna Scheer et PRESI io juy 2000 __ Loe pump FAA qa dien Loe july 2000 Losi pgp FPA qep 2183 1O Juiy 2000 Logn 16126122 Zchecukar Test 2181 ij Ju 2000 Login z LB 25 13 Scheduler Test 2163 lO J0 2DOU Logri Lb 35 L3 Schedular Test 2162 1j 3u 2000 __ Logn pamir FAA weng S lO Jui 2000 Liari clantia E 2 began been g bgo 2 Ergi E bingo 2 bingo 2 brgo Mazzage Tack instance 1213 uemnalbad Ztalui 3 mnn 2164 berrmnated Eet come 15 Sasson 2168 ziarted id 18 Sa LBD nire Mi seson gd rs lgs Cent Session 2153 beminsied Eet coda 19 Bassin
3. Error reading client record filter and display only this kind of events Internal error filter and display only this kind of events 26 Service stopped filter and display only this kind of events 27 Not enough memory filter and display only this kind of events 56 28 9 30 31 32 33 34 35 36 Events number filter and display only this kind of events Session deactivated filter and display only this kind of events N We wae ase asa eT a Fee es Task instance created filter and display only this kind of events Session created filter and display only this kind of events Session started filter and display only this kind of events Session terminated filter and display only this kind of events Task instance terminated filter and display only this kind of events Session retried filter and display only this kind of events Update target error filter and display only this kind of events e Source this filter allows you to display messages from the selected XACS component 1 All display the messages written to XACS Log by all XACS components 2 Scheduler display only messages written to XACS Log by the XACS Scheduler 3 Console display only messages that come from the X Configurator console 4 Session display only messages that were written at executing the task sessions 5 DBTrigger display only messages written to XACS Log by the DBTrigger
4. HH EA ES Parameters from profile Hane abun Incas default usar hamn debuh gamme Fe 4 xara cf ruota man hh 0 buck cione hanger Figure 13 The sample properties for new created target served by NAS called here XACS NAS 6 1 9 10 Find Target You can find required target name by entering the name in Target name field and pressing Search button When selected target name is found it appears on the top of the target s list 6 1 9 11 Edit Target You can edit target in the appropriate NAS by selecting desired NAS from the Projects option of the X Configurator When you select particular NAS name a new window will appear with a list of targets associated with this NAS The list will be empty if you haven t configured any target before Click on target name to see the properties of this target Also see Add new target to NAS for more information 42 6 1 9 12 Clone Target This option is available in Targets section of selected Project When you select NAS a list of associated targets will appear Select a target to view its properties then choose Clone target New window will appear which allows you to enter Clone name for the target Additionally you can assign this clone to selected NAS When you are ready simply click on Create clone button A created clone has the same set of settings as a source target 6 1 9 13 Remove Target When you choose Targets option from Project option of the X Configurator new
5. 1 Each project has to have configured at least one NAS that will serve the targets routers 2 Each target must belong to one NAS 38 6 1 9 3 Update NAS You can change any information for the selected NAS associated with the appropriate project You can add change or remove any component is described below e Update parent NAS profile Add parameter for NAS Update value of NAS parameter Remove NAS parameter Remove NAS Add new target Edit target Clone targets Remove target Set parent target profile Update value of target parameter Remove target parameter Project Default NAS NAS 002 parameters Parent Pizie rant Sl ugann Hame Valug parameir 2 da F raay ups iakego sobip nas Y nga eise Parameters from profile Hang Value Inde Registered targets Find target Target name Search al Target name Hu buesl odd bock Figure 12 The view on properties for selected NAS 39 6 1 9 4 Update Parent NAS Profile In Parent field you can set the parent NAS profile for the currently created NAS To do this simply designate the appropriate NAS profile s name from the list and choose Update The NAS doesn t have to have a parent profile 6 1 9 5 Add Parameter for NAS To add new parameter to the current NAS just select appropriate parameter from drop down menu and click Add parameter After this enter the value for this parameter in Value field next to the added p
6. 6 1 3 Add Update Project Description This option is available in Project section of the X Configurator Click on project name to view its components At the top of the page there is a field in which you can enter the description of the project Once you entered new data click on Update description to save the changes 6 1 4 Remove Project In order to remove the project choose Project option from the main menu of the X Configurator A new window will appear with name s list of all defined projects To remove any projects simply click on Remove button next to the chosen project name Note 1 In order to remove the project the user must have required user s rights to execute this action 2 If you cannot view the list of projects after choosing Project options from the main menu check the user rights for the currently logged user Such situation might occur that if the user has No rights set in user rights section 6 1 5 Profiles Profiles allow you to group parameters that can be configured on the target or the NAS Profiles can be inherited from other profiles from this selected as parent profile The LUA job scripts may use parameters grouped in a profile When you configure the target you can assign to it any chosen profile 26 You can create a new profile in a project by selecting desired project from the Projects option of the X Configurator and then choosing option Profiles The new window will appear with a list o
7. When you input desired searching key click on the Find button Note For these three fields function OR is used as a condition in controller searching For example If you enter 3 in Controller identifier field and you leave the used for listening checkbox unchecked as a search result you will get the information about controller number 3 if exists and all controllers that have not marked Used for listening option 74 6 5 1 2 Controller List This window shows the list of all defined controllers If option find have been used the list will show all controllers that match search conditions If no controller was found in search process or there are no defined controllers the list will remain empty 6 5 1 3 Add Controller You can add new controller in Controllers List window To add a new controller to the list press Add button A new Add controller window will appear with the following fields e Controller identifier input here numerical identifier for the new created controller e Number of channels input here number of communications channels offered by this controller device router e Used for listening check this box if you wish to use this controller in listening mode allows receiving the incoming calls Otherwise the controller will only be able to make outgoing calls to the targets When you fill in all the fields click Add button to add a new controller to the list 6 5 1 4 Remove Controller
8. 6 1 6 3 Remove Target Profile ee 30 6 1 6 4 Set Parent for Target Protle an 30 6 1 6 5 Add Parameter to Target Profile 31 6 1 6 6 Update Value of Target Parameter 31 6 1 6 7 Remove Parameter from Target Proile nseeesessennnnenneeeeeerrernnnreneee 31 6 17 NAS Prote S o rrt cet t MEI eL LE LL EL ME L 31 6 1 7 1 Create New NAS e EE 32 6 1 7 2 Remove NAS e 33 6 1 7 3 Update Parent for NAS Protein 34 6 1 7 4 Add Parameter to NAS Pronle AAA 34 6 1 7 5 Update Value of Parameter 34 6 1 7 6 Remove Parameter from NAS Protle 34 leegent 34 6 1 8 1 Create New Job 35 6 1 8 2 OT olo E EE 35 G18 Os ROMO G JOD EE 36 TO A NOCIONI e E 36 6 19 Tales ais Ae Ot RO ABA rt LE er 36 6 14 91 Wees 37 6 1 9 2 Create New NAS sonsnssnnneeeeoosssnnnnneresorrrttrnnnrrneorrretrnnntnrsoerrttennnntneeeennet 38 Gale Update NAS r rapi rai ana nn enden au 39 6 1 9 4 Update Parent NAS Protein 40 6 1 9 5 Add Parameter for E 40 6 1 9 6 Update Value of NAS Parameter 40 6 1 9 7 Remove Parameter from NASA 40 GT OO REMOVE NAG aate Seta Aiton ai cre ora ans cel neha neha SEE 40 6 1 9 9 Add New Target to NAS dee asd dac oua eua xn arca suede 40 6 1 9 10 Find Target s s m toe o Cro RE pee OR ete d refte pd 42 X E NR DM el Ee EH 42 EK Clone Tarek E 43 6 1 9 13 Remove Ee EE 43 6 19 14 Set Parent Target Protilg i oie ecards 43 6 1 9 15 Add Parameter for Tage 43 6 1 9 16 Update Value of Target Parameter 43 61 9 17 Rem
9. Calls string Returns when connection is established or failed Returns 1 connection established 0 error com disconnect Terminates connection Returns 1 connection terminated 0 error com_isdn_lastcause Returns 3 numbers ISDN reason code ISDN result ISDN extended info com_lasterror Returns device specific error code For ISDN error codes are 0 OK 1 DISCONNECT_IND 2 CAPI_SET_SIGNAL error 3 DISCONNECTED 4 Protocol error 5 Wrong parameters 7 Timeout 8 CAPL_ REGISTER error 9 CAPI command error 1 Local disconnection 1 DISCONNECT B3 IND 1 Wrong state 1 CAPI not installed 2 Call rejected 2 No memory com listen Listens to incoming call Returns number 1 incoming call 2 error com accept should be called to accept the call Incoming call can be rejected with com disconnect com readtimeout Returns number 0 last receive operation completed without timeout 1 last receive operation completed with timeout This function shall be called when com receive or com receivebuf complete to check out if timeout has occurred com receive delimiterstring timeout Receives data until delimiterstring is received or timeout occurs timeout is given in miliseconds Returns string of received data and received data length E g to accept line of text with 1 second timeout call readdata length com receive n 1000 com_receivebuf numbe
10. SERVICE PROFILING AND DISTRIBUTION DELIVERY OF UPDATES AND UPGRADES X Configurator is an absolutely modern and innovative platform to address the issues and complexities of installing and managing significant numbers of routers within a service provider network X Configurator enables the service provider to offer and maintain new services at low rates and high availability X Configurator was developed to meet the following customer and devices needs fully automated provisioning and maintenance of remote devices noon site engineer required to provision the device no end user configuration required to enable network access the migration to different service levels should be supported as a seamless operation experts should only be involved during the service definition phase investment protection the device automatically gets only what is necessary for update configuration or image a single change updates all devices that subscribe to a particular service no pre configuration of device required units will be shipped directly from stock 1 2 Components X Configurator system consists of the following components e XACS Server XACS Scheduler IPC Service Database Trigger e WEB Server Apache WEB Server with PHP e Oracle 8i Database e TFTP Server e Radius Server optional e Configuration router e Firewall e WEB console and X Configurator users XACS Server and TFTP Server are services that mus
11. omn imn fanaa a appa l update zez op maren dz apn Een ej emoe an merean s ow mmm 5 eee eret ee EE Che ges l menu EST unu ducc Change Raven Figure 27 The sample view in Users option of X Configurator 6 3 1 New User Click on New user if you want to create a new user If you choose this option new window will appear for you to enter the following information e Login name Login name for the user With this string user will be able to log into X Configurator and operate e Full name optionally description of the new created user This can be his first name and last name e Password password that will be used together with login name when logging into X Configurator Password is encrypted using MD5 algorithm 67 By default every new created user gets a default set of rights You can grant rights for any user using option Rights from Users options Click Save to save the setting and add new user to the database Note During login process values for Login name and Password are case sensitive 6 3 2 Update User You can modify parameters of existing users in User window To modify selected user make changes in appropriate fields and click on the Update button next to the modified field 6 3 3 Remove User You can delete existing users listed in User window To delete particular user from the list click on the Remove button next to the selected user He selected user will be deleted f
12. user task in particular option of the X Configurator i e Projects Users Job e Execute if this checkbox is marked user has right to execute object starting a task in the Task option of the X Configurator e Admin if this checkbox is marked user has administrative rights for the object i e project user task in particular option of the X Configurator i e Projects Users Job Click Save to write the user s settings in the database Note 1 The rights apply to the project selected in the drop down menu on the right side of the window This allows you to view the user s rights for Profiles option for example in ProjectNo1 and the rights for option Job in ProjectNo2 at once When you select any project name from drop down menu click Refresh rights to make sure that rights displayed on the screen are correct By default new created users has default set of rights so you will need to assign the additionally rights for them Additionally you need to have the rights to be able to create and modify the Users option in the X Configurator 69 Rights for user wda Ett hene Read Create Change Deieig Coote admin Projets Ei F E F F KR F F F F LHE ae Piofilas Sup nar mish ighi Tangat E E ammmnnmnmun a a gn a a gg a GE EK 1 mamnmnmnmns 35 u uu uu u uu u 3 uU u a bock Figure 28 The sample view with user s rights for user xds in Rights option 6 3 5
13. when parameter is enumerate type you can associate values of this parameter with any description name entered in Value name field In this way you can create the pairs containing value name value e Value name input here description name for the value of parameter when the parameter is enumerate type Add button allows you to add pair value name value to the list and Remove button allows you to remove the selected pair from the list e Je array mark this option when the parameter is an array of values i e array of numbers array of strings e Writable mark this option when the parameter can be written to database by the job script e Headonly mark this option when the parameter should only be read by the X Configurator e Hidden mark this option when the parameter has to be invisible for the user operating in the X Configurator e Mandatory mark this option when the parameter have to be configured in every project e Quick info you can enter here some usefully information about this parameter The Information is displayed in a language selected in Language field When you fill in all the fields you can add parameter to the database by clicking on Apply button If you want to abort or cancel the operation click Back 60 k Nara B Sei fer a deenptek Data type D Parameter SE destination e Lara gee M val ls amas intake Fepitrde Hirkden Hisndaskpry Kn 73 Wa 71 Fs Parsmak
14. 17 Figure 18 Figure 19 Figure 20 Figure 21 Figure 22 Figure 23 Figure 24 Figure 25 Figure 26 Figure 27 Figure 28 Figure 29 Figure 30 Figure 31 Figure 32 Figure 33 Session lifecycle dagram EE 10 Main menu of X Configurator user logged with Admin user s rights 24 The view in Projects option of X Configurator ssssseeeeseesessseeeeees 25 The view in Profiles option of X Configurator sees 27 The sample view in Target profiles option of X Configurator 28 The sample view in Create new Target Profile option 29 The view in NAS profiles option of SX Confourator 32 The sample view with NAS profile proper 33 The sample view in Jobs option of X Configurator sssssss 35 The view with sample registered NAS in Targets option of X Configurator 37 The sample list of targets served by NAS called XACS NAS in option Targets of MAG OMTQUIPAL OM aye eoi cate root iocis aed iia xd Unc a da te medal 38 The view on properties for selected NA 39 The sample properties for new created target served by NAS called here EE 42 The sample target groups configured in Target Groups option of KE de ee 44 The view with sample configured tasks in Task Templates option of XGOBTIOBERIOLS testetur pee ec Eee e Ge 46 The view in New Task Template option of X Configurator 48
15. 6 1 9 1 What is NAS NAS allows you to assign the targets to the appropriate central site router NAS For each project must be at least one NAS defined When you choose the appropriate NAS the new view appears that lists all targets served by this NAS In this window you can add remove targets Registered MAS amp es in project Default D HES name Renge z HACE MAG peream base HAS rama cdd naw HAS bork Figure 10 The view with sample registered NAS in Targets option of X Configurator 37 j gt ri L E SL Project Default HAS XACE NAS parameters Parent Pike rant aene Hang Value add from aber z Parameters from profile Hang Value Index Registered targets Find target Target riam Search 15 Target nana 15 bingo rema 13 zimpip pesas ij aigi Dd J aii S3DER cuui remave previzus page E 77 old hock B Figure 11 The sample list of targets served by NAS called XACS NAS in option Targets of X Configurator 6 1 9 2 Create New NAS You can create a new NAS in the appropriate project by selecting desired project from the Projects option of the X Configurator and then choosing Targets option The new window appears with a list of NASes associated with this project The list is empty if you haven t configured any NAS yet In the field New NAS name enter required name for the NAS and click on the Create new NAS New NAS will be added to the database Note
16. When all sessions are completed task instance status is changed If all sessions are completed with success instance status is set to Completed OK If some sessions completed successfully and some failed instance status is set to Partially Failed If all sessions has failed instance status is set to Totally Failed When session is running for the time longer then defined in Task duration field of the task template scheduler terminates the session Table below describes session and task instances states Session State Completed Session has finished error code describes session result Value of 0 means success Other values indicate error error code is set by script Values of error code are predefined see section XACS event codes Initial State for newly created session In this state session waits for communications channel to be available Running Session has been granted communications channel and is running script Interrupting Session is being interrupted Scheduler sets session state to this value when it terminates session which failed to complete within specified duration You can also interrupt not completed session Postponed First state for session which is created as retry of failed session The practice shows that it is good to wait some time before retrying communication session to faulty target The session waits in this state for 5 minutes and then is put to Initial state Task instances state
17. for NAS for more details 6 1 7 5 Update Value of Parameter To update the value of particular parameter input its new value in the field and click Update to save changes in the database 6 1 7 6 Remove Parameter from NAS Profile To remove particular parameter from the NAS profile click on Remove next to the appropriate parameter name 6 1 8 Jobs Jobs contain the set of actions grouped in the LUA scripts file that have to be performed during configuration For a large rollout process here you can define a main job This job contains the common most important parameters that have to be configured on the remote routers In the jobs you can define what will be performed configuration update reset and return to the factory settings firmware update on the router or creating new WAN partner Jobs option can be found in the Project section of the X Configurator When you select a project name a new submenu will appear containing options for job Figure 9 shows the sample view in this option 34 Jobs in project Default D s rb cC nfigeres rarger for bbl Faramererai fone D scnpivn Fis Hans breca upia remus Liu ubl ld az Here eer Description File Home embuk is arise Ven reis rip le Id z HeT T t mt jcb Calls terp Logs in and dispeunnmecets E Faramatsra sone x Description Fie Ramp ide ie ufale mires Sp ke bork Figure 9 The sample view
18. for particular target 6 7 Help 78 This option the X Configurator enables quick access to the X Configurator Help The X Configurator Help contains a detailed description of each option of the X Configurator Additionally you can use the search engine that helps you to find document according to the entered topic Search engine is located on the top of the page and allows you to input any string that should be find For example if you want to search documents that describe Task Manager option simply input Task Manager in the search field and press Search button The search engine is not case sensitive Help Index button located in the left menu allows you quickly jump to the contents of the X Configurator Help Figure 33 shows a view of X Configurator Help X Configurator Help aisen Leo Zeremguaksgtosg Deh a KACH Set ait derierwiayd Manu options WADE Civi pra Projects SS JETE bp Reg Zu grgtuie p ege Pete Gredt Fisnasug of tie SACH Errem add ug fae demons en Meare of Geta gapiin Fee kidino project saring of Chancen SP Le Maaring of P rejsciz Project Maaring of Iota rcfiaa Maaring of Targatr Target archi ua Maarasg ct Tasks Create raw berget nrohia Con Time Take Ramee target proia Repeeaa ie Tasks Set parent peotde On Cat Tasks Adi parameter bo birgai preide Ge Eesrt Tibi Ups parerrader in lange probs Megraag pl Sada P rtrro parenenes egre rt prable Maegrang gl AS Log HS pries Creat
19. from Name field e Data type this field allows you to set up the type of the parameter You can choose between 59 1 Byte select this type if the parameter represents the small positive integer number 0 255 2 INT16 select this type the parameter represents 16 bits integer number 3 4 5 INT32 select this type the parameter represents 32 bits integer number String select this type if the parameter represents text string e ass See IP Address select this type if the parameter represents IP address For example IP network mask 6 Password select this type if the parameter represents password For security reasons such parameters should be encrypted and invisible for everyone 7 Version select this type if the parameter represents version For example firmware software version 8 Date time select this type if the parameter represents date and time e Parameter destination here you can define where this parameter can be used You can choose and apply this parameter in 1 Projects select this option if this parameter will be used in project 2 NAS configuration select this option if this parameter will be used in configuration of NAS 3 Target configuration select this option if this parameter will be used in configuration of target e Language here you can choose a language which describes the parameter You enter the description in the Quick Info field e Value
20. in Jobs option of X Configurator 6 1 8 1 Create New Job This option allows you to create the new job When you choose this option a new view will appear that allows you define the following information for the job e Name enter in this field the name of the new created job e Description you can add description for the new created job optional e Filename select here the filename of the job script file that contains a set of action that should be performed in the job You don t have to input full path to the file The X Configurator will look for scripts in directories configured in Script path field of the Setup option When you fill in all the fields click on Save to add the job to the database 6 1 8 2 Update Job To update contents of any field simply enter new value in the desired field and click on Update button located next the appropriate job Changes will be written to the database 35 6 1 8 3 Remove Job To remove the selected job from the project and from the database click on Remove button located next to the selected job 6 1 8 4 Script Info The functions contained in LUA script file can have a tag that shortly describes this function An example of a tag is shown below IHHHHHHHHHHHHHBHHHHHHHHBHHHHHBHHHHBHHHHE Function Testing Description Here is the description Description section for the function Globals testaddr IHHHHHHHHHHHHHBHHHHHHHHBHHHHHHHHHBHHHHE function test
21. is can be started on user request by choosing Run now option for the appropriate task template Task template includes job This job specifies identifier to the action to perform Storing action script in file has a drawback scripts must be located on local drive accessible for the XACS Scheduler service Keeping scripts in file it will also be easier to work with compiled binary scripts Chapter 3 XACS LUA 3 1 XACS LUA Extensions X Configurator uses LUA programming language interpreter as embedded script language It is beyond scope of this reference to describe LUA language itself refer to LUA documentation for language description In short terms LUA is dynamically typed scripting language with syntax similar to Pascal X Configurator extends LUA to support communications functions 3 2 XACS functions com_accept Accepts incoming call com_listen must be issued first Returns 0 failure 1 call accepted com reject number Reject ignore incoming call This can be used after com listen completes successfully to ignore or reject incoming call In cause of ISDN device number specifies Reject value of CONNECT RESP message The values can be Value 0 should not be used to accept the call the use should use com accept function Main purpose of this function is to ignore calls which are addressed to MSN other than application s MSN Returns 0 failure 1 call rejected com connect string
22. n res gend Bini rice sisi fus bnck E Figure 15 The view with sample configured tasks in Task Templates option of X Configurator 6 1 11 1 Create New Task Template Choose New task template from Task template A new window will appear see figure 16 with the following fields e Task name in this field enter required name for a new created task template e Description in this field input optionally description for new created task template 46 Job name from this drop down menu select the appropriate job that will be executed with the beginning of the task Job arguments enter here arguments for the selected job optional Client selections rule this field allows you to enter rules that will apply to the targets Rules can be defined in such way that they will be able to exclude matched targets The rule is an expression in LUA language that uses variables defined for targets and NAS Client selection rule applies to all start types of the task Start task type this field allows you to define how the task should be started You may choose from the following types a On Time task will be started at defined time Choose this start type and click Next button The resulting window will allow you to configure date and time when task will be started See also information in sections Task start conditions and On Time Task for more details b Repeatable task will be automatically started and repeated in the
23. on Deactivate in appropriate task template You can deactivate the task template at any time 6 1 11 7 Run Now Once the task template is in active state you can start its task instance manually by clicking on Run now The session s for the target s contained in the task template will be started 6 1 11 8 Remove Task Template To remove task template click on Remove button associated with the task template you want to remove The task template will be deleted from the database 6 1 11 9 View Task Instances If you want to watch the task instances from particular task template click on View task instances When you choose this option a new window will appear see figure 17 with a list of all task instances By choosing the Sessions option located next to each task instance you will be shown a new view with list of all sessions for this task instance see figure 18 The Details option allows you to view the detailed information about selected session see figure 19 The Log option allows you to view the messages written in XACS Log by the selected task session see figure 20 49 Task Instance jd Task Fetare name Tack name State Srat date End date rere ih 320 Login Test Lon Test Tntaby tsed EN luy DD 13 28 16 D Juby DD 13 3 1G seine OT Login Tant Login Twat Completed DK d O8 July 00 12 50 09 D AN DD 11 5007 rengen OTs Logan Tait Legin Teit Completed CK gy D luby 900 12 55 09 D Au DD 11 55 00 ke
24. parent profile for this target Target has to have at least profile root default selected You can find information about how to create the profile for targets in Target Profiles section Add parameter this field allows you to add the parameter for the target Remove click on this button to remove the parameter from the target Update change data in appropriate field and then click on Update button next to the changed value e Parameters from profile this part of window displays the parameters inherited from the parent profile e Clone target this button allows you to create clone of the current target For more information refer to section Clone target e Index array if the parameter is an array you will see here an index in the array for this parameter Note 1 Each target has to belong to one NAS 2 The currently logged user who wants to remove the profile must have required user s rights to execute this action 41 HAS XACS MAS Parameters for target x 1000 0001 v Dhu larva Trace arora M Tricia Lenk F Ee Trace semicon states Trace versn acris P uei Trace pension scripty art F Internal trace k Parere Debat login peotiia zje t M c Lin Hame abun des Werbose TALE S mawigi updahe ES Teds el izdacon fign umibar p mandatory upishe usum daft kin JEnsh lad mma update confiqure_state rive conkquiedt HHT res update ronhgurm date PE 20E21 DN HHT creas updae
25. rutar is Besson XIDODIEB3 KIDDO Ap nA jM ERA TAR ap unmmpartud krpe fnr Seaton sini 2865 KRIER ood concatenation fal Sein barrranated Info Schaduler 1000 2503 KD Od 12 Juy 2000 14100 3 12 July 2000 14 08 30 12 Juy 2000 L 29 9220 Heceesnme em Error 0209 Mecoooprt Geste Emar 12 July 2000 i PING bo TETP amor Zalpd to AFIN Brrpt trace Info ikora Bhmsrzan 21000 FERF KIDDO d roach TFTP Sarrar 9207 Srript brace Infa Een dingue Session IDW 2583 KiDOU ACD System Up Tiree 0 01 33 15 DO J wi 92068 Serpe rece Info Seiren Zadar o IDG 25H3 xIDOd SCH Mamba ofrgetaren 7 Curent z ftearg vardo v 5 2 Hzi15 Sompt en Infa 12 July 2000 Senn m1000 zEU3 S100 ODI Fw 3 from 2000 05 0 EI gt QU 00 00 H214 Script trace Infa NEU Segen XIDOD SSH DER ACD Local PPP JD Eet ALS 9243 Srript brace Infa duum Sesin SEDO E83 KEE SODI Logged n 8212 Online infa erger Settkan xIDO 2483 e 400 Connected Connection eee 9201 silabikwreant Info esch Senn IDG 25H53 IDG 000 Calling 91 started ae SEI Seddon ibarb d Info ran EL Schadulr 1000 2503 1000 ACDI 2503 staried Chenk kk 9209 Session crested Info JA EU pores der sio esaa IDO soca SHON 2585 craatad Cham id bock R Figure 20 The sample messages from Log option located in Task Sessions 6 1 12 Task Manager This option is available in Project section of the X Configurator for selected project When you choose this option a new vie
26. target will be added to the database and to current NAS Once you have created new target you can set up the following options see figure 13 e Debug level this section allows you to configure required debug level for this target Here you will find the following Trace errors mark this field if you want to write error messages to the XACS Log 40 Trace task mark this field if you want to write to the log messages from task execution If this option is marked information about the time when task was started and finished is written to the XACS Log Trace session states mark this field if you want to write to the log messages from the session states If this option is marked information about the time when session is created started and finished is written to the XACS Log Trace session scripts mark this field if you want to trace the execution of the job script Trace session scripts ext mark this field if you want to trace in details the execution of the job script Internal trace mark this field if you want to have the detailed trace from the system state This option produces a large amount of information that is written to the XACS Log Default value for this option is set to off and should be changed to on only if necessary You should turn on the first four debug levels For default settings of the debug level see also Global debug level field in Setup option e Parent here you can set up
27. view will appear with a list of all defined NAS in this project Select required NAS A list of served targets will appear If you want to remove selected target click on Remove button next to the target name The selected target will be deleted from the database Note 1 The currently logged user who wants to remove the target must have required user s rights to execute this action 2 If you cannot view the list of profiles in this option check the user rights for the currently logged user Such situation might occur that if the user has No rights set in user rights section 6 1 9 14 Set Parent Target Profile In Parent field you can set parent profile for the currently created target To do this simply designate the appropriate targets profile name from the list and choose Update The target doesn t have to have a parent profile 6 1 9 15 Add Parameter for Target To add a new parameter to the current target select the parameter from drop down menu and click Add parameter Then enter the value for this parameter in Value field next to the added parameter To apply value for this parameter simply click on Update button next to the parameter If you do not see parameters in drop down menu it means that you have to create parameters for the targets first Refer to section Parameters for targets for more details 6 1 9 16 Update Value of Target Parameter To update the value of particular parameter input its new value in the f
28. wiht aherat bkackppg bei callback raprirppurt Cub La mprezsion dd aer Des naMion Cate hype COMER T Targets Targets Tangats Targat Targets Tange Ge Targe te Tange bs Tanger Targets Tangutz Targets Tange ts Tange i Targets Tange be Tange bs Targets Hine ES mai Awg Faa Pa aa rire neg rng Taz Arig paan ES tel one ang Bry me na HTaz a Aperte eme meets enee See amaer EE iei Deben iors pm Figure 23 The sample view in System parameters option of X Configurator 6 2 1 Project parameters This option is available in the System Parameters section of the X Configurator Here you can set up parameters describing project The LUA script job files of the X Configurator can use parameters configured here If there are any configured project parameters you will see them on the list of registered parameter types see figure 23 6 2 1 1 Add Parameter Click on Add parameter option to create and configure new parameter that can be used later in the project The LUA script can use this parameter When you choose this option a new view will appear see figure 24 with the following fields e Name enter the description string for the new created parameter e Short name enter the short name of the parameter that will be configured This name is important and is used in the X Configurator job scripts The button Copy from Name allows you to copy the name of the parameter
29. 00 jobs scripts at once each of them trying to make ISDN connection when only two B channels are available In ISDN option of X Configurator you define resources available on the configuration router s The resources are represented in CAPI 2 0 fashion in terms of controllers and channels For example if you use one configuration router in central site which is standard SO controller with 2 B channels supported you should create in ISDN menu option one controller with 2 B channels and optionally mark option Used for listening That will allow to answer and to handle the incoming calls by X Configurator 1 10 Meaning of Task Instance Task Instance single execution of task for all targets which are associated with task template Task instance consists of sessions one or more for each target Task instance groups together both successful and failed sessions 1 11 Meaning of Session Single execution of job s script for the target client Session has its status i e indication if it has completed successfully Session status is set in job by assigning value to error_code variable For more information about error_codes see XACS event codes section 1 12 Meaning of XACS Log XACS Log stores system log The log is mainly used to report system errors but can also be used to write debugging and tracing data What is stored in log depends on the global debug level parameter defined in Setup option and in the field De
30. 2153 stated Chent id 13 Sarum SLES reine Mew session id amp 2153 5ession 2152 bprminagred Eet cade 18 Tuin ILE laten Cent il Figure 22 The view in XACS Log option of X Configurator with sample messages from XACS Log database 6 2 System Parameters This option allows you to configure the following parameters e Project parameters mark this option if you want to add edit or remove a project parameter e NAS parameters mark this option if you want to add edit or remove a NAS parameter e Target parameters mark this option if you want to add edit or remove a target parameter When you select desired option s click Apply button The new view will appear with defined parameters see figure 23 If the new window remains empty it means that either user has no rights to use this option or there are no defined parameters See section Rights in Users option to learn how to check user s rights 58 ID 336 J mr a37 33 Parameter names arira grmu Admin girib Anrede Aciverds abar Fina Administrat _ hachnamg Admmibrabs Ort Agra rege ha bar PLZ Ader raboar_Sarac Zchkr gtstior Vora AO autherdication aaj ticlant athe rat block tire tai ralhack rap rppnnort Cun comprezson Registered parameters types admencammunity Agminiirstor innede Administrator Finma Admmnsirator Nachname adsunstiaboe Omg ABdmnnulrator PLZ Admmrmiratnr Sire Aran strabor Vurmsre apo authanticabon
31. After installing Remote CAPI you must change properties for XACS Scheduler service To do this select Services from Control Panel window and then from the services list select XACS Scheduler and press Startup button Set up Log On As option to This Account Now enter appropriate account name and password Now log on as a different user if necessary and restart XACS Scheduler service To check if the remote CAPI is properly loaded enter command netstat a from command line This command will return a list of active connections The following item indicate that Remote CAPI is properly loaded TCP computer name port number IP address of CAPI SERVER CAPI port number ESTABLISHED Where computer name is the name of the computer where the XACS Scheduler service is installed port number is the port number used for communication IP address of CAPI SERVER IP address of the device where Remote CAPI is served usually IP address of the BinTec router located in the central site CAP port number port number for Remote CAPI server If you can t see such item on the list of active connection please refer to the documentation of your router 5 2 Configuring ISDN channels for using by X Configurator In this step you will configure controller s used for the configuration purposes From the main menu option choose ISDN and then Controllers Click on Add to add new controller As Controller identifier input unique number for this contro
32. Change Password Click on Change password button if you want to change the password for the current user logged in the X Configurator When you choose this option the new window will appear Type in the old password in the Old password field and then the new password in the New password field Click on Change button to confirm changes The change takes effect once a user logs out from the X Configurator You may use Logout option from the menu of the X Configurator You will have to type the new password when trying to log in the next time 6 3 6 Reset Password If you want to reset password for the selected user click on the Reset pass button next to the login name He will use empty password when logging to a system the next time You can use Logout option from the menu of the X Configurator to login once again with empty password 70 6 4 Setup In this option you can configure the X Configurator parameters as well as parameters for others components The view that you will see in this option is shown in figure 29 x Configurator Setup Log size Imitation type momtergterees E Number of ka antrigs Emo Mambe erines bo celebs bm Sessions mecund Bahati iypr Mosuinnsic orsin dooie Mabor of Task retried B Task duration hm is el Tack start type Da Tee Secor reir lied ea s DIPLEDELLEBIA BZGEIBE zanl Bath D Trace emors KR Trace trek FF Global dabug bevel Trace session
33. Choose Targets option from appropriate Project and then create the new NAS In the New NAS name field enter required name for the NAS and click on the Add new NAS The new NAS will be added to the database Note that for each project must be at least one NAS defined Once you have added new NAS this item appears in the registered NASes list In the next step you must add the target router to the NAS Click 22 on the appropriate NAS name and then Add new target Once you have added the target you can set up parameters for this target See section Add new target and Add parameter for target for information about configuring the target Note Each target has to belong to one NAS 5 5 2 Create new Job Once you have added target s to the Project as it is described above you can define what should be done for this target s See the description for Jobs option of X Configurator for more information 5 5 3 Create new Task Template and assign the Target s Once you have created target and job as described in previous sections the next step will define task template containing created job You will learn how to create and configure the new task template in Task templates section Once you assign the job you must assign the target s for this task template Additionally you can include the target groups to the task template You will learn how to add targets to the task template in Add targets section and how to add Target Groups in Add ta
34. SDN session It retrieves client s unique identifier e g serial number Then scheduler starts configuration session to target which matches unique identifier For more details see also sections CLID method Active method and XACS Scheduler Click on Save button if you have changed the value of any parameter and you want to keep the changes 6 5 ISDN This option enables you to configure ISDN communications parameters This option contains the following sub options e Controllers e MSN 6 5 1 ISDN Controllers This option allows you to create modify or delete communications controllers To perform any of those actions simply click on the appropriate button next to the chosen controller Figure 30 shows a sample view in ISDN Controllers option 73 Find controller d Cortroler denter E TED Numbar af charnels Used for knksrirug C T mua t D amp rue d Controllers jist Contre kentifar Number at channels Used forlistaning ede RTR F remove _upetote Figure 30 The view in ISDN Controllers option of X Configurator 6 5 1 1 Find Controller In Find controller window you can quickly find desired controller You can search for controllers using the following key properties fields e Controller identifier find controller with required identifier e Number of channels find controller s with required number of channels e Used for listening find controller s with this property
35. The sample view in View Task Instances option ssssssseseeesessssrrrrrneeeeee 50 The sample messages in Task Sessions Log 51 The sample view in Details option located in Task Sessions 52 The sample messages from Log option located in Task Sessions 53 The sample view in Task Manager option for appropriate project 54 The view in XACS Log option of X Configurator with sample messages from XACS Log database eee rtt tete e tte desi dana anc e eue ies 58 The sample view in System parameters option of X Configurator 59 The view in Add parameter for project option sssessesssssss 61 The view in Add parameter for NAS option 63 The view in Add parameter for target option 66 The sample view in Users option of X Configurator 67 The sample view with user s rights for user xds in Rights option 70 The view in Setup option of X Configurator 000aeeeeeeeneeeee eeaeee 71 The view in ISDN Controllers option of X Configurator 74 Sample view in ISDN MSN option of X Configurator ssssss 76 The sample Log Report created in Reports Log option of X Configurator 78 The main view in Help option of X Configurator Help 79 85
36. X Configurator Welcome X Configurator User s Manual Manual version 1 13 August 2000 Note The information in this manual is subject to change without notice This manual provides a description of the X Configurator software The instructions included in this manual are compatible with software version 1 2 While every effort has been made to ensure the accuracy of all information in this document Xnet Communications GmbH assumes no liability to any party for any loss or damage caused by errors or omissions by statements of any kind in this document All product names and trademarks are the property of their respective companies Copyright 2000 Xnet Communications GmbH All rights reserved Contents Chapter 1 System EE 6 1 1 Ets e eg 6 TZ OOM ee En 6 1 3 System operation summary EEN 7 1 4 Meaning of Task Templates en 7 1 55 Meaning OL JODS nei eic Re EEN EE 8 1 6 Meaning f Tardels E 8 1 7 Meaning of e 8 1 8 Meaning of Setup option 8 1 9 Meaning of Communication Channel 8 1 10 Meaning ot Task Instant enii maiera aA e rene tae 9 1 11 Meaning of Session doce te A tM DA A E A At LA 9 1 12 Meaning of XACS E toes eru ite ee pee eet nte 9 O EE WIGAMING OF E 9 Chapter 2 XACS Scheduler AAR 10 2 1 How AACS EU 10 2 2 Task statbeondillorient s d se cA e d DM edu su MUS amu Me UIT 12 23 20 TITIO HT aS Sud oo Eom ER D ERE DECOR Emu ated onere ete era 12 2 4 Hepoalablo T asKs eui boca dd iiu fd ia ui
37. You can remove existing controller in Controllers List window To delete particular controller from the list simply click on the Remove button next to the selected controller 6 5 1 5 Update Controller You can modify parameters of existing controller in Controllers List window To modify a controller first make desired changes in appropriate fields then click on the Update button next to the selected controller 6 5 2 ISDN MSN This option allows you to assign particular MSN numbers to selected controllers When you choose this option the new view appears see figure 31 75 1 Controller rumter D MM to irs ban for iecomag calls 3 ga Uu MEN list Controller runber MSN to isten for incnming calls sm Figure 31 Sample view in ISDN MSN option of X Configurator 6 5 2 1 Find MSN In Find MSN window you can quickly find desired controller You can search for controllers using the following key properties fields e Controller number search for controller according to his identifier number e MSN to listen to incoming calls find controller with desired MSN number used for listening to incoming calls When you input desired searching key click on the Find button to begin search 6 5 2 2 MSN List This window displays all defined MSN s and assigned controllers or if you used Find option this window shows controller that matches search pattern If no controller found this window w
38. active it changes session state to Running and executes job associated with session Job execution means running script here The XACS Scheduler embeds LUA language script interpreter extended with communications functions The script performs its actions typically connection establishment and data exchange and sets variable error code to indicate if it completed successfully When session is completed its state is marked as Completed If session has completed with failure i e error code variable was set to value different then 0 by the script scheduler retries the sessions Retrying session means creating new session Newly created retry session has retry count field incremented It shares the same instance identifier as parent session Retried sessions are not started immediately Instead they are created in Postponed state In this state session is frozen for some time 5 minutes After this time session state is set to Initial from this moment session can be scheduled to run How many times session is retried depend on Number of retries field of session parent task template Diagram below shows session lifecycle Finished error cade 510 AND rerty counts max retny Completed Channel available Finished error cade 0 status changed to 3 Figure 1 Session lifecycle diagram Every time a session is completed scheduler scans all sessions belonging to the same task instance
39. and the source Scheduler and Console In figure 22 is shown sample view that you will see when you choose XACS Log option To extract required messages you may use the following filters operating on the fields from the database e Severity this option allows you to filter and display only the messages with specific value in the severity field 1 All display all messages written to XACS Log don t look at the value in the severity field of the message 2 Info display only the messages which contain in severity field Info Information 55 3 Warning display only the messages that are stored in the XACS Log database with Warning in the severity field 4 Error display only the messages that are stored in the XACS Log database with Error in the severity field 5 Fatal error display only the messages that are stored in the XACS Log database with Fatal error in the severity field Event this option allows you to filter and display only the messages with specific type of event contained in the event field 1 Success filter and display only this kind of events 2 Script trace filter and display only this kind of events 3 Database access error filter and display only this kind of events 4 Error reading setup data filter and display only this kind of events 5 Error running script file filter and display only this kind of events 6 Error initializing script engine filter and display on
40. arameter To apply value for this parameter just click on Update next to the appropriate parameter If you cannot see any parameter in drop down menu then first you have to create parameters for the NAS See to section System parameters how to create parameters for NAS 6 1 9 6 Update Value of NAS Parameter To update the value of the appropriate parameter in the NAS input its new value in the field and click Update to save changes in the database 6 1 9 7 Remove Parameter from NAS To remove the appropriate parameter from the NAS click on Remove next to the appropriate parameter name 6 1 9 8 Remove NAS When you choose Targets from the appropriate Project option of the main menu of the X Configurator then new view appears with listed all defined in current project NAS names If you want to remove the selected NAS then click on Remove next to the appropriate name The definition of NAS will be deleted from the database Note The currently logged user who wants to remove the NAS must have appropriate user s rights to execute this action 6 1 9 9 Add New Target to NAS You can create a new target in a NAS by selecting desired NAS from the Projects option of the X Configurator When you select NAS name a new window will appear with a list of targets associated with this NAS The list will be empty if you haven t configured any target before In the field New target enter required name for the target and click on the Add button New
41. ask mutance 233 created Tamplate id 2 FLET n 03 300 Logri Tert Tei maiancs 23H terminated Statue 1 ZIE 0 Ds JXA DU Loge Test bina Sermon 359 bemminsted Eek cote O ZIBE D DS AN Z0 Login Test bingo Sees 358 started Cent id 15 zis 2 ISNA Login Test bingo Sasson JPF craabed Chant id 15 zi5 i 62 035i Loge Test Task weztanca 253 craatad Tamplate id 2 152 D OSU Loge Test Task instancao 257 rorminalud Sratus 1 151 n GS SUD Lege Test Ire Seman 288 barrnnated Eet Gig D FLI H D3 30L 00 Log Tet ba Sean 35D ibarbad Cantid 15 ESL Ed 03 2UL400 Logn Text bingo Sanon 158 created Cheri id 15 z F AL Logn Tert Task tance 237 created Template id 3 S i 0 U2 3X4 00 4001 Test Task insiance ES Eterminisied Status L SL D B3 30 00 amp OD Test Kibo Season S57 bemninsied Ext code D Zii 2 OSL 4001 Tast vU Zit 2 OU AO Tast kLDOU PING to TFTP amar faded to raach TFTP Sener i 2 SUL AO Tast kLOOU Byaba Le Tue O 03 29 47 00 Tle D n3 341 00 ADD Test xLDOU Humber OF interfaced 12 z121 E 0AL0 ADOI Task xLDOD Curent ideie veram v 5 2 Pau 1 fom 2000 05 00 DO DC oo z1430 Z DMAA ADDI Test xLDGU Local PPP ID IG BIM elm d D2 3 00 t Test LO Conrached cL Z OOS LA 400 Test sion Cabral zi37 D QD3 4 00 amp OO Test ri Season S57 started Client id 14 Lil452z sata to page E Figure 32 The sample Log Report created in Reports Log option of X Configurator 6 6 2 Targets This option allows you to create reports
42. atabase Note Currently logged user automatically gains full to rights to the new created project 6 1 2 Edit Project This option is available in Project option of the X Configurator Click on the name of the project you want to edit A new window will appear in which you will be able to set up each component of every project You can edit the following components e Profiles allows you to manage the profiles used in the project See also the description of Profiles option e Jobs allows you to create add and remove jobs in the project See also the description of Job option 25 e Targets allows you to include target devices into project See also the description of Target option e Target Groups allows you to include and manage the target group in the project See also the description of Target Groups option e Task Templates allows you to set up the task templates for the entire project See also the description of Task Templates option e Task Manager allows you to view the task and system activity See also the description of Task Manager option e XACS Log allows you to set up and view the log for the project See also the description of XACS Log option Note If you cannot edit the selected project it means that you don t have the necessary user s rights for the project To view the project contents user needs at least the right Read for Profiles Jobs NAS or the others sub components of each project
43. ation click Back be Adress park nama I Adress copy Rem Hama Zecnptek Deia Eype iF Adder Pate timber desiaetion HAT onnfiquistian T Language English T alus ze Vue name area ls array E Quick infa Wer tCobke m This i3 IT address of the MAS central router Fedor Hiden Mandatory FP zept pmi Figure 25 The view in Add parameter for NAS option 63 6 2 2 2 Update Parameter Click on Update button located next to the selected parameter A new window will appear with the fields with the same meaning as described in Add parameter for NAS option When you have changed the desired field click Apply to save changes in the database or click Back to abort or cancel the edition 6 2 2 3 Remove Parameter Click on Remove button located next to the selected NAS parameter to delete After this the NAS parameter will be deleted from the database 6 2 3 Target parameters This option is available in the System Parameters section of the X Configurator Here you can configure parameters that will be configured on the targets routers Parameters configured here can be used by the LUA jobs files of the X Configurator If there are any configured target parameters you will see them on the list of registered parameter types see figure 23 6 2 3 1 Add Parameter Click on Add parameter option to create and configure new parameter that can be used later in configuration process of
44. bug level configured for each target See Setup option to find more information about configuring the XACS Log You can view the contents of the log by choosing XACS Log option of the X Configurator 1 13 Meaning of NAS NAS is an ISDN router or other ISDN device located at central site which allows serving the targets Since every target must belong to one NAS which will serve them at least one NAS must be defined for each project You can define many NASes located at central site if you have many central routers and indicate which NAS will serve particular target or targets Chapter 2 XACS Scheduler 2 1 How XACS Scheduler works Scheduler monitors database to look for tasks to activate When task start condition is fulfilled the XACS Scheduler creates sessions for all targets associated with given task Initially session is in Initial state It means that session is waiting for communications channel to become available The XACS Scheduler also creates task instance Task instance is the entity which bounds together all sessions originated from the same task template run This means sessions to all targets both successful and failed There can be many sessions to one target in the same task instance as failed sessions are being retried The XACS Scheduler keeps track of communications channels ISDN channels available The administrator in ISDN option must define the available controllers and channels When channel becomes
45. ch is predefined and supplied with the X Configurator 3 The currently logged user who wants to remove the profile must have required user s rights to execute this action 6 1 6 2 Find Target Profile If you are going to find any target profile then choose Target profiles from Project option of the main menu of the X Configurator New view will appear with the list of all defined target profiles names If you want to find any target profile then in Target name field input required target profile name and then press Search If such target profile will be found then it appears as first on the list of defined profiles If search fails then appropriate message will be displayed Target profile not found 6 1 6 3 Remove Target Profile When you choose Target profiles from Project option of the main menu of the X Configurator a new view will appear with list of all defined target profiles names If you want to remove a target profile click on Remove button next to the selected profile name The selected target profile will be deleted from the database Note 1 The currently logged user who wants to remove the profile must have required user s rights to execute this action 2 f you cannot view the list of profiles in this option check the user rights for the currently logged user Such situation might occur when the user has No rights set in user rights section 6 1 6 4 Set Parent for Target Profile In Parent field you can set pare
46. configuring targets 5 5 1 Create the New Project Project is a set of task templates jobs and targets It contains all necessary information about installation and configuration process The X Configurator realizes the control modifications and user s identification in each project In order to access project data user has to log in to the system Every type of user Administrator Project Manager Operator Hotline End User is given a set of rights which state his privileges in entire X Configurator The rights for different types of users can be configured in section Rights of the Users option menu By choosing different rights for different types of user you can limit rights of some users to only viewing the appropriate data from the project others to modifying data and others to having full access to the entire system You can create the new project in Project option of the X Configurator In the New project name field enter the appropriate name for the new created project Then click Create project to write changes into the database Now in the window displaying project list you will be able to see the name of the created project Click on this project to setup its properties The following steps can only be executed after selecting this project must apply to this project Note When the currently logged user creates a new project he automatically gains full rights to this project 5 5 2 Create and add new Target to Project
47. d 12 ZRIPMGIEECIECI cR 12 2 5 1 EID MeINO Gis miren ene eid a uide cie cc as 13 ESSEN PCUVG AMGUNOG ee 13 26 Ombsvernt Tasks os osten e Or o oO nude ua 13 Chapter 3 XACS EA E 15 3 1 MACS LWA Extensions 2 dedere hee eege ENEE 15 3 A e Ee EEN 15 Bed HAC S NANA OOS cece since eet Ee ee 18 Chapter 4 Configuration scripts development guidelines nnnnnnaaaananaaaaeeaeeaae eaa 20 Chapter 5 Preparing system for working 21 5 1 Installing Remote CAPI for BinTec routers 21 5 2 Configuring ISDN channels for using by X Configurator sssss 21 5 3 Configuring Setup option of X CGonfourator 22 5 4 Creating accounts for the X Configurator user 22 5 5 Create the new project for configuring Loes 22 5 5 1 Create the New ETH enee epo D ta o ie EESEeESKS 22 5 5 2 Create and add new Target to broiect 22 5 5 2 Create new JOO cach CANA tates Seba n o gione DIARI Sr cured E rae 23 5 5 3 Create new Task Template and assign the Target s 23 5 5 4 Watch the X Configurator etaie ENEE 23 Chapter 6 Menu opttons ENEE 24 Bal PIO OCIS EE 24 6 1 1 Create New te EEN 25 6 1 2 EGU PIOIGOD EE 25 6 1 3 Add Update Project Description 26 6 1 4 Remove Project GE 26 NEA e EE 26 6 1 5 1 Create New Proflle der rera recor tne rente ar m ten eheu ege EC 27 D Ee let 28 6 1 6 1 Create New Target Profile en 28 6 1 6 2Find Target te UE 30
48. defined intervals Choose this start type and click Next button The resulting window will allow you to configure date and time when task will be repeated See also information in sections Task start conditions and Repeatable Task for more details C On Call task is waiting for incoming connection from target Choose this start type and click Next button The resulting window will allow you to define how to match digits from incoming call number You will see the following fields Rule matching this field defines how the incoming phone number is analyzed If Match all is selected then all digits from calling number must match If Match first number is selected then the first digit from the incoming call number is checked and matched If Match last number is selected then the last digit from the incoming call number is checked and matched Matching digits enter how many digits should be matched Digits for the calling number are checked from right to left See also information in sections Task start conditions and On Call Task for more details d On Event task is started when the appropriate event in the database table appears When you choose this start type and click Next a new window will appear which will allow you to enter the event name See also information in sections Task start conditions and On Event Task for more details For more information concerning task types please refer to XACS Scheduler section Task
49. duration enter here the approximate time in seconds of the task duration for example 360 When the time is out the task is terminated by the XACS Scheduler Number of retries input here required number of retries for this task If an error occurs while executing the task due i e communication problems XACS Scheduler will retry this task the number of times specified in this field Input O zero if you don t want XACS Scheduler to make any retries 47 When you click Next you will see the new window depending on the selected task start type Click on Save to add task template to the database Task Templates in project Defautt Task rame Mee ck npete This is Can terk tee lace Caio phar Ys name json Job Argumants ERA Chart Salaction Bula Start tuck type as Evi Task curatinn E Numbar of patrii B r el noe Doch Figure 16 The view in New Task Template option of X Configurator 6 1 11 2 Update Task Template To update any information in the task template i e name description start time click on the Update button next to particular task template The new view will appear identical like in Create new task template option Please refer to the description of this option 6 1 11 3 Add Remove Target to from Task Template Each task template has to have at least one target To associate the target or targets with the task template click Add remove target button next to sel
50. e nass HAF proie Pprreeop Ph E paulis sk paret prelia xac Bohodulor Add pararater to AAG profile Update pararmacer in HAS profile ieee HACE Srhaular pore Cie era raion eg HAS arcis Tadke Expar Proper n Teri Taaka Teta Easnababia Tarka Cresta ner jab On Call Tanks Uer jeb On Event Tasks bamper noh Pott info KACE LUA deer iones Frojecs agen WAT Funchans Greate nem Hi Ir dere zl TE bseieet lip dais HAS EACE ere ies Remco His ede vi x ie varies Lig date parent profile for HAT Aid renngisr for HAS j Up tebe valna of HAS parecer Configuration scripts developement quidelices see Gare ndi rem t XACH ayent codes fronts Sel parens prabke for bar pet Hen ha Char art Pe mite Langst Prepare spelen For arbi rojenia 3 ikon Perside Peet fer Rafsr mistari asi m Figure 33 The main view in Help option of X Configurator Help 6 8 Logout This option allows you to log out from the X Configurator You should use this option when you finish working with the X Configurator or you want to login into the X 79 Configurator as other user with other user rights When you choose this option the new window will appear with prompt to enter User and Password Note During log in values in the fields User and Password are case sensitive 80 Chapter 7 Appendix 7 1 XACS event codes The table below lists currently defined XACS error codes These values are used in the XACS Log and session log You can use t
51. ected task template name A new view will appear containing two windows In the left window you will see the list of defined targets not included in this task template To add any target simply select it from the list and click Add In the right window you will see the list of targets contained in the current task template To remove target select it from the list and click Remove When you finish adding removing targets click on Back button 48 6 1 11 4 Add Remove Target Group to from Task Template Each task template has to have at least one target To associate the target group s with the task template click Add remove group button next to particular task template name A new view will appear containing two windows In the left window you will see the list of defined target groups not included in this task template To add any group simply select it from the list and click Add In the right window there is a list of groups contained in a current task template To remove the group select it from the list and click Remove When you finish adding removing target groups click on Back 6 1 11 5 Activate The task must be activated to be ready to execute required actions When you finish configuring task template you have to activate the task You can do this by clicking on Activate in appropriate task template 6 1 11 6 Deactivate The task must be activated to be ready to execute required actions To stop the active task click
52. ed in project 2 NAS configuration select this option if this parameter will be used in configuration of NAS 3 Target configuration select this option if this parameter will be used in configuration of target e Language here you can choose a language which describes the parameter You enter the description in the Quick Info field e Value when parameter is enumerate type you can associate values of this parameter with any description name entered in Value name field In this way you can create the pairs containing value name value e Value name input here description name for the value of parameter when the parameter is enumerate type Add button allows you to add pair value name value to the list and Remove button allows you to remove the selected pair from the list e Je array mark this option when the parameter is an array of values i e array of numbers array of strings e Writable mark this option when the parameter can be written to database by the job script e Readonly mark this option when the parameter should only be read by the X Configurator e Hidden mark this option when the parameter has to be invisible for the user operating in the X Configurator e Mandatory mark this option when the parameter have to be configured on every target e Quick info you can enter here some usefully information about this parameter The Information is displayed in a language selected in Language field W
53. emote router In fact this can be any device which provides X 75 connectivity X Configurator stores targets definition in database Targets may have many parameters which are dynamically created by the user in X Configurator 1 7 Meaning of Projects Project is a set of task templates jobs and targets It contains all necessary information about installation and configuration process The X Configurator realizes the control modifications and user s identification in each project In order to access project data user has to log in to the system Every type of user Administrator Project Manager Operator Hotline End User is given a set of rights which state his privileges in entire X Configurator The rights for different types of users can be configured in section Rights of the Users option menu By choosing different rights for different types of user you can limit rights of some users to only viewing the appropriate data from the project others to modifying data and others to having full access to the entire system 1 8 Meaning of Setup option Global parameters required by X Configurator are defined in Setup option of X Configurator See the description for Setup menu option for details 1 9 Meaning of Communication Channels X Configurator is particularly designed to work with great number of targets It needs information about available communications resources to schedule sessions For example it is not reasonable to start 30
54. er ici Projo Kee Faramir ior ros copy irem Hama Evie h odd Quick infa ia 15 desczliphicon Ior pea kesh perches seal pre Figure 24 The view in Add parameter for project option 6 2 1 2 Update Parameter Click on the Update button located next to the selected parameter New window will appear with the fields with the same meaning as described in Add parameter option When you have changed desired field click Apply to save changes in the database or click Back to abort or cancel edition 6 2 1 3 Remove Parameter Click on the Remove button located next to the selected parameter name The parameter will be deleted from the database 61 6 2 2 NAS parameters This option is available in the System Parameters section of the X Configurator Here you can set up parameters that describe the router in central site and optionally the central radius server All the devices are called NAS Parameters configured here can be used by the LUA script jobs files of the X Configurator If there are any configured NAS parameters you will see them on the list of registered parameter types see figure 23 6 2 2 1 Add Parameter Click on Add parameter option to create and configure new parameter that can be used later in configuration process This parameter can be used by the LUA job script When you choose this option a new view will appear see figure 25 with the following fields Name enter the description string f
55. f types of profiles which you can create and associate with this project see figure 4 You can create the following types of profiles e Target profiles choose this option to create and manage parameters that will be configured on the targets routers e NAS profiles this option allows you to create and manage parameters that can be configured on the NAS on router at central site or RADIUS server Project Default XA amp C amp Profiles management Iaruut nri back Figure 4 The view in Profiles option of X Configurator 6 1 5 1 Create New Profile You can create a new profile in a project by selecting desired project from the Projects option of the X Configurator and then choosing option Profiles A new window will appear with a list of profiles associated with this project The list will be empty if you haven t configured any profiles before In the New profile name field enter required name for the profile and click on the Create new profile button New profile will be added to the database 27 6 1 6 Target profiles Target profiles allow you to create a set of parameters that will be configured on each target router Target profiles can be organized hierarchically therefore one profile can inherit all parameters from another profile i e from parent profile Figure 5 shows a sample view of Target profiles option e Project Default Targets profiles Find profile LEA Profile name Search D Tar
56. figuration select this option if this parameter will be used in configuration of target Language here you can choose a language which describes the parameter You enter the description in the Quick Info field Value when parameter is enumerate type you can associate values of this parameter with any description name entered in Value name field In this way you can create the pairs containing value name value 62 e Value name input here description name for the value of parameter when the parameter is enumerate type Add button allows you to add pair value name value to the list and Remove button allows you to remove the selected pair from the list e Je array mark this option when the parameter is an array of values i e array of numbers array of strings e Writable mark this option when the parameter can be written to database by the job script e Readonly mark this option when the parameter should only be read by the X Configurator e Hidden mark this option when the parameter has to be invisible for the user operating in the X Configurator e Mandatory mark this option when the parameter have to be configured in every NAS e Quick info you can enter here some usefully information about this parameter The Information is displayed in a language selected in Language field When you fill in all the fields you can add parameter to the database by clicking Apply button If you want to abort or cancel the oper
57. get reck name 3 boer admin param 1 3 x 10 Fos dud naram rema 5 binec teense param meae Wintec PER param mageg ii bent i m pene 4 eT PCT Lae os be ail renee H hnb r vukbg nar m mme 5 iinic system config pace mma H Entier system paran TPG E 32 nbgc trage fre emae E i Figure 5 The sample view in Target profiles option of X Configurator 6 1 6 1 Create New Target Profile You can create a new profile in a project by selecting desired project from the Projects option of the X Configurator and then choosing option Profiles Choose Target profiles and new window will appear with a list of target profiles associated with this project The list will be empty if you haven t configured any target profiles yet In a New profile name field enter required name for the target profile and click on the Create new profile button New profile will be added to the database 28 Target profile bintec licence param parameters Dali bars a The arora W Trid bik F Trace unien ate Trace zevenn scri A uei Trace nmzsiGn gcnpts akt W Internal trace Name vals end kcspriainumber ere denm ovs ip dne bomas Des aae semevs apdare berg kea mmres Dpdoe betse Mes BHT cre nridshe medal parameter Parameters from profile Hans Value Inde bork Ckang hrg Figure 6 The sample view in Create new Target Profile option When you create new target profile see figure 6 y
58. gin password The script should use these variables instead of login name and login password from target parameters These variables are automatically set by the XACS Scheduler to target s values of defaults according to use default login flag The script should use command line options for customizing Especially it should support write its info when run with option To access script command line you can use ARGC and ARGV variables You can also use GetParameters function from comutils lua module shipped with the X Configurator The script should set the variable error code to its exit code This is very important as it tells the scheduler whether it should retry session error code should be set to one of predefined values for exit code These values are listed in XACS Event Codes section You can use symbolic names of event codes if you include xacs lua file The scheduler does not make ISDN connections for the script To establish and terminate ISDN connection the script should call com connect and com disconnect functions respectively 20 Chapter 5 Preparing system for working 5 1 Installing Remote CAPI for BinTec routers Before you start using the X Configurator you must install Remote CAPI For BinTec routers Remote CAPI can be installed and configured by the software called BRICKWARE supplied on CD ROM with the router Please refer to the documentation of the product to properly install the Remote CAPI
59. he X Configurator and allows you to create reports based on the information stored in the XACS Log When you choose this option Log Report Wizard appears In the first step you will select the columns that will be contained in the report Please select here the required columns and press Next You will go to the next step of the wizard In the second step of Log Report Wizard you select the filter that will extract messages from XACS Log with required property The view in this option is similar to 77 the XACS Log option located in Projects option and therefore for more details please refer to the section that describes this option After all press Finish button that ends the wizard procedure The report will be listed in the new window You can now print the report using Print option of your browser Sample Log Report is shown in figure 32 Note Displaying the report page may take some time when the XACS Log database is large 2 D2 34 O Lngm Tert kLDO Cakna FL al SIb H Dz J4 00 Loge Test kLDOO mermon cb sksrbed dert id 14 let 2 DNA Loge Test elo Easson 361 created Chert id 14 i53 2 DS AR Z0 Login Test Task instance 240 craated Tamplate id 2 zi amp z H lr 3 DO Login Test Tack inztancp 30 tprmminated Status i i61 0 OSU Login Test bingo Seman S60 Derminated Eet code Oo i D GS SUL Oe Lege Test be Seman ep searted Chant id 15 Tiss o H3 314 00 Lei Text bingo Tajin 160 created Chart id 15 TLE E 03 2UL 300 Logn Tert T
60. hen you fill in all the fields you can add parameter to the database by clicking Apply button If you want to abort or cancel the operation click Back 65 H ere A Lapin ede P B cl rr I i z Datu typa Fam 4 Paramnpigar PER T cinsknation Tange onl gues on EE Ear H wahi D IS amay aria Ando Hidden Mandabory Gg 7 Figure 26 The view in Add parameter for target option 6 2 3 2 Update Parameter Click on the Update button located next to the selected parameter A new window will appear with the fields with the same meaning as described in Add parameter option When you have changed the desired field click Apply to save changes in the database or Back to abort or cancel the edition 6 2 3 3 Remove Parameter Click on the Remove button located next to the selected parameter to delete this target parameter from the database 66 6 3 Users This option is available in the main menu of the X Configurator When you choose this option the new view see figure 27 displays all defined users It contains the following information e Jd displays unique identifier of the user in the database e Login name Login name for the user used for logging into X Configurator e Full name Full name of the user i e first name and last name of the user Id Loge rame Ful name Fiara Lhe 9
61. hese names in the LUA scripts For example at the end of the script you can return error code XACS SUCCESS that means script has been successfully executed and doesn t matter what happened before this in the job file maybe connection to target failed Predefined name XACS_SUCCESS 0 Success XACS_SCRIPT_TRACE 1 Scripttrace AACS DATABASE ACCESS ERROR EE Database access error XACS CONFIG READ ERROR Error reading setup data X amp CS RUN SCRIPT ERROR a Erorronning soie XACS_SCRIPT_INTERRUPTED 6 Sessioninterupted terminated by scheduler XACS CREATE TASK ERROR 1 8 Error creating task instance XACS CREATE SESSION ERROR 9 Error creating session XACS UPDATE TASK ERROR Error update task instance status XACS UPDATE SESSION ERROR XACS NO MATCHING CLIENT FOUND 12 No client matches event condition XACS ERROR IN EVENT EXPRESSION 13 Error in event condition expression XACS MISCELEANOUS ERROR XACS CRON STRING PARSE ERROR Error parsing cron string XACS CRON STRING EMPTY 16 Time conditions not specified for repeatable task XACS CONNECTING STARTED Connection establishment started 81 7 2 Index of XACS LUA functions and XACS LUA variables Index of the XACS LUA functions Index of the XACS LUA variables com reject number ARGV com connect string com CIPMask com_disconnect com ClPValue kom send sting com sendfilelocalremote
62. his is preferred way to do debug printouts This is because it is much faster and overloads database write log EventCode Severity Message DebugLevel This function writes to XACS Log The parameters are e EventCode valid XACS event code Event codes are listed in XACS Event Codes section e Severity event severity The values are 0 info 1 warning 2 error 3 fatal error e Message optional text to be written to log e DebugLevel message debug level 3 3 XACS variables Below XACS LUA predefined variables are listed The variables defined for devices other then ISDN are not listed here ARGC This is an integer variable equal to number of script command line options This will always be at least 1 as first argument the script receives is its file name ARGV This is an array storing script command line options Remember that in Lua arrays indexing starts with 1 not 0 as in C language First element of this array is script file name This is sample code that lists script command line parameters EN while i lt ARGC do write Argument number format 96d i is ARGV i n i i 1 end com CIPMask ISDN CIP Mask com ClIPValue ISDN CIP Value com ISDN B1 ISDN B1 protocol com ISDN B2 ISDN B2 protocol com ISDN B3 ISDN B3 protocol com ISDN Calling Number Calling number You may have to set this variable when making calls through PABX systems com_ISDN_ctrl_connec
63. ield and click Update to save changes in the database 43 6 1 9 17 Remove Target Parameter To remove particular parameter from the target profile click on Remove button next to the appropriate parameter name 6 1 10 Target Groups This option appears when you choose particular project name in Project option of the X Configurator This option helps you to group targets into one group for example based on their location One group can contain other target group This allows you to create hierarchy of the target groups The sample view in this option is shown in figure 14 COUR p AA Configurator Target Groups in project Default Ww Group names Description Parent Group Target List fuese Forge group l eaa 2 Bee pera voro Eryo aerea tat gets roe ADU freer XIII ues Ba 161 Barzen me BUTS Faron exidiremcvo baga Mao iiri x1T000 Femme Bx S nore mm uint iL ES arican dn TEE Sm cuicirarrcenm hagrh amaa L bork vi Figure 14 The sample target groups configured in Target Groups option of X Configurator 44 6 1 10 1 Create New Target Group If you want to create the new target group click on the New target group button When you choose this option a new window will appear which will allow you to define the following properties e Group name in this field enter the name for the new created target group e Description optiona
64. ill be empty One controller can have more than one MSN number 76 6 5 2 3 Add MSN You can add new MSN number in MSN List window To add new MSN number to the list press Add button in the top right corner of the window New Add MSN window will appear with the following fields e Controller number input here controller identifier for which you want to assign MSN Controller with this identifier must exists Refer to section Add Controller for information about adding new controllers e MSN to listen for incoming calls enter MSN number that will be associated with this controller One controller may have more than one MSN number When you fill in all fields click Add button to add a new MSN 6 5 2 4 Remove MSN You can remove existing MSN number listed in MSN List window To delete MSN number from the list click on the Remove button next to the selected MSN 6 5 2 5 Update MSN You can modify parameters of existing MSN numbers and associated controllers in MSN List window To modify selected MSN number first make desired changes in appropriate fields then click Update button next to the changed MSN number 6 6 Reports This option is located in the main menu of the X Configurator and allows you to create the reports from the sessions to the targets routers Reports contain particular messages from the XACS Log for example for selected target task 6 6 1 Log This option is located in Reports option of t
65. ing INSTRUCTION 1 gt INSTRUCTION 2 INSTRUCTION 3 INSTRUCTION gt end The information from this tag is displayed when you choose Script info button Meaning of each column which appears in a new window is described below e Function this column displays the name of the function defined in Function tag e Description this column displays the description for the function defined in Description tag s e Parameters this column displays the global parameters that are optionally used by this function and are defined in Globals tag If the function doesn t use global parameters then you don t have to write this tag If you do not define such tag in LUA script file for the function the window Describe of LUA script will be empty Note Tags for the functions contained in job script file are not mandatory 6 1 9 Targets Target represents configured device router and allows you to create a set of parameters that will be configured on this router target The target can inherit a set of parameters from any target profile selected as parent profile Each target is configured with a help of NAS So when you select Target option of the X Configurator you must create first NAS and then targets that will be served by this NAS The view for creating new NAS is shown in figure 10 When you select any NAS then new view appears with a list of targets served by this NAS see figure 11 36
66. ive On Call tasks and looks for associated target whose telephone number matches Calling Party number If it finds one the session is started Although CLID method looks nice and simple it has some disadvantages When remote device is mobile its number may change To support such kind of remote devices the X Configurator provides another incoming calls handling method called Active 2 5 2 Active method In Active method remote device makes ISDN call to the X Configurator The XACS Scheduler rejects the call As this is ISDN connection scheduler sees Calling Party number To avoid some disadvantages described in CLID method section in this method XACS Scheduler makes login session to calling number before it analyzes tasks It runs the special script which retrieves information from remote device which can be used as unique identifier This can be e g device MAC address or serial number When this special session completes scheduler searches On Call tasks but does not look at target s Branch ISDN login telephone number Instead if evaluates LUA language expression which has been returned by the job script The expression should uniquely identify the target The script which is used for Active incoming calls handling is configured in Setup option of the X Configurator The script must set special variable called client_selection_rule For example if we want to find client based on its MAC address the script sho
67. ke start every Thursday on 10 PM On Call Starts the task for specified target in e Rule for ag case of incoming call calling number e g match last N digits Number of calling number digits to match according to Rule On Event Starts the task when event occurs Event name This start type is to be used with external software 2 3 On Time Tasks On Time tasks are quite simple to explain task template is triggered when the specified time is reached Task instance is created and so are the sessions to all targets associated with the task template This does not mean that the system tries to call all targets at the same time Targets are being called when communications channels e g B channels become available 2 4 Repeatable Tasks Repeatable tasks can be used when you want some activity to be performed repeatedly e g every Thursday on 10 PM You will specify appropriate time conditions at creating time of the task template of this type 2 5 On Call Tasks The idea behind On Call task is that user requests configuration session on its own calling central site NAS The system supports two incoming calls handling strategies CLID method and Active method 2 5 1 CLID method CLID method is simple remote device makes ISDN call to the X Configurator The XACS Scheduler rejects the call As this is an ISDN connection scheduler sees Calling Party number Then it searches all defined and act
68. l Figure 21 The sample view in Task Manager option for appropriate project 6 1 12 1 Activity Matrix This window displays matrix see figure 21 The first row contains a list of defined tasks The first column contains the list of all defined targets In the intersection points you can execute actions represented by the following icons L e Click on this icon to view the portion of the XACS Log for this task and target s S e Click on this icon to view the session log for the target s included in the task D e Click on this icon to run the task for the specific target Additionally next to each target you will see the graphic status of configuration state for this target You will see here the following icons representing different configuration states of the task instance v e This icon indicates that configuration of this target was successfully executed All sessions associated with this task instance completed successfully i e their error code is 0 e e This icon indicates that an error occurred during configuration process All sessions associated with the task instance completed but some of them have been successful and some failed e e This icon indicates that this target s is not configured It means that 54 target was not configured at all or his state was manual set up target parameter configure_state Not configured This icon indicates that the task instance is running configuration process fo
69. le property 6 1 7 2 Remove NAS Profile When you choose NAS profiles from Project option of the main menu of the X Configurator a new view will appear with a list of all defined NAS profiles names If you want to remove selected NAS profile click on Remove button next to the appropriate profile name The selected NAS profile will be deleted from the database Note 1 The currently logged user who wants to remove the profile must have required user s rights to execute this action 2 f you cannot view the list of profiles in this option check the user rights for the currently logged user Such situation might occur if the user has No rights set in user rights section 33 6 1 7 3 Update Parent for NAS Profile In Parent field you can set the parent profile for the currently created NAS profile To do this simply designate the appropriate NAS profile name from the list and choose Update parent The NAS profile doesn t have to have a parent profile 6 1 7 4 Add Parameter to NAS Profile To add a new parameter to the current NAS profile select appropriate parameter from drop down menu and click Add parameter Then enter the value for this parameter in Value field next to the added parameter To apply value for this parameter simply click on Update button next to the appropriate parameter If you do not see parameters in drop down menu it means that you have to create parameters for the NAS first Please refer to section Parameters
70. ller and in Number of channels input number of B channels which you can use simultaneously For example if your router is connected to the ISDN BHI you can use 2 B channels if router is connected to ISDN PHI there are 30 B channels available for you Mark Used for listening option to allow the controller to answer incoming calls from the targets If this option is off then X Configurator can only dial out and cannot serve incoming calls Once controller is added in ISDN option then choose MSN option Now you can add new MSN number for the previously added controller In MSN to listen for incoming calls field input MSN number that allows the X Configurator answer the calls See description for ISDN option of the X Configurator for more information 21 5 3 Configuring Setup option of X Configurator Before you start using the X Configurator you have to configure some global data This is made in Setup option of the X Configurator For more information please refer to the description of this X Configurator s option 5 4 Creating accounts for the X Configurator users You will need to create users that will be able to operate in the X Configurator You will find more information about how to create new user and how to assign appropriate user s rights in the description of Users option of the X Configurator You should configure at least one user Administrator with full access to entire X Configurator 5 5 Create the new project for
71. lly you can add a description of the new created target group e Parent group select from the drop down menu appropriate parent group This is not mandatory If you don t choose any parent group group Everyone is taken as a default e Target list select from this window targets which will belong to this group Click Save to add the definition of new target group to the database 6 1 10 2 Update Target Group If you want to change any information associated with particular group i e name or description enter the information in selected field and click on Update button next to the appropriate target group The information will be changed and written to the database 6 1 10 3 Add Target to Target Group If you want to add a target to selected group click on the Add Remove target button next to the appropriate target group name A new view will appear containing two windows In the left window you will see the list of defined targets not included in this group If you want to add any target select it from the list and click on Add In the right window there is a list of targets contained in the current group 6 1 10 4 Remove Target from Target Group If you want to remove a target from selected group click on the Add Remove target button next to the appropriate target group name A new view will appear containing two windows In the right window you will see the list of targets contained in the current group If you want to rem
72. ly this kind of events 7 Session interrupted filter and display only this kind of events 8 Deadline reached session terminated by scheduler filter and display only this kind of events 9 Error creating task instance filter and display only this kind of events 0 Error creating session filter and display only this kind of events Error update task instance status filter and display only this kind of events Error update session status filter and display only this kind of events No client matches event condition filter and display only this kind of events Miscellaneous error filter and display only this kind of events 1 1 1 1 1 1 16 Error parsing cron string filter and display only this kind of events 1 1 2 3 4 Error in event condition expression filter and display only this kind of events 5 6 7 Time conditions not specified for repeatable task filter and display only this kind of events 18 Connection establishment started filter and display only this kind of events 19 Online filter and display only this kind of events 20 Connection failed filter and display only this kind of events 2 2 22 Error opening script filter and display only this kind of events 23 24 25 Service started filter and display only this kind of events 1 Login failure filter and display only this kind of events 1 Connection terminated filter and display only this kind of events
73. nge O73 Leg Tut Leg Tast Completed DK e D luby 00 12 00 02 D Au 00 12 00 07 seasons BTA Ligii oan Lagn Tout Completed CK dis D July 00 12 05 08 D fuly 00 12 02 08 engen BTE Log Test Login Test Completed OF do D luiy 00 12 10 02 D Du 00 12 15607 nions STA Login Tast Login Test Completed Ok gy f luhy 00 12 18 02 Dech 00 12 18 n7 senicms SIT Login Tast Login Tast Completed OF dis O6 Juby 00 12 20 08 Dech 00 17 D I DT eagieng ATE Login Tast Login Test Complotad OF dis O6 July 00 12 25 02 Dech 00 22808 samienn BTB Login Tazt Login Test Completed OF dis D6 luly 00 12 20 02 D Jufy 00 13 80 E semina tri pope nam page lat page PTH i21 IN tal iyi isi TE L Lee Figure 17 The sample view in View Task Instances option 50 Task Sessions id Targat naa Job rane Status Erno Code Emor cade add Error best refrsah 2539 L000 AE Completed d Succes O dete eg J es Figure 18 The sample messages in Task Sessions Log 51 aloo inb name ADDI Job argumenta Status Compt ped i Start date 13 1uy 2000 14 DO 52 Bed date 12 1uy 2000 14 D1 38 Beatles 13 July 2000 14 06 22 Retry count Teir Ma D Eror Cede Success Eror code add D Errar teat Figure 19 The sample view in Details option located in Task Sessions 52 Xacs Log Event Seventy Tee Sore Tat Sammon Cent Joh Message Semap J56 imrmaabed Ext code ra IER configuring
74. nt profile for the currently created target profile To do this just designate the appropriate target profile s name from the list and choose Set parent The target profile doesn t have to have a parent profile Each target has to have parameters that allow to dial out to this target ISDN number login name and login password These parameters can be taken from target profile called Default login profile which is predefined and supplied with the X Configurator 30 6 1 6 5 Add Parameter to Target Profile To add a new parameter to the current target profile select chosen parameter from drop down menu and click Add parameter button Then enter the value for this parameter in Value field next to the added parameter To apply value for this parameter simply click on Update button next to the appropriate parameter If you do not see any parameters in drop down menu it means that you have to create parameters for the targets first Refer to section Parameters for targets for more details 6 1 6 6 Update Value of Target Parameter To update the value of parameter input its new value in the field and click Update button to save changes in the database 6 1 6 7 Remove Parameter from Target Profile To remove a parameter from the target profile click on Remove button next to the appropriate parameter name 6 1 7 NAS profiles NAS profiles allow you to create a set of parameters that will be configured on each NAS point central router
75. or the new created NAS parameter Short name enter the short name of the parameter that will be configured This name is important and is used in the X Configurator job scripts The button Copy from Name allows you to copy the name of the parameter from Name field Data type this field allows you to set up the type of the parameter You can choose between 1 Byte select this type if the parameter represents the small positive integer number 0 255 2 INT16 select this type the parameter represents 16 bits integer number 3 4 5 INT32 select this type the parameter represents 32 bits integer number String select this type if the parameter represents text string IP Address select this type if the parameter represents IP address For example IP network mask 6 Password select this type if the parameter represents password For security reasons such parameters should be encrypted and invisible for everyone 7 Version select this type if the parameter represents version For example firmware software version 8 Date time select this type if the parameter represents date and time Parameter destination here you can define where this parameter can be used You can choose and apply this parameter in 1 Projects select this option if this parameter will be used in project 2 NAS configuration select this option if this parameter will be used in configuration of NAS 3 Target con
76. ou can optionally set up the following options grouped in Debug level section e Trace errors mark this field if you want to write error messages to the XACS Log e Trace task mark this field if you want to write to the log messages from task execution If this option is marked information about the time when task was started and finished is written to the XACS Log e Trace session states mark this field if you want to write to the log messages from the session states If this option is marked information about the time when session was created started and finished is written to the XACS Log e Trace session scripts mark this field if you want to trace the execution of the job script e Trace session scripts ext mark this field if you want to trace in details the execution of the job script e Internal trace mark this field if you want to have the detailed trace from the system state This option produces a large amount of information that is written to the XACS Log Default value for this option is set to off and should be changed to on only if necessary 29 To have a good idea of what happened in the system you should turn on debug for at least first four options Note 1 Each target has to belong to one NAS 2 Each target has to have parameters that allow to dial out to this target ISDN number login name and login password These parameters can be taken from target profile called Default login profile whi
77. ove Target Parameter sein c e ota e SU de Me wake nid 44 en E a EE EE EE 44 6 1 10 1 Create New Target Group 45 6110 2 Update Target Group scito tie UE REN A RARE RUE 45 6 1 10 3 Add Target to Target Group acu itr EE EST 45 6 1 10 4 Remove Target from Target Group 45 6 1 10 5 Remove Target Group 45 6 1 11 Task Templates EEN 46 6 1 11 1 Create New Task Template 46 6 1 11 2 Update Task Template AEN 48 6 1 11 3 Add Remove Target to from Task Template 48 6 1 11 4 Add Remove Target Group to from Task Template 49 0 1 11 5 INCUIN EE 49 EN T3160 Deactivate EE 49 BT EPIO EE 49 6 1 11 8 Remove Task Template roter re Etre caecos 49 6 1 11 9 View Task Instances cccceccceccecceecceccececeececcaeeceeceeeeceeseeceeeaeeceeeues 49 6 1 12 Task Manager s erede terree A LAE A EAM LE UE 53 6 1 12 1 Activity Matrix EE 54 p 1 42 2 SYSTEM JAOUVIDY EE 55 SX IBN XACS OG EEN 55 DEE ahaa aA Aa aa ANAS A UU CD EE 58 6 2 1 Project e een 59 62271 be ele RE an EE 59 6 2 2 Update Parameter E 61 6 2 1 3 Remove Parameter ee deer et dee 61 ee E 62 6 22 De RE 62 6 2 2 2 Update EE NEE 64 6 2 2 3 Remove Parameter 64 6 2 3 Target parameters esoe 64 6 2 3 1 Add TEE 64 p 2 3 2 Update EE 66 6 2 3 3 Remove e 66 Dia USES ae e a a a e eea 67 DARUM RU MMC DP C 67 GE Ee EE 68 D 9 3 ele d 68 Sree fe HAR FV Eech 68 6 2 5 Change Pas
78. ove any target select it from the list and click on Remove In the left window you will see the list of defined targets not included in this group 6 1 10 5 Remove Target Group If you want to remove selected target group simply click on Remove button next to the appropriate target group name This will remove the definition of a target group from the database 45 6 1 11 Task Templates Task template groups together the following information List of targets or and target groups Job which has to be run for all those targets Start conditions To be able to make configuration process for the router target user must define task template which will realize this You can create Task templates from Project menu of the X Configurator by selecting the appropriate project name In figure 15 is shown the sample view in Task Templates option EJ Task Templates in project Default Dd Task Templbe rame Description Flite Type D r hath template Od Teri ap trgde oavemowr cwnn 3 jen configuration exemple af moss eddie mera oupi miri vies hok instances i Sage Chea update nddiremer oteepl 43 claar rta cunfig rmar ica mies nel re ree gevun viis hoa instances Farage ced nt E sspe nddiremeee cent uite D jrizeearz update Gn E1000 amp nd E A ZT mmia gH ER OEE Bist EJ eddie mae maupi n g r Irak insimanzes Login Test em Beda miram mnn 2 EmrmrpLms tesk to log on bergart Bi ede
79. r timeout Receives incoming data until number of characters is received or timeout elapses timeout is in ms Returns string of received data and received data length com_receiveline Receives incoming data until newline character OxOA is received Returns string of received data and received data length com send string Sends string Returns number 1 successfully sent 0 send failed Binary data can be sent using hex2str function com sendfile local remote Send file using Z modem remote parameter is optional If not specified remote file name is the same as ocal Returns number 1 file sent 0 send error com receive file remote local Starts receiving file using Z modem protocol Returns number 1 file received 0 receive error hex2str string Converts parameter string to sequence of bytes Returns LUA string which can contains 0 characters It can be used to send non ascii characters eg com send hex2str 0DOA include file string Runs LUA file specified in parameter string It does the same as LUA native do file function but searches XACS job script path to find requested file system string Runs program specified by string Actually this calls C language system function write dbg string Sends string to X Configurator debug output Debug output can be viewed with ctrld exe program Although scripts can also write XACS Log database t
80. r any target is in progress This is initial state Instance stays in this state as long as not completed sessions associated with this task instance exist e This icon indicates that the task instance state is unknown You will find more information about session states and task execution in the XACS Scheduler and Task instances states sections 6 1 12 2 System Activity This part of the Task Manager window see figure 21 represents system activity and displays messages from the XACS Log You can set up here the following options e Refresh time time in second for refreshing the information in this window e History time time in minutes defining how old messages should be displayed in the window e Max task maximum number of rows displayed for each task To change the values of the parameter input the correct value and click Update Note If the currently logged user doesn t have the Admin user s right Task Manager window will appear as default User who doesn t have Admin right cannot access all menu options of the X Configurator 6 1 13 XACS Log The XACS Log option is located in Project section of the X Configurator You can view the log of particular project Once you have chosen a project messages from the log will appear You can use filters to extract messages that interest you from the XACS Log You may choose multiple selection which will allow you to select for example Info and Warning severity at once
81. rget group section Finally you have to make this task visible for the XACS Scheduler Now you have to activate the task template For tests purposes you can run the task to start configuring the target s You will find information from task execution in the XACS Log and in View task instances Additionally you can use Task Manager option to check the system activity 5 5 4 Watch the X Configurator state You can view the system state in the following ways e in Task Manager option located in Projects to see the task activity matrix and the current system state e in XACS Log option located in Projects to view the log from entire X Configurator By choosing this option you can use filters to extract interested portion of log e inthe View task instances you can see the log from sessions and messages from the XACS Log for the selected task 23 Chapter 6 Menu options Figure 2 shows the main menu of X Configurator On the left there is the menu with options that can be selected All these menu options are described in the following chapter Note that such view appears only when logged user has Admin user right and therefore has access to the all menu options of X Configurator es EE us Ir 3f Welcome W Configurator TDATA Choose optan from let menu Ka a al Led Program mgr L Oginga Dangi bii Jbt Ta Cie FUZ Eis tations cke Copyrighr Figure 2 Main menu of X Configurator user logged with Admin user
82. rom the database 6 3 4 User Rights This window see figure 28 allows you to assign or change the rights of the selected user Each of user s rights gives the user access to particular option s of the X Configurator Projects grant access to the Projects option User grant access to the Users option Profiles grant access to the Profiles option Setup grant access to the Setup option Target grant access to the Targets option Task grant access to the Tasks Template option Job grant access to the Jobs option Report grant access to the Reports option Log grant access to the XACS Log option NAS grant access to the NAS option You can assign the following rights to the user that apply to particular option of the X Configurator e None if this checkbox is marked user has no rights to access this option of the X Configurator e Read if this checkbox is marked user has right to read view information from this option of the X Configurator e Create if this checkbox is marked user has right to create new objects i e project user task in particular option of the X Configurator i e Projects Users Report 68 e Change if this checkbox is marked user has right to change properties for this object i e project user task in particular option of the X Configurator i e Projects Users Setup e Delete if this checkbox is marked user has right to delete object i e project
83. s and their meaning State Description Running Task instance is running This is initial state Instance stays in this state as long as not completed sessions associated with this instance exist Completed OK All sessions associated with the instance completed successfully i e their error code is 0 Partially Failed All sessions associated with the instance completed Some of then has been successful and some failed Totally Failed All sessions associated with the instance completed with failure As session record stores information about its completion result and error text if any this is main source of information for the system user View tasks instances option located in Task Templates or Task Manager option are helpful as it stores global parameters summary task instance status and duration 2 2 Task start conditions Activities to be performed by X Configurator are defined in terms of task templates Task template basically consists of three elements job to be done list of targets target groups to service and its start conditions Task template start conditions are constraints which have to be fulfilled to start the task Start conditions will define Task type The following start types will be available Start Type Description Parameters Time Starts the task at specified date and _ time mE Starts the task on time conditions Ld cron like string Time conditions are li
84. s rights 6 1 Projects Project is a set of task templates jobs and targets clients It contains all necessary information about installation and configuration process The X Configurator realizes the control modifications and user s identification in each project In order to access project data user has to log in to the system Every type of user Administrator Project Manager Operator Hotline End User is given a set of rights which state his privileges in entire X Configurator The rights for different types of users can be configured in section Rights of the Users option menu By choosing different rights for different types of user you can limit rights of some users to only viewing the appropriate data from the project others to modifying data and others to having full access to the entire system Figure 3 shows the view that appears when you select Project option of X Configurator 24 xXACE amp Project management project Default Expat le projerr x El updahe deicrg amp inn Project parameters Nama Vsus migediy i sl mardsinr readaniy ni Fe mme upishe m Ee amea upetote odd por orrerler J s8 Figure 3 The view in Projects option of X Configurator 6 1 1 Create New Project This option is available in Project option of the X Configurator In order to create new project first enter the appropriate name in the New project name field and then click Create project to write the changes to the d
85. s the XACS Scheduler waits before retrying session to the target For example 80 Script Path Set of directories in which scheduler searches for LUA scripts to execute when job s filename does not specify full path Directories names should be separated with semicolon E g c xacs script Global debug level Global debug level is used by the XACS Scheduler to mask its debug database output Debug level for specified session is of this field OR target s debug level configured in Targets option To set debug level you can OR the following values Errors 0x0001 Error trace This is default value Task Trace 0x0002 Task instances creation and status change Session States Trace 0x0004 Session creation and status change Session Script Trace Basic 0x0008 Printouts from scripts 72 Session Script Trace Extended 0x0010 Extended printouts from scripts Internal Trace 0x0100 Flag for highest level internal debug e Identifier of the job used for incoming call handling Identifier of the job used for incoming call handling when value in ncoming calls handling method field is Active e Incoming calls handling method Values 1 CLID Session is started when Calling Number matches target s telephone number 2 Active When there is an incoming call XACS Scheduler starts job which is specified by the field dentifier of the job used for incoming call handling This job calls Calling Number and makes I
86. sWord oie a raa aapa aaa ae aTa EAEn Ka Aa ERAKAR EEan 70 6 3 6 Reset PAS WO EE 70 S Mo ETE 71 SES ID Tm 73 6 5 T ISDN COMMOIETS 3rd or rU EDU uactande vant ROLE REVENU REL teens Ceu onei Enise eg 73 65051 FING OG oDILOT8E oss roe Ore De Ro Or Deas D Plan orn alor p RE RUD 74 BL 2CcGontrollB EE 75 9 51 83 Add Controller 1 55 oo ieiuno b edi ie Chote a alice p eee eee 75 6 5 1 4 Remove Ren EEN 75 6 5 15 Update ell 75 6 5 2 ISDN MSN EE 75 See NI Find MSN EEN 76 p 52 ZOMSNEHSU 1a AMOUR AU 76 E We odis EE 77 0 582 41 REMOVE Wo MEN T4 p 5 2 5 Update MON eoi diei sco YU c Ld d vd e uio IRA hd A Rea cid 77 EG ee EE 77 SF cya EE DEE 77 E EE eet EE 78 Ee EE 78 BO EE ee eege ee 79 Chapter Ee ee 81 7 1 AACS event e 81 7 2 Index of XACS LUA functions and XACS LUA vanables eeen 82 Chapter 8 Troublesbootng uk NENNEN 83 Eom vct 85 Chapter 1 System overview 1 1 What is X Configurator X Configurator is a service delivery management tool which supports the BinTec router family X Configurator provides an efficient delivery model of new managed services for medium and large enterprises Installing a router or adding new features to the remote router like e g adding new WAN partners changing CHAP passwords or configuring interfaces is fully automated and trouble free X Configurator automates and instantly reduces costs for the following tasks MASSIVE ROLLOUT AND INSTALLATION SCENARIOS NEW SERVICE CREATION
87. sessions when number of sessions exceeds the value set in Number of session entries field 2 Older than number of days remove sessions older than the value set in Number of days to store sessions field 3 No automatic session delete do not remove sessions automatically In this case you can delete records manually Number of days to store sessions this field is shown if Session record limitation type Older than number of days This parameter describes how many days particular session should be stored in database Number of session entries this field is shown if Session record limitation type Number store session Number of sessions to be stored in database Number of entries to delete field is shown if Session record limitation type Older than number of days or Session record limitation type Number store session Number of sessions removed in one truncate Number of task retries Default number of retries for a new task This parameter says how many times task can be retried when an error has occurred during the execution Enter here 0 zero if you don t want to retry Task duration Default time of task duration given in seconds For example 360 Task start type Default task start type The X Configurator offers the following task types On Time Repeatable On Call On Event For more details see also sections Task start conditions and XACS Scheduler Session retry timeout Time is second
88. sk and sessions execution in the XACS Log and sessions log even though the task was started Solution Check if you have setup the appropriate debug level for the target s included in the task template Problem see the message Connection failed Last error 0 Result Call Answer error Code Timeout CAPI code 0 in session log for the task Solution Make sure that in ISDN option of the X Configurator you have configured at least one controller s with identifier 1 and have assigned MSN number for it For more information please refer to section Installing Remote CAPI for Bintec routers and Configuring ISDN channels for using by X Configurator 83 Problem have installed Remote CAPI XACS Scheduler is started but configuration process cannot be started Solution After installing Remote CAPI you must change properties for XACS Scheduler service To do this open Control Panel window and then Services From the services list select XACS Scheduler and press Startup button Set up Log On Ae option to This Account Now enter appropriate account name and password Now log on as different user if necessary and restart XACS Scheduler service For more information please refer to section Installing Remote CAPI for Bintec routers 84 List of Figures Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8 Figure 9 Figure 10 Figure 11 Figure 12 Figure 13 Figure 14 Figure 15 Figure 16 Figure
89. sk template defined and activated scheduler checks if start conditions have been met If yes it creates task instance referred also as session One session is created for every target in task template Session has status field which keeps track of session execution state This field is updated by XACS Scheduler Session can be repeated automatically by XACS Scheduler in case of a failure Task template can be started in two ways Outbound central site X Configurator initiate a call Inbound remote device initiate a call 1 4 Meaning of Task Templates Task templates are defined in Projects option of X Configurator Task templates define static of the system Task templates groups together the following information e List of targets or and target groups e Job which has to be run for all those targets e Start conditions Dynamic of the system is represented by tasks instances and sessions Sessions represent script execution for a single target When task start conditions are fulfilled task template is triggered e g task instance is created 1 5 Meaning of Jobs Job is a script written in LUA programming language X Configurator embeds LUA extended with communications functions ISDN connection establishment and termination and data exchange Actual job script is stored in file You can use either plain text script files or compile the file to binary to hide source code 1 6 Meaning of Targets The target means r
90. states Trace session scripts C Trace session sorpes az IT kawta traca Incoming cals handing method Top um Figure 29 The view in Setup option of X Configurator You can find here the following fields Log size limitation type This parameter says when the log file should be truncated You can choose between 1 Number of entries remove oldest log events when number of entries exceeds value set in Number of log entries field 2 Older than number of days remove log entries older than date set in Number of days to store log field 3 No automatic log delete do not remove log events automatically In this case you can delete records manually e Number of log entries this field is shown if Log size limitation type Number of entries Log size is limited to this number of records e Number of days to store log this field is shown if Log size limitation type Older than number of days The number of days that log events are stored 71 Number of entries to delete field is shown if Log size limitation type Number of entries or Log size limitation type Older than number of days The number of entries that will be automatically deleted when log exceeds certain number of events or when events in log are older than number of days specified by user Sessions record limitation type This parameter says when the session log should be truncated You can choose between 1 Number store sessions remove oldest
91. t Number of ISDN controller for outgoing calls com ISDN ctrl listen Number of ISDN controller for incoming calls com device Communications device type The following types are defined XCOM ISDN Device XCOM TCP Device XCOM Modem XCOM NULL Modem The variables listed above are predefined global variables These variables can be read and written by LUA job script Chapter 4 Configuration scripts development guidelines The X Configurator uses embedded LUA language interpreter for configuration scripts jobs The X Configurator can write any valid LUA script there are however some rules that must be followed to write the proper XACS configuration script The script is supplied by XACS Scheduler with set of pre defined variables These are e Extension variables described in XACS Variables section e Static parameter of target NAS and project These are project identifier NAS identifier target identifier target name target debug level e All dynamic parameters of target Some of these parameters are used are used by the XACS Scheduler These are use default login This variable tells the scheduler whether to use target s own or default user password for ISDN login Script should set this flag to Disable 0 when it changes targets login parameters and set it to Enable 1 when is restores login defaults at target device e All dynamic parameters of NAS e auto login name and auto lo
92. t be running under Windows NT 4 0 Currently WEB Console can be browsed and managed using Internet Explorer 5 0 but in the future will support Netscape Navigator too 1 3 System operation summary X Configurator uses task template target client and job Task template is the entity which tells what when and for whom should be done Task template groups together the following information e List of targets to service List of target groups to service Identifier of the action job to perform Start task conditions Task template task stores both target and target groups information Only one action can be defined for a task This might seem to be a strong limitation but it is not in fact Since actions in the system are written as scripts you can group things to be done in script including many files in one Having only one action job per task allows avoiding unnecessary redundancy The action to perform in task template is defined by job The job is a script written in LUA programming language X Configurator embeds LUA extended with communications functions ISDN connection establishment and termination and data exchange Task template has a list of targets associated with it When a task is started the job is performed for all targets associated with task template The target is defined by number of parameters including its name phone number IP address netmask etc All these parameters can be referred to by job Having ta
93. the target When you choose this option new view will appear see figure 26 with the following fields e Name enter the description string for the new created target parameter e Short name enter the short name of the parameter that will be configured This name is important and is used in the X Configurator job scripts The button Copy from Name allows you to copy the name of the parameter from Name field e Data type this field allows you to set up the type of the parameter You can choose between 1 Byte select this type if the parameter represents the small positive integer number 0 255 INT 16 select this type the parameter represents 16 bits integer number INT32 select this type the parameter represents 32 bits integer number String select this type if the parameter represents text string IP Address select this type if the parameter represents IP address For example IP network mask 6 Password select this type if the parameter represents password For security reasons such parameters should be encrypted and invisible for everyone 64 7 Version select this type if the parameter represents version For example firmware software version 8 Date time select this type if the parameter represents date and time e Parameter destination here you can define where this parameter can be used You can choose and apply this parameter in 1 Projects select this option if this parameter will be us
94. uld retrieve MAC address from remote device 2 6 On Event Tasks On Event task requires some additional explanation The idea is to let third party software activate the task Activation method should be flexible It should allow not only task but also target selection Event is record in xacs_events table The process which wants to activate the task should insert row into this table Event_name field of the table is the name which is task template parameter The XACS Scheduler watches xacs_events table If the entry is inserted there it searches all task templates of On Event start type to find matching event name The task can contain more than one target Using this method we can specify exactly for what target the task should be activated when the event occurs E g if we want to activate the targets whose geographical location contains word Hamburg we will input the following in the Client selection rule field of the task template strfind location Hamburg nil If we want to activate the target which branch is 007 the conditions will be even simpler branch 007 The following operations can be done on task template Activate Makes the task active i e visible to scheduler Task will be executed when its running conditions are fulfilled Makes task template inactive i e not scheduled Run immediatel This runs the task immediately Any task template no matter what its start type
95. usually located at central site The NAS profiles can be organized hierarchically therefore one profile can inherit all parameters from other profile i e from parent profile When you choose a particular NAS profile a new view will appear with a list of all targets served by this NAS Note Each target has to belong to one NAS 31 e Project Default XA amp C amp Profiles management 7 n Has name Dap ZK M mage reme 7 Les van more P Rew HED 7 EE odd fare HAH Cn Tosa Figure 7 The view in NAS profiles option of X Configurator 6 1 7 1 Create New NAS Profile You can create a new profile in a project by selecting desired project from the Projects option of the X Configurator and then choosing option Profiles When you choose NAS profiles a new window will appear with a list of NAS profiles associated with this project The list will be empty if you haven t configured any NAS profile before In the field New profile name enter required name for the NAS profile and click on the Create new profile button New profile will be added to the database Note 1 Each target has to belong to one NAS 2 You have to have appropriate user s rights to be able create new NAS 32 Project Default NAS NAS 001 parameters Penn Proin moot mne Happ Value cdd pGoremgebar EN Parameters from profile d hone Vale Index e bock Figure 8 The sample view with NAS profi
96. w will appear showing you Target Activity matrix This is the best way to view the status of the entire system and the appropriate target For example you can start here desired task for selected target The window of the Task Manager consists of two panes The top pane shows the Activity Matrix for all defined tasks and targets in the system The bottom pane displays the current System Activity Figure 21 shows sample view in this option 53 TargetiActivity matrix 2 i at anmi oien D 7 binga fous REI 2 ime BH ausy ors 3 ELO egt s DL RB d DL RB d DL d LU vum ooo 8 me s 4 Busy H an E ka E aiim F o naadi amar d renne back Ratrash tiapzec D History aire I Mar tack ro VE update ort Eum Taek Target Status Eet pode Test I15E 55 3 Login X100 DOU T Gurgen Cal Sg Test ep 0p L I bing Sucess Calling ESE Logn Sue LE 55 03 Test SLISCH Conplelead Buren Login beat dca Enc full St Login i Sonrmction Connpcrinn faded Lasi ama o Basuh Call angwar ama Code mr LEGEEI rent bingo Competed failed DISCDOMMPCT MD CAPI code 1490 Logn sid ee S Concho Connection faded Lert error C Sank Callanewer armor Codec LDII8 rest ling Compe zg DIBCOMMECT JMD CAP code 3490 15 ire A IER DUI Competed Burrzmns kogn best macpesxstull Login 2 Coommgchr Connectnn faded Lait armor O Senub Cal aniwar error Code EE Leer LEE DEE el DIBCONMECT IND CAPT code 3490 innn B

XACS User`s Manual - Xnet Communications GmbH

Contents

Download Pdf Manuals

Related Search

Related Contents