Tuning up a ZIP installation
On this page:
- Configuring Upsource Launcher properties
- Configuring Upsource Frontend properties
- Configuring Upsource Cassandra properties
Configuring Upsource Launcher properties
Upsource Launcher process uses:
Upsource-specific properties — can be changed programmatically with the
configurecommand.See a list of the configurable Upsource-specific Launcher properties.
JVM properties — can be changed programmatically with the
configurecommand 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
startcommand. 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 configurecommand, 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 configurecommand, followed by all of the settings that you want to update in the configuration file.Use the
-Jprefix 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- Add an option with the
- 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 startcommand, followed by all of the settings that you want to pass to Upsource on start.Use the
--Jprefix 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.
- Add an option with the
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-frontendEnter the
upsource-frontend.sh configurecommand, followed by all of the settings that you want to update in the configuration file.Use the
-Jprefix 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=2000In 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- Add an option with the
- Start Upsource.
- Upsource starts with the specified settings.
- The configuration file
upsource-frontend.jvmoptionsis 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-frontenddirectory. 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 theconfigure 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/cassandraEnter the
cassandra.sh configurecommand, followed by all of the settings that you want to update in the configuration file.Use the
-Jprefix 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- Add an option with the
- 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/cassandradirectory. 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.