Contents x
    Insights On-Premises: Administration UI
      • Print
      • Dark
        Light
      • PDF
      Contents

      Insights On-Premises: Administration UI

        • Print
        • Dark
          Light
        • PDF
        Article summary

        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.
          image.png
        2. Select Administration from the home menu by clicking the arrow at the top right.
          image.png
        3. Log in again with the power user account in the admin menu.
          image.png
        4. Once you are logged in, you can see 3 menu options on the left side:

        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.
        image

        Services

        Containers

        Container NameListening Port
        iop_control8777
        iop_proxy80 (HTTP port)
        443 (HTTPS port)
        iop_ui3000 (UI port)
        iop_search8000 (UI port)
        8089 (Management port)
        8088 (HEC port)
        9997 (Forwarder port)
        iop_master8089 (Management port)
        8080 (UI port)
        iop_data8000 (UI port)
        8089 (Management port)
        8088 (HEC port)
        9997 (Forwarder port)
        9887 (Replication port)

        Container health status

        Container StatusDescriptionAllowed Actions
        HealthyThe container has entered a healthy stateRestart
        Stop
        UnhealthyThe container has entered an unhealthy stateRestart
        Stop
        StoppedThe container exited and is in a stopped stateStart
        RunningThe container is running-

        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...
          image
        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.
          image
        4. In the Admin UI of your IOP appliance, click the three dots next to your data node and select Expand.
          image
        5. Confirm the warning popup by clicking Approve.
          image

        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.
        Reset the password on all IOP nodes

        When you use more than one IOP node in a clustered environment, you must reset the passwords on all nodes.
        If you are using a clustered environment with one master and one data node, you must first reset the password on the master and then on the data node.

        1. Under Current Password, enter the current password of your admin account.
        2. 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: ~ @ % ^ - _ =

        3. Click Modify Password to save the changes and confirm the warning message:
          image
        4. 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.
          image
        5. If the password was successfully changed, the following message appears:
          image

        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.
        IOPLicenseUsage

        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.
          image.png
        2. Browse your local computer and open the license file.
        3. The license is added and a success message is displayed.
          image.png

        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.
          image.png
        2. Confirm the message by clicking Confirm
          image.png
        3. The license is removed from the table and a success message is displayed.
          image.png

        Apply Security Patches

        As a system administrator, ensuring the security of your servers through regular patching is a crucial task. In 8.7, we have added a new upgrade feature to address the challenge of updating your Insights On-Premises servers with the latest security patches.

        In this article, we will guide you through the process of updating your IOP servers with the most recent security patches.

        Prerequisites

        • IOP version 8.7 or higher
        • Only OVA-deployed IOP instances are supported as the Administration UI is not available for Linux-based installation

        Download the Upgrade Packages

        Our support team provides the upgrade packages.

        How to Apply Security Patches

        1. In the Admin UI, log in with an IOP admin account
        2. Click Software Upgrade on the left-side bar
        3. Browse the tgz file that you downloaded from your Download Center and click Upgrade
          image.png
        4. Click Continue to confirm the warning
          image.png
        5. Once the updating process is completed, click Continue > Close
          image.png
        Was this article helpful?
        What's Next