Tuning up a ZIP installation

Configuring Upsource Launcher properties

Upsource Launcher process uses:

Upsource-specific properties — can be changed programmatically with the configure command.
See a list of the configurable Upsource-specific Launcher properties.
JVM properties — can be changed programmatically with the configure command or by manually editing the configuration file upsource.jvmoptions.
A JVM property can be also changed on a temporary basis, passing it as an ad hoc parameter with the start command. This method only applies the changes for the current run and does not change the configuration file. Use this option when you want to test changes to your server configuration.
See a list of the default JVM options for the Upsource Launcher process.

To change Upsource-specific Launcher properties:

Stop Upsource: <upsource_home>/bin/upsource.sh stop
Enter the upsource.sh configure command, followed by all of the settings that you want to update in the configuration file. You can set multiple options in a single command. For example:
<upsource_home>/bin/upsource.sh configure --listen-port 1111 --base-url http://upsource.mydomain.com:2222
Start Upsource.

To change JVM Launcher properties programmatically:

Stop Upsource: <upsource_home>/bin/upsource.sh stop
Enter the upsource.sh configure command, followed by all of the settings that you want to update in the configuration file.
Use the -J prefix followed by a JVM option. Do not add any spaces between the prefix and the option.
The symbol that precedes the option determines how it is applied:
- Add an option with the - symbol.
- Remove an option with the + symbol.
If you specify a value, the corresponding option is only removed if it has exactly the same value.
You can set multiple options in a single command.
Example:
upsource.sh configure -J-Xmx1024m -J-XX:+HeapDumpOnOutOfMemoryError
Start Upsource.

You can also change JVM setting by editing a configuration file manually.

To change JVM Launcher properties manually:

Stop Upsource: <upsource_home>/bin/upsource.sh stop
Open the configuration file upsource.jvmoptions located in the directory <upsource_home>/conf.
If the the file does not exist, create it and copy the contents of the sample configuration file with the .dist extension into it.
Edit the JVM options directly in the file. List each JVM option on a new line. To set a pre-defined JVM option, simply uncomment the corresponding line.
Save and close the file.
Start Upsource.
- The changes to the configuration file are copied to the database.
- Upsource starts using the specified settings.

To change JVM Launcher properties on a temporary basis (ad hoc):

Stop Upsource: <upsource_home>/bin/upsource.sh stop
Enter the upsource.sh start command, followed by all of the settings that you want to pass to Upsource on start.
Use the --J prefix to pass the settings as ad hoc parameters. Follow the prefix with a JVM option. Do not add any spaces between the prefix and the option.
The symbol that precedes the option determines how it is applied:
- Add an option with the - symbol.
- Remove an option with the + symbol.
If you specify a value, the corresponding option is only removed if it has exactly the same value.
You can set multiple options in a single command.
Example:
upsource.sh start --J-Xmx1024m --J-XX:+HeapDumpOnOutOfMemoryError
- Upsource starts with the specified settings, bypassing the configuration file.
- The configuration file is not modified.
- Subsequent starts that do not specify the ad hoc parameter use the settings that are stored in the configuration file. To run Upsource with the previous settings, simply restart it without passing any custom parameters.

Configuring Upsource Frontend properties

Upsource Frontend process uses:

Upsource Frontend properties can be changed programmatically with the configure command or by manually editing the configuration file upsource-frontend.jvmoptions

To configure Frontend properties programmatically:

Stop Upsource: <upsource_home>/bin/upsource.sh stop
Switch to the directory <upsource_home>/conf/upsource-frontend
Enter the upsource-frontend.sh configure command, followed by all of the settings that you want to update in the configuration file.
Use the -J prefix followed by a property or JVM option. Do not add any spaces between the prefix and the option.
The symbol that precedes the option determines how it is applied:
- Add an option with the - symbol.
- Remove an option with the + symbol.
If you specify a value, the corresponding option is only removed if it has exactly the same value.
You can set multiple options in a single command.
Example 1:
upsource-frontend.sh configure -J-Dfrontend.diff.filesize.limit=2000
In this example we increased the maximum number of lines to display in a diff from 1000(default) to 2000.
Example 2:
upsource-frontend.sh configure -J-Xmx1024m -J-XX:+HeapDumpOnOutOfMemoryError
Start Upsource.
- Upsource starts with the specified settings.
- The configuration file upsource-frontend.jvmoptions is modified and the new settings will be applied to any consequent startup.

To configure Frontend properties manually:

Stop Upsource: <upsource_home>/bin/upsource.sh stop
Open the configuration file upsource-frontend.jvmoptions located in the <upsource_home>/conf/upsource-frontend directory. If the file does not exist, create it.
Edit existing properties directly in the file. Add new properties with their values to the end of the file.
Save and close the file.
Start Upsource.
- The changes to the configuration file are copied to the database.
- Upsource starts with the specified settings.

Configuring Upsource Cassandra properties

You can manage the Cassandra process by changing its JVM options with the configure command or by manually editing the configuration file cassandra.jvmoptions. See Upsource Cassandra properties for a list of the default options.

To configure Cassandra properties programmatically:

Stop Upsource: <upsource_home>/bin/upsource.sh stop
Switch to the directory <upsource_home>/conf/cassandra
Enter the cassandra.sh configure command, followed by all of the settings that you want to update in the configuration file.
Use the -J prefix followed by a JVM option. Do not add any spaces between the prefix and the option.
The symbol that precedes the option determines how it is applied:
- Add an option with the - symbol.
- Remove an option with the + symbol.
If you specify a value, the corresponding option is only removed if it has exactly the same value.
You can set multiple options in a single command.
Example:
cassandra.sh configure -J-Xmx3500m -J-XX:+HeapDumpOnOutOfMemoryError
Start Upsource.

To configure Cassandra properties manually:

Stop Upsource: <upsource_home>/bin/upsource.sh stop
Open the configuration file cassandra.jvmoptions located in the <upsource_home>/conf/cassandra directory. If the file does not exist, create it.
Edit existing properties directly in the file. Add new properties with their values to the end of the file.
Save and close the file.
Start Upsource.
- The changes you made to the configuration file are copied to the database.
- Upsource starts with the specified settings.

Last modified: 02 April 2021