set-application-property-113e957.md

set-application-property

Use this command to change the value of a single property of a deployed application without the need to redeploy it. Execute the command separately for each property that you want to set. For the changes to take effect, restart the application.

Remember:

SAP Business Technology Platform, Neo environment will sunset on December 31, 2028, subject to terms of customer or partner contracts.

For more information, see SAP Note 3351844.

Tip:

This documentation refers to SAP Business Technology Platform, Neo environment. If you are looking for documentation about other environments, see SAP Business Technology Platform ↗️.

To execute the command successfully, you need to to specify the new value of one property from the optional parameters table below.

neo set-application-property --host <host> --account <subaccount_technical_name> --application <application_name> --user <e-mail_or_user> 
--<property> <new_property_value>

Parameters

To list all parameters available for this command, execute the neo help set-application-property in the command line.

Required
-a, --account	Subaccount technical name Type: string (up to 30 characters; lowercase letters and numbers, starting with a letter)
-b, --application	Application name Type: string (up to 30 characters; lowercase letters and numbers, starting with a letter)
-h, --host	Enter a region host. Type: URL, for acceptable values see Regions ↗️.
-p, --password	To protect your password, enter it only when prompted by the console client and not explicitly as a parameter in the properties file or the command line. Type: string
-u, --user	Use your email, SAP ID or user name Type: string

Optional
Command-specific parameters
--ev	Environment variables for configuring the environment in which the application runs. Sets the new environment variable without removing the previously set value; can be used multiple times in one execution. Type: --ev <KEY1>=<VALUE1> --ev <KEY2>=<VALUE2>, where a key-value pair specifies one environment variable. If you provide a key without any value (--ev <KEY1>=), the environment variable KEY1 will be deleted. For a value that contains spaces, use quotation marks.
-j, --java-version	Java Virtual Machine version Default: depends on the SAP BTP SDK for Neo environment Type: the version number of the JRE 7. (beta) You can use JRE 8 with the Java Web Tomcat 7 runtime (neo-java-web version 2.25 or higher) in subaccounts enabled for beta features. For more information, see Choose JRE Version
-m, --minimum-processes	Minimum number of application processes, on which the application can be started Default: 1
-M, --maximum-processes	Maximum number of application processes, on which the application can be started Default: 1
-V, --vm-arguments	Java Virtual Machine arguments System properties (-D<name>=<value>) separated with space that will be used when starting the application process. Memory settings of your compute units. You can set the following memory parameters: -Xms, -Xmx, -XX:PermSize, -XX:MaxPermSize. We recommend that you use the default memory settings. Change them only if necessary and note that this may impact the application performance or its ability to start. For more information, see Configure VM Arguments
-z, --size	Compute unit size Acceptable values: lite, pro, prem, prem-plus Default: the smallest size from the subaccount quotas For more information, see Compute Units
--runtime-version	SAP BTP runtime version on which the application will be started and will run on the same version after a restart. Otherwise, by default, the application is started on the latest minor version (of the same major version) which is backward compatible and includes the latest corrections (including security patches), enhancements, and updates. Note that choosing this option does not affect already started application processes. You can view the recommended versions by executing the list-runtime-versions command. Note: If you choose your runtime version, consider its expiration date and plan updating to a new version regularly. For more information, see Choose Application Runtime Version
Tomcat connector attributes
--compression	Enable or disable gzip response compression Default: off Possible values: on (allow compression), off(disable compression), force (forces compression for all responses) or aninteger (which enables compression and specifies the compression-min-size value in bytes). For more information, see Enable and Configure Gzip Response Compression
--compressible-mime-type	A comma separated list of MIME types for which compression will be used Default: text/html, text/xml, text/plain Condition: applicable if compression is enabled
--compression-min-size	Responses bigger than this value get compressed Condition: applicable if compression is enabled
--connection-timeout	Defines the number of milliseconds to wait for the request URI line to be presented after accepting a connection. Default: 20000
--max-threads	Specifies the maximum number of simultaneous requests that can be handled. Default: 200
--uri-encoding	Specifies the character encoding used to decode the URI bytes on application request. Default: ISO-8859-1 For more information, see the encoding sets supported by Java SE 6 and Java SE 7.

Example

To change the minimum number of server processes on which you want your deployed application to run, execute:

neo set-application-property --host hana.ondemand.com --account mysubaccount --application myapp --user [email protected] --minimum-processes 2

Related Information

Update Application Properties

deploy

display-application-properties

restart

Org Administration Using the Cockpit ↗️