Advanced Configuration Settings

Although you can edit most of the OnApp settings via the Control Panel user interface, there are some options that can be edited only in the on_app.yml file. You can use the Advanced Configuration Settings section to modify the OnApp configuration settings. This section contains the list of parameters you can edit in the on_app.yml file with their default values.

We recommend making a copy of the configuration file before making any changes.


ParameterDefault value
google_map_tokenempty string
custom.css file/onapp/interface/public/themes
log_path/onapp/interface/log/onapp.log
background_process_log_path/onapp/interface/log
background_process_pid_path/onapp/interface/tmp/pids
private_key_path/onapp/interface/config/keys/private
public_key_path/onapp/interface/config/keys/public
max_memory_ratio16
ssh_port22
use_ssh_file_transferfalse
ssh_file_transfer_server127.0.0.1
ssh_file_transfer_userroot
ssh_file_transfer_options

-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null-o PasswordAuthentication=no

template_path/onapp/templates
recovery_templates_path/onapp/tools/recovery
backups_path/onapp/backups
database_backups_path/onapp/database_backups
remove_backups_on_destroy_vmtrue

data_path

/onapp/data
update_server_urlhttp://repo.onapp.com/
dashboard_host127.0.0.1
license_key
generate_commentAutomatically generated by OnApp (%s)
graph_frequencies

[[hourly, 4000], [daily, 100000], [weekly, 800000],

[monthly, 3200000], [yearly, 40000000]]

simultaneous_backups2
simultaneous_backups_per_datastore2
simultaneous_backups_per_hypervisor1
simultaneous_transactions3
show_new_wizardfalse
enable_huge_pagesfalse
schedule_failure_count100
remote_access_session_start_port30000
remote_access_session_last_port30099
ajax_power_update_time8000
ajax_pagination_update_time9000
hypervisor_live_times12
guest_wait_time_before_destroy60
disable_hypervisor_failoverfalse
allow_hypervisor_password_encryptionfalse
system_emailapp@onapp.com
system_support_emailsupport@onapp.com
system_hostonapp.com
system_notificationtrue
ips_allowed_for_loginshould be empty to allow all or string with IPs comma-separated, like 1.1.1.1, 2.2.2.2, 2.3.3.3
enable_ipv6true
remove_old_root_passwordsfalse
pagination_max_items_limit100
monitis_path/usr/local/monitis
monitis_accountmonitis@onapp.com
locales[en]
default_firewall_policyACCEPT
app_nameOnApp
show_ip_address_selection_for_new_vm false
backup_taker_delay300*
cdn_sync_delay1200
billing_stat_updater_delay5
zombie_disk_space_updater_delay300
cluster_monitor_delay15
hypervisor_monitor_delay5
schedule_runner_delay60*
transaction_runner_delay300*
zombie_transaction_time20
kms_server_host
kms_server_port1
ip_range_limit1000
same_autoscaleout_nodes_virtualization_systemtrue                                                                                                                                   
dns_enabledfalse
enabled_libvirt_anti_spoofingfalse
allow_start_vms_with_one_iptrue
allow_initial_root_password_encryptionfalse
wipe_out_disk_on_destroyfalse
password_enforce_complexitytrue
password_minimum_length12
password_upper_lowercasetrue
password_letters_numberstrue
password_symbolstrue
password_force_uniquetrue
password_lockout_attempts3
password_expiry1
password_history_length12
cloud_boot_enabledfalse
nfs_root_ip192.168.1.1
cloud_boot_target192.168.1.1
storage_enabledfalse
prefer_local_readsfalse
vmware_cluster_nameOnApp
service_account_nameonapp
system_alert_reminder_period60
archive_stats_period3
is_archive_stats_enabledfalse
wrong_activated_logical_volume_minutes60
use_html5_vnc_consolefalse
use_rrd_for_statistic_tablestrue
partition_align_offset2048
migration_rate_limit10
iscsi_port_availability_check_timeout5

* - these values are recommended for the specified parameters in order to provide more stable daemon workflow.


Daemon Workflow

To provide more stable daemon workflow for deployments with a high load we recommend increasing values for the following parameters in the /onapp/interface/config/on_app.yml file:

ParameterRecommended value
backup_taker_delay300
schedule_runner_delay60
transaction_runner_delay300


SNMP Statistics

ParameterDefault value
server_community                                              onapp                                                                                                                                
snmp_timeout2
snmp_connect_retries3
snmp_stats_level1_period10
snmp_stats_level2_period60
snmp_stats_level3_period120                                                                   
snmp_max_recv_bytes100000
snmp_stats_protocoludp
Both TCP and UDP protocols are enabled on compute resources by default. You can select the preferred protocol by changing the snmp_stats_protocol parameter value.


VMware Statistics

ParameterDefault value
 vmware_stats_level1_period                    60                                                                                                                                     
 vmware_stats_level2_period                               180
 vmware_stats_usage_interval    20


SolidFire Statistics

ParameterDefault value
solidfire_stats_usage_interval                  120