Fuse Management Central: Installation and Administration Guide

Fuse Management Central 1.0

31-03-2020

VILT Group, S.A.
Rua Ivone Silva, 6 - 7º Esq
1050-124 Lisboa
Portugal
Tel: +351 210 343 399
info@vilt-group.com

For more information, visit http://www.vilt-group.com

Disclaimer
No Warranties and Limitation of Liability Every effort has been made to ensure the accuracy of the features and techniques presented in this publication. However, VILT Group, S.A. and its affiliates accept no responsibility and offer no warranty whether expressed or implied, for the accuracy of this publication.

1. Introduction

This guide walks you through the installation and administration of Fuse Management Central 1.0.

Fuse Management Central is an application management platform that simplifies OpenText ™ Content Server® management and accelerates its administration learning curve. The Fuse Management Central web administration console enables centralized management of OpenText ™ Content Server® instances as well as its component monitoring.

Fuse Management Central also separates system administration from content administration, introducing a new layer of security on top of the traditional OpenText ™ Content Server® administration tools.

1.1. Document Revision History

Revision Number	Modification Date	Section Modified	Modifications
1.0	2020-03-31	All	Initial version

Revision Number

Modification Date

Section Modified

Modifications

1.0

2020-03-31

All

Initial version

2. Overview of Fuse Management Central Architecture

The diagram below display and briefly describes Fuse Management Central conceptual architecture, designed for high performance, scalability and security.

1	Fuse Management Central integrate with OpenText ™ Directory Services to manage and authenticate its users. OpenText ™ Directory Services provides a scalable identity management solution, by integrating multiple authentication services, such as Active Directory or Google.
2	Fuse Management Central is the secret sauce central piece, responsible for orchestrating all system monitoring and management activities, regardless of its cluster type, whether productive or non-productive.
3	Fuse Management Central Database stores all application related data, such as administration settings, access roles.
4	Fuse Management Central Metrics Database is used for long term metric storage, allowing system administrators to perform a temporal search on system metrics, combining them on aggregated system metric snapshots over time.
5	Fuse Management Central Alert Manager takes care of interpreting, deduplicating, grouping, and routing alerts to Fuse Management Central while allowing the option of silencing and inhibition of alerts.
6	All managed systems require Fuse Management Client installed and activated. Fuse Management Client is responsible not only for collecting and dispatching all system components metric data but also to make the system management interface available while ensuring the data interchange security.

3. Installing Fuse Management Central

3.1. Pre-Installation Tasks

generic checkbox checked Review Operating System Support
Review Hardware Requirements
Review Communication Ports Availability

Please refer to the Release Notes document for a complete listing of supported systems and compatibility prior starting Fuse Management Central installation process.

3.1.1. Installing Java

Before you start the Fuse Management Central installation, please check whether a supported JDK is already installed.

Please validate your current JDK version:

Option 1: On Windows go to Control Panel > Programs and Features to see what JDK version is installed.
Option 2: Check if JDK is already installed, opening a command line and typing the following command:

java -version

Check Fuse Management Central Release Notes document to find out which JDK versions are supported for your Fuse Management Central version.
If no JDK is installed or the installed version is not supported:
- Download and install Java with the default option selected and make sure it is available in your path

Free long term support (LTS) versions of JDK are provided by AdoptOpenJDK and Oracle.

3.1.2. Enabling SSL Security

Optionally, for enabling enabling SSL security on Fuse Management Central, please refer to the Configure SSL section in the Spring Boot Reference Documentation.

3.2. Installation on Microsoft Windows

To run Fuse Management Central installer on Windows:

Log on to Windows as a user who is a member of the Local Administrators group.
Start Fuse Management Central installation wizard, by double-clicking the installation file (/Fuse Management Central/Windows/Fuse Management Central 1.0-Winx64.exe).
In the Choose Components dialog box, leave the default values selected and click Next.
In the Choose Install Location dialog box, accept the default Destination Folder or click Browse to select a different folder, and then click Next.
In the Choose Data Location dialog box, accept the default Data Directory folder or click Browse to select a different folder, and then click Next.

