After installing the Stratus Cloud Workload Services, edit the cloud properties file (/opt/jetty/resources/CloudMgmtExt.properties) to configure settings needed for your environment. In most cases, the properties are set automatically during the Workload Services installation, but, for example, you must set up a mail server and optionally set the logging detail level in this file, as described in the following topics:
The table summarizes the settings available in the CloudMgmtExt.properties file and indicates if you should modify them in the Modify column. An example properties file appears below the table.
Cloud Properties File Settings
Setting | Description | Modify |
---|---|---|
AllowNonFtOnFt |
Specifies if the orchestrator can place standard KVM instances on KVM-FT hypervisors. The default setting of false ensures that only KVM-FT instances are placed on KVM-FT hypervisors to reserve the resources and overhead of these hypervisors for Mission Critical applications. A setting of true allows the orchestrator to place standard KVM instances on KVM-FT hypervisors if hypervisors with a lower Availability Level are unavailable or have exceeded their instance load. NOTE: The orchestrator cannot evacuate a standard KVM instance if the instance is running on a KVM-FT hypervisor. |
No |
BootstrapUsername | Specifies the OpenStack admin account. | No |
BootstrapPassword | Specifies the OpenStack admin password. | No |
BootstrapTenantName | Specifies the OpenStack admin tenant name. | No |
buggrabber | Specifies the location of the Stratus buggrabber utility that collects log files and other information if needed for your service representative to troubleshoot your cloud configuration. | No |
cloud.mgmt.mail.server.host | Specifies the system mail server host to use for email notifications. | Yes |
cloud.mgmt.mail.server.port | Specifies the system mail server port, which is 25 by default, and generally 465 for SSL and 587 for TLS. | Yes |
cloud.mgmt.mail.sender.address | Specifies the email address that appears in the FROM header when mail is sent. | Yes |
cloud.mgmt.mail.secure.password.authentication.required | Specifies if secure password authentication (SPA) is required by email server. NOTE: If set to true, you must specify the next three properties (encryption type, username, and password). | Yes |
cloud.mgmt.mail.encryption.type | Specifies the encryption type of the email server connection (DEFAULT, SSL or TLS). NOTE: Must also set cloud.mgmt.mail.secure.password.authentication.required to true. | Yes |
cloud.mgmt.mail.account.username | Specifies the mail account username. NOTE: Must also set cloud.mgmt.mail.secure.password.authentication.required to true. | Yes |
cloud.mgmt.mail.account.password | Specifies the mail account password. NOTE: Must also set cloud.mgmt.mail.secure.password.authentication.required to true. | Yes |
cloud.mgmt.mail.password.reset.url | Specifies the callback URL pattern that is sent by the forgot password email. If necessary, enter the hostname or IP address. | Yes |
cloud.mgmt.mail.password.initialize.url | Specifies the callback URL pattern that is sent by the initialize password email. If necessary, enter the hostname or IP address. | Yes |
cloud.mgmt.help.system.host | Specifies the URL of the online help system that appears when you click Help in Workload Services. | Yes |
cloud.mgmt.api.logging.level cloud.mgmt.orchestrator.logging.level cloud.mgmt.presentation.api.logging.level |
Specify the logging level to use for Stratus logs in the /opt/jetty/logs directory. cloud.mgmt.api.logging.level=info Possible values include:
|
Yes |
databaseUrl | Specifies the URL of the PostgreSQL database. | No |
databaseUser | Specifies the PostgreSQL database username. | No |
databasePassword | Specifies the PostgreSQL database password. | No |
DataCollectionCommodityIntervalCode DataCollectionMissionCriticalIntervalCode DataCollectionBusinessCritiCalIntervalCode DataCollectionDefaultIntervalCode |
Specifies the data collection interval in seconds for each availability type. Valid values are 10, 30, 60, 300, 600, 900, 1800, 2700, and 3600. If an invalid value is set, the software uses the default value. Defaults are as follows: DataCollectionCommodityIntervalCode=900 |
No |
heat.template.function.enable | Used only for internal testing or demonstration. Must always be set to the default of false. | No |
HypervisorWorkloadUnlimited | Specifies if the cloud allows infinite oversubscription of resources. The default setting of false prevents oversubscription of resources. A setting of true allows you to continue deploying applications even if cloud resources are exhausted. | |
KeystoneEndpoint | Specifies the URL for your OpenStack controller. | No |
KvmFtDiskEnableTimeout |
Specifies how long the KVM-FT orchestrator will wait (in minutes) before trying to automatically repair an OFFLINE or FAILED disk. Default is 10 minutes. |
Yes |
KvmFtQuorum1Ip KvmFtQuorum2Ip |
Specifies the IP addresses of the two nodes that run the fault-tolerant Quorum server service (QSS) for KVM-FT applications. You manually enter these IP addresses after installing the quorum servers, as described in Installing Quorum Servers for Stratus Cloud Availability Services. You cannot change the quorum server IP addresses later without redeploying your KVM-FT applications. |
Yes |
MaxAdvisoryDisplay | Specifies the maximum number of records that Workload Services will display within a category of advisories. When trimming to this maximum number, the system displays the most recent advisories. Default value is 500. | Yes |
Orchestrator |
Used only for internal testing or demonstration. Must remain commented out. Setting to local enables a mock orchestrator that simulates the orchestration function without connecting to OpenStack. |
No |
OrchestratorAPIEndpoint | Specifies the URL of the Heat orchestrator. | No |
OSTokenMinutesToRenewBeforeExpires | Specifies renewal interval for OS token in minutes. Default is 15 minutes. | No |
SearchHost | Specifies the elastic search path. Default is 127.0.0.1. | No |
SearchHttpPort | Specifies the elastic search HTTP port. Default is 9200. | No |
SearchPort | Specifies the elastic search port. Default is 9300. | No |
StackCreateTimeoutMinutes |
Specifies how long Workload Services will wait (in minutes) before reporting that application deployment has failed if no prior success or failure response has been received by the system. Default is 60 minutes, as some stack resources take a long time to create (for example, instances with large disks). |
Yes |
Example Cloud Properties File
HypervisorWorkloadUnlimited=false
#Orchestrator=local
KeystoneEndpoint = http://192.168.105.50:5000/v2.0
BootstrapUsername = admin
BootstrapPassword = admin
BootstrapTenantName = admin
# Cloud Management Database Maintenance
StackCreateTimeoutMinutes=60
MaxAdvisoryDisplay=500
SearchHost=127.0.0.1
SearchPort=9300
SearchHttpPort=9200
#minutes to renew before token expires
OSTokenMinutesToRenewBeforeExpires=15
#DATACOLLECTION INTERVAL CODE IN SECONDS
#VALID VALUES ARE (IF INVALID VALUE SET, it WILL DEFAULT to 900)
#10,30,60,300,600,900,1800,2700,3600
DataCollectionCommodityIntervalCode=900
DataCollectionMissionCriticalIntervalCode=60
DataCollectionBusinessCritiCalIntervalCode=300
DataCollectionDefaultIntervalCode=900
## system mail properties ##
# The system mail server host
cloud.mgmt.mail.server.host=<change_on_setup>
# The system mail server port (25 by default, generally 465 for SSL and 587 for TLS)
cloud.mgmt.mail.server.port=25
# The email address that receiver can see in the header FROM
cloud.mgmt.mail.sender.address=<change_on_setup>
# Set to true if secure password authentication (SPA) is required by email server
cloud.mgmt.mail.secure.password.authentication.required=true
# The encryption type of the email server connection (DEFAULT, SSL or TLS)
cloud.mgmt.mail.encryption.type=DEFAULT
# The mail account username, required if the cloud.mgmt.mail.secure.password.authentication.required set to true
cloud.mgmt.mail.account.username=<change_on_setup>
# The mail account password, required if the cloud.mgmt.mail.secure.password.authentication.required set to true
cloud.mgmt.mail.account.password=<change_on_setup>
## password reset mail ##
# The callback URL pattern that sent via the forgot password email. Change the host/ip if necessary
cloud.mgmt.mail.password.reset.url=https://<change_on_setup>/cloud/#login:passwordreset?useridentifier={0}&passwordresetcode={1}
## password initialize mail ##
# The callback URL pattern that sent via the initialize password email. Change the host/ip if necessary
cloud.mgmt.mail.password.initialize.url=https://<change_on_setup>/cloud/#login:passwordreset?useridentifier={0}&passwordresetcode={1}
# help system host
cloud.mgmt.help.system.host=http://clouddoc.stratus.com/1.5.1.0
#buggrabber=c:/cloud/buggraber.bat
buggrabber=sudo /opt/stratus/scripts/buggrabber.sh
# Orchestration API (currently needed for LAMO trap POSTs)
OrchestratorAPIEndpoint=http://134.111.39.80:8084/orchestrator
# KVM-FT Quorum IPs
KvmFtQuorum1Ip=192.168.81.50
KvmFtQuorum2Ip=192.168.81.90
# KVM-FT disk repair threshold
KvmFtDiskEnableTimeout=10
#### LOGGING LEVEL (OPTIONAL) Default : debug if not found
#POSSIBLE VALUES : DEBUG/INFO/WARN/ERROR/FATAL
#fatal: shows messages at a FATAL level only
#error: Shows messages classified as ERROR and FATAL
#warning: Shows messages classified as WARNING, ERROR, and FATAL
#info: Shows messages classified as INFO, WARNING, ERROR, and FATAL
#debug: Shows messages classified as DEBUG, INFO, WARNING, ERROR, and FATAL
#trace : Shows messages classified as TRACE,DEBUG, INFO, WARNING, ERROR, and FATAL
# APPLIES FOR BOTH API AND ORCHESTRATOR
cloud.mgmt.api.logging.level=debug
cloud.mgmt.orchestrator.logging.level=debug
#Postgresql Database entries
databaseUrl = jdbc:postgresql://localhost:5432/
databaseUser = postgres
databasePassword = root
Product Support and Downloads
|
About Stratus
|
Product Documentation (PDF Format)
|
About Help
|