Module: ForemanMaintain

Extended by:
Concerns::PrimaryChecks
Defined in:
lib/foreman_maintain.rb,
lib/foreman_maintain/cli.rb,
lib/foreman_maintain/check.rb,
lib/foreman_maintain/error.rb,
lib/foreman_maintain/param.rb,
lib/foreman_maintain/config.rb,
lib/foreman_maintain/runner.rb,
lib/foreman_maintain/context.rb,
lib/foreman_maintain/feature.rb,
lib/foreman_maintain/version.rb,
lib/foreman_maintain/cli/base.rb,
lib/foreman_maintain/core_ext.rb,
lib/foreman_maintain/detector.rb,
lib/foreman_maintain/reporter.rb,
lib/foreman_maintain/scenario.rb,
lib/foreman_maintain/procedure.rb,
lib/foreman_maintain/csv_parser.rb,
lib/foreman_maintain/executable.rb,
lib/foreman_maintain/utils/bash.rb,
lib/foreman_maintain/utils/backup.rb,
lib/foreman_maintain/yaml_storage.rb,
lib/foreman_maintain/upgrade_runner.rb,
lib/foreman_maintain/utils/response.rb,
lib/foreman_maintain/concerns/hammer.rb,
lib/foreman_maintain/concerns/logger.rb,
lib/foreman_maintain/package_manager.rb,
lib/foreman_maintain/concerns/finders.rb,
lib/foreman_maintain/dependency_graph.rb,
lib/foreman_maintain/runner/execution.rb,
lib/foreman_maintain/utils/disk/stats.rb,
lib/foreman_maintain/concerns/metadata.rb,
lib/foreman_maintain/concerns/reporter.rb,
lib/foreman_maintain/utils/disk/device.rb,
lib/foreman_maintain/cli/backup_command.rb,
lib/foreman_maintain/cli/health_command.rb,
lib/foreman_maintain/cli/content_command.rb,
lib/foreman_maintain/cli/restore_command.rb,
lib/foreman_maintain/cli/service_command.rb,
lib/foreman_maintain/cli/upgrade_command.rb,
lib/foreman_maintain/concerns/downstream.rb,
lib/foreman_maintain/utils/curl_response.rb,
lib/foreman_maintain/cli/advanced_command.rb,
lib/foreman_maintain/cli/packages_command.rb,
lib/foreman_maintain/utils/command_runner.rb,
lib/foreman_maintain/utils/disk/io_device.rb,
lib/foreman_maintain/utils/system_helpers.rb,
lib/foreman_maintain/reporter/cli_reporter.rb,
lib/foreman_maintain/utils/disk/nil_device.rb,
lib/foreman_maintain/concerns/base_database.rb,
lib/foreman_maintain/concerns/primary_checks.rb,
lib/foreman_maintain/concerns/system_helpers.rb,
lib/foreman_maintain/concerns/system_service.rb,
lib/foreman_maintain/runner/stored_execution.rb,
lib/foreman_maintain/concerns/directory_marker.rb,
lib/foreman_maintain/concerns/scenario_metadata.rb,
lib/foreman_maintain/cli/transform_clamp_options.rb,
lib/foreman_maintain/cli/maintenance_mode_command.rb,
lib/foreman_maintain/cli/advanced/procedure_command.rb,
lib/foreman_maintain/cli/advanced/procedure/run_command.rb,
lib/foreman_maintain/cli/advanced/prebuild_bash_completion.rb,
lib/foreman_maintain/cli/advanced/procedure/by_tag_command.rb,
lib/foreman_maintain/cli/advanced/procedure/abstract_by_tag_command.rb,
lib/foreman_maintain/cli/advanced/procedure/abstract_procedure_command.rb

Defined Under Namespace

Modules: Cli, Concerns, CoreExt, Error, PackageManager, Utils Classes: CSVParser, Check, Config, Context, DependencyGraph, Detector, Executable, Feature, HammerConfigurationError, Param, Procedure, Reporter, Runner, Scenario, UpgradeRunner, YamlStorage

Constant Summary collapse

LOGGER_LEVEL_MAPPING =
{
  'debug' => ::Logger::DEBUG,
  'info' => ::Logger::INFO,
  'warn' => ::Logger::WARN,
  'error' => ::Logger::ERROR,
  'fatal' => ::Logger::FATAL,
  'unknown' => ::Logger::UNKNOWN
}.freeze
VERSION =
'0.7.7'.freeze

Class Attribute Summary collapse

Class Method Summary collapse

Methods included from Concerns::PrimaryChecks

package_name, validate_downstream_packages

Class Attribute Details

.configObject

Returns the value of attribute config.



46
47
48
# File 'lib/foreman_maintain.rb', line 46

def config
  @config
end

.loggerObject

Returns the value of attribute logger.



46
47
48
# File 'lib/foreman_maintain.rb', line 46

def logger
  @logger
end

Class Method Details

.allowed_available_procedures(*args) ⇒ Object



124
125
126
127
# File 'lib/foreman_maintain.rb', line 124

def allowed_available_procedures(*args)
  procedures = detector.available_procedures(*args)
  procedures.select(&:advanced_run?)
end

.available_checks(*args) ⇒ Object



116
117
118
# File 'lib/foreman_maintain.rb', line 116

def available_checks(*args)
  detector.available_checks(*args)
end

.available_features(*args) ⇒ Object



108
109
110
# File 'lib/foreman_maintain.rb', line 108

def available_features(*args)
  detector.available_features(*args)