To ensure business continuity, the Data Directory path should have a backup policy applied, enabling data recovery in the event of a disaster.
In the Choose Start Menu Folder dialog box, click Install.
When the installation process is complete, click Close.
Open Windows Services console and start Fuse Management Central service, once started all dependency services will start automatically.
The following windows services must be running:
- Fuse Management Central
- Fuse Management Central (Alert Manager)
- Fuse Management Central (Database)
- Fuse Management Central (Metrics Database)

3.3. Docker Deployment

3.3.1. Install Docker

Before proceeding, please make sure you have installed the latest version of Docker and Docker Compose, as defined in the official documentation:

Docker: https://docs.docker.com/install/
Docker Compose: https://docs.docker.com/compose/install/

Please refer to the Release Notes for the required minimum versions.

3.3.2. Run with Docker Compose

Load the docker image with:
```
docker load < fuse-docker-image.tar
```
This will create an image with the tag vilt-group/fuse-server
In the same directory as the docker-compose.yml provided, start all the services with:
```
docker-compose up
```

After start up open Fuse Management Central login page in your browser: http://localhost:2100

Make sure that port 2100 is available in your system. Otherwise change the exposed port in the `docker-compose.yml`file to one available.

3.3.3. Advanced Configuration

Data Persistence

Data is persisted in volumes, however backups are recommended for all the volumes. For backup recommendations please refer to Docker official documentation.

volumes:
  postgresql:
  prometheus:
  alertmanager:

Alternatively you can also map the data directories to filesystem mount points. Please follow the official documentation for the third-party containers.

JVM Options

To configure advanced JVM options in Fuse service use the JAVA_TOOL_OPTIONS environment variable:

    environment:
      - JAVA_TOOL_OPTIONS=

Third-Party Components

For more information regarding third-party configurations, please refer to the official third-party images documentation:

For information on running the docker image with kubernetes, please contact us by email product.support@vilt-group.com.

3.4. Validate Fuse Management Central Installation

To confirm if Fuse Management Central was successfully installed, open Fuse Management Central Administration page by using one of the following methods:

On Windows, click Start, point to Programs, point to the program folder name that was entered on the installation process (default: Fuse Management Central*), and then click the *Fuse Management Central Administration shortcut.

Open the following URL:

http://<fuse-management-central-host>:2100/#/admin

Login with your authentication credentials:
- Username: fuseadmin (default)
- Password: fuseadmin (default)
On Fuse Management Central Administration area, click Status

If all Fuse Management Central components are green and healthy, Fuse Management Central was successfully installed!

3.5. Next Steps

Once Fuse Management Central is installed is mandatory to perform a set of initial configurations, required for Fuse Management Central to properly operate and for security reasons.

Post-installation checklist:

generic checkbox checked Review the Security settings
Update General settings
Rquest and apply a valid License

4. Fuse Management Central Administration

This chapter explains how to configure Fuse Management Central interactively using its Administration pages, allowing Fuse administrators to adjust all of the application features.

To access Fuse Management Central Administration area:

Open Fuse Management Central:

http://<fuse-management-central-host>:2100

Login with your authentication credentials:
- Username: fuseadmin (default)
- Password: fuseadmin (default)
Click Fuse Administration on the navigation menu

4.1. Security

By default, Fuse Management Central has a built-in administrator user account named fuseadmin, which cannot be deleted.

This chapter describes how to change this user account password and email.

4.1.1. Change fuseadmin password

For security reasons, is highly recommended to change the fuseadmin user default password.

To change fuseadmin default password:

On Fuse Management Central Administration area, click Security
Fill the following fields and click Change Password:
- Current password (Default: fuseadmin)
- New password
- Confirm password

4.1.2. Change fuseadmin email

To change fuseadmin email address:

On Fuse Management Central Administration area, click Security.
Insert or update the email address and click Submit.

4.2. General

To allow your systems to communicate with Fuse Management Central, the API Endpoint URL must be updated with its FQDN URL.

To allow systems to dispatch their metrics to Fuse Management Central, the API Endpoint URL must be accessible by all managed systems.

To update the API Endpoint URL:

On Fuse Management Central Administration area, click General.
Under the Fuse Management Central URL section, update the API Endpoint URL and click Activate:

Please note that API Endpoint URL is built-in on your license, changing it will invalidate your current license.
Before changing Fuse Endpoint URL please request an updated license providing the new license data.

4.3. License

