jfqbi= = eqji=qççäâáí= = = eqji=^ééäáå~íáçå=réäç~çéê== rëéê=dìáçé= oéäé~ëé=oko=
oéäé~ëé=oko = HTML Application Uploader User Guide NOTICE The information contained in this document is believed to be accurate in all respects but is not warranted by Mitel Networks Corporation (MITEL ). The information is subject to change without notice and should not be construed in any way as a commitment by Mitel or any of its affiliates or subsidiaries. Mitel and its affiliates and subsidiaries assume no responsibility for any errors or omissions in this document. Revisions of this document or new editions of it may be issued to incorporate such changes. No part of this document can be reproduced or transmitted in any form or by any means - electronic or mechanical - for any purpose without written permission from Mitel Networks Corporation. TRADEMARKS Mitel and M MITEL (design) are registered trademarks of Mitel Networks Corporation. Other product names mentioned in this document may be trademarks of their respective companies and are hereby acknowledged. Mitel HTML Toolkit HTML Application Uploader User Guide Release 2.2 September 2010, Trademark of Mitel Networks Corporation Copyright 2010, Mitel Networks Corporation All rights reserved ii
Table of Contents OVERVIEW... 1 USING THE UPLOADER... 2 Main Form... 2 Purpose of the Form...3 Parts of the Main Form... 3 The Menus... 3 Selecting the Group or Switch to Upload To... 4 Selecting File(s) to be Uploaded... 4 Updating the List of Files...5 The Clear Selections Button... 5 The Upload Button... 6 The Display Target Files button... 6 The HTML App Upgrade button... 7 The Status/Messages Area... 7 Previously Used Files and Groups... 7 UPLOADING A FILE... 8 Purpose of the Form...8 Parts of the Form... 8 Using the Form... 9 The Connectivity Test... 9 Uploading the File... 9 Protection against overwriting R1 apps... 11 VIEWING AND DELETING HTML APPLICATION FILES... 12 THE HTML APP UPGRADE COMMAND... 16 MANAGING SWITCHES AND GROUPS... 20 Purpose of the Form... 20 Groups and Switches... 20 Overview of Using the Groups and Switches Form... 21 Introduction to Using the Group and Switch Management form... 21 Creating a Group... 21 Creating a Switch... 24 Copying... 25 iii
HTML Application Uploader User Guide Various Parts of the Form... 28 Summary Part (the top of the form)...28 Displaying Groups or Switches... 29 Show Details / Hide Details button... 29 Add a new group / Add a new switch button... 29 Exit button... 29 List of Groups for a switch or Switches for a Group... 30 Detail Information...31 Detail Information for a Group....31 Detail Information for a Switch...32 Usernames and Passwords... 33 Passive Ftp... 34 Other Operations...34 Deleting a Switch... 34 Deleting a Group... 34 Saving and Restoring Data...35 Exit the Form... 35 COMMAND LINE MODE...36 Syntax:... 36 Specification of files...36 Examples:... 37 Return Codes... 37 Restrictions... 38 TROUBLESHOOTING...39 Errors when Uploading... 39 Unknown host...39 Time-out...39 Cannot connect to switch...39 Invalid Username or Password...39 Failed to get the one-time Userid/Password... 39 iv
Table of Contents LIST OF FIGURES Figure 1 - HTML App Uploader Form...2 Figure 2 - Attempting to exit while an upload is in progress...3 Figure 3 - Selecting a target...4 Figure 4 - Selecting a group from the list of groups...4 Figure 5 - The file selection area...4 Figure 6 - The file chooser window to add new files to the list...5 Figure 7 - The Upload button...6 Figure 8 - Attempting to upload to an empty group...6 Figure 9 - The Display Target Files button...6 Figure 10 - The HTML App Upgrade button...7 Figure 11 - The Uploading Form...8 Figure 12 - An upload in progress...10 Figure 13 - A successful upload...10 Figure 14 - An upload that has errors...11 Figure 15 - An R1 app cannot be overwritten...11 Figure 16 - The DisplayTarget Files button...12 Figure 17 - The Manage Remote Files window...12 Figure 18 - The file list window(no files selected)...13 Figure 19 - The file list window (with some files selected)...14 Figure 20 - The Manage Remote Files window after files have been deleted...15 Figure 21 - Messages while trying to delete files...15 Figure 22 - The Abort button is available evrn though there is an hourglass cursor...16 Figure 23 - The HTML App Upgrade button...16 Figure 24 - The App Upgrade window...17 Figure 25 - The HTML App Upgrade command in progress...18 Figure 26 - All switches have been processed...18 Figure 27 - Errors during viewing target files...19 Figure 28 - Group and Switch Management Form...20 Figure 29 - Switching between displaying groups and switches...21 Figure 30 - Adding a new group...21 Figure 31 - The form when adding a new group...22 Figure 32 - Adding a group...23 Figure 33 - The summary part shows the new group...23 Figure 34 - Changing from displaying groups to displaying switches...24 Figure 35 - Creating a new switch...24 Figure 36 - Selecting a group for this switch...25 Figure 37 - The new switch now appears in the summary part of the form...25 Figure 38 - The Copying menu item...25 Figure 39 - Copying a switch...26 v
HTML Application Uploader User Guide Figure 40 - Copying a switch just before saving...27 Figure 41 - The new switch appears in the summary information part of the form... 27 Figure 42 - Copying a switch that was in a group means the new switch is in that group... 28 Figure 43 - Dragging the divider line allows changing the ratio of space for summary and detail information... 28 Figure 44 - The summary part of the form... 28 Figure 45 - Sometimes the radio button is disabled (greyed out)... 29 Figure 46 - Switches are not sorted initially... 30 Figure 47 - Switch names sorted in ascending order... 30 Figure 48 - Switch names sorted in descending order... 30 Figure 49 - Detail information for a group... 31 Figure 50 - Confirmation of deleting a switch... 34 Figure 51 - Confirmation of deleting a group... 34 Figure 52 - The saving and restoring data menu items... 35 vi
HTML Application Uploader User Guide Overview The HTML Application Uploader is used to upload applications to one or more switches. The HTML Application Uploader has two functions: 1. To maintain information about switches and groups of switches 2. To upload a package file to one of these switches or to all switches in a group. A package file is a specially formatted file produced by the HTML Application Packager tool - another component of the HTML Toolkit. (See the HTML Application Packager User Guide for more details.) 1
HTML Application Uploader User Guide Using the Uploader Main Form When the program starts, the following form appears: Figure 1 - HTML App Uploader Form 2
Table of Contents Purpose of the Form The HTML App Uploader form has three basic functions: 1. To define targets: switches and groups of switches 2. To select a file or files to upload and a target to upload them to. 3. To initiate the upload of the file(s) to that target. Defining switches must be done before any uploading can be done. This information does not have to be entered each time the program is run; it is saved, as is the list of files recently used. Since the group and switch information changes infrequently, a typical use of the program is to simply select a file and a group, and then initiate the uploading. Parts of the Main Form The main form consists of: a menu area an area to select the target (switches and groups of switches) and to maintain this list of switches an area with actions to apply to the target (upload to it, view its files, issue the HTML App Upgrade command on it) a list of files to be uploaded an area of messages The Menus The top of the form has two menus. 1. The File menu contains three items: View current log to invoke an editor on the current log file. View previous log to invoke an editor on the previous log file. Exit to exit the program. The Exit menu is not allowed while files are uploading. Attempting to exit the program while an upload is present produces the warning You must cancel the ftp or wait. Figure 2 - Attempting to exit while an upload is in progress 3
HTML Application Uploader User Guide The Help menu contains two items: User Manual shows the User Manual. About displays the name and version of the program. Selecting the Group or Switch to Upload To The target selection area consists of A radio button to select the type of target: a switch or a group of switches. A drop down menu to select a particular switch or group. A button labelled Edit. Figure 3 - Selecting a target Depending on whether a switch or a group has been selected by the radio button, pressing the arrow button displays the list of switches or groups. Click on one to selected it. Figure 4 - Selecting a group from the list of groups Changing between group and switch mode clears any selected group or switch, and clears any selected files. Clicking on the Edit button launches a separate window to manage switch and group information. This must be done before any files can be uploaded. This is described in Section 0 Managing Switches and Groups Either a switch or a group must be selected before the Upload button is enabled. Selecting File(s) to be Uploaded Below the target selection area is a list of known files, a button to add new files to the list, a button to remove files from the list, and a button to unselect files. Figure 5 - The file selection area 4
Table of Contents Before uploading can be done, at least one file must be selected from the list. Clicking on a file selects it and de-selects any other files that were selected. To select more than one file, press the control key and click on the filename. Controlclicking actually toggles that file from the selection, so to remove a selected file without affecting the rest of the selection control-click on the line again. A contiguous range can be selected by first clicking on one end of the range and then pressing the Shift key while clicking on the other end of the desired range. The selection is cleared when toggling between group and switch mode, and when data is changed using the Managing Switches and Groups form. It can also be cleared with the Clear Selections button. Updating the List of Files A file can be added to this list by clicking the Add a new file to the list button. This pops up a file chooser window where one or more files can be selected. When its Open button is clicked, the selected file(s) are added to the list. These newly chosen files are automatically selected. Figure 6 - The file chooser window to add new files to the list Only filenames ending in.spx may be selected. Files can be deleted from the list by selecting them and then pressing the Remove selected file(s) from the list button. Note that this button is disabled if there isn t a file selected. The Clear Selections Button This button de-selects any selected files. The main use of this button ensures that no files are selected when a new switch or group is chosen, so that the files previously associated with this switch or group are automatically reselected, as explained in section 0 Previously Used Files and Groups. 5
HTML Application Uploader User Guide The Upload Button When a target and at least one file has been selected, then the Upload the Selected File button is enabled. Figure 7 - The Upload button Clicking this button brings up a separate form to control the uploading. This is described in Section 0 Uploading a File. Attempting to upload to a group that is empty produces an error message. Figure 8 - Attempting to upload to an empty group The Display Target Files button Figure 9 - The Display Target Files button This is used to display files on the selected switch or group, and to be able to delete some of them. This is described in chapter 0 Viewing and Deleting HTML Application Files. 6
Table of Contents The HTML App Upgrade button Figure 10 - The HTML App Upgrade button This is used to issue the HTML App Upgrade command on the selected switch or group. This is described in chapter 0, The HTML App Upgrade command. The Status/Messages Area At the bottom of the form is an area showing status information, warning and error messages and other important information. Error and warning messages that are displayed in the status area in the Uploader Form (described in section 0 Uploading a File ), the Manage Remote Files (section 0 Viewing and Deleting HTML Application Files ) and the HTML App Upgrade window (section 0 The HTML App Upgrade command ) also appear in this window. Previously Used Files and Groups When the Upload the selected file button is pressed, the program records the list of files associated with the group or switch being uploaded to. The next time that Switch or Group is selected, and there are no files currently selected, those previously selected files are re-selected. (Any of those files that are not in the list are put back into it.) If, however, any files were selected when a switch or group is selected, then the selected files are left unchanged. When the program starts, it attempts to set the current switch or group to the last one used on an upload. Consequently, when the program starts some files may be initially selected. 7
HTML Application Uploader User Guide Uploading a File The Upload the selected file button in the main form (section 0) invokes the uploading form. Purpose of the Form The form is used to initiate an upload operation and to monitor its progress and to show its status. Parts of the Form Figure 11 - The Uploading Form The summary information at the top of the form shows the group or switch being uploaded to, the number of files, and the basenames of the files (or the first several of them if there are many). There is a checkbox to issue the HTML App Upgrade command. If this is selected, then after successfully transferring the files to each switch the upgrade command is done on that switch before going on to the next switch in the list. The list of the switches and the status of each is displayed next. The next area displays status and error messages and two buttons. The values for the status area are discussed below. 8
Table of Contents The warnings and errors displayed in the status area are also copied to the status area on the main window. This allows them to be visible after this upload form has disappeared or is being used for a different file or group. Using the Form If the filenames, switch or group is not the desired one, the Exit button at the bottom can be used to dismiss the form without starting any transfer. Otherwise, the Upload button should be pressed to start uploading. When this button is pressed, the Exit button is relabeled to Abort all ftp operations. This is used if is necessary to cancel any upload operations that have been started. The status of all the switches is set to Pending. The Connectivity Test Before uploading to a switch, a connectivity test is performed to check that the switch can be reached. If the switch cannot be reached, the status is changed to Error. If the switch can be reached with a simple ping command but fails this connectivity test, it may be necessary to turn on passive ftp mode for this switch; see section 0 Passive Ftp. Uploading the File If the connectivity test succeeded, the uploading begins. If the file already exists, it is overwritten. If the upload was successful, the status is changed to Done. If there were errors uploading the file the status is changed to Error. If there were any errors encountered, then a message displays in the status area of the form. This may be helpful for troubleshooting. When all of upload attempts have been completed (whether successful or not) the button labelled Abort all ftp operations reverts being labeled Exit. Clicking it will dismiss the form. 9
HTML Application Uploader User Guide Pressing Upload again will repeat the entire operation. Figure 12 - An upload in progress Figure 13 - A successful upload 10
Table of Contents Figure 14 - An upload that has errors Protection against overwriting R1 apps The uploader only allows uploading, viewing and deleting R2 (or later) apps. It also protects against overwriting an R1 app. Figure 15 - An R1 app cannot be overwritten 11
HTML Application Uploader User Guide Viewing and Deleting HTML Application Files When a switch or group has been selected, the Display Target Files button on the main form is enabled. Figure 16 - The DisplayTarget Files button When that button is pressed, a form pops up showing the group or switch name, the list of applicable switches along with a status for each. Figure 17 - The Manage Remote Files window If there is more than one switch in the list then one of them has to be selected (by clicking on it) to enable the Get Filelist button. If there is only one switch in the list it is automatically selected and the button is enabled. 12
Table of Contents When the button is pressed an FTP connection is made to the selected switch to get the list of files, and the switch s status field in the Manage Remote Files window is set to Retrieving file list. The mouse cursor for this window changes to an hourglass. A new window pops up displaying the switch name, the group name if there was more than one switch and the list of files in the html apps directory (/db/htmlapps/apps) for that switch Note: There may be a noticeable delay before this form pops up because of the time to establish an ftp connection to get the list of files. Only regular files whose names end in.spx in that directory are displayed; subdirectories are not shown. Files that are for R1 apps are also not shown. The list is initially sorted by filenames. By clicking on the column headers it can be sorted by name, size or date. Clicking again in the same header toggles the sort between ascending and descending order. Figure 18 - The file list window(no files selected) To delete files first select them. Click anywhere on a line to select a single file. If the control key is pressed when clicking, the current line is toggled: if it was not selected it now is selected, if it was selected it is now cleared. This allows selecting multiple files. To select a contiguous range of lines, click on the first of these then hold the shift key while clicking on the last of them. 13
HTML Application Uploader User Guide If files are inadvertently selected, the Unselect all button can be used. Figure 19 - The file list window (with some files selected) When at least one of the files has been selected, the Delete selected file(s) button is enabled. The label of the button is changed to reflect the number of files to be deleted. If this button is pressed the selected files are deleted from this switch only. If a group was selected and there was more than one switch in it, then the second button Delete on all switches in group is also enabled. If this button is pressed the selected files are deleted from all the switches in the group. In either of the cases the window disappears and the Manage Remote Files Window shows the status. If deleting on the entire group, then all the status fields are set to Pending, and as deletions are done on a switch its status field is set to Deleting and then to Done. Click the Close button if there are no files to be deleted. When deleting a file on all the switches in a group, if there was a failure deleting on one switch this does not stop it attempting to delete this file on other switches in the group. 14
Table of Contents Figure 20 - The Manage Remote Files window after files have been deleted If files are deleted, a summary per switch appears in the Manage Remote Files window. If there are any errors, they also appear in the Messages area: Figure 21 - Messages while trying to delete files The mouse cursor now reverts from an hourglass to its normal shape. 15
HTML Application Uploader User Guide The Get Filelist button can be used again, possibly after selecting a different switch, to repeat the process. The Exit button closes this form. Although the Manage Remote Files window displays the hourglass cursor while a file view or delete operation is happening, the Abort button is always available. Figure 22 - The Abort button is available evrn though there is an hourglass cursor This can be used to terminate the entire operation. The HTML App Upgrade command The HTML App Upgrade command must be issued on a switch for it to use the R2 apps uploaded. There are two ways of issuing this command in the uploader: 1. There is a checkbox button to run the command after uploading to a switch. This was described in chapter 0 Uploading a File. 2. A button on the main form allows sending the command to a switch or a group of switches. Figure 23 - The HTML App Upgrade button 16
Table of Contents When the HTML App Upgrade button on the main form is pressed, a new popup window appears. Figure 24 - The App Upgrade window This shows the selected group or switch name, the list of switches, and a status for each. Initially each status is blank. When the Start button is pressed all the status fields are set to pending, and then the HTML App Upgrade command is sent to each switch in the list. 17
HTML Application Uploader User Guide Figure 25 - The HTML App Upgrade command in progress When all the switches have been done a final Finished message appears in the Messages area. Figure 26 - All switches have been processed If any errors occurred, they are displayed in the Messages area too. 18
Table of Contents Figure 27 - Errors during viewing target files 19
HTML Application Uploader User Guide Managing Switches and Groups Groups and switches are defined by invoking the Edit button next to the group and file selector in the main form. The following form is displayed: Figure 28 - Group and Switch Management Form Purpose of the Form This form defines (and later modifies) switches and groups of switches. The form can also make a backup file of this data (the groups and switches), and restore data from this backup. Groups and Switches A switch is a Mitel 3300 ICP that is to receive an HTML app information in the form of a package file. Switches may be put into a group. This allows uploading files to many switches in one operation. A switch can exist in more than one group. 20
Table of Contents Overview of Using the Groups and Switches Form The users decides the order of creating groups and switches. A group can be created first, and then switches, and the add them to this group. Alternatively, one can create switches first and then create a group that contains them. The Group and Switch Management form can display information about groups and about switches, and operates in two modes: Summary mode and Detail mode. A radio button at the top of the form shows and controls whether it is displaying information about groups or switches. Switching between summary and detail modes is described below. The form starts up in Summary mode. Introduction to Using the Group and Switch Management form To explain how to use this form, we will perform the following steps: - create a group - add a switch to it - add a second switch to this group by copying A more complete description of the form will follow. Creating a Group First, check that Manage Groups is selected; if not, click on the circle next to it. Figure 29 - Switching between displaying groups and switches Now, click the Add a new group button Figure 30 - Adding a new group 21
HTML Application Uploader User Guide The detail part of the form appears. Since this is a new group, it will be empty. Figure 31 - The form when adding a new group The name of the group must be entered; the comment and location fields are optional. Hint: Because the comment appears in the detail part of the window and can be sorted, information about similar groups allows these groups to appear together. Notice that as soon as any data is entered, the appearance of the form changes in several ways: - the background colour of the detail part changes (from light green to light red); - many of the buttons that were previously enabled are now disabled, including the radio buttons to switch between groups and switches; - some buttons that were previously disabled are now enabled, such as the Save changes and Cancel Changes buttons. 22
Table of Contents Note that we cannot add a switch at this time because no switches have been defined yet. The Add a Switch area is disabled in this particular example. Figure 32 - Adding a group After entering the data, click the Save changes button. The detail part of the form disappears, and the summary part of the form (the top part) now shows this new group. Figure 33 - The summary part shows the new group More groups can be added if desired. 23
HTML Application Uploader User Guide Creating a Switch Click in the circle next to Manage Switches; the form now changes to display information about switches (instead of groups). Note that some of the labels on the form have changed; for example, the button previously labeled Add a new group is now labeled Add a new switch. Figure 34 - Changing from displaying groups to displaying switches Click the Add a new switch button. Again, the detail part of the form is filled in, but this time with empty switch information. Figure 35 - Creating a new switch Enter a switch name and the userid and password for this switch. These three fields are mandatory. The location and comment fields are optional. If passive ftp mode is required for this switch (see 0 Passive Ftp ), then click on the button. 24
Table of Contents Because we have a group defined, the Add a group button is now enabled. Clicking on the arrow shows the available groups; at the moment there is only one. Select it. Figure 36 - Selecting a group for this switch Now, click the Save Changes button. The form now reverts to summary mode (the detail part disappears), and the new switch is shown in the summary part. Figure 37 - The new switch now appears in the summary part of the form We could add a second switch to this group in a similar manner. However, if this switch is very similar to an existing switch an easier way is to copy this switch. Copying Both switches and groups can be copied. Switches are described here; the procedure for copying a group is similar. Copying a switch means to create a new switch that initially is the same as the original switch. To copy a switch, first select the original switch in the summary part of the form so that its detail information is shown. The Edit menu item contains two items that are now enabled; choose Copy Switch. (Note that this menu item is only enabled when the form is in detail mode.) Figure 38 - The Copying menu item Click on Copy Switch menu item, and the form will show detailed information for the switch being copied. 25
HTML Application Uploader User Guide Figure 39 - Copying a switch Notice that several of the labels in the form are different from before. The Save changes button now displays Save copy, and the Cancel changes button displays Cancel copying, to remind you that saving the data will create a new copy of the switch, rather than changing the original. Now, change the information in the detail area for this switch. You must change the name before saving a copied switch or group. For a switch, the address field should also be changed. Other values (both fields and the list of groups this switch is part of) may be changed if desired, or they can be left the same. 26
Table of Contents In this example, the switch name and address are changed but the rest of the data remains the same. In particular, because the original was part of group group 1 (and we are not changing this) the copy will also be a member of this group. Figure 40 - Copying a switch just before saving Click the Save Copy button when done. The form reverts to summary mode, and both switches are displayed. Figure 41 - The new switch appears in the summary information part of the form Now click on the Manage Groups button to cause the form to display information about groups instead of switches. Click on the line for the group group 1 to show its detail; it will now show that it contains two switches: 27
HTML Application Uploader User Guide Figure 42 - Copying a switch that was in a group means the new switch is in that group Various Parts of the Form The various parts of this form are now described in detail The form always has a summary part at the top, and when it is showing details has a detail part at the bottom. Between these two parts is a divider line. This can be dragged up or down with the mouse to change the ratio of how much of the window is displaying the summary information and how much is displaying the detail information. Figure 43 - Dragging the divider line allows changing the ratio of space for summary and detail information Summary Part (the top of the form) This part of the form is always visible when the form is being displayed. Figure 44 - The summary part of the form It contains three menus: a radio button to switch between groups and switches; three buttons; and a list showing all the groups or all the switches. 28
Table of Contents Displaying Groups or Switches At the top is the radio button that shows whether groups or switches are being displayed. Whether the form starts out displaying switches or groups depends: 1. If the form was previously been displayed (and since closed) it reverts to the previous setting. 2. Otherwise, it reflects whether on the main form groups or switches are being uploaded to. If the buttons are enabled they allow switching between showing groups and switches. It is disabled (it appears as greyed out ) when the form is in detail mode and there have been changes to the current group or switch. Figure 45 - Sometimes the radio button is disabled (greyed out) In such a case the changes must be saved or cancelled before one can switch between displaying group and switch information. Underneath this are three buttons. One is labeled either Show Details or Hide Details; one is labeled either Add a new switch or Add a new group, and one is labeled Exit. Show Details / Hide Details button. If the form is in summary mode this button is labeled Show Details; if the form is in detail mode this button is labeled Hide Details. The Show Details button is only enabled when one of the entries below it is selected (for example, using the up and down arrow keys). Pressing the Show Details button is one way to enter detail mode. (Another is to click on the entry.) The Hide Details button causes the form to enter summary mode. This button is disabled if there are any unsaved changes. Add a new group / Add a new switch button The Add a new group or Add a new switch button is used to create a new group or switch. When pressed, the form will change to detail mode with empty fields for all the values. This button is disabled when changes have been made in detail mode and when copying. Exit button The Exit button is used to exit the form. If there are any unsaved changes, a dialog box appears indicating that the changes must either be accepted (saved) or discarded. 29
HTML Application Uploader User Guide List of Groups for a switch or Switches for a Group The rest of the summary part shows the list of all the groups or all the switches. There is one line for each group or switch. If there are more groups or switches than will fit in the area then a scroll bar is displayed. When the form is in summary mode, clicking on a line will enter detail mode for that group or switch. If there are no unsaved changes, then clicking again on the same line will revert to summary mode, while clicking on a different line causes the form to stay in detail mode but to display information for the newly selected group or switch. The order of the entries being displayed can be changed by clicking on the title for that column. The first time this title is clicked the column is sorted in ascending order (and a little triangle appears pointing upwards), the next click changes the sort to descending order (and a little triangle appears pointing downwards). For example, if the switches initially appear in the order they were created, like this: Figure 46 - Switches are not sorted initially then clicking on switch name column sorts the list by the switch name in ascending order Figure 47 - Switch names sorted in ascending order and if the same title is clicked again that column is now sorted in descending order: Figure 48 - Switch names sorted in descending order 30
Table of Contents Detail Information When the form is in detail mode, it is split into two parts. The top part shows summary information (as before); the bottom part shows detail information for the selected group or switch. What shows in the detail part depends on whether a group or switch is being displayed. Detail Information for a Group. Figure 49 - Detail information for a group This shows the name of the group, its location and a comment. The group name is mandatory; the location and comment are optional. Any of these three fields may be changed. Normally, changing the Group name field means that the group is being renamed. When the changes are saved the old group name will not be available. However, while the detail for the group is being displayed the Copy Group menu item in the Edit Menu is enabled. Selecting this entry means that the original group will be unchanged and the values in the detail part will be saved as a new group. This of course means that the group name must be changed. This is described in section 0 Copying. At the bottom of the form are the switches currently in the group being displayed. If there are any switches defined that are not in that group then the Add a switch area is enabled. Clicking the arrow displays a list of available switches; clicking on any adds them to this group. Conversely, if any lines of the switch are selected then the Delete selected switch(es) button is enabled; clicking on it will remove the switches from that group. (The switch information itself is not changed.) 31
HTML Application Uploader User Guide At the bottom are two buttons. Initially they are labeled Save Changes and Cancel Changes and they are both disabled because there are no changes. As soon as any change is made on the form, then the background colour of the form changes and the buttons are enabled. If the group is being copied, then these two buttons are labeled Save copy and Cancel copying. The Cancel copying button is enabled immediately. If no changes have been made, then: - the form can be reverted to summary mode by pressing the Hide Details button (in the summary part of the form) - the form can be reverted to summary mode by clicking on the line in the summary part for the group being displayed - the form can remain in detail mode but display a different group by clicking on a different line in the summary part - the form can be reverted to summary mode for switches by pressing the Manage Switches radio button - detail information for one of the switches listed for that group can be shown by double clicking on one of the switches listed in the Switches for group area. Pressing the Save Changes will attempt to save the changes made. If this cannot be done (for example, if the group name were changed to the name of an existing group) a popup window will appear and the information will remain in the form. Otherwise, the form will revert to summary mode. Detail Information for a Switch A switch contains a name, a username and password, and may contain a comment and a location, an indication of whether passive ftp is required, and a list of groups this switch is part of. Any of these fields may be changed. Normally, changing the Switch name field means that the switch is being renamed. When the changes are saved the old switch name will not be available. However, once the detail for the switch is being displayed the Copy Switch menu item in the Edit Menu is enabled. Selecting this entry means that the original switch is unchanged and the values in the detail part will be saved as a new switch. This of course means that the switch name must be changed. The bottom of the form displays the groups that the switch is part of.. If there are any groups defined that do not currently contain the switch being displayed, then the Add a group area is enabled. Clicking the arrow displays a list of available groups; clicking on any adds this switch to that group. Conversely, if any lines of the group are selected then the Delete selected group(s) button is enabled; clicking on it will remove this switch from those group(s). 32
Table of Contents At the bottom are two buttons. Initially they are labeled Save Changes and Cancel Changes and they are both disabled because there are no changes. As soon as any change is made on the form, then the background colour of the form changes and the buttons are enabled. If the switch is being copied, then these two buttons are labelled Save copy and Cancel copying. The Cancel copying button is enabled immediately. If no changes to any of the data have been made, then: the form can be reverted to summary mode by pressing the "Hide Details" button (in the summary part of the form) the form can be reverted to summary mode by clicking on the line in the summary part for the switch being displayed the form can remain in detail mode but display a different switch by clicking on a different line in the summary part the form can be reverted to summary mode for groups by pressing the Manage Groups radio button detail information for one of the groups listed for that switch can be shown by double clicking on one of the groups listed in the Groups for switch area. Pressing the Save Changes will attempt to save the changes made. If this cannot be done (for example, if the switch name were changed to the name of an existing switch) a popup window will appear and the information will remain in the form. Otherwise, the form will revert to summary mode. A change to the data in this form may invalidate selected fields on the main form. So a save operation in this form clears any selected group of switch, clears any selected files and disables the Upload the selected file button on the main form Usernames and Passwords The switch data contain the real Userid and Password for the switch. The userid must be a user that has System Admin access for that switch The password is not displayed in the form, instead stars are displayed. When the password is entered or changed, a popup dialong box asks for confirmation of the password (because it is not shown on the form). 33
HTML Application Uploader User Guide Passive Ftp The Passive ftp? box is normally left unchecked meaning that passive mode is not enabled. It may be required to enable passive mode if the computer running this program is behind a firewall or a router with NAT (Network Address Translation) turned on. If the connectivity test (see section 0 The Connectivity Test ) fails, try activating passive mode. Other Operations From the summary part of the form other operations are possible. Deleting a Switch To delete a switch, select it and show its details. Confirm that this is the intended switch to delete, then select the Delete Switch from the Edit menu. A confirmation popup window will appear. Click the Yes button if you are sure. Figure 50 - Confirmation of deleting a switch Deleting a Group To delete a group, select it and show its details. Confirm that this is the intended group to delete, then select the Delete Group from the Edit pull down menu. A confirmation popup window will appear. Click the Yes button if you are sure. Figure 51 - Confirmation of deleting a group 34
Table of Contents Saving and Restoring Data The File menu contains two items to save and restore the data: Figure 52 - The saving and restoring data menu items The data can be saved (backed up) in a file and then later restored. This can be useful To prevent against accidentally destroying the data (entering a bad change) To recover from media damage (disk crash) or file system corruption To move the data from one computer to another. The data being saved consists of The switches The groups The list of package files When data is restored, it is added to any existing data. Exit the Form When all the changes have been made, the form can be exited either by clicking on the Exit button at the top of the form, or selecting the Exit menu item from the File menu. The list of available groups on the main form will be updated if any changes to groups have been made in this form. 35
HTML Application Uploader User Guide Command Line Mode Command line mode is entered when the uploader is invoked with at least one option. This is not an interactive mode; there is no scripting language for example. Instead, all user input is done with command line options. Syntax: The syntax is HtmlAppUploader [options] Where options are one or more of the following: -a Issue the HTMLAPPUPGRADE command after uploading files specified with the -f option. -f file... Specifies one or more files. This option is required unless either the -a or -h options are given. -h Displays a brief help usage. No other option is allowed with this option. -i Use passive mode ftp (the default is active mode) -l logfile Specifies a log file. If omitted, output is to stdout. -p name Specifies the password for the ftp request. This is required. -s name Specifies the switch. This must be specified and can be an IP address or DNS name. -t val Specifies a timeout in seconds. This is optional; if omitted there is no timeout. -u name Specifies the username for the ftp request. This is required. Specification of files Files can be specified with the -f option. Alternatively, a text file (new line delimited) can be created containing a list of filenames, and this text file may be specified prefixed with an atsign ('@') e.g. -f @filelist.txt This text file must contain only one file per line. Leading and trailing white spaces on each line are removed. 36
Table of Contents Examples: Assume the file C:\temp\filelist.txt contains the following 3 lines: c:\users\fred\app-one\stuff.spx c:\users\fred\app two\test.spx c:\users\fred\app-three\abc.spx In the following examples, each command line is one long line (it probably would be in a.bat file) and is written here as shorter lines with a \ character. HtmlAppUploader -u myuser -p mypassword \ -f c:\users\fred\app-one\stuff.spx \ "c:\users\fred\app two\test.spx" \ c:\users\fred\app-three\abc.spx -s 10.20.30.40 HtmlAppUploader -u myuser -p mypassword \ -f @c:\temp\filelist.txt -s 10.20.30.40 HtmlAppUploader -u myuser -p mypassword -s 10.20.31.45 -i -f c:\temp\packages\special.spx \ "C:\temp\packages\special demo\test1.spx" -t 120 -a Here the switch is behind a firewall, so passive ftp is used (the -i option) and a timeout value is used. HtmlAppUploader -u myuser -p mypassword -s \ icp31.mynet.wizzywig.com -i -f @files.txt a t Return Codes 0 All files successfully transferred to all switches. 1 There was a command line syntax error. No uploads were attempted. 2 There was a command line error. At least one file did not exist; or the switch was not a valid name or address. No uploads were attempted. 3 Some uploads were attempted, but at least one file failed to be transferred. 4 A timeout occurred before all files were transferred and the HTMLAPPUPGRADE command issued if applicable. 37
HTML Application Uploader User Guide Restrictions If the -h option is specified, no other options are allowed. The -a option may be used with or without files (the -f option): If no files are specified, the HTMLAPPUPGRADE command is performed on the switch immediately. If files are specified, then the files are uploaded first, and only if all are successfully uploaded is the command issued. A switch must always be specified unless the -h option is given. Filenames that contain spaces must either be quoted if specified directly on the command line, or put in a text file using the @file syntax. Quotes should not be used on filenames in a @file (unless the filename actually has quotes). Filenames must end in.spx. Files that exist on the target as R1 application files cannot be uploaded. 38
Table of Contents Troubleshooting Most of the error messages are self-explanatory. Some of the more common messages and their probable causes are listed here. Errors when Uploading In most cases there will be multiple lines, with the first line being of the form Unable to upload to switch name (ip-address) Unknown host The switch name could not be resolved to an IP address. Time-out The switch could not be reached. This could be because the switch address is incorrect. Perhaps the switch is not running, perhaps there is a problem on the network. Cannot connect to switch The switch appears to be active but is not responding to FTP requests. Probably this is because the switch address is not for a valid ICP3300. Invalid Username or Password The userid or password is not correct for the switch; or the user is not a user that has System Admin privilege. Failed to get the one-time Userid/Password The switch could be connected to, but the one time userid/password failed. This could happen if the switch were rebooting when the upload were attempted. It could also happen if the host address is not actually an ICP3300. 39