For long-term use on a Windows server, Stash should be configured to run as a Windows service. This has the following advantages:
| On this page: Related pages: |
![]() | Before you start
|
Setting up Stash as a Windows service
To run Stash as a Windows service:
- Stop Stash.
- Open a Command Prompt (as an Administrator, see the Before you start section above).
- Change directory to the Stash installation directory and then into the
bin
subdirectory. If a directory in the path has spaces (e.g.C:\Program Files\..
), use its eight-character equivalent (e.g.C:\Progra~1\..
). Run the following commands:
> service.bat install > tomcat6 //US//STASH --Startup auto
This will create a service with the name "STASH" and a display name of "Atlassian Stash". If you would like to customize the name you can instead run:
> service.bat install MyName > tomcat6 //US//MyName --Startup auto
This will create the service as "MyName" with a display name of "Atlassian Stash MyName".
Run the following command to increase the amount of memory that Stash can use (the default is 256 Mb):
> tomcat6 //US//service_name --JvmMx 1024
- Verify that the Stash service comes back up after restarting the machine.
Here is an example:
C:\Program Files (x86)\atlassian-stash-1.0.0\bin>service.bat install Installing the service 'STASH' ... Using CATALINA_HOME: "C:\Program Files (x86)\atlassian-stash-1.0.0" Using CATALINA_BASE: "C:\Program Files (x86)\atlassian-stash-1.0.0" Using JAVA_HOME: "C:\Java\jre6" Using JVM: "auto" The service 'STASH' has been installed. C:\Program Files (x86)\atlassian-stash-1.0.0\bin>tomcat6.exe //US//STASH --Startup auto C:\Program Files (x86)\atlassian-stash-1.0.0\bin>tomcat6.exe //US//STASH --JvmMx 1024 C:\Program Files (x86)\atlassian-stash-1.0.0\bin>net start STASH The Atlassian Stash service is starting. The Atlassian Stash service was started successfully.
Troubleshooting
- Problems may occur when trying to setup Stash to run as a Windows service with JDK 1.6. The problem is due to failure to locate MSVCR71.DLL, which can be found in
%JAVA_HOME%/bin
. There are two options to resolve this problem:- Add %JAVA_HOME%/bin to PATH, then restart the Stash server.
- Copy MSVCR71.DLL to system path, C:\WINDOWS\SYSTEM32 or C:\WINNT\SYSTEM32.
- Take note of the username that the service is running as, and be sure to modify the
/temp
and/work
directories in your install directory so that this user has read and write permissions. - You cannot run Stash as a service on a 64-bit operating system if you require allocating more than 1.5GB of memory, due to 32-bit JDK memory limitations and 64-bit JDK/Tomcat service issues.