# Phusion Passenger - https://www.phusionpassenger.com/ # Copyright (c) 2014 Phusion # # "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. require 'optparse' require 'net/http' require 'socket' PhusionPassenger.require_passenger_lib 'constants' PhusionPassenger.require_passenger_lib 'admin_tools/instance_registry' PhusionPassenger.require_passenger_lib 'config/command' PhusionPassenger.require_passenger_lib 'config/utils' PhusionPassenger.require_passenger_lib 'utils/json' module PhusionPassenger module Config class DetachProcessCommand < Command include PhusionPassenger::Config::Utils def run parse_options select_passenger_instance perform_detach end private def self.create_option_parser(options) OptionParser.new do |opts| nl = "\n" + ' ' * 37 opts.banner = "Usage: passenger-config detach-process [OPTIONS] \n" opts.separator "" opts.separator " Remove an application process from the #{PROGRAM_NAME} process pool, and" opts.separator " shut it down. Has a similar effect to killing the application process" opts.separator " directly with `kill `. But `kill` aborts any active requests, while" opts.separator " this command shuts down the process after active requests are finished." opts.separator "" opts.separator " If you want to force abort a process and its active requests, just use `kill`." opts.separator "" opts.separator "Options:" opts.on("--instance NAME", String, "The #{PROGRAM_NAME} instance to select") do |value| options[:instance] = value end opts.on("--ignore-nonexistant-pid", "Exit successfully even if the specified#{nl}" + "PID is not in the process pool.") do options[:ignore_nonexistant_pid] = true end opts.on("-h", "--help", "Show this help") do options[:help] = true end end end def help puts @parser end def parse_options super if @argv.empty? abort "Please pass a PID. " + "See --help for more information." elsif @argv.size == 1 @pid = @argv[0].to_i elsif @argv.size > 1 help abort end end def perform_detach request = Net::HTTP::Post.new("/pool/detach_process.json") request.basic_auth("admin", obtain_full_admin_password(@instance)) request.content_type = "application/json" request.body = PhusionPassenger::Utils::JSON.generate(:pid => @pid) response = @instance.http_request("agents.s/server_admin", request) if response.code.to_i / 100 == 2 body = PhusionPassenger::Utils::JSON.parse(response.body) if body['detached'] puts "Process #{@pid} detached." elsif @options[:ignore_nonexistant_pid] puts "Could not detach process #{@pid}." else abort "Could not detach process #{@pid}." end else STDERR.puts "*** An error occured while communicating with the #{PROGRAM_NAME} server:" STDERR.puts response.body abort end end end end # module Config end # module PhusionPassenger