Cisco IOx Local Manager Pages and Options
This chapter provides detailed reference information about the pages and options that are available in Cisco IOx Local Manager.
Cisco IOx Local Manager Tabs
Cisco IOx Local Manager includes the following main tabs in its menu bar. You use these tabs to access the Cisco IOx Local Manager pages:
- Applications tab—Displays the Applications page, displays general information about the Cisco IOx apps that have been uploaded to the host system, provides options for managing and administering them, and provides an option for adding a new app.
- Cartridges tab—Displays the Cartridges page, which lists the Cisco cartridges that have been installed on the host system, displays general information about these cartridges, and provides options for installing, deleting, and obtaining additional information about them.
- System Info tab—Displays the System Info page, which provides hardware, software, network, and resource information that relates to the host system.
- System Troubleshoot tab—Displays the System Troubleshoot page, which provides options for reviewing events, errors, and diagnostic information on the host system, and managing and obtaining log files and related information for troubleshooting.
- System Setting tab—Displays the System Settings page, which provides information about the range of NAT IP addresses that are reserved for app, and provides options for managing SSL connections and app signature validation
- Middleware Service tab—Displays the Middleware Service page, which lists the Cisco Data in Motion services that are available for apps, displays general information about these services, and provides options for starting, stopping, and uploading licenses for them.
- App-ID tab—When you click the manage option on the Applications tab for an app, a tab with the ID of that app is added to the menu bar. The App-ID tab displays the App-ID page, which provides access to pages for viewing information and performing other activities that relate to a specific app.
To remove an App-ID tab from the menu bar, hover your mouse over the tab and click its Close button .
On Cisco IOx Local Manager pages:
- You can click any field title in a table that displays rows of information to toggle the information in that table in ascending or descending alphabetical order by that field.
- On most pages that display information in multiple areas, you can click an area title to expand or collapse the information in that area
Applications Page
The Applications page lists the Cisco IOx apps that have been uploaded to the host system, displays general information about these apps, and provides options for managing and administering them.
It also provides buttons for adding an app and refreshing the page
To access the Applications page, choose Applications from the Cisco IOx Local Manager menu bar. Table 2-1 describes the fields and options that are available on this page.
|
|
---|---|
Each app that has been uploaded to the host system displays in an area that includes the following items: |
|
|
|
Resources profile that is assigned to the app (default, c1.tiny, c1.small, c1.medium, c1.large, c1.xlarge, or Custom) |
|
For an app that is in DEPLOYED state, blue shading indicates the relative amount of total memory (RAM) resources on a host system that the app requests. For an app that is in ACTIVATED, RUNNING, or STOPPED, state, green shading indicates the relative amount of total memory resources on a host system that is allocated to the app. The percentage value at the right of the bar indicates the percentage of total memory on the host system that is requested by or allocated to the app. |
|
For an app that is in DEPLOYED state, blue shading indicates the relative amount of CPU resources on a host system that the app requests. For an app that is in ACTIVATED, RUNNING, or STOPPED, state, green shading indicates the relative amount of CPU resources on a host system that is allocated to the app. The percentage value at the right of the bar indicates the percentage of total CPU resources on the host system that is requested by or allocated to the app. |
|
Appears for an app that has a status of ACTIVATED or STOPPED. Click to start the app. See the “Starting an App” section. |
|
Appears for an app that has a status of RUNNING. Click to stop the app. See the “Stopping an App” section. |
|
Appears for an app that has a status of DEPLOYED. Click to activate the app. See the “Activating an App” section. |
|
Appears for an app that has a status of ACTIVATED or STOPPED. Click to deactivate the app See the “Deactivating an App” section. |
|
Appears for an app that has a status of DEPLOYED. Click to remove the app from the host system. See the “Deleting an App” section. |
|
Appears when the app that has any status except DEPLOYED. Click to display the App-ID page for the app. See the “App-ID Page” section. |
|
Appears for an app that has a status of DEPLOYED. Click to upgrade the app. See the “Upgrading an App” section. |
|
Appears for an app is in running state if its descriptor file (package.yaml) file asks for visualization. Click to open a new tab that can show graphs and tables of data that relates to the app. The information that displays depends on what visualization information the app asks for. |
|
The first app that has does not include information for an installed app displays the following buttons: |
|
Uploads the app to the host system and puts the app in DEPLOYED state. See the “Adding/Deploying an App” section. |
|
Cartridges Page
The Cartridges page lists the Cisco cartridges that have been installed on the host system, displays general information about these cartridges, and provides options for installing, deleting, and obtaining additional information about them.
Cartridges are used by PAAS apps. The packages for these apps include only the app logic (such as Python or Java files), but not the Linux operating system files or the root file system that the app requires. Cartridges provide the root file system and Python or Java files that an app requires to run. See the “Cartridge Management Workflows” section for additional information.
Cartridges are not used by KVM, LXC, or Docker apps.
To access the Cartridges page, choose Cartridges from the Cisco IOx Local Manager menu bar. Table 2-2 describes the fields and options that are available on this page.
|
|
---|---|
Provides options that you can click to execute operations for the cartridge:
|
|
Installs the cartridge on the host system. See the “Installing a Cartridge” section. |
System Info Page
The System Info page provides hardware, software, network, and resource information that relates to the host system and to the Cisco IOx infrastructure and framework. The information that this page displays is not specific to any particular app.
To access the System Info page, choose System Info from the Cisco IOx Local Manager menu bar. Table 2-3 describes the fields and options that are available on this page.
System Setting Page
The System Setting page provides options for managing internal Cisco IOx networks for apps and managing SSL connections and app signature validation.
Internal Cisco IOx networks allow apps on host systems to communicate with other systems. The network named svcbr_0 is provided by default, and cannot be deleted. Some host systems allow other networks to be added.
If needed, refer to the app documentation or developer for information network configuration that an app requires when it runs.
To access the System Setting page, choose System Setting from the Cisco IOx Local Manager menu bar. Table 2-4 describes the fields and options that are available on this page.
|
|
---|---|
Click to add an internal network on host systems that support adding internal networks. See the “Adding an Internal Network” section. |
|
Name of the internal Cisco IOx bridge that provides connectivity for this internal network. |
|
Physical interface that the internal network uses for connectivity. |
|
Logical networks that provide bridge and NAT networking modes for the internal network. Click a logical network name to display a dialog box that provides detailed information about that logical network. |
|
Identifier of the VLAN on which this internal network operates, if applicable. |
|
IP mode of the internal Cisco IOx bridge that provides connectivity for this internal network (dhcp, static, or no_ip_address). |
|
IP address and subnet mask of the internal Cisco IOx bridge that provides connectivity for this internal network. |
|
|
|
Click to import a externally signed SSL certificate to the host system. |
|
Enable Application Signature / Disable Application Signature toggle button |
Click the Enable Application Signature button to enable App Package Signature Verification on the host system. When this option is enabled, the Cisco application-hosting framework verifies the signature of an app when the app is installed on the host system. If the app signature is not verified, the installation fails. Click the Disable Application Signature button to disable App Package Signature Verification on the host system. When this option is disabled, the Cisco application-hosting framework does not verify the signature of an app when the app is installed on the host system. |
Click to import a trust anchor (a.tar or.tar.gz certificate file) to the host system. Use the Import Trust Anchor dialog box that displays to locate and select the trust anchor that you want, and then click OK. If you enabled application signature verification, apps are validated against this certificate when they are added to the host system. If the validation fails, an app does not install. |
|
If a certificate already exists on the host system, click to display the certificate. If this certificate is the one that you want to use, you do not need to import a certificate. If you import a certificate, it replaces the one that exists on the host system. |
|
Displays the checksum value and metadata for each certificate that you imported. |
System Troubleshoot Page
The System Troubleshoot page provides options for reviewing events, errors, and diagnostic information on the host system, and managing and obtaining log files and related information for troubleshooting.
The options on this page are useful for troubleshooting the Cisco IOx framework. For related information, see the following sections:
- Viewing Events,
- Viewing Errors
- Log File Workflows
- Tech Support Information Workflows
- Core Dump File Workflows
- Downloading an App Log File
To access the System Troubleshoot page, choose System Troubleshoot from the Cisco IOx Local Manager menu bar. Table 2-5 describes the fields and options that are available on this page.
|
|
---|---|
Click to update the fields in the Events area with current information. The information in these fields does not update automatically while the System Troubleshoot page is displayed. |
|
The amount of time that has passed since the host system last started, shown as days, hours, minutes, and seconds. |
|
The amount of time that has passed since the Cisco application-hosting framework last started on the host system, shown as days, hours, minutes, and seconds. |
|
The following fields provide information about the number of items that have been written to the Cisco application-hosting framework log files since the Cisco application-hosting framework last started on the host system: |
|
Lets you display specific Events or Errors in the Events list or Errors list. See the “Viewing Events” section or the “Viewing Errors” section. |
|
Click to display the Events list. See the “Viewing Events” section. |
|
Click to display the Errors list. See the “Viewing Errors” section. |
|
Appears when you click the Events button. Displays information about events that have occurred on the host system. An event typically relates to a successful Cisco application-hosting framework operation. See the “Viewing Events” section. |
|
Appears by default or when you click the Errors button. Displays information about errors that have occurred on the host system and lets you view detailed information about an error. See the “Viewing Errors” section. |
|
Let you navigate the Events list or Errors list. See the “Viewing Events” section or the “Viewing Errors” section. |
|
Click to update the fields in the Logs area with current information. The information in these fields does not update automatically while the System Troubleshoot page is displayed. |
|
Click to configure the type and level of information that the host system captures in its log files. See the “Configuring Log Files” section. |
|
Choose the type of log files that appear in the Log File list. See the “Downloading Log Files” section. |
|
Displays information for each log file, according to the log type option that you choose. See the “Downloading Log Files” section. You can drag a border between column headings to resize a column. |
|
Choose the type of diagnostic information to obtain and display. See the “Diagnostic Information Workflow” section. |
|
Check this check box to display detailed diagnostic information in the Display field. See the “Diagnostic Information Workflow” section. |
|
Displays diagnostic information according to the Diagnostic Type option that you chose. See the “Diagnostic Information Workflow” section. |
|
Lists the names of snapshot files that you have generated. A file name has the format tech_support_ timestamp, where timestamp is the host system date and time that the file was generated. See the “Generating a Snapshot File” section. |
|
Click download to download the corresponding snapshot file to the location of your choice. See the “Downloading a Snapshot File” section. |
|
Click the Delete icon to delete the corresponding snapshot file from the host system. See the “Deleting a Snapshot File” section. |
|
Click to generate a snapshot file. See the “Generating a Snapshot File” section. |
|
Click to update the list of snapshot files with current information. |
|
Lists the name of core dump files that the system generated. |
|
Click download to download the corresponding core dump file to the location of your choice. See the Downloading a Core Dump File. |
|
Click the Delete icon to delete the corresponding core dump file from the host system. See the Deleting a Core Dump File. |
|
Click to update the list of core dump files with current information. |
Middleware Service Page
The Middleware Service page lists the Cisco Data in Motion middleware service that is available for apps, displays general information about this service, and provides options for starting, stopping, and uploading licenses for it. This service runs on the host system.
To access the Middleware Service page, choose Middleware Service from the Cisco IOx Local Manager menu bar. Table 2-6 describes the fields and options that are available on this page.
|
|
---|---|
Provides options that you can click to execute operations for the Cisco Data in Motion service. Options that appear depend on the status of the service as follows:
|
|
Indicates whether a license is required for the Cisco Data in Motion service to operate on the host system. |
|
App-ID Page
The App-ID page, where App-ID is the ID of an app, includes the following tabs. These tabs provide access to pages for viewing information and performing other activities that relate to a specific app.
- Resources tab—Displays the Resources page, from which you can assign various resources to an app, activate an app, and deactivate an app. See the “App-ID > Resources Page” section.
- App-info tab—Displays the App-info page, from which you can view system and network information that relates to an app. See the “App-ID > App-info Page” section.
- App-Config tab—Displays the App-Config page, from which you can update configuration information for an app. See the “App-ID > App-Config Page” section.
- App-DataDir tab—Displays the App-DataDir page, from which you can see the contents of the /data directory in an app container, upload files to the /data directory or subdirectory, download files to your local system, and delete files or subdirectories from the /data directory. The files can be configuration files or other files that the app needs when it runs. See the “App-ID > App-DataDir Page” section.
- Logs tab—Displays the Logs page, from which you can view information about and download app log files. See the “App-ID > Logs Page” section.
To access the App-ID page, choose the App-ID tab for the app from the Cisco IOx Local Manager menu bar.
If you do not see the tab for an app, choose the Applications tab, and then click the manage option for the app that you want.
To remove an App-ID tab from the menu bar by, hover your mouse over the tab and click its Close button .
App-ID > Resources Page
The App-ID > Resources page lets you assign a resource profile (host system CPU and memory resources) to an app, designate the network from which the app obtains its IP address, and activate or deactivate an app. This page also shows CPU and memory resources that are available on the host system.
If needed, refer to the app documentation or developer for information regarding resources that an app requires when it runs.
To access the App-ID > Resources page, choose an App-ID tab from the Cisco IOx Local Manager menu bar, and then choose Resources. Table 2-7 describes the fields and options that are available on this page.
|
|
---|---|
Provides options for designating the resource profile for an app. A resource profile designates the amount of host system CPU and memory (RAM) resources that the app requires to run, as follows.
See the “Activating an App” section for more information. |
|
Number of CPU units that the app requires on the host system. If you choose Custom from the Profile drop-down list, enter a value in this field. If you choose another option, the system enters a value in this field for you. |
|
Amount of RAM, in MB, that the app requires on the host system. If you choose Custom from the Profile drop-down list, enter a value in this field. If you choose another option, the system enters a value in this field for you. |
|
Amount of disk space, in MB, that the app requires on the host system. If you choose Custom from the Profile drop-down list, enter a value in this field. If you choose another option, the system enters a value in this field for you. |
|
Appears only for VM-based apps. Enter the number of virtual CPUs that the app requires on the system. If you choose Custom from the Profile drop-down list, enter a value in this field. If you choose another option, the system enters a value in this field for you. |
|
Number of available CPU units on the host system. The system does not allow you to activate an app if the value in the CPU field exceeds this available CPU value. |
|
Amount of available RAM, in MB, on the host system. The system does not allow you to activate an app if the value in the Memory field exceeds this available memory value. |
|
Appears only for VM-based apps. Number of virtual CPUs that are available on the host system. |
|
Designates the network from which the app obtains its IP address or addresses: |
|
Click to configure mapping of external ports to internal ports for an app. See Step 9 in the “Activating an App” section. |
|
Serial Access Configuration area Appears only if the app metadata requests that a serial port on the host system be assigned for use by the app. |
|
Identifies one or more serial ports on the host system that the app metadata requests for use by the app. Port_description is a description of the port usage that comes from the app metadata. Click the radio button for each port that you want to assign for use by the app. |
|
Click to activate or deactivate an app. See the “Activating an App” section and the “Deactivating an App” section. |
|
Appears only if the host system can provide this information and if the app metadata requests that a USB port on the host system be assigned for use by the app. |
|
Identifies one or more USB ports on the host system that the app metadata requests for use by the app. Port_description is a description of the port usage that comes from the app metadata. Click the radio button for each port that you want to assign for use by the app. |
|
Appears only if the host system supports this functionality. |
|
Enter a password for accessing an app via a VNC session. Use this password in the VNC client that you use to access the app. |
App-ID > App-info Page
The App-ID > App-info page displays system, resource, and network information that relates to an app. It also provides information that you can use to access an app via a console. Much of the information on this page comes from the app metadata.
To access the App-ID > App-info page, choose an App-ID tab from the Cisco IOx Local Manager menu bar, and then choose App-info. Table 2-8 describes the fields and options that are available on this page. Some of the fields on this page appear only when an app is in a specific state or has a specific configuration.
|
|
---|---|
For PAAS applications, the name of each cartridge that the app requires. See the “Cartridge Management Workflows” section. |
|
Author of the app (for example, the company that provided the app). |
|
Link to an external page for the author (for example, the website of the author). |
|
For an app that has a status of RUNNING, displays the command that you can use to access the app via a console. See the “Accessing an App via a Console” section. |
|
For a VM-based app that has a status of RUNNING, displays the password that you entered in Password field the App-id > Resources page for accessing an app via a VNC session. |
|
Number of CPU units that the app consumes on the host system. |
|
Resource profile that you assigned to the app. See the “Activating an App” section. |
|
Disk space, in MB, that the app consumes on the host system. |
|
Number of virtual CPUs that are available on the host system for a VM-based app. |
|
Name of the network interfaces that the app uses for network access. Click an interface name to display a dialog box that shows the following information, as available:
|
|
Row number in this area number for the corresponding information. |
|
Description of the USB or serial device that the app uses on the host system. |
|
Unique ID used by the host system to identify the USB or serial device that the app uses. |
|
ID used by the app to identify the USB or serial device that the app uses on the host system. |
|
Description of the health of the app. “Healthy” means that the app has no errors and is operating normally. “Unhealthy” means that the app has errors. Click a description to see more detailed information, if available. |
|
If Cisco IOx determined that the app was corrupted and tried to recover the app, this field shows true. Otherwise, this field shows false. |
|
If Cisco IOx tried to recover the app but was not able to, this field shows true. Otherwise, this field shows false. If this field shows true, the app must be recovered manually. |
|
Percentage of total CPU units on the host system that the app is currently consuming. |
|
Memory, in KB, that the app is currently consuming on the host system. |
|
Disk space, in MB, that the app is currently consuming on the host system. |
|
Data, in bytes, that the app has received from and transferred to the host system. |
|
App-ID > App-Config Page
The App-ID > App-Config page from lets you update the configuration file for an app.
An app configuration file is a text file named package_config.ini, which is stored in the /data directory in the app container for the app. When an app starts, it obtains configuration parameters from this file, if the file exists. The contents and use of this file by its app are defined by the app developer.
To access the App-ID > App-Config page, choose an App-ID tab from the Cisco IOx Local Manager menu bar, and then choose App-Config. Table 2-10 describes the fields and options that are available on this page.
|
|
---|---|
Lets you enter configuration information for the app. See the “Updating an App Configuration file” section. |
|
App-ID > App-DataDir Page
The App-ID > App-DataDir page lets you see the contents of the /data directory in an app container, upload files to the /data directory or subdirectory, download files to your local system, and delete files or subdirectories from the /data directory. The files can be configuration files or other files that the app needs when it runs. log files, and other files that are created while app is running.
To access this page, the app must be in the ACTIVATED, RUNNING, or STOPPED state. This page is not available for use when an app is in the DEPLOYED state.
To access the App-ID > App-DataDir page, choose an App-ID tab from the Cisco IOx Local Manager menu bar, and then choose App-DataDir. Table 2-10 describes the fields and options that are available on this page.
|
|
---|---|
Location in the app container /data directory of a folder that you clicked in the Name field. |
|
Displays the files and subdirectories in the app container /data directory. In this field, you can take the following actions:
|
|
Size of a file, in bytes. For directories, the size displays as 0. |
|
Provides the delete option for deleting a file or directory. See the “Deleting a File or Directory from an App Data Directory” section. |
|
Click to display in the Name field the contents of the top level of the /data directory. |
App-ID > Logs Page
The App-ID > Logs page provides information about the app log files that the app creates in the /data/logs directory in the app container for the app, and lets you download these log files.
To access the App-ID > Logs page, choose an App-ID tab from the Cisco IOx Local Manager menu bar, and then choose Logs. Table 2-11 describes the fields and options that are available on this page.
|
|
---|---|
Host system date and time that the log file was last updated. |
|
Lets you download a log file. See the “Downloading an App Log File” section. |