A license file is required for Fuse Management Central to properly operate. By default, when installed for the first time, Fuse Management Central has no license file applied.

Please note that under the following license scenarios, Fuse Management Central will have limited functionality:

Not Licensed (No license file found in the license folder)
Invalid License (License data mismatch Fuse Management Central API Endpoint)
Trial License Expired (The current trial license period has expired)

Fuse Management Central is currently supporting 2 license types:

Type	Description
Perpetual License	Without an expiration date and limited to a total of managed systems.
Trial License	For evaluation purposes only, with an expiration date and also limited to a total of managed systems.

Type

Description

Perpetual License

Without an expiration date and limited to a total of managed systems.

Trial License

For evaluation purposes only, with an expiration date and also limited to a total of managed systems.

While Fuse Management Central is running using a Trial License a notification is permanently available, displaying its expiration date.

4.3.1. Request License

Request a license by providing the following information to your Account Executive or contacting the support team by email: product.support@vilt-group.com

Trial Period (Trial License Only)
Customer Name
Fuse Management Central URL
Total Systems

Please be aware that when a license is issued all the above data will be hardcoded in it, meaning that any change on this data requires an updated license.

4.3.2. Apply License

To apply your license, please execute the following steps:

Copy the provided license file to folder <fuse_installation_folder>/license (e.g. C:\Program Files (x86)\Fuse Management Central\license).
Restart Fuse Management Central windows service or process.
Validate on License Information if the license was updated successfully, if not please review this procedure.

If you are using Fuse Management Central Docker image, please mount the license file directly to /opt/fuse/license/key.license

4.3.3. Validate License Status

To validate your license status:

On Fuse Management Central Administration area, click License.
Validate if your License Information data is correct and if Fuse Management Central license status is valid.

When Fuse Management Central is running using an invalid license (trial expired, Fuse Management Central URL mismatch, …), will cause all managed systems to automatically deactivate, limiting Fuse Management Central functionality.

4.4. OTDS Integration

Fuse Management Central has a built-in administrator user account (fuseadmin), which cannot be deleted.
In order to allow other users to access Fuse Management Central it must be integrated with OpenText ™ Directory Services (OTDS).

Fuse Management Central has a native OTDS integration, leveraging its authentication capabilities while allowing a centralized user management.

4.4.1. Create OTDS Resource

For Fuse Management Central to integrate with OTDS, a resource is required to be created on OTDS.

To create the OTDS resource:

