# Appliance

## Appliance Settings

Appliance URL
:   The default URL used for Agent install and Agent functionality. All Instances and Hosts must be able to resolve and reach this URL over 443 for successful agent install and communication.

NOTE

Alternate Appliance URLs can be configured per Cloud in the Edit Cloud  >  Advanced Options section.

Internal Appliance URL (PXE)
:   For PXE-Boot your appliance needs to be routable directly with minimal NAT masquerading. This allows one to override the default appliance url endpoint for use by the PXE Server. If this is unset, the default appliance url will be used instead.

API Allowed Origins
:   A CORS-related field which specifies the origins that are allowed to access the HPE Morpheus Enterprise API. For example, if you were designing a web application which needed to make AJAX calls to HPE Morpheus Enterprise API. The origins should be specified here. By default, all origins are allowed. When this field is filled, an exclusive whitelist of allowed origins is established.

Cloud Sync Interval
:   Data is refreshed through cloud integrations at the interval specified here in seconds, the default value is 300 seconds (five minutes). Appliances managing a very large number of clouds may be adversely affected by setting this value too low.

Usage Retainment
:   Determines how many days to keep account usage (metered costing data) records. Retainment period is not set by default. Usage records will remain indefinitely if Usage Retainment is not set. Note this does not affect generated Invoice records.

Incident Retainment
:   Enter the number of days HPE Morpheus Enterprise should keep incident records in the database. In general, this setting can be left alone but in certain cases may need to be adjusted as very large incident database tables can affect the stability of the application.

Stats Retainment
:   Select 30, 60 or 90 days period for stats retainment. Selecting a larger period gives the ability to analyze stats, such as Instance metrics, over a longer period of time. For example, in the Monitoring tab of an Instance detail page, users can select a 60 or 90-day analysis period if the stats have been retained that long

Denied Hosts
:   A comma-delimited list of IP addresses and/or hostnames which should not be allowed sources for HTTP Tasks or REST-populated Option Lists.

Approved Hosts
:   A comma-delimited list of IP addresses and/or hostnames which are the only approved sources for HTTP Tasks or REST-populated Option Lists. By entering any values here, all others are automatically denied.

Enable SSL Verification of Agent (Communications)
:   Enabling SSL Verification of Agent Communications requires a valid Certificate be installed on the Appliance.

Disable SSH Password Authentication
:   Only allow ssh login using SSH keys. When true, SSH Password Authentication will not be enabled for VM’s and Hosts provisioned after the setting is enabled.

Default Appliance Locale
:   Sets the default language and region for all users on the HPE Morpheus Enterprise appliance. Users with individual language preferences may also override this selection on their User Settings page

