You need to specify the following bootvm.py script arguments to boot ESC instances.
Arguments |
Description |
||
---|---|---|---|
esc_hostname |
Specifies the host name of the ESC VM instance. |
||
--image |
Specifies the image id used in the OpenStack glance to boot up the ESC instance. |
||
--net |
Specifies the Network IDs or names in OpenStack that ESC connects to. |
||
--ipaddr |
|
||
--gateway_ip |
(Optional) Specifies the default gateway IP address of ESC. |
||
--os_auth_url |
(Optional) Specifies the OpenStack keystone url used by os_auth_url for authentication. |
||
--os_username |
(Optional) Specifies the OpenStack keystone username used by os_username for authentication. |
||
--os_password |
(Optional) Specifies the OpenStack keystone password used by os_password for authentication. |
||
--os_tenant_name |
(Optional) Specifies the OpenStack tenant name used by os_tenant_name for ESC deployment. |
||
--bs_os_auth_url |
(Optional) Specifies the OpenStack keystone url used by bs_os_auth_url for authentication. |
||
--bs_os_username |
(Optional) Specifies the OpenStack keystone username used by bs_os_username for authentication. |
||
--bs_os_password |
(Optional) Specifies the OpenStack keystone password used by bs_os_password for authentication. |
||
--bs_os_tenant_name |
(Optional) Specifies the OpenStack tenant name used by bs_os_tenant_name for ESC deployment. |
||
--flavor |
(Optional) Specifies the OpenStack flavor id to boot the ESC VM. |
||
--security_rules_file |
(Optional) Specifies the file to define security rules (IP, Port security) for ESC VM. |
||
--etc_hosts_file |
(Optional) Specifies the file for adding more entries to the ESC vm's hosts file (/etc/hosts). |
||
--avail_zone |
(Optional) Specifies the OpenStack zone used for ESC deployment. |
||
--esc_params_file |
(Optional) Specifies the default parameter file for ESC deployment. |
||
--db_volume_id |
(Optional) Specifies the cinder volume id to mount for database storage in ESC HA [ESC-HA]. |
||
-- ha_node_list |
|
||
--kad_vip |
(Optional) Specifies the IP address for Keepalived VIP (virtual IP) plus the interface of Keepalived VIP [ESC-HA]. An example format for specifying the interface of VIP is --kad_vip 192.0.2.1:eth2 or --kad_vip [2001:cc0:2020::fc]:eth2 |
||
--kad_vif |
(Optional) Specifies the interface for Keepalived virtual IP and keepalived VRRP [ESC-HA]. You can also use this argument to only specify the interface for Keepalived VRRP, if the VIP interface is already specified using the kad_vip argument. |
||
--bgp_remote_ip |
(Optional) Specifies the bgp remote ip, should be the ip of ASR/BGP Router [ESC-HA] |
||
--bgp_local_as |
(Optional) Specifies the BGP AS number for routing configuration [ESC-HA]. |
||
--bgp_remote_as |
(Optional) Specifies the BGP AS number routing configuration and this number is configured in BGP Router [ESC-HA]. |
||
--bgp_local_router_id |
(Optional) Specifies the BGP routing configuration [ESC-HA].
|
||
--bgp_local_ip |
(Optional) Specifies the IP of the interface for BGP anycast routing [ESC-HA]. |
||
--bgp_md5 |
(Optional) Specifies the md5 code for BGP broadcasting [ESC-HA]. |
||
--route |
Specifies the routing configuration for ESC VM. |
||
--ntp_server |
(Optional) Specifies the NTP server address. |
||
--rsyslog_server |
(Optional) Specifies the IP address of rsyslog server that ESC sends the log to |
||
--rsyslog_server_port |
(Optional) Specifies the port of rsyslog server that ESC sends the log to. |
||
--rsyslog_server_protocol |
(Optional) Specifies the protocol to be used by the ESC to forward logs to the server. |
||
--secure |
|
||
--host_mapping_file |
(Optional) Specifies the host mapping file for VNF deployment. |
||
--version |
(Optional) Prints the version of bootvm.py and exits. |
||
--user_pass |
This along with --user_confd_pass are mandatory arguments from 3.0 onwards. --user_pass admin:'PASSWORD-OR-HASH'[:OPTIONAL-PUBLIC-KEY-FILE][:OPTIONAL-ROLE] Following is an example of --user_pass for admin account and stronger clear text passwords. Use single quotes to avoid conflict with shell reserved characters: -user_pass admin:'Strong4Security!'. Another example to install ESC using a password hash for both admin accounts. Use single quotes to avoid conflict with shell reserved characters: --user_pass admin:'$algorithm$salt$hash-of-salt-password'. ESC 2.1 and later, accepts the public key for this attribute. For example, the following will generate 'admin321' as the password for user 'admin' and use /tmp/abc.pub as the key file to inject the public key for it: --user_pass admin:admin321:/tmp/abc.pub |
||
--user_confd_pass |
--user_confd_pass admin:'PASSWORD-OR-HASH'[:OPTIONAL-PUBLIC-KEY-FILE] Following is an example of --user_confd_ pass for admin account and stronger clear text passwords. Use single quotes to avoid conflict with shell reserved characters: --user_confd_ pass:'Strong4Security!'. Another example, to install ESC using a password hash for both admin accounts. Use single quotes to avoid conflict with shell reserved characters: --user_confd_ pass:'$algorithm$salt$hash-of-salt-password'. ESC 2.1 and later, accepts the public key for this attribute. For example, the following will generate 'admin321' as the password for user 'admin' and use /tmp/abc.pub as the key file to inject the public key for it: --user_confd_ pass:admin321:/tmp/abc.pub |
||
--esc_portal_startup |
(Optional) Starts the ESC portal. |
||
--log |
(Optional) Specifies the log file. By default, logs to stdout. |
||
--esc_monitor_check_ips |
(Optional) Specifies the IP addresses that must be monitored by esc_monitor (for HA failover). |
||
--enable-https-rest |
(Optional) Enables a secure REST Interface for the created ESC VM. |
||
--enable-http-rest |
(Optional) Enables an unsecured REST Interface for the created ESC VM. |
||
--ha_mode |
Specifies the ESC HA mode for HA installation. Specify one of the following available options for HA: no_ha: No HA, cinder: Shared Cinder Volume, drbd: Built-in DRBD, drbd_on_cinder: DRBD over Cinder Volume |
||
--encrypt_key |
Specifies the key for encryption |
||
--proxy |
Uses the proxy on a given port. |
||
--noproxy |
Lists the hosts which do not use proxy. |
||
--kad_vri |
Specified the virtual router id of vrrp instance. ESC VMs in the same HA should use the same kad_vri number. If kad_vip is not used for L3 HA, the kad_vir has to be used, otherwise, you can skip kad_vri argument. |
||
--kad_unicast_src_ip |
Specifies the source IP address of unicast. Should be the IP address of interface that ESC VM uses for unicast (L3) VRRP communication. Example: --kad_unicast_src_ip 10.20.0.1 |
||
--kad_unicast_peer |
Specified the peer IP addresses of unicast. Should be the ip address of interface that ESC peer VM uses for unicast (L3) VRRP communication. Example: --kad_unicast_peer 10.20.0.1 |
||
--placement_hint |
Use this argument to specify the placement of ESC HA virtual machines using the server group, samehost, differenthost filters. |
||
--format {json} |
Use this argument to capture the success and failure message in the output. Example: $ ./bootvm.py --image ESC-2_3_0_8 --net esc-net --format json --test-0 { "status" : "Success" , "vm_uuid" : "UUID" } |
||
--user_rest_pass |
Adds a user to access the Rest API. Format is username: password. This option can be repeated. |
||
--user_portal_pass |
Add a portal user. Format username: password. This option can be repeated. |
||
--no_vim_credentials |
After the deployment is complete, the user can set these VIM credential through ESC's VIM/VIM User APIs (REST/Netconf). For more information on configuring through REST APIs and Netconf, see Configuring VIM credentials after installing ESC in the Post Installation Tasks chapter. |
File |
Description |
security_rules_file |
The file contains the following: |
etc_hosts_file |
The file contains one or more entries that you want to include in the /etc/hosts file. |
esc_params_file |
The file contains information to configure various parameters of ESC. For details on parameters that can be configured in the esc_params_file are described in table below. |
host_mapping_file |
The file contains information to map a network based on the hosts. |
Using this file, you can configure various ESC parameters during the installation. The parameters that can be configured are shown in the table.
openstack.endpoint=adminURL affinity.filter=ServerGroupAffinity
esc_param.conf |
Type |
Default Value |
Description |
---|---|---|---|
default.vm_recovery_retries_max | Int | 3 |
Number of recovery attempts allowed per VM. |
openstack.endpoint | String | adminURL |
The parameter to set up the keystone endpoint value of ESC. Options: adminURL, publicURL |
log.level | String | INFO |
Level of logging. Options: INFO, Trace, DEBUG |
affinity.filter | String | SameHostFilter |
A constant string used to build PolicyEngine and initializing VM policy table. Options: SameHostFilter, ServerGroupAffinity |
anti_affinity.filter | String | DifferentHostFilter |
A constant string used to build PolicyEngine and initializing VM policy table. Options: DifferentHostFilter |
![]() Note | scheduler_default_filters = RetryFilter, AvailabilityZoneFilter,RamFilter, ComputeFilter, ComputeCapabilitiesFilter, ImagePropertiesFilter, ServerGroupAntiAffinityFilter, ServerGroupAffinityFilter, DifferentHostFilter, SameHostFilter |