Quelltext der Seite CKB:Improve performance for systems under high load

  

== Applies to: ==
{{NoteBox|title=|content=All Versions of Cryptshare}}

== Purpose: ==
If your Cryptshare Server is highly frequented it is sometimes necessary to improve the performance of the server.
-----

== Solution: ==
===1. Update Cryptshare Server===
{{TipBox|title=|content=Since the performance improves with every new Cryptshare version, it is advisable to update to the latest version of Cryptshare}}

===2. Check system hardware===
If your system is always under high load you need to increase the system hardware (CPU cores & RAM) of your Cryptshare Server.
{{InfoBox|title=|content=Check your system performance with the following commands:<br />Windows: open '''task manager''' and switch tab to performance<br />Linux: enter command '''htop'''
}}
'''If you are running you Cryptshare Server on a virtual appliance it is also advisable to set up hardware version to the latest version!<br />
'''[[File:51971899.png]]
[[File:51971904.png]]

===3. Assign more memory to Cryptshare application===
The Cryptshare Application uses 25% of your system memory for default.<br />To set-up more memory (at least 50%) for Cryptshare Application follow these steps:
# open '''launcher.ini''' (/opt/cryptsahre-3/launcher.ini) with text editor
# Add the Xms flag to the launcher.ini file: '''-Xms<size>  <br />vm.arg.<number>=-Xms<size>'''
# Add the Xmx flag to the launcher.ini file: '''-Xmx<size>  <br />vm.arg.<number>=-Xmx<size>'''
# restart the Cryptshare Service/Daemon '''rccryptshare restart'''

{{InfoBox|title=Example|content=If your system has 8GB memory and you want use 50% (4GB) for Cryptshare Application enter the following values:<br /> '''lauchner.ini'''<br /> <br /> vm.arg.1=-Xms4G<br /> vm.arg.2=-Xmx4G<br />}}

===4. Change Guest OS settings===
For Cryptshare Server running on vSphere the Guest OS settings should be set to the newest version provided by your vSphere<br />[[File:51971901.png]]<br />[[File:51971902.png]]<br />[[File:51971903.png]]

===5. Adjust the Web Server Configuration===
The configuration file "resources/WEB-INF/ui-config.xml" in the Cryptshare Server installation directory can be used to adjust how the web server behaves, the following section includes comments to highlight the options that can be adjusted to improve performance under high load. You can find the full documentation for the configuration file in the [http://www.eclipse.org/jetty/documentation/current/reference-section.html#jetty-xml-syntax Jetty Wiki].

 '''ui-config.xml'''

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "resources/WEB-INF/configure.dtd">
 <Configure id="Cryptshare" class="org.eclipse.jetty.server.Server">  
 	<Arg name="threadpool">
 		<New class="org.eclipse.jetty.util.thread.QueuedThreadPool">
 			<Arg name="minThreads" type="int">5</Arg>
 			<Arg name="maxThreads" type="int">25</Arg> <!-- OPTION: If a lower value is set, the maximum amount of requests the web server will process is reduced. This will cause the server to handle fewer request but be more responsive. -->
 			<Arg name="idleTimeout" type="int">1000</Arg>
 			<Arg name="queue">
 				<New class="java.util.concurrent.ArrayBlockingQueue">
 					<Arg type="int">200</Arg> <!-- OPTION: If a lower value is set, the server will accept less requests while all threads are used. This will cause the server to handle fewer request but be more responsive. -->
 				</New>
 			</Arg>
 		</New>
 	</Arg>
 
 	[...]
 
 	<Call name="addConnector">
 		<Arg>
 			<New class="org.eclipse.jetty.server.ServerConnector">
  				[...]
 	 			<Set name="idleTimeout">
 					<Property name="http.timeout" default="15000"/> <!-- OPTION: If a lower value is set, the server will terminate unresponsive connections faster. This will cause the server to drop inactive requests faster and reduce the total 
 server load. -->
 				</Set>
 				[...]
  			</New>
 		</Arg>
 	</Call>
 	<Call id="sslConnector" name="addConnector">
 		<Arg>
 			<New class="org.eclipse.jetty.server.ServerConnector">
 			[...]
 			<Set name="idleTimeout">
 				<Property name="http.timeout" default="15000"/> <!-- OPTION: If a lower value is set, the server will terminate unresponsive connections faster. This will cause the server to drop inactive requests faster and reduce the total server load. -->
 			</Set>
 			[...]
 			</New>
 		</Arg>
 	</Call>
 </Configure>

Additionally, other settings of the Cryptshare Server can be adjusted to improve responsiveness as described here: [[CSSCurrent_en:Advanced_Configuration|Advanced Cryptshare Configuration]]