Default Console Gateway
:   Select a configured HPE Morpheus Enterprise Worker as a console gateway or VDI gateway. For more on installation and configuration of a gateway, see the [VDI Gateways section](https://docs.morpheusdata.com/en/latest/tools/vdi_pools.html#vdi-gateways) of HPE Morpheus Enterprise documentation.

Max Option List Size
:   Sets a maximum size for Option Lists (such as those sourced from REST calls to a remote server) to preserve appliance performance in the event that a very large payload is inadvertently accessed. The entered number is multiplied by 1000 (for example, entering “1” results in a maximum list size of 1000).

Dashboards to Display
:   A typeahead field which will show all Dashboards available to the appliance from Dashboard-type plugins. Select all desired Dashboards and they will be displayed in the order set. Dashboards can be dragged up and down the list to set the order correctly.

## Tenant Management Settings

Registration Enabled
:   If enabled, the appliance login screen will have a “NEED AN ACCOUNT? SIGN UP HERE” link added, enabling new Tenant registration.

Default Tenant Role
:   Sets the default Tenant Role applied to Tenants created from Tenant Registration.

Default User Role
:   Sets the default User Role applied to the User created from a Tenant Registration.

## User Management Settings

Min Password Length
:   User passwords must at least be as many characters in length as the entered value

Min Password Uppercase
:   User passwords must include at least as many uppercase characters as the entered value

Min Password Numbers
:   User passwords must include at least as many numerals as the entered value

Min Password Symbols
:   User passwords must include at least as many special characters as the entered value

Session Expires (Minutes)
:   A user session is forcibly logged out after the entered number of minutes of inactivity

Session Warning (Minutes)
:   A pop-up warning is shown to the user when they have been inactive for the number of minutes entered. Example: If sessions are set to expire after 90 minutes, warn the user after 60 minutes if you intend to provide 30 minutes advance warning

Expire Password After (Days)
:   User account passwords will expire after the entered number of days. Enter 0 or leave the field empty to opt out of this feature.

Disable User After Attempts (Number of Attempts)
:   Disable a User account after a specified number of failed login attempts. Enter 0 or leave the field empty to opt out of this feature.

Disable User If Inactive For (Days)
:   Disable a User account if inactive for the entered number of days. The User will not be able to log into the appliance again until another User with sufficient rights enables the account. Enter 0 or leave the field empty to opt out of this feature.

Send warning email before deactivating (Days)
:   Enter the number of days prior to account deactivation that a warning email should be sent. For example, enter “5” to warn the User when they are five days short of the deactivation time entered in the prior field. Enter 0 or leave the field empty to opt out of this feature.

## Email Settings

In this section, you can configure an SMTP server for email notification delivery. You will need to provide HPE Morpheus Enterprise the following information, your mail server systems administrator can assist you in filling these fields and with the preferred encryption method.

- From Address
- SMTP Server
- SMTP Port
- SSL Enabled
- TLS Encryption
- SMTP User
- SMTP Password

We recommend that you add the HPE Morpheus Enterprise server to your SMTP whitelist as well as using user authentication as an additional security measure.

Once you have added your SMTP server information into HPE Morpheus Enterprise, scroll down to the bottom of the page and press the blue SAVE button which can be found under the Enabled Clouds section.

When you have saved your SMTP server settings in the HPE Morpheus Enterprise appliance you will then need to restart the UI. To restart the morpheus-ui, connect to your HPE Morpheus Enterprise server via SSH and run the below command:

`sudo morpheus-ctl restart morpheus-ui`

IMPORTANT

If you do not restart morpheus-ui, the notifications will not be sent. Please note it can take up to three minutes for the UI to become reachable again.

## Twilio SMS Settings

Configure SMS text message delivery for HPE Morpheus Enterprise alerts. Previously, customers could use HPE Morpheus Enterprise’ own account for delivery, but for security reasons clients must now supply their own. Complete the fields indicated below and then restart all HPE Morpheus Enterprise nodes to apply the changes.

- **Account SID:** Twilio Account SID
- **SMS From #:** The “From” number to receive the text message from
- **Auth Token:** The Twilio API authentication token for your account

## Proxy Settings

The HPE Morpheus Enterprise Appliance can be configured to communicate through a Proxy server for Cloud API’s and Agent communication back to the Appliance.

NOTE

Additional Proxy configuration is available in the Infrastructure  >  Network  >  Proxies section. Added Proxies can be scoped to Clouds in the Edit Cloud  >  Advanced Options section of the Cloud.

Add a Global Proxy server by entering the following:

- Proxy Host

  : Specifies the hostname or IP address of the proxy server.
- Proxy Port

  : Specifies the port number used by the proxy server to communicate.
- Proxy User

  : Specifies the username used to authenticate with the proxy server.
- Proxy Password

  : Specifies the password associated with the proxy user account.
- Proxy Domain

  : Specifies the authentication domain for the proxy user.
- Proxy Workstation

  : Specifies the workstation name used for proxy authentication.
- No Proxy

  : Specifies a list of hosts that should bypass the proxy.

## Currency Settings

In HPE Morpheus Enterprise, Tenants are separate environments which can be defined as using currencies that are unique from one Tenant to the next. In addition, these currencies may be different from the currency in which Price Sets have been defined. In order to present pricing to Subtenant users in their designated currency, HPE Morpheus Enterprise allows for integration with currency conversion services “open exchange rates” and “fixer.io”. This article goes through the process of setting up the integration and how it works to determine pricing conversions.

## Integrating With a Currency Exchange Provider

### Procedure

1. Navigate to Administration > Settings > Appliance
2. Under the Currency Settings heading, make a “Currency Provider” selection
3. Enter your “Provider API Key”

### Results

The service is now integrated and can be used as described in the next section.

## Consuming Currency Exchange in HPE Morpheus Enterprise

Currency exchange data is synced from the integrated provider once every 12 hours. When needed, Morpheus will use this cached data to present currency conversions rather than hitting the API directly each time. This limits the total number of API hits and reduces costs.

Exchanged currency values will be shown under conditions similar to the following scenario:

A user is working in a Subtenant configured for Currency B. The user is attempting to provision an instance with pricing sets that have only been defined in Currency A. Morpheus will convert the pricing data from currency A to Currency B for this user (and all users in this Subtenant) since price conversion has been enabled.

## Enabled Clouds (Types)

Controls which types of Cloud can be created.

- When a Cloud type is disabled, it will be removed from the available options when adding new Clouds in Infrastructure  >  Clouds. Existing Clouds are not affected by changes to this setting.
