• Bitbucket can be automatically restarted if it stops for some reason.
• Bitbucket is less likely to be accidentally shut down, as can happen if the terminal Bitbucket was manually started in is closed.
• Logs from the Bitbucket JVM can be properly managed by the service.

Using the Java Service Wrapper

Bitbucket can be run as a service on Linux using the Java Service Wrapper. The Service Wrapper is known to work with Debian, Ubuntu, and Red Hat.

The Service Wrapper provides the following benefits:

• Allows Bitbucket, which is a Java application, to be run as a service.
• No need for a user to be logged on to the system at all times, or for a command prompt to be open and running on the desktop to be able to run Bitbucket.
• The ability to run Bitbucket in the background as a service, for improved convenience, system performance and security.
• Bitbucket is launched automatically on system startup and does not require that a user be logged in. 
• Users are not able to stop, start, or otherwise tamper with Bitbucket unless they are an administrator.
• Can provide advanced failover, error recovery, and analysis features to make sure that Bitbucket has the maximum possible uptime.

Please see http://wrapper.tanukisoftware.com/doc/english/launch-nix.html for wrapper installation and configuration instructions.

The service wrapper supports the standard commands for SysV init scripts, so it should work if you just create a symlink to it from /etc/init.d.

Using an init.d script

The usual way on Linux to ensure that a process restarts at system restart is to use an init.d script. This approach does not restart Bitbucket if it stops by itself.

1. Create the startup script in /etc/init.d/atlbitbucket with the following contents (Ensure the script is executable by running chmod 755 atlbitbucket):
   

   ここをクリックして展開...

   #! /bin/sh
   
   ### BEGIN INIT INFO
   # Provides:          atlbitbucket
   # Required-Start:    $remote_fs $syslog
   # Required-Stop:     $remote_fs $syslog
   # Default-Start:     2 3 4 5
   # Default-Stop:      0 1 6
   # Short-Description: Initscript for Atlassian Bitbucket Server
   # Description:  Automatically start Atlassian Bitbucket Server when the system starts up.
   #               Provide commands for manually starting and stopping Bitbucket Server.
   ### END INIT INFO
   
   # Adapt the following lines to your configuration
   # RUNUSER: The user to run Bitbucket Server as.
   RUNUSER=atlbitbucket
   
   # BITBUCKET_INSTALLDIR: The path to the Bitbucket Server installation directory
   BITBUCKET_INSTALLDIR="/opt/atlassian-bitbucket-X.Y.Z"
   
   # BITBUCKET_HOME: Path to the Bitbucket home directory
   BITBUCKET_HOME="/opt/bitbucket-home"
   
   # ==================================================================================
   # ==================================================================================
   # ==================================================================================
   
   # PATH should only include /usr/* if it runs after the mountnfs.sh script
   PATH=/sbin:/usr/sbin:/bin:/usr/bin
   DESC="Atlassian Bitbucket Server"
   NAME=atlbitbucket
   PIDFILE=$BITBUCKET_HOME/log/bitbucket.pid
   SCRIPTNAME=/etc/init.d/$NAME
   
   # Read configuration variable file if it is present
   [ -r /etc/default/$NAME ] && . /etc/default/$NAME
   
   # Define LSB log_* functions.
   # Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
   . /lib/lsb/init-functions
   
   
   run_with_home() {
       if [ "$RUNUSER" != "$USER" ]; then
           su - "$RUNUSER" -c "export BITBUCKET_HOME=${BITBUCKET_HOME};${BITBUCKET_INSTALLDIR}/bin/$1"
       else
           export BITBUCKET_HOME=${BITBUCKET_HOME};${BITBUCKET_INSTALLDIR}/bin/$1
       fi
   }
   
   #
   # Function that starts the daemon/service
   #
   do_start()
   {
       run_with_home start-bitbucket.sh
   }
   
   #
   # Function that stops the daemon/service
   #
   do_stop()
   {
       if [ -e $PIDFILE ]; then
         run_with_home stop-bitbucket.sh
       else
         log_failure_msg "$NAME is not running."
       fi
   }
   
   
   case "$1" in
     start)
       [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
       do_start
       case "$?" in
           0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
           2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
       esac
       ;;
     stop)
       [ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
       do_stop
       case "$?" in
           0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
           2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
       esac
       ;;
     status)
          if [ ! -e $PIDFILE ]; then
            log_failure_msg "$NAME is not running."
            return 1
          fi
          status_of_proc -p $PIDFILE "" $NAME && exit 0 || exit $?
          ;;
     restart|force-reload)
       #
       # If the "reload" option is implemented then remove the
       # 'force-reload' alias
       #
       log_daemon_msg "Restarting $DESC" "$NAME"
       do_stop
       case "$?" in
         0|1)
           do_start
           case "$?" in
               0) log_end_msg 0 ;;
               1) log_end_msg 1 ;; # Old process is still running
               *) log_end_msg 1 ;; # Failed to start
           esac
           ;;
         *)
           # Failed to stop
           log_end_msg 1
           ;;
       esac
       ;;
     *)
       echo "Usage: $SCRIPTNAME {start|stop|status|restart|force-reload}" >&2
       exit 3
       ;;
   esac