Open OTDS Administration (e.g. http(s)://otds.company.com:8080/otds-admin)
From the web administration menu, click Resources.
On the button bar, click Add. The New Resource wizard will guide you through the steps to create a new resource.
On the General page:
1. In the Resource Name box, type a descriptive name for this resource (e.g. Fuse Management Central).
  
  Please note that the name you type here cannot be edited later.
2. (Optional) In the Display Name box, you can optionally type a different resource name.
3. (Optional) In the Description box, you can optionally type a short resource description.
4. Leave all other options with default values and click Next.
On the Synchronization page, make sure that User and group synchronization option is not checked, and click Next.
On the Principal Attribute page, leave all options with default values and click Save.
In the Resource Activation window, copy or write down the resource identifier.

For more detailed information regarding OTDS functionality, please refer to OpenText ™ Directory Services documentation.

4.4.2. Activate OTDS Resource

To activate Fuse Management Central with OTDS:

On Fuse Management Central Administration area, click OTDS Integration
Fill the following fields and click Activate:
- OTDS URL: The FQDN address of the OTDS Server (e.g. http(s)://otds.company.com:8080)
- OTDS Resource ID: The ID of the resource that has been created in OTDS

Once activated, the OTDS resource activation status will only be displayed when authenticating in Fuse Management Central using an OTDS account with administrative privileges (e.g. otadmin@otds.admin).

4.4.3. Configuring Fuse Management Central Access Roles

To manage user privileges a set of access roles are available in Fuse Management Central, each one with specific privilege sets:

Access Role	Privilege Description
Fuse Admin	Permits access Fuse Administration area, allowing full control over Fuse Management Central. In addition to these privileges this role also has all privileges of System Admin role.
System Admin	Can manage all systems, allowing to perform actions on them e.g. Restart, Apply Configurations, etc…
Guest	Limited privileges role, for users with "read-only" access, meaning that no management actions can be performed allowing only to observe monitoring metrics.

Access Role

Privilege Description

Fuse Admin

Permits access Fuse Administration area, allowing full control over Fuse Management Central. In addition to these privileges this role also has all privileges of System Admin role.

System Admin

Can manage all systems, allowing to perform actions on them e.g. Restart, Apply Configurations, etc…

Guest

Limited privileges role, for users with "read-only" access, meaning that no management actions can be performed allowing only to observe monitoring metrics.

To allow users to authenticate in Fuse Management Central using OTDS, these access roles must be mapped with one or more OTDS groups from both synchronized or non-synchronized partitions, depending on your OTDS partition scenarios.

To map an OTDS group with a Fuse Management Central access role:

Login using to Fuse Management Central using the otadmin@otds.admin OTDS user account.
On Fuse Management Central Administration area, click OTDS Integration.
Map each role by selecting or inserting one or more OTDS groups to each role field.
click Save roles.

Please note that all OTDS groups mapped with Fuse Management Central access roles must be added to Fuse Management Central OTDS Access Role.
This access role is automatically created when the Fuse Management Central resource is created in OTDS.

4.5. SMTP Configuration

To enable notification emails for Fuse Management Central alerts, operations, etc… you must first configure SMTP settings.

On Fuse Management Central Administration area, click Notification Channels
On the SMTP Configuration panel, fill in the following information:
1. Sender Email: Type the email address that will be used as the “From” address in all email notifications sent by Fuse Management Central
2. SMTP Host: The FQDN hostname of the SMTP server to which Fuse Management Central will connect in order to send email.
3. SMTP Port: The port number used by the SMTP server.
4. (Optional) SMTP Username: If your SMTP server requires it, type the user name to be used in the connection to the SMTP server.
5. (Optional) SMTP Password: If your SMTP server requires it, type the type the password for the user name you typed in the previous step.
Click Send test email and validate if you have received a test email notification.

The test email notification will be sent to the email defined on your user account. If you are authenticated with the fuseadmin user account, this user account email must be properly set.
Click Update to save your STMP configurations.

4.6. Alert Manager

Fuse Management Central uses an Alert Manager to automatically detect system anomalies and consequently triggering real-time alerts. These alerts are used to report on warning or error situations, such as performance degradations, failing agent schedule, lack of resources, among others.

Once an alert is triggered it will fire notification events through its support notification channels.

The current supported notification channels are:

Channel	Description
User Interface	Notification events are displayed on Fuse Management Central user interface, being displayed on the events list and adjusting the failing component style, providing real-time feedback to users.
Email	If SMTP Configuration is properly set, alert notifications will be sent by email to system owners.

Channel

Description

User Interface

Notification events are displayed on Fuse Management Central user interface, being displayed on the events list and adjusting the failing component style, providing real-time feedback to users.

Email

If SMTP Configuration is properly set, alert notifications will be sent by email to system owners.

Fuse Management Central system monitoring is based on numerous built-in, predefined metric thresholds. These default thresholds are set based on common usage scenarios but can be adjusted to fit your organization requirements.

To change the default metric thresholds:

On Fuse Management Central Administration area, click Alert Manager.
Adjust each alert threshold, to fit your requirements, and click Save.

5. Uninstall Fuse Management Central

This chapter describes how to remove Fuse Management Central from a host server.
If you are upgrading to a newer version of Fuse Management Central, it may be necessary to uninstall the older version.

5.1. Uninstall on Microsoft Windows

Fuse Management Central uses a Windows Installer to remove components from a Windows platform. The program is designed to remove all program files installed at the time of the Fuse Management Central installation.

The uninstall process will not remove any configuration and long term metric data. This is beneficial because you can retain these data files for use if you upgrade your Fuse Management Central software.
To force the deletion of all Fuse Management Central data files, please contact product.support@vilt-group.com.

To uninstall Fuse Management Central on Windows:

Stop all Fuse Management Central services.
Using the Windows application for removing programs (for example, Programs and Features), select Fuse Management Central installer and then click Uninstall.
Use the uninstall wizard automatically to remove all Fuse Management Central installed components.

6. Appendix A - Troubleshooting

N/A