Insights On-Premises: Administration UI

From version 8.6, Insights On-Premises (IOP) provides new powerful administration functionalities that make your day-to-day administration activities easier. Instead of using the command line, you can use our GUI-based interface to:

• Expand the disk size of data nodes.
• Change the IOP password for your admin account.
• Manage IOP services
• Manage IOP licenses.

Prerequisites

• Insights On-Premises. The new administration menu is not available for Hybrid versions of ControlUp.
• IOP must be an OVA installation. Linux-based deployments are not supported.
• IOP version 8.6 or higher.
• Admin user credentials to access the administration menu.

Access the Administration UI

1. Access the web interface of your IOP installation. To log in, use the admin user (cuadmin, prior to IOP 8.8) and the password that you defined in the OVA deployment.
   
2. Select Administration from the home menu by clicking the arrow at the top right.
   
3. Log in again with the power user account in the admin menu.
   
4. Once you are logged in, you can see 3 menu options on the left side:

• Services and Resources
• Disk Details
• Licenses

Services and Resources

[1] The Services table provides an overview of the running IOP services, the machine on which the services run, and their status.

[2] The Resources table shows the IOP servers, their roles, and system information.

Services

Containers

Container health status

Disk Details

The Disk Details table shows you capacity of the disks attached to your IOP servers. When you deployed the virtual appliances for installing IOP in your environment, you configured 2 disks. One for the operating system (by default 100GB) and a partition for the IOP data. The partition for the operating system is shown as "os" while the data partition is displayed as "data". The data partition is the partition where IOP stores its data.

Disk Alerts

You can now send an email when the free disk space of a data node falls below 10% or 50GB (the first to match). To use this feature, make sure you have set up an SMTP server under Settings > Mail Server Settings.

Expand Disk

You can expand the disk of your data nodes. This requires some preliminary action in your vCenter Client as you first need to expand the disk size of your virtual appliance.

In a standalone environment, where you only use one IOP server,

To expand the disk of a data node:

1. Log into your vCenter Client and browse to your IOP virtual machine.
2. Click Actions and select Edit Settings...
   
3. In the Edit Settings screen, change the size of Hard disk 2 to a higher value. For example from 50 GB to 80 GB.
   
4. In the Admin UI of your IOP appliance, click the three dots next to your data node and select Expand.
   
5. Confirm the warning popup by clicking Approve.
   

Change IOP Password

The password of your admin user may need to be changed in some cases. You can change the password for both admin accounts, the cuadmin user which connects to the IOP appliance via SSH, and the admin user which accesses the graphical user interface:

To change the IOP password:

1. In the Admin menu, make sure that Services and Resources is selected.
2. Click the Change IOP Password button in the top-right corner.
3. In the Change IOP Password wizard, choose the node on which you want to reset the admin password.

4. Under Current Password, enter the current password of your admin account.
5. In the New Password field, enter the new password and confirm it.

   The password must be at least 8 alphanumeric characters in length and contain at least one of the following special characters: ~ @ % ^ - _ =

6. Click Modify Password to save the changes and confirm the warning message:
   
7. The progress icon appears while the password is being changed. It will take several minutes for the new password to be applied to the IOP server. This causes a short downtime, so the IOP server is not accessible for a few minutes.
   
8. If the password was successfully changed, the following message appears:
   

Licenses

From IOP version 8.6.5, you can use the license management feature. IOP uses a software technology called Splunk. When you input data in Splunk, the indexer stores data on the disk and indexes the data. This operation requires a valid license which mainly determines the maximum amount of data you can input.

From IOP 8.8, you can click the License Usage button to open the license usage report in Splunk.

License Actions

The Licenses menu allows you to add and delete licenses.

Add Licenses

To add licenses is very important for long-term implementation of your IOP environment.

To add a license:

1. Click the + Add a License button at the top of the license table.
   
2. Browse your local computer and open the license file.
3. The license is added and a success message is displayed.
   

Delete Licenses

You can delete licenses from the Licenses menu at any time you want. Be aware that you can not delete your only license, so deleting licenses is only possible when you have more than one license available.

To delete a license:

1. Click the three dots for a license and select Delete.
   
2. Confirm the message by clicking Confirm
   
3. The license is removed from the table and a success message is displayed.