2. Enable the service to start at boot time:

   1. For Ubuntu and other Debian derivatives, use:

      update-rc.d atlbitbucket defaults

   2. For RHEL and derivatives, use:

      chkconfig --add atlbitbucket --level 0356

      You may have to install the redhat-lsb package on RHEL or derivatives to provide the LSB functions used in the script.

3. Gracefully shutdown Bitbucket.

4. Restart the machine to check that Bitbucket starts at boot time as expected.

5. Use the following commands to manage the service:

   1. Disable the service (not to start at boot time):

      # Ubuntu and other Debian derivatives
      update-rc.d atlbitbucket disable
      
      # RHEL and derivatives
      chkconfig atlbitbucket off --level 0356

   2. Check that the service is set to start at boot time:

      # Ubuntu and other Debian derivatives
      ls /etc/rc*.d | grep atlbitbucket
      
      # RHEL and derivatives
      chkconfig --list | grep atlbitbucket

   3. Manually start and stop the service:

      service atlbitbucket start
      service atlbitbucket stop

   4. Check the status of Bitbucket:

      service atlbitbucket status

Using a systemd unit file

Thanks to Patrick Nelson for calling out this approach, which he set up for a Fedora system. It also works on other distributions that use systemd as the init system. This approach does not restart Bitbucket if it stops by itself.

1. Create the atlbitbucket.service file in your /etc/systemd/system/ directory with the following lines:

   [Unit]
   Description=Atlassian Bitbucket Server Service
   After=syslog.target network.target
    
   [Service]
   Type=forking
   User=atlbitbucket
   ExecStart=/opt/atlassian-bitbucket-X.Y.Z/bin/start-bitbucket.sh
   ExecStop=/opt/atlassian-bitbucket-X.Y.Z/bin/stop-bitbucket.sh
    
   [Install]
   WantedBy=multi-user.target

   
   The value for User should be adjusted to match the user that Bitbucket runs as. ExecStart and ExecStop should be adjusted to match the path to your <Bitbucket installation directory>.

2. Enable the service to start at boot time:

   systemctl enable atlbitbucket

3. Gracefully shutdown Bitbucket.

4. Restart the machine to check that Bitbucket starts at boot time as expected.

5. Use the following commands to manage the service:
   

   1. Disable the service (not to start at boot time):

      systemctl disable atlbitbucket

   2. Check that the service is set to start at boot time:
      

      systemctl is-enabled atlbitbucket

       

   3. Manually start and stop the service:
      

      systemctl start atlbitbucket
      systemctl stop atlbitbucket

   4. Check the status of Bitbucket:
      

      systemctl status atlbitbucket