Newton Series Release Notes¶
3.2.1-4¶
Bug Fixes¶
Fixed a
__init__()gotanunexpectedkeywordargument'project_name'error in various networking commands whenhelpor--helpwas used.[Bug1650026]
3.2.1¶
Security Issues¶
Mask passwords when
--debugor-vvoptions are used.[Bug1630822]
Bug Fixes¶
Skip password prompt when running commands that do not require auth and user auth values are present except for password. [Bug1619274]
Fix problem with
--os-auth-typetoken_endpointthat caused exceptions when recent os-client-config version 1.23.0 or newer is installed. [Bug1642301]
3.2.0¶
Bug Fixes¶
Fix prompting for password issue introduced in release 3.0.0[Bug1617384]
3.0.0¶
New Features¶
Add a new command
portunsetto clear the informationof fixed-ip and binding-profile from the port.[ Blueprintnetwork-property-unset]
Added support of –server-groups –server-group-members options to
quotasetcommand.[Bug1602223]
Add new commands
volumebackupcreate/delete/list/show/restore. It is used to replace the old commandsbackupcreate/delete/list/show/restore. [Blueprintbackup-snapshot-renamed-for-volume-resource]
Add
networkagentdelete,networkagentlist,networkagentshowandnetworkagentsetcommands. [Blueprintimplement-network-agents]
Support bulk deletion and error handling for
aggregatedelete,flavordelete,keypairdeleteandservicedeletecommands. [Blueprintmulti-argument-compute]
Support bulk deletion for
subnetpooldelete,subnetdelete,floatingipdelete,securitygroupdeleteandsecuritygroupruledelete. [Blueprintmulti-argument-network]
Update
--binding-profileoption on theportcreateandportsetcommands to support JSON input for more advanced binding profile data. [Blueprinthttps://blueprints.launchpad.net/python-openstackclient/+spec/neutron-client]
Add
--enable-port-securityand--disable-port-securityoptions on thenetworkcreateandnetworksetcommands. This supports setting the default port security for ports created on a network. [Blueprinthttps://blueprints.launchpad.net/python-openstackclient/+spec/neutron-client]
Add
genevechoice to thenetworkcreatecommand--provider-network-typeoption. [Blueprinthttps://blueprints.launchpad.net/python-openstackclient/+spec/neutron-client]
Add
--device-owneroption to theportlistcommand to enable listing ports based on device owner. [Blueprinthttps://blueprints.launchpad.net/python-openstackclient/+spec/neutron-client]
Add
networkrbaclist,networkrbacshow,networkrbaccreate,networkrbacdeleteandnetworkrbacsetcommands. [Blueprintneutron-client-rbac]
Add
--network-segmentoption to thesubnetcreatecommand. This is a beta command option and subject to change. Use global option--os-beta-commandto enable this option. [Blueprintrouted-networks]
Add support for showing flavor access list by using
flavorshowcommand.[Bug1575461]
Add
--purgeoption tovolumedeletecommand (Volume v2 only) inorder to removing any snapshots along with volume automatically when userdelete the volume.[Bug1589332]
Add options
--upand--downfor compute v2computeservicesetcommand to support force up/down compute service. [Bug1589348]
Support bulk deletion for
ec2credentialsdelete,endpointdelete,servicedeletein identity V2.0 . [Bug1592906]
Support bulk deletion for identity v3 commands:
consumer,credential,domain,ec2creds,endpoint,federation_protocol,identity_provider,mapping,policy,region,service_providerandservice.[Bug1592906]
Support bulk deletion for
volumetypedelete. [Bug1592906]
Add
--forceoption tobackupcreatecommand to allow users toback up an in-use volume.[Bug1596443]
Add
--propertyoption toflavorcreatecommand. [Bug1596798]
Add
--forceoption tovolumeqosdeletecommand to allow users todelete in-use QoS specification(s).[Bug1596821]
Add
--snapshotoption tobackupcreatecommand.[Bug1597184]
Add
--forceoption tobackupdeletecommand to allow deletein state other than error or available.[Bug1597188]
Add
--propertyoption tosnapshotcreatecommand. [Bug1597192]
Add
--publicand--privateoptions tovolumetypelistcommand.[Bug1597198]
Add
--incrementaloption tobackupcreatecommand to allow users tocreate incremental backups.[Bug1600196]
Add
--projectand--project-domainoptions tovolumetypecreatecommand. [Bug1602169]
Support to get server
rdp,serial,mkstype console url. [Bug1605088]
Add
--limitand--markeroptions tosnapshotlistcommand.[Bug1605475]
Deprecate
rolelistarguments in favor ofroleassignmentcommand. [Bug1605774]
Add support for domain specific roles in
roleand``role assignment`` commands. [Bug1606105]
Make
subnetlistcommand supports listing up subnets withdhcp enabled/disabled by adding--dhcpand--no-dhcpoptions to the command.[Bug1610883]
Add “Checksum” column to output of “image list –long” [Bug1602073]
Add
--projectand--project-domainoptions to theflavorcreatecommand. We can use these options to add the flavor access to a given project when we create the flavor.
Add new command
floatingippoollistto list up all floating ip pools. This command is used to replace the old commandipfloatingpoollist. [Blueprint rework-ip-commandshttps://blueprints.launchpad.net/python-openstackclient/+spec/rework-ip-commands]
Add new commands
serveradd/removefloatingip. They are used to replace the old commandsipfloatingadd/remove. [Blueprint rework-ip-commandshttps://blueprints.launchpad.net/python-openstackclient/+spec/rework-ip-commands]
Add new commands
serveradd/removefixedip. They are used to replace the old commandsipfixedadd/remove. [Blueprint rework-ip-commandshttps://blueprints.launchpad.net/python-openstackclient/+spec/rework-ip-commands]
Add new commands
floatingipcreate/delete/list/show. It is used to replace the old commandsipfloatingcreate/delete/list/show. [Blueprint rework-ip-commandshttps://blueprints.launchpad.net/python-openstackclient/+spec/rework-ip-commands]
Show project access details for private volume type.
An user can list projects which have access toa specific private volume type by using
volumetypeshow<volume-type>[Bug1554891]
Add a new command
subnetunsetto clear the informationof allocation-pools, host-routes or DNS servers from the subnet.[ Blueprintnetwork-property-unset]
Add a new command
routerunsetto clear the informationof routes from the router.[ Blueprintnetwork-property-unset]
Add a new command
subnetpoolunsetto clear the informationof pool-prefixes from the subnet pools.[ Blueprintnetwork-property-unset]
Upgrade Notes¶
All
setandunsetcommands now return normally when nothing specified to modify. This will become the default behavior of OSCsetandunsetcommands. [Bug1588588]
Migrate command
computeagentsetarguments to be optional.
With the change to use keystoneauth plugins the OpenStackClient-specific
osc_passwordauthentication plugin has been removed. The visible difference should only be in the behaviour with poorly configured clouds with old default Keystone values for admin_endpoint and public_endpoint as seen in the version details returned in a GET to the root (‘/’) route.
Deprecation Notes¶
Deprecate commands
backupcreate/delete/list/show/restore. [Blueprintbackup-snapshot-renamed-for-volume-resource]
Deprecate command
ipfloatingpoollist. [Blueprint rework-ip-commandshttps://blueprints.launchpad.net/python-openstackclient/+spec/rework-ip-commands]
Deprecate commands
ipfloatingadd/remove. [Blueprint rework-ip-commandshttps://blueprints.launchpad.net/python-openstackclient/+spec/rework-ip-commands]
Deprecate commands
ipfixedadd/remove. [Blueprint rework-ip-commandshttps://blueprints.launchpad.net/python-openstackclient/+spec/rework-ip-commands]
Deprecate commands
ipfloatingcreate/delete/list/show. [Blueprint rework-ip-commandshttps://blueprints.launchpad.net/python-openstackclient/+spec/rework-ip-commands]
Bug Fixes¶
Support a new
--stateoption forvolumesetcommand thatchanges the state of a volume.[Bug1535213]
Keystone V3user password set is a self-service operation. It should not required a scoped token as it is not considered ascoped operation. [Bug1543222]
When performing
domainshow,projectshoworusershow, peek into the user token to determine the ID or the resource (if supplied with only a name). This should make finding information about the user and their project easier for non-admin users. [Bug1561599]
Fix setting defaults for some scope parameters, that were putting invalid scope parameters for some auth plugins. [Bug1582774]
Raise
ArgumentTypeErrorif the input arguments do not match the typekey=valuewhen we set properties. [Bug1589935]
Scope options are now validated after authentication occurs, and only if the user does not have a default project scope. [Bug1592062]
Fix for network OS_ENDPOINT_TYPE/–os-interface. Previously these were being ignored for network commands which resulted in the public endpoint always being used. [Bug1592368]
Add default IP version in
ipavailabilitylistcommand and make this command work properly without--ip-versionoption. [Bug1592761]
Fixed service name lookup in Identity commands to properly handle multiple matches. [Bug1597296]
2.6.0¶
New Features¶
Add
serverbackupcreatecommand
Add
networksegmentlistandnetworksegmentshowcommands. These are beta commands and subject to change. Use global option--os-beta-commandto enable these commands. [Blueprintrouted-networks]
Add
volumetransferrequestlistcommand[Bug 1554886]
Add
--projectoption toflavorsetcommand to set project accessto a flavor[Bug 1575461]
Add
--projectoption toflavorunsetcommand to remove project accessto a flavor[Bug 1575461]
Add
imageunsetcommand [Bug 1582968]
Add
ipavailabilitylistandipavailabilityshowcommands[Blueprinthttps://blueprints.launchpad.net/python-openstackclient/+spec/neutron-ip-capacity]
Add
--stateoption toserversetcommand to set the server toactive or error state.[Blueprintserver-reset-state]
Upgrade Notes¶
addressscopedeletecommand now accepts multiple address scopesin a single command
computeagentdeletecommand now supports deleting multiple agentsin a single command
An exception is not raised by command
servicesetwhen nothing specified. Instead, the service is not enabled by default. And if--disable-resionis specified but not--disable, an exception will be raised.
Bug Fixes¶
Fix the
--enableoption on all commands by changing the--enable-beta-commandsglobal option to--os-beta-command. There are no upgrade impacts for the global option rename since the old name isn’t used. [Bug1588384]
2.5.0¶
New Features¶
Add network support for
quotasetcommand. Options added includes--networks--subnets--subnetpools--ports--routers--rbac-policies--vips--members--health-monitors.Options--floating-ips--secgroup-rules--secgroupsnow supportboth network and compute API.[Bug1489441]
Add
--icmp-typeand--icmp-codeoptions to thesecuritygrouprulecreatecommand for Network v2 only. These options can be used to set ICMP type and code for ICMP IP protocols. [Bug1519512]
The following Network v2 IP protocols are supported by the
securitygrouprulecreatecommand--protocoloption,ah,dccp,egp,esp,gre,igmp,ipv6-encap,ipv6-frag,ipv6-icmp,ipv6-nonxt,ipv6-opts,ipv6-route,ospf,pgm,rsvp,sctp,udplite,vrrpand integer representations [0-255]. [Bug1519512]
The
securitygrouprulelistcommand supports displaying the ICMP type and code for security group rules with the ICMP IP protocols. [Bug1519512]
Add
servergroupcreate,servergroupdelete,servergrouplist,servergroupshowcommands.[Bug1542171][Blueprintnova-server-group-support]
Add
--shareand--defaultoptions tosubnetpoolcreateand--defaultoption tosubnetpoolset[Bug1544586] [Bug1544591]
Add
--transparent-vlanand--no-transparent-vlanoptions tonetworkcreateandnetworksetcommands to add/remove VLANtransparency attributes from networks.This option is available in Network V2 only.[Bug1545537]
Adds
volumeservicelistcommand.[Bug1550999]
Support X.latest format for OS_COMPUTE_API_VERSION in order to talk with the latest nova microversion API, that is very helpful shortcut usage to use new nova side features. [Bug1561838]
Add
addressscopecreate,addressscopedelete,addressscopelist,addressscopesetandaddressscopeshowcommands. [Bug1566269]
Add the
--ip-versionoption to thesubnetlistcommand. This will output subnets based on IP version filter. [Bug 1581179]
Upgrade Notes¶
Changed the
securitygrouprulecreatecommand--protooption to--protocol. Using the--protooption is still supported, but is no longer documented and may be deprecated in a future release. [Bug1519512]
Bug Fixes¶
Support a new
--stateoption forsnapshotsetcommand thatchanges the state of a snapshot.[Bug1535239]
--pool-prefixoption made required forsubnetpoolcreate[Bug1536479]
Command
networkdeletewill delete as many networks as possible, log and report failures in the end. [Bug1556719] [Bug1537856]
Fixed the
--routeoption on theroutersetcommand which did not properly format the new routes to set resulting in aBadRequesterror. In addition, theroutercreate,routerlistandroutershowcommand output for routes was fixed to improve readability and to align with the--routeoption on theroutersetcommand. [Bug1564460]
Added
--no-routeto theroutersetcommand. Deprecated--clear-routes. [Bug1565034]
Fixed
networkcreate,networkshowandnetworklistcommands to correctly display the router type in therouter:externalandRouterTypecolumns. [Bug1572228]
The
quotashowcommand<project/class>argument is now optional. If not specified, the user’s current project is used. This allows non-admin users to show quotas for their current project. [Bug1572733]
Fixed
flavorshow/delete/set/unsetcommand to properly find a private flavor by flavor name. [Bug1575478]
Fixed
flavorset/unsetcommand to properly find a flavor to be set/unset by flavor id. [Bug1575624]
2.4.0¶
New Features¶
Add
--disable-reasonoption to theservicesetcommand
Add
portcreate,portlistandportsetcommands[Bug1519909]
Add
serverrestorecommand
The
securitygroupcreate,securitygroupsetandsecuritygroupshowcommands now uses Network v2 when enabled which results in a more detailed output for network security group rules. [Bug1519511]
Add
--projectand--project-domainoptions to thesecuritygroupcreatecommand for Network v2. [Bug1519511]
Add
--ingress,--egress,--ethertype,--projectand--project-domainoptions to thesecuritygrouprulecreatecommand for Network v2 only. These options enableegressandIPv6security group rules along with setting the project. [Bug1519512]
The
securitygrouprulelistcommand now uses Network v2 when enabled which results inegresssecurity group rules being displayed. The--longoption was also added for Network v2 to display direction and ethertype information. In addition, security group rules for all projects will be displayed when thegroupargument is not specified (admin only). This is done by default when using Network v2, but requires the new--all-projectsoption when using Compute v2. [Bug1519512]
The
securitygrouprulecreatecommand now supports a security group name for the--src-groupoption. [Bug1540656]
Add
subnetcreatecommand.[Bug1542364]
Add provider network options
--provider-network-type,--provider-physical-networkand--provider-segmentto thenetworkcreateandnetworksetcommands.These options are available for NetworkV2 only.[Bug1545537]
Add external network options
--external|--internaland--externalsuboptions--default|--no-defaultto thenetworkcreateandnetworksetcommands.These options are available for Network version 2 only.[Bug1545537]
Add
--image-propertyoption tovolumesetandvolumeunsetcommandsImage properties are copied when a volume is created from an image.The properties are immutable on the image itself but may be updatedor removed from the volume created from that image.
Add
--projectand--project-domainoptions tovolumetypesetandvolumetypeunsetcommandsUse the
--projectoption to restrict a volume type to a specific project.Volume types are public by default, restricted volume types should be madeprivate with the--privateoption to thevolumecreatecommand.
Add
hostsetcommand [Bug1556929]
Add
aggregateunsetcommand [Bug1559866]
Add global options
os-certand--os-keyto support client certificate/key. Environment variablesOS_CERTandOS_KEY, as well as thecertandkeyvalues in clouds.yaml may also be used [Bug1565112]
Add
routeraddportcommand[Bug1546849]
Add
routerremoveportcommand[Bug1546849]
Add
routeraddsubnetcommand[Bug1546849]
Add
routerremovesubnetcommand[Bug1546849]
Add
subnetsetcommand.[Bug1542363]
Upgrade Notes¶
The
ipfloatingcreatecommand now uses Network v2 when enabled [Bug1519502]
The
securitygrouprulecreatecommand now uses Network v2 when enabled which results in a more detailed output for network security group rules that matches thesecuritygroupruleshowcommand. [Bug1519512]
Deprecate global option
--profilein favor of--os-profile.--profileinterferes with existing command options with the same name.Unfortunately it appeared in a release so we must follow the deprecationprocess and wait one year (April 2017) before removing it.[Bug1571812]
Bug Fixes¶
The
securitygroupcreatecommand now uses Network v2 when enabled which allows the security group description to be created with an empty value. In addition, thetenant_idfield changed toproject_idto match thesecuritygroupshowcommand output. [Bug1519511]
The
securitygrouprulelistcommand no longer ignores thegroupargument when it is set to an empty value. [Bug1519512]
Fixed
openstackcommandlistto display properly[Bug1545609]
Fixed SSL/TLS verification for Network v2 commands. The commands were ignoring the
--insecureand--os-cacertoptions and theOS_CACERTenvironment variable which caused them to fail withAnSSLerroroccurred.when authenticating using SSL/TLS. [Bug1560157]
Fixed
subnetpoollistcommand to properly disply the list of subnet pool prefixes in thePrefixescolumn. This fix is consistent with thesubnetpoolcreateandsubnetpoolshowcommand output. [Bug1569480]
Make
--nameoptional involumesnapshotcreateandvolumebackupcreatecommands.
