Using the Administration Console
Learn about administration tools used in the Administration Console.
Table of Contents
- Installed Features tab
- Available Features tab
- Monitoring tab
- Configuration tab
- Repository tab
- Health tab
- System tab
- Troubleshooting: IE browser support
Platform administration is performed using the Administration Console. After the platform is installed and the Configure Container Instance Wizard is used to define a container that will host selected features, the Administration Console is used to perform feature installation, configuration, and maintenance tasks.
The Administration Console includes the following tabs:
Available Features tab
The Available Features tab displays a list of features, tools, and plug-ins that are available to be installed on the current container instance.
For an example of the Available Features list, see Installation Options: Full List.
The feature list can be filtered to show Feature, Tool, or Plug-in via the Filter drop-down. Installation and configuration instructions can be found here: Installing Features, Installing Tools, Installing Plug-ins.
To install a feature, select the corresponding checkbox, and click Install Feature. Select additional checkboxes to install multiple features. During the installation process a series of feature resolution screens will display. After the installation process is complete, the feature is listed on the Installed Features tab.
If additional configuration steps are required, you can select Configure on the Installation Complete screen, or select Complete Configuration in the Pending Installation Tasks section of the Installed Features screen. See Configuration Actions for information on available configuration tasks.
Installed Features tab
The Installed Features tab displays a list of features that are installed on the current container instance. The feature list Filter drop-down list box allows you to filter features by Product Feature or Bundle categories.
Pending Installation Tasks
The Pending Installation Tasks is a list of configuration tasks (if applicable) that are required to complete the installation process. To perform pending installation tasks, click Complete Configuration. See Configuration Actions for information on available configuration tasks.
To uninstall a feature, select the icon and click OK. The system uninstalls the selected feature, removes it from the Installed Features tab, and moves it back to the Available Features tab.
To update features, select a feature line item and click Search for Updates. An installation wizard displays and presents a listing of available updates (if applicable). To install the updates proceed with the installation process. After the update is complete, the version number of updated features is changed to reflect the installed version.
To rollback a feature, select a feature line item and click Rollback Changes. The system uninstalls the selected feature, removes it from the Installed Features tab, and moves it back to the Available Features tab.
View Feature / Bundle List
To view bundles associated with a current update, click the "Installed Features" tab, select "Bundle" from the "Filter" drop-down list box, and click the "Version" column to sort by version. To view "Bundle Details" click on a bundle line item.
You can monitor the real-time state of a container with the Admin Monitoring Tool, an optional plug-in.
For more information, see Using the Admin Monitoring Tool.
The Configuration tab provides two methods of modifying a container configuration including Configuration Actions on the left sidebar that execute wizards, and Properties that are presented in a table format. After modifying any container configuration properties you must restart your container.
Configuration Actions are located in the bottom left sidebar area of the Configuration tab. They represent repeatable tasks that were performed during the initial container configuration. To modify properties for a specific configuration area, click the task link to launch a wizard and then configure the properties.
Configuration properties are organized into Configuration Categories and are located in the top left sidebar area of the Configuration tab. To view properties, click a Configuration Category link and a properties table displays. To update a property, modify the property information in the table row and click Apply Changes. To add additional properties click, Add Property. See Configuration Categories for a listing of configuration categories and settings.
- The Configuration Categories section displays a list of property categories that expand to display specific property names and values. The initial property configuration is created during the installation and configuration of features.
- To update a property value, select a property name in the Configuration Categories section, update the property value, and click Apply Changes.
- To add a property value, select a Configuration Category to add a property to, and click Add Property. The Add Configuration Property popup displays. Enter a Property Name and Property Value and click Apply.
- The Configuration Actions section displays a list of maintenance actions.
The Repository tab displays a list of repositories identified by "Location" that store product features that are available for installation on the current container instance. A default repository Platform Default Repository) is added as part of the initial Platform installation.
Install Container Updates
Container Updates are distributed using a Repository URL that points to a repository that contains designated product features or updates. The Repository URL is added to the Repository tab via the Administration Console. Updates include bundles that represent new features, or updates to existing features.
After a Repository URL is added to the "Repository," updates to a specific feature can be applied by clicking the Search for Updates button via the Installed Features tab and applying the list of updates found.
This section provides instructions for adding a Repository URL to the Administration Console and applying an update.
Add Repository URL
Product updates are installed via the Administration Console. The first step in applying a product update is to add the Repository URL that includes the update data to via the Repository tab.
The Health tab gives you access to the System Health tool, which allows you to monitor health statistics by making a GET call to any Akana container.
For more information about this tool, see Monitoring the Health of a Container: Akana System Health Tool.
The System tab provides a summary of the Platform process characteristics and states. Information includes the last start time of the process, memory details (Total, Used, Free), and a listing of associated system properties. System details can be used to review system health and for troubleshooting purposes.
To restart the current container instance and associated bundles, click Restart. Note that Restart applies to standalone deployments only.
Generate System Report
The Generate System Report option allows you to generate a report of all system activity associated with the current container.
Troubleshooting: IE Browser Support
If you're using the Akana Administration Console version 2018.0.0, you might encounter an issue with user interface display. In Internet Explorer 11, with the default browser setting of Compatibility Mode, the user interface does not display correctly. Instead, the tabs display without the content, as shown below.
To fix this, just clear the Compatibility Mode checkbox in the browser settings. Follow the steps below.
- In Internet Explorer, at the top right, click the Tools menu, as shown below, and choose Compatibility View settings.
- In the Compatibility View Settings dialog box, make sure the domain for your Akana Administration Console is not included on the list, and clear the Display intranet sites in Compatibility View setting, as shown below.
- Click Close.
Once the compatibility view settings are modified as above, the Admin Console displays correctly.