end

.available_procedures(*args) ⇒ Object



120
121
122
# File 'lib/foreman_maintain.rb', line 120

def available_procedures(*args)
  detector.available_procedures(*args)
end

.available_scenarios(*args) ⇒ Object



112
113
114
# File 'lib/foreman_maintain.rb', line 112

def available_scenarios(*args)
  detector.available_scenarios(*args)
end

.cacheObject



96
97
98
# File 'lib/foreman_maintain.rb', line 96

def cache
  ObjectCache.instance
end

.config_fileObject



82
83
84
# File 'lib/foreman_maintain.rb', line 82

def config_file
  config.config_file
end

.detectorObject



100
101
102
# File 'lib/foreman_maintain.rb', line 100

def detector
  @detector ||= Detector.new
end

.init_loggerObject



129
130
131
132
133
134
135
136
137
# File 'lib/foreman_maintain.rb', line 129

def init_logger
  # convert size in KB to Bytes
  log_fsize = config.log_file_size.to_i * 1024
  @logger = Logger.new(config.log_filename, 10, log_fsize).tap do |logger|
    logger.level = LOGGER_LEVEL_MAPPING[config.log_level] || Logger::DEBUG
    logger.datetime_format = '%Y-%m-%d %H:%M:%S%z '
  end
  pickup_log_messages
end

.load_definitionsObject



86
87
88
89
90
91
92
93
94
# File 'lib/foreman_maintain.rb', line 86

def load_definitions
  # we need to add the load paths first, in case there is crossreferencing
  # between the definitions directories
  $LOAD_PATH.concat(config.definitions_dirs)
  config.definitions_dirs.each do |definitions_dir|
    file_paths = File.expand_path(File.join(definitions_dir, '**', '*.rb'))
    Dir.glob(file_paths).each { |f| require f }
  end
end

.main_package_nameObject



178
179
180
# File 'lib/foreman_maintain.rb', line 178

def main_package_name
  'rubygem-foreman_maintain'
end

.package_managerObject



6
7
8
9
10
11
12
13
14
15
# File 'lib/foreman_maintain/package_manager.rb', line 6

def self.package_manager
  @package_manager ||= case (%w[dnf yum apt].find { |manager| !`command -v #{manager}`.empty? })
                       when 'dnf'
                         ForemanMaintain::PackageManager::Dnf.new
                       when 'yum'
                         ForemanMaintain::PackageManager::Yum.new
                       else
                         raise 'No supported package manager was found'
                       end
end

.perform_self_upgradeObject



164
165
166
167
168
169
170
171
172
173
174
175
176
# File 'lib/foreman_maintain.rb', line 164

def perform_self_upgrade
  package_name, command = pkg_and_cmd_name

  puts "Checking for new version of #{package_name}..."
  if ForemanMaintain.package_manager.update_available?(main_package_name)
    puts "\nUpdating #{package_name} package."
    ForemanMaintain.package_manager.update(main_package_name, :assumeyes => true)
    puts "\nThe #{package_name} package successfully updated."\
         "\nRe-run #{command} with required options!"
    exit 75
  end
  puts "Nothing to update, can't find new version of #{package_name}."
end

.pickup_log_messagesObject



139
140
141
142
143
# File 'lib/foreman_maintain.rb', line 139

def pickup_log_messages
  return if config.pre_setup_log_messages.empty?
  config.pre_setup_log_messages.each { |msg| logger.info msg }
  config.pre_setup_log_messages.clear
end

.pkg_and_cmd_nameObject



155
156
157
158
159
160
161
162
# File 'lib/foreman_maintain.rb', line 155

def pkg_and_cmd_name
  instance_feature = ForemanMaintain.available_features(:label => :instance).first
  if instance_feature.downstream
    return instance_feature.downstream.fm_pkg_and_cmd_name
  end

  [main_package_name, 'foreman-maintain']
end

.reporterObject



104
105
106
# File 'lib/foreman_maintain.rb', line 104

def reporter
  @reporter ||= ForemanMaintain::Reporter::CLIReporter.new
end

.set_home_environmentObject



67
68
69
# File 'lib/foreman_maintain.rb', line 67

def set_home_environment
  ENV['HOME'] ||= '/root'
end

.setup(options = {}) ⇒ Object



57
58
59
60
61
62
63
64
65
# File 'lib/foreman_maintain.rb', line 57

def setup(options = {})
  set_home_environment

  # using a queue, we can log the messages which are generated before initializing logger
  self.config = Config.new(options)
  load_definitions
  init_logger
  update_path
end

.storage(label = :default) ⇒ Object



145
146
147
148
149
# File 'lib/foreman_maintain.rb', line 145

def storage(label = :default)
  ForemanMaintain::YamlStorage.load(label)
rescue StandardError => e
  logger.error "Invalid Storage label i.e #{label}. Error - #{e.message}"
end

.update_pathObject

Appending PATH with expected paths needed for commands we run



72
73
74
75
76
77
78
79
80
# File 'lib/foreman_maintain.rb', line 72

def update_path
  paths = ['/sbin']
  existing_paths = ENV['PATH'].split(':')
  paths -= existing_paths
  if paths.any?
    paths = paths.join(':').chomp(':')
    ENV['PATH'] = "#{ENV['PATH']}:#{paths}"
  end
end

.upgrade_in_progressObject



151
152
153
# File 'lib/foreman_maintain.rb', line 151

def upgrade_in_progress
  storage[:upgrade_target_version]
end