From 8e4777a5ff0b3405a0d628ef5465d97683a0276d Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 8 Jul 2024 09:01:08 -0400 Subject: [PATCH 001/303] libvirt start --- salt/libvirt/configbad | 51 ++ salt/libvirt/configgood | 50 ++ salt/libvirt/configstock | 51 ++ salt/libvirt/configstockstock | 536 ++++++++++++++++++ salt/libvirt/defaults.yaml | 53 ++ salt/libvirt/etc/libvirtd.conf.jinja | 8 + salt/libvirt/init.sls | 80 +++ salt/libvirt/map.jinja | 7 + ...python-10.5.0-cp310-cp310-linux_x86_64.whl | Bin 0 -> 504724 bytes 9 files changed, 836 insertions(+) create mode 100644 salt/libvirt/configbad create mode 100644 salt/libvirt/configgood create mode 100644 salt/libvirt/configstock create mode 100644 salt/libvirt/configstockstock create mode 100644 salt/libvirt/defaults.yaml create mode 100644 salt/libvirt/etc/libvirtd.conf.jinja create mode 100644 salt/libvirt/init.sls create mode 100644 salt/libvirt/map.jinja create mode 100644 salt/libvirt/source-packages/libvirt-python/libvirt_python-10.5.0-cp310-cp310-linux_x86_64.whl diff --git a/salt/libvirt/configbad b/salt/libvirt/configbad new file mode 100644 index 000000000..0cf5f9ef5 --- /dev/null +++ b/salt/libvirt/configbad @@ -0,0 +1,51 @@ +listen_tls = 0 +listen_tcp = 0 +tls_port = "16514" +tcp_port = "16509" +listen_addr = "0.0.0.0" +unix_sock_group = "root" +unix_sock_ro_perms = "0777" +unix_sock_rw_perms = "0770" +unix_sock_admin_perms = "0700" +unix_sock_dir = "/run/libvirt" +auth_unix_ro = "none" +auth_unix_rw = "none" +auth_tcp = "none" +auth_tls = "none" +tcp_min_ssf = 112 +access_drivers = ["nop"] +key_file = "/etc/pki/libvirt/private/serverkey.pem" +cert_file = "/etc/pki/libvirt/servercert.pem" +ca_file = "/etc/pki/CA/cacert.pem" +crl_file = "/etc/pki/CA/crl.pem" +tls_no_sanity_certificate = 0 +tls_no_verify_certificate = 0 +tls_allowed_dn_list = ["DN1", "DN2"] +tls_priority = "NORMAL" +sasl_allowed_username_list = ["joe@EXAMPLE.COM", "fred@EXAMPLE.COM"] +max_clients = 5000 +max_queued_clients = 1000 +max_anonymous_clients = 20 +min_workers = 5 +max_workers = 20 +prio_workers = 5 +max_client_requests = 5 +admin_min_workers = 1 +admin_max_workers = 5 +admin_max_clients = 5 +admin_max_queued_clients = 5 +admin_max_client_requests = 5 +log_level = 3 +log_filters = "1:qemu 1:libvirt 4:object 4:json 4:event 1:util" +log_outputs = "3:syslog:libvirtd" +audit_level = 2 +audit_logging = 1 +host_uuid = "00000000-0000-0000-0000-000000000000" +host_uuid_source = "smbios" +keepalive_interval = 5 +keepalive_count = 5 +keepalive_required = 1 +admin_keepalive_required = 1 +admin_keepalive_interval = 5 +admin_keepalive_count = 5 +ovs_timeout = 5 diff --git a/salt/libvirt/configgood b/salt/libvirt/configgood new file mode 100644 index 000000000..72369709d --- /dev/null +++ b/salt/libvirt/configgood @@ -0,0 +1,50 @@ +#listen_tls = "0" +#listen_tcp = "0" +#tls_port = "16514" +#tcp_port = "16509" +#listen_addr = "0.0.0.0" +#unix_sock_group = "root" +#unix_sock_ro_perms = "0777" +#unix_sock_rw_perms = "0770" +#unix_sock_admin_perms = "0700" +#unix_sock_dir = "/run/libvirt" +#auth_unix_ro = "none" +#auth_unix_rw = "none" +#auth_tcp = "none" +#auth_tls = "none" +#access_drivers = "[ \"nop\" ]" +#key_file = "/etc/pki/libvirt/private/serverkey.pem" +#cert_file = "/etc/pki/libvirt/servercert.pem" +#ca_file = "/etc/pki/CA/cacert.pem" +#crl_file = "/etc/pki/CA/crl.pem" +#tls_no_sanity_certificate = "0" +#tls_no_verify_certificate = "0" +#tls_allowed_dn_list = "[\"DN1\", \"DN2\"]" +#tls_priority = "NORMAL" +#sasl_allowed_username_list = "[\"joe@example.com\", \"fred@example.com\"]" +#max_clients = "5000" +#max_queued_clients = "20" +#max_anonymous_clients = "20" +#min_workers = "5" +#max_workers = "20" +#prio_workers = "5" +#max_client_requests = "5" +#admin_min_workers = "1" +#admin_max_workers = "5" +#admin_max_clients = "5" +#admin_max_queued_clients = "5" +#admin_max_client_requests = "5" +#log_level = "3" +#log_filters = "\"1:qemu 1:libvirt 4:object 4:json 4:event 1:util\"" +#log_outputs = "\"3:syslog:libvirtd\"" +#audit_level = "1" +#audit_logging = "0" +#host_uuid = "00000000-0000-0000-0000-000000000000" +#host_uuid_source = "smbios" +#keepalive_interval = "5" +#keepalive_count = "5" +#keepalive_required = "0" +#admin_keepalive_required = "0" +#admin_keepalive_interval = "5" +#admin_keepalive_count = "5" +#ovs_timeout = "5" diff --git a/salt/libvirt/configstock b/salt/libvirt/configstock new file mode 100644 index 000000000..ac1174cfb --- /dev/null +++ b/salt/libvirt/configstock @@ -0,0 +1,51 @@ +#listen_tls = 0 +#listen_tcp = 1 +#tls_port = "16514" +#tcp_port = "16509" +#listen_addr = "192.168.0.1" +#unix_sock_group = "libvirt" +#unix_sock_ro_perms = "0777" +#unix_sock_rw_perms = "0770" +#unix_sock_admin_perms = "0700" +#unix_sock_dir = "/run/libvirt" +#auth_unix_ro = "polkit" +#auth_unix_rw = "polkit" +#auth_tcp = "sasl" +#auth_tls = "none" +#tcp_min_ssf = 112 +#access_drivers = [ "polkit" ] +#key_file = "/etc/pki/libvirt/private/serverkey.pem" +#cert_file = "/etc/pki/libvirt/servercert.pem" +#ca_file = "/etc/pki/CA/cacert.pem" +#crl_file = "/etc/pki/CA/crl.pem" +#tls_no_sanity_certificate = 1 +#tls_no_verify_certificate = 1 +#tls_allowed_dn_list = ["DN1", "DN2"] +#tls_priority="NORMAL" +#sasl_allowed_username_list = ["joe@EXAMPLE.COM", "fred@EXAMPLE.COM" ] +#max_clients = 5000 +#max_queued_clients = 1000 +#max_anonymous_clients = 20 +#min_workers = 5 +#max_workers = 20 +#prio_workers = 5 +#max_client_requests = 5 +#admin_min_workers = 1 +#admin_max_workers = 5 +#admin_max_clients = 5 +#admin_max_queued_clients = 5 +#admin_max_client_requests = 5 +#log_level = 3 +#log_filters="1:qemu 1:libvirt 4:object 4:json 4:event 1:util" +#log_outputs="3:syslog:libvirtd" +#audit_level = 2 +#audit_logging = 1 +#host_uuid = "00000000-0000-0000-0000-000000000000" +#host_uuid_source = "smbios" +#keepalive_interval = 5 +#keepalive_count = 5 +#keepalive_required = 1 +#admin_keepalive_required = 1 +#admin_keepalive_interval = 5 +#admin_keepalive_count = 5 +#ovs_timeout = 5 diff --git a/salt/libvirt/configstockstock b/salt/libvirt/configstockstock new file mode 100644 index 000000000..d8bb42b6b --- /dev/null +++ b/salt/libvirt/configstockstock @@ -0,0 +1,536 @@ +# Master libvirt daemon configuration file +# + +################################################################# +# +# Network connectivity controls +# + +# Flag listening for secure TLS connections on the public TCP/IP port. +# +# To enable listening sockets with the 'libvirtd' daemon it's also required to +# pass the '--listen' flag on the commandline of the daemon. +# This is not needed with 'virtproxyd'. +# +# This setting is not required or honoured if using systemd socket +# activation. +# +# It is necessary to setup a CA and issue server certificates before +# using this capability. +# +# This is enabled by default, uncomment this to disable it +#listen_tls = 0 + +# Listen for unencrypted TCP connections on the public TCP/IP port. +# +# To enable listening sockets with the 'libvirtd' daemon it's also required to +# pass the '--listen' flag on the commandline of the daemon. +# This is not needed with 'virtproxyd'. +# +# This setting is not required or honoured if using systemd socket +# activation. +# +# Using the TCP socket requires SASL authentication by default. Only +# SASL mechanisms which support data encryption are allowed. This is +# DIGEST_MD5 and GSSAPI (Kerberos5) +# +# This is disabled by default, uncomment this to enable it. +#listen_tcp = 1 + + + +# Override the port for accepting secure TLS connections +# This can be a port number, or service name +# +# This setting is not required or honoured if using systemd socket +# activation. +# +#tls_port = "16514" + +# Override the port for accepting insecure TCP connections +# This can be a port number, or service name +# +# This setting is not required or honoured if using systemd socket +# activation. +# +#tcp_port = "16509" + + +# Override the default configuration which binds to all network +# interfaces. This can be a numeric IPv4/6 address, or hostname +# +# This setting is not required or honoured if using systemd socket +# activation. +# +# If the libvirtd service is started in parallel with network +# startup (e.g. with systemd), binding to addresses other than +# the wildcards (0.0.0.0/::) might not be available yet. +# +#listen_addr = "192.168.0.1" + + +################################################################# +# +# UNIX socket access controls +# + +# Set the UNIX domain socket group ownership. This can be used to +# allow a 'trusted' set of users access to management capabilities +# without becoming root. +# +# This setting is not required or honoured if using systemd socket +# activation. +# +# This is restricted to 'root' by default. +#unix_sock_group = "libvirt" + +# Set the UNIX socket permissions for the R/O socket. This is used +# for monitoring VM status only +# +# This setting is not required or honoured if using systemd socket +# activation. +# +# Default allows any user. If setting group ownership, you may want to +# restrict this too. +#unix_sock_ro_perms = "0777" + +# Set the UNIX socket permissions for the R/W socket. This is used +# for full management of VMs +# +# This setting is not required or honoured if using systemd socket +# activation. +# +# Default allows only root. If PolicyKit is enabled on the socket, +# the default will change to allow everyone (eg, 0777) +# +# If not using PolicyKit and setting group ownership for access +# control, then you may want to relax this too. +#unix_sock_rw_perms = "0770" + +# Set the UNIX socket permissions for the admin interface socket. +# +# This setting is not required or honoured if using systemd socket +# activation. +# +# Default allows only owner (root), do not change it unless you are +# sure to whom you are exposing the access to. +#unix_sock_admin_perms = "0700" + +# Set the name of the directory in which sockets will be found/created. +# +# This setting is not required or honoured if using systemd socket +# activation. +# +#unix_sock_dir = "/run/libvirt" + + + +################################################################# +# +# Authentication. +# +# There are the following choices available: +# +# - none: do not perform auth checks. If you can connect to the +# socket you are allowed. This is suitable if there are +# restrictions on connecting to the socket (eg, UNIX +# socket permissions), or if there is a lower layer in +# the network providing auth (eg, TLS/x509 certificates) +# +# - sasl: use SASL infrastructure. The actual auth scheme is then +# controlled from /etc/sasl2/libvirt.conf. For the TCP +# socket only GSSAPI & DIGEST-MD5 mechanisms will be used. +# For non-TCP or TLS sockets, any scheme is allowed. +# +# - polkit: use PolicyKit to authenticate. This is only suitable +# for use on the UNIX sockets. The default policy will +# require a user to supply their own password to gain +# full read/write access (aka sudo like), while anyone +# is allowed read/only access. +# + +# Set an authentication scheme for UNIX read-only sockets +# +# By default socket permissions allow anyone to connect +# +# If libvirt was compiled without support for 'polkit', then +# no access control checks are done, but libvirt still only +# allows execution of APIs which don't change state. +# +# If libvirt was compiled with support for 'polkit', then +# the libvirt socket will perform a check with polkit after +# connections. The default policy still allows any local +# user access. +# +# To restrict monitoring of domains you may wish to either +# enable 'sasl' here, or change the polkit policy definition. +#auth_unix_ro = "polkit" + +# Set an authentication scheme for UNIX read-write sockets. +# +# If libvirt was compiled without support for 'polkit', then +# the systemd .socket files will use SocketMode=0600 by default +# thus only allowing root user to connect, and 'auth_unix_rw' +# will default to 'none'. +# +# If libvirt was compiled with support for 'polkit', then +# the systemd .socket files will use SocketMode=0666 which +# allows any user to connect and 'auth_unix_rw' will default +# to 'polkit'. If you disable use of 'polkit' here, then it +# is essential to change the systemd SocketMode parameter +# back to 0600, to avoid an insecure configuration. +# +#auth_unix_rw = "polkit" + +# Change the authentication scheme for TCP sockets. +# +# If you don't enable SASL, then all TCP traffic is cleartext. +# Don't do this outside of a dev/test scenario. For real world +# use, always enable SASL and use the GSSAPI or DIGEST-MD5 +# mechanism in /etc/sasl2/libvirt.conf +#auth_tcp = "sasl" + +# Change the authentication scheme for TLS sockets. +# +# TLS sockets already have encryption provided by the TLS +# layer, and limited authentication is done by certificates +# +# It is possible to make use of any SASL authentication +# mechanism as well, by using 'sasl' for this option +#auth_tls = "none" + +# Enforce a minimum SSF value for TCP sockets +# +# The default minimum is currently 56 (single-DES) which will +# be raised to 112 in the future. +# +# This option can be used to set values higher than 112 +#tcp_min_ssf = 112 + + +# Change the API access control scheme +# +# By default an authenticated user is allowed access +# to all APIs. Access drivers can place restrictions +# on this. By default the 'nop' driver is enabled, +# meaning no access control checks are done once a +# client has authenticated with libvirtd +# +#access_drivers = [ "polkit" ] + +################################################################# +# +# TLS x509 certificate configuration +# + +# Use of TLS requires that x509 certificates be issued. The default locations +# for the certificate files is as follows: +# +# /etc/pki/CA/cacert.pem - The CA master certificate +# /etc/pki/libvirt/servercert.pem - The server certificate signed by cacert.pem +# /etc/pki/libvirt/private/serverkey.pem - The server private key +# +# It is possible to override the default locations by altering the 'key_file', +# 'cert_file', and 'ca_file' values and uncommenting them below. +# +# NB, overriding the default of one location requires uncommenting and +# possibly additionally overriding the other settings. +# + +# Override the default server key file path +# +#key_file = "/etc/pki/libvirt/private/serverkey.pem" + +# Override the default server certificate file path +# +#cert_file = "/etc/pki/libvirt/servercert.pem" + +# Override the default CA certificate path +# +#ca_file = "/etc/pki/CA/cacert.pem" + +# Specify a certificate revocation list. +# +# Defaults to not using a CRL, uncomment to enable it +#crl_file = "/etc/pki/CA/crl.pem" + + + +################################################################# +# +# Authorization controls +# + + +# Flag to disable verification of our own server certificates +# +# When libvirtd starts it performs some sanity checks against +# its own certificates. +# +# Default is to always run sanity checks. Uncommenting this +# will disable sanity checks which is not a good idea +#tls_no_sanity_certificate = 1 + +# Flag to disable verification of client certificates +# +# Client certificate verification is the primary authentication mechanism. +# Any client which does not present a certificate signed by the CA +# will be rejected. +# +# Default is to always verify. Uncommenting this will disable +# verification. +#tls_no_verify_certificate = 1 + + +# An access control list of allowed x509 Distinguished Names +# This list may contain wildcards such as +# +# "C=GB,ST=London,L=London,O=Red Hat,CN=*" +# +# Any * matches any number of consecutive spaces, like a simplified glob(7). +# +# The format of the DN for a particular certificate can be queried +# using: +# +# virt-pki-query-dn clientcert.pem +# +# NB If this is an empty list, no client can connect, so comment out +# entirely rather than using empty list to disable these checks +# +# By default, no DN's are checked +#tls_allowed_dn_list = ["DN1", "DN2"] + + +# Override the compile time default TLS priority string. The +# default is usually "NORMAL" unless overridden at build time. +# Only set this is it is desired for libvirt to deviate from +# the global default settings. +# +#tls_priority="NORMAL" + + +# An access control list of allowed SASL usernames. The format for username +# depends on the SASL authentication mechanism. Kerberos usernames +# look like username@REALM +# +# This list may contain wildcards such as +# +# "*@EXAMPLE.COM" +# +# See the g_pattern_match function for the format of the wildcards. +# +# https://developer.gnome.org/glib/stable/glib-Glob-style-pattern-matching.html +# +# NB If this is an empty list, no client can connect, so comment out +# entirely rather than using empty list to disable these checks +# +# By default, no Username's are checked +#sasl_allowed_username_list = ["joe@EXAMPLE.COM", "fred@EXAMPLE.COM" ] + + +################################################################# +# +# Processing controls +# + +# The maximum number of concurrent client connections to allow +# over all sockets combined. +#max_clients = 5000 + +# The maximum length of queue of connections waiting to be +# accepted by the daemon. Note, that some protocols supporting +# retransmission may obey this so that a later reattempt at +# connection succeeds. +#max_queued_clients = 1000 + +# The maximum length of queue of accepted but not yet +# authenticated clients. The default value is 20. Set this to +# zero to turn this feature off. +#max_anonymous_clients = 20 + +# The minimum limit sets the number of workers to start up +# initially. If the number of active clients exceeds this, +# then more threads are spawned, up to max_workers limit. +# Typically you'd want max_workers to equal maximum number +# of clients allowed +#min_workers = 5 +#max_workers = 20 + + +# The number of priority workers. If all workers from above +# pool are stuck, some calls marked as high priority +# (notably domainDestroy) can be executed in this pool. +#prio_workers = 5 + +# Limit on concurrent requests from a single client +# connection. To avoid one client monopolizing the server +# this should be a small fraction of the global max_workers +# parameter. +# Setting this too low may cause keepalive timeouts. +#max_client_requests = 5 + +# Same processing controls, but this time for the admin interface. +# For description of each option, be so kind to scroll few lines +# upwards. + +#admin_min_workers = 1 +#admin_max_workers = 5 +#admin_max_clients = 5 +#admin_max_queued_clients = 5 +#admin_max_client_requests = 5 + +################################################################# +# +# Logging controls +# + +# Logging level: 4 errors, 3 warnings, 2 information, 1 debug +# basically 1 will log everything possible +# +# WARNING: USE OF THIS IS STRONGLY DISCOURAGED. +# +# WARNING: It outputs too much information to practically read. +# WARNING: The "log_filters" setting is recommended instead. +# +# WARNING: Journald applies rate limiting of messages and so libvirt +# WARNING: will limit "log_level" to only allow values 3 or 4 if +# WARNING: journald is the current output. +# +# WARNING: USE OF THIS IS STRONGLY DISCOURAGED. +#log_level = 3 + +# Logging filters: +# A filter allows to select a different logging level for a given category +# of logs. The format for a filter is: +# +# level:match +# +# where 'match' is a string which is matched against the category +# given in the VIR_LOG_INIT() at the top of each libvirt source +# file, e.g., "remote", "qemu", or "util.json". The 'match' in the +# filter matches using shell wildcard syntax (see 'man glob(7)'). +# The 'match' is always treated as a substring match. IOW a match +# string 'foo' is equivalent to '*foo*'. +# +# 'level' is the minimal level where matching messages should +# be logged: +# +# 1: DEBUG +# 2: INFO +# 3: WARNING +# 4: ERROR +# +# Multiple filters can be defined in a single @log_filters, they just need +# to be separated by spaces. Note that libvirt performs "first" match, i.e. +# if there are concurrent filters, the first one that matches will be applied, +# given the order in @log_filters. +# +# A typical need is to capture information from a hypervisor driver, +# public API entrypoints and some of the utility code. Some utility +# code is very verbose and is generally not desired. Taking the QEMU +# hypervisor as an example, a suitable filter string for debugging +# might be to turn off object, json & event logging, but enable the +# rest of the util code: +# +#log_filters="1:qemu 1:libvirt 4:object 4:json 4:event 1:util" + +# Logging outputs: +# An output is one of the places to save logging information +# The format for an output can be: +# level:stderr +# output goes to stderr +# level:syslog:name +# use syslog for the output and use the given name as the ident +# level:file:file_path +# output to a file, with the given filepath +# level:journald +# output to journald logging system +# In all cases 'level' is the minimal priority, acting as a filter +# 1: DEBUG +# 2: INFO +# 3: WARNING +# 4: ERROR +# +# Multiple outputs can be defined, they just need to be separated by spaces. +# e.g. to log all warnings and errors to syslog under the libvirtd ident: +#log_outputs="3:syslog:libvirtd" + + +################################################################## +# +# Auditing +# +# This setting allows usage of the auditing subsystem to be altered: +# +# audit_level == 0 -> disable all auditing +# audit_level == 1 -> enable auditing, only if enabled on host (default) +# audit_level == 2 -> enable auditing, and exit if disabled on host +# +#audit_level = 2 +# +# If set to 1, then audit messages will also be sent +# via libvirt logging infrastructure. Defaults to 0 +# +#audit_logging = 1 + +################################################################### +# UUID of the host: +# Host UUID is read from one of the sources specified in host_uuid_source. +# +# - 'smbios': fetch the UUID from 'dmidecode -s system-uuid' +# - 'machine-id': fetch the UUID from /etc/machine-id +# +# The host_uuid_source default is 'smbios'. If 'dmidecode' does not provide +# a valid UUID a temporary UUID will be generated. +# +# Another option is to specify host UUID in host_uuid. +# +# Keep the format of the example UUID below. UUID must not have all digits +# be the same. + +# NB This default all-zeros UUID will not work. Replace +# it with the output of the 'uuidgen' command and then +# uncomment this entry +#host_uuid = "00000000-0000-0000-0000-000000000000" +#host_uuid_source = "smbios" + +################################################################### +# Keepalive protocol: +# This allows libvirtd to detect broken client connections or even +# dead clients. A keepalive message is sent to a client after +# keepalive_interval seconds of inactivity to check if the client is +# still responding; keepalive_count is a maximum number of keepalive +# messages that are allowed to be sent to the client without getting +# any response before the connection is considered broken. In other +# words, the connection is automatically closed approximately after +# keepalive_interval * (keepalive_count + 1) seconds since the last +# message received from the client. If keepalive_interval is set to +# -1, libvirtd will never send keepalive requests; however clients +# can still send them and the daemon will send responses. When +# keepalive_count is set to 0, connections will be automatically +# closed after keepalive_interval seconds of inactivity without +# sending any keepalive messages. +# +#keepalive_interval = 5 +#keepalive_count = 5 + +# +# These configuration options are no longer used. There is no way to +# restrict such clients from connecting since they first need to +# connect in order to ask for keepalive. +# +#keepalive_required = 1 +#admin_keepalive_required = 1 + +# Keepalive settings for the admin interface +#admin_keepalive_interval = 5 +#admin_keepalive_count = 5 + +################################################################### +# Open vSwitch: +# This allows to specify a timeout for openvswitch calls made by +# libvirt. The ovs-vsctl utility is used for the configuration and +# its timeout option is set by default to 5 seconds to avoid +# potential infinite waits blocking libvirt. +# +#ovs_timeout = 5 diff --git a/salt/libvirt/defaults.yaml b/salt/libvirt/defaults.yaml new file mode 100644 index 000000000..1905b2e8f --- /dev/null +++ b/salt/libvirt/defaults.yaml @@ -0,0 +1,53 @@ +libvirt: + config: + listen_tls: 1 + listen_tcp: 0 + tls_port: "16514" + tcp_port: "16509" + listen_addr: "0.0.0.0" + unix_sock_group: "root" + unix_sock_ro_perms: "0777" + unix_sock_rw_perms: "0770" + unix_sock_admin_perms: "0700" + unix_sock_dir: "/run/libvirt" + auth_unix_ro: "none" + auth_unix_rw: "none" + auth_tcp: "none" + auth_tls: "none" + tcp_min_ssf: 112 + access_drivers: ["polkit"] + key_file: "/etc/pki/libvirt/private/serverkey.pem" + cert_file: "/etc/pki/libvirt/servercert.pem" + ca_file: "/etc/pki/CA/cacert.pem" + #crl_file: "/etc/pki/CA/crl.pem" + tls_no_sanity_certificate: 0 + tls_no_verify_certificate: 0 + tls_allowed_dn_list: ["DN1", "DN2"] + tls_priority: "NORMAL" + sasl_allowed_username_list: ["joe@EXAMPLE.COM", "fred@EXAMPLE.COM"] + max_clients: 5000 + max_queued_clients: 1000 + max_anonymous_clients: 20 + min_workers: 5 + max_workers: 20 + prio_workers: 5 + max_client_requests: 5 + admin_min_workers: 1 + admin_max_workers: 5 + admin_max_clients: 5 + admin_max_queued_clients: 5 + admin_max_client_requests: 5 + log_level: 3 + log_filters: "1:qemu 1:libvirt 4:object 4:json 4:event 1:util" + log_outputs: "3:syslog:libvirtd" + audit_level: 2 + audit_logging: 1 + #host_uuid: "00000000-0000-0000-0000-000000000000" + host_uuid_source: "smbios" + keepalive_interval: 5 + keepalive_count: 5 + keepalive_required: 1 + admin_keepalive_required: 1 + admin_keepalive_interval: 5 + admin_keepalive_count: 5 + ovs_timeout: 5 diff --git a/salt/libvirt/etc/libvirtd.conf.jinja b/salt/libvirt/etc/libvirtd.conf.jinja new file mode 100644 index 000000000..12406e1d2 --- /dev/null +++ b/salt/libvirt/etc/libvirtd.conf.jinja @@ -0,0 +1,8 @@ +{# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. -#} + +{%- for k, v in LIBVIRTMERGED.config.items() %} +{{ k }} = {{ v | json }} +{%- endfor %} diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls new file mode 100644 index 000000000..4b1fd6969 --- /dev/null +++ b/salt/libvirt/init.sls @@ -0,0 +1,80 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +{% from 'libvirt/map.jinja' import LIBVIRTMERGED %} + +install_libvirt: + pkg.installed: + - name: libvirt + +libvirt_config: + file.managed: + - name: /etc/libvirt/libvirtd.conf + - source: salt://libvirt/etc/libvirtd.conf.jinja + - template: jinja + - defaults: + LIBVIRTMERGED: {{ LIBVIRTMERGED }} + +libvirt_service: + service.running: + - name: libvirtd + +libvirt_conf_dir: + file.directory: + - name: /opt/so/conf/libvirt + - user: 939 + - group: 939 + - makedirs: True + +libvirt_source-packages_dir: + file.directory: + - name: /opt/so/conf/libvirt/source-packages + +libvirt_python_wheel: + file.recurse: + - name: /opt/so/conf/libvirt/source-packages/libvirt-python + - source: salt://libvirt/source-packages/libvirt-python + - clean: True + +libvirt_python_module: + cmd.run: + - name: /opt/saltstack/salt/bin/python3.10 -m pip install --no-index --find-links=/opt/so/conf/libvirt/source-packages/libvirt-python libvirt-python + - onchanges: + - file: libvirt_python_wheel + +# places cacert, clientcert, clientkey, servercert and serverkey +# /etc/pki/CA/cacert.pem +# /etc/pki/libvirt/clientcert.pem and /etc/pki/libvirt/servercert.pem +# /etc/pki/libvirt/private/clientkey.pem and /etc/pki/libvirt/private/serverkey.pem +libvirt_keys: + virt.keys: + - name: libvirt_keys + +install_qemu: + pkg.installed: + - name: qemu-kvm + +install_libguestfs: + pkg.installed: + - name: libguestfs + +# required for the network states below +install_NetworkManager-updown: + pkg.installed: + - name: NetworkManager-initscripts-updown + +ens18: + network.managed: + - enabled: True + - type: eth + - bridge: virbr0 + +virbr0: + network.managed: + - enabled: True + - type: bridge + - proto: dhcp + - require: + - network: ens18 diff --git a/salt/libvirt/map.jinja b/salt/libvirt/map.jinja new file mode 100644 index 000000000..eebb50062 --- /dev/null +++ b/salt/libvirt/map.jinja @@ -0,0 +1,7 @@ +{# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. #} + +{% import_yaml 'libvirt/defaults.yaml' as LIBVIRTDEFAULTS %} +{% set LIBVIRTMERGED = salt['pillar.get']('libvirt', LIBVIRTDEFAULTS.libvirt, merge=True) %} diff --git a/salt/libvirt/source-packages/libvirt-python/libvirt_python-10.5.0-cp310-cp310-linux_x86_64.whl b/salt/libvirt/source-packages/libvirt-python/libvirt_python-10.5.0-cp310-cp310-linux_x86_64.whl new file mode 100644 index 0000000000000000000000000000000000000000..5687a286251694c55897d2ee093e07f873c79f45 GIT binary patch literal 504724 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⁢M>PQ9a*r!u z(uKR;w}QrXnE2JpbO|o`san=Uhzter%jo2sZ!+r|tXb=kp9)Yg5=2lK4ae1bd`Mo7 z+$yuMVg={BEUooeD2AlmuI7)qTD(!b2xd--AcYP!^5a%@Ptz1_CfQ3 z%bRX`EDU2Q?@4Vtq!clcA!%B>LQa(j`)r zY(pghpkzi)o-FI)As7TZ>5Ob~D7|2CqgxePK}?+oTqsst2jfq^>)6H<6LahngRHf1>g5>ptdx$EL*-}Dp- zZ&%O-F;ymN1)pIN78*38+5Bu?myw~Xbpd6(MKdLa;7}ghYN%Kg+8HT(UryQ)mCzI~ z6{Z4!3}?o<6YeuInSbk zJ)0`aPfByc5{{&^$g446}kk`Xw~90ME+QrP7+a;B9u^7d#uE)W#Xpv9Iv@LaT4ENQ?{`OSd!1_JB4$THIWI=JjQV}r?S$_n|0^$4*P;k z>ooj)t+XO(^{P=PkdngBP|i`@9WXXztz#sK)nVxhpUZBd^;~p!Og!A-}l=UsEMGB%8A?ZZxZ7}1ha`+?suLPFL%#?oCBf{%M9!|V zL!nfZT8UG{+&1Ki-Wj{KOI4<5&NAs$#|We3uEtgveT}p?#FQr{TZ}Vzcc5u(k71|` z``6|wTS6QVU<4PgWnc0FHl>x+Xu(~aP4S9u2p+kDZiz*Y+yWZWXbxq9(ZtuPdqGKd z&3Pa)Wi|#yW%`b!3wPibbTR=y$Xb9lrq)`_K*f_xqqI(-3ht*Q3Cb?(@EH;cq&A3_v}4PgNn>38Eee`L=q zDU?yD^cyOK-TW$A2Dy$-%Ie8pP#PO9@^}R=x-4l?l|XFmSEHezW}sSqt{r8L(zQhK z)C%XGmaMRMf-b}5>TiGHxg4o0bOKN~X~eDCMbQtkhLJQBap?Yo2xQetFp^r9g1cRZ zg}3sRNHBL#Mm%_Po_o2N`HTieBoV6dr*b4lFt;(wP$yN%%@azlr0>muFv^c~5u!^|Ea|1ci(*%Tn&yfvOd(CR11Cs zW4^J0cX2X?SZUEhf-Ah?8b(SWh-}OQSHDuE1J3Iyr08o>HusGsW&@VJsx<8$<~DR< z5YwG40f%f(8Vand%t?R+^;ocj4Rt+^9;@kE!;P+R9_Wr2=7_7a4Y#)~iAGL(%8SRy z7&C}2FYM&$e&_xP0a530maCR1OQdd%eAvt=Oj79EJ)z?Mcm#eb<(NLJrP^2>cUsZU zj;G)(2dCOeh$ReRP@I%g)u?ue4vl2!8A!-w;m^YAbMH&KoCOS>EX+ zUg^Qc)Z4MT3D4q%!HqXjB`>+GO=8!@LD(RC{n&q6y9{3UOtCz4-Mr8;dfh-ow>LQL z9S-rD=Ygi-NL~9S!GlVjPw*A@G_gmD%ko*CZ~RqYlvHzkJxKNg29eFM=>*Z$XG`QJ`BO7zD=du0|Tl<6g`q?66{W5<7HYlY+*w`mumZC$gpR?Tkv+Hv$=#x8F9v zoF#P+E;D?4U&BY;UK)|P=*Sz7mibEaqoJTR;q7koIYG4vSlVNAl9-fHAXJt@ti zI~R84S(f9s**LMX&JLvVsJ_&u4*_rxUL(8`-q*n^K=L@JMhbhS50odZQpp?y6W28 zaa|Cfl8e=NjYu!YM-`uI1t>W|hj7xvz6`}R6(6M7ur<=#rohlvQs^kpYQk10zU}sc zcP^pTyoNeQ}fGOJ$D}zS#HwY%7q( z+}Z&;qeA`(nI4_xoM9+LMul+_6K1QX0NtNMUAN ztYJ1bK-4Mz2mew? zXvWxKiH^?>K(NYb*B&ch%b6^J!w|)$uDaS;zBF~PI9?_X{`k;e_P1049Ur2`s#q6~ z>i#})S`QDkwDhkTt`s!pDgDcGxVQGNBrbk#6YA0`-6rI9<^!ax+PRq}r9Ap_a^lBZ z-r8kaC{<8g)-K^2Wi+RZY9+(2in{t|+9IiVBGK9epq1!jYk_C4juy61TD3CrOQ5|? zjn!{NP)7vYDQ)VXWs6j?POOlH=Vn^p>%#1o6hGhSUE^~@)vrVftu(+^q|i(SJgZqw zH#(qi^e={wW^#Uw`qNMwd>IUFLoKVH=8GdtZ7m9?ReU`U@rz~oeTSxVFG$-okmg_B z1QmrT$f~olHol_1JO1vRGUcdo+-!b3iAPxfKri0IcYlSnnKF~y!vs{hlIc7zyshVO z!Y4>Ig~x$+A3y?6NJWTw5FN6Qd$0yzld>bbYT!)RH_wh5CvmQ}Wi8R>tKMyz6}sOr zToG?E96iM}#xxsK|M?^>lq@3W)mcK|YsOHry5?877swjIUK-eHQEUv;vbe%%DOn1- zWehI|{od)#+4x0&`gd*utzw020DlLg6~(KGTQK2^xS0{qaAel8FJ`&J3KE{ zgcm(k&XD?;LJw-p8!NO~JXI7+p;_MbDJ9F8!fj5HB#W|UtWO_$x#!yy#J1mo_cqb|r1eA`CczY0R&ERe1O7 zs@>zgvF5rt-WzEuCr0WKAiZ6zQbb-U7PqC6_$PQF3_{^@D7f}v@$0W=Jl6AblED9G zNnOu6!YdX%hnH=THP-x`L?oBIy&K)YnSQHruBJFc3+J!DUYvc6$ge^RX`lkIP6@)D zbPIIRk((@;PtWgGMvXfK&TL^b9iKxbM%_?`#O{N6YCizY8i_%01)Tmj-8 z4c}c62KGgznXV-cYoT=vxc2E5r3Rg6lSe_UfuN zNvN&}Pg@09Cu(gS=r)Q-+X%v2k4vjl;%E)c!r*J*EQ8|fJB^x_C2!RPZ=rD2J+@z> z+m~v8h*}||be`A(B{~5N`nzVaE^ey>@omdC(-7Pg7+*BH$j{1PSQV$=9NCrOUoPs9 zklXgU-ROed&dvJ8uGDqzQiflr_vh9w&TZeA&lJb+1@5xEfI3#g_HxEXQpT3Vi|xu47(wraUVT!)$EZ-+s)gEUo@MHi!iLr|OQ0qERwW6n2fl6O z2sDw())U7z7RI(Hg>7H_s$+!w`3I=Tm)v_S=}pX~Zqig|fndztWF#2XH#CEQ3yUk3 zY9maT=jkXW3qP%gEpDxTq z`$ikpbC`{(KRgu80=d{cU`9g1G6QhKVbR$T>Me@gFgr7(mE@xCJFizaD`w!VpkEeL zV8&BVImE+u(j^9Ych|3sNPJ+V);A2v4(X&k*Go`Kjfd@3+!R}5CVKOo5K6uKtrOa4 z>~-VkH>HE-G3DQ=q6t-OF__#x)mF)5qYzRJ-VGy3UmL2o<+=3@-#KzO4JR$p#ai*C zZRnz5&|(R8UB{LBhW~P?X{sS^6kD2zL$g`3;j2BsTZ?V2pXbXHjoUHJ#18RuYAl_ecb4VWY_$OrH>Ad~|-=J3hM^_OAOk zAO3#P8xC&{dxxL;?B!(oL?D}?*qnpKG!__t42!`1m_DMT2faXx1^v{XjKu~5XETu^ z3NWgTQ|Jt$JBH95K;!<%)-8q3a571sgGrR<61aH|^){iwR(Ua089tn-kuwEL1u6AD zEQ(21oSoIP4m&2MrcLWT}lLEp2KQqR;b4rVn91uzx2sd$2pu& z3R9v6n{41*c3nd}8VeYujKaay+1c^g&oFxVtBc;%uzwW9_IxlsP+9t?D9fO~F&7(x zMFe1Zv-x$fS8UA_feG)~QZ)?&bUmFz@H2LcRWz0>)U8K}gZ{98d2@C>=$$SjM0F}g zVK!C(T$nV$0N*0S5McMQ{(d-tey02-Z%L32zO1&T2pf8HwB-IJ70fW-%{}w}yK2kT zmY5i^YoKi&4S#fVk+g)aSO@on7E9?0wmiwp1wH^oj^R=&8_0-7j_chj2<`c7jEO&{ zI9ROPd0CjlzOZj^D4CYDu)~3Vk7q@v=!A51bjpJ0j#0h+tw}a>zhXl59RB+2zwxzi z#`0hPO|N}>_#GW5r7k>4qkWY6ZiR(qKK~YQeD1Qq!AsKaT)+K#0GRJf^@i z$l}wihsBt&q9G7SHNk=+2_a!-s4}S^pZ0$4-zebR4Eu*ygMMp5Dj`Tv(&o0``l((n z4u(E$-s?(9mOyGc!VLtL2&zcR*4V4}!W=ei*q8OSaM2N0R3{`E!q{-lYH1^5|MhN)ZGjb-$|H zkpQChY>C5&$2r>7#QG3bYE6DK8-@04Vr1h5Z(?E_dT69ePkVX%6^X9+^vhYt34m+a z#x?A_vxyJ=i|NK9?iu_`p`r=X+N{b#YuuQ@u5w-LR?SJ>nYkP1Q#hGN6cL0sF?Y{Y zZ@>1#y>07x?JOM=n1?!Yb+u~3fZw6tEB|_Y)E$lBfMzfy-s&j;PV*%G=bTa=b@S#3 z6%>vlRrn9J{mvp61b(w*BCc0|OH{#5G*pFrhvbBFeQ8$Z>)@rZd_0blLP@qwY&_>a z)hp%!oL=2!4VhA9OjqHi@wCIz`Z~4!c;;xT9!143Q8cq%zV;}M;t3j#VMdS(w;@(T zRH7FKjyC&F59=Z9Fw2GfRv@r&|Ep;@-WY7HiqKrye%5we+7Rw zV^#)(g`mkm4F^5dv?eGigX+mxPzWo{Uw#U{--G>lR;d*+?f_1M(2~@qzuzm(W5(3) zl>}vM_|_0DK;Wt9Qmp|3f_`z)=b^$B~v%i3+BS)Hfdyo3P?I1#t|yZ^)`Wt38Q*C(OnB=e{RJz;9cRdKqd@l zWj2dKdne)bMgI9QB-Ex0?vuzp8>wM=juvTk!3xWtBYfKJZzO?=e4x$b&^mN<9lGhA zXjPFe^GaK##=hCyShu_+tP62pJy`Ly8Mb{r*jG#-TeNBUCV2tkXcXH^*^QwKQdgTL zg%w`?+Hkt1NZz^`UJ$33VRj!C7h&;WuJGca0cNT6(lnf*)ElCAG#^i<{p6JXxoU9`Lo0NdNILnK#j!)EJfF&7)gpMgo z%=3cuwbZt~nrGZk(p%K-n0drsoxHFuyL!zGFO1sNHuC>&INpk-d+AhLM)|d!^p{AR z93P{FAI;pWk1hob>!)-wpSo&@dAE#xHS#j_Uw4CjUQq}5_kaiS4iM@9=cVBr;rhA* zR5y|cS|b}A`he>lPy=^0%3*@973bTzx62c30qx!RBIfxlO2!}4>}Z~$7lBtmGT>e? z=8tQX$({{K=b@~5Xh+uN-7N){>v4nh&Ws1qNP%{R*=P|AN7@Fa&^3`Vdu@Aram@*FO5U0S1bBf|Ebt?#0B-ITnAFjR_UqQPArtC?PXqL1)D z>AnMDjsZ*%tZ90##>rDSiJbx_N_T^m04Enk^$5~dH-kW60W!}9=?$9Pm-U5}R=z*@ zuY>OaRQ!ByhvuU`i?aR7X6#}injO+d#&d$aebKj!pqDF71ecqo4cVuFa##%7DmXfj z1SHM|^~SwJ2mk1i3bMetSEEuX!DcRn%2{yA6#3kq{NfGfQ1<) z4q>55IES<-8Jfp3Zg~--k~CFposinG>O7Y z#OBisllnKDC%xXMBm35oI@07xw6_JW*^Cl>9s#<0I*Jg%<}My`#{MAh5*|u3%Bqy( zUDhFZ6|2;%2m1-f`GWv)1Z-UbS-8I5zAKYIJmtLoIWG9+J=o<qtQmkvxYLf?rC)zm0Bxcb-->HHlcD@x8DMqRaR04DAjI6H1-Kw$+gl ztFDo%%#2IjxBf{zGFGcITB51J5{lXj(pji9G4;`F8o4d`n* zZ8fH=frqLrk5s3821!px9vCpaDDb=sY=XgCikT?hf#RdSjS4j?{^6&eBc373HIAXD z6-F0;AeCwELu_SKIl46I#@gjA>)q=4 zHaMO>z@Nl-(P*Kh0lnt72!OMF6c!;aFe{5?+ZSAsP}EoggSeddL{4xrL**9GeFIr8F_FwL_O z*jwKP2*Ppn)SJX%&VOzj;K%2z^1cdyGbk(+I>Nyq3iCAS5EB^=_zf*m&LEhqeKBU? z>>(cIE0HvNQ2H=K9<4)4O~~E>$N??Ww1~t9;kewv(bsRhk9|;=CK{sQU zmsz-Ih^m)GL}3>8IuOwnz%NdJ4IiWVY$dq24By%G8Q1YTpt~td+0FaqfvO_`{tck| z0qWf;X}1}7P=ee%+@cZZmR9qslx5oU##D>fVj z$l*Pv0oRz)9az7hK>_yP4Wm$+>?>juA*|+g5cH-@;xxXez`NrjqF+`*Io3~Zjhd%= zQFgA^0d2FKb-@h=6OPGTP0pGzyMWyW!2glnnpn~Cmj?1?JX#1A;p8Jaq+bo+$Y@pU zCx0Czy)grciV$iaHdI8W!UmY+^DN#P%%{AtSEZ9o$-aj>-^lWM`H)5VLpo_h+zjKH zHQN>Xbw&jk7V`$?*fnv1HduWM%-pX7C2CcBoE&OarUA14p@8}hTpXo=@;HiTv5mNJ zd{7u>zrCB53T51J8JAaq5CabD7DOOyh77tFhVj3mrX~|{BjoC}ZR3DX2Tb*)U1R*6-S}3b@Z4EF0iJ}P`dHTEqu=Zj zEfKBnapEr7OC!$`2;RYDAbR+vLeF#;urCyQ#=DhgO|597;4=yBW+Isd`3uNo8sJ}4 zDD!}QJ*g}a!0v#_@w!@bIStg-Y;IjHceZrjTVr$e)2`xk5>Z_~XX2oEc~~4^tr9L@K4=^*Uq>?4aQSjy@1Rw@yrdL`Lh5jyLp^Zb=UYFB-?eFf|j`ofp5T-Tb&12~Sj8St?UQ z^%;`z#2YUqSj!SP5~g2B(5|Ua1FPFe+Aib5pYKtJiI)KQ7fAzI4(`?P%}ZeIK(^*3 z1u$l70oy6)^kPzWnYdn1(q2CGDrvinzOE(i^7vKpflizwKggrki4d`rqN<`q-2v@X z2(O2{SE#6e{3Rp{T?n|9Xi=ujt;-jUCWNhQN6J_>eVwSWGMX-o_0FJ{Gq!bfB_e+9CJ-M?dCik>#J>$zB{Ni6l^-~~YaMWl>nfNo&Ba{=0g`3_)1 zL$){JS-8HS8E+K`wr9y(HuFkjp8Im=_B?lZk8J`@nQPLs$E_Qy-V#dkSoZv9vRmt3 z9nAd(zPhJh#9$FUwYTvt$9eZ=z6SHDeQe3nS3h~Jv9I>Xtz*Ezo>ohR3F_;`Iy3(M zVulOqDE6i76qR;gw4Tk36c*lovB3-NEdce)*dppd+Q1NDLDz*1g22$)`arL}oZVsB zrnhHusGD`AwZXpFxuL-hT@?fLsd23gbbPuoF!;&EV_LA?M)d*c)TrPCu-~5Gd-5gj zd_E$rjS2Pm?cR>CVlLXkmW&AgxohnQ-V@dQrk|)8dXot`NOW~C8^5Rq`5x*1L_O#D z_MB4y-(pc#@|@({jT@$e(*ctJC3A=ul@xWTc?mL3sw<=x=^HiBc~d)qhV+}=Ka?T& zTV2TAtjMS&HT@1X#{dNtFbfM&6IeTT(9%U!hOMWOK}!f%7Pl2JJF~2S^%CENfjIwB z3v%|AHvzYa_E-UG9mBI0l%4f#1;S>A70~rZv>CwC@3n9}hAOOg;V5bXS@ZBp*v9(F z^`Ki?)mGpu=2!t?^Q44v3?CRM>%VH@OsZTX@)eei6;Q@n`qGZI9x0m%w@J-nl2rs< zXJoYO8Go-wLjIOs+YAHFa<_^IGgCu+@bep@g~ZQB!U?NStK<^d_Pwn{A{Mh9VT31G zC5P15B`jp^-&M#O;|^9jFWGapR;~^UiW}v!dvi_m4DorQO$1c{tTMyUE?gs2LmIkT zGObf-eqBwiZUSFT<@%+pXK(PqWe-}DJjK+w9E=0;9rvlQo5Fs)p=_G~Yt4i2XvEy5 zllArdC3qPu!%BC0w11igooWDGBi(HG*SL64?A6F$+}oFvE$-l(cf=AEqJH->OrbQp zI&(Nrux%E!X1-1|hiPp`bEvlO~ zi4GJtBD+P|{Z_PFqIRLO9Wh%cb`LB+dyhEelLIVA0X@q?G`zuA2KLZvhPv%=QyVkH zG=zRbPl~S4bjR>|3!8om10xjKj)!>09@{v&83S61z&fJOvy_{ena4#Jon$_})!ldy z7G?nKQ}Q3dP8kCjN9nIZHCk8 z?LuQ4b?OTRIS`_dG~vX}!%6%vm%S9x=pjib>HR`Lm>UdT9}jMh&QE*CXE(#k-r(}) zqIWgyAK{6C`b9{5~3g& zDV!y0{R%*uqUJdO$&l0lTXi+qMepkJ{HQ;?9Gw5XW-FE+xsWn%C7c)PgCZW`It<~{ zserdFFS{u0dAI#|6m{dPSu}}4-gC^rz#c~raLy7wMHUVd$kTP(7-eA&lEilbUIGYM zaYYa@ngN*Oj)QTi?&;(JgcM`=n}*pVQxR-X?+aIDMxfO4kh;C8GgsK^A&PB;PZ9KC zgY$u0AWyZVA9yhA_tE;VO|&%0>DT|4LUE`3!yVz#<5<9%c;mBS)5aynG) zvDZ$$+S3~2y{+%j%4#Bfn#`m3YSlsp(vw>=soVw^13*h@Cg?KLu)T{1BNaqSNoff z)K?MB6orbfDS0J}qjBkY>S6hL&H3Enz&kRQ%jc(Xx#FaNMy9TnIrhoY3#A!KLtyi8 zyEgMQ?bV*$G=aMep$Hi-#lG&j1)UAi%_NqBWAeoV_q#fZ>bd(YozE;R@q!?kA*Ang zx5SYncknoNW!Mc#pxQwPjYLQxmzHL+FbLsO?B2Aov(8kdt%uoS|9k*5!^LM04N^XI zQ({=!OHRycE@U&}PB>BO(fs}aB^5=h>Rwiqs5od0Rdl9`D>COo99V&8_nqCPdjVVy z@&EmI0V%$k$5WR{a)N-GM589`353pN_U460{WS3yEod*;bS*~ORX2t>q4YBT|4p#Z z(=w*6PxqYj0L(ylGqZ4v5VqwJY1J^KZ~b)MO{K8v6cu-}`7v|o8lL|4{qGP}2EYCJcQQD_A5~K$kpUcYHMJBF z)fd`O;U?&AOL7dnq9b=}ri1-WOw%hes~^C49f~2I*|sErj3!~8mlD0mQprf5=F4CcH_ey9V8nC4js&&{B=9}>BGo?< z2tYkM@Ye3Z%?;dLH#bBEY6ovF7Kh<1pHHGUdjb4$j%#@HyANEZbMwxd{%3Wju|IwA zoB=+^!C^q}qNVv>jsK_oP4Fi%yRTI>d?A}ni*DfWON8RgExJ*`ln!zZ%2E!y zrogGyT8G_+@Wgc#(D1fy{045$Hjt*cf--=?zK`w`53Te+Lof6KA!VK;2T3Int|bh6 z&a|6(@@od}7982W|MTRsBrwQ(SWT$8g9It+U0?+9N(xXGYV15Erd zE?_k9`h()4{zRw=Ke>_+;`@Z0*P-L)wGjp8m!k-TD!f{fQvAUlX*n=@oIItIr${3b z4qiS7mTu+Jd7|U~!o(Epr5)#X2lV-#i4hb8C~TnW1kR_^(kQII-n-&C^|+TADA-)L=|_e_sv!#)Eox zwey<_)8;6Hj0fQetj_@1X<~@f4K)Uuu&RSP44%=?6D(&g#|IJ2Ax=doNS=F^iWP?U z!vce$Z%XbnN52r-Y-Y$basmYznS6j@*-{-=W?RhiI|!V>xSA zJ2!(i-ui_JCTzR?2Q;IJU_?dMck%r^b3^EezNb-`Ko}NLc3xm+@Mlc2yaVMsf0z^Z z7^lxkD=3yW&>bYjz%QbGf~gE_Jsv!uC9eekx8M(*g}3n}F5)O}0kac1kq=($Y3pX# zmsK{wVCDhY|DNZCo>trl=o)IJouBFP9Z2~OQ!<~P-_>BShl&+stfb`brodM)fIC>M znD5(L6waJwbafu=s0~@mEX@2&r2-0iQu_iJQLS)vVdq+jrA*7O)s+pj7yx`NQ-i1T z93xptG;p||6c4P#=jhk^RumFV5Z-TD+Vja_dqM_`*%{`Q>T>RGdbnjxhJqllr_RE!{@ySSSn&T;K&sqMpSE zL(qc&uq!FKZdA~^f;^gr3A(AqNMw1H#1P-5B3{^uMybb+ptu+Oa(&7H*%a&yYoU3p zTnZuEg`mpdqxJ-zL{HHqK)CEdiIFrJhuI?dFwg1308ObEDTtt_VG`b>qspF=eRAF6 zg!QyX>!DTN-GMoRWMQ*96iL9rT&7JM@>5h2O4^gAri$+95=LxDlzG{(yl3s!E}0&( z+!j?tJTh{)as4{Kz(n<<;c=>{TFHslfRd)*VQ?5c4|=Q6K83^-9jMR-s6&srTyCrj zFb`W=&M763Oxeqf-dFrgLt}8QmDh~9%G%qVmG??+uVYiY8G8k&jYpP~SHF2#o<;;&KPq1NTcd^6ZFPrL5#klNKK(06M4B9PZ2#)iZoOdU`&``=cja{m@clr z%|#_BWu?Ih*9lSEO9)G2MbnYaQ_o2c)#$x^u%Z6;$RUfv{C7hS5HDYZi7r-vt{LsW z;=`d=WyXPsWHu`u1gBtxz>#xp%L>P1oyQNAUhUI?NXMbLU&tW9atY-2%C(gh>5ia|SnOwwnH=53251NfzQ+VFOI5?9mGs~%B+__Dlnz1!*M z%I(zQz24|zvJtYne%3dQth4x72I*I>lj&_Vh>hhZUs5k~tEn|GhwvJ^)X>UfzJ!ie zsv_4)S1YZzLv77Ja!X(0aw;;O#An+28amqrrv-cJ7^ zM#2)N@S+ggG$lHAc3WX?8$sLE(HoL-jsI3lMzi^?5&~?Rpa(21cHZ2XyF^)X?6{hi zge4bzULd)mxD4DrpN~cn$Y4UUl{uei=*6JOk(O{R_4qU|JB*bg#75ibUizI5wXe#M zZ3PKk`0<-O(X~9mko`9iD|k1}r3-%H+x1Y-2N*=#y(OxXG>*^(J5{X#3!&mx#a)wy z@(Lv<#c_HU$L38LXLqmqGiSWo` zyPF%y9k(IP5me5Wizy7cWnzkka{H6`(Otnx*#(e#6g@4IssQcKt86<9z7PwjU9I)! z7K%cq-){R?ch3@H8n{&Pxm7+1e5ibz=G!O&lEkErClYPU>$doM@IM0c ztIn}O9HCqiLAhXF0R@;^K<7%P2^Ie+BCb4a6m%#hu7|;;t9^_YW*+rS3xs zuMukE<@jv7RxCk6<(u*Uo89hT+whSA!{IV6HrJ06{RHi%JgIKg_dO>iq%`R*cj8<(g z1hUIJ6W3b@jW22@^0y-yJ@qEKsU9^S$ZElQyC|SkIs%s3Tr7nv%7ddQe$rY*0Rh#> zg$bm4M#`qDWOPGHE0Zl7Mz6)mqitM}Lmj>abum$!rE2z|Q7a`uO=@{f>fU6OnxU?Z zobHBk8fbRDfBfCKsEgKvWDiJ!z$ktV9~&q>Nz=z%A>c6*CI2*R`RN_KSIJU!p|T3A z(?7R!g^vLEaJ5cjMnEN))Q-T1?424S0?#f%5ZIlzyCLeqk6CIDs(G3+991z?-%@A9W<~ zU3DaWXja=z2?oH;!CjC*_i--_=5cq=8>`URA=*U6n+r(WXq^-jK^LwF8tvA?cJJ;f=$NFxtzT`kl!`n za_09TSW4=69jHVOuhTklEw@YO*(lnK-@%H$27Z_D-SS5)3K~wSt~lQa0J$&D=U@@Y z=4h$yIGy(d5c_kF`VtoCX92JO1nM8I(y4ach&vJ^#Pz}XMc!H-Ps>H^F9Bu=8(#vB zB*i!+0(nPlSn&(`(-n(C?B13`NomYcz-P)f6*Vx68|(a8P(Z^2cXAWBDz<+asLNrEncoruMG?|)u0AY<}B;PqS|2_ zC%me|MT9#>Et3}EQ!al6QO`rRoQVB0L`&6*;7Rc^Sarxahxr%QbZ=ocjamg@5jh(U)&~ zW1kW@(>B!CcwF0&`%u#w6)@{U&BY-b7aSNpeM%=z$hq6%piJ>4Yo>N3jZJ|cfTEK8 z?-fAfgpPwlu^7OXQ9aqr$V2YT%ghaR-K|SyBFyv*mMxH#pkn0N}?kc!G2Ek zpK8o3hwgr}bT*$j2}Rh|%!-bb+%N}!tp@EG< z4RAXMMWruok_WI7!Vvz5HK*K$8DXphd|lj-k1$~nfJ+$GltEk){5~+UJxnn8fy*JD zox)%h^xN5&k^!L~>s>sh@z_x^AnavA2K3p&EJ|#5okQ&s1Z}&6j6Zk$7N=ZRH5KBR zmoBan#ngXe{R7NeuTfMpC;1=XVE_#b_o+qnxS%T#c4yvI)QFj}-{ibkA?KCKcWRBd zOYYgKY$vge!P*w!%DGXWJ*ac~sj+?K9I+Noe&e^dU`_TRSXz^fjRPH7d_a+K9%I|} zMr;e)jYJ9L@J0AJm7FGEx)(t%8zeU};b?mW;t|a@_Au9(Z*b+$>J(G^wMa3lr-;{+ zK)n)s)ILe$j&b-j?<@{gjZozbTp^7~Q% z8O<~JGC!E)QS^xL(2G_d4*UIIZVs;oRlAV|FkN{od)#pnrI+em}ps z>0RD@IzQ=m=)Z6=+ocyHnuvw{hsO_3;;h&{$z_!X$sK}9k?$VUKTC~|77|q#1x#zL z)4GpM@~Wx#!r;u+L4mEtN$DgbR>fY> zn*`gaqdZJwrsY(Ot~gk!*%A&&R-?KhA)TB?#K>M4cDG_3Ztp<@NQ}u%-_T=LMJv2t zLMsmGMe9=j~jD>2mvVy|FRbL&y=4$?=7B>w8V=+qlK#`ntBJ^jWm z+>O#0S^jYljf=7`n+3uk9(e)ZUv|qH8D|qI9=3(YEQwcXqq6H{T@JQTxlohiLSO0qZN% z?6Bi#eU=^cF8v7}Dt*q`chECb=dn4qz^^9_ud}54GU&IRbw9S9PU~I(yxAGHn>|?G z{^~r!@*68M3TeOlBlA3uX8~gKhimfnDefL@>LW3$af{dWX8QF3GX~YW=mrrl8`FQ9 zVX7fjasyukZi76jW}I=HKVqL_aKaT(NRNuWqi4b{NY~w)M%g`jTPwlEI2}|ydbIrp zxaziC8@TC{g+Dcf+c?L`XfhuwkcfughoAa~zg(OjpIzP@^-ubjef7!l$I7C|jQ#FB$h&zkYv)UDiCWt?VpTO4Yq=GfB1TiERw;^TRmm-Tby)5MdqiVSFk0haWfaCpWpzVG0-llnK@g5HANgW@v?>QOp- zTrBpLsGY}X;X)pxuR`Xl;Gf4B5N5Z!+x?20M6C^q-(C&+KRT>Q?foAlQKncCV7w0n zWG$_bNCr2#chyvIfJA`u_RU2ADdiJvYZBbYEI&Z*rgMS%fyVU&Ku4;G2uj80XsjQl z3rexo`3MgjwJ?mK$!2Ut3g|bLVZtcI=(LC9**SmV0m+AjZ8zuxik^n*^eX+UP~4Hq z8*oy%VvrUv`Zl5@acZAPK_#Ek=LjPh*WASL`2Y6zs3P!RKq&hwc4I^2jK_#G^>0j0 zetQY(Y)syxJ6|ly?(c=WgvGe2OTWR||r-QSlschm{owN4?wO zX*?l436*~lNN1^D>Ku~BO@II_i)$G{f!+j!8YiZtbn?Q{XpT_>m|IQdiOz?ZqHSYn z0g4Af4l$rU$*w;&QAe>swM@Z(w>eG3(_mdw&F#krz8 zm6M&z53ERgR{Z`@YM|iyfCcl1Z@u@rWsro*^f~$e+xynvMsg(2@Ap?21soO&TotT` zU%=sjl$5e^oXX73hh474AtBpYE^Wz@SC6i)`RkX#_ajKDX1aGj+yR50viJ*TL@-DO zgF$kqwy%!s~&y|FZj4!%h(y{sim(aKfkl zRqc7(3ja5+-y&Lp`!3JlzQ6Cc|4Kbb_HP*RNG<=@iGo$@#XA|L|9=eZzd8mc6#xHZ z1WX8jYWz#!Pm6x-IQrLPU)q(4qLOeZV+VVHbU9CRciFuwf?2p@Q3O}$q{1!>QV|pu zRMSalNXU3wP7iQB^FczH38&kAIu>B5vZ$zLxf`w010idhoArwoMp9qYV@LGsvZ8;0 z3oCAg1L9w0W}@N}8~be6z1MLX`bzbr^guEqUB^r()!=1$h4E;W^{%8VQE zOGOO``NpkSc_^`-Hs%YI{M+>E(;a_e_eB3*47PtwB+;txPljj z)iA{)YlQHBGb%y!fBwtjjB=R$6QYd2Zasfli~{+_i5>gfVmIfrZrC3cXHl1|*c%H8j?00Ya6`3sO6a@&tEWM=$|-I%gf!Eh5i0X9V@;3 z%T9$Z#R37YhSBe7+-=lQL73(&$U)K(p!t|44l8$l45lrU*hcBIE%R z;x5!e&zse%P}JC{*rOS{nTI304FYv*M~POWapWg zSf5Z?nr3r|mY|Oe81t0xQc-ye5qqKjnI3$_CXh6#>bA~{Jk4*Dag^#0?eU3-Zk&*| zIZ54+s!i+@ZcyF-FRc^9RlBe3JS?4}-~=vlWH$6zdH3}z*dyEodvu2f@+mfNZ!D<% zJ3RbH`C}){<%*uH9N1`1Mh{uh`)0RWKCNgXd-umX+tMKG9=f4GD`Qum%0=?d*z8eu z8d|(kg-+sX9A}d#tE*3Ek=)kdx8Ccgj^WXCY60*x#Dc9`z~$z;=g%W9cJk?78oTiO znojuhS4YRpvfIC4eAGYjPjygy|3MW0H|{>jq4K|R@8MT@`15uiL<5BP9kc)xy6a%A zd`{eR@b!Z~eaFGu;ZE6aFjqX*ZUYD|w;T8$YQKT@gVE~yazj>FWTYVD34LN!8;eHi zU6Qv&R7UeQ$!emhp0BuJ<$Ygyn&#Op0Svqq2*l8bnB>hUjS1qyhZyB~8b=v{Typuw zMKj*K!2-POc4XkEl;p>DoX-hO+{R^@muE2kI7LZD|5YdKtLH9Y5@$7?>x5$T(yA%q zvWl5jI5(_!!nJWL;@1*1J;};Q^DK+UbvufxI8Cyc))jv)qHNMmdN3 z4Q62R$r=mQj8H7dI*pRlZlInQeNQ-=M0E_STtqkUPStw9T&$%1kIQ({HdS0^(Ojz< zevO)X#((XrU(+bNZKB&)S~&f6oaNa#mNrd)E263@W+iDjY032Wcs$FCk}zFU^Oe76 zxlwYZN{A}cIr-^YtK@SHJcE!orjTs7VAm7BcCfoiJf)w{E6gZ(&x-F!6SYLB44jc^ zJboOfvH_dyF3TS>$68LI6`oEVm32IETJDr8#R~dZ~2ItGX%mXQsWK;`h>=*TSY{SG3C6V2%_A{ zquVJpRwv8dclNY~W;cc|h}3tqd2VAeB2`tA-L^SzY@2tDVp8S>hVPlIxT8XuJ8hHY zE$Q&2hgGiHiHk!fSw49Zeec{FZ)4J;Y08 zI6Q%%E~BjCBk1)B__E2egwC$L%TxG?$k+#VGB}0%YSz^G6y}A?Q+UtoSq!sGuYU^X zWRQsx5c6Vid3|+$(>sNuQ8d2e;+|g(u7}IVxR(6V&MG7VZgjLVSdzO3I@n)0S3y~@CIleWn?s+R1wq0 zMSwNZ%}w-0FTf+2w{tnDoc9BK!tkMi`{%;|zq6>4OLl0M^P4co8uq$(6W|vrRyl#R zl?K;gt_}F0e|3r5Z32lMUl-4v&vZ!zaXF2~v0<5r{c1qXfU$38?6p4M7qhs2$jiH9 z-;=OVcaflD{Y3(gbQtwj-Gq>4mO#sb1|FSkUb;#5`|`Q-X(gW!FCxBAK*8gvXsbse z&fKFL8(fSN_}il-8{JeRj>a^Fp=INHv}V&}u~%=7oZ~8KXGDLVaR(yp_-I)?-1pH=j4yJ zek`aHg%4FIjen$a;N$TFw>dUgoj_4loZ|9=I0UC?c2Y#Z(tvmZr-%R_iAw4tUy}L% z6fwyEerw`}&OrTP|N0a`Kv_{;CZB1W53et-P7L#c`7P<$XYp%9*$c?VDvTaG6F!PDYk7RSXTzx5BD zCjK^Uh@qAKanpoJU{n^(-%wFY%-$sP-;? ztl)kiGM5x_=EQw`=rW$?hNI3n7%iT^AKpjZ>vHXU7?#sb(T?I<@<$ny1)&~jG&N6S zS>w&y+tL+)1)9eBe4Y@an2`l|{(y(8IELkZ;_)gDk;CoK3n}9?;-G6UXcT3Whh$RE z+R7xKm0?<`s*g}og|y)n6A;fNGGV?yY3}WUsc4!z)!8v z-QN=RfTQcgv~g6?q^Vy=6vD?OPn4BI!0gVP4KV}6j9Xz5Ly%b3N$H+~BYJUItvpHu zX%PL9x!tLy?4B08&Qnhr!(LRl18~fdF2GT&w?q%P*cu4$*794j?{h!M`z^5&@uE)E z5}Z->Y6;GDYF6q)5N|&kC-o!V&$<^k`cBDV*Ge;Doe-k->&`U;zLV0@(5KUL)Oofs z-S|hy<*`-bf5Wy%8Iw6N$zoeR7x`P0KzfU92L3ALMjkZ^oKKd%9^%tFQ4ru0J3kWO z7Coxq=M+{WAwKN{pa7#3TITt2ke;FCmxMyoIJ&21It-!6;z0thJ(7N&ry)UA?s0&7 zXNG=8pdHB~1`zq0sb8?y3z%!k$9$X!{Zl_<{U5nHO%y z*e>7&FT{dD;ntLb6c%V;d0j&CBwuyRu<%K{CEflIbH{pIWl`)43m%>R~dxnmn5( zw{{zv7%>)`hB{ep_diQwQsc$y*=05<>&Ft@g*n7D3y3&W(Y#36Cg*toOaE*~Nj;AW zhj|QIvO4=Xdu|?ws-($O+KZ1RGEz7E3qDpT#7HX;I zhehnH0u6ey?25+jd`L4y_-Hce_KW4pUU0F54`kp#(n17^{(qWB6J&&8IVrU31;5C; z;iQcw6W`|qq$!}II)ji2BK;tmyVIHpnwI%o-|ro`tlw@I@86csyXfTwE;hoMC*8Z4 zCF2UXCu306CdK^_7XpJ`;-WavCZoF%NRtXKi*IE87pRE`{f@Af5N9PJDvrZfROUcN@sOy z;EvmwND8!ZwkvgoqGYhZp7|s~%iB7G>_H4um(iob^lcv5(<;mQ~4EKdx>*y|9^(eizre3aa!SFF>iG$#|A+57)Mp4+uby(ivM~ zSnA39>)E)H<6RLN@);&Hz5#v1U z-n;cncyf|991Cf2zI2?hcK4%@=l&M{AZeRsPW^i6a3h}+C}w@W8Bw6@$qq3i0o8VG z5F4^l$~1?ru+_K29vY^$k8jT*?L>*7=kUc1dwZx=tqY3!P-)8<9&F<~7= z&$r-Xa&S?C*W6^P*x&PyG;MH%4cfn_*;Ic<+Dec2r69`9C@i>h}aVmxgTMsxGwydqwYV5nW z-F~*&?cwSG=ev-(53?^cD{MTtN;eSH6URQlkK62=571p@dK^IaqI)<5PP>`jw)q{n zZWeaL!J17mz{y~{;c(2%*|yQj^U5|Etq}4`zA)Zu5Y(q2=GLPZrgip!@q29UOhV}#kHDKd7{65N?Y=ZamCR2q@Bk4WgX&i0cVw2H> zc*4EZ`Ie^@brN;1P@5diaReUPQsrU~t&e}!oe32wB%|bVQ^C&y$AQ@**6+jdncCK} z1213_E$^M~-~eI!i|&3YhKHvSD9+8snRjoS?awK3P7YhHDcnmjLmQ(0{8rAN;euzN0Bm=*s&J5|R>9-~+-A-hoOW5bH5+noB_-NTZFW;A5*V(N! zDQLpn?2!x-_erIlV?Ts_Q*b6gw{0@9ZQIrtO>EoA#Qb7&V%xTDCllMYCbpfNx#!{j z=RBR4uCA{A)U~T?_1b%{6|GqPhLTeR3E+M;-?H$y{5Upx(i|IvZOwQco-!dz>ha;A z?sr|FhUo}}q_{tEVzoP(p3klaVN{6bq5`l3ACWO^AnUbQNNmpjtfw0t&F$PZV0fi) z#=@qU;M(j4a^M)CBl(1#xIeoQvOm};}gbC%80Td z*+9igFf4pkXD}7>^VC*4-Zvox29=nmNJ7+fW16kbsft+O)x- z&)cap9j*X@SCg0qKWmIqaAg>m@u6h=Ub>IU-D*qd6{1_lO5=WbOkE;>hJMQ0mDC33 zWFy3E&|@2|hKN+3MxgkiIq0w!`Ym~YN#O$4?)=tNYjI+T#DgcbfD&xfy{_&tkQm1( zXLXKV^TH2iZh@IhOX|)20E(KjzQH9h6^JF4zH+O1L9eT;eR2Chtc#iW|;K}N8fNb zr;DoAQW^NWbho>~5u&8FNjyXgyFTD7zCw5dVFHyc@~|C!I*s7}%*=n5|D1EmfO%ni zZ}kdmCwW?Ak{4hSA5mpSDmluKRl6h#5dnj}J9h6D0p*0HlDiu)iJ- z4K-StYS~aoJo*4vJIr#gEd+BvhQ$l*H@n)J6T;x2>g{E>HHkdG&x*9HY&^PcKyY<> z5+T7g1O`5vtmJ^250_lCNIAfYuP_{}J1&Fd@^Esx(!NK0su646S#OCQ9DAPq;f0Mi zvA^%{RC@ML!&Y&rmuPk) z^m*ramBg!1c0ImX+3P$hf%z9l$r)20U$f9W0_cZqA;~FIge@cFc}FcI5L9JHEfL&p z;-bBV9uP^%K2ro7&%ij(i8okclFO7w4wu5fIK1CM%^P5kh_Pi@54`Z_tx&LpAsCxr z2uK6CSN;*9h8WL+BLj6YUU`2FHOKg8@0hC&3CmtdtB$r2^yq>wud^5-`mty4hfsJS z`3-^|H=+KoHRQizLLT`*_znL5dXmfSrEU7$v^GnoYkT$+Zt$J;*~5~Zk`Wu>thI0* zCe0ps7n&PJXC7#^iHe(*~9h#&n0K z;Yq~u4*t#EU1o5dooc>1TP5~RTOE4WPNK|eJSI>a!aK+L;k7nzdMk1PQF6@vY@H)e z&yH4lBsY7uL*(my)PvK%4fxkb4XZnI!DY4zse?H+HRD4(J2h_ik97LLpV=W+!A1;2 zLvy%E=azvn;~;sSn;>+{A;c1e5AS?ZH$Ui-vTsls5X4Z)zm@oA*j6@QqqlPgoE*>J zM=h=KN{u`}k>RgY|ModbFkw1l7GH7mz=;^EoVlASBD&E0As#K@;qb-z%T#giQ4re2 z4{!*1ARWzh4L~Z`)r|Cz&w1BxxNljdDV-jeIatf|d&9W*{ff!v;_^SSbV4i8LY?;B zO=}NlK}rw(waIbv6ngf-$`72QuhYHTHI+7a(%Bd3=-25Fhwtd!;2KK+l2$@WOe zwe9;=t>15b@9%2v!TaV@N0OE`V>FupU}S9FmDdDbd^UX>Gf^Lgo?~2ZF}#Tj!!~%kZV|lZAFqv z?DxV9Z-|vzn5bSF%AMx6EKAwRlhX#5`q} z&EZ~_5M8c625H$$JH$eW1cnpBqPl8%Nc@Ds5El@YvD7XrU$)Vi3vdFG_EkRNmx3 zlmOOQ5DnNo6eHszQji4q>@3l^5k0^1n~2g;?h=Lc1C<4JyJB(gESK-$d=gCm)&0^- zjR$PLCyJ}kHA&DG9xkcx@)J_p@22Atsbz2V7CD*unZ?G=`TBj_{_W;I za@{d+N;l9TrvxI4e( z(5P`mknd$7{lp3vZ?kG_IO@e4C0s*$D6tS?1kd#>gyj-heSdLtVP$9zqIDNu`jtyj zQa#AXRavl>`dl~ER_;EfH18b#snb}WPtB0*_itl{51@HeCOR7BDPg2}OrGF7l(M6_ zNuaxr>{WpDPtKFYSl^AL%2;gL}*QF&bDbx)wXdkw)5-$JpJ1h>aTZ zN}{d8waJpKtp?)iwk9N5CrU~R6o7wzNA_jZX-h8oP5I!ZXq2yZ>2(+jf>`ki1JX9w zCnJ2FvQpU^4?SWWL=Jbn^N{p*7t-JDe@|alLY_=BcA~!;yZ-d})qK<6?MIuLmIg#| zCJ)H%q{zG=`cP~Zk^3Un>$;|!8jL}qTCado%fY^IEyMaCjZ&QwsOqca9f`>&EFAP!r;JI$V^-#Mh~YDSX!{RK@tI2CkyK{ zw(~%aST7YL=$d`y8Z#c42l>HtPrK;8tu59&)XovqM`^p5lZCpNILL6P3a_d(5({U; zwagyC_j2blvy?eBGM>hJ3(VxEW3L+Zu=RGR9Y%NxHBZg9i(Hh8>OE{?X3B-3#<@HB z+#d6iai0pXs4t^3$g@xGxpJ+=z+kEF98WmA=sWAs$Nkjbens+);+Uzx!#V4cL>##p zRhFk&4UMO&`@5O~b~9V(F?5p++TR=qmg$Oga1MP2kNR|iSxse3vTTno^6D86la;fY z-dKq&jc1pFBZ)r)I1xU3<_pp2Wh!_*UkFqvrb^8W6f24d^aZS4T>>R*A&_cjvd!Yk zcUGjGxcAJ*8DG1Xt7Nuh7_jD6z=AYX%vUm|%h24aRR?S4ELnXcd1_V4!#?Dxlt;%4 z=`@RRk6tU*LWNvD z5``C-s7C`^@RP$D$GH=?#4B)*IluiB@j5o$R3(aZdZufM*T-Iw%58US?c7O z9d5Q!XNc{4E0(1dUdPhO>tap6XwyA+3*BmxXhVG|A-BX&vyF*XM7$h(bM^I^b*c>1 z&+rj>w>cvlV7$nkP)}nEaEpiAy-F9mS|+Ij3Q76;{84Rg z(_Nf5CL!c0i5IYrFjS-ZpOotR^j8steX?8M;)|7t6@K20hj}m|G-aT zq(m7qR=S4TZWfs>FS|*{_kFxh)lGdiW^Six%ylq&&$e06^isHNqi1)LZ}0jw9vFgQ zeDX%(Vaue+Y^D?JYM<&__G>14?yIBA=t%^~?$xf*V<&fo%`j09<_k*wP&7Ex?%92z z_9V$4 zc9BNSO#YZu!G(fqi}Gd%{ZU)5f)v-?SkzV-sYn+PT@#A!^;O-lq?Tn5xWT^-BS#+* zYS7%_IF1oBu$26kISZKu#khWWsypH82NK`Ez~AVaH)#WNB8Mu!oN1#0vw>?5)0Y2Q zJ6So|1%?bm@Vqs0gdXTCN4?3$trVzHRUeFzyaE(i5Ped9aAQR1Z`Ev!2 zU`uf+-^g!BIH4`sAOnz{q;~>mkF))UFMzF7=RY(2gm7~|R8(l`pN9tnN95@HG2YIp_p`0C-iCC!qehcLJ;RfXrbdJzqP7id8fN1`)jZU`E z2~7p_fQTnl0UX@>=LOWd!4)NK!!=IL-c8+oHr&?jkH&Ff1gV*YvyiIeom+Z=?ll93 zJu)QA*{nmKqlNE2zSjPce|>I4B(FPB*nPmwL$9G-(2AxTXz|;#5R8WLUy*h32q$89 zX8fT$chu4*>WY_|MmGzw!_~B&K&%ily;NuVln|2?Ih2q5Mj68!Id$A0$D2gB13czW z488pEJRQ6r1cTmD$HJn!f*x37y7{v z5Acsf=g59sO&z-`fYoS?N1~zOL zCP9aW*Lr;*<|shse2j?Iy#$O9%D-E?-C^E|mX#=ck#p%Su71zg*Std$qh-sNwB+5O@Sys;~&gmQx z!9D}mnur>b>E<`UITSwiR_9GcSF|$a+W!4?q9JAf{V4Rqv% zn)Bnr{ORf6zRw~#SsbHpQtj|S>f;b7<5Dt>E~w3=TgT@sP}csM1GJNO>ZsyyBYl-w zr4-fsqQI(DtXC@(&aNc76v29s_#A~Ow?)zx@WQeZ2;9iiiVSZZ5~DPc0h1(^I~zE6 zb#niPzCi-$W?hz8Zy{Y@RAk0Zq>|Z7YRtks$y{SqlohCG(WI|4xK_r7>a`-Us1G^c zhi?P><@z|SP7vyx|WXlFTUq>WLplfxL!dT1a6fr-^J0wSn zUcDWB!GxgNCd=}X>?G#}B%k%i}jia=odQpoLJrLR%r8AegB#32CQMEVxLYA6CPWZoZ~b}rZTp1p(E$Mn_@ zk3OMKMY1-ht)j0aTD?D8kdS9}e};{HxWoxW*XyxiE2H7L)QJGe+Wov$v_b2-;gZT0k-oeiPR5r3M)34mTl z`#bxO9(u5fkrvXx>OlWRP9-T6`<5=(zH@<9sj@y_fWcFDGN3JZHv8~f)kPJpN?Z@4 zDn-S`kgHtECxSgk+=Y&Z7LKU@VHqa&m#;QS%)h&ZDi=Y6EubQoIY@Au2)(?IkX`z)T%HrYKhz zA>NsJkIV>rT8n%a?WGVM(<|r>eVaYe$V#9ef57Pq`VIUFJA8F;Q7(1d&n zMYZD!0lCZ$*6!BKR*x6lULOLc#Z7?7s#kRMj?&M;c5}~g!pR*Z=j3{=YHe1ZZ|Glr zCzf}_B7x~T8SJ;LzlLr)?KTeIcwh}0q*Gy6(iQuM64`|e_Ujz0r`P1d)6>E zD_h&3iQGW_tvjtt;PLoOBa*vF*PJLs6Ab|QF8w@Aya_zxVS3BA-c^7x2WUD|+^E<| z?CBpmuhTZaDN)kvL{~PNG))Od6u$|9f_^^rgfQ0xszDYa^cRQC#PbwLui=n|$fI{& zb>vLyg7#te2DQW0`FVeoOQ1fBv<_=kp58eC;h=#3!uzKIJx{a|Ego;EgM9a$# zLB)|SBySs^FB=0Sa~f zqe6l0BXvat8yl3gWA-?WhDPnS21t<%IP{%}g=Ke^)mA&eo~zI11qpXqS62bd>*`P{ z_paZBp5VK0H!T)BoJ`qp{#DE=d83Nf0qa`8fm+9+ca)2kcqAsju4-@Wp3~R8^ZC0? z3oG@+Vf+2IJi^KSEhrE>+?=hlAhuqz0PTUsfRTI3Xe;+#UPiPIg_nFU-YU%ZsTPXD zMaO%`sGC;GQk~w2D*;3k=!dwil2_=f))WITJz&l#I_d`|Rf54jd;T@GxxTMuJIc1p ziB5u|uiSia50%^m2Q`GzO#PVU?YfxV?+p_6zlA0jxxk{94JpC>fR;kAo^Bw%_};U{{5yUq7|Du2Zc$5a;oIf&}UFIl6S^bnF{o%Ljqz>Xo*S;m$i8yg`u*_Zxw2u4CBEg}PThB0h z?;G~&GJMx)_ z_RNGsO&nxIygVb^>ZgXdqz|gWVgY9olcMr(H7h(@&pMu;fbFDUmd{bA>01@svZX9C z${sx4pX#6AxGdq#8K9@9&+!EuC0zFNL6Oo_Nmye%@3`Q+xiV3@1>^+ z__}aW!=a!Kmuse-svq;JQ`qaCPm)bJbyi_Y_&J@avDZ7kS3gm;Jb?Ci)%IKqe>n?N z`{$_qsh5nJz4Ze9)_wKx)uHFgqJE{4j#YHnEV4g0=~d;v6fK>q}|6 zxYM3{uwj9_$|^m*8GnNekv+a^{e3t-#Q6PF){}hYTi=h1>37_~MuC z_iPs;?dT8}jvBIpHKGOPagPduKVv!m@I1upB>En(MVj7)qq51xoZ0DooT!H_p}@w` z9#~;m#Z?v~P;(m}eu~_3Gc@^zQIr7#M+X4`fd)Z~+|zW@O>0yC0Rqwo2?B!n@6^W9 z$ko!(*}%r#n9<&2O0~~wLlC+9oDT9G84uM*Fi$bDqz`#h`N!pyjjP1GvZcgiP1eaZ zZ)bxpx5Fm7XBnb4Ot;6q*^%YZ8h%f04{$lNvvt~rF)ei5liDVlxb*A?2d!rHSw|>U z3rSw!2%)s|C@u0aFn3`5F^}$0`k{Z8I#7{>jBl+YL?S4|dlbrb9gIYkT5^Seg$tXO zm2h?yq}gXv3sK{-v8RB5RVOgv3S+`DUP4u+U1}tk7p1LtT99$0X%LD7A-x*_4rOgL&TY>-&OEyP5W9Jz0*3pvMh^s|)EtR+CAn=*%0)&+R zF&1g)29icL8Hv~$l?L*Yy7UMnK4W6pnQ98>n?$EY9+uS@W5o_Q_cWbw8p-X@Mt}Et z7vwxFMHiGf0oVf3tFv$-Rp)7QWpgphg=*JY8hqvNqH&?7!*ig zd!)4*%z1lD2{>bdyx^xNsJ*YjIFY|6dzmN8K|if0@Q(q;83zA51Cf3#Cg(tdfSBWg zfFS*k40JFBy8KJQW=%ai+%Z(2V~wT@C_EUa#HFR5#D}z1BwEhKtH@MZV-1RI3xYe7 z&I%n~_On*s@BC`~1EHV?7q;~2{^?h50JYKz&uP5leJ3|QeE1#0PR{B2BiH=yv{P9a zT~izz#z1+Kl-CsY5F9UeIfJoG}?GA zqIIQ?YRrf_MNP|bg0Xg3xJ=J{WdhNXQkl#CC5_}%4cGFlh4O$NewNVc&G=>@6P_b( z#IAaF$e-M4xbx+szns}|V!~OGb+oDyC++p}9E+`@7((#wE<4=kK@UyV1qE5ne;D$| zta`}UuiTZ9E`L_R^;_vx8BtD$s0%8FTi~WwKFC^-dE2LUHMMKW_{m$<7W73A*DOSv zQ_f5s{KiBTzK}(y0|!ell&hG+hk=Z2J=jR&&P>d8*ESBUvI@5jOI(m`7FD3ir`WcP zo#`u^vnaBnq%405h9BGK58Bi$MA`pRP8WPHVSRN>*EHs7uHpPy;~)}Wws^#gy#X8)dk%GS^6*zgXlp>5H2IC+`ey3;w@LQuU7ncMW3Ftb+4y0T3fvCiE6iN*&Kdr zaoMT2mAiWStq+=J1~Gu^zy8|1Q!TBL2*HaXZ9W)DOK(6VRv2o=cSWVW^2`Ma+~Kr4YMdc7t=Qbeeckxk~ES4+V0g8 z@E-xup7`zO&Hiq9I@h_h(p$(`IVnQ*hIml0r=Rf;*tzmC$8j9#uFH@6S66XKU_acc z&@u#G%)4zIy>|A|yJ{P|8y~AE%+j+)9Dh5z*GoLvX5`2&-|CmB(^+qx6|)#8bH~+H zR8Y9okord<7?E_t_o+?x00`G2tHtd}VRny+{0O6b=>ZQ}6-rROI{Q&Yb8anpHDcMY z69U%8C_1>DoVwrV_;}YWQAIV8TI>z5x|6=iuS9tmjJJ<%+XM99yzoRsd(Slb15sW8 zz2+E^`sxZ^Mz4?V7VeU^hepImuGv#2m6l6ljYPicH0gVaFp;Sb#3+(Sw`ZtV=dp8- zyRH3MZ<}==<2Bo_o zk(GF6*2?d~7a-K#Z!_ZkIp}GPVDzR_?uUl|XcNOULZlCgXkbvnT<|OC(bJn{?rk{) zON&uQ$~LoHETl2sUdNXs=I}f=FUlW2+Uy_7n$o2Rt$U}FkH2e4y)oAfx`qRsS6}Jo zqPK&C;eVX|W$(Hbf*eBJVEuLSEes+p@}~%$6~{lAc)o>6!ff?dVmDo&)N z#tqJjIIgBuHN;4?XGY6~Jdm<;ULb&{N@7pUoU^y*#Z{=0;Nsdcw7WZ>vV(6A`1Mpd zF25<#;g!{lPa!=iioai^nWR~lI`v@iK3%lIA0vbr2P-Od!z1mbP%&4OB(1g{(o89w zD@ml_T6SMQ8>>+CYm0Lmn-X;v zK`1((Ffq>x^lpWC-DK>4{!jV{5IP6_BYV5gQ~q=%TFuZE0dh9W`jt4OXiLge()2de z4US*6^Rp08C{*-=N}!x<{7eL`GjE@GR%KdrYpbLDM&+j7m+CrY2!F|HlA-V}L6miM z=jaOI7^AT?Ov_cg-R@b9PUj{Xo$(;r9Kv1O)#b;e>^9Zw?eg!m*^X&~S0NEAn%a{Q zZ?F)!T1e&VNfSXi$e;Ix!kLDDD#m;4LaV^C`LSYylh5)MES!8`>!85lk}&ywJ!6P7 z-{N45{d_UAA;)<{gcS?!KK^?I*;e<5w@3V6+m~35Jr-AI1KqPFAN4F*S;(wlpaZ0{ z&~g82WAgdQaOR*f)&YR?7!@5x5nZ~&Q@#=kpn)6su!ak1tan&$Ez+!>1iSA@J`z%!d8bT&woGLW?DK(VB>L?%}{K6n0 z2>*dHhL(2!4@={}+bu}GJ%3=3(K1RganyOuO9$uC`CO>4K&bYUs*+U0zdi}_VOt{O!$492+(gHWIl#NV)N%-4e z^SgP(qaMY(o__4aUDntA?Se}9=ilDc3pkI=$djE+roTfx-`#IiGd1mh?~{^cau`gc zkA;$I^%0*yMs3C@`q5QwpuOe5jYW^7+DiiXsWQ7rQKrIvv7{F7-dC6er3U?zO4j}J zrAByf5|~;+4~afOLH7GhI)P8A_v7P@zx|hTe|N6dFu2^iTG^fE$m}vrNcF`Ye z$1x+;oiZQuuu|L z5f^#!sAMDCiK&o?rL23&AIAG1quM_NiJhkwk|uG=$z>{>e<1&2c(woeemM1x!|nMQ z?+xha`j-~(FZjzT6ZlsR)+HpjYVnRB@TxEw$#{bJARnHd9v^TQ08bZRhoA3ZtGU@T z`nf$`64Tqd31oLqCyuVZA7A??30*#ZuTN8*3%}#sqO>r{*xu808?n{QlfkHrA=i_o z<=!NaYr(-6(&$e)z*r=r48S~-MDz6A5)3oU;l!A1EV19RZh}laxJeRNG{20rQik>t zsm>pHG)>gvB8L)H1LG9*N!0`Q?A`N|b?d9iEpxCU9Bd$ZX&FF{0%>)?aNrr&eiWHK z)Hb7sg=q;_s*3R7!$W)jQbJUyL(YBLXCYQlN=cdkLGXXHG@83Hs{nw-*XSB@KKGT zP4qJVqiv;@^f=>;06V$9_pBRecKr?M^hg+wLS1AzDw7tPRXbJW1}L*zC<^m$_ct5l zX~Br2X$$P>5J5ledDs`Ke&j2J>;2Wxx|P+WZSULrjYzPY1ium9-$fms#c4dcb$4y3 zKL8=)JXt4|>bV5`wmWA^E}D0i%-Etd$;uAK@`X%=-e0_t(#9ObaT@5G!TN#vmg%J| zj;yTb&GPt|s!jkHdCqE6idKf#Nbv@+Uc?gGA)Sh{8X zs7xVlq(IZo+Dth9AQ$*v#TzBwRq+kB`OoJDC=-y|_~Z#|JJh1NK2-^6*Qsp4fL51*47YZY~h3vXX#zb`p!Mn}Gz(X-bpa zh+w`&*v{T>Q@w87)|!Llv;nv?lw>VHlc}x{demkVcg(1^ZQG;Z4Zh zL9e8Z(3c@Sl?^V^Zfn^K;S`OaYX!aVhTZCo6m1d)JvH7vYUH+;ypbvYTs8jAu1FuW z=ML9-vvOzLBec*0l3=6Z^Xm!2X0rxnM`&)?gH*`31=$d5(~i3+s~(+UX;?iXhU!7y zRc&)A&rP^DLk?`<}|X7V1;zX3U5^yN>ass^2>;($cQ%!Vppu6sw;IIxj+% ztYJ0uvj&&lf^RnLrKOhD=3ilfQaKX^Lbfwu<07b&AyMyr~`>MSp9scQn)Neor5a zOB|^QV)=#Da-^um{jbgRaHZ=01!HS3v;Dh`! zBX7fhSGKc8G*oeJsI>@Fn|-n_=$v!VK7-2ZCWp?C&V%wtf@?NLRr9wCw%67r+69Nd z)89&rNN!PD=KW^G$sayn{++_gXeW2r zYdB=pyx@!aUC?>b{9(|5(B&Xf>((;7E%}03BWd-71(5>YpNh#kFC*bJm7TojNyjav zg{b)D$pHeP$hTU{Io(vlrqMKXjhO0u%Q7dq9=Kv1!1-Oy zGv9Ea`~4o&PzynuD-a}TYZCC<*`)yu2Dt5uIbbd&YGZNn>bxvZR%MVX=9h*VE^124 zj2W^R%p)}t{>HPUuy(=?E48H&Vc58e6y`ZSKTOZS~FNGlmj)x;g=lj3u!w z9sALTpeZ*t+X?8Y=yR%|ZUWXj@-xrZXL2?!8!Za2jPaJD`lZovA@4T!Zx_q|Ihyr~ zS6N^ZsFdB-OF7U6;nBJ^h*$n-p}D;JnlAdB%pZScJvnn?-&xP@VnCF)9B62Zmh6pW zuiDxp-$_#7!Y9hzYbopY^`4;4ug<{afzX8^a4aaf{NC4uyKV z#RxW|p*7Yhs~!+61+g8L4%zmEa$qawHvr}0be3upvtHjM_Y|pL0Tj5gO*$R|LL)U* z#0>kq%BF}QHfHd4mm{utBl#VGgVb3$mtNT=6j=tkHVv1RMT0}lWKkFGtI_?kDj1ns zRU2Bv2!`FUtK=eSrNX;@c=~+p=t-`n*9=P5 zuac>ioFN*MJZ!Oo|M?{T-63f?9u3^v5g`X;hztg|6_<6-COUFdZ_gib4LCo7G1vdX z{OamV#=JOtIv2{qSSkf-B|Q8acOIh2Z>iUz{<|238{hG}wgq8+3I=~-fe!X2>ZJD1 z3V>iSJum&Q^k~SY%2t|&h(EMdB*LGA_zHNko84kI%vn7X;v)1{aRo_Z(2C<5i`Xt- zHeLw(6;=C)BTPzSR=yK7dmLeoAH$=4q_`it;2dYJBO;Df+VW`@++904Hu?A*yRHR? z4=Ec3&d04Gq>6JEp{anGxaxWG0|4&O+oWS4CCs6sWn!YP7UC)>fF5)>!!{u1xh(zV znZ{!oh6{nnt#eIWSZTZr`*9AvQI9>l&Q2I@dP{7L^wLy<{~|k3zd*0sv41MtBVTn1 zm~iSKHW0kcDe=uGMet8rBx?NfIP2q8f!Acp(i`N|Y0N~3Z21<8Q+~NECN$b~ec0w5 z5E=o+A7znI*)mjVtae_o!k1;^Z``i~r+8lBzbKU-tyXz}*9>Su?9N^;_CnkbN#}P7 zY`QYt51W6W01nJx7R_s{U#2HVX34wBmGC+wP*K@A!nQ)qxfoT+q#Fg~8#@DQ|9aui?6f0Fi*?t~a68OJZj%XoFF_biWbZXA8RTpt zw&vXG|v)~ zsAqprFhqF50tF=@_XrztmBaA)PNg$A!H?$LA?r$3K?%z|*xsd;>?moi1}AZJGIP$d zC;%9BG#TfWceNI_a?aLLN}y=N~lSA^B}2Z_8R zO2;82W7EMrzCp6{v0M*N@-E1wt~z)Za5E9Vsk4TMxK5RLfAbuFB<XVV_g*Wt&lM z9-&|oHX!t~miHe_Bd1aK|6%*>O4;UeHJB}L!B)Y#shq8vpr&bvTebKX0!Nn%P4Q() z3T?<pNm&*9^n2^fk`K*c}#!o3NM@=ip&+BnH-IyB;kqwxwgV0&-GHWr^lr4Br zHdJ=E*wkjNv$#EyX-%tg8r2A;^BHf}6GsbJ0GfiQKr7%Zp zJKMa0!518H*>#|$E^KIcIX~aC>OiIoep*uL)N-WoA#}mmCv6O$!H}m(`J73y9nWp< zoN97ly+-&S1kY@hadnT3s;HIeDnQ_It)gtf2IF8d-Ve(R|y?iS}F3 zvY(X>bZSdW*^=pgnl)A(kk`X(rA%ta|F^iDr^wj*QJe0&B8W>fXIJ&&dQ7mI9}vzwnCZ=08~eJ#Js7G^!GtJ$|UB zxDTykdFun$uDFkvDnym)u08g>O{KPr-jzkA1flev+1oP%PT4hvFvjX!NZ@iEiMw<* z^pTu3pg;}+hm*Cu(C!sY6PX2xv%So|Un zm#5L|4xJArrZO8&SuwUQcUeGM$5hc{!ifCbFTd2WO*I^C*`{$txC0D8hpd>q zRO#i_*EMUC48rfk>}1okS%#`iU5kyv?~W&GGvJ^*rJ{!q1`GH!dYkRFIfrNR8C({R zyt!wl9>MXxYMC}^?>r$GEhHmkL&UA;m&d%5CSIdu<$(T`L#)Y9CghvL;tpU5FYQ#P z3`o@Sx1X>VG5@)Tl&(uZ3vkhS-v-y<{21GOD54}Tb~gB}7wP5^R|<_UmVf05Ha5B} zYzu|sOSkA1pYsiW01xPLf;U#_|2qQ$eCorjllTkjKLiZMziKAf$LkS*2Lc2e1Q~?( zKLiZW&VxF*;amTek zW&940lU4Y?*0<&jwpOWpbmG3gk32znY6~)L!g~>I%q(lK9!tXR&osZ^iC{}Pl55P* zLd#N8p3cn7fK~(3>9>g`8=uN%joOOa0Zn?_SEqkAki0V&Zq}J3^gcBvk1!)^>9NgM zD(P_X6;+1w{V#i&Ooo^m8LJGZtX!wZ9V>@|v5K#vsW&+HHWBpxNi9G^l6Iyn+oE)s z``BD-7#-&-{&2CCQ>+}H62WLou&wF z468HL-ft1Vr1Dt~IjSrwkA~#DA%Np893J%*!>^ASTU!mT|Ko|o^Y=s6n2S@G z0>@#-`GC7{tgscahkI1d?g;(bk`?QrbC-SSczsHJyOLZxl-h|Qhf07gm20Rw1Lnxq zz9vnK*N_8Iay4o#QkZcwfDm)_}mSW#s7vFmD7W}r4K6ShMe(HV4$SZN))jRClZAMlrb`@g)3IH-mh#{!;&*GBe_ z6^7~+@ZZDz81;LRM}!=_DPruxh)`=oPmk?RAH8nh3IV>DBTV~cs3W!e0LGY|U7p^B z8Nc~+m|IV2{L&$%M)fv*hFd4#Jj#A^4B#vw2E8`=^hq*#=o;@EeC5!U2pJ zBc}V37$f)&;6w2wF|s^VGF^;$xlV)DH2};AG6Q^w{kDX0%*cP&@6ZiMi7-wF*rJax z>}$%q*rL@M3`zWC-d*45@wn?yGymFpJj{S7uXWzy_8Jdoc+|gOZQj)nZ*Dhg zrJ2+8;9uTa>uF*-P-yV*a+W#q(~s0hDRjiu;C?)XW{S$s^}dhIcqO*%eZP+Cy6ZN8 z-(Y9)@um2kumh+TdDxvP@L{voz?73F@Y%)aWBYX!Lld~o=N)ZlxNDZtyR_Jly^YvH$IzBSWsHVLM&tf$|>R5|jpawWZ%rgFZOu|azL z#V&Al+Tc|}RPOQJav;#fnfFreB35p^;pc1SyLG~OiUx&Fh{I>Ge-Dvp;Bhxh07Wao zq4|0}@~peyJD#2vJKQbMeH;x|v!2sjxm_OcUmRTtJk#$VFDeyUMY%$kBr&&KTm2-J zSW<)-Nv>G#IY$S%QmNb)D!Emz7$aA5jNIpBF*h?i*!6$>U%j5!zWYAU^Euw{_viEd zGT&zM^5G*77%BdppVdHISK11!=d>RyDklcf_VN+;LG7rO>g<(aPM)>rq( zLM&!+ynl`F?_h*Wh^)?t7g|qSJ<)3odh>;1EA@^Ojh9STGej_R@85Bhm+fjFFMgK& zyj!FSU+&`=T{2W z#49#qI)393o#{7yn|_X3`dn#W*@L=ruYB<@rA>PY7w{)ycN*U+XS_f ztc0!>Zc-*HWVYNoDr7^sON{5*r6VJKfoD7?@+ZGadtt|y=Qw#oTpN#-jO5y7S%32@ zTQ!-e+2qPBB(rfYW5yVZSJYGu7@(XnhM4LGc72#h$l{PPm1-@+ab-(&V(ywnUwL<% zl?an#t5xsf4xF*`Szdeilw6TkyEW<=6jW6q$q37RA`Kr%OwsFDsGq*UVJcJ|ZLV11 zUEMGqYYnKuQ`e2nK1qj`uyXSTxqZ-8rT~@b$s9FkB2RLb{?w&Pq3Wm7JdJBEV=r); z2(`rhk0dY}PQ4N8fjHo=OLaP#UH+y8BvbGua z{bk)BFV9vxH$5rolE9_*f={x}lOtukloQL9RopQmqp{CJw#vrd4>NC)BmhCpg?wa9 zP6uRG!Zsc6m!<~};vP+m*?CR){Y&>{Xm$mEY>jQ9_&+?_otRm@x=@~#E$e>d6X70v z&LEDf|IL6j+2>zkuj9^@zvdx^3mIA{GOW@*=QZwgvr86;g639?2{?e?%ETaF77sC( z-)IGv=+na<{p2K7Cfj|berg-+l$r1}^!{Mo)J4dfu>MBs`h+pUaW^Ns^-4pg8_hCv zEd7GK*51?>C?}2*sS7%Yx-#X};h`|z4=oQL_gr(^aC^F=9dAM46n$wz)!<=hom*dC ziSE0*7&;u)8LksDUzPa~`PO^jEtV1R;x1nK^Gx%{(y=h^Uzhs1^pe<#%G&!g+NGr_ zb-6Q83WIwWUGVS5qn3!-Kzr^CcmU3R;NLWfTvA=*^1IofD{H)Lv1!@qz{5%37WR`^ zgw|62mUDB{P*s5qcYKi?K2Z>-sY9I&7p(8P%h>v!_}M^XZlkWEo1k|K?>&&+hvoJ^ z91w`9Le(!1b_trndDkuz!-s@Tq(giR$A<9fX|$0b=tup4zVVvu2^2n%k%tO}Ei`;1 z%M&L)dG>1u;&}J!f-!cZa;p=vA?$z;$Q$joZOW+I-0-PXhT@qjT==i1s&3uYREO_9 zOOs6{u(HKE;n$hk(h4>ktNHQ^gEh1HUeBS+2L>|-gYHgr*c;G-x;k#{DHRWL6I(ow z`MlMlOKwCit#n~m$z3k~8?y}Iy{lam!snVv8b+6p4j=uQE+4-(Yq}?h+WmSmw33hx zS)A>Hd(3s^C2Y*XD;cv*(ZOwGr>Dq}v>>Wta4=PsAGhiEl*3@+g1*Bh^_{m-eFK=q%?Gi|IDF&(M@ zn^l8h&`Wq>wkTNhK>}9TTTpxfqTWm%F`Hz+$|jD9Pxm#cybR7*?XnW0&n^oE(Ht&(GrCndDjnKR|G?^IU&4P`_X)jE7p&l)D z!CgsRf#PgVdk@!l55@(uF-w+WyIVA+lcfeTyQ2bXq}Iu0jinM%{vUlUP?Mu7E0TV+ z**u}3>f#D*UWWr=;#3_uHF*n7orv-$I~n5rj;&0Xxht-2(G4p~Wb}K>R{T64{PJzW z`9(Y4yP^G$Diswz;`wXrOcY(okbO#cvEL#p?Diecrv_1>;eXb>$b3zqAr=CttOqHC z+N{Ni@E?wKD~`ViQo;c*H985}Qgjo7#Fk=Bj5a}MC|yi)efd&T&CUCB$;(lp;?8r7 z0Gbf%m?3xENgN568XPH(+RRIK#8YBV9H^3--Q2l{`_wVBhEP_@tj*MhYIYK&g%?}o zqS*7!)w1mcPQMhJ>M7n$Y-*#-FlT5gF7V~Is^2%=5ZCaTSzsg5$;TFow5 zj-eB7!$i7jd>=xX^d;AEvRkdw3L~+_aC(}lDdaupG#V|n?q2H%!;PuP2B>TdaiY94 zovX3Izf}mxhbfqPjrc`MRM7lUL#~TND@`P7OH5+jCI4?dSGS4lTk05Y?{K%2Dk)A+ zjS3Hf|1NuJEJdes>c)QjK1hh2on(JJK|reOYgc!uKs2<=@y$J}BEpL(5krnx*d$Fh zfi_E)$Z87p{1r`!3QcjmDw-4u>aJ3+LUo$b<=Y+c>c z6#fBV752_COyBcvVwCub1uTw6U-WOng(Wx=^#)(T1%-m@+aJUIYaOwcZLg}};pmK=%UbK@6{$4UD}ZIz;L`o<)5bk zkn8Wqc~R&;qe|SS3f2++XgJS*>2D^yim^UhC`@hWh~g}`Hq~I=#GzPm zI@WV5c#QhR5oaY%KXR#w+QbNpVkv-HEN|?#jtWoI(nl_Mp${C?xEGk2Eo&G>Q|wcL z3kZ_}vmHZ)RsZqsJ>>+7w+;muvP;$PReky!?px;wb8{P(hid+762}MH&)81t52~0c z8R8Kd@x((>o47w^@Ock$C_!?TtQ8f&)f!(NQZM=*BE((MSVHkfZDLX!Ctcm|3g}6# z=artwa*N_L0eSHRo49|!oWMwmXCW(8mLNkC>y@Q{>reeu!B0F)aXBnR$dr_#WAlVK zV;wi~&xwy^J?Gk@g*JH^Cr}5uA?uXTGDM}0 z==lpf8RbuPZUVJ0zFKRFT~z7h1x1l%JcNdn)H-?TLR7X-6YQV4;ju}r@nmO7_I}Cr zzefz~mo=HRB1dH4@LDM8ZFZ)tF!e!+<7CJ$6-2knM6$$mS>qa;tpC)&PH6F`X_UA2 zPyjpUjE6a6==$_FWX`4`L5S7PN-RwPVavOtWX z#kNMhAect^=cS+MHWcD8pa1<4{N6F^Yw0|7iYS>SC?_#XJ>2BGPKgS4L!r54qmQvZ z(T-f)pPs}pp~dynP5w}g@iu9-jgFm7HJcfZ*dS1Up9_V9XkQ$q*$rj9rN4~XOHKNH z4I4T^Pmw6`1$jw&p_DKqP*Z5pMy%zt zAKAQX(%#{|px+b2JmYrNU>biIF<&?YIn1EFXR8inb&E#t)Wv%pr+9wjTx-s=ePe8J zmQxeQd=#6w8e|R6Lc?PXr#{N?9@0*ij+V6L`CHViK!Z8HHMc^q%!M2IWiufIn`4>^ zFvPC_%i3k*Tb$xxR<6xWR-PO_iaBZXfTvr>op)_FgkHz6ZozPaFBUKgi>0|+b|-%k z#r!a&oYPg|U$R?x`wEckH{Cq98{V*@Dqzo>7#p`k6Z9)@d!D6yL zZwQ~GN!j|wRd2S{I295;vMDw_BGyrW6NJ5O948!EbH~(COcDx@bxW9^_0IJ-oK3o|Hi#PjkwAAW4`6j zc?&UTIde>#!TWC)3{a)67nd<##x@U(tRhRttS?g2S9R*R2N#mn7R0LXE7{&wxTFe0 z(wBds6WmNu>|3W`&MYhzlNygfO(*^cy8D@ISR;k7#3&}@UQcV&tseU1ZN8ZlK9TGi zt~{1Q4tl{(*s{Q{sJ|uGpEc;lVhu?QouCQ27fS<6emOvTWwv}T9L{RGZ;$#uT@_Hl^fgq^{BWjcEkyY-!XS z{hzs>f+sD&<|bzMl|`EE8_u0anRPLP7D&^~#N43I=PsdKjx-&m2OcSZ9 zl8K)Pi=hyj)t$gPPQ4eK(7Smz4W+m^ua6yU`{TKFAvV`v|J)TU7N0|r2{x|c884Jh zs|Ulq0*CtkZuz6;FL|eYWDH%96jM#0EqZ-oCewS#gbp`Y(TB~)aLVB!?p;pJq5|>v zeYrhlUpiXh61{j_LYuo?8z>C*>lZ#Ve^&&#~X(kd<#^HhRwVd#YJOz{qw7;}Ab=vxHAvuV@0I6nA z_He^mR9Z3^7QdU$X`y5(uknwFM@*J48-Rk7n(?Hd;`{VpnNa_EHg|l%@Nbx8j_apN znQ$u12eH@juNJ*+@~$T?aM1EyA#&x2>L<)wX{cPYc?vF;4!Ps+htJ9hKkv8+@A1UW z4(y;v{7c4mp=`f|$x7j`Y2e>g^s;6yw0wWF47X6gnvB$Y`$@a=?id_^R_0OuSXZvj z^3D{XJp0GoOzC;M{8%gt_^jnTwbe|Pwt6s3=I-U8;<+!#s-rVO1MuK1V(Q@-7IBF5-^TP%FD8i1c!dna&qhy2;|BIj1n0 zv8xQz?B!tIgMOvWiN)HETnIZBX2gve z#`!^LwWxw_#2?+ew2xWQ>291@M^-dk0p^UIr;i(M-ux5OB_)b&5C~@RyGkppw5+V2 zg?)O2WbB$rr0&#G%#cqydmtNa02eUl*&ydBp-*O`zgYx_4}J=&h@C*Xu+G8-=5dFX zweOz~yNA3&eSFru6qB~~DVEkz_rQfRv{h|yNZHq`8=_1hyK>g?#cfnc_q^B%2-k#q z%le}i;_Vpz5$4T}MV|p>E$9!1ps}BxQXnq$Be}_`e^u_$y^T-$3M(JlmQTjIcnOE$ zprFoMttdrDcjEJYI_e!_s;HeX}D`kfX0yXsp^ za6RV|tNaiDd1BNp{40*|3)zpfFW@-?PU=ccpZRK=c0Q34vaz-LhI52C$39_`$5%Q} zzjuZ7_52kS?+T-y`(?7*s2uTqIBcb&1dm;0H7WaHtQxl#_pNJ3O<-lRSvMD-g-?7c zf7w>X8E{?+3(L>K68b_H$BKwz+Bs;;$|3SsLs7!@ql6*XIz`8z>KE&I%tHp4Jw0q> z;~>X!rC#noSutWyX!@V)Wb7?GQ((^9{?cMaX=JzUExmW9G;dC_-lWGOcQ8BjY>@RR zK8^|RH@l-)$F2H@a*HYA=}^Sx!0am#nKi4UKv^6BD5d> zbYpQPkP~cIrJjYB3wh~1ER9^GaawIP@J8?EDEb$v0YYO#1CNQN*__UU)2}t^f7kbs zLWd`+SQ}jFi_6Kt4b2CeZctLyhn>Eu|H{BBkX$9W5m3{sdw3yljAxLLyhAEaWZeJN zgz-3n)a#yyWT-K?aR#Vsr&)?JL!?lNmXZ65K1XOFU!v<*#u1c#0|TYCZ`s%9OQ}YF z6FrignxJw>sjd}9W-N_hcEbk_>7k6Sasad`^^hgtZpw<8FiCp^|i9DC5(`UFy6*J1H>K+&h$fFlrgJj zJS>@RFWg#SgP#6J z_pnir4~!zS5+)pCzophP!b|9eo?!X%dN`6M)W?*nH>&~5*%$6EZT>ZA?g$?klQ1In zE)+0^bo}7r->nh}pH^TW3t=+&50qQ&D+0;AY!UzLER?0sI&QblNc-mQ{Gi?K?Up{% zr33!hk8&Sn^;=IBrm zp=JT}euwZfhyUEe8;5bY41LA2)5<7&pW~WP_=RGXA(&p->7X~RiuuP&Rf;dZO|*NP z_AcXX&Dje|r=TfmD~Ef{E}3NsCV8g!&C2IFcOtUV(^6YXC2uGmJUSa)+}^32lA4^h zcn9io$;;hd1*S4_FQx3Xc1qP*b+|mCb~GhpcYf-~_cLbV$;saxZnzkNfIPdqaQ9vW_I;Dtfgy?H)Xc2YCtvA8#ecQ8U;nMpX(Biqa{HL<`4@;T)6AsQ zch;}m3Qm+ViL}E$>w@1b#LyC_ugiZ{&U*dc*7br|5oc9UPN|*HnUzkmyI}eZevFW@ z#O4z!AS?9coe35_J=^9S6s@g_c@$tX`DXlyLye2uEtO&w!eaBa=YnSl(jubsvNw{= zY3m0)o)dkgBXZ|T&rG0CO z$&W$&>QugWude5q6Zt$jcyd1Ez4BX&$&omr;@AV4iKd4pp5QX%TKSyPU8M5wo_mPZIf@vdgBS5_cT;wblV_L_o0#qojf zJ$eR4jsH%2zH2*4z7;i>;raOV$JsWq*^wqi1wBn|_^Gy26-Jpc`6Ksdu2ofK#0WMc z1{CEUA{|RDL_`c?*GYevFT0fXy_oqksT?A_+RUE+aq_CY$Va_5bu|l1x#LQiFaz)S zVT8*=LZQ6?&cNfZ^%co}U0Y`M=C0gGu}V&n{leeWI_DU|)gvsC z#815nqP0;O=OF@1KPmT%9zOUSBy{M!H2JkfWX!ean>l7RDcm;E{engp>)g9;WXhi3 zNCDq`l}XYp|GcNp6$GtT>K{YU@rjPmQ5*9AGhng1P9ZxT|9 zm4DDJ{8{N*$No{@WGff>pyItY^Oz&4PnO=tMc#Hmyh_!Xlt~dgWPZT_o+5U&iy)?b zY|>?{L`o3Xr8{;q>8<(QSIVCuzA^KcZ34T$<$4#2SD6$D|9G3Km=aLr^@9=BsH9oa zb+fVD>iM}@^Gp6qyNAZBZY!wr;B^M9>vMyL8Sh<`;t9VxuM-4=X+;Ly*1hEq3g&8< z{pX?Be>m$phv0x3^_UbBp?#;ccSmuihK)|1w3t7Xk@D%5;P?H9#r{1E>i?QN_N;%& zFRUWszr=KewM|M`<@--zQSY6zjXOwx_c?@`1^3)Oj) zU1e5%L5=Q=#v`nY#QF=$uT9UrH__p|y*T}t{UH#)1jyo4<@^#AOO?Vf(C zAcFqE@Qk5%r|0r9z+cLsjd6XoKMTZ{^s>_RS=n{5%0i%9C5$&X2E}}52B|R=7pZq zNhJ%Xb}9~Q;sgu*lg?4DyPq$r_a2C?3%>g<>~TD>=tVChR* zBAgi3YrlDtXuE#nhV{SKJ>Meo-hQOBqUn|v7{0t@O5VGI{!^(BMn+urTSl+?Ie)d% zZqRed6;!7Q@G*}*s+j*^a{^*lJ+2u3_tt8IlMXhd;-@=x_gl+F?BmyMDMKc8x+m{7 zdffGBnIuUTr0l6Qe&?1SL|wA}a-0M|C+U+L+#;c4{k*k9*XhRKFYVi@k{KTGi)wGv z&g}Z)^Zs^*H~m?fcV*~L-(`pe+Di4|Tf6t58(5kZ3|&ZZyzxcCto5Gg#_uKxmkv#9 z*SQf1-s@=fpBy*b2Ihf8zlxMO$FA@3$i_Y2vWE|6CA+_wG}D^3^leLzZ+Ts+sEU${ z%7aky2UfpizZoA)QB3IQ?Ed#-am_u`qwiXyVxb|4RQZ5B(f@&S?bE*d`%Eg69$ztg zSaYG#iT|^E2;R|4>V#0)cTvKc@+X28di0~E58+{EOAA%MW<=LkVj?$q%%g3z z@EJbLvxEdIw$OaD>GJDM(&YfecfA{(LodskN4%}Ab=;Efx#MZp2Za#wIr;M=R-+Qf zKPG7}JR!9<&ydL6ao>#rp;?*wXr|rtffL(apgNumfrl$#`9kz7O+aUpFVU~@qB$ZNgLYTf&|OjQ9VYF)yO>Ea&O-+Z$(uX8^=n^-gJbp^8VSF`MY7$xmyvr zjO7`Z2Ua$ zvin<~QAG3ZAM`7R^}lY}81d!w@@?tB6jK&DEk{GHcH8Rv+)B5Z+qh8jAKjSwGb)H! zSeCQEy{%Yi)?^||FJW0L)vt^+S=BwCR#kb!%^jcoEv9@`GsFGdy5v`M){mZRQ=6$e zQ6dS>^fxD?z|XJUhiB{#!z_xA6wLEV{!RSBX#PBNjGP%d@R(`+&A7^EfwK25s>xSm zN6c-G6JoSwqfc|GB5W^#^Ot6c^l;Ql&01Ct=@t|2@7jO<`=9ae$}N9B^D1KXyt4Zz zogZ|kI>HNowGZlCyh+#U2{QY4<7T434RK(ZgC`|EN}!0(eBL;jxU>u&M2 zf+;#DJNwe3@}J%OGLFB_9~WJNJ(Wa} z2c7G*#^Y$F8{f*$ChV&~k6z<&=KRY0Lv2Yc$5Vaze~;W;y}_^_*UHE{CHEq0=edgo zs%xnXO;Jkeez)9-tcc}}?^tO`oR6KZ$r0<*jAu!Gf0iH*Kh+}Irq`Fn6!FKQCeKFC*%#ZWLtVcMvD>wIqZ~;S+Fk$KnUb8lCUHrO)@yS|r;IFJOsa4#g*UyLwqhg7=>N>ARY^~epi6z!f_tGpt7 zYuT%QOJC)TI;P$?H8e|MVDY7i&r)vJ#d}`L%diRZfw@$VYbuJ0vXdCi68V6nfs;AN zaLLJ4g7@T9FZP)V;qSH2H9z{3FNj0_X0lSAF&lP;tiI^0dlF2@4?PsJhvmKVObmte zxVt*XRDdYnpf|Yw^>uYvclY_LpZmoAeT-f$o9Rox%hDk0B)vN$o2mSb_`>WR;XQTE z+ug@U1q#)Zw`QLwR#a-ANxcsxh3?kr+SD$4aL>}rJyQL9Lc2ma{({oOu5wWICIOP6 z>BlD&gro6WBD3x5F#>*(FK#lg7?V%l8u+`>{77?1H!#^9hRw>v>LB7D+v=)6uJDyd zljirBbz73?6;Ja=&Z#_zqDB~~!t)=SMee%R`22a}l15PBlVE)!w8Mv1lHhc}bt8UA z&(`joRNcqpDXXHtueLeo^&QD`arqq6`9zJZ>|tY{%_ z!YFh9!N&gIRILn60mexmQ4)b2)UDr0poF4IJ)o*fNd-tBIrs5dhux!#+*E(d=W zo3$i4GL|cHU#%eCB>67qnfWe5XKSPAU4(flr#KB(UgO}i=3e!~d1fXr=k>}_MW446 z2k@vH#7iIUvkq9e-z0KXa~jKz?RR$|azEVPI)3- zb1J9aFQ@Ktcm6una(p@XskLIxtb^%+9zmL`P|s~lb-2)XTYT%mPkUSkh5B<{u^09h z9C-TeZa~aVht7lEG2#~xiQJxg!|X>NEYB#*3U+<)G;EeDFX&;Z+H|GVKTUNDzT#LZ z{M0gI2jp3aW25+B;PK1u2W#(Ry3#IvKo8PoKZg_{oxXf7E3#1&;`6$|N8WwSLV>U2Wa(^1 zXpyGlMO%w9WfFeFe?~l_#4K{zWyGAMX$fP?}|uvG|0dR!fmasWH59 ztNS@_MJfkBrcq^cSE<<2(xWipre{lUw>!%JakvNOl=+`)Z~cyvH!pW7Pgi6Q3@n@} z>77_OF&cAF|EI2TzsK3%wl-v&-s#TwgF*jQl?U6@6-`c~%F7B9k4qQVKS*F_elBhv zsoYI#CZ1JnT|l+i@LvwH@E+zi?`3(W3&iLKEH}RA;HCOSlpu%vzA%5}YTmf#{DP|2 zYcqy_YMjw~m2H4rD|wQ2s^oUtW`a}G%&O=&<%7Y`G;fvPHD+pFFCYB19yhoZd(}wr zF!`QGdEb2;2iY8l4Iaj~828IQN;src889lTSc2L|42jjvHR^BMr#YPOX{&MlSlx5~ zQyIij=c*%0qls0mw)=i=$(Z>`>FNLcvEcBR;cEWo`2F!a+<=qbpR_D{-VXhUs0#swM1cB2bD(fyz`AQm7dPBj%^xwc}ta_ zt=yE@sS6oH7t8;O zgxgP}AGU?Q?=!Z`IF{~dcP_kS=50GS>%>yZe>`N1^R!Jui@$E{d*{+Cg0&|zu+cB( zG!82zipm5Y99oZKY90n*WV_?mzGbP`r^Q+7369Ee#v#Y#Ro z#b{5taCdh(J^HZar@eZ5vF|-)En4uV8A9c4UB@V^2VFEaL|(fpocEG1Nj`I1$8;#PU*JPubMZ;S1_P@HAI-4?N-nq*B_8#@77#op^SUBq{FrN( z2o67YsWvJTJP)zD%Hwc&!^q9NC~>*=@J&qBrqO?G^;>y&?VAmtU%4-{JSMIN_YA_H z9k2;ZlBsMNoVVOJ|EFyGR{bw6>5GR7eOs>WcfX?hurQ1(_a5QKV#gKNmrOpu!pCYN z{4i}?>%r$z+%a`U+DdXsQ zMtX5LB=U|~aG4X~@uEdlop2?LsC#3ptWUP7i1g8935kXVC}>W9l9}rlQ*^_nBLl)? zk38|ikhh)|O@0*6p$nIH2huEUA!UcJV#xQPgK39W>50;bT+3G*H_5@OmXRQJ#`pIv zwVMwX>n&C1QJM6uyNT5_?GZYyGApojwYfC8q6K{aTWMZJ9JnXnBwJ&D%)I3E4j!ti zQwpfZdT>@2td_YtZ3Q}47OuO5(#vwLLVTttCKi_5<>9r~VXf7a?_-PZ!t!CibntQS z=HBbkw~DNt#wjj~-Gle44BEJ6mW|?p?BSZ+iujF#ZQKKvUu{=9AQh=r?ACU}~1JFmw)&y=bNB*i zdqYX{|5$RLZCZc|E2c7D7^`w6yk$wm!- z58p=$pLULyKV0e%s!O@vO0JGQFo;;)hC2ydUDED7RXp4?&$m_fz(__QhDK)jvZYA!#41Ixrt9M>*Sy zJ+a~xDn$`*CCab3u+^t`wn7de9NF5_Ct5u$f9WeY;-o2Rt*pbP4?+hWw-VhUi?~6B z_OSTC6DuybZ^9!4=G_{v7nEO>Zz1t{HFWjxcOGz3Z~sf0(xP#}suNpcI=q#5JnJV@ zW+=QB?@uBy-N1qI&GB;*kZQVY@8$FJsWy^F_?MtPatJdiVPSQ;N+HEaTm80t4OpEsL`VQVJ`4O+lyKsS+m3aCW8xY6R%UXuq69CYn)b9iJ@f`h`hYi_L>56f z>c^m8P)2#LIPrmC8Ct8tq8}nK+>-;U<*-8 z=Y6L7=7YE{09ho(7`czta$Ap(Hd5Jc&nZWL=~2S z-bZ@p#Z}=#KsmTr=ncy1qF7KMz<1j|4;Em5GBtpDR{fS;*s7p(P{-}t(aIGlPW$>G zFa!Y>;nS^HO5XMXX_SCoBmmRI4*};Sc)u!m&`N|a*eL`6Q}vq=ZH1ncxgRRCUCKV- z^oi+r@%ZcGy4lpg7@&%);{@h4fKzV$abPSFM3&GENN+ReTyKTSd1XFeopf(&L&F9b z>f!PLGhes51FEpBQK+N-1c>Fnd)^xgP!(n|R0?zg0gyIto7ERk1#W!cN&BD7Tflhq zEnrRlP?gzy=mD^5yGX!C_@b@I#{lweJ_TMRt8%}C1K|U&IJ`OBwk^XLmIU^O{&R{S zz@qdNFqP}YmcT?TSgCPiJ$P*sGvf-JTxA z>mvUHx-bB`fFppds+ef;|L+k2%xbe^mt26a#rSSxAXr!uXko{IUWwb?>r)8tC)1_? z*~-)c88B+;dRWOPo6W#o)H|Sn2|zjQ38;~wiOnPmVuB5{18RhMq`6p97at3X{65$= z^aGSs{L(&E@U%~|3Refn4C4*r>>hf6G0hA-13K0PK$H55JeB$gU@ZMbvPyj#T7m=> zDSg1^2M?9#!WRI+&Dy}_>t#2tqkhzOT^^l*lkD<2YONelzF5=of?}#sbJ+h&8!h%t z{yD`ZKl}wH6SM;O6sU$$knE7bWxDYkP6QzPbQ{_K02;fS4daQ|L0wh=$cSbDGEND{ ze;B+af6y<=qjvR&pC)A&e+!c(X@)1!awSU97K04+`h=xx4&%vJ zNv|oK+wiB9KMERV5?F5DKcjeZzz4Pq8{v*os^a;_!b#u3AB>Udt2s>d`jiD((lYWY zrL>fKxInfYEi^)M!euNNtJ@z!Q1_7T+=fR|rj@>dPBiBCfvN75`3BTIRFxy$~x~Sv5fjHmFDba-KAtER zi)VbMC#u>98O&e|GqvH@C@wg)=xG8PQ6SreKASjAV4A*#?29)xhkaDZGNP%ALvU9% z2~3RwWHXww2Y4#o?u-RVZ+Y<`-}5f|ReL}naT84SEFa|-{Oj%^juEi=KndjKSgMI;|3m%UQdIGY! zb`%^E&FDqW;~42KIIeyh6U<&sBn@T0stNUI{{whA`J4>ssNUa z4X#iU|7@OmOL!fhtiPQfm?!;!Sg<7$7p_vs%lcQr1x9JcWe>^OL;aYf|JyJ)5r#%oP`%V50rRM-h-}?bVgH-RA#*>gm zEX%9d*CYYP9()5reKPXpGvyp;x!RP_%k9L3xD zoA*!`zEXmZw@v=TCZG?Eh;*U7M1b|M364A|dlYz|9G$?Zt&|!8!qD5)-`NH76pAI- zv^t%IImaXCO7P>vI~qI{?#FaqeDWlMg6eLK)8nbw2SGvqXmjNq?LyDv!Gike1$h;( z?Tc^+P&O^k93U65Af~#4$k~jh(Bb9)^Q>*SlELm3lWb68Z?}b!_J`f~q!5~b4thdv2Z zBOS_#J9=EtmBW2!TUc0;980St&nPv%5(q# zGhdXjYqI+SpbFnP!FwF?{w7;O_9|UWRc0UtNHhi{X`*Mr4hsFn^=a+c19XDCy7@Ss zHTHa(n6^x4&$lWD9^IVy%EqG8sDxl#f!(X zpU=v+TEx0?UDzrEP%@qPA0XdT7bGuJojQxvim%-yped$+la)L==y%nx*NHvhPqG0u zL^+H)nj;0a>UV%P>zfQ%!Td^qGdvVP&d%W4$aoGk-e$o)MxqHS@WvL{C*9$1DAOL` zEb$`uin^DbF_8Bgz+skJEQmuko31X-urmc{$c_L3wHyYJcus(}CbnG>0B!WjNpQ** zbPk!C)M=s_*%Wqlo3rtoN)wfA})dZlHc(ES24Hpi)0>H zeTiG*JpLOT0e+z_xbw*X*=#9{7hyn@N7v=`XJW(|#W|Z;%3^z#t35m&2x(xu8Gktj zOe3;4m7WgCnt+Nnx{ZH9>EQzbT>{XGxooTQ6TKsd(_79}t0!dgKrJDt7=gjnOmOod zFuh&y793Z5>?p%`1%%bJt)XZOj!>(j8c@Ni87&UYlGr{sn8$&TRDBh=eN1Xh~_xF^G+Z|RrpX1ZYNe19x-Ym#Ejn~9a6R(k-wzZ>Z4D^P`-Rh0EvbzDO zDXZnGWrgenLLq|tJ8#(v+3Dq*;YYn$+qoj=U>G3!Gr;8hHrWIqE!a3{Ku0#%4+gCM z*s}uND!%{3T#qp3M+&mlram=LBT&2S_uz!a@(<0Gw+?x>e!!lsCPrMtKWYfcTe zLqgPZQ=XC79h3Xehr&w7y>t&SZKlNdp#qbIM~C^@qWy{b$7Xpu68B82NP_PTt$leLtu`G}kNq1t2W2UGon3w;-z@(T1cL$z-Ss+|z z6cT!P6v9^M#7vp?ginR3aNB>Y3}8$en5frE(( zk^_4lf!TB5RT`X?1?)mWirbMu4OzVXR3dPJm}c&-2iSx|fJP32aqk$u0n@_dN4}(E z_fr1?lW>4il_PftDsht^cjP5|Y)%8xh=usM^AhtW;j0cF1 z2nbv?W<}y7DFQN2DLk>(L#?uCE8q&eGK)bF+aM2ZvvZ#v3EaU&W_>{h@F{=^h&S{E zaHkB^O9jiYj_gQeBE64M?+Fv43ZM@GtOSAks~MPxZPg?Kc&&g_;}0CopKK2>BL~7* z1u7W=Xd>DGq6u_h=d-f0Zhx&T$nJ97DXdw{dOz~C9MEdUH(ah{DMOa|nB zU=)Ir0W)IVbp{v^AXhOErZI`TlW7kO>XzdV`~wYwZ3*5u9>X`F+9-l-H}GZ?fMWunsO{y} zI8I8FF;h>0kg?nPj|K(46X3rGaNY)%p?bN$RG>{vepC#dpSWEOhd`P83BH~D zdmQc=Vd&o>aIEudPUO%Y8Gd~}=FKVp2!PA(tR4D?(L2yP#dQVI24ApzIM|xdlyC%@ z54AT`b?r)nVS^Muly7nuT6OL0RAGenZhJnQ#9Bo|IzMzb?3nJOQ)@?W;)T#AQ!@>= zJ4<&=Zue!+2rE96AX|Lx{9N0)spV|$zA5PlTiItp#tp9<^mZolO-i7preNTo9q93^ z`}OyrwWkat0|izDCi&5PYrYWz5m>>{qifWNydA6i^!d@ysUHm?{74}jWbNQueM4M? ziy`kQ|Ed7ZYG>k8oYGDie%cVbYVwwJnNr8EMiSuD?QcU^19XRsaOkcz@u^dhklnET z)w0#HAfyXZJEw9Z34AgT{oPFQDT#(QKEiI;0p|TFQe;Vvs5Qv7b%j-@9 z^C#!Xn)OYC{me%IL!{8S0Q>M%Zv%9<4F54WTuYQW)4*v+ij?1h*eSCkYd-);r@Zx5L)dMId+pd13$R_ftNtKUb!xMrFhXnxd?)T;b%lJV*v^-`!sP((agkL!>vvT{ zn0LUn5h<*{hpE{R&4)i)Ez9(85Q#uS^mpj*0^xiD;RLp_yrw!nge$K}ML_q2p8|xX zM~LmjO8^DgMwIf|@51e3`b>F5688gmJR7w6@X~0BHNA*re!K{X=STx%Cv=bfKDP2y zTLe)U;By_|L*yUdI@`Ir``A7+je|R3>&v#$m_q=mvIec8<<-jo# zF9E@oTaIYJ3xc4wm`Z|ax%+{a%lkEmck@|8ah)5MX9*XXa%%0+miWJyX0EJTI0fmwT5hcQf+6D?`4GIMbgF=~(l}1tp zL7{>`p@@hqA@&8(aYcjzFLr0B*fJp!9JsdBZ{HkfxDbis1Jya*a3M-jpk8dV0t}KO zkBbQV(DHWBEh-;Ze%WG-%!d?U?>B|EaQS+XJZ!VEez3uckDVVw@+IgwyWbv@~FJB+SfyK|>4Q2@k zW(m0iEHxrnYDm7?E&BCtr4pe#z$wv(m%O!BV)^)3SyT#NBEp5IRs^(d9?Z7FHn16? zf!hH=EN>_uW@4`AnEzI=@hO8@lI8Q~tK9~gb_lGsblyasQDLw_bVRYDDiB$S+5^jo zWqUA6{yU8M!LB9UFa%cqD7^9)!BPuBfO%F1J<9~64YoC42VAVw!SSc&2A7Zem?2tg z1ONp9kiM}6vGAqrHaG@Sz$J(J6r2Dx>rb*AQ#ZhYZd8`87^(<(5n!9&XkvrwCD29! z1>!d>a``IY@PQK-F_8-KDuOFMW+z~M1BPS3)kiTF08#*;17*<`;E4wiVt{J~;!u3V z5FJhghXfID#(~|_0HXy~dj{0xfFulv2XM)f(@(*F8sJQX6$3DQBvkl4ge(G!8LLV zAaY>`AVTgwY?ff?ao}Y)U>5+C0wS^oiDxB%P@gb}$aZiB;lsxOiVxK0AP`lB&9*QU zLnQ#g4|Gc5!yV8g{eX|e;365O5Al(J`B6mkuNz~qh!7Cb0I^{Y0G$H>Ai#tUAbfx| z6et1P5F~Bk_XC_NpRAwK{u*$R>f1R+;|;D~U(i$EAW z9Y+wW0)$^YkKq}E!~CBK!`Y7jw!=7El&t`iHee-DfO23IOaUqupCiCU08K&Q00{zM zy8*dGkP~h<$a)*#v;cERP!!A#K&Tvph+F9@urO#V+Y1Q$0D=Gt#}x*APnZL0#ts7< zjWOW&EchoExI=-w>lJ|SU#ZX^kp=Nn4Ja^^+#^6~2h0W*>cv0_LB3J`&47S=JP$Z< zrZ~`o&2&J($9{iUR2~3MsSxThLj*W50&a=%z^yzWrhr@sNRA8x&H$hS0;dQR1OW#L z=E5Zkq$3JECjxWS9}LCK7MKIa1J|Df(18YkngV4OFpUH0vxNYG0$YbW+zAVz>= zX{106s<22r1Gl%G2ro0ZMQ|0(0ACSI238mVA;19+w22G%6c0F1955pZ#B!FoVE+Ut z3YbxZXHymsWI#Y5Otv);!Tke;+yYR)O|Hgr5-Gj#`#{}Vj4WppbN;;YpJ7a6^8RIraXk{~|+SePLUP8!pjCP&BA zB2#$%w_%jQPW3CY;u}yO`bSZWtY`tER7CBrP%}1Lbh#5O4eLj>hCIVD49G4u1XOBt z4;V2$klzSMb_1Sa5wLOpKigETB*>g+XT|QZI#>=?1j&XXfubhJo&~Z`{DEZ?kkNVfZjKPg|q&MmgTB@qfd#C7)_1}qy`7O*oxbq#@m;7dT~Ixs>9qMjg zR-XZ|I}F1L=KvuN2s}uIlMH0?VRs<!#qh@6iMstEK&HQbuU+18%RF~%{+88!=g&cNn>ALW$WPaw6 zg_)tD-7GpGD?2#CtmW`XLl@_j-^`4@%2;9jMkU6+5&tifEdv*umu=- z3P24|_J|h%*aip{Adv+x$1kf;xPu@tYYp#DpkKl8Fna-!d|)|C35etYz!3nR0H}wT z`2pA(2s$DSaDIUbsa$}FLHFRnw*}7N8svkbSb>El51g97OVb!Iq=6p1X`x`N^+5V4 z0O6Ei%bhQ{ib40_!F~k9;BAQlP<4>3^C2J(2d)ZqH9&3Z;M&*$DFPrO;3@Tit%8J^ z=vnBpLkv)c8IU zi8^c?9@8421aEN>iGT=)Ex?|zK)Vn)Lc)7Ae0hQw5E7J>=>|B7V3M)6OsKf<0xSb| zT_(H^d|(1(&ol>wHK-95o|9{Un1?yw!ozd~1PSK20FDrd3YE-NynhegHdBBM0Th+< z1rQE^AcD&rIvNlIfPj;%GY3kyfCVR*3x*P12)KGMahQXgoI4I!L$EAtZ}0)R|pSt;B6@da75wd4VuYRorMNUNk3XqI2QH zfEO?aHm_Hv${grt-?|{rBgkSPU{xX4#}J*~T_(qQ*zmc!s;(eBUa#W_^qQm&aTVsyO1oV@kRKH zC%O4}T!GupbB)i6dagF@Wm&D?etze#@`d%vHov3pAIOeNCX_mo2{l54OlE5`YwJc> z2Kb;XiZR82WU?VUh<$vaYhCO5n{xcW<6k+#DY=W*4xfyCkxk@o04D%=1;F9I*R>YR zhe!eZKtUC77S00V08I1%u}47cBM@`QS@f(l1j;(MS^h`^4h! zJr@wVfVc+}Fh?B_Yk(-R1~&PCJjaVA?ROp!%7a|l?ILd%J@uah56!>>4wexIGSNW6 z&jJuyfUpD{y?kJbADB`D+9G*?*aL`S*wpDEobxwdFV-IRkru52@sb4ZQ}YEotq}SO zV;zVV9yy@^;f5}R8IK%KfPO<0Vo5aMP=gYpf>(d5D=spEr$peBN<%J>y1*x`h6Ds| z?nARb0=qpxpkWq~&zr#;u&ZGkqJ^(kdQ3mkohN}uUuNu3q%uN8FjT66!z044zh%rG zA;_~J`bndq53#?;=aHiu`z3NV@du51l}DR6OQcRvEtX~AKM=(jz|y; z)oQqlXyKLP3(#)3j4(sUi7X$BWbw&u57^pJj1b}dqv(o?EaX|(7T^{6jAudklX3%o zFq$j4dALCuk?C%SwqasrXSuP-omJ2D56fY6s4b3<$h>hB)g8R^6$ zx8)PEp&sGD_eXrJ8zIT}N7~ga5?RK_5nZ;4)IwMZ>hBrb9hrpq|1CL_XBF9C&C`j{ zmmjl@v_V+$>hp|+M(Xj&2?iW(&_tN=$?*qlY50c_<*P(CyhFqwhPRLHjpXpG^H<6= zWFb-nDy14a5k|c10<{@jB%U{eC%~|w0FjT#*b>0oKtuQo=!=Y9jdVvO2xakxi*YFw9f{@!0u)9GF5yNLJJjO-D@XGN9s76L3)&>7aj(H=(d9TZi-9Q-e zEo@!R@Bh!np!h!u^6XFT_=@dK!UWm=T#^>~7Ca`korA#kZOIrDZ5 z*XRiJte*G;Lk>~k=3gmqV>hmDl%C5Yk}0}>74@83MO0(ee_PZ?+H_{}Oq%{APq3_4 zMNi^%$EYmu@1w7JXHCIJ3E%u1dulCzJS{y`pRxZ<`^I~7Qc&Q|oP-$%g*@q8 zRyIq3VSKF5QYdI^R@W~(8HS;X${%*?O{+C6b13Rawp zcCjyiJ(kots}Qs(A@j%i-&9iSJ)1%1eihG#$T@Wnm5IdX4LnD%nVQHmB+D~YuGT5S zjywvz*Op9c-Kbh@l)I=UP-WqO5;N`SXn8N7xb4E3!2K_`-IZI}$+5ER2{tj)vo*$FO236=Ma@9y)x0%F4 zzl`y_UwitAzc!an&Xx6a-1>Pn`)K-3j^Bl*(%?0pp|};Df=#C5$^o++rB43AaY(Qg z+AtSBN8Z{HPfKbx{*j4pm)E(y-~UofbJ0m;{dd%f0VUtGC=Cf?KFEOCMS6%`X|}xA z(m{JEGMel(SXCHIk?@)?6Z~3?tu5}Hd3$Ms7jkBhKef;1Ln{j}b0kBm62O zN-E{~1B`}q<*m=>vmXwPSqvUid0wWp#6P!t)vmosUT2He{U#HexgD}omGx4ID{G2> zW(HqAD#!`nH8E#1iF<*!4sc@VN?9&O~84h}_#De|fs8OdD z;u+I}!QscD?tC$Kqd95!OR?eKP8~BiS2CyH4G+!%=Ab#bv#358Rd44n7bJ4;5Pz^UtpDO}~I*3HT1a z4k_|7Ixwh>9M#slQ&!~FtMYF>*StkBb}*!}I)PiI6~*0POS3|(rQ$7jDI07U9$@TI zalCXq567=WH0<+bh8NVFxqW{+>$3vouK@jP0G)(C}}`_TM1(Lp80)S^o+tBH>uQ%f{{f35ni z+6C8=i@%;);7~~=#ygoc-sKF5-^&r#@wASxqH&{rnY4KG989JGxe@=Z;=ywbY(nGQ z<^pTycg1)El2xMgvoWW*iC=}u?kVYSwtjbfdSV7sF;@SHh_~(f7j&5K&#we@oOR&A zijmC=FuklOk}_4^r-+kM^NefX%` z)~ZpCF{F=zk)-$4aU@>w^GRsSe{}gNn;!^#VaOxQ;~CmvUPkSTJ7(qDa@G4~$25!0 zqg8I{)>@j18;{X+azsPEC`D^dY$AxB-I#xDDv6B1n}j^Xlr!d+!y-hNtFFe-!d9QR zupIW7CaH^?x)X+`Z7#RByl=_ZnCwZV&wgjv*1cU0yZ3att@>6v>A}$W+BH5C7Ex$( z;X}tFGMbfR`^Z}HXMQ@5Y1j`;xn1u+y2+$X0==M#kZ5qfl;7_VM#jc;ZO3w0vif9_?a3JHuvQgGip>Lh!N;PM_wtfk@$nA6 z^x6H>J@$zt_E03L^;#UMmxbY07B3$*V_@7Ptye5*=s_C|ZZu}8Z<0nfX{L;MJR;T7 zAClr!%Nf05^x47|N{UmYwNa<%UP|d|Y@>?g6dm=^*VM;Q&wQ7sXpiSHw)8psJHI4o>P-WqjjCgvhV^d+#{6LQ}JZ zmfWng#)Xxb^Jh3D?wz(Fe0pKHv|C9A zJ9^%q z`Et5*P|xn!^vu28f*F1L^PU}f>g5slJR;64(e4=XG`GMZYGvbz4#xLS~=6xj8QfFq1| zjciGL;hJVDv;Ahnm~MuC!PkHJ`@0`Ud7 zX{+mFY|z{fnawbvhf!;gqY}OoEXS;vd7O1Um)Jf*ohVY_OKfFDwD?Z>DCTZuoVUBP zfhwSXf=ok?xu~buar9_X6A~MGQ~h(##fapK?f%bsuoIo%Hs7jJ^w=+B$qbt~d``Q@ zzRbf$vqiMcF_KpH=9ra7^m;l*V$lD3*f}(GwwNRGrzN%G;`?@#;#XfH$$Ea!|J>ai zI`J_zJrKi{Tpr2%J`FVmbFGhSL-TZJhqi;{>1m@sxkl$XSGG>MWCXffRrTMz@_`@03!E8gSE?$}gT054N73`F52i##i*{4c(p(Ap3inkels=U~oW=3B?fF!M{6hPk8y zie&lywxknZ+q(jHuTuxbPniVG(n@>jbB8~8VjQy|gTlVj!xbBTg7KsQgSKik_v-g` zbj{r1%F)i2g4ZU6F8&+F9k-VZPk2fE?hc;P<~s%+1d)I9T~>vVY&_1&dmMk*r=DEi1WLTf8tvAPeK;7HOT8#gy4cF1NpPKs66op zgXliaQFa(we=wn0R(BnGObf?upUh7o89$xhf&t2F(mn} zsqimjo_$35==m1wbTzO@~v~^J!8O+ z;$j(hUqesw8Hs%5i{W$RQ>IQCJ9;6xzFw%3#>C%z6`|rXxrU?#a==H1prA>uIoz(Z zwD7y0b{<# z^qE;axNTqED9&RDFKi+_@kk=Wlaw=uX}Irkw0`7V^EiE^dHfN-;3HB6W{oci<~9tI6ck! zH4#7icOmi;3Bkv1K5)AqmqA`8+Oe1Re_B(VN-6y{#`GsXCui3Rtl$N87^G9iP}=QB z?+uP?1b&Vv5pv?f`DavDi1L>Wh1ghYy-T6 z3pGXg8TCG_Hao`oR}>fH^A0}mnB@Abd*(G| zUoYt1>9sZ4eI{P`M7*%D2{>h2qbpATsXu++aIs0+h;HJ68zK}>L3Xd?7y*|~XXyo} z#i4Bd8f&&{$x(5+UPVbCKX0s0A4*ipE}wq*ZvI^!^Icx|8&UgZr8@El?dl+hf*~0L zsODtP!mirCd`IU@O3bO{LW|+qF7=kLAaZUSg!@5A#8jew5k+4eRU@`+KUO#z2 zNzYY;re{;Jl|fMbK*yAx^e+ugANOr+yy|n#;7fn|@Q>P9os?aVFZg~!eYOeIXf4+N z-5hbPkapxz=(e=u3H^Q&%$`2z?=Noe(51(#Z2RM{8*hG-uQ0fMJ+J1chu_FyPs`80 zFztbPE;X;zy*DMj&SsW1qLuvTWMAEXf1yI}>EcO0QmH6@K*8vDmQj`OSIWAGTlo6% z8ip5tG47gsk%_wfV2&}4@ols^!svt3#Qunivo=t2`T(-6y{+93n~-YcI=$m>EN&pM z5fhXlM(p*<`R!uQDQp@DMEcI%s>JsrCCSiG$zSX6mOK?t3$4W0dAG?P^8(HhxtL~p zVv623^h5dexWE-%H}2gt8K-I{j-RUO@OI~}j-cPwn~>*cR9UQ#>2Haomax|&c_kGd z_bZKFFAr7!lpH>^KN0rHei;4ItHupAP z201A(@bG?ue^)29CFRh?81(}eSp@AHX6p07EtKYp^0hmkc;*;7`LP4yuNifFwqIzM z{A|ol(KHb(*)xzcL$jHK27KnAQfcDf^uGDEze0{2yFUe+Zp00r^ ztV*GcrCL@Q7!4o%u4;VnbZO}3U6X8`pUAu;Om!}9>)mbR;r-^famS9?1&gs0cC@ja z6bs`SzdHV+@#Q}6?k6;h^@(v})oQ7tWdG+Q-@$I+f%F$bLSxp0Uwn+N{_-pC{wi#A zJ!J6sZrRQkB;@9WWZYn03XZp!c6G_v#izF_|#H6nk^8eNJA4E@2Ix?O1|}cG62Bx$xS`U4s+lA#q;aGOFwPNq7A= z1dE~TcZL+mYLY9y+~GXrG>3Sl2g>k$s?*5bNbukw@$1mOXpY9TtZTlOi_Uz?3*5 zCS8~fb$eq)WLXE{<71R*C*kPWKob8$TF^G4nvgJUe*g3aNj#di);slvNy16BX%=pw z={))A!q-)Y5_%Czd^X#Qm0Dv3Ev8l^Ze~SPq#yTf#wZLr}uCqjKbEMcEBvVah4U zX!d}6jq9V|PED+Y!HbU3gwGODonV zg@z`~7ICAl6e7X#riu3*wru|p$I1KiK?sVY1v=)H=#9}KVMBH)sB|u=$tSc$K(;-UGF! zPZk$mS`3{-Bgm$hx{XLN+yHb_%W3$$&ebbf`jfeE(*Z&ch0;}eOV=a#=E+Fyc~qzW=BaxT zLPCuzUC(!p9+rrd#QHnxKjnOaI}j?CX*hm5i)LMN-6kv zxY3~fGLW^_CCKo?2Xg-qnnsqBf;^TtsiIu=8R2Kp|2lugN~{!w4S~RNXgJYIh;>?L zbT}ssVr4Rk1p*v=D#~++am0X|Ui=gSU8nP}A&GO2m z^%?K`>yh^qg2M-X=X96MrfMys7+j9;2=wD(9|zTWc?8#T6AjHyv~fa4`|5CN&seJH z;?&b?G9BYfk0;dDR2|Ynt-@#kkKhB#E*UdiOp) zC;#**XUJ=x#y<0>amcs#ApLbq-dw@P3$KK0pRGj}v{>KcK6MP@nj0#oX-Q%~p6kgfl6CXp zn0kMCZtY@XYLwrwNfk&0ztDj>B?TUAI9-a(P%};3_Xv|ska_~;HLNjX=8d`OB_&Yi z4-!u107X1>@|yb3O?2J;_qXe~>UL&CRQ4F7C4+K8%e~7r>v(-&d^SbVr>`dqXKelf zHOM!_^3qdj;(X-{ND+d1dRbn+2aofxI2QaF2Hg$xb74Q&e$M3`gs8{lfeh4+2I?_I zOiSZoq6$)WOm8_viCB_yj~QgQAHy|>r{XS7G3qZ{;INWbB&3{A4U%BB8;Q(I@xN>W z?Jfx8&K^U_)o(A!0iRx_J*H@q+`A zBp5gULe`tYkfPEGF?J(g_^gmT{Q80 z%XP2K<4)`%;jFLFjW)z522M^7oRG~1PZX6^ogDb7i)1hev^Nx@ej7n$8(UT~a3a7W zm>W98E$+DL4Ba0qN~k+?u7Pf?emph@>zO0c($tIJtzbolcKHqA7o?SYNvK59{M}`C zl29Be=czGP_FFQOqw>*q`n=P+)8%%``B*T7`WEBB@g|)GgUM2dN`E(*Lxb2rr6wesYO%^NOC$2^~@R3HWj4$4X>bkGA1ey zXXnD!9=fnMRO28k`li1yo^(~cg0{CBq9;Xh@TiB(dp#323M*|t7|CN8k#%ZECp_dd-xJ$o?R*$a|BDLoYe^9i=jx?qnj%!r$NK&ZXY* zt@Xlhgzpp}$r=T|WD&a>DV&9a$CfyPmzHLeq&C8dQg|Ghdvu)0sZ6NXX&PhTGyH#a z8DnQV^tmJWz#{EG_Uz-!o^Cjn0@&Fg{$>q#t7SHH=pOe?jgNJj)6v8&4hh;NVN^eJ}^g z0e33{l<@H_!bLc2e-Zc|@0xWby1vpRi-2Qxi|j}^_JzwZzmB@wb%Im#zfXc8n`X`a z4vIhhlU{6=CZ(c!FXyaLm9^KX=CxdtivgxbNH-`cPfO<9!cB(^FNTsPG;MaD>*$Z>{ypK&5(|sjw#KGCap8LEw?hFg_pom3p9@3_p_#MuNCBx2 zkkpY$`hx!u+LyVFSu<2hDjMq3( z*_g|6^wsbXq;C@PYhC93_H$+T^#X$^tp3)vA$S)yeKkt5x4%9h35z_;Y1_` z98|EgbP1ow-uQ~tRXq|e@zYxE*&|NV5vS9y*!smT(Ix)iXaBIMF>BLAr2y`QNjf>e z6k7A7qYh<4Oqo;&yPFUrIzQu-yeGG+VE6r&?I|zc2*22)aN^FxWA`a>5ivufX-ngF0?lH(W?}LS}?EuTPfHtigE)a(|3)FSMh-7m}Y|!+|Rg{k%P7 zW>CGVshhPSyql<@`)!6Hi1hA6>VKby9(z&p2bJ12g=Y^EDummu)%n&)vU)!&5+3_& zc2<0eq|&0|s8J;==ph6-i!Yd=Zt$UkE4^i&EWXL~JcLr@HqMc2x|tg;<%_CSME!c> z+n0zTeDAOYg3?tjr?*fXKmUxr>pa5}4fpO9uY*1jOR%M)Gnu$!JF{>NhjnEe>F&;d z=+w+vI@RRPyj~gp5^)@jNf1F`>=j%w>%zA%uM@xvw=1S<;GL)ehgMG-wr)*v(k7K& z(8|yT51hn-`-P~G^m(Kv-hXYgXijtkw?Su6%{o2xCnl8Xj=dcc_`-;X7~O@^MV!!T z4DIhkgfV1vzD{B4+K=G(!x>>W9l`G#Z5EwUyo|BGgCAuQ6t6>fvoZz1$y2w^ceqNFU8Y^}$KS&3z|$LR%dZ8SO<))@}**f|QP`U@S8eM>>!J1$`@ zBD`mX^%FtNHPKlk)`W5i1jEtA2Jmn_;uitNfe^`+^sg7F3}V(YgP6%?5KWCyKb3z} z`A#v8fA448nzd63odqU7N13=9OMGv;x2POSbX7T9rQ-V}P+IBS_~*YP!4sNo*gnx!k}WG_!jAG~U<%5QzeNPQ@Vx6_u ztTQGD-X%w=V$01w4=B`f&F?D_waa`7zJ_yy^P_6$HS0__PR}hD@arE0MaQg<0YcZH z-v0H_Vex&vgl`f<6Et%beH4E1d+5kgUKZhR5#1-K(Kl4qom=xTmE74;&fxdiw3}wj z6fi6o-YwVM*vIZH({1**6;vV~L9=bw6yIqGv88vLKQ{uV6c zA6KYCd>#4|j|RqFIW1@fD0q79${kK`YT!r3J8!uYf=c*dH0I}N(<*)Zt_)JkxgxIe zlYZP+?Msl-w3ctQ3%Asy9al2JAX#Nt3%NjIXUtw#RTYQstt#G(I3z1<3=N2M5(frW zID`am+y>u-MBl?e)_3K?>x*$D;*X)&Y4Y9qwH5rLD>sRLr~k$0O6m3$Jh_LRZ*Stu zEsftaHa0Oe!$mSkI>wN6;|3~iM|lqBn#>rzr0hAV_MX5xgah|8gIqjL_tM(vRv3u* zSq{G``xkrzi(Xon_54=(Bep;bje{5Q#>Q7`V$XVDCuF3?D)L`FM~&YfVlOiD%b|dd$Vmf&1Tvch>v)jq~t3Mxj523HfWJ7ULDz}Cw`3jv`&Ti>-r7>Rl ztTy9(^tlc+8aZJ|nNC>bo!RvFc4b%WUNL{F6~Hz3>0qd2IQ+fujhiNQBE8O#klT*y zBJb~_`*=r^+wI?QNUtz#=xvFL+yA+h=cP0ma;MCNs|CKl35_#Ia|^i3mh47 zhuc=R_C%EXDcOH49jj%J_oc&cLXnmta+HccvbvLWq$QJzyXy6pTkt54>t#T|c^8-G z@3n_|Bm0qF?xA-%N#>i_*IBCf*7B6U?A^-MGs1pP`nDG6C2@5H>Tu)Yq`@K^UvKSy zOPK3o<07NjI2$GW7qAVcxpI-ODNwWl9(|{1y~M0#uI+L8G`{wR>0Q;;Ir85B^$Lli zObL3YK4mj-5P$jPDO0<(&4oJxb2SvTsd@Zsj43+-2_2&UZOQp@+A>JEF9hYaFBb2h zruPXNx>yR;JfuS9m+%CKbSlJbV-Yia{^j96L#mTbml6qbiTC`sPkcsa_@_&_;Lrk>s4_agHG$+rn!z z;_7!ij-QQQ`9YZ*Oh$bY!*+aUA8e5^fj&N+W~*8Selj;AQg3N>n4!?zSGo%lnYcY4 zjEG1_<`li7g!&Jo<^L|8am!CDlX2^wW$q(XkAy^lKc@b#_}+!Y?H6`TB4vG6@Isr+ z{DNxJ_XfXk{n-o>T7ZtffxYlr${0^@bPqMftEe~<3f3|8kGFRvzj-)w*Z0^VL%e^e z^2lbJ*V9q1_1Ntw66gy!u^bez}Z9G^+)^|NxD3xCyws;^Ug|^UI(sE_c`Rf7hCW5E{aZ& z@$MwPAyJ6UbKnK%YhZu0mdqHF+^rK`O58{ka;8 z{I9b+*`^ou?i0hi5BY2qdQV|%INvxora!apl|>M1`14`7?FRi zXjtRVPfm$8V&fV9*OFfII_Jo>8ghp|jU&*&;-|5uN+XCS_lk%8KfGeq6^kyV7{-kF zf9_XmV(FCLCngsD*huH44&cdzFN-YawbDRhn*EZ4+$go<&V3^1nxH6E@An|b!m*0{ z20ezo%*LwSAyb{@RX2vdT40ES%h(^AoDv`TXhYR) z5$kCmOC1m!C8dz5(f!|=SjEM@Q`nK>Vd^`@O4JqY8glT^Mxpy6)|$JEOmzq)?!*!a zzGRKR4%hLeQXQy8%W48L>GAJ^8*g`&lT*`viL}h<1Q;h|ua_LUjdT6T(i0gBuX&U0 z_i#^A$(MWAI}aE?i~pFMG?Ann|KVL)d+ffvrIB7*t7XB%RO%==p_n6%I;6MJJ6sC^xuPC(#C2EQ%HZjr zxA$t`AB!t|FkkfieXuWO;OyYR2-UIzvo{aPv3A;jFp@e#1Tn9kC5Qc%HIA00cN*s% zsD8%Wlk?D>9*w`mx}hk1qRh&$L9`X_`6R_Rk`nW1=BmyfS7na?3jH)OPcZ4)cR__ku#Bs)nze(AD9s z2}>~&ahI)|h;4H*Yx%0~!CFCGkMde`*7K@o-PGC+SWY`#xqr|2(q){=1%l7SFZO+r zf+r>FIt3R?^<0d@wGfh*1=Fd)$`^h%C`6egili!gF#g$nj5ZUePq+pp3`+;zK;L&h z@JE<%;z0-g<4f`2(i?x#yD2z{y_va;Ju`&73kQhGZF_x9vPXE+*CwwzIGmm0-Ky`_ z@YVB64o+w%!?QnU1^;5o?6l98$JehvxCo)FN8 zPuP>15cC`?nf(MSS#gM&b_9Ho)ja;={G8-*GL!vy;AO~@XWL~hu0_{HM6}pn?zLPG ze8ud|PV&=syp+A>%m3w}w&JT%+%xV{^KDV%J?9&DRMcagZ| zE7;|O(Gwpvfd|vzA8MA*1n|nnV3(ZeIPMveyzH zdFwf)yI>`Fn&z&Rc%c`a&DKmpuYco2=c{&S)RVjJcy%3|uDQ+IeV59fG4+`A&MerS3qs?}Kct*W*r@}+(Eg`4)xd=sm0b z^o)A8*tSBm#8*c)0~{iKpXeHy&z-Ee7f>4Vx~=V`@{M4#-P*-#dy5Z9+b$@)&-2jf zdO(y@YrVUBMTmt}!Ty_%k3}t?TjHO`Kg3!umgv+4*k{;&{W8Vk`G7rrYbZ`}#MaIJ zvd6V??7i6#+qT?c!t48|zMo%CJy`Q{*XYlyC;siD9S$^o_T&q}P~5}O>xjkPwi{xH zU)#P8x+dioa;+-vTzag2V{*$EIb{02pdmdya=S&@A4#Lbdy4jB6{Fa-P3RF!B}2hk zxM)MkPiy!gDqp{eHve=kBBu53?bb&I|8UOEO+SxN?|fQLj6XWJ_dWEn$3*EsNESKf zz~Xdrwz(1EWox*C>->YoD_R==xDgobzt*3}WohH{X?pKWUv6pskdMCDa1wXzs~bS(8!F!hNJo9f!;uwf1X*(foJBTzuP11|Md;L;ke(?TROKe9h>istjaM~ z%vt~P_iFx`mRRv6=ge}pQ~315HtvA_+(W?^uim8FGK?0Q64IBonG%U_+Ptn-3mS*AbNuME#zcJGFq|;m-^6e zx4qL`iw5~S`{x8qI+5e;pQUV9K7AQA^3~Nfb@X%; zvE3ry8aZ<5)%_vkXFN`rqf(!;UOnQ|tue+!7QcChp6~dxxN`Kv*a^Lk$YNImSG$R| z_dh~S4%i*i_=wa0%!G0|c3Tz|`G!#Df4Gh=wVWS1iyESXsPSJzD62lK0T%n&Vh=LJ zzQDEnPIZoi;BTd;A!HiFHwpFFUP0)(BfT^`@9e#HHA!Lp=VwQmCykFTv%OwAkla?{?Px}=_2oHTVtpEq4F6`Euj zx1L+d@wvQx#U1t1#a_o6Wvv-%3COq$u@zj$;0n;+WlZhX35p~dgZ;Yo9n?@Bgym1)!lzW9J~ z3^%`?a4Ts#0(!x;&rvMNCO6%$I`zixoCbG6`|nKH{2n)s)kXaar|&H9?4?LJ?0YNl zXqH7Dj$7a(s~4xE&OgzXqCPk9zR7=z>F~pIR4C_e(3^IaU09mlk}qS&l*#b!(IlZ4 ztsVaZctD50i@L_*#WnQHS!DiYzlh>FoOB>|gW7Xea?x+kd%gND<-9#l&G`pm{QQIR z>Uus`cK(4YJ^w&UTYUaODe?O$4Dc(U;Wy?Ne*Qr@b^Y*H?EC}DudG3S$=`_2m;e1s z;$IIz{5ulHzuyX{(>7&!{Oh8Le@m&S(^oE^6aSu2$G=|-&pXtsw^QnE%ESJ6{4=lr zbXWDqoMK9U{8^Cn$LylU`lHU*!u|-J_yzrOx}3H@>ii7)qp7>FKU{c!Ty}>2aq(;Q zdZbUmFJF%|Eh$=${5s)(T8~`#R=6IiH$uH0S?noXkJKz{Wj*qtG!x};0quGu_Y!OC zkqb^1>ygW41nZFrd6e}?{{pJ@NXNopJ@TdiTaP?0@R{q8z(r&|GIF@G9y#Fx*CP)L zsn;V{3R$d27L|bO5jh^c8=;Cv2dR3jGwm@inkG_GwfF}Ujr(YX+F6dxOX2(C{qX*xyE!k*ynRb`_<{k-YaR6%XKqJ|cxR0LVC@}!)UBxXaudN0+;M}IXA{VFoao+hKsD0sbxHzR*1 z;Zpc!X(7%dA-%|;nSmw2=Tmy&jGPA!4|~!5OEe%mOE*1aAA|x?*L)`PsoapXlV$Ng4KG{gp}a?NaisN^t`$1Jx{$zu*87syJG zdKS~2ulJ3m{@40O0N)?tTSD@{QEvg@AN=H@7}cZDUO;#Tb45fr>D^GU7|LTPdbn}KuHx!IbYLrSqn5Fju!Vi3D!~APEKaUL3_)* z%B1kS6IIxo>>ic>igd-$f^>?oNWS&L$v355T%E7>W?Nddkm%BE;_*gTK~y^+s+ryR zIs<*wWeDk){eLR`ay~!lmpM{$5n=xE`!NQd*HSxO#T82(N>S&#OP16%c!p=qR^ z*S$lhORn@(7pC+~e5JbmJlw+jqhA+5zA{u=S5mYQmn6M#A*%!IiGB0ZO^0gE)VNjt z&?Sm2CaF&Z_1;LAz`;b9!c3RF`M5u%bHuM@X;-;nRerO#!*^e4ulSL$G4kY)EXC3u z_*?mMG4y3=H2l~vnD}$J2 zA}%?W{MXZOJU%#hq+AVqb^ai$c+CMyGeKHLJ8WfX#NXky_ziTw^#O}dN~r4=#n4HmxN1J+SD#06?ohN#(R?|584Id0D;!nP(sh3CxeB zQrX$KLpzgHMR@Vdra5%qMXnWbne3ZG??&f&B~Ou5faNJZ6jAaNPc!{;lsE^YPIxvw z;6PfJ*#d)xu6q5I@#`1%SF)S1zq|)(`|D$VtNrzDabbU5FQD|-w%nw@)_-NQzw+d@ z=&yhCd|7|Zbrkg1(2rl#U&ZpX{%TQJx4-h|w&<@}1@-!?W%w8Mmy=YY1nsX!cC5c} z&C|sGmNidqwB~7sgP`VVz<=2!kl13U)I1fya+JvGg`eyY);nP-q=NZay;JVOs(Pmm zj+!X5hp^u1zanImI5japBlS)l=q_J}672a;d;0umUK(Pqio8b(UH4Bp>8D z=2+^vZjNm|T`lX$n51sfv0_xxk9I7hi6yPpPavsZZh@plK2S-I+NsLON@Wcr{6%$S z?U}CFKgqgobXDp4F}Ft7p9H$HAto&;EUYIZOR&R;qrBJXVMq5G$2m|r=Uc3|W@DYd zx1+z9B%RC;<9T`gwQi)X^;c1{r>w+SQqQ7P||Lk}^= zXR0ILg17ZvVfGhT`eI-X()y{(G@KVU^+om(busKGoVs;C)C=Ed>U-K3YcZH!hzz)* z^g^skCz4&QB)Qt?{v>}!R!=1gkaapmB)XSYqc4$hfp-sa9Q-<;ri`btQus*MRI0qx zWtP9Dcm-e2@5BB_x`ZZ@tSwUad@7GI$5QVX(f`wW_ikaT{?Ce+Cr-X)ZzVlJLz#^@ zCuBZKmOstx$%4>(hCNyZRYE}Wccq=;(0InJ#kO(q|KkQHFHlS4;C#uo2{R> z4kzp9?|Lcg=V^8{UfhlCD(ho5v8(lTe9-mtpSh^9{Xy5$XiAkL=|`FU$pj^T?q;W;rxY+(5>A=wqNcx^iU9C6`ebH45=Rm2$>%fG30Lu@h z$o3;G`H$*(jL#GMq~dv1`65}Lra$S`OR%|CuAo*{fqqykZ)uf_vI;z@%(_S|=N?+M z=z@-^_2G3kt0R;?6_8hec*DkY%zaM*wP5!Q|+xzAx z?HF!Ret5nME56NeqOFh%aGl6`8ikYs+);S4yfL~w&A0t1k7tWklxD4<^F&kBX<0Yq z`rAuVUNL_s+x(rRjrr92f73;+e-$UK{>^eL`X{`x)W1gFFVnx7y_&xq4Cg~yzVIeH$RO^oKQ5Ym#J?P{7?=G_#=}XkZR*wv!MTPY+1+}QPBVA zGdxH9b`iDK)iN%?{vQiAhzk~k1RKHPjyclCJak5Jno-Lm*qn){;sWwWLgA29H5-Tg z@9^{Q{}69j1zj?0qx26NM9dy#J);I%=ouiIA!&Bra)ZB=G~J2%v%)ODKBM&8jv%Oa z%tPZwH=m1mM+1GW6q(Y3%`fqQ$>XdHn3=C>Xunzx?cGpl{|k;Ay=mOI=?R@paeh_W z>PTacQY5y2$x4oKHdWeDK)I$Lx#sA8O4#8o)wUx6zMEV-f&=`cuayA*D-w?vk*&;6 z9p48SjPL(~@%`&pB)%Vq`omg$|Lp)n@x7D0alubV=jFMd^3cwRu(zCs2ZmV2_^wiN zJ|5$@r!ju;1RUf0;uyaRSrR@ZL7mS<8mtk0aXi;OKMPLozLW!UFB0b$^}u2N6LpyX z=`roDHyGGC$e|+cD~m~-lyc(`eyCwf{0CoZ1O7>ZfZrnC_nAQA{l*=Xcz+?X zG#pp$A@#m5XuP$-(yrIMr60!dcz-_qD084?ygy$4upI`0$Y0D+o$u4n(0LvX(j&5^ z6gI@-{FnCp{FhwB7L=o^$1=0Ae?iQ~6FH5yZ!}X*IrVuSlYZO{$Bd7?lAu)Q zzu41=ZqiGnubiKJN9x~59_jQWYB6}dOzYo@Wwy51r=j(4VV&fui9U!J9PN=N{romt zNg}QJB+n;LahCOKk{88aSMsZC@F=gFj`OSU@YeI62xrzscbOw~v!lW&`6D9CQK{cQ zSeV<05s@b2DV{!>*s<%@0wna8r_yy^_c%(nC`33wo(`f94(-kp8X})S!(3Ibzuh%xc30+<9zV2bRvi^CJ&Fb}cpyBnI_4>EpiS1S9@7&8) zz5aMRb-n(x)|z_#|2}E>o8Bt?XJuup>-C-Ud`Z22iFetec(+f_&v~EH4xAQLy-&%# zHGlsjYK8E9N}Jv&Z8`Fo#9IemXx2}f_dX7ME985!hu-r#^nn^FKcUI%cX0SMs+BrM zpNeJS65Lpk4Y z(ITIGT$+MZ(dHMjLk-z;C9=iF?0IqU|76c&|5MxZj4Wo)u9?)H(;fhOPX0$|&z(bU z+4E1t4|99I)ly^6Ssyg^@cx4`hQ>?Wp6@;RYxTbw$#pQe92mvUq$~0M?0pWe{hfc9_Wf%x*v5YT^5%i;g$bM{8YJz>}K-O&o<-FT;R^85Q^#=J);gF zFB%U%IiZ<3kFzc6V|+{`&-EdU?k5?cW+U)%drTZ?ydXRrue!2mD(oa`>O`-v&Mt&i~^(=|9i!O4(aJ z&mR%QQi}8b$yPnjpDQO@PA7WZ%jVDXecfVz3D=F}0b`~jcDY4{WI_?7cPUO#_cK8}?+(!|`$f2eweEE02}--E>5&{x@diMh?s6a`-2 zrir;#c04gR(jqZeCMRjnrGy0B|5C)XU^mnY_8ks=^5SNV>Tm~$fWTh{-S zms<(*a@}r|yxfDw+I;Bw;r~NE4xC5QkM06a4pSxO&IYOzb0nWEC+1qv#N5syI5Afh zCmj+=D#=P>F89-HB{65ZB`43yS|sMc{(HZx7W?l5Uu0WP%x!p*ZIPIJk}hBSlARzi zSMa(;Vy=*KRZU{91a(cw6~(60#9XW$NzBcR}Ev0v3AeS+=+yrqC_Ljym1cuZJ0xYEcg}=2^C=9_DDea<#8+!g`pz znc1)&=8v189_IcdjWhh8>S2!FAa)u2$a=oK^U(k8`H$z>f_j+x4b}B9OI~NgdKmXX ztRAM?(`<1)OxR6kj{B|~sE4_H$-*A5KFJoOpz~WSr60r zjbemu*H!f}U){-8*Tby4&a5!@`sdff6dFYAv7EnRkE7GGc|FXHYl3>1DYvs>Jt$K7$G}v@f|Aqp?eWnC3wwP0SZI&0 zFDqC3Ee+b^s0@ugI$Q(x*#5!)uRYdGBldXkzIA(a`tg6V$G|5dd)!!0ZIAh1XzX!L zKW2}ynO5v^^(AJHm984F$0p}3?6Fy<&>q`fvb4vGS9I<1^+gMNd@E_~G1pba9;aPV z+2e0FfjzoiW%lTN_4DoV_kP44=hap0QMzVfk1ekV?D6dljXmDKA+X1@H!SRN?pLfS+mEhiUrk4)wjn^XD#fp>m#u}UQw==c^TT{qq`b=3`+&} zc=XQyuRX51Ozg4h9qaa(*#CdBM;za1?eUvBYI_{}L}QP3y_r2aKeT3#smvZ1T{2*g zyUtkH&sHA^`*4@AsrDVELN2H zeZjNBUq7G;6E~W53N}BJ*4}5ks$S9tH2L9VmKPc$Q{+zel8Rz`q035_$qVF<<)!7` zQ?&1~{?dW_q^r=%@{#-wFK=AuQtOmb=hET=G0y>fQHj?>U{RTRK`~EfmED1rWq@jB zN$l=F6#Lb^9FD$CiD%TCOiu=IJ06&Y+z!QnjKS zS5v*ByeV<>G*R>H9g5A9Y-9gK)-xG2Rfv1)(_OYJ+K@V#t#hy5`((&NZDrD-QfUtuGSJtrIKWjn!g^6+U38$EKDUeD4- z@%{p}(GKURjjpCP8kDMDNM@X4CVKsx)xWQcpMAbl>~rtMZ16nvmCM=k z^UzZMbM(ih7WRtmb0_^u=8u;4xlI1B0|vdX1N$7^OW!`JX_g|U>2RNph5{C*Il>2+ z=7c-cG)r;QEO5udG+oXrrWrPYnq|ZVYL=yNZ_iPi<+sVSxBtSx;|@(bdsDl_CTV{` zG08nCEYDMlnq>TSVv?mSOtSG=iy70nJr21hw8xdu9)C$8_V_W)x;=XLG-!`!w;*A#R-YwcW4%`}t-?FgAk!QFy=3&-&^BnCU z2i!sD)aE!biFS~LLF6skLGIKZWm612$4s&C8QBz1+9{7KS=wUF6U-KUq}u3WmUdYD zlwyZxPE$KvO6@S=f-+Y+P($o~h8f}yXEYg|vCs(T;PcVC5c|7VU9msEbJYHhFgxl< zZ)@PO0l5y`&0P`3&hr z&2i@`bv4$RquaX7VdvEvcb1kx`uB`6~_18bv55Urxm`VPgw9Ba@GLfrfR-<#eCQL8$18> zrfPrk>ni`-`KQ-FJ=GCbe=#SS?oUp;3-%|QT@vn3=JL0B{^yMFR^QP0`SH4H{9O0?pT^IDtLpJ{;20Y}ZIkHuS$7hQpS%}@<0oHzTjOWTHTC!@ zL1;e{W094hi8=* zRXs|!Zaq(GvN47D)~#|L-np~7`sc07^cR`{IB`qrMfcn$<9JNzku#p^7@a&xiMvC2 zelWVN{a*Yditk#VH}$dwzbuD-Ci$3coC66?%vMfB3_Oy}PegQOCn83E z%nth*KU5e@kLK$8kF@q?w(@?vnMv93l&)^_TW3}MDwRJ%&@~!xa;K^ z&*vAjRqy+}ppcxBNJvgNu9@qF=fPDxBebuycDDJQxeWQ$Z;*xkm$Q7P)RmNat+_ynU?=8t5}&J+pZ0s~0fll+O1Y|*vi5zu zS5JxSTYUB7yNP5EFRZ&oeE0NQ7T@K%z~Vddcwf2WN_@BQPq`Q$m4y}k7*c| zVF4a~fA&4hQ{MkV-_5!xRTT4`S4*Go`HLF9{+w^S^J>1Y&M17P1WUfxj~eH@ZFRV>`p(_w6_!cQu95NMGlNQ(;|p`pg9pcxWus5(rOaM*YY3-=)Fbb87-0MBQR3k z6AJMfGI2EM8hDV?_ndHjHy$_9{xi|-(c-e@5lwTN-~rN2e*PR^*XN@2AX&NS^@HT1 z;TutGlUtEv`OG8@Ptx=*m72&0 zoZ+9mrQ#QO<6S1tvXiTz@JT#F(IR``FOoks z;QF3T5$`Z`E5}x&>D|5Qb_Sk;&5C-E{6#HlUdYtotW5jsoh~3eN|4N0-BhB zEWg&7J;-mzPSSfWUE4(_v=E#M@VS9#mCEeL&eg#m(q~@MT&A?bXY-hE;k!)6qt2Wx z9~)F_q4djX^2p0MpQrNi$?|z9V-dZ~p(OvE%$}b@BkmJ^&R^P$SGAGD?Cb;0$HK7h za%y6Jgh*yOoTl|a_+Czl_)F|pnWwVhdF$+Yq1LXq>lDA<-ovWvEz-H3v$gB>v$)xEfdZ?yV)T{PE| z^Ea1k$oU&j@ zArdj+ycvE}3gpd9{ADrVJWm{dU1a&L>hvmEiA*oK{z?9Pg>>_%_5A3f>NfNg9xgWc zjAf-a6ZX>AmcqvEpu(n~1j61tsfaOh4-sR$P}B@^lhIwIr6;p3-o(RS%H?oLxlZLh z^r^m;`^ojHBXLV4XjTK|<<)>vSBB#lK94;_K0hl(+ImE{esfYa8+s|vXeybLDwtL-O%R@>ORv*~U+2&ZTUp##+`p4@13Z)xZWx~qcc!eChcdYeU0 zZ{mqqKOnIlA7CS~=RVCyYzRgo9)CC4_}fDNHtQ4^e}BrKZ;-nGZGHR&SN&W)pPdxy z*~!gP&q~{*#rybx_{p3ff8|H*UtkF2KGXEW9 ze(94Kh!+0Q#nLLX9u`GbxRzoxd=6F14G6>1Gz zPqZk`);m3ulyxJ1P8Ijquw$(Ld57|d9DakH7ovN2uO?FTw0J05jz3N#cawF2VREj_ zs6*;_y%T;4y1DrcnFv!QHym(9`!BA9hP(N=l)0Pq06lk_ocwbft91|gAR=&cb8^^d zJdnLpXe73GlkzB(%j7>vIXUIB3o8ZT&l=olY-jNVNa`ZDAml&rZoOOuh1*8)guT}aL@xyo< z{^{06<+(sT~1()F)s+)o0-@eSLDgh(3W$ zs6LhU8rJ7*qDY?;@oIhc#;f&N7q8Z5VZ5Txp%YA>`DYC4lXjZu)3qYiXZoa0E)n||meQsAI`ZWKZ>hske!}@GFEYfG)F10?me=PNxwo9$g=v|6FtrM9(IQ}=N z53VOc`qZmH^)c@h>N9B{)W>zbY+oDn^*LOD=<`Eks!wLTVSQ#D66rH-r&^!UJJtFO z+Nsv3^G-#dEjyV$?N90HV}2(e#DMi#h=VZFrfC0So>-(LsoxG|0g2?12JB_p91jcg zNklDgV*VGOV-Q`;!;`fBu7|yy^lX>KoKOqT2@Pob-B2r^E3M32kih&Q>3?*utXmfS zk1+b%@MF>}oI^i`=L`J35%_zPMCYrj+jHUsZ%=Oz+MYkQTej!VJ=WXP!GpA?25wIo zW9>;ksA|uN?dtaI-LA9;+c$5|itSe0V=;bHl*#&KG8x9dl&8b^$ToQxXR3zrf!%x< z)02+yz=+yGhjPR=K9pCfhH|Dd&9^U4+P|?89nIhDv>44@XzLr}(Hw3$n%m;hoOnQ) z?Nw)Bu=#x(y1Beqr|m~LYZupP4#u&3Tu;P!4gRU)K{l?(CbMxp!-`%eS+K<8M6kx? zs9ULz3BisyRu!gv|it1ZTB@lO>FFuhtHXL`-lA768mh+IX! zrE>MzA{<}cc8SK9=Qb)==`A+L*K2n=zWk|N2eug=U%mF}kFT~{)Z;5)i+X%{Z&8mg z_btl!db^M5^-Yq^@g?ik`xw#dep#y5cbkQJRoN-h>&+Ib*V9cl^*UOX=(VZ=)oaF9 z!+Lq|)z`~?vsy3L&1${uHmmh|u}RVE_+F-0)=|Uu=zWw3wxbLc%zl&59zSds+2gUz zRIq~^ZQA4FGDNVI^{HT8w-~m^oZY(i_+q2l9`9^a+vE9-YI{uFsMsT(Z)Cj=95HH- z_D6_Zk)^3z7dHsU*XeDd@fEX)$`!rA=J@Jcn#i@J9+j)gX2av_e7yenO5C6xU)wgQ z$JdGt>hU#agEGDb>}Gn+_}i#GUPvT*wJ$~WTDe}R*OILwz4~vYdWEjHsaMTXM6daE zsb2qWG_2Q(UHW>>S+CY>;(E1SBi5_+>a||ct9Crot6QRBdt7mt2v+VJD%j8Kg!VXi zi^v{pZJ>fxU1!rC^L;}Eo9;&iJGH^EJr3WgYmdFwsqL}tI<-9ptW(>g_d3NM^Xy`J zRXJ?a9u>Vt93pzXDoOPUTr1S8-e!?r4)R*!;~JZKT`5WRszdc!yxy>0jdtkj<-Jy| zm-||^Uao7^dfBa2^t!Tx>GfZNVZ8zph+aqBs9uHE2=&UhNu<~1wN$S&aW?hZ;70VC zRGaEGc%5OrT(;}#Ww%DH*NZr{UU%ZudYz9`^jfo>>2>;`STCN83pOWF7v?4vJV+Fq zQ-Us9Zm*UVD~M}LiCpseGT8cXMhj`yJkraazMma)T)Kv)@%~W$G>M4z#7Pk@$ow({ ziS`@0MH)WxE!uaKuf38wld7!6$H8F9X9U>=ljmq6C3|!!lR3x^>sgujw+CSnmf60} zINO&TI8)PqMTPaUw6xAbMVvR;&i`|7zSSbjPekEPqDUzxaF0@K3F`@%8@! zmK}@~t^bAkZrM-t^)62Jov_M^zQ3-wrf-8ds&B1T`udhEZlQ0ZT3p}LabK)&uPyre zwq2#xH((Wre^-h1bz7zA`)mu-x5)l4(6{wIqVM^lRNt~It>{~Poi%-D%H#LJ3VnU| z6}8aUr6$*R$m%cF*KV`EzAye#>wD)fwZ7;766?G7FGb&5eBRl)S6AQWLVcg@A^MIe zLiIho!iv7T*I3hc+)Ao%m^FP{QGI(9vC#Ln57#&UsxQ`e#YTO7=d4icJ8=bwe^!X~ z?Yu(KxB4cY|Jw5f<9F6>qOWUVs&CKbR`l%{XVw44Q++*R^vCbNg)H>l>dp1t_}3Tf z8?ZrNU+?8=echL<^>tk?*7yA~Mc*=iFnwRge}TT$24ZMou$^}VxBU*GewYJC%9)%tFW73;e&migaUp8wzVIr^Gpfm3!8f!nxH zftM|nRdNOb$E<_`FOkV~TSf(Lul(sTvA~U8@N4g6ftyz60zY1+CvYbsa3B_VoTb2> zu)q`6iUel*jzE+$J9B+|Emg;3ZI>$gE>`L5hrhQR|5R`t)3@eMrtf6K{`aRHMBW$9 zRNh8Qtc>55&OmC*L{ut_;p>P9=~==)Z_QXV)6J* zTda)VL-Uxvm$rX_e<-+}#=iyR_;-=D_; z#J`I`{JRLmzl*HIzl#)od(7qW@3zm09~A$vc`FgPMt&;r_=Q&dL-;al{-OS2Dsat( zR{VoJfGg&=@DFP$bAeAS{$l^obCs@tXuDAD9|9Jt{e$;Hv43z|sQ8Cxt9bmoRmVTH zGM^*+P39D`)5BpX%Ir9YMDFI^^YN52c~giA~CQ-0CK&Z8?gkIZWyWX?nqw^d#)I=T|6X#H^! z7T9D?YCa<`mbSS$FD~c^!8Z$Qgr5Q#NlWe$h_bEldr}=&D$0WQE8;Sh_lQbnFGbgP zl7w*99%WqTNNE`VWwHN{@p}BzvXxBFqbRrzOdxvBvZiNqv7YZY(fxlXs^`fVp`J&U z2=$z?fa)0;V_nZFPE^lUYCYR}5j{&T{Cqv*SLo=uE=H~A!Wgxl(_++mj*e0EZ2cFv z|4p{_`3Gcz;ga#DQ9ae=YZv6IRl7(oe`JJo?K58!dbhyo_-jw;Cgytybk}A zy`1S;ek0Q}THl|_gVQV6OdjbO>d~u-IoPA9^uq?C>m^6(Tg%OtbuFawt!`4uMbx*t zG2gmYc0{-TpuY9$JS^@J?feyNzJT2;`eP58`$}^pxvy+blKX1wlbA!E`0n80CH09R znz<8?C%aoqPa8r!Z6oYyM_PK?|6}jV`l(U2mFO;F=?4DZ{|Kj?;Rmj^JA>joo_zBJ;yX8n;rqo~BH;T!cSgduk2@2yZfO|b z4A*5bh-APp%R=w>T$0lPZww*6f4=Q6;JfPH2Jl^eixJ-iw;1s~|?+g>ZuYVlz{YwhZoIW&TwjH_9tOCcqvLuU;JWQS_PAcc?18N$ZnY8LC+Kj+{gHrgvP$6lF2wg9 zsDBjxdiEY=|2`)1eUlmAR4~^v!A#mehDhxk#f0%$57%S%<)s`WThoGv;Xq6XZtHeB z9pw9mwCMK55Z3OFVQqi^YpI}w*@On%t>wqVcvDtE{>hQRZgRzAm~X`3T2Z*w5UoyF zrIr4<#*jeD@^Mpx$JC%7Lu*qfXXMr~+oG286F+(r zM{XA^_;055GOOxcE7v&S4VLg6Jiqu3yt6{J$=wfPs_)$N>a;JZy_yJg?!SsLa_<_@ zh9EfnbMUq+^5#;6E77Z2^A;2hJ*mgYp#|IO_^i&D}{hFJaeO zybsOf9-&siqLCTZo$o(PO@_VfT^aWB4Vk|RWcB*w^_c^{_P3J7c|gzVq4E5Ij+oE+ z!#RO1qyoH1yvw;|65cllx07JL_X8r?x7l(`&%P2(mEaF#OD%hI6K@V1u$*m0<=j+f z&erZ>ez24>Nas)p%%7MfXZY>>)g*i)OU>R)uD{jvp3{dNPW>KVdhlzKa1X=rYKJ;U zTuD1I-1T!CwNmK>VQzSe4-ZFfCSNQ;dkxm;MK{X#SSixdg5QySC)qOv_~gg<8|%y` zfxDuNRZo7TIpljEpJ?ZOx08QKzf_lRWC&gEZv(&Md%jhC#ewym2FhYHSy?R>hO6>c zSbVsK$`{qi_h#MIgD-a`V9S*GJ;@WF@M9K2!1G@Z z@audIrBX$?PnZBMyq{?Bo25q;)_NSMr@+cW@)a2S};IL3Tc8|8n)w zdk)i1Z)T8CqhR8n&`rPBA)z3+k1V-KYLhMge74g&HnZv&^Hx9@^3C3>nUa~A2KkJ) zMM%O>@qjow{7{bC_dT&(<=dkEhu^F7rJUUZBS*a64{~BVRNqc^-Y++Pmjl$Tv}5uX z6fS$OK6G7uy}W-Mj4gfx7)4+MhZ$UVYG+`5$q-rj-bZP^6(!T)KAqVEC(ZE4LV%W> zXDFG^gvY?xk>5J;DcX4Ow|4qt+{>cCbb>z|&bOI@irt?CuZgtTMgK#-TV7{-NOt3D zxYy${+DPEPa6Qvd2YDC8$l!aEu;;*y;hVURd7j&VNJbI&L z+C5C?-Q^LHzz5{RDmcF)=0_#|;+q@1PvFrLj>z+i;g5I2jVkB!Nv<+Xa_Ir^5e{Jmt`1L<*O$n9)i$Hly;_Izr;6JPD4+MQjUwHExk8dPg2Q%BuWCvLEdCz&8I z;U*b}tMV4w3bUb_FP3iujbXQ$-LXtsVEy3E*hA#pax}lX(&`w}tV&j&hXxuz{4^I& z7`t$uJdXraF1(RNCfs1rmIJu96tWrd!3=><4D#iPWhyR-??#eIH`%?HweDC0{DJ)6 zlAOF%6A6PABUDn+4EIMN$Kw?VH~hjFV8?vH0P%~E0g@;K#8z4uprhh+1N}cDgw8#@ zgFF;8*)vIz#>*Z_5C`^Jl9BqLuT+EnU={;;>Gd##ZR#lsiMQL>GJOaPsHa)ks)!*Kz?;|$<3suv172xI5gIbvx3 z958z55^qiJt7f+L=BxO-k<9c-2Gb{p)=^ezZO5mU{T9ssTLS(M`JDV1)-~f0yBNgC>iI*-*2NOw zpX-`)fEO7+m+JXxP(~ey-+! zFnP53C&wx7%UV~%6wq6m0_y&SNdXODJc+NJ!>VqJPCr})@(ZM!bw*&SgvKA^7`B2ILqQ4BN^(XFf>g9%cpHG%b{bsMK4#aH z;fv{`UB>+{Dow+0k&l)MdCu{7?~jgC+?TfKW`@5b8vYJ{Zo=R1K_mVuZWH)hHJ9P< zQ@~#g%BzKHvE2ns4>&AXsCapSLoBzbRfwcwhR01x?p!1BxNjwbjAnRzNP!HHczlzA zbYu5oE?S}SsaRWUR$BN};5)^LZ+GMH{lt94cg_tae5W04h+l6I(+3D6iF@k@LH@#oE9h<{cxZsh{WxMhg+U!*qhPh|+d1s6+sCPR4ka#=r6BD|P^ zbY}?fqd*cQ!bc-WMJs6^{dNAGG7s_DYN-jIt$t_}KHmsh@!5Hg37>tJTk*Mmp1|i8 zzZsu>=bP~P@H{ggmn7Nuj{;@z}Y_UY@j+>O+NF*&6XmUd!^>GF=+VvU;g;2RB zH-u2Ayh+K8K4e6tCO3qp&AG{5zZvC5H>2EO^w?|6|Coz*O!6YreZ|wm4sl=c((e;la{LAhkW{SU>O-EtvV)xQb zFk|CuU_5W%JqP*MxzNPFqYpR4zv@Y7xW(p?D%15q6l3upn=saKnRpc%-#R47gc=w2^H5 z^>W1S*$j`T&wnTU$bT=)m;5KW&JhnLddnn-$;qemibwVX#N$(q{SFa2`OHd&)_XNZ zd}F5xt=pDb7;&?d5mSB0h_e_Yz8{dt%m7Awrp)Z;@4b=x`EMq*rb8l6DZO^CMCPjq zRB?X(>d5>TZ{ffA2>iFL4Eb;AJkxs3YOdWc-ayP>U3%AH8ADfpO`hKLkqKREmWT&& zn113Yn|XskS+`=wgU>@}xnXdP?(i$Q`VB3n)#&rFYa#cBd#U}muV6}d;BqMc2lv%C zI!A4d!KWwP1HSZAAvkDHMorHzam?Kd1cC$aFl^?E3kPY#EoIyc8lvApcruo3o&|9n z*s=L?@j)QuuO)DMF3t;Y@CRo5caeA#$3UO)enFoVg%OcyH0U#NiHSb`>rRV4@6T==eLST$^tr3Psr0FvXQj_|+fDSTD7Rlfiv)e*@-6fU z6gG`MfrX8xPm4vTL7&(n6Ma4|I4%10x~_5b*<4~npTxSR(q~$Ql|DPRn&|V{9DDn1 zzMxM*o`pW2T-P-Ed@{fB>u1Jk(C3vh6Mg#5IxYIt6f}-Loqaa++51IP>9cOGl|J3K znB%_zTl$pB=+Cy97W(w_HjO_0<~5o=S1&jX`gERdqR;J~)1uFj{KnCzs>sfM+uKz7 zbeLn~|7w8KJl6TpP8rU|Kv7~KEtoG zq0jo`jiQg{pMF(p^-o7_F#A6xw*G0U)Ia1}tN)YNH2-vBpwa$m_p49CKb>fnZ!ga{ zJ^yEBi^7a8hu_VYczdsnsOTS zdF5KO|1ruD1F=IZdNao6<(p z=Q?})tzr6DCjbKRR}|7W%>eWE5x|K}>J|1-U5 z^a+$SKK?fCH0aaM96$JY>goAE*EWtmn{##gi1Pv;HN1ZUPr#Acg^VN@AW349C`IN7)TP^in&^W zoFn%FA4QOgGgtrL$R8+}iu(%}%{1+A&HT{O;QM6!38?MYF$z85P>ZJD8zvH^6^JL- zkMa#1OeozOaT&?9jF_Y{zRju{|dl%X7 z2PT{MV+{O$q4B{oxeqh+YL@>s!<_HO@ip=Ti7(qH#~$=DL_Mci`K;GXcxpe3ZDv!< zJe1E9Q#X=VCqO0{l^OSmOfph7L2>UimPWSvYQ?%~GL39rCS%=8c^cVu8dL{8jcgnT zJVT_BJwHW3{_4=u$hvaKeGZmJcD~jmY;a0WuFGJ6uR3@d*|l1e@b0r@=#M!h%e$W6 zhg>#ATVEoL?AZ*lzUHTpRtn-OnMQUqgK$F{*^;ZYeNK@^Hammw-_1`W(-pw^GL38$ z0#wB3+vMlO8P``rBl91ou>6N$U*ubAauo@Imc z*QsJz%^S}I-#lO)m?R-n6zdFhvSiIolN4bRCGY&eICcfzmw``hZ#de5ben483&BBe zdo{jTkd#8|CY$mL1qa>XRr!S!auE4ggM3hDq1j%QUq~T`k|!mkf1YHY;a-+sNFmb5 zipiSX6|B?A%kv8tB)Lhxg6J<<$H^c%Q-}a{`WP4A0nTR$t={*$Gi>N7BKW3uu09}*SE4)>Y7hfS-JNh2jTe`$5eif z1kcC3<6xBDF^Qdzd1r#mm%Z9_Hs))0O`8GRpo@Mj4?FN|OdjBapN(-k~?l?+bry~y~tMfEZ(BI+L)w#{PpuT|Be+7{V|l=ANP60GW=x>TZZ%HGJIi-T84w1!v2_@trkK@xe#9&$yUKx zPGNrx)8LNli|{56x}TdWi6lV-eNSJ7(>dsC9JCubGTtPg#WL(WQkTzQm%KCHW*we2 zQsnu<@_#^qOqL7r@CcQ!I+QF>AbsUZ+&V(#tGdZm3Z#`>ijR!2%U7LZl+Oi?w137k z`{ydT9vOeY@{+kJwlzej*`Avb*A$nuBv}RN4lw^-wy;0r04DyM`OuL!x;g? zFw|G4Nrt83||8SMi)h#2LiYn>Yvar$p~uR($52-kb|FVL%N0js1xVC*zf)FH*G5P z1^vbSk~?T;;fL|P=g~Oy5Ih_U!+wtbHyk8=C)dgIa)RDj-!_TfA5FK?d+@U+dS_fK z>3xw~()+tnw)7r5PSQJV%wMGU#$g)0w_IbP_e_j|8O0{tPoc=5wi;0HU=sZHxN-XrBJI9fYE0DM4$zYo(cexc)Dd{_7-{$2_0|Ik5& z%Iop6hrr$82g$wJcJGZbdj0s#sn(}8qSNylMjO9Io4cMgEz-xY!gq>e_(I)wrCg|k zNAiW*8W!r6Vxc~kDHrNJqpS<{3fqNhzfRi?W$P5q>5vXrvDe@DGOgxM=N=y^*6K4O z*jl|qt;p{#V=3{|PhwCmZOWGDOjT zxIO(xEBd?tBK@z>=|9DWrI49Xsp`M}slW9!#bG+0X|M>ShcGyDA+{u3V3^uc&0{gOa6`YJHB2t)ySN zXehYVJ>WxsYt-*#8nvUyfKjp&h@eoUSIwzs*okv*#Z{5KJ~WT}tJQ6Of7s~&w2Z$S{eSs@64q3kKF)i{caV1c&&{^9gr&hCl8gFy4SzjXr*gnR^c1b+>aU8R$cp|{@jNlKzG@$`PS}q>Kq~&rYEx#YGq~-G{E&VfT zqv4M7zAp5)f1AYQW%{x$&Wr)SF?kt3s(R3m)3AS7zNN{p6BSEDifj3Q&;2B1O=|F<^%q~Ry z2PWF!KN0bN!Ih`Nf1<>H-B5-9pNAUo-_3~sJ`wU?uC&KL=r4tTZlCOZt&#SL%6Qot zlY|(r8pkl6sqy10=M`m5A#683dS&V61KPHfaz!15=fX-TXrHm2IQL_6G>4Ko;GeKd$h*p06f1xhi zo=R^(_AA*4kea@1t21*zow!d0jza}cqy>Ku?sIQA5xwl2=DQ9Jy?9X6P}i&V4J{DZ!^wnbFBut?Gf)E4ORDKR1ZobLuFjdf0sH>+7|;$w}fth zeM^XESev?dgQp1h-cV2RI=pZ!VK^_y zpapb}E#aFRaGmy>U0q+l?1VFr&o~{fxgZ(rg2Y6)pe6VdZJ=dF%~|`GfOq@@#D|X$ z6c=3-fzmxvo=$N&lj}b1(eg3+qvZ@wZ{y7r{Q+}3aedbG^FCN#A6mriKa4QqeHc%Z zM4-;2@*bCelMjYB_`dmFA2$_$)5ciwx8vR>;V-=0g1;w5+u?8KB8k7{!vy|%4UqV| zcu3>%ckBuce`nki0e@c)HsNnoT7&pov8$>0>yT;1-%a;434c8vvf!^^lpX#`7fSri z8ZGd5I* zcKEwtfyCdPR|xz)(_iB6--8;Dzd3_6{G~_YzZnBf_;X!pk3YVDQvW>PKUwU zv2wA2`P3+evQbe=vz@=jw1LvaZ9Kxgd#JD<-t5QpSzr43+Yomn-8Fsoo0DJZaK}KU z(LR&ACja33)LZ4Q$q~)bc|qU&j^Uv9I>oNZI~wSXPHorZGrm=Qy;JO(+^K<1b!xjN z&vMWaV*ivBYM_0b+6MSC4%&``rjS$(6zpKRgEEDK{^($!L&

=;yRl?xghMpqn|U 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 z ze|lPWeSb~4Sl73>-~f|#Kwi%)<-h$1@|3mNWlH6v|HPL;uhn|bfx3nQO#@VZQ(>#b z(fFUmwIPNPm-WZ9`jY1vRi2+-2V{rnmE=m{oS&Pn7sc-`Oa9kwU>H61s47)N$s;X{ zfoQAXL08SAlE!^fdWC!Zw&T6eovG?%(!m_;VNT9kXv~r2Y8CQ+l6)wh`)@xz{+M5P zv?nZyu%4uRA&CBZkbIJPRLjxzATs?yXp&MDQ_yx@%VFO}c3LBM(B(c!lV9(vQ4=jT ze0I<0Y?pqER&lM~BMAoiCk09+#;5+;;9C{wY;k0VlO|tKP!(o7g{=QxaH&dU7ha( z{#cH;kXM3Jmwk=6nIJzOG3};EP!>k{7&J#EHEKxtun?ZP2dRBIuTv*V&5RjOx7;S& z7$^Ag)OZ^WNO~0?*L&;}MX06h@=8Cvdn|%b!oZ7L_wg@@t56&PhPsI@{=XUp^1u z>H*x8Hc6&@s*|T@;iS-N3QvM?6$HU5LaxRj~TPXvMjX#Nt&H;X^ zi8b<$1y>D|ci;xRrHdf$)cp@7?q5P-T+2iWb+Oz0@W;mQbIcar`Ku!D8B==JVn4lz zg_wCCA0%eaU^?;62eL$N05!olhhv89Pq1^GY!7$TJvmjdO`NwLdr|smFWwa-1LW3; zbLe4oOp)yYyIvCWKaIPkr(6^>I)HaPkOzVz;)Hu-93y4>!H#kA%;LWP6r27C)#ED4 z9{vBAyUbd%=>6yr-r+!w2qwkR_6Rw~$_|1Z;^cb3i*Y}H{adVXD}S^b?{Xj$%pDd7 z>!EQ>lI;S!#L4J!JI49yIjE+O;GYG^2ZLMVH1!~k;j(?;XCQe!a1nLew~Jmd|66?H z-(sGBie(}OTmxj0+!}GVdV)pyvh83ekZd%!Xxzgduw%}{+qwS~XZ%{0M}o0&0(#O# ziK8Q6dyrf-xHFEkN5U~qc32{()tgUbZ&f3SS`|3|#|Pwka|8^P+oO^EBoKTT-A>0c&95BVqL)#3jH?MKo-#ZUYG ziK&9$KNrsRe^FVamqh3bpwI{>~xGp^N=>2lei2*<)kbw{x#E z8>&^1-@6ml#?Qkt#3&GB$@;|7UshwAUhd0>28N|@zYOzkJ7=}6Q%jR(YF;U^A<9JE z!5{ZEUH7#ELe>3bTvA$_q!h`G+GF2!e5tDV7v!EHB_(ZmWPI{?SH0pqvhJW*ffTK9 z`cd6WU2<%Ua(5gqBSm_YMN!_b+uC=qB$g|j<&Tf82^v0Ds~kH-g8R<6`$~7*t@21A zGXw!3;iY{^H37ACn5PH=kJx$o>|~NqjzSa&Am}|J^o!QnYu0tt z6try)I=7eGFtFn&RHc}d?=EELB7_=+k|PnJ&4_b$1@?Emk{L-)V8kN>+}PVaFKOMoV(ATtwCzXTL{(O4sVCHO+wp#LCJB5 zbAG^SAkc5%%xl09v=jzfDgrHu^X$UEBSNDQ6nY>*l69$(w=bVMthbPz+XGY;XtPSW zy785J2#knrhc~iMr?JZ=nS)by6q6vH4^SA;(nZk1Sx-Bx5?fq*7bXT$O>z^M@6^a9}YCLpK?(b7`l6_knytw&JGfJevRsWaA1JDF+t5&0J>uLOa5@eoz_}+V{D3nGxNl!m?kNh~$H3d? z2;37?NXmaUkGeV9aQ+N%w#d3!3ht|t--V|m&aVTSa0TZctV=$;CzNR@426J?wzuu~ z0{0UUlt9*{koX1pq-NFyURNPVFBDdS2#r9T-vgZT0tq9aB@}lbe}0`5WEyHK!814l zJd*z(aOctr)u>_Uw(?WRBu@&?UWlFN1n0zoGXxS$SeGE+KL5Z*Daarc)}%!$2W^Uj z`$iO!q!p8JPD1c5C^-vpZVEU(1`^(w%%ll=3suP_nJ6SFgZt8X`*sxEC|01&MsOca zCJF8!gnKSSwghc9!zLR-3lO0#h|n}d=vzc+F5=t)a4HETNQ0IbKuZlHti(nt84;mb zh|sqGp{wqq0Oy@TISEnvpyUX|>=h5IxdEu=1hj3)J``>*l>dC5VhuQbM5P*(9F7RB z(mI#so`QP{Q97V=+bj{JOhjlk;@k;vdisBf!SjEJ;VeYyf##i+bezUidL`O5BGmQW ztmeiGLK6|^mjI_CfKy9A5PQUlpjBE;tt<_$-wC6>%;PIE4X%Y|Ul} z-arBwNT6~(6X=Kf-&R9$CVpo_Y}b(JJuVGb6|}RiS{vZ1RaZ5`!DE-VLF7P*BhkaH z#hdJ!r9O6+!&_&~Z7uJX_goK`8#h;vM(imnWHz7{r>Br7zQ_e)f0xko0N+itPWVikz zjrw@{(rG?WV4&4xW1v)G>o}$D{E;{1#D_?zv4+6YV4-wH+nUE>VW$HI=f`UU5XT_5qPFwEZi)u?3eHoLj4hEy>8wEl*9R7@A(Snm zpT6?SaRcc5I%(05bR@aFSbmmIJgR+qtL3XSB=;mW`u=D-yx(u+9+6N<`Fk4ly{#p23=&2>CsoE#*ocJmCQ^~9{5SRt z!5t)sq&&Pw(y=378z@r74?tE3j^hUdxK5Jj>_fY@WKu6?{S2P9oChMPSqLz$4`e?T zXtK3~-TL258%?l|J>njVI=R(2>@>jnJRLu`&aGiiNo}EspFZqir)*LA{h%}6C`ulY z;Fu|>4}`TX5}POSGl9>}rhXHTP$Z#&u=0cDkf+-}ZglQZWHiYY6X_wTN2o`3+YV=L zD?&G`-4-#(yqq)I2e7e_)Sc@$vk!8=O*}vw(}roO2Z>an@`&+QF(m^H#ou&tj$f7 z9R};;Y9s8_&0c<|9?_b< z$dXeoEjUQP&w|eEx?#rA`#PsBC>1rGQ@;F=hPK&ZGM1HlVR2EX?me}r`~sQtwtNH} zMpnLUXh&wL!hO;VJB_&+=#+HqLYb34SeE|Y>gp1GC_NB0ez;sj^^{*=q>*Pq=a0kA zwA3l5G58s~?&W5=sk0{1Ginc(l*1i`u+zsSWN}wFyC@21!>7n(tM7w2^2T%V`x?`V z_E1zm3}D@hOys{kKSleb^4+gmUh9{&JQgno+hN-j@s zfZt(zq88t(Hlu7cbWw`Vq%m>7r?^IoTaAu|m8u(XV#6oF*LsurqqcS^#t%!(79ahp z+%km%cnAJ#%?hYld4jy~H#TRsiAzBwRjoBr&fi3&dWjz|$~ZiJPr97{^6RBvW0c8c zYOu{|xoG{-=|;)TrmBMKqHntF&}(PQl?U0cjUPz|Gs68=E;B4G5IaBPxzB%TRC!7{ zFE7POT)Q_coto6b!gEu!-!7(je4zWl^ifmntQ=-f($C=2-KWF;p2cXx1;$~ys*DR} z9jA1c6$y`=a`Q<_sbL)OguGCYoN;5or#qwfPrO$H1ekb&^GAO?knrOZV+_(y6-;xm9Q7T`J*$%HNQ0z0BJe&CBJT~B^A{6 zN5qBYZ>VhqOUBAJaNn}{R($qHh(Dro-vJ_uFWbqK{!K1%C$<#`ul~AMx-??2`(vAw z{L2i%@!lOYu*RRNEaPlpm>6$2S_VGFbw-BOhcOf0gb6E?hPTSq6o>8^O z&$%a*PY%*|m2dy3+8bnur>tQ!gcliom!8eN0;j~?$L;Q1x}H0PtCqb8jRie=8mZ!6 z$C^MNlSEpg_sNx0D|GxPc#8a`jch3mEx)AS&wHh$(z1n{05f%J;W)|=+=&a)KuZnk zF@upe?1I1!H->~!)v_4xqM!?k zd`gyYjvHP(Pqw#}mfbLJ{5qCRRaTNMB}Pgf^EBIdir*8p7bJmQm{>#pR`lt$BeC*( zSfL4WuGpwa4vu|%63I6OT9nEXmqqCYeicx{-Pg$mkD*Rcc8y7_GnEc%Go%0m9iA2h zlpi<}W#f6V2Q~`{1^6k(?hlQ3v(79{D$@cR_I~^Bd_Q3`9E3n;vx0e_)YEsD^j#gY ztDb{1!TafCGq8dHH7gHgA7AlzdB++DQe{jkdeYKLevTFQ>XqSv@}A26K^%UCAppSn zA=!+N#EeE|^J{V1ZF}R?{p-=RN=h(v{Dh;Rk3W#Wt|eUd<^`a8_bYh6lx!xh0O8#X z3%7KOJgFe_FzLt_ZkYDF*bv)$B0_8&=$G+O2v zn-dEqKeyQZmslX|r55<)Z|*r^%@0!@j+R)pWN_gF-J7mixgpe!^n=Ex z4(XO!3rJdUws^hU>-t1~`^ae#{IDZKU!}pp23JD>+kkgxF*e2UDboiPd7}^pSZ=9q zSf;mBvZ3fz@`6?02;@A8b_{?KncjuFK3vVOP)nNx!ijtrh ze$q+)p8%SQSp!OGKUs4kcVjkt8X;64r!+GJ<(~a za8~gLxd42&-tZ@8cnC(r3UNul=I^2oV=X!j#+Mw zRp2|=pd;o@8|kp-9aVp2!6k6lmAj>W zURqRg{ztZ@_iupzYKJnrj95i>fP)Te$nh(me6X5U0;?7g%BnHDbYQMxPiT@merO{!L^e!I$j|HvSZu zev^>f$)EHByi6f77p7pgwk)WQZgS>I0i>zD7LRn&P*-qUbPNX5-ll{}4rihR@f;I- z>(eET$GTsTny!6-4d=NoN?4gj$bw*A9)>S_n7{ESd-nm4wJGn0RyN2*#3KCpEcmvL zjeM+mi@hPs;loV&KsLnbHJ+OG4QI=~#?wW$II~8-rc`mjk3_=< zT`j*$6nUu*uI4}*-AlhPT!KU1(y^x)`a~G2kX4C&=xuOIMFw!}hq=8eZK3rTEO_?wv6{y$up>?IGX*X3Yk5;O4{$Ir_54BDJ;h{f zA#g+>A2Niy1X@%}A703E*22&Gh;#K-aXX=Mzz4l!`tD1GFi!n~rY1?tgMu5}Zth|@ zv42}otx1QwVMR0OO=nmCFrPXgfH2aM!znp0Q$%#bHpLHZ|q(Px;XcS(x;(fsZ7uk{j!m3~U?Wzv7=|FnAf~ zE3q_f?^nT+MCrV@7wmAEG%(a^;&GL({N|Mf)Qqg}h9(*Gl^whtl~5bK!> zd`mg7xTDd&qhH(fjbG|fV{%9!6{``X{WFn<_zjtwuTCyh_K2x2^D0p8bYN;Vsi|8H z7-b0*i26ATN-?-<1-eV`+Y~WpB%|aiwjIR(^Nm&$3Gh=jt9h@}Sj21k^0+v`<-fq( z5G|^sciP&d=e=tqpggj(MXlJ``Y59K&FtH@Gx=L=&^xwlqpw`)sCBx;|MO z);F|(V;A7@W3oF+z*SLIJ9l((9^|!Bx4LYSH^H`AkNVqvA26@|TJReM{QXgmwPR?_ z!bhGs0yfoBFXz&+=oXuH;dn<_kIb)1=pWaZSO;}JN{|ep?2|OGI;xoZg`5&Tn?`#c zaydmDNjc<(3Cj&)a=Z$A0ytK29xsB>&PI{Y%R=#wXxYnzzl4!(wWq>AbtF^+Wf2mNgX*T z32wAS-=D-%XTAlW=B6+G%xPMReF7TR0MynbYHQaFXOZ-&vL?3_lMz)kIv+vy3vvyT z9r(+159W;2THdETZ=rdMV;a<)b{PS@kQtF_*W}v&3a;2dW-dgk@!#93^%QI_87A&^ z+1^>E?)tb9M~a1QV0R=^8ld`Ld+9yr$3qngF&a%);jeM81)T>WF)hVH+Y{quGDljZ za4zysR=H5(5Po<=vO3)2m2G6W(b&Bq*S4cbfTV=^-2~ux!`a>OgHQ6k4lF`U zqp7(-#mVYIHRO(aX3juZ@y>Ucp)*aJS^LM^raLiXV9IepQ$ib&i{=4;gR5?Zy~|N~ zOShu?r86~YOXs6Fu>%rQTie`;6R+&1*>v@cP9>V;#nqNXgR}ok50q+*)DMk2i^)gR z@P>%gYJQIvqTaTf6pf~>d;7YtjJXnh2sUXQ!GD~Je`^r=2(56S-_ZLhA=U9JQ)vA)Fb1*O{Z24-* zuei5%iVOU4MNvx#Q24qRlB*8+SP+ThR+HK64{X9+`ou$4tuoY5N0wvbqkm7w@6^ga zYJfF1F)|+#w9)92h%dClju zs||;n)%m41;MDqKvwh^?4PrNw{H)_686XhJE*f~BTyoMpb)O7xqqMo7Tkn9Hob918k$U z+c*XI`|)N1Q(S!;XH|{wgAmrUwFaeSRV|6rQ1Z-HZpi6{e{OYhC1vu_x|->JPu)`` ze(w2^=3kTmF;tqlvMKr2BI94WS2sC4RcdJ&Q$5UXl z83Z=Apv7Ib6IDIB6*FDHCYf4(KlqQObJ2bH*&Uj2FKJa{1%2{PT9i868 zEEOAwBsjC(XaRdM(#lD6vCxjumn}1TKmL&67Q$2)j~OOx2GcmRUU*tjea2dh@s(~2 z(|EVRD-5@^_f=N5o|kXfs-;Q7AdM0l)rOo4HH3UFACs-Q`CsZx0f+H@(;7uMxOryu z+we5_4-6Z6wWy!C>c*saziS#Kn*OF0U~1~ta3~^jIQl;NeBh!0Y+3Xx;;2w@5tCuK z4|%c@IU5CQv_vL2M3xET?|wBgH<3;5{8UhQ>eL@<-991gJLlhLw;Q|62V>0g*TL(G zNDRn3N*!H7Tga##O{+YZX9C5tBz~M9sdIF;2XTK`$gW*AHy-A>oi)?oc=LjKsg4KY zV(!34doAHPe<$pmV6Jx7IfEg7cT|_5$zC1<`c)4M&2RcuP!k;?-?6-MrwxPf>-jJj z?DY_~-%c;PGW_aEeZ5poEiNG0M9-bksn2e29=+Ydy-7Q$V-}fSD49p-ce%6)(IHC6 zln5QIl%YO!v7bpXn<3*(DIe2tsA;Ea?)ka699UZIr$tn-TjSfs&y!A8I1|IYvc@c| z?CJm@2uVg}Iru(>is-Cr(IQV-U6h9VX3m}+&g!#+xt-Tq07l|+WeoEYllj=ZuH$zi zoEoNpV7036Zf9S*z)ry6>SUdlUa<{iAXEaH{k#QsC3Zq!+J5!devD79O0r|5LOF=O_9LYc zbLYqE^aDK~RH+Y$U89}7s-4J=)iKL&2i6|6=Q{A7^D@@H){R+fs&3T0+8lWpYR9}T zZjs1TjmeI~UvwPVfzK@4?JX;21mBtaozjiHrTF~l+H~v=w}ANsFQ*@CHGIfH5&PL? z>yQq3A#d>Zgx=dfBlnihOH9;UqFz(ekx~?4nq|yd>U60txUW1nUNxMVm^f-cza{=? zGa)Uc+PI;e@oDj#gn9#bwVPE-^z~lXzfEr8DX=CV@J)y7>g$CaF`!<+Wa3_q1-C_L258%4q_A{DS@e#*8LD7q&NBv{nHIGqmN;)At7Uw7 zUHgUkJMHdY{+R9{j)3OPV?MK!Mf-p{2Oi%SDeZ>t6^eNxngY4%a~*~02_5vDO%izI z7Z7t!t8^xbV^uj*WWoE8b(*-~S0)0a7OcCG1^mb2Y2Ld@e-6X2g%ib8`NsAcyz0P< zw!-696J$a&9->6oJWTPV9yuM zlQn_p>FuLmzstLxr>nH~=`r|+ZbbGDvLcSCHd5%KJXTry&(+jk?U~ME@EhJQy2E%z zP52J+=Z(s;tE*uPm-br2Be@8fo3}lqlH4vN)e*~$rU4Y?oy%44rV5W|8+u;;n`2E{ zQ`?&gfc@FE=HJtyu3!wvCAmFdwb}!{0#kBKo$#a_E0`vswbaobz_L({#JdeOAi7iz zeP57H5|YD)A+_z%I@@(74{0R1ZAoQT-H_Q_tx<&6*b8rU$D>7AF_h|H8uuP~48a37 zPpNF~PH4s4UB|YRS?5sSK28Ia!3izbUJctJ^XP81RD94$>1gHz`ji`bR*Z@|8^Fqz zqB}XPj3`Srfa1K2E@NOywmjj^>mBC)^UN;)yN;t>Nr-Z27#qef`>jH%ignd)1$ui| zfmJ01F9BM~lPF^VQ2C4={hgMvd%~CEUScLMtsZkn=Z2=)+O1QIxr-lYn6$bCKD zOfR)I0BC$>XON!ko#N+9ISvKitWwA_$>hjrLsCSw^HvgbL`M5BJuL0 zU3g(KNl1_udeF`fRJl2|!iB+t-rT}iyVV{%um3_x9&m#r>DVSjD+Z(-Oy3QC8x7I}qFXgp6F{+vu%0d-GU1NMh1#Zozm(F-0koS)IHv8#e#%1$^ZF42j{_Z~09zC77wHv2y0iL3H zHN|8Z+XDsXo+&dQm5h#PI1jSD8|mqbbZG3_%psU^4Q?bF6zDFKDnV#XjY7SB_aG*) ze6bVW>PH2vv@z17ix{kTVx#0BbJ*x%3GE)hfsePqxNm?f*e9r-sivOSU3)TQ07aPm z@jH*a!&4s_-g!U@aVCap(-5vA40BXf)?}t+gNJ2qi{vn4ukSE*qlC04vDkI}JieEbhzEy9k zj=dEXjfB6cC0waGt~0o9JUG4FGs%Dtay4T!Ag9Kuy(pK;jb&0{Yz=2Woo;1|ohzpJ zSW@+2&h82#!ReV-O|NyMPpWS(?Oqhwoebdm#$?-rQc*7wu48|9mw*<-5A96DZmonX zoK-YXz1*jIGhzE?qIM&Dyv|-CG%~IzX519!i+Lw^c?JKJufBu$F5x>1o?LKG&K!Sy zgT_1GvNHq_(STDiKjsYp@V+8r7QRPz2+6IkjU1%0J>clUia?U>oID4)dbF!z|FF*x z5HNHY@1X+683p&Sr3JDfdi*u_4}cZRGRjMwoo^<1lpQE;>vQH3zs+QmQ3QB}(Zvi& zTREII3P|wCNGUsbp-;^y@-Cevx9$`4uJd3L<8F0pCr80@^Gt@4R$1eyZLV#PxW!_M!%K&@cJ9gEA`i3*tk#?Lu8Xk{s58vVGYXGsmq;ZO~Sz&O%_r!mF4 zZW#3ERU5~^1bwq9-r=+&x0GzFjdUYlF{Y62Ui3qPxlv7z$d7TozPgSWEig(q+v)&W z9pkPGTQROGkcoRL)O_FolpQXk7gUY}Rcn2|5#kd&ix>HSLfP5JjJiy={hFv@q3Gzr-fd=xj>YBODXe|`^`o}p$5 zP7VC7x&L2u;&(w_O%vTQk;@`-6&Eb?Y;6%B#Ux45K5BbK(*+bwqii!XwGqAFTOUuaK;+tGaE z=>O_G3b8plG%J|>4r$U3j&AX5fz>E9r{@kbp9iDw^}#vY*v0faSp&C9bD(}+B~d0( z8h%!r_7*`RT=9PF3)nw+3qkf&Xi5F@_2{l&?A+^87J-^!S5$1|q3=o%_csov23+N0=Cv2usfgxoi zEHsV`C6M@;(ynqzH{F#T6K-{k=X|c=cp4UpE(ob8OSqX0P6fLtjqy``Vwax zgQSCj3IE_qUtV{qu=+*Q!QOF#w+&p>q>ZzXxnzLRD*cwGGJqQGiXkx<3*T~$YPTzH zni*rAOphYDjJ|43vN8R0FcAlst|oQSoUQpOMbye!d&Nac&^`m0``-g;r7o^@Eoem8 z833|oKB`FranmGp*_!eAq^`EDtkUH7&9o;UH`1y=!S2v0#^w@b*7NjNW&rlx)Q<1U ztbSkjWiFd@4FG#z*(WC!=w?2@0rKMLoj61R5O}011_DITa_kf%gOV3xV{wS)P zUiWxX^w9TE@W^ohv)}xRAi&{rFU8FN>3*#^$dRDq6Sif4HT6$$$00T$w`j?{4?``X z!2g|&hH(d#Yk#|`_d76CUt;Elw(=sO_x~`@_)923wqM+D3lDG-kIihO!)#Rwo!O7- zouTS!Qn)^T_PK?h3L=jAWF+OV$~Kq4K9|O3W{%)etxkr?(aIo>x0@sRA{B)U2n759q0-$ ziqhl69_iBVBu@QpCB=3#8ZNEG!nN(P;bO6n+ofyK>vxth|Iah3b-Gte4-v@mdlP8o z#S~j4yw(2BN*<&10ETzeRn1P+Epq~)C!^Tzmw95*aMl@4tcX{b|8UYQ3~Omz(}&vQ z#10%ZVM9`Xp%P{|5AFrHLMIF=&Mqn93zG-y*h8u=5GLCvF(39MHs_w*X+*-=V<890 znex{ub}?{Xu27v3EG>>#lKl1wXAYb+rIyS7u8?omeWry%!@PMad5-MN=qTsIn9k{cdl7Y9ZISLd`g*fj0iI z{(zyXwG}j<43M|)-VURS*p-36j#KjXmB2;Dxj?(`j%%JCUfye-o^2Nf0|Xn{J5lz9 zsED|^=$&eVLfZV|%P^_8+DF%x=+~=4QjndbX~C{NjqXT=Br-tFIp@D9_6%fg^ffRh zZvO4Ndk70GDZvR)$Cr6rxDd|OPxk-#>g_#Nhw+>`1L@-Mh$yP9vp|fvDh~2eksJ|z z*!9(rm#*R#s#&hvkR^xfb4`SvMI`2Qgp;|Q zmaT6PH`s^$rH*sdyZqv;+BdRRM<;3EyB^OrZI?EH*~a4O;_Q5G;IH{KZ*4+eAN)v8 z6F#ci+UygmI?*x9KK;CHYv`fU8B&Jl7O6NFGhzzU%>7g!bK)#fS*Sn~>xV|9JqiImP z<_*o?E3T;?Zxj5ZR_`z?!$#+@#oH6wa)qm9Tdp;@<|Ika_UP{lHafa;K}&Hx2TXx2 zOfxiQXd?9){!1;{=)!G>@`==(I}-A1O=*X6r z6>nC8^V6wi+kFep508^3) zgr*tXv5jI^@Tau!L)nM1(y{11{7`))X9>w*2W(*2#q(UDS?C{HO>@UtuwbHZKuB>1 zY#B1fs5&$|*bSnm~MDL^i# zWg|<@M(imoi49e0x#~1`Lx@paU_yO0TE0g8L*fXgr)m2S{n?&FCt=B|HM8T5%*ei# zZALQyec^BL>@b)xEY6PB_mQV6KJ1nDWG8r5$4D(CB$^O*@C^zE$(U;F>skU(RHdny zs)sPs$_N7&7IHreVc{zcpH{&@IW>Xw?G=eCnfbPj>@KmW^eiCu8~ph^C_`=LqG|nP1oqq7^t-R^6*=yGL+}5i1~`Bl z>!){pz~z&%gp(-om%7?QM%z!Wqv>(o&kh(? z7l!xjSSkGJBc-@>`S0rx0}iq*CM7elI2p&l$_g*>a+qYu#P9qCA)odT&n9-GfA52b-uSs#nkl2CKP;XQ!L$D65V31+bD|*_lYmMuLG_K#vQ4FE#*9%#=EtiYNaH&c* z{*@StG#iWvY@sRzy;z4Xtc5n>eLq%F()#(OKzwm3Ubi#r`#y-wK*fi)`5P+`B^W`y zV6g`p`Dn*9bSmOL#rHE_f{RM8?#XGUAYp^9__P1R2EP88aAJ`J-8urKRXr?-xO9~m zTEFl` zHBc#WUmab>8+D3vM)i2p3xYZU7D|u++I9`PvtCNqx@tcGsjOK zUzj||bEKjU5k@OX>j4nRalp`KYrXJww=2w77GelDzdO{^;33%1h?&@9`Tb*d_fmye zwo!yzC{L^mMK6c_J&PA@?DT6IC+^8Fr7Kip&MWU2am^xmtg1X8dGdvgKgEBHSx=n9 zM`gn;!bdgQ?9N!?16+J9nJpS|rqmwr6!WNtr4T?zm zRn9~hYTv{+`*Y1KI?Dwobeg~I)cx;!1;L^1&%@G}{e^PPqOf$CkNeAbemnRpUVjTt za@@5HTLthAPoW8m$?oRdE4{JDV9|29G}tWY;kBA=%hK!pH4mt?_R0PjzrJv6h&a4# zsp-;TkG2+qzsN7R+ao>(rnhg>B@!nK3#_SZAG7%@B*gi1jzregH& zRm{;e?ASw7hVfpb91Si|=UbbkjGfaO@i=s0iT-6ZFq}%oj%}v zDV;nwpzz3r^*6`?FjAu^46CTSwI2 z-B4^Tdln~pz2Y1N3Xep+y&AXKHhzB|H~2-`<!+R_B`@2m0&kJSzM&6lm{Z)F6OAs~Fn@engs7vvhCG7{)$c{1UHGxb z3cq;ET>^!+8iaG;{#u$%fthM)-3?NVT~To*AEd^ zJFfN%Cbe90&_2%38^O=XXSg$^jgteEPS<_RR)VK-^jw~v9^gD$@KI`H0v<7dq~E{j z|NMZo@-^K59rTqintBDB>csQwGrAX%4`!WPZfNYxNp~z!<2qO6y$rXg%5!cD^7iv_ zd@AhD7Ju_T*7}F+hEdlCEXCuCA3GkB$=_`qx?~IEb^Iq2G$6N^`{mZpseM-~=mpk= z_ZlbPWspRLdNuk+C30A*t0qOp$7doS5or179o0PqO92D;@@Kgvpd&uH=f$ZKr=_T> zxe8x}Mi%>?cv{ocD@fI|y_@89H#SQ^Mr|Zckd(hNmzr2iYcioBcr*YB@xc=9&7QKX zfSJ{Zl8hlj!L~a}3VO@Sx~{tsh^f*NPol5i+tU*%UMgu{@t8kT-(lSADlLKH<~Ah{*FSSylcF|z(!Y1^W%%?~;OtIo8Cqpd)W zSkfc@0^dc=*_TRQK#ojb0Cns-7f|dbUwa`7oy{V(-KjdI6cckIUQ)b1&S)y1Y*5Acobs|wTr zD86k+-!#VwwZcOEG6LM*T`M*{Jq*rrJ*(wqFN#i#`~*e^{qen)_VuoEsNYL+oiCU1 zJ`?qm#GcIlFZ*{aB7gmDe!*UNs@jnB?NG|AgF?e-V9yQcZHx@rBBOM8|KVxQF-BbJ z@;|&o+W*un)h>PWBahMIh=NJOx!avZb~j+EI2F(b9*?pkLR)LferR(>(Bdz+?ubve zly3K-T06Voqr>zyUIc>Pmg+@5XDTlB>?n8^Vn+=Vmh4FMCH{rdUYvZ#i++fL9wt@a zT%cRCsi*D!Rhz6!=kQG@uG>phCeCzTU{zDf>w1?rJHE_|ueld@lwvN7#0o^=TkBR` zVVIOuvD6I%B-@jc35uvty?+uvqUoYLMu(S>Ey+H2Hy zs=TcU|76I~@;E5+3Mcw9@`L1qFsVrGO+oFiW<$LYS_bITeLC`v9flZvO)&_xbV&m* z`6B8VED421x~G=rArm;~4olS|^~d2Stf; z057YnxUj7MNuNdGQM^fGQ4s%UoMdQof$ffd<0!!w#Twctr(y^Xy6fBR%>xd2U->n{ zqv!9^i&M6})-TxgxZMK|?x0c>$y&gFJ&jS-xEZ--l|T^BQa~Ib1{94_>DQ z8jGEj81Ye`f32%{ZZ{!J#V%2!gXOwZhI?s)s{E-Bu?~A;nd&T{C{tqc8BZlV8N>)I1I+$Z>hVYO|Gf zw)dpM*Vw90(kS?ZC$nC=JF&r^Nr)4>LC{~lOj zT}QMJ;`S9&h^5J{t*FeSeSE=H5FrE38&tn^w?*8xB-Jkcoz_N)q;S2_xSe*zyecbU zyY;}ika)5RSU(xk=va32yCs1H#jWiPzgb^vv*>7jT__WA#fKfmX~Z{&@C#gqC>|f# z68Fh&-1MdgZBV|Lr!pIif9TDzC31_Tzuj|8qgmd(zZ$y5j5u!w-?N)`GUlQQMS^~TIb*d@dq`c^3Au^>~2cZ zdyl>99_Z-f5D6h`3KO?-X-Hhw*z79Il7I1QrIzqEC;#!$ZqKthr5`WD>0kf;gU{i4 z9P=6%N2#vIzzs;=0u}91Z(dk1t`oH?BK$~VNjZKxGF|_cww&^YYs|v7`K;cldF~JJ zmB4milb-Bm9b-ofEV&>i75;6PZT3C3VzW*S+l+fpHSa5bHb;TIWbEO-KA5y!WQ1hZ z)Pk~SnNL>Rg3dB~D6LBZ?AC7a0Kq@IZU#73QFcF8P5h3y&kD)x)(YMztVZ7KtvxjmINcmU?3B1DrOM%2Y3CbGyMC^ZUI+eR@Vq12n5o-`tV+VQmVE6p9n@N24~G={(1_* zum0j0rM#31Mk&pjPEUV9p)BC1>^(B^*7b7%_S!y+v1bTd_+CF*hdyMdVk)3r9)tLG zRhJ@UJg=ZG6^6_}uk#UN@VyKHzl{tc>V-Tq>1*(=(6fd~S@wq(%%(ySj94cbdXLwk z>n0!7y=2p^=tl}wVU*#~TiH{+<61hxqg==OLKP;ZQ04SM?KzEz2wZ5APx{XSA0`GR8$NX+#~_O+>Kk`bg+Kj@RVA`N zNgR#@5e=W{6`Od3Ybkk`pf=tg57Jp#@ls+Oa1m}2PkiC-59u8K_xMS0X54w@6Ee8o z>-tL~QCdyV2ENHvvk|tOaQ3z(7t2P;04Gnc|Ni~UewKTbLZMTTJE##A#kd>5s9W9o zb3EW7FUm&)fi(Th5R}qcCkr<7XSpmG<*?RDyIzAh!M}#=%-v=Z%E5it0?2xNlCM|B z>aL^*zjVXAMu^XDvQfP!o}e>H$^NFdwr4_Q@WJ$Yz4!lu2)ei2A3o5*+l+f+3R4~d z3~dT&2 zao1Sixchs_*U*v@^-2{~f#U>LO(rn_PbIv;34TYpE=V#R+}9t&2EzhR{}h z6r-z!?J^L(=#U_PWX`mFte zbSQ}RLio0hX>*Z?{D+y|e}|z?Lyt_@@oirASJ~rK6ZwukpWpHgZSU`PTDw#HbN7P! zTkrj|wWInqdNwKkBBn0<#}}eg+I^~@d}OMuIO(6?ztg0o3z`8^`54Q{uSjd|Wt_pF zaZ)AH#N7ZZpQ_}~5f;QG&>aSX3YL9~ub4OMDkOe%C3kFQk;$rgygn=~`2U{xzUY6# z{N2#xeNC8(Ot;~@j0NAb=L3R&3sO_6jREB00ycH#mZBDW8P#O;+pGgoeSQOU+YgyH zm6lvL6zkA2)@3Q)a;j+cm$o|x$|Fx0r?}6*T>VpRXHW!fM4~>;qs!2F z3|Ipwv)a%lX&ku?w9BGCcrFoLB@-wF{lTr!fzhZx5aOSV25gs-SvW*~ub(fU3co|h2 zaqqr~%}j2E^|uLM#CgQz3120%GVm4BFv6cB@y-+;@8#gN*?Ch*e1O9 zPukJ5sI&cXOrcG!RD1c)q^)*Lp;k5?VL57&_^xP8Y+eu(tiF273>wdT(6*XL2+PGJ z|Cd+OxI0=p);xR4TNyxMhjY;rTi&kM-T0aS9o}Z_Ufpa7o%MgYIr?MTcG^B>Ma!m< zQlBSneg!uBYiG)-AT%LULrXqDDA?)ow3e=4+FKhBl{>elh8M07n%dpf*EI*qxj;7| ztog%S$wU%SyiL7Z_lPggC;U5gu)st)c=^}h*>S5oPXmm|%gx4%L1I(}Xl$si{Vzf6 zqfQRA1_kJvVVpD)#5?36*K~ZjZ;p0h$EyDbSTCIy^lVyheQ53A?;W60QL`Tj;6~L-o5=qz>Z= z)Sm*hv_@*?kVEuSf>re|B2Vmx`;uwW$AU%0VwYXON#C>K+jblSR673cGiYI1}wU z;+V)+v|i)>WPu#$fIB4-@&T?adw1t)wUT$CNMv7%FsX#P><6hB1IXo1O^yO5fAtgCc2$i1e;%X&8~uZ>dA58K zOnkA2l`E&}PTbr_v*8TRED# z$qSmg>6Z2nBFGb3xt9at>Z{pwC8Z5fIPUA$T)7&-Ju8uBca(}NWW-~4AK1(d(xG{e zD$jmVt{ak^d&sZw=<@$47y8SupB8+W8G46^7<8o=(>>^OGKXRaztp+C{P6_(QsF3v zalj3y_6g@ruIGIFe-_g^o9ycWyUii&GZ&oMd8OHTjimLe7jaD2KgQ3#Gv(xHaHfvE zj*nnk5cnEvufrF|M3o;G%d$z?ty-Dm()sB>9iPlsAZ?LXi&+*1@0CD$4{IQfA5r7N z9r2NdwvUdueQB2$&zHLUr;k6{$b8-~`Oo^EAK&X|u*v&4*q6*_!^-tB8ISpkA*Ej= z`tJQlqMkJIe3`ZO*_XC0iTT)JmVFT}dywgz(kXL)sYNf3-@zjC(_j&7n+6&j%voa>2_M6H$BqI~oF?+9XgZ{j z?4c2er^G{%D3@lv9%~}60E_tce6O+|26))LRvKaUepyO3bMhH*Zo#=P1*dlUTX^5O zzqBhpNfLQ~0b>jjd*~S98Tm;HuWn(Zs+{;V-jiS*>B&?pro;{kTBx)vqSS^KJXC8# z+hRK&Uo_B6%w4?|+P{NEFYj{tS|ctDMrF%F+ZzE4F}7nbz8e9k6x;wIeu)LSGqIdDKXyUm8ZD7aj)1Y&AD~d z1`RZfi1vEa8xBtHHSN#i$vRafdZF7-L$WKaGI?jC+cgP&h{S#IDvimd{{$pA>pju! zuH40;d@t4cpV1c3AfqboaR|TbBIkFPXNMZZ*2(iCu&4Ry3MV)O6Yp0r@|SeMI~3Ce zg$h%aU*u>f$3(+@vv%qyX;Z^})0}oYZuk$R|8%@TlA+5Z68^n2fIl_0wI6G&7wl~3 z6c^F2#o+#JZ!(vAO|1t1fD_C|OIQ?1mR=>ZNy(2TvDI%6+clQI`d+n6L#_x<4RqjD z$~X`4?+&4rB7HYXFix1PxDT0~TFT+Jvvs8P7C`quSsVf4hRM2O3w-=P>zgJnj(e4*YJuEg$DgHbF^`4VU}fvJN0vQsm3Guv6+B%*Yu0$e~4rP z@u)uYKtdi}g(p3-ncU)tK=iO2u^YtwET5Mb|9L@4dbm$)%o{;^_+K|W0l3iB6uO$0 zQNU~b4cCoSwbYjJLOfkJ(q9tqfN}1#6X{WjF2SN&iQe-8?1!euS zUwOLZGkMY+D@8@{F-PTYA(dL9>wf~q0YmaT^4=jsMM>>F;h!QDLpF2{6z<;mak^qG zOMCw9K$jR+ne(vQ^M*g&<(MM%OozDRr|Ecs!gMr#b%z@b0qfu z!QpT((umz?Fy&}5B3s$ni#^h!o!N9nmOB=yfM^ zc>X;~FE9mXJG8g&qi=o{qnytqnX#Zqt!W6#bgh+oJp*y_<{A>U3o;E=fOGeH&;&aP z{p+MD)%Ft@!u8Q^MWw^sqh}1nBCuTd9x=Pv=J7(`${!O)Ion1Pko}^X(Z(^QTJP@_ zFI(KIJHP6@-P@lf4*7%`2=&}G%sSKjmFK0WR-sNUZ;eG6`CR)yzd4dj zX;2g~b)kFl<_i2-$=aR(W;y#+X{C;kjs4G=B?pnY#e4$2kak&F&g*yfH43%{*2fb% z>WLAbRBfx9xuLVQ=pA-H%Ae&ZmJ6=0w_^P?tQWw_W&+Qrn`$cx1iAs?lPg3h+ldwt z3MWI~xeq_+;xTiN5G%Pe@|P9W;G4j&wKUF^%|WLg3u-GrA~yrXs`f9Rz7VU3DU*r2 z3QimK7-d4|ZBI~sto=D|oeG-9UOyTOingZsWhQB9vl;s&!XzS}5$L8C9XG(VsflAs zv!46?*}FIlON;KmD!2~1L+1qT12`=HwYq#IH{4+jpXQVMoUUdH)Df$pYQMe?>z3~dA1$Lp17~;jLWEO zo&UhAAlgVi`LYg|?(&P!33kU2+XAzRd;#)ay_wp+K1kr(q*JK;4D$Jw$Gh6#PRap( z7Aw9{$E4I%%yVK>`StjVmS^VyrtTJ8$o1{`34b6fUhM6ry<=*fTphNScRv+wHZT6ToG1FABJJZ+SKcr#a;!8@gxKp#A zWj-P@qMO)&o1Fg#ZO=^S*%rgDig331^}_jkitALT8goCo6P`PwfI>?Z(R`a6w0~bl z<#$u;X#;PM%!y6EPv#$Y-TDSz}Erowr=;FR@Uierm`i;m4iC`t+ zeYLV63P$b`WoNR4=Sl|)Ul0&& zkWXfwwbZ8H^G>gC_mn{7mdJNZP*G;8H8#J3Lcd2B*{VnNaCO<1R5+Prs}m?#t-nU1 zK7j9^Nesvbd0#gFcJW?qrn*YOdhS9PKb}Gr8n|t2ZPMRe+@tC#G^IF(U8Xd))-t|_ zL1cL>q)>91wKgRQiShM+AHvt>&5L>kt`4NyVct0ggH5Ni!@Ff}1pXBjw!Ns2{*XCV z81(K}RonJVsIJ4)*cn z*9y?iKk{0BD;&i;;H+`}k}f1%*bG3Vq*vu>85f!^6tRTN@7#0G7*RIFvc@BmBn8#; zLn6AJ^Fr$0n5Gle<*ibxG!#9-oVm@WmjB36z;HtO3ap4E(BO~lTW5Yh%1=9Y;(iz# zta}gjNW`OnwJ*j_rOLQk={>d!h1&#WY$-ODi*uaT0IQ13W%!>178>&}FpgiZq z(?#`q*U0H##_Oy6sgfmmtN0p-aVPGVl*<7$HMrH)7D^4HKdBl*vQ-{jqIFj0>)=&B zWG-Er4nFh0AoC*_PI`H*Y5%+j^VyV&OWOL)WxnZIB=a}(_I;B}Erx`^w zgmMYCr#q~91c0AVnj0&eYpY4j>$OowN!+;?>PN)4037(}lVH+r<>)5qQmIV`BdLI|VD= zHl;tc--C(1=Z>DnGvCtVf;$~SM=iCw$OvfI`gfA^SG%{w@Ciqd5Y*tS^)c%Ffs}{J zh*QKcqO}whBI1Mt;xzucE)`A%@}Y!2mis`{xS-SF+qYtzZUV#x$e!aDMO#ZuR5tRZ zxm8L~Es*Dt@J;u`X&NXKA^%sKug@6Ou)Anut2pXs75a>OZKwbO#wz{nc*z7?Ks4;k zi7PB9h43gUlsZ-@O{_%Jvv7QAe)-QHlVU=gFtFx&Qljskr7ObA9nF);tibE0&cZ6> z^ZJ=DV4gRC-9TAxzuQW-?|~y!%;nlAu5~?SGK)`%YJ^%1h6Dvq!05K#_dmZz%V(k} z?X{V;i4RoI(~0qisK_0a2v#$(!f413|2D=2YUWMEa_qi;C-?7{xW$`85Bu6iRo$Zis^zL*|1Zo4XWCy>_)Yd0?JPU zVXIu;iOOWETc(4D)%%|ZZRGdAS?RWlAqBnPA~pQ>11%SjX>%9z!J$90b&9rEGaqJ; zys<+*SezNpEfI+CdR@1Gc5kkGtxM(CQ-nw6BPt9N)voVB!Fo;PeaBn1e8PEU?Ncej z9?8+#1)Mi*;d1m_reqI(F4nWiE7PYLDDYM{zm2f-5_h)aU&+4wpbde&{fKqpLv?QS ziLJtn+(Ty7!x?0)b9p*m&_fQjSH<{YZFDz@m2=#six}}pUtqpht%WY)$wCd`+GkpJ zxt7s)?fh0Z5_^HY_n-U2Fr~#o) z_<9!6_HA^AbwIzceSx#D$Hl`)3cQ4ke%PZm_b?M{aE3JJ*tc_c6L|`r@`z)G&ekv- z1s|Y3voB@cd68jjQZsK|YFo;{geXEAsb%w4=8bsKUsfh#4Die*XgSX-Dp#_d`CyN3 zt@>gv_Eth_I59fv#7*53XV&txe4nXngK2-jgKc%Tld5$#M8ofn%knli@ky>7dZcyy z&l~={SNkgy1)difal`oFALouI`l2@Y`7G`~7WVQ&Z({`zeB)&wZjrZC+KEtMZf`Lm z@2ax8tY*X~jr2!A=7~o3x9aLOXTdvqXDC?%YpTj_+R@KEO?qA^cFW_v2PC-`5^|#4 z;P^Q2O#R>U^DiY#4Yf@?Du+;o_10z4rF@3JuW#2^&-)z90kSXc z2%&&&qUgoHg&tfm<`4lOJ%4HR5pPZz+eQi_J{ zvq^b!`SPk1ESD*DoBC#XGN&fhHD)evc9!@W{i7E7wS*H9!XJPeeh=2w#5Jl`f_4qR zBPvU&r;ze5T|^#qcw+_ItIPqj>Ne~lAM6)k|GGoB`ts&&Plk_HfO0yenGqF~!qJDG zfR5*VK3cYhLaz;5e$(JxMQVp=vii1nJ)&>blC@!7+fT2-)ooUdV1oSKCB1%JVyhTs zA70^fDEXZj%~U!Sp|1R5_c@=AlYeriKB%v4&yPwLS}V(?Z>VnZZ=w(0G7gc2?_BUt zEMVB|WokezK*>vvu`FxsNVXwi{X4lB?b{;j51V^>bf5I;kdPsdH09f%S|TL=Gbqd5 z=TPT)YFP>>HcgVPFwgR95I+MINSR?oz^3iQ?>Oh=HZu}I*2K@xNj&EvE?xwJgkFd~ zBrk=dSTDpy0!GbcfM!8%E;FfFERC*18i2r$0it9o$Z23a5Vv_m8{^I{kO?urZ39v6*!^xSh^?=!m*& zxq4X06w*DPL3S?3gJRAu)x${07YV1d&grAO>4wzXvbUusMtiCox1>BuP8L?SrIr#A zk|zd%jKc20Sjr76uU2}GcE33N`Eb>CJenK(6Vq3o10DI{;bM<9GvcKXI`SlS-O_dr zLsCM!s|t}Ld^!>Y_`{CgcJa`;e2B!fcISXkEl7~beOOR~aQo$-h*?+3V(BwbR53VFqomhy?^p4_ z%Jq*Qt|Vqwl;4CmWp%S0B3!bfx}mAsr*ihDlOv)QwG|y|&2F}3zqF4G-pT@d2GH6L zZ>1al$)YYO{~x&7K{t?fV$Z^djBt+(B`D*Tx-goj0qxa_2B2q}5!Tgsg#^WW)t6xJ@#t>- zY%|`gu#rw%k6wQ{S(To@o!pkg=Mqf=cE@fuasIC7b)*KP>SG6_ zc>H)T4dpD|}rgjx50c@(za z%vM1fG8{;c04jMBOY8A`KEIsd?WM}fN}a%a zmObyVR5}5qc(4P~Kb}cD%$_IP=9?Jn33w_Rk2%WBsL^{DF39CotkIXP3pn$mGqU!(q!t8cM-t)AphM7>ZCSE%p;X5j^xj7Pm1^4U^a zojZl>ycvpo576QbxK(2kCtudcrC*Y`{+usq9$Ezw{Ms@vLsAeJY7LqgE@vQg9LfJ5 z=B3;Exl=O_(r)w(6J{PZj@33CVZBidU&Y^|+93@hom+My3E_ZVlO7UNw_0w>W{=cn zrIyjBblco~uTUO&Go-noJKYhgz7XQmElz%s_a(Tv7qzNzor05ZO9sD ztzW%4eDf^QdV}OtPm+;e)O0*bl((Ek%^Rx41%--!vCd#0dBgMd(71^-=!_~CuLX?c zVo-&??nL}NH($KZoT>gItl;>w@zvPJkpk;?7p`n(<5-IZkXLXCO3*b+)mtXyk1x4u zTpe>2{uD?v0;thh_U_Ko8}(~~fejL0<`F#yF8iI^scb|m;~eq^jJU9e7;voy3QhqzlpYyFDFG0|#>{C-FBw7FYgIM3YB5Tfzash-v`4LPE;O{lPli52Y zFiPIR@&m}J4b#)F8p8INB+Zjhu@z&p1vuQK5(AmJIYDTqzuEQP1>YY?SL4@sQIa;k z$REJ(0@UzYV>2*QKL1;w631`Qb*`ru5=c>^o02en<dn4K)Lk{cNl5SYA^2;V z$9J$*$Ujt0hm%qpb=u;v6T9Iuga)hYBwb#k!J)!Qj$%2V+h_Utx4Gstdc*Z!+!^x2 z+N#H+Cv%kL?74ZJa?zzZoe1n{V-^BxjZ^sV~q8fU=qRzfm22P zc2d0u`7_SN0&!QoVe2}qWpDGi0AxFSbzes$v3*|QVB7kEWK>JV+^9-_Ndn}2G}W{l zRk9t~VYun-wd=)@&akJT-QEj{M{6l^7o=Dmd@R=QYMg~2nUC#IjCpN36wfmy;R1Ok zF9f5OXYj#ygR4S1uQp4ySgi!~tnZylt3&o327fD%UC%kIAoqLqqyS|9Xk6$X^Zl1Z za13qzs&ctt&3C8-Rd&!2kl?3CHnK*==Pi&wn-zvZ=R$mU?)r!AZvm}Ox2a0UZm+PA zG>+*@4!!F8vqUW>#b7N+@$*BUaJtlIV6x}eF^b7CFa03F3hkc*zXC_Ifd77~!X7Xh zX*iyPhfYrP^yqD-hIxPmV4$6@r6Z3Zl4E4~fJ*cG`Ruwvkr5w^(*vD!1PgpMVDAO3sA4 zH4Fw#BTATpxa2lJI^&+s{*Y{4c2_a{?2MB(;TYM#L@d*1MXEvw0sJd&S(~{b90r5y zA!k%&zP{|FuOCF;Tz7`W$J%bK3faB?7C)9A$)SnTj2+@~ilw|T84`lQlE!_IfgW+>a|Jd8{0@u3jQ>w43e4aW3xoP>Lo08!+W~)y+`Q*n1C9r`UQCZwEigNw6FUW5E zOR)}lKSxWG>Sii-JS%PPT0{po8FVWbk)Tt)K(B01P()%)1>8+I<4}}iWOQ#ZVrtf5 zj1-|+ww7TsN}|shh2>at=1tH|Y0^j*B~16rUW(LcVHCm7-p10_43cmF%SaS__Or1( z$uN94@^moRh20X=?Z{s~o3~buo{R=aECQwDQH8*-0s_LH-EQ9J6E5E8I&wH<`5qs- zLSK?9nS&p=r&JZqXD^?-{Zwh;PGb zqA&;7oyBn&9a#TbT{6y*RR0S^-oZnEA`nW?lYi^@ILyg5R<%dS2@9Kno435^)>7KT zXLeMB0&qk>0W>qIk9Xe2F{>Zob6D!BJO09twxTQ|kM>rIyEIlk(1f3LiV~el{e2wT z49TZgH&>qe7Q?YsUYCJr#y=Jz|H%g(HJCW6_&!y49cXE(xR)WTIHWyZAP>PdOoUD;5j0PYm037TtKIL?& zP|QX(p5o2=VvUYGV|NmqPrVHUSSgIV{T}TTunqeC3C+Un%Dwd~Y>M_vcpiUL@lQ-s zxSycx1U~6C(>s-iw{l6Efc_~2IrL5QcG_1GYtJ=YS*R8~8h%E(=N(tA4n5k=RK8m( zSF#{N_C#6J^evU=Tfe;54lH=6Y>fx$^;EM2b9+cM**(2JHxExpd)~gm&IdxVE*y;9<}z*mzxpG^OhE+-=O~A3CL@RtKf#r)-CE;WD&o-@Aau z9s0m#+ZqC3<{wTNX0-s2yMqnJ?dJpQ{1!5EZX9*^TdmZ?>Q|{kw=v15#0=qa_nxzd zxWFl}HL#Ab?krYCZhu^uX9@S5I6g2ANRnt4z%04?4ds?9tBe`H(StBu&sWVz?^Y81 z`W)02WAFh*mPBd5Ld50ylaQ>29(RuZWdlnhzwrkiZ--x|WSp;N+W)!e{J?Oh5MvN6 zQrl~4Zl#pP_HR-)JQ3b8yYOdY!h$ zQRczt=3C)gf+-wAJeGYaTI6={F=Jy*|5$# zz6f)|?QF=?)^{?NpK=D98Le*$|AL5i_1(ty^XEgghXcE{A z1rGkAv5zfl*vS{w39*&X2~jE?U}u#0Teb7@8aqEmL4V*E-J$5vBG!l6t zCToJbY6ho3xZ!E>H6M+p0ag&uIVOjV?R^p&dys8Z!2kXSN14OAJut{iu& z1(n>+jFM$3v6!Bm5;nZ+h&*k#14$S{2WSX!p<#~O3j-t7HCqcCStpL)5i;@x#SN(5 zeNsp<+LtFiM$&0a19~u40NX{fW7`dEYNrFT3}6dQO=8?>nUz+oUZ+hk{RZcF7oefM=1P4`V)xjuHg? zXrTL}Ngn@7emAdgHx@{_HQMMoW@e_Q4Q%CXdHSvJV8!C18V)B-`#lQG=5xWqDM$Ai zCnz$n1B5(A0oOaH^ioV9RH2%J4pUkH?Rnro8~_1NOvxR=rA6sF6aafRjr51v21S=X zhdjiGy$oVhN#=n4!Dz&HD>K2>E5LH`iUZFp!JK|PtD*O}+$Rrj7k{qaz510r{JXIe z1ACIJQo`}Sn#MWqgmXp04`_fPeo-c5U(fGiyPt4PDXV~6C^v?J9P2?higzpHF7s{# zg2#1}OvT3LZVz1p2(qNC%^5LhX<3Sp?f1)v-f`TT&Y@|#T7uuT>K4VHseZ)f)}( z?$*=lD*oLX2cPcNb5*h^5Q04Z%WIq?>?n{yyk0Zrq5${$(JeT*mY3PJk8$yQ@Gq#S zG~deJG0 zTb-_;_{t2v$_j1k@sM^iV?&(e^Xgy1uiJHzlNN6{|>BfJ6f70Ha=}+z6okpmhaD8*p(wTcBD#S3h?w; z4_3TTjtJ&PbQ!(Q$xD;!+R$RreNx;OtQhL0xX@?zxuDv6ED+O5PdU~OP(fTP@b&&t zlWoADJ>Fr06@L{>Vuz&lZH|8MAGzi5SJQa0&qnYK7bwwdcsW zh2lS&#J$_d?RYKeWW^B*S*3S5#UHlrov`}ZJd>ZyX(Vk??REJ`-QH)qNMq@g%c-8H#8}OYC*xb;5;!+sC0>x5=!z2fp*2<$S+XuV zp@PDw+^6(w{8wkdC0sIZ>Me!>6 z`6pfo8YtG^Hl*U|EhC&@pji5fI!QZImBs3XWUrwjqIO>F8si5ifzvVY)bcyyeMIe1 zDy@|wG#f6oa_SLR6Mc2i#?{ETHy>OcX7#FuCy$e)G|Vhc!Iu()|c z8M?WBN3yUeZSR2nJVupWNbDv)n$0O*Zw z(8c75$1wr0tKg|B{;Ws;Hl^-zGpM*OJ(8atOt0M$wu0FaiJWHa4<+5IO||RBam%-) zB-Z@bk9&TJEUTrJUZts-v9V+)A~^*P-sW;_ywwR*CwaL**m0b9Y5 zlP%?d*L)I+2Oo&#_jJO4J7C_=i=>^f4!!O!w$+Cdu*xxR{nBsczQ#7jv`IZ3VkkE_ zS%ck4^{sw2j&C1}nn9_9PgA#oxmK?_*;Xkd6=~E89oP;!Zv_jnMMR8fvqi(>zH-eqIDXYQhsMaib9IPnws2Sy$M*6 z=#m{@W(1?f&3y^n;$|wn59WoOPaS?Md}3RhQd}mEki6GNGJ$K@z}*xtC6e@b-s8!u&+d)`UN^a zK4qm}XkgedyqqYrA^humOMu+ouY#N=6~W@X_rQzSbult{pmv_-XYH;`d4%Tx7=#$4 z`Hs`xHcLhDaHB+=SgBnNGVt6*Bpgm7xtdwpk6kwCn3_9DDv@JmJumm|qXfpyXWJM2 z(~h!5r6MQZ#>~tyfvf=mN=#S^8zfIjAN(jUp3``TTLk$(zfbWK9Qwz*J>Kqp;hQTt zpwW)949O}q5r$^o1d@@DCmn}!mB)n20T$V)H=} z%V$>(52edblwAbER%n7YZ)abdpb2;QqhCe+R$~_kGqze@aj*_*Srb~pzg3&K$Av@A z)P&E!GpXC5k?XWnKD+JNuzS|Vm=lG&){y6iSTTtZeoMzwH&A>j|g_?1?93!fy`L#D+1VV)n|eU>q9KBmbuHZqBBB3Yukgh1)^BSQzEQWam^!X=7LVAia&+4 zJ|y$BgtCGbXgszo{`Gro5q`jk{Kn-^z9%CSanoa9*OA#oct%aB#o;pSCI4JU;9ICl z?RE@>SC0aFwV8m!i&6}Qoxg?3#fRF77@j=XGk<BwSc9v9t1qa#U^W6_B38lpZFCp)7F1m{!t&8_80Ye)XzP0DNtD=USdwyX5y=a; zkn;;Se9X+^MStW5ADZKOP7|}wQ?B=uXTnnseQRi~%~dW3B61TKV>8$DEM_bBbNB7i zq9xb%(|%0!(*^zZx~$3VX~50XRj6kqVsOTTHvdPcmU>CGQ(_fZ?e%SaUZ}M&Xw-{! zNVl_ie|;fw{lbEAOH+ILiT~o18`0KNtfM^*g`P3vpOYRuHJ0PqJz`pHtl56L_4MO< zue6bmamTH0D}edgApGwOn_IJxuhC(nX6QjYU2XOIUG4(hZ5foaqv`F_J25V1b2UrL zUI{AVMPB*QfT@NK>d@r}jG-P2=jF9Th2s$VK5(HkuBbL;v6RiMq4Tod_s*ERBJtzx zL-!7~P2wT1{JnaJonQX`65(SNt!(Z`OLwjpFR>EZ>iEX{d+4o#XIy$bBG$vpB?9)5k!8! zL5i!cV2Xuef?7=^XKtEjR)5f(gjI!@Y{Sq!mD88 z8zVtp614(Y3j5+RQ6Nmz3gNcq5|=rQ!J~x@)S>8dUi7x0QVh^TyJhKQC&$BvLfix{3oLLfAtWFd{pfJL7~|rI4clUK)IQi-}>>lL-~|^GB8)~ zVqj66QUU{q?f$oFq%IJ=s|X9WLJ*~(kE2&hLv}B>Jp2W)JacyAe&hlPp1}fZei?bW zQQ{{UTBu;49^1licY4$ zYl%|$d`p?}dT7s=d9^9uFpg!e`dI@$cUi(^%wy(Fl@*i`*1a9@@Y140Tj8ByNRTzB zL68n08)T?@yo=uZR@NHOV)y#^2Z0{*@_i!@CMy9l?fG?nwsoQ?_SQMs^_SIX_~L|~ zR8O(but|v65ySPfzSy){xO}Z^sqV3Nz#%201P?W&v&jplmD(pA(|VW?(MlBQfp(3# zv+TK%fPGlVAN3<$OHIxtJ`jPQ-!xM6v#SLH$%#nH{!7I#42~u7V<)}-nVowOf@A70 zpf|a6pS2c7b)-+MBBxtQjpZV;NU?&UCyWn6sqWpwOEZtEBv~0gc`lup9W7$KZRhuO zZ@eyBom26*5!!Br?LXsy@(zK!NW|T`=fe#yo)NxB3#fj^ChVm8xFP!GG-+!1>CQVX zyA%qL(b!htBFghej<#HyMt8Yd^ge8_JM5K&wki9{G%G$@`hwuMvTbe4gY<$SWT zMa%O`jRXwyUmqY^fpVwMqffxmK|Xhvd=>H5ff}Cc;YxJBrBc{#l`{qY3|g|?7U{J< zH0Z8s@4>DzH1)Yxn7AXA~djtW1ii!L;Uksj-=uMBKLQHPBbt>&JzdmZ7d zTFv38EY0^HtOT;oA@(kcbQ+b5qH$)TMItno|=89<|>g+RN=FcL&oB?DqEZR{&LJs2}h@{Gj}&jq=+Y zW4^2p5PPof;`7Rnq)V3RW2gw8<{l+`5?L!QDZkPX76zzw9AsF0GbR6KbE@Vl{d^=p zxN2Q%fIcQ6G4{w`G7p@@!Bum08hYFm&%6FOwksGA8noFI4* zq3_o5!U?P2NJyd4Gg8=u!lXgphWrvNv<2z>xszcnd5hcTreh(OIVNiF#T*bm;>L^o zS$h{@_TE~xm)P@AQJ_A#O0?XPbhP5jzJssQx29oHSB}6eEz;aC4)fnfD&l$SrD_hM z1?r0-W9{a>r%eN*u3V#pBZc%={^QyXX%(3o1RZb8^s}x8R#W;{p{8h~9IELWMtA)z zcaB%G)#=0bgq@M1(net;_7ee#qRyb45e{9YjyEnp^+xQAc)k)9Ytd3?myq#V15KG_ ztG^9p9u3bi)GbI~R@i=E75Jhe(j|ySJ2Gn~-(p7ikzdK8sWJGIM25P99-F((+r)Vj zHba$o)Gj<$;0s4bOPQwS!>$*+BL6ijN0ne4t`ZrN_WZ^R|6GJ{9?kO{F!F28i>i-c z;`w6hK^BUR7&K^{-$&p49rursw9_Tp=7P|7yT-*5^xIHPuW9vCqQB}W* zk5NX|=7;)#xSeRR_Xqr{z~x@61f;6hkosRqo?}~&2{3hBo2GMQpbeTb zGxQ1jGqlZ5=I||)-0k)M5`=E+7u{}OwOl!$-_vJa)xAvb+#9C;^cbGxmOgX)>K-uR z9G9Yb@Q@>PfSY4+&FdD(QN)}uDcTs_w*t9h*Inr1dP{Y;_D;96>;!iuWN{r!rKVi$ z+~bin63m?=zPMSgkkdZA$;kgtBR8P+gw{q1@6|0#W}Z5y>hrbG`xb`x(!9i4rybnF z9l*s%0rw>_Q62uGOd{LFS{#vy;OW;)<)Rj$KSs`0UUm?^n?yVj2H?M|`_+RJO?Bz0YG-5}`8qBG4=ks&PT4Zng2o`hz=j}C zfsTKWtIkMkhJMXSZNUy6!bS4|CMvN^t0U*c8QD(>n$?<~9anW_MYpk^a${-OyZ3pf zcdahODXm7gG&i%22u`Ue)~G&!jtc|48#tK=JQBH~0`6Sfu4Mx4f;ot~1_{z9UIGt( z$~8&dwSC4&?bzk5Bab$ocJa9Crv9aMVqJIdhS^yOnFQ&gl+QB#1y>+e&xG`fjWma1OMF5a*+ibfB9-hg*qyp)ad4b)n{RrOSg)MolJ zRbZSs?UPN7k?htGq4Vt!U&%XxQbwz~27_lAVK1w)+h^avCh17I8+(=i>gIz9J?nk_ zodgzqj8ji+{)hy)d_+kHExEmA0c5;qlQbaxX~q=vhYm_kb-!H=f>qep!iT!3sRw|IBH8v!}|75h^T1f0J;5>5AUpD#Z$o($S>mX)*p4l>wley zLm2}TUjO~wGVO0fSELqr!C5ex`sGqTu#nqYG!Xs#9j{zMp&G$K9tF=Mg`0RM<%}Mw zTCq)m$m{C)b>8FwypHMbrgYAOc*|_5D)|)iPNfa;H1=r6%|#indlMv0^5rbdN;=-J zI`NcBY4M|ur)=bJ<47^*07aM;5JGM)w%?YGq( z49SYfd>+i(I&{kND2Xl1zOOasmsc`=lTi*2e2RM@4}bXjC9E_O>ySg;?v--(M+>EF zR2nFacOG6;>(Os)m-W91KOW#GG}FM{kAH#XLL^Pcr*!=`q&ff8-O40^pDcKE}K57GZ33 zF;zJh0In;N3DX>YeTQF0zbmAWM6FS9x5 z>PfJ|U8+06>LREM5^VGcx&s8MRPOMu?cjP&+{BrIf&ZStG;4kZqgMHW3X#8+P+;%Z zPmS8STklmS;NJJOU)sX4#oAHM^y>MlLB1c%CER0`$n0GWq(zT?$9lxAMC43#q%55S zu0jKn-gp2n2Cm+f9njsmIO|ORD@Bo<5sBqt#YJ-W8QC4I1agJW&blCnJ(D;!%~>o_ zL3VE{lo4?G-B&ZCmrvN|tv8E>-@LK{tNR&Kjk_%cQxYEvmuH8 z&vCX-0$QUSu8zpa&D}C?gPcgsY#SS%|5L=Hw-kqZbP0cVZ0qI*m6J^io4gqw?U~3t z32oQlAFx6HYK5N!yrMEWvcJdm zdA+6Pvc51E{1POk*lq@I`D)Fz=|?BYcp4U|OS0)luysZJ@=pAU^$Ryq{2EGr!a9AS zIds7PG8aIWLQ?`Bp^fVXZ2Yu}e_3ztSL|-XHdl;2f1gqSvamBHI zKwvdGP^yI3pP4Hp8Qh6e>M_$I=2Je#DeFJKuH6KTzj*0FyJ#Rv$-hG$Suh{-`#qo0 zNJ&f#d@L_^>IYEFPzff5qvnpIA+G6=*b++#v!Zdsg{fs^&`%Sa=W+3ta+ZDnb|P4! z+e^UjPx6;gK*L8~7 znBe!tcG?|mKx07rD@xZxL&j^m{15Vl1(Lb|m^p@z7)Nb*{s)D^Jf_|a(L5s!{fStH zIz`KmaX_f9Xyu$aq?nNnw$2mKo1bqK-tlKtu!)f(cQ#4ELqcWM^^A2|Z>UEpzI9w;=Dr~UVj{%H&$IG z2T0|tDoilto*MYDzwl=quo_ovjjr&{W#(9wHS}2>`F5=6`6g!k&V9~lz#2u$i#@ts zwM<{9mUYgrzBeD8V<-Mmevx-r+Bv_$JyfndU*?^DN-TDVchPhP9cJ8V>n-K0rZx&?@$_CQ(s&qIW&|mld`6^mTZ^O+p@?|ws%?9EU&2yqE-|M|35#9&pJhQeOGT+d^Fqh-!@IOOU z=n4^L4`R3ziylla(Q|-}T%t}ZCZeo_{irSl`rwXshCWVN+e${=M&F3;+zT)v_=h)O z!8*#-I8Ih;A%2_AJlsh8 zC>S(S9V+OMzm3YrqHH2YrE(>Jz!o5|Yr#5NWVL*9bT+df5{D-E+L@_OOx6~gk>^E| zV*4+005KWm)yuwE&TSj?0LCp>vQKfFKmODY+6TWI!WBF7dZtX|j`aAxY4$`P-Ih(_ zCtE977RnD}?k4&3?(p3$|Dl(N6Xs#G%UAdelIn2v_A6Yf(dXK{gLJoOGaey+nK!#_XA zvUSTS4~<2GBQJq(RS=UhWs7SR`d|Q^^~Bvau+v~nKM^dX@Af+kojCcrSfZ{lXhWf{ zTcte1d~2%Cyrwqec=)|)RK94z)zcC5&2Td^F3Z8E# za&Ld3Z{zKf2g{=wT!It&9!DWjf?QG?6>}85E*h7q4z<5K@`XDH*nKf+O_}8Q`0djiCpmS0_p8>Qffce zwn^Ne`p_2qj4vm~*jAMN_d9mFJXhMy|LLwQ*bNsTD38nn6VXs(MMin-R%=uEiOfm* z+*#R(m5T(4-o?rFjedESPA)y>ZQ0@5Y#`(Bz%3@PO2Hf2vRHb={FVZXD?wr4?`{vl zHJtO}2@_W@{mOApv+>cIgZ949q>CvmAeLJ8U-O@r3l^4LiS(p$r$PwU1BSf^PxQRG zZO@3kNhCQ|mx2VmgN|4&*C*c?OM+dFd*lpU3l!c8U9J?|@4PEPyANnz-STQ}57lPB zx)i-*GzI}v7%ZnIM>qT|cEVp8Q(t+d<~E;|6N34?yBjf>Hy565#aMo<>@tRPE+acO zxd|62u?lR+HawiDFR^Gw+-rWfT}UnlCIe*?r#=vbF4YmV5&1Slj>EG^BKpYbzBEBI zZoaG*B4<%i>atznmpRS4X*+E1?zg$Ln!3Z3n$X|P$`+Fco)+J_blC)+c0^ABPCIVN z%rH1$sjr{0hNqH}0r)tN!C9*vbv#hi6we{2o9vZ~iK9P%)()#$vX13nH;Eyi2Ph6uDS5}flg-j2@^r3D2vA;r;mgGfAD?yD^;3}TeNYsP^?t+ zCbWip62FZ-bo;OZ7Uq*)#yi!p1D{M`%r^%Ml&r1Rc1# zGWvP&kaVDH!@`VTd@5EPig90S1Lw~^sHU9_fN!m;Ph4RRcw-EChDgtnNEAoX0jh43 zvkuf`X32%WXX!ZiXFalpeb))6Bj_HKKaL1LptNuTQ!^9hi*=kwFc&{qOl6(SXtuWB zF~2$eohK%z@6iXkjQDb(5&jWR5lispN8u~-&aLus^rcK=tU36X`vqJAOU0!;9Oha{bYB?{qumf2j8Amjv)30} z{-mEGroYflx<*yVc;@x5~QADq<#zXH-gmD0j9L# zOn{bFRN^BRt2Upt;iO(&Hpmsgdf~c+Q+Y?f4OjJw1kGe_pBUKKX1?ZTM|G? zZ$IdKFTvlE07`l%gFII7_omL@QpVp}fL00q-eUai19^|&Z<+3t%^;gt9$@+%<_g_M zExg;}cbH?_b9UDgovdO`sG;`Ig$vtf3EtsCDGd+p1YVQvf z_2;_>CI`^&ff$gZ`t#ibQ_L}Ss`>0SO+R}z<=qpH@%pv{XL=4}x&YLew?F>k^{j#E zzFhbon7-9PXL{IKKTMZ5Fr6>U%=Awm{`c8yEI$tS6qL=CqsM6ig2`Gd)B< zd+p@?N#y;h-jP!~f>Apis+f$_?t8~T?O85_!l;XN)T#a89Y54Ac}J%%7{XFPYFkF?evo$xQrqdIwr8YX z2k3o4Y6nK@eUR@7QnU2r3*S7{(d@pRboaHqV|L%oojAum7{@AEZ=mjWn#01wG;F!pPKTw?$a$@R>6LVZ03cQ|9t z6D(agwM`kdO`(d01Mu$e83VQ1T&N49{-Lws?(Z2t)YddmTe6F^tn;DYyT51j=v%*w z;qLDlBdLQ^6{Q4=38!WEJ>Qj+T7sSDy2B7U58$MhVCT6pAP*O$mefft#Ryyu(3=Ce z`<7=U4XgoKLEWF?pu(tA3jh~!Ul?0l<65+)M;}@wyzuKGL>-| z2gkSv;?wSoTqbd0Wj@@lqH~$%kITPL>0Ex%&CKQK56u}_>C?KW{;pSSZ+qIvUzZRV zI}JOL*R3z;Ozgq=3k{%s3Te>!)PbD8&;Z(}P#fgTftvif~l+Ox6h9Z*zEO3-it<^x#~_GOi~;{bP{pk*5q?FW|y{ z;5xX6&h?5@ez@*n;JSSeGuNL!`oEsWy6%+D{!qOs`{h$c_7}sS=QboD`=lHvzVFG| ze{Q4wV2fcm^9B3QZL}Y32gsWQ`!8%7`!8+8{w07e2=-sui2ct%{zS0W$c4CZbD11rLaycTUJex9H7@eqbw!8ZTfVzX_rr*jmuJaS&WD4dO&U z)QSGa7QY_87Xv6|5GVQ(Bf1L6l?HL5ztxDQ9m?OCnSQJ@?K)`=$ba=gXiB+9;eK^N=7{}+Jiqpt(mlMXsf(st# zL#;kK$D>d9ODqf=&*@|4c*Y}tiN$1o1m4%!s8?^D$IJ1)#!0>0e*A=y^?WdvlPr)N zm$SHh{W$9@%z^4rEU@C;J^U z*=KdKPaZdu{a#;A_Ir$MA5>8=8@HPsH;{dU3#FhB`}^u-e}3E#*&C1RWWVfdCcC#^ zvL77RUD?&oaEs1F>J#YYcH-jxF*&#B)L;C-%tkA~6<`Quvc(U~Y_tO04CDsc;tggx zsXJ}7g=7#w{RFAI7^xFL9w$iMt&!?T;vE*Zh{O7G77sEO=fE*Dki`@ui>0{G7#e+{ z4>P2yKNiCbESB$YX0fi6ThtL1LzrsX->}>HxRJl1@MjqfyUA<(tr;MmMr5Nkh&9mp zm4d%zHd=!?0`fk=-*TP573}PG8=xD4zm<%?Z$N$^_*D`I~Ahh8h8bp?EOoZ>p^kmc@e{Gnn%?P3LbqC$YtITOg$Gl8Z@&6$9b%{d;+I6eV29zl*<9W`*= zmkT?gOHT$F7RHYH;kdkk<8s;3KHdM335-3ehtDS2hJ~@CMy8kLSCkHH`X6EC`lZE} zgE`Y3Y;+NP4F+;WFx|mM7r~D}zAu>0(wXka+}AclQT`pw?-h4qOh-Xk#1MY3xU)^W zS6tAeC|zvYz2cpt6{V}qbg#IZO}|&XnRi#*D;_nNGv9|Xp9n3)55b4Q9WgL}feRlb zqSF|DnsdYt^Yf1A%pV(UX8!rD|MOn)M@Mv5zp1xne|f}cfUG=_s1a`y4zu#JngOzh zilrT9fRZqt;zPvJ4l_V~kZTPQOFOy&>M{fL2B`ZGZh$wK0Y-wHD-2N2roR9ZEl^)r zATuZphSnVLt|N8VvA$j@bYg z{_h#l^001z2YOrfk%x^2cn(Q)Jn@$JngNCk=LU#pXVkx8JTHX-;@KHBdZ?m=59J0( z&<&868K49}X+yaI@-YL{0J+*wZh%Cy0rHy-P{3?}f(8Q&KV&vQ*l=!u6lQ?N&_aFq z*he2S7+?t(YJdS=3^QyNI^@Ry9S`XSXfRybP4VdeG{B}qx&gWmH!OG@G8*8^FnUEK ze9b;6pMCGo^T<8OY_sKP^cpUUY__l*O z;fHh0gm1g`KUO>r>P%nL8?n1gOe^>(Wh)ML?EzMPSz~(KNY3=nRto;_!9dOnrhm3l z@c$Cz&ji!IST&}9wGz{R0rWyJ{hO7T4$A@c9M1IbR{dEpNcA69{SkQ>{hwR4XTjva zmCy^TX)3(5nx?`lE1wEG$2$V~@JsUH#EujjiVy;-7@9< zS>}fWx@Fpol$NZGCxicZWL~DhLfIn?mq!PU7TO%GC|?k<&-Sx&eWm2LQQSgbSSc74 zg#jh!a0`85rC?MOx!IowoVGEQ?q&d%W}>3wFZsUT0z;VJ1?R#Tq; zwN>A$!HLlJzl`Ese`h7G7eW0V>s)V*u2;XLt86Yzr^On zNstfc@Og1rpBGoyy!Z^Dj|AE8GqS%2`8z@O2UhJAFf{^BdmiJy~MX;mdZ$Z^BO&&hNH z9A*Zn0#Jov;^$<{0F6OzI86MU%xbz{e$34HajSL;_-dc|6fkitC;S~oczdX^HFogP zJ_F&exbPPc-hZr4cz{2`FYnU{KQ>m{SNA_Iz(Ng7-_#qiXPB5C8wA|40JE2s>+1)l z#*5#WS!oN{Kp040!Sp&SZ2_AG@&v*3dY$PFjOh&ktr1LbWK16fdB0$KlbPww8q^RhPblNUtBRz>l|;Uwz8kIt77fCPbanT zc*7R3eMVA4+z@$K{MakI@9GJh)VbDDsPQ2T;kqDouC*nWJpuU}LFzo6)cK6mU}!O5 zI45-hBh>@4dpIX`p&qR5s-i5injUGsSdZNcdH2K?rpyWAS7(glLQrFV9N*Ht29CFJ zp*$Q`WP;A|fxUh>9=TWNc*F$h7TGudy@l!cUY+R$dL#C)_8OVKV~6WW7AW?}Ob1UA zzd&P=x*Qx{YPk3X8jI9TK(05OGd)UYdNiYK06={N(_z32Z5A76HEk9f zuQUDC9y8P1Cvv8zGNxxijni;^kM{TiD_#dMd`@`#cnxJWKHHw_q0-0{x%%GTrl0!N?G|KkoO3td+AK~W=!7# z=$c@<4`ccP$X^Mj`+9!*jmN9C7f-0WSg|?B}CR`W|)IOVJ*ekln zU!X8hTXwRUT8G~Rq{|+i)W(wyfntx5)I$zMX+d0c=A`PY-)~Rhq_(iqyxIyUkSh}G}PBVz+#yxhSXuV9~S5C)>+J*VrKD=o6=s<-8z5srx@~t-A4ZKvUsOwb!MI6(!h^jk+CKm|u| zf(lsaw~kdoE+qdmB@>d@C`^Q45 z&JLNs%dKULoTEOe_dzk{5{>_hrd%hbpAHXGV?b|;_vqz zI)5khitQc~fA6L!$`3SbQ%;g}W3-y25$T5ur~_**|)=dYtb z{)!p+dobI~UuTKG9tQsYoNdTeb{P5F8N-OS(fIh?u|I z6AvI_{Pl)ox{t!0B1Zm7aiKrPzj-=;Rs8W6X5g>eJTreO5`VP}{EgNtw)Zjdw<=sw z4%4ukyvE<<`JBJQEdGs#&gTmL4zu{T805Kvzau(-M;U*60op0}JI44s3-TGk-*KJ4 zCEKLF_)3Q<=YJWZRElvjDPbDJ4Lqn;cx6Voxct9&HSkne}}di;-6lz z{j+UG{=R}?Z=_+rv-P$3w~+I<(Ncyy6gq!b@VC*@8p~dQ{EOgklg{5}#$WVkI4h6l z{B2?U6$UwJH0N)t&R>AU-;o8Jzuk<#5^zk~XxwXMjkG~(c8sgsq zX#?XoX8sBp`1@0@*#3rzzb=pgFQQ?mzsBDii#UIaEc7VxTG07wqd9+zEc7VxERb7| z=KL+z`CG#H8wJpC!QY#Vzu6$q6#OmK`ODcV#lMA|zg3LCx8Rt?$lu7V2L7gSVK2tN zg*t!pw)){O%fMg3MbhR(iN80u8sgs~oxfvSjr^r1E6M~K_S!A4#lOYk*Jc)46x$A+ z-z@l>V4+2^b0D7-{7uyPo5cA05}?lof0G%1&p>`E_?x2h_i&38{}yxpW-HJ7C-!5-C~G;i>33g#Gl>3-)OyJdy0v__fr*RAPrl6jlauF zIDZ2zv}raR`VcyX^Ec2!n`V6==O4rQ8>I7>&G@ScQ05rU-(bdHOOTt7;rtEJ`D-EZ zm%Bv#XpHgK1&+xYgTEs%^4FaUcQO7g(fJ$bkH5+W{x&R;wjD|Q4clUfe|p9Cy{2d4R zsNk=&&fkU2Qv7?9^VgH{_bwcB4*9#h*}&gzF8qq|?@gV*dz=06w`;Q@{=I4D@6Q|3 z!)P`e;-6lzJ;cP{rJ{;bkB0qh(`)hXE%B^r3*9OB4Epeq;IE#A?iBnC@)N;deVxAs zj6dgCMRAPf{553!@{AD96*Pn*? z{c_G9f$P$`g>k6+|X8BL4#U zl^`<3kjU^JiY?a@mUAMDGa`e>DN4XNoJvL_qqtBGi0rpqCo-QuB7fYd6S;G_naGn8 zkv?7l-u1qqS8Of8%ki%FUA^4i&O~rBE}XCgXQS+(sVl`h>6wGZ!JypZ#5?JkgO&uj z*f{Y{dfh>zEwq)r2|x|Tab9B>uU$ayG>-G?HY7M3&AfiPg7ccdcpU)8^g&)nZZsx1 zT<8J3o?oH!I)9_T1joQ@z)CZ(TP0rK;<~t%J$|Jj!P#iw&l430SDkcz*}#hRtr~By zvM7;A-@kMxY65h9416Myy?^OO)G`nkjpN>_FeVOxyl)(5(Zam*637<>i&nr$dB=zP71F849Fb2jRyGkeZ$p$~99^9al z+G&-U)CD*E-6#2VgYL4qdiBmeQ#4Fm(8+Ncj)MS}_n)um~CdkqFNOu@V*`;ZKS0rXV(kPXzM)lb|~S>3*g^ z7)@e(#oHD|r8OQRI}46)J072lW+XeE3(J7)sc-9KSM*1AfPw4}-ZqmR`}&<#d@h=S z?1y^w)PJ&N9 zdO1DOj~w5jbJr#S)(MV3Cyoz;cu;VBSL_jpz^8kDp)G!oS#Rd}pVge>2kbXmaQtcH zc;b2k#|yb|5Qg)3wa)R%^?o?+zFy}zeT|vpT%$v4I|SB?KEV-n*BJIVt~YX7BS=v$ z(pv61`CPVVE$8wgarqGp;HKd6B60a6h~EmweV4d#On_KCfs^_k5tIO;X96en5|Nq) zV$lhl)XVyE?mBa{t+kfZc%5jh07sOWfa?kC3^YFE!VRD?eXUO8PwV{9cxs(aQsCU9bR6F-wc94Cm~L&Uxb;zB{}ULtlgh#Lj5`?O7s5mOTsWxuwkF`~Xx zQ4WYLjS=m^mk)}aT@j1m|3kvFDV7{&KViWAj4_;(QhYGquHzOuNfz1J3WEmY5+h5lNrTgbQGY@ufl|L^UL%?wtnx?Z69uu;iP)teE)m4e5PKOZc+b=v{(OL<%rZIr zY{SoMcz08HcR$_8ZLpARupTO3jW*b^#$baBTu1{-&TrIhaD9y*8_Zjy+rYiaY=cV= z4K~R1yN~gcHM&`fZ_>^3^%~tQb@Xz(!(^5d;XosW|JAZte%Q>-GLY_s9)eNs6J{Am zH$tz1_?|G!AY%7>5FZJ%WD}`>gZNUIWiXk=IZ09SOyXu4qM79+FfddzOGzL($7Gga zh9_jMHk)P8W^R_zWEL+}9s?iylhp>Z1aL}P0441<>t+e}XO?TLb+hc=Y&Of<|Jy8X zgIV6y+p-ognB|^cZm+k-XqM%nib5|CzVWtfmdRVWS=!J7TQL}A$|P=wwlc{;{P^F>(#nhvbO4G>AG4s z%doA6v%_kmS*pQ>RVFPwtzyOcTWyoKbF*a9y89*=q71>%uOJn^iiC7#vk zlIPv0<^ zt{ykt#_^7>+|#P?A)VdEP1l4>_Z)iiE1Is?+XmAu;lgF0ZRa-KbZg)CW4hXJ>!!1A zH=C}B@yz~Tudm(0E5MA_yWNn{zHKy8Lr8V#-ft#1(mKsZGj?zz6{V|R$7Jx($=paq z>FT!ti1CxTk&0wlIvy=1drAHVIf?@O%{CepLM$CuiHv+I$ z@S8yV9s==z;5V<98U4na7VCxscXAGsh{LmR#3|(PhfaSSez8*L zaK%pPnpVn;q7A(5*DJP{H}SR)vR?;{m{+|}0F10iRZMbHp3c%_*d7?qNS zy%m5(drn>_CS0p$HAJ$PM zAgDb2*E+a}CAfJAWYhH!vj)9@AX>x{*fInq`@2wcn*e*CfjMxTy$!S+i@(CLpNks; z|3%MINVx+ZkKd!wuCY7dPhi8yk<^&Ic{H_I92!eRor?;-(-d7siJl7o6~=U0s^YX;xPfg!=+a2EjZ~~tH=KiNXj|zlk^BXZb$2*7C_Is0fM!kdL2jVc?NyA z_K!p$Sc!g&_0|{*MFVWFuyZ~rkFE@VN|uB_P0>gt#UCZMP!0HcB0LL~x}s7)1@FOW zc*CZc-G+}ve3HPIYL(O_$IHTJ$zBY{tKsM^Lg^h%X|S&8gTQFLq~Z&lqVaX2X?HcO zZL?x{(PoXo4#)1vfzd=pmxJ%=Q}B6c!3BfMf{8s-N&t`)v6O~hwgU)-T#s?+p7){d z;KD9!TlIW11ecXbEmn!e8iG^ff5+NF!3xPCMb)WTTM=-ikYYA$Qt{Z@;DgP=XIZg= zBIQ6R?nH`XJ@^p3kn}JdO`_5c|BJ@MW3jG~3|kHOp1uHFNe!v2p2vDW>598kLi$lJ z-%P-VnuOvggFz3D=^avEtqo0k-UE6=8br-U=k-iV2ccm&_Bq)zs}9~DA|c(gq%3Af z)R}UgcG#IFbbO|#OnnfV#@7d-uBXQc5SpoIo+h5&H9=?|iUx1vap2He>3}@5oIm0LZ#Dr{6`zr7Rok_NBt+fP3+AVK zA`_;T`YCvQpxPgX6Qs@`LB9|^(g+T|T<{+_xG>g`ei#Zm=XpQ4B*Y%iufqWSz%dTv zkO!~t@?0gpn-Jf5J`O^yHcE%!JlE`~RH2V@Jq#5p4C|xZh{2v!=&#&#Z=s_8%B{rR z3cU{SL-lL?(p9Oi`8CoA4!UWLzmIi++H$z5yhM zEiF(B3L4eT#5JvD1F+T)dP4bf2Yy#Nb|2J730pye#lmVGr_~BpzKV|)+!!|tYb_6d zVx#&(!J&ke@I5^ezGsFV33dgFYL7Y&k^g@Qmz-h8BC(c4&pzzg@d%_pIe9?uQA*ee z5{i0)1_N@6gmh1PaL2HBNGRnA%Ld^b3FSP`hk|f{gi4AR_uhu(x8%0vomcM#SOo*FjH%0h#C zQdRu1yw!!%JlOqXE0A)Tq`Gf41Zf15V%;C1G}0Q1o|x$F-y5V+Rz{=ZZ3iucO|lj~ zgdO+^J2}&uF9Vv3#x}i45DLOpTElVaH@a>R571rUi!}-VU@a^N`)WXk62sP5H)CHX z!W0i%YjvQYxF?{rjJQ6{W|P5lH*?!uq6pRp@@0~C5JIqy#yY%J`F&4D|(=XFC~I<+TX z8~|5A&cbmq0HpMH;zWW(*_j^YgMw&O_de+l1$ixnard(Cdk|D-KFeSb+?OFaaVA=5 zB#Ij!W8uutqyV=IeB4=(Sv*+r7KcGQi(B%I!)l8L^By^CS=M8ZYPG-~;luqc>Y9$w zX~p{&oS&R6Ecy0etAB!!>}+MRg@{<O#XGs{>nt)W$-yBG`>n#Mzcfs=IhDNbM|9 zt;q71tAo^@^(ayCE_nmQ9+p@Y>Ws!-cpYGUXHjdR0#M?!jld?;ti!R%wF9vC*6=OV zV)84u~eJpmb0)*`hT_heVV2;8gBB%$syKMJpU( zQnLGdxK?l;Wm3BP5fX5WN#zvp&`Kblw(MhpgoUnJ=RkqF57}0~D1#PS&>v4d z!|??;YNPrXIVU#6Q&00Mc~9Bra=D5xf3vEI#j%gM&FHXwkf=G=1t$fCLTh_Lh;?oYt_p&CFid*q z_F$@CaTka4sB;&Sg5Ax~a?8q<}*;=rwvu8+5VW=e^e69n;KjMjQFsZ~y>1lNz1Hyo2&M6P z6V7#xh`3;^+c5_F;P7J75bUmq(gug98(-AqT;s_18CE+T{&+va`Ozd#{BDY$ICop; z@x8z{@OjjU&Ng|fgz-~|vuz%J3c=@5INRl6fuwY|VM7#W*E|XL;3&0pkAdA4XE!Fr zD&F@XHaPp`NvsdGL_fh6C)a|KKf{u;pu{(+7W#02b2>JH55;iWopioY+})9uKqoZ` z&iF1)a;r0830Bku{&)|<9CCgU9=;h%c7*X$%(XBP(vc4q*Y)7;Z4VCT3{nexj;*%? zp|dkwUFZ};bg6uZ6(D_gMycGVe*$-OMl(ruzl|@nFTkW&_e-2y1(}rSeu|MIiAl-s z!jLmLeN0Ms|BEp#nMvi`cGOH^Ql@)cM+~S;s_X8DhA76QChmgZHO@39wNbnSI)ms` z<5okjqj9+2-_eNC5$awnIRt;wt~gCBuoLaV+UPZ>Bdiel-4F0obtZxj7k}vPd?$ja z4|XSD*UmBtyk-%O;&McBtkhczHE%>D$3rF2Sd(u+4%+bZi2C7z#k&#QhWPU>=NG(M z#XArq{x=b2^Mj_hXJZh4h)C~&72&bI>)BY*%ZMdd(Q$N>SE7G=&~g8aNNW>L72!h; zowms0eX$}HjpK++-i;OEu`I$YiRrCEeRUh-AbzTiapvXq^sjgv6zQBPwSR#!tj4_C8tF;X3XY{aF$ zf|MgdZ3f>X)k45wlo|vlt!T9<)EuKGLh9~Tx94Kg{tSYoM-6I;-S68E@4k8eK(9Ix zV>^Ijx&ZAv-R}I8U8Z4_uRUeI=GDl7jSdCHNh!UkV&e$3z{v-ohOal zv@1%5+<7jt^XqgBCwbl82T*79F!3jP@b1 zyvZ)*k^EQ+Y~U)NU>Xq^n@|Cci~bI)ZHkT^5u4NiN_*!$HnrISimaI zcv0;Y2rbS8UadQ@6?Qf@4toPJB>;!%iA`98ja0?58<59^Cl}fa-&3x`_t;IzP*5`O zS=88w8ljjpCKtSg8V=N$9uEa2;vb;KyQuLUocdgq)Zeh+CHzT?j4;IyJ&43k#3%f> z4bO)!OG}F2fv1jH{W}*|w{FBGsMtfD@pX-Ab3CR^1U_fjq_4y-83_s_!*ft!q^NX8 zgoY1?RMa(9U4r;>tYBM&xmSJQn!>d_{17S}7ZrS}DN$914jl!1yS7q?Vz+^tx{gxY zv2_x`i3{cZ3x8Ev8@|V`1iB)MyTc-(-e;)sFI=HSrp4!lf|P&Yd+csFX-1ZdE{+-z z@FzA9t}r93CuX9C9lpo5g-{gPz|#~pN=5Q18d={m41WdrQ8~17P$itAb*fQHdl}|g zWLt}^6|VEDFoh!rS_;hv!50of-N@mVxF|f4LhcorYvC?b1#-5?5f+~Lq1Q%^w6IfO z=>c83DUqX?W~_TY);QY2uWUv_!W}t=Ny+5Vkz-kIp6tSULAqNJt{bGbvN? z?uYasa+oD=auhCAVOPT;`G|bWqE^6?s_-YRMU;rd1tT?6{erI;E1a)0U@1T2MSBHM zh$;~~7!SiEXcZ&sqVrAou6~RQeCpAT$j@zD%~E3bLv9%Lp>22+E;&LP8}&flg~#s4 zCg0PV>=C6k8HZQUg%Uo*CcStejaLiN#bX}gVR%IBXEAtmz-ajI zF=|YK(imTy8wye;qsEkcP>>dtj2fZQyxTFWoeki-x~vO!yFX=kyGv8I|ACnsv(r`# zmp6++S`%|p?T*Lxfj?>EqD8mkqqT0AzzgKUiL97VluEdsgCMctmVx$d}w> zlXk-Q^iD0%p5ud`g5bea&OL!Ih+)R+p2$w;9!yx>li1nZa~uM`donwjE3ti{hwj-4 zudw>HSba(wUX$kwh2f?oV@el_$-L*?97jBZrrYu~%ot)jV8(D{6lM%ddSb> z7S%ChI9vfU27GwFM_u0?<6(11s^ipW@I7Ar2ZBR_xRUKQU8l~3K)5U-jhLhJd} zMR563K%D^X7F0_^&y!Sq1!f`j2xKaS)nDO^;Ztuyrjo3B!SPenYTy8=YF=o)h#Cg< z7gYy9|BI;|;2JDVtp)nU)x}U-y4oBxGt?u{+Y)Lnqe`pqpIQco);oq zHFX|1e|2>U=+{s)pq`p)Hk_(zse^#M+Uf{sv5wjt_^hiwhivQ(^&8--p1KsKbba+V zXsdyG7_zR0>P6^zBXtZ|sRbz zN5N{X)eHr_kH>>LK{vL9GqRS(cgy(2nW_Xt$G^4k5a;8V;w| zF6tHNb652_BM_)A!#@kPA z12d?<+859PsslI~sO|>09i%n{du1!$Q!tl3gDmPM@Y(3?@F(rKSDfK-27(0xo*p$masiV z<#LrYY{S=9&wwju?_%3zR9=2lQ(j?IUg`aWDHpQ>w92*@ zmDm5HDQ_?;Z;bzrDenPS_inO%fy BnaglM&+Fem|G$nFkig8Yz|OMJ>EuBK4DZo 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

=IzKgY6garUn`{<=f_c{ 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

==E8{Pqjs) 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 *XOOg2?!5D)LcAH?wR` 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 TTMP_5K)4E6V_aF!4&(s<(W-u< literal 0 HcmV?d00001 From 810be2c9d28766d068fc90e3b65fb943632abbcc Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 31 Jul 2024 15:19:22 -0400 Subject: [PATCH 002/303] virt start --- salt/hypervisor/defaults.sls | 61 ++++++++++++ salt/libvirt/configbad | 51 ---------- salt/libvirt/init.sls | 3 + salt/manager/tools/sbin/so-minion | 10 +- salt/reactor/createEmptyPillar.sls | 26 +++++ salt/reactor/deleteKey.sls | 11 +++ salt/reactor/setup.sls | 37 ++++++++ salt/reactor/virtReleaseHardware.sls | 67 +++++++++++++ salt/reactor/virtUpdate.sls | 95 +++++++++++++++++++ salt/salt/cloud/cloud.profiles.d/socloud.conf | 66 +++++++++++++ salt/salt/cloud/cloud.provides.d/libvirt.conf | 11 +++ salt/salt/master.sls | 14 +++ salt/setup/virt/searchnode.yaml | 18 ++++ salt/setup/virt/sensor.yaml | 19 ++++ salt/setup/virt/setHostname.sls | 61 ++++++++++++ salt/setup/virt/soinstall.map.jinja | 34 +++++++ 16 files changed, 532 insertions(+), 52 deletions(-) create mode 100644 salt/hypervisor/defaults.sls delete mode 100644 salt/libvirt/configbad create mode 100644 salt/reactor/createEmptyPillar.sls create mode 100644 salt/reactor/deleteKey.sls create mode 100644 salt/reactor/setup.sls create mode 100644 salt/reactor/virtReleaseHardware.sls create mode 100644 salt/reactor/virtUpdate.sls create mode 100644 salt/salt/cloud/cloud.profiles.d/socloud.conf create mode 100644 salt/salt/cloud/cloud.provides.d/libvirt.conf create mode 100644 salt/setup/virt/searchnode.yaml create mode 100644 salt/setup/virt/sensor.yaml create mode 100644 salt/setup/virt/setHostname.sls create mode 100644 salt/setup/virt/soinstall.map.jinja diff --git a/salt/hypervisor/defaults.sls b/salt/hypervisor/defaults.sls new file mode 100644 index 000000000..d1feb6d34 --- /dev/null +++ b/salt/hypervisor/defaults.sls @@ -0,0 +1,61 @@ +hypervisor: + model1: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 128 + free: 128 + disks: + free: + 3: pci_0000_c7_00_0 + 4: pci_0000_c8_00_0 + claimed: + 1: pci_0000_c5_00_0 + 2: pci_0000_c6_00_0 + copper: + free: + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + claimed: {} + sfp: + free: + 5: pci_0000_41_00_0 + 6: pci_0000_41_00_1 + claimed: {} + model2: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 512 + free: 512 + disks: + free: + 3: pci_0000_c8_00_0 + 4: pci_0000_c9_00_0 + 5: pci_0000_c10_00_0 + 6: pci_0000_c11_00_0 + claimed: + 1: pci_0000_c6_00_0 + 2: pci_0000_c7_00_0 + copper: + free: + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + 5: pci_0000_c5_00_0 + 6: pci_0000_c5_00_1 + 7: pci_0000_c5_00_2 + 8: pci_0000_c5_00_3 + claimed: {} + sfp: + free: + 9: pci_0000_41_00_0 + 10: pci_0000_41_00_1 + claimed: {} diff --git a/salt/libvirt/configbad b/salt/libvirt/configbad deleted file mode 100644 index 0cf5f9ef5..000000000 --- a/salt/libvirt/configbad +++ /dev/null @@ -1,51 +0,0 @@ -listen_tls = 0 -listen_tcp = 0 -tls_port = "16514" -tcp_port = "16509" -listen_addr = "0.0.0.0" -unix_sock_group = "root" -unix_sock_ro_perms = "0777" -unix_sock_rw_perms = "0770" -unix_sock_admin_perms = "0700" -unix_sock_dir = "/run/libvirt" -auth_unix_ro = "none" -auth_unix_rw = "none" -auth_tcp = "none" -auth_tls = "none" -tcp_min_ssf = 112 -access_drivers = ["nop"] -key_file = "/etc/pki/libvirt/private/serverkey.pem" -cert_file = "/etc/pki/libvirt/servercert.pem" -ca_file = "/etc/pki/CA/cacert.pem" -crl_file = "/etc/pki/CA/crl.pem" -tls_no_sanity_certificate = 0 -tls_no_verify_certificate = 0 -tls_allowed_dn_list = ["DN1", "DN2"] -tls_priority = "NORMAL" -sasl_allowed_username_list = ["joe@EXAMPLE.COM", "fred@EXAMPLE.COM"] -max_clients = 5000 -max_queued_clients = 1000 -max_anonymous_clients = 20 -min_workers = 5 -max_workers = 20 -prio_workers = 5 -max_client_requests = 5 -admin_min_workers = 1 -admin_max_workers = 5 -admin_max_clients = 5 -admin_max_queued_clients = 5 -admin_max_client_requests = 5 -log_level = 3 -log_filters = "1:qemu 1:libvirt 4:object 4:json 4:event 1:util" -log_outputs = "3:syslog:libvirtd" -audit_level = 2 -audit_logging = 1 -host_uuid = "00000000-0000-0000-0000-000000000000" -host_uuid_source = "smbios" -keepalive_interval = 5 -keepalive_count = 5 -keepalive_required = 1 -admin_keepalive_required = 1 -admin_keepalive_interval = 5 -admin_keepalive_count = 5 -ovs_timeout = 5 diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 4b1fd6969..4e9d0a6af 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -78,3 +78,6 @@ virbr0: - proto: dhcp - require: - network: ens18 + +# virtlogd service may not restart following reboot without this +#semanage permissive -a virtlogd_t diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index 6f14104c3..e1cd48473 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -59,7 +59,11 @@ for i in "$@"; do -i=*|--ip=*) MAINIP="${i#*=}" shift - ;; + ;; + -c=*|--cpu=*) + CORECOUNT="${i#*=}" + shift + ;; -*|--*) echo "Unknown option $i" exit 1 @@ -637,6 +641,10 @@ case "$OPERATION" in updateMineAndApplyStates ;; + "addVirt") + setupMinionFiles + ;; + "delete") deleteMinionFiles deleteMinion diff --git a/salt/reactor/createEmptyPillar.sls b/salt/reactor/createEmptyPillar.sls new file mode 100644 index 000000000..95e41eef6 --- /dev/null +++ b/salt/reactor/createEmptyPillar.sls @@ -0,0 +1,26 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +#!py + +import logging +import salt.client +local = salt.client.LocalClient() +from subprocess import call +import yaml + +import os + +def run(): + #logging.error("createEmptyPillar reactor: data: %s" % data) + vm_name = data['kwargs']['name'] + logging.error("createEmptyPillar reactor: vm_name: %s" % vm_name) + pillar_root = '/opt/so/saltstack/local/pillar/minions/' + pillar_files = ['adv_' + vm_name + '.sls', vm_name + '.sls'] + for f in pillar_files: + if not os.path.exists(pillar_root + f): + os.mknod(pillar_root + f) + + return {} diff --git a/salt/reactor/deleteKey.sls b/salt/reactor/deleteKey.sls new file mode 100644 index 000000000..646e17948 --- /dev/null +++ b/salt/reactor/deleteKey.sls @@ -0,0 +1,11 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +remove_key: + wheel.key.delete: + - args: + - match: {{ data['name'] }} + +{% do salt.log.info('deleteKey reactor: deleted minion key: %s' % data['name']) %} diff --git a/salt/reactor/setup.sls b/salt/reactor/setup.sls new file mode 100644 index 000000000..b8c5ad16c --- /dev/null +++ b/salt/reactor/setup.sls @@ -0,0 +1,37 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +#!py + +import logging +import salt.client +local = salt.client.LocalClient() +from subprocess import call +import yaml + +def run(): + minionid = data['id'] + hv_name = 'jppvirt' + DATA = data['data'] + logging.error("setup reactor: %s " % DATA) + + vm_out_data = { + 'cpu': DATA['CPU'], + 'memory': DATA['MEMORY'], + 'disks': DATA['DISKS'], + 'copper': DATA['COPPER'], + 'sfp': DATA['SFP'] + } + + logging.error("setup reactor: vm_out_data: %s " % vm_out_data) + + with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + minionid + ".sls", 'w') as f: + yaml.dump(vm_out_data, f, default_flow_style=False) + + rc = call("NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVirt -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -a=" + DATA['INTERFACE'] + " -c=" + str(DATA['CORECOUNT']) + " -d='" + DATA['NODE_DESCRIPTION'] + "'", shell=True) + + logging.error('setup_reactor: rc: %s' % rc) + + return {} diff --git a/salt/reactor/virtReleaseHardware.sls b/salt/reactor/virtReleaseHardware.sls new file mode 100644 index 000000000..6211fc611 --- /dev/null +++ b/salt/reactor/virtReleaseHardware.sls @@ -0,0 +1,67 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +#!py + +import logging +import salt.client +local = salt.client.LocalClient() +from subprocess import call +import yaml + +import os + +def run(): + + def release_compute(hw_type): + compute = hv_data['hypervisor']['hardware'][hw_type] + compute.update({'free': compute.get('free') + vm_data.get(hw_type)}) + logging.error("virtReboot reactor: claiming %s compute: %s " % (hw_type,compute)) + + def release_pci(hw_type): + free_hw = hv_data['hypervisor']['hardware'][hw_type]['free'] + for hw in vm_data[hw_type]: + f_hw = {hw: hv_data['hypervisor']['hardware'][hw_type]['claimed'].pop(hw)} + free_hw.update(f_hw) + logging.error("virtReleaseHardware reactor: released %s: %s" % (hw_type, f_hw)) + + + + vm_name = data['name'] + hv_name = 'jppvirt' + + with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls") as f: + try: + vm_data=yaml.safe_load(f) + logging.error("virtReleaseHardware reactor: vm_data %s " % vm_data) + #logging.error(yaml.safe_load(f)) + except yaml.YAMLError as exc: + logging.error(exc) + + with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + hv_name + ".sls") as f: + try: + hv_data=yaml.safe_load(f) + logging.error("virtReleaseHardware reactor: hv_data: %s " % hv_data) + #logging.error(yaml.safe_load(f)) + except yaml.YAMLError as exc: + logging.error(exc) + + for hw_type in ['disks', 'copper', 'sfp']: + release_pci(hw_type) + + for hw_type in ['cpu', 'memory']: + release_compute(hw_type) + + # update the free hardware for the hypervisor + with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + hv_name + ".sls", 'w') as f: + yaml.dump(hv_data, f, default_flow_style=False) + + # remove the old vm_data file since the vm has been purged + os.remove("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls") + # remove minion pillar files + os.remove("/opt/so/saltstack/local/pillar/minions/adv_" + vm_name + ".sls") + os.remove("/opt/so/saltstack/local/pillar/minions/" + vm_name + ".sls") + + return {} diff --git a/salt/reactor/virtUpdate.sls b/salt/reactor/virtUpdate.sls new file mode 100644 index 000000000..e44bc8070 --- /dev/null +++ b/salt/reactor/virtUpdate.sls @@ -0,0 +1,95 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +#!py + +import logging +import salt.client +local = salt.client.LocalClient() +from subprocess import call +import yaml + + +def run(): + + def claim_compute(hw_type): + compute = hv_data['hypervisor']['hardware'][hw_type] + compute.update({'free': compute.get('free') - vm_data.get(hw_type)}) + logging.error("virtUpdate reactor: claiming %s compute: %s " % (hw_type,compute)) + + + def claim_pci(hw_type): + claimed_hw = hv_data['hypervisor']['hardware'][hw_type]['claimed'] + # if a list of devices was defined + if type(vm_data[hw_type]) == list: + for hw in vm_data[hw_type]: + c_hw = {hw: hv_data['hypervisor']['hardware'][hw_type]['free'].pop(hw)} + claimed_hw.update(c_hw) + host_devices.append(c_hw[hw]) + #hv_data['hypervisor']['hardware'][hw_type].update({'claimed': claimed_hw}) + # if a number of devices was defined + else: + n = vm_data[hw_type] + vm_data[hw_type] = [] + # grab the first number of devices as defined for the node type + claiming_hw = list(hv_data['hypervisor']['hardware'][hw_type]['free'].items())[:n] + logging.error("virtUpdate reactor: claiming %s hardware: %s " % (hw_type,claiming_hw)) + # claiming_hw is a list of tuples containing (numerical_id, pci_id) + # claiming_hw example: [(1, 'pci_0000_c4_00_0'), (2, 'pci_0000_c4_00_1')] + for hw in claiming_hw: + c_hw = {hw[0]: hv_data['hypervisor']['hardware'][hw_type]['free'].pop(hw[0])} + claimed_hw.update(c_hw) + vm_data[hw_type].append(hw[0]) + host_devices.append(hw[1]) + logging.error("virtUpdate reactor: claimed_hw: %s " % claimed_hw) + + vm_name = data['name'] + hv_name = 'jppvirt' + host_devices = [] + + with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls") as f: + try: + vm_data=yaml.safe_load(f) + logging.error("virtUpdate reactor: vm_data %s " % vm_data) + #logging.error(yaml.safe_load(f)) + except yaml.YAMLError as exc: + logging.error(exc) + + with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + hv_name + ".sls") as f: + try: + hv_data=yaml.safe_load(f) + logging.error("virtUpdate reactor: hv_data: %s " % hv_data) + #logging.error(yaml.safe_load(f)) + except yaml.YAMLError as exc: + logging.error(exc) + + local.cmd('jppvirt', 'virt.stop', ['name=' + vm_name]) + + for hw_type in ['disks', 'copper', 'sfp']: + claim_pci(hw_type) + + for hw_type in ['cpu', 'memory']: + claim_compute(hw_type) + + logging.error("virtUpdate reactor: host_devices: %s " % host_devices) + + # update the claimed hardware for the hypervisor + with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + hv_name + ".sls", 'w') as f: + yaml.dump(hv_data, f, default_flow_style=False) + + # since the original hw request provided was a count of hw instead of specific pci ids + # we need to update the vm_data file with the assigned pci ids that were claimed + # update the vm_data file with the hardware it claimed + logging.error("virtUpdate reactor: new vm_data: %s " % vm_data) + with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls", 'w') as f: + yaml.dump(vm_data, f, default_flow_style=False) + + mem = vm_data['memory'] * 1024 + r = local.cmd('jppvirt', 'virt.update', ['name=' + vm_name, 'mem=' + str(mem), 'cpu=' + str(vm_data['cpu']), 'host_devices=' + str(host_devices)]) + logging.error("virtUpdate reactor: virt.update: %s" % r) + + local.cmd('jppvirt', 'virt.start', ['name=' + vm_name]) + + return {} diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf b/salt/salt/cloud/cloud.profiles.d/socloud.conf new file mode 100644 index 000000000..c410fd7c3 --- /dev/null +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf @@ -0,0 +1,66 @@ +searchnode: + provider: local-kvm + base_domain: jppol9vm + ip_source: qemu-agent + ssh_username: jpatterson + private_key: /home/jpatterson/.ssh/id_rsa + sudo: True + # /tmp is mounted noexec.. do workaround + deploy_command: sh /tmp/.saltcloud-*/deploy.sh + script_args: -F -x python3 stable 3006.1 + # grains to add to the minion + #grains: + # clones-are-awesome: true + # override minion settings + minion: + master: jppvirt + master_port: 4506 + startup_states: sls + sls_list: + - setHostname + +sensor: + provider: local-kvm + base_domain: jppol9vm + ip_source: qemu-agent + ssh_username: jpatterson + private_key: /home/jpatterson/.ssh/id_rsa + sudo: True + #preflight_cmds: + # - echo "do something" + # - hostname + # /tmp is mounted noexec.. do workaround + deploy_command: sh /tmp/.saltcloud-*/deploy.sh + script_args: -F -x python3 stable 3006.1 + # the destination directory will be created if it doesn't exist + #file_map: + # /srv/salt/filemap.txt: /remote/path/to/use/custom/filemap.txt + #inline_script: + # - echo "SLEEPING" + # - hostname + # grains to add to the minion + #grains: + # clones-are-awesome: true + # override minion settings + minion: + master: jppvirt + master_port: 4506 + startup_states: sls + sls_list: + - setHostname + +core: + provider: local-kvm + base_domain: jppol9vm + ip_source: qemu-agent + ssh_username: jpatterson + private_key: /home/jpatterson/.ssh/id_rsa + sudo: True + deploy_command: sh /tmp/.saltcloud-*/deploy.sh + script_args: -F -x python3 stable 3006.1 + minion: + master: jppvirt + master_port: 4506 + startup_states: sls + sls_list: + - setHostname diff --git a/salt/salt/cloud/cloud.provides.d/libvirt.conf b/salt/salt/cloud/cloud.provides.d/libvirt.conf new file mode 100644 index 000000000..8c57cc1e5 --- /dev/null +++ b/salt/salt/cloud/cloud.provides.d/libvirt.conf @@ -0,0 +1,11 @@ +# Set up a provider with qemu+ssh protocol +#kvm-via-ssh: +# driver: libvirt +# url: qemu+ssh://jpatterson@jppvirt/system?socket=/var/run/libvirt/libvirt-sock + +# Or connect to a local libvirt instance +local-kvm: + driver: libvirt + url: qemu:///system + # work around flag for XML validation errors while cloning + validate_xml: no diff --git a/salt/salt/master.sls b/salt/salt/master.sls index 6e320e4a6..84e18b8fc 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -47,6 +47,20 @@ salt_master_service: - file: engines_config - order: last +# we need to managed adding the following to salt-master config if there are hypervisors +#reactor: + #- salt/cloud/*/creating': + #- salt/cloud/*/requesting +# - 'salt/cloud/*/deploying': +# - /srv/salt/reactor/createEmptyPillar.sls +# - 'setup/so-minion': +# - /srv/salt/reactor/setup.sls +# - 'salt/cloud/*/created': +# - /srv/salt/reactor/virtUpdate.sls +# - 'salt/cloud/*/destroyed': +# - /srv/salt/reactor/virtReleaseHardware.sls +# - /srv/salt/reactor/deleteKey.sls + {% else %} {{sls}}_state_not_allowed: diff --git a/salt/setup/virt/searchnode.yaml b/salt/setup/virt/searchnode.yaml new file mode 100644 index 000000000..f48502b94 --- /dev/null +++ b/salt/setup/virt/searchnode.yaml @@ -0,0 +1,18 @@ +MAINIP: +MNIC: eth0 +NODE_DESCRIPTION: 'virt search' +ES_HEAP_SIZE: +PATCHSCHEDULENAME: +INTERFACE: bond0 +NODETYPE: SEARCHNODE +CORECOUNT: 16 +LSHOSTNAME: +LSHEAP: +CPUCORES: 16 +IDH_MGTRESTRICT: +IDH_SERVICES: +CPU: 16 +MEMORY: 32 +DISKS: 1 +COPPER: 0 +SFP: 0 diff --git a/salt/setup/virt/sensor.yaml b/salt/setup/virt/sensor.yaml new file mode 100644 index 000000000..e4946bc1e --- /dev/null +++ b/salt/setup/virt/sensor.yaml @@ -0,0 +1,19 @@ +MAINIP: +MNIC: eth0 +NODE_DESCRIPTION: 'virt sensor' +ES_HEAP_SIZE: +PATCHSCHEDULENAME: +INTERFACE: bond0 +NODETYPE: SENSOR +CORECOUNT: 4 +LSHOSTNAME: +LSHEAP: +CPUCORES: 4 +IDH_MGTRESTRICT: +IDH_SERVICES: +CPU: 16 +MEMORY: 16 +DISKS: 1 +COPPER: + - 1 +SFP: 2 diff --git a/salt/setup/virt/setHostname.sls b/salt/setup/virt/setHostname.sls new file mode 100644 index 000000000..e77ebd5a7 --- /dev/null +++ b/salt/setup/virt/setHostname.sls @@ -0,0 +1,61 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +{% from 'soinstall.map.jinja' import DATA %} + +setHostname_{{grains.id.split("_") | first}}: + network.system: + - name: {{grains.id.split("_") | first}} + - enabled: True + - hostname: {{grains.id.split("_") | first}} + - apply_hostname: True + +create_pillar: + event.send: + - name: setup/so-minion + - data: + MAINIP: {{ DATA.MAINIP }} + MNIC: {{ DATA.MNIC }} + NODE_DESCRIPTION: '{{ DATA.NODE_DESCRIPTION }}' + ES_HEAP_SIZE: {{ DATA.ES_HEAP_SIZE }} + PATCHSCHEDULENAME: {{ DATA.PATCHSCHEDULENAME }} + INTERFACE: {{ DATA.INTERFACE }} + NODETYPE: {{ DATA.NODETYPE }} + CORECOUNT: {{ DATA.CORECOUNT }} + LSHOSTNAME: {{ DATA.LSHOSTNAME }} + LSHEAP: {{ DATA.LSHEAP }} + CPUCORES: {{ DATA.CPUCORES }} + IDH_MGTRESTRICT: {{ DATA.IDH_MGTRESTRICT }} + IDH_SERVICES: {{ DATA.IDH_SERVICES }} + CPU: {{ DATA.CPU }} + MEMORY: {{ DATA.MEMORY }} + DISKS: {{ DATA.DISKS }} + COPPER: {{ DATA.COPPER }} + SFP: {{ DATA.SFP }} + + +# set event for firewall rules - so-firewall-minion + +clean_sls_list: + file.line: + - name: /etc/salt/minion + - match: 'sls_list:' + - mode: delete + +clean_setHostname: + file.line: + - name: /etc/salt/minion + - match: '- setHostname' + - mode: delete + - onchanges: + - file: clean_sls_list + +set_highstate: + file.replace: + - name: /etc/salt/minion + - pattern: 'startup_states: sls' + - repl: 'startup_states: highstate' + - onchanges: + - file: clean_setHostname diff --git a/salt/setup/virt/soinstall.map.jinja b/salt/setup/virt/soinstall.map.jinja new file mode 100644 index 000000000..1c82fe3dd --- /dev/null +++ b/salt/setup/virt/soinstall.map.jinja @@ -0,0 +1,34 @@ +{# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. #} + +{% set nodetype = grains.id.split("_") | last %} +{% import_yaml nodetype ~ '.yaml' as DATA %} +{% set total_mem = grains.mem_total %} + +{% do DATA.update({'MAINIP': grains.ip_interfaces.get(DATA.MNIC)[0]}) %} +{% do DATA.update({'CORECOUNT': grains.num_cpus}) %} +{% do DATA.update({'CPUCORES': grains.num_cpus}) %} + + +{% if nodetype = "searchnode" %} + +{% do DATA.update({'LSHOSTNAME': grains.host}) %} + +{# this replicates the function es_heapsize in so-functions #} +{% if total_mem < 8000 %} +{% set ES_HEAP_SIZE = "600m" %} +{% elif total_mem >= 100000 %} +{% set ES_HEAP_SIZE = "25000m" %} +{% else %} +{% set ES_HEAP_SIZE = total_mem / 3 %} +{% if ES_HEAP_SIZE > 25000 %} +{% set ES_HEAP_SIZE = "25000m" %} +{% else %} +{% set ES_HEAP_SIZE = ES_HEAP_SIZE ~ "m" %} +{% endif %} +{% endif %} +{% do DATA.update({'ES_HEAP_SIZE': ES_HEAP_SIZE}) %} + +{% endif %} From 52e52f35f79aab950617ee846221e5ebfbb8ecdb Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 31 Jul 2024 15:49:32 -0400 Subject: [PATCH 003/303] hyper setup init --- salt/firewall/defaults.yaml | 13 +++++++++++++ salt/manager/tools/sbin/so-firewall-minion | 3 +++ setup/so-setup | 10 ++++++++++ setup/so-whiptail | 3 +++ 4 files changed, 29 insertions(+) diff --git a/salt/firewall/defaults.yaml b/salt/firewall/defaults.yaml index fc5368e12..c9b864a18 100644 --- a/salt/firewall/defaults.yaml +++ b/salt/firewall/defaults.yaml @@ -12,6 +12,7 @@ firewall: eval: [] fleet: [] heavynode: [] + hypervisor: [] idh: [] import: [] localhost: @@ -471,6 +472,15 @@ firewall: - elastic_agent_control - elastic_agent_data - elastic_agent_update + hypervisor: + portgroups: + - yum + - docker_registry + - influxdb + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + - sensoroni customhostgroup0: portgroups: [] customhostgroup1: @@ -523,6 +533,9 @@ firewall: desktop: portgroups: - salt_manager + hypervisor: + portgroups: + - salt_manager self: portgroups: - syslog diff --git a/salt/manager/tools/sbin/so-firewall-minion b/salt/manager/tools/sbin/so-firewall-minion index 66a0afcea..4b0fb766e 100755 --- a/salt/manager/tools/sbin/so-firewall-minion +++ b/salt/manager/tools/sbin/so-firewall-minion @@ -82,4 +82,7 @@ fi 'DESKTOP') so-firewall includehost desktop "$IP" --apply ;; + 'HYPERVISOR') + so-firewall includehost hypervisor "$IP" --apply + ;; esac diff --git a/setup/so-setup b/setup/so-setup index bd8a8c6ba..005bf903d 100755 --- a/setup/so-setup +++ b/setup/so-setup @@ -624,6 +624,16 @@ if ! [[ -f $install_opt_file ]]; then set_minion_info whiptail_end_settings + elif [[ $is_hypervisor ]]; then + info "Setting up as node type hypervisor" + check_requirements + networking_needful + collect_mngr_hostname + add_mngr_ip_to_hosts + check_manager_connection + set_minion_info + whiptail_end_settings + fi if [[ $waitforstate ]]; then diff --git a/setup/so-whiptail b/setup/so-whiptail index d950f2921..b25682acd 100755 --- a/setup/so-whiptail +++ b/setup/so-whiptail @@ -681,6 +681,7 @@ whiptail_install_type_dist_existing() { "HEAVYNODE" "Sensor + Search Node " \ "IDH" "Intrusion Detection Honeypot Node " \ "RECEIVER" "Receiver Node " \ + "HYPERVISOR" "Hypervisor Node " \ 3>&1 1>&2 2>&3 # "HOTNODE" "Add Hot Node (Uses Elastic Clustering)" \ # TODO # "WARMNODE" "Add Warm Node to existing Hot or Search node" \ # TODO @@ -713,6 +714,8 @@ whiptail_install_type_dist_existing() { is_receiver=true elif [ "$install_type" = 'DESKTOP' ]; then is_desktop=true + elif [ "$install_type" = 'HYPERVISOR' ]; then + is_hypervisor=true fi local exitstatus=$? From 5a24a7775e7c2b63851bf0a82e3930ffb57f16bf Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 31 Jul 2024 15:57:43 -0400 Subject: [PATCH 004/303] salt 3006.1 - avoid some cloud/virt bug in later version --- salt/salt/master.defaults.yaml | 2 +- salt/salt/minion.defaults.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/salt/salt/master.defaults.yaml b/salt/salt/master.defaults.yaml index 19677f70b..fc7a6ae16 100644 --- a/salt/salt/master.defaults.yaml +++ b/salt/salt/master.defaults.yaml @@ -1,4 +1,4 @@ # version cannot be used elsewhere in this pillar as soup is grepping for it to determine if Salt needs to be patched salt: master: - version: 3006.6 + version: 3006.1 diff --git a/salt/salt/minion.defaults.yaml b/salt/salt/minion.defaults.yaml index 2e4ebc93e..0aa315264 100644 --- a/salt/salt/minion.defaults.yaml +++ b/salt/salt/minion.defaults.yaml @@ -1,6 +1,6 @@ # version cannot be used elsewhere in this pillar as soup is grepping for it to determine if Salt needs to be patched salt: minion: - version: 3006.6 + version: 3006.1 check_threshold: 3600 # in seconds, threshold used for so-salt-minion-check. any value less than 600 seconds may cause a lot of salt-minion restarts since the job to touch the file occurs every 5-8 minutes by default service_start_delay: 30 # in seconds. From fcf859ffedde3ed209bc7ab6e8b332538620c8e1 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 5 Aug 2024 14:53:11 -0400 Subject: [PATCH 005/303] start adding bridge for hyper --- setup/so-functions | 23 +++++++++++++++++++++++ setup/so-setup | 1 + 2 files changed, 24 insertions(+) diff --git a/setup/so-functions b/setup/so-functions index 870aa77d2..7b3e7e507 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -740,6 +740,29 @@ configure_network_sensor() { return $err } +configure_hyper_bridge() { + info "Setting up hypervisor bridge" + info "Checking $MNIC is using static or DHCP" + sod=$(nmcli -f ipv4.method con show $MNIC) + + # Create the bond interface only if it doesn't already exist + nmcli -f name,uuid -p con | grep -q br0 + local found_int=$? + + if [[ $found_int != 0 ]]; then + nmcli con add ifname br0 type bridge con-name br0 >> "$setup_log" 2>&1 + fi + + # as mgmt interface as slave + nmcli con add type bridge-slave ifname "$MNIC" master br0 + + local err=0 + nmcli con down "$MNIC" + nmcli con up br0 + + return $err +} + copy_salt_master_config() { title "Copy the Salt master config template to the proper directory" diff --git a/setup/so-setup b/setup/so-setup index 005bf903d..5ae0a5218 100755 --- a/setup/so-setup +++ b/setup/so-setup @@ -628,6 +628,7 @@ if ! [[ -f $install_opt_file ]]; then info "Setting up as node type hypervisor" check_requirements networking_needful + configure_hyper_bridge collect_mngr_hostname add_mngr_ip_to_hosts check_manager_connection From a6f1a0245aa0f3b7441b81a3f4aadeece805403c Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 6 Aug 2024 12:33:09 -0400 Subject: [PATCH 006/303] configure bridge during setup --- setup/so-functions | 34 +++++++++++++++++++++++++--------- 1 file changed, 25 insertions(+), 9 deletions(-) diff --git a/setup/so-functions b/setup/so-functions index 7b3e7e507..1931180ef 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -742,25 +742,41 @@ configure_network_sensor() { configure_hyper_bridge() { info "Setting up hypervisor bridge" - info "Checking $MNIC is using static or DHCP" - sod=$(nmcli -f ipv4.method con show $MNIC) - + info "Checking $MNIC ipv4.method is auto or manual" + ipmethod=$(nmcli -f ipv4.method con show "$MNIC" | cut -d ':' -f 2 | xargs) + info "ipv4.method found $ipmethod" # Create the bond interface only if it doesn't already exist nmcli -f name,uuid -p con | grep -q br0 local found_int=$? if [[ $found_int != 0 ]]; then + info "Creating bridge br0" nmcli con add ifname br0 type bridge con-name br0 >> "$setup_log" 2>&1 fi - # as mgmt interface as slave - nmcli con add type bridge-slave ifname "$MNIC" master br0 + # add mgmt interface as slave + logCmd "nmcli con add type bridge-slave ifname $MNIC master br0" - local err=0 - nmcli con down "$MNIC" - nmcli con up br0 + # if static ip was set transfer settings to the bridge + if [[ "$ipmethod" == "manual" ]]; then + local addresses=$(nmcli -f ipv4.addresses con show "$MNIC" | cut -d ':' -f 2 | xargs) + local gateway=$(nmcli -f ipv4.gateway con show "$MNIC" | cut -d ':' -f 2 | xargs) + local dns=$(nmcli -f ipv4.dns con show "$MNIC" | cut -d ':' -f 2 | xargs) + local dnssearch=$(nmcli -f ipv4.dns-search con show "$MNIC" | cut -d ':' -f 2 | xargs) + # will need to check for proxy + #local proxy= - return $err + logCmd "nmcli con mod br0 ipv4.addresses $addresses" + logCmd "nmcli con mod br0 ipv4.gateway $gateway" + logCmd "nmcli con mod br0 ipv4.dns $dns" + logCmd "nmcli con mod br0 ipv4.dns-search $dns-search" + logCmd "nmcli con mod br0 ipv4.method manual" + logCmd "nmcli con up br0" + # we cant bring down MNIC here since it would disrupt ssh sessions. we will need to bring it down at the end of the first highstate + # network comms will take place on MNIC until it is brought down and switches to br0 + fi + + return } copy_salt_master_config() { From 9d2c5d54b0c450a4de59e539e551689de518881b Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 7 Aug 2024 10:43:53 -0400 Subject: [PATCH 007/303] hype changes --- pillar/top.sls | 4 ++ salt/allowed_states.map.jinja | 8 +++ salt/firewall/defaults.yaml | 61 ++++++++++++++++++ salt/hypervisor/init.sls | 0 salt/libvirt/init.sls | 53 +++++++-------- ...python-10.5.0-cp310-cp310-linux_x86_64.whl | Bin 504724 -> 0 bytes ...python-10.6.0-cp310-cp310-linux_x86_64.whl | Bin 0 -> 504725 bytes salt/manager/tools/sbin/so-minion | 4 ++ salt/telegraf/defaults.yaml | 4 ++ salt/top.sls | 10 +++ salt/vars/hypervisor.map.jinja | 1 + setup/so-functions | 6 +- 12 files changed, 117 insertions(+), 34 deletions(-) create mode 100644 salt/hypervisor/init.sls delete mode 100644 salt/libvirt/source-packages/libvirt-python/libvirt_python-10.5.0-cp310-cp310-linux_x86_64.whl create mode 100644 salt/libvirt/source-packages/libvirt-python/libvirt_python-10.6.0-cp310-cp310-linux_x86_64.whl create mode 100644 salt/vars/hypervisor.map.jinja diff --git a/pillar/top.sls b/pillar/top.sls index 76d1a14e1..1a0d5f8c6 100644 --- a/pillar/top.sls +++ b/pillar/top.sls @@ -307,6 +307,10 @@ base: - minions.{{ grains.id }} - minions.adv_{{ grains.id }} + '*_hypervisor': + - minions.{{ grains.id }} + - minions.adv_{{ grains.id }} + '*_desktop': - minions.{{ grains.id }} - minions.adv_{{ grains.id }} diff --git a/salt/allowed_states.map.jinja b/salt/allowed_states.map.jinja index 37795e9d7..1cdf6145e 100644 --- a/salt/allowed_states.map.jinja +++ b/salt/allowed_states.map.jinja @@ -199,6 +199,14 @@ 'kafka', 'stig' ], + 'so-hypervisor': [ + 'ssl', + 'telegraf', + 'firewall', + 'schedule', + 'docker_clean', + 'stig' + ], 'so-desktop': [ 'ssl', 'docker_clean', diff --git a/salt/firewall/defaults.yaml b/salt/firewall/defaults.yaml index c9b864a18..944c37992 100644 --- a/salt/firewall/defaults.yaml +++ b/salt/firewall/defaults.yaml @@ -1452,3 +1452,64 @@ firewall: portgroups: [] customhostgroup9: portgroups: [] + hypervisor: + chain: + DOCKER-USER: + hostgroups: + customhostgroup0: + portgroups: [] + customhostgroup1: + portgroups: [] + customhostgroup2: + portgroups: [] + customhostgroup3: + portgroups: [] + customhostgroup4: + portgroups: [] + customhostgroup5: + portgroups: [] + customhostgroup6: + portgroups: [] + customhostgroup7: + portgroups: [] + customhostgroup8: + portgroups: [] + customhostgroup9: + portgroups: [] + INPUT: + hostgroups: + anywhere: + portgroups: + - ssh + dockernet: + portgroups: + - all + localhost: + portgroups: + - all + manager: + portgroups: [] + managersearch: + portgroups: [] + standalone: + portgroups: [] + customhostgroup0: + portgroups: [] + customhostgroup1: + portgroups: [] + customhostgroup2: + portgroups: [] + customhostgroup3: + portgroups: [] + customhostgroup4: + portgroups: [] + customhostgroup5: + portgroups: [] + customhostgroup6: + portgroups: [] + customhostgroup7: + portgroups: [] + customhostgroup8: + portgroups: [] + customhostgroup9: + portgroups: [] diff --git a/salt/hypervisor/init.sls b/salt/hypervisor/init.sls new file mode 100644 index 000000000..e69de29bb diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 4e9d0a6af..1e4e3dde0 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -9,18 +9,6 @@ install_libvirt: pkg.installed: - name: libvirt -libvirt_config: - file.managed: - - name: /etc/libvirt/libvirtd.conf - - source: salt://libvirt/etc/libvirtd.conf.jinja - - template: jinja - - defaults: - LIBVIRTMERGED: {{ LIBVIRTMERGED }} - -libvirt_service: - service.running: - - name: libvirtd - libvirt_conf_dir: file.directory: - name: /opt/so/conf/libvirt @@ -28,6 +16,28 @@ libvirt_conf_dir: - group: 939 - makedirs: True +libvirt_config: + file.managed: + - name: /opt/so/conf/libvirt/libvirtd.conf + - source: salt://libvirt/etc/libvirtd.conf.jinja + - template: jinja + - defaults: + LIBVIRTMERGED: {{ LIBVIRTMERGED }} + +# since the libvirtd service looks for the config at /etc/libvirt/libvirtd.conf, and we dont want to manage the service looking in a new location, create this symlink to the managed config +config_symlink: + file.symlink: + - name: /etc/libvirt/libvirtd.conf + - target: /opt/so/conf/libvirt/libvirtd.conf + - force: True + +libvirt_service: + service.running: + - name: libvirtd + - enable: True + - watch: + - file: libvirt_config + libvirt_source-packages_dir: file.directory: - name: /opt/so/conf/libvirt/source-packages @@ -60,24 +70,9 @@ install_libguestfs: pkg.installed: - name: libguestfs -# required for the network states below -install_NetworkManager-updown: +install-guestfs-tools: pkg.installed: - - name: NetworkManager-initscripts-updown - -ens18: - network.managed: - - enabled: True - - type: eth - - bridge: virbr0 - -virbr0: - network.managed: - - enabled: True - - type: bridge - - proto: dhcp - - require: - - network: ens18 + - name: guestfs-tools # virtlogd service may not restart following reboot without this #semanage permissive -a virtlogd_t diff --git a/salt/libvirt/source-packages/libvirt-python/libvirt_python-10.5.0-cp310-cp310-linux_x86_64.whl b/salt/libvirt/source-packages/libvirt-python/libvirt_python-10.5.0-cp310-cp310-linux_x86_64.whl deleted file mode 100644 index 5687a286251694c55897d2ee093e07f873c79f45..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 504724 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⁢M>PQ9a*r!u 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

=;yRl?xghMpqn|U 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 z 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 BnaglM&+Fem|G$nFkig8Yz|OMJ>EuBK4DZo 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

=IzKgY6garUn`{<=f_c{ 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

==E8{Pqjs) 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 *XOOg2?!5D)LcAH?wR` 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 TTMP_5K)4E6V_aF!4&(s<(W-u< diff --git a/salt/libvirt/source-packages/libvirt-python/libvirt_python-10.6.0-cp310-cp310-linux_x86_64.whl b/salt/libvirt/source-packages/libvirt-python/libvirt_python-10.6.0-cp310-cp310-linux_x86_64.whl new file mode 100644 index 0000000000000000000000000000000000000000..1ab49e39501051478aaa5f08b3a6644de1ada247 GIT binary patch literal 504725 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⁢M>PQ9a*r!u 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�i^_s2JzdPl)r)pqk{N!hdnuO}$Qm44RJFNWA*z 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

-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

hc&NM<)K6J2L<5hQ$}YaU2O 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 ~ZpS;(?1QFU^Nh)4%T_#a>6n0;?F*Aa{&-Uz;! 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 SVqo9_!d1X3 Date: Wed, 7 Aug 2024 13:13:43 -0400 Subject: [PATCH 008/303] use salt3006.1 due to issue with virt state/module - salt issues 65694 --- salt/salt/master.defaults.yaml | 2 +- salt/salt/minion.defaults.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/salt/salt/master.defaults.yaml b/salt/salt/master.defaults.yaml index e133dbd0b..fc7a6ae16 100644 --- a/salt/salt/master.defaults.yaml +++ b/salt/salt/master.defaults.yaml @@ -1,4 +1,4 @@ # version cannot be used elsewhere in this pillar as soup is grepping for it to determine if Salt needs to be patched salt: master: - version: 3006.9 + version: 3006.1 diff --git a/salt/salt/minion.defaults.yaml b/salt/salt/minion.defaults.yaml index be405b9e8..0aa315264 100644 --- a/salt/salt/minion.defaults.yaml +++ b/salt/salt/minion.defaults.yaml @@ -1,6 +1,6 @@ # version cannot be used elsewhere in this pillar as soup is grepping for it to determine if Salt needs to be patched salt: minion: - version: 3006.9 + version: 3006.1 check_threshold: 3600 # in seconds, threshold used for so-salt-minion-check. any value less than 600 seconds may cause a lot of salt-minion restarts since the job to touch the file occurs every 5-8 minutes by default service_start_delay: 30 # in seconds. From d29b0660f0bab91bf28a163ab1ed5c85432512c1 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 7 Aug 2024 14:47:01 -0400 Subject: [PATCH 009/303] add docker module for salt 3006.1 --- .../docker/certifi-2022.12.7-py3-none-any.whl | 2469 +++++++++++++++++ .../docker/chardet-4.0.0-py2.py3-none-any.whl | 2469 +++++++++++++++++ ...linux_2_17_x86_64.manylinux2014_x86_64.whl | 2469 +++++++++++++++++ .../docker/docker-5.0.2-py2.py3-none-any.whl | 1817 ++++++++++++ .../docker/idna-2.10-py2.py3-none-any.whl | 2469 +++++++++++++++++ .../requests-2.25.1-py2.py3-none-any.whl | 1817 ++++++++++++ .../urllib3-1.26.15-py2.py3-none-any.whl | 1817 ++++++++++++ .../websocket_client-1.5.1-py3-none-any.whl | 1817 ++++++++++++ 8 files changed, 17144 insertions(+) create mode 100644 salt/salt/module_packages/docker/certifi-2022.12.7-py3-none-any.whl create mode 100644 salt/salt/module_packages/docker/chardet-4.0.0-py2.py3-none-any.whl create mode 100644 salt/salt/module_packages/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl create mode 100644 salt/salt/module_packages/docker/docker-5.0.2-py2.py3-none-any.whl create mode 100644 salt/salt/module_packages/docker/idna-2.10-py2.py3-none-any.whl create mode 100644 salt/salt/module_packages/docker/requests-2.25.1-py2.py3-none-any.whl create mode 100644 salt/salt/module_packages/docker/urllib3-1.26.15-py2.py3-none-any.whl create mode 100644 salt/salt/module_packages/docker/websocket_client-1.5.1-py3-none-any.whl diff --git a/salt/salt/module_packages/docker/certifi-2022.12.7-py3-none-any.whl b/salt/salt/module_packages/docker/certifi-2022.12.7-py3-none-any.whl new file mode 100644 index 000000000..7f561460a --- /dev/null +++ b/salt/salt/module_packages/docker/certifi-2022.12.7-py3-none-any.whl @@ -0,0 +1,2469 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + securityonion/setup/files/salt_module_deps/docker/certifi-2022.12.7-py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + diff --git a/salt/salt/module_packages/docker/chardet-4.0.0-py2.py3-none-any.whl b/salt/salt/module_packages/docker/chardet-4.0.0-py2.py3-none-any.whl new file mode 100644 index 000000000..3b4094eb5 --- /dev/null +++ b/salt/salt/module_packages/docker/chardet-4.0.0-py2.py3-none-any.whl @@ -0,0 +1,2469 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + securityonion/setup/files/salt_module_deps/docker/chardet-4.0.0-py2.py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ Skip to content + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + + + + + + +
+ + + + + +
+ + + + + + + + + +
+
+
+ + + + + + + + + + + + +
+ +
+ +
+ +
+ + + + / + + securityonion + + + Public +
+ + +
+ +
+ + +
+
+ +
+
+ + + + +
+ + + + + + +
+ + + + + + + + + + + + + + + + + + +

Latest commit

 

History

History
175 KB

chardet-4.0.0-py2.py3-none-any.whl

File metadata and controls

175 KB
Raw
View raw
+ + + + + +
+ + + +
+
+ +
+ +
+

Footer

+ + + + +
+
+ + + + + © 2024 GitHub, Inc. + +
+ + +
+
+ + + + + + + + + + + + + + + + + + + +
+ +
+
+ + + diff --git a/salt/salt/module_packages/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl b/salt/salt/module_packages/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl new file mode 100644 index 000000000..87df81cbc --- /dev/null +++ b/salt/salt/module_packages/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl @@ -0,0 +1,2469 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + securityonion/setup/files/salt_module_deps/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ Skip to content + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + + + + + + +
+ + + + + +
+ + + + + + + + + +
+
+
+ + + + + + + + + + + + +
+ +
+ +
+ +
+ + + + / + + securityonion + + + Public +
+ + +
+ +
+ + +
+
+ +
+
+ + + + +
+ + + + + + +
+ + + + + + + + + + + + + + + + + + +

Latest commit

 

History

History
195 KB

charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

File metadata and controls

195 KB
Raw
View raw
+ + + + + +
+ + + +
+
+ +
+ +
+

Footer

+ + + + +
+
+ + + + + © 2024 GitHub, Inc. + +
+ + +
+
+ + + + + + + + + + + + + + + + + + + +
+ +
+
+ + + diff --git a/salt/salt/module_packages/docker/docker-5.0.2-py2.py3-none-any.whl b/salt/salt/module_packages/docker/docker-5.0.2-py2.py3-none-any.whl new file mode 100644 index 000000000..1b63ebdeb --- /dev/null +++ b/salt/salt/module_packages/docker/docker-5.0.2-py2.py3-none-any.whl @@ -0,0 +1,1817 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + securityonion/setup/files/salt_module_deps/docker/docker-5.0.2-py2.py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ Skip to content + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + + + + + + +
+ + + + + +
+ + + + + + + + + +
+
+
+ + + + + + + + + + + + +
+ +
+ +
+ +
+ + + + / + + securityonion + + + Public +
+ + +
+ +
+ + +
+
+ +
+
+ + + + +
+ + + + + + +
+ + + + + + + + + + + + + + + + + + +
+ + + + + +
+ + + +
+
+ +
+ +
+

Footer

+ + + + +
+
+ + + + + © 2024 GitHub, Inc. + +
+ + +
+
+ + + + + + + + + + + + + + + + + + + +
+ +
+
+ + + diff --git a/salt/salt/module_packages/docker/idna-2.10-py2.py3-none-any.whl b/salt/salt/module_packages/docker/idna-2.10-py2.py3-none-any.whl new file mode 100644 index 000000000..7dfbd65fd --- /dev/null +++ b/salt/salt/module_packages/docker/idna-2.10-py2.py3-none-any.whl @@ -0,0 +1,2469 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + securityonion/setup/files/salt_module_deps/docker/idna-2.10-py2.py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ Skip to content + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + + + + + + +
+ + + + + +
+ + + + + + + + + +
+
+
+ + + + + + + + + + + + +
+ +
+ +
+ +
+ + + + / + + securityonion + + + Public +
+ + +
+ +
+ + +
+
+ +
+
+ + + + +
+ + + + + + +
+ + + + + + + + + + + + + + + + + + +

Latest commit

 

History

History
57.4 KB

idna-2.10-py2.py3-none-any.whl

File metadata and controls

57.4 KB
Raw
View raw
+ + + + + +
+ + + +
+
+ +
+ +
+

Footer

+ + + + +
+
+ + + + + © 2024 GitHub, Inc. + +
+ + +
+
+ + + + + + + + + + + + + + + + + + + +
+ +
+
+ + + diff --git a/salt/salt/module_packages/docker/requests-2.25.1-py2.py3-none-any.whl b/salt/salt/module_packages/docker/requests-2.25.1-py2.py3-none-any.whl new file mode 100644 index 000000000..68e34c862 --- /dev/null +++ b/salt/salt/module_packages/docker/requests-2.25.1-py2.py3-none-any.whl @@ -0,0 +1,1817 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + securityonion/setup/files/salt_module_deps/docker/requests-2.25.1-py2.py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ Skip to content + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + + + + + + +
+ + + + + +
+ + + + + + + + + +
+
+
+ + + + + + + + + + + + +
+ +
+ +
+ +
+ + + + / + + securityonion + + + Public +
+ + +
+ +
+ + +
+
+ +
+
+ + + + +
+ + + + + + +
+ + + + + + + + + + + + + + + + + + +
+ + + + + +
+ + + +
+
+ +
+ +
+

Footer

+ + + + +
+
+ + + + + © 2024 GitHub, Inc. + +
+ + +
+
+ + + + + + + + + + + + + + + + + + + +
+ +
+
+ + + diff --git a/salt/salt/module_packages/docker/urllib3-1.26.15-py2.py3-none-any.whl b/salt/salt/module_packages/docker/urllib3-1.26.15-py2.py3-none-any.whl new file mode 100644 index 000000000..686d9a9e5 --- /dev/null +++ b/salt/salt/module_packages/docker/urllib3-1.26.15-py2.py3-none-any.whl @@ -0,0 +1,1817 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + securityonion/setup/files/salt_module_deps/docker/urllib3-1.26.15-py2.py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ Skip to content + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + + + + + + +
+ + + + + +
+ + + + + + + + + +
+
+
+ + + + + + + + + + + + +
+ +
+ +
+ +
+ + + + / + + securityonion + + + Public +
+ + +
+ +
+ + +
+
+ +
+
+ + + + +
+ + + + + + +
+ + + + + + + + + + + + + + + + + + +
+ + + + + +
+ + + +
+
+ +
+ +
+

Footer

+ + + + +
+
+ + + + + © 2024 GitHub, Inc. + +
+ + +
+
+ + + + + + + + + + + + + + + + + + + +
+ +
+
+ + + diff --git a/salt/salt/module_packages/docker/websocket_client-1.5.1-py3-none-any.whl b/salt/salt/module_packages/docker/websocket_client-1.5.1-py3-none-any.whl new file mode 100644 index 000000000..fa5dfd9fd --- /dev/null +++ b/salt/salt/module_packages/docker/websocket_client-1.5.1-py3-none-any.whl @@ -0,0 +1,1817 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + securityonion/setup/files/salt_module_deps/docker/websocket_client-1.5.1-py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ Skip to content + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + + + + + + +
+ + + + + +
+ + + + + + + + + +
+
+
+ + + + + + + + + + + + +
+ +
+ +
+ +
+ + + + / + + securityonion + + + Public +
+ + +
+ +
+ + +
+
+ +
+
+ + + + +
+ + + + + + +
+ + + + + + + + + + + + + + + + + + +
+ + + + + +
+ + + +
+
+ +
+ +
+

Footer

+ + + + +
+
+ + + + + © 2024 GitHub, Inc. + +
+ + +
+
+ + + + + + + + + + + + + + + + + + + +
+ +
+
+ + + From 81d407f0ff4afd051ba0584cc56ad5e706b85dc8 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 7 Aug 2024 15:34:37 -0400 Subject: [PATCH 010/303] new wheels --- .../docker/docker-5.0.2-py2.py3-none-any.whl | Bin 173568 -> 145967 bytes .../websocket_client-1.8.0-py3-none-any.whl | Bin 0 -> 58826 bytes 2 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 salt/salt/module_packages/docker/websocket_client-1.8.0-py3-none-any.whl diff --git a/salt/salt/module_packages/docker/docker-5.0.2-py2.py3-none-any.whl b/salt/salt/module_packages/docker/docker-5.0.2-py2.py3-none-any.whl index 1b63ebdeb1c560eb4fd3daa68269b448ac5901fe..f1ed95ee122f37731b51226ccbc8d6eb07405f39 100644 GIT binary patch literal 145967 zcmZ5{LzpJOw&Y*7ZQHi1x~j{zZQHhO+qP}nw$bJ4>ARS@@695={Bo1$bHYvHV?M{n=pGur?S%mfR* z-y?@)-+p3`J|HwJW{>F1a3W2n&A{b#a{o}%GrB}rp~&q3f6NG*s_l^buV!bk2U)l(KRC;D_0`}B{nv& zZ|&}2e?N#F*5+u}!H}${j2}$fpJre%ue6%v5MD(u-SuUuT(0$TT7}-Rb#+u^W^Gho zucsD^3e56o&i_)@m=U)#Uu&>+UyrIhHHEjDgr@B2aDTtdtBPvs>mx2BrB?Tq>S{Jj z@O^mr)^gYVg+rv-%gbMz8R#oXa9uri)RlB({^ww4u8v-nfI+W^K;oNlozBKL+LUD< z8{d3)35R-jP;GOhN+rqW!ZKyrv?(yPxF~zY&3R=Z^+B@UmI7kP zIiZs1G{-X}kG_g?C9%vdv#Yu`@-@`hdi0&)E!#>_*QeRJCpw*wvpV1FsMZ zB1@MlOw-0()!*jK1q?qzcvo55nP-NNQ%G~(#ScZ?4yy~yk1$_0@g?6ujF4GdiY3{2 z5e9^3|Xrv6zbrPM0(_3Y^dwgm~31S8$a&Vk@In;z87)>;W@ujMnYEXu8DRLKW zQxzHZ<|4_9L=4d-UKBJd$Zyc)j&1UWiuT+otxPqOl&qECqZ2*B2#piBlmKyv)c#CQ z@y*^^rN_2h7`~1hu=zsK4QTo*)6$_;E0?zA&wm905A)d**gt2T1Z|HyQxUvKakI|ZTXxq;*)IVNlk(9 zy7?y(qpbpseaK>wy!Y+;GyB?~NXi#wGu#6uC+BAs*+}AJ3xU~~Zj}}&Qw30g{ZO6> zE!B|w02`oZk}*PLv;0$YEMHq+Z!mYoCf+I}KU8CKDe(e=eq+e5fFBd{70BrB#B^Ux zY#D;I=$a<@jmtG3k`Lo*%_uP#nyM<6g*LVo=FWcO#-Nnvp!LpG&^*>_7&%A&GZ<><0F_L z^U=7vOiqH}?HelTP0#g6_}Ujth)xqjMIKR6#XefbfuoGn4|>(zAx!Kt_G7Ura~;GC zdf#G^oh61t&?NZRq-uhY2cUShNIGIj4~)-s>P?9Yf1lZoeQJ}RI>fH@;=%LuGYeT+ zhGsi)ZZCxp)ZzQ|h~4WQ5ptF@E}mLR?fL^M1W}Q75H=J-50uDAutRREI#rjtW9|jG z0~B2Eu?G`RzI#|{`e_JYhF+&+(iUqQ&T{eo3==}H*` zsWnYs=&xuqs4U>Hw68d-OF*kc#Dc(HCp{n*a5$rMHHY&{c>u(^20&H2uZ zK%7u2%eqFvHm>G#{UZMO=9vhds+DMnlv}Ya z%~fs}#^Ccf89wq01<^a$&p$gX8(oUZdsJ1fF{rRd7Bum^xQ(D+(y#nq$~3DE*k6SG zs>t&rva5az`y5?!uYjBj!Q&-V0Yb4c5`L+Vy=##2@2Y^vXgGsbKHH*_!&l4V)T@c@ zvH8G4OV3F1cX-+s5`A#KLax(F9dRqqG&bS0IPRzM{c!m~z0!mUfw zATp+7)AFcjQ3FNUt&s6>S;P;brxvls8Pn0GJR`kNnZdn%qOj%(?rHk+>0y(Pd>MJ{ zftJ2UARh||kd!8kAC z374h5HbJMvZ>p=Y5B?x*byc#Wao_{<`_-&V`1@grL4Z(XWl_gw|5~&K`N2< zU~2gUs9rI=)OD*JQKo8j)i7k}IR)j;qog}4(SUyqTK{R>@k!THo?ee$PG6V%_bJ7C zO;@GS40`a>__m2oN{vuB!GvF|QV>3}Lw(*Qf7l0WHaa{VX4Tutu;@XE^6G`Z8QHQM z&6&(KWTLeGMnPOqSv;@0?2M6fm*AQ48z_>_Ag3{%%yo65zM*QU5~{d*Jd{dGp~k2Q z^JZywYvAx5y`BMk6QRIT&d(nj;hr!0HK_6D!0sAbs$(;)eh1L?(A`hha#+L|DN$TF zCM#g&kJDCz*O=LPbariF*+?uLQOd7K8_dDWK>du^Q@lu}8TlA#kVG(vP7avCZ;ju7 zRWzy`jKr^!cAWMDKF#fXpgDvK5~zQRy9A%u)Yf~J+j6A@c-%U{!oY!917ug0$)JlFMUV{31M15Da-`

NpZY3g~axGDG^{t?tIiXxDV1*8q3c1Ci%CR3-w%s!*YYWR-eA(3&GkeKcCkf zfGa9jqUuD?xY(S*$wY*;B8w)3bvaaCbroju%a4j^|9Zm*x@W8X8g0MswsyRV;^#Y8 zzF@NMSB~8ECZ%E;swjFQ)UrbRH{Yl={ zk~);MMW@g2K&XqePkGu$K2B(Qik`QAPv)RxGS~dUKk!(}&`*+y{$FO;mQ&~6$oek> zIgR$2ydOlXzfXl*YvjrN3DXhJ|1^1lb4&7PbEt8iXc82A7Rrst&&ZYGIAe1r;YBbh zemGmum@|SrK0LJ@nINVFYIja#A;9SRmO1h3MOWA2DUi2>bn`R!$HGN&S-CZ+X~wEy z83`EI#FHOIfc7_J4QG({%y&c?E;a?00i3(r@5GoprFfFsHG(V;Nk>?E9MoS)dpmo4 zbyG1xGqy&QAC8!o-0d(Bc8t4Z;z`nkI9{D9`IVBxuTwK;sSN}bF7pl!5<(b#oLlc5 zU*c`RoQS3n=HC=kVp8{xGUciu&!dxrrDe89yIW`D(LyWnS&-W#w?51_%g*3%X zTFcVmbZQdFZUS<@?;Ov_*J*Nf2cW|Db^8-)!u>ZtYgf0;6Yl}$EiT~OQ(c4Z0&YTu zln(?>pW9uN8KZ!UM#uRIg)q5KvoBn0&Qp$R_EIVaf(tnsWbVz0h=k-&F$IX`ddF`7d3+Bu)5gZ6<}3w6^$%-V_X zd~X?lk!P->wI-RTdYbQghdY=11Iwu2l_Cc;lpMiVjF1Blug&Me%ha34EAX`0uJ}~| zL9Qc{yHMV@AD!6dcYg{5TEaZ?g!6?Kz1uFC*&^5+?jTRyWz!&p z@f8O-u`=;eEECcuM7EtoFwRlHLOp&wV5;F)WD6rrvW}sB%7o!@U)a+Tdz{zhi*{+A zAugBuJcar8@a3TV{4e2EV&b-$z-`CC2zNTR{VrcR=Kq z8A=vJI96@bg%K=0L&`!Ru7%1WkK5BJKDPkx><`TU?me>{DpGbJ0DyFS008m7y{D12 zg^8{6zwWa}!^Uol9r5Q@PpF;X8aB7F83!CwiiyObL0b@FTzumcNvVVON?T zb*8SxA({kIYYqE^8zhWmGwIvKtPBw?cS!;bG2fsfkzy>G+~6;Hq&~KzpyPX`rNMnf zgWTje-YSW^=X=BkL#c_&p`5D&1H+C3saBDiF^Gx0a%mb(+_x*7gk+1En;!gICK{Mr zWmW?JsUm0xGUJWXwJSQ5O4JVYDFl7g8_pyAfV#cAt39ZOpBCgqTCvPjEWO1*v$*33 z3@hOq-N5~HSWnNjXA+sG;FuZ6zO_0%9x}t80j&mR`Wwyqs=50BYV=g*4qX51xTB{h zxRkTT=~=plz`TJBBsL)TqsW%6-=UT9W=4;?aYuq7UdWZ;hMGBR52z=-SYc-z*?zhz(#A?vU&9-qkq_H&1 zM?5326Ho`p;wTe?@dT^-AS@9>bl8Y0M?#TW5IZ4*cv%U4m|Ugc@DRaA`7=|JNyR=c zA3AwQN@8I?HkJGoA~F(ZIUAv7xF)=3M!E?v`@|1zMqsi&-pq&?nP?;CpWmTC5}{0b zg+Qi)Bp%a%uTZIkl5u$6*dqnX$7a(EcJNU=`;z;ru7%t#EzS#*OBjf@RXM{1pp@vvF+?-dwZ7TAVFJ^qQMqOq%C-Vr zI8Op&P=!3+0zG{mPf>Gsd`aFdHQtbeNriO-7dk>hMveP4)rQv|w`xnDV(uIoU;8Y1 zf*%3hpq+}yPEfw&$EoX6@S&jQEi|GX$w3O+(wv(zOyzkZw`y!(KWmYJdlo7q_fI0% zO*AmRe?_XTOyEblK9eN}FKJ_vp@M%68X?b|wZS{1eryq@4)hXbQVsb#V6_~$dCqJW zX+Yd>#fYmxWja73k`_65UEczYD%Tqkp~9L=)`+1(p{cXO75TU-Yzlb9e_ad)@0p>M z@pY(I%TmgFc~=ImG)Snx{;BJI!|VO&TscK+r-nDvjfLiGdrlhcq;v$sP}m2|rPCGP z(;_}Te5u^ecnlJdrffOczv=4~Pr!T~-TJns>kLRCFt45#wp_Qj_cYsu5n{aC>zhHm z6g50#^76>H_^|J8?(f4aH#i1dvNSZ+f7gtw%k13K_$Bp0dhN}N-dLxWZVDUVx0SATZ z(WQBERiX;kouV0ptNmmS_FSs^-o8lf>sF9zs|O-Zv;U{%a=(+^#*%f_QYJM*{#ps% zG&~yh+pP-Lt|S#PG!C&+jHrs8=8vSSS5^N>n~Gokr+^Shn&hhTz<0>L?~gosH0;ml z&0pA$J~dcfeTaa}+iqL-f&O7;@*K$lq|+>$mZ-XTE@u4Ocvk17j{&S>+NiMatZA2< z(=~xhW#_WI-D8t`G{-Uc&V(t2D~hzI5B$E%E3N1kq|R!{pD*JiWY_s*o51y-MIu+< z#pU0aT1@mxf82JvlWBgD-^!OMLUZB93*CqHxAO)auR9^g)X&zMRN9K&3H)y=05r5x zu?!3V6oLW(DF1^B*x5Qc8`wHK{bK_z%2skmoT%TodJZGL&^PjUr8lp*97+gIP zhYqp+uONv}(V+?H^Y+nKPJbdI5!|vn&!L2H5j3I$sG>0EM%a3s68s?dk5n2fXGVFh zz5Y~~Yqwc*cTq<-*MV$w)`|1qv1HokM*dE8I_AcV{dt6VgGcBcGh^yP>yWAtuik8Z zFIu|X(m(`_3xSd@3-Zw6mpIb0{sVKAT(WFZi?bpDf$-Ju;$~0uqG)k}beQP;X`eRt z#GY5Tiv^3&_6@N{5FP6_WXTb{w>L}wm#52W9EK=(gz|~Dh`2}%R;(ArDAV+r_*fms z0mYOls?PrElMY4i_gi6eiiue8XGm-48OFWt!{neg`>#|nnlt%x zu5(QSI&PiT^Blt)kNamdP7MvJr<9JKfp932v6M19hYka71knhSQTVqN7j zU}xpKNsD*CcI}SQcx4W&SdUQxu(TVsDDL_A{r2{}J_~0Z&H8DuyE5tETLTF;-iH*L zEYw=ybKPcrJ(L)lZ8J%g)PfiCg1>-e!;2HR=P2|`2FTLS3(r^GnIc^%fDoV*9_Z3m z9W(^VLP6X$D;&X6Xzfpb3u~Ak3*QN?abCzG0G+ridqUCK*2_~OExw}i6=mH#YiGWU z25jG&)U;fmJSSWs3!S@0lv%*Ew6<&J1~`?9Wzng0UG{#M=-foNS~0!|YHa<+iT*Wq z=Qpj@o-=#k%wUAN`={WC-q4)W{fPq7gOZ-S>CKbi#)bnMH}BejYm)}~z&-m#`gYKB zNXTyjd?4cW-LK#K4^in?3exu{!~ebn8X8~bvtR%K`M-yy|G|e%93AZ(|8oOo)c-FZ zc9`dv7-S{G+w_6N*4J1x99Ybk2=t|b4oEQ1iV>|OT^VNi+H)g)5uR|>1-~8qux z;dk@Cb!V-zBw~~Js40-F+OSSd6Q$xrdB;n+!*|rQB6nXF7!habmqP^o^9gDjQMjLc zs;F$=XZ(&Vp%FMQMIGRp35_`hRJxR*!k0HB$!agx4o*i%(YaEj2wfq_03}On5d~H| z_v0T)ml~eRD28G+Y;i%R1TWF2xjB?Q1I-<#typOB%Q98tGXp4#uBEm~m!c5mPPPUa zQ66sTxV6~+A1dZ3xb?akNI_66?b+G#YbH1wODd`yv4$AsTf7>YHEVaM%!KhTlN}7F z3s1<>e^(;vd~sEmD;f(8F|bfrtA@xGTbJuN=H--gB*WBFf#dQ)4sohzHgZSmP)daq z<^;Kh&p<#*qU@B@Vt{?v!`30_AygG)_Yod|i5`^n*B_kLPZEyKKxorF9vhmcZM;Ht z%rj!ZF~sI0DhGI!AxLX{X$$TU>PX}oDG!R%edmmj)r1&oj;|O$gs3f?`};;K_nK#g`F99 z5n95jXY2Dmu}snrF&;^V%63+w$(XaRL$Bd*wj|D@Q+{dL#ojYWKXedtZytV*s|XAw zO(>I09YfjBrc6HC<#(I~7e4Z&%sCuxO8)3&pKITjBZ6I3Y?6l$4b&EQ zCUh^k9`&s%5)wUEn#G?@CyU|L=ax^aP$nrD1>Y!o4Y4AkzfRc98`JF#q7%tb?etxI@~-wZZj-aD;`CP?9A71x@DgD)=(YZwBk6c~wxW z(86Ss{Ucn2LVAhsD*1Ri*0xwXBuU4MzMeBgG;R6y*I4ZJX~_IL{5=nw zHGYecEwLS3olZ;%T|Qyc&RULPmdL#t14{c*y1GQ2`T`}gv`TF?Q1 zYr(^RtRia@v~`!uVI^0r| zMF~6W+FW{YLM)q96;_d9hV_D*$nYSiH8{Ya^w~#QYpDt1wB@tGb*SWsrFvjlfiYV+ zeSB!PsxDF^^=RzmhXIWQ>59<|(pbY0KL9WOF3Te3lUlrCz}DSauKogVIWBgYnSHwD z0?xKOTOXLWBC$#23XcKud(yHDgsG?DSs3-EBq(86G|G4P>a$7kmzINw+OOPwpE zLRl+Vx!uFh5Fk_+ROH;xYvBAF?0?sO3`!4}ZO?!u;id`E>7|v44 z*2Bv$Fm6cF+6Hvs=HhblW0Yaorb}fSOgq?LvsYD9OLoIB3(6pk>aK_)K+iA@paiu?NZ1C13*7*+B*inQ1k9;@kGD)^h5(N$<{oqx0S~y{2Lt_n;BPnr_rkc#9~I zLK_sCS9`Q(d<3^Q1unUUoz}4H_BjL3kM$(n4S4=;K-vm7oKmSkWTxQa3V0i3ZkxnI zF@a|eZy68fns!u8l`raHtf1Hd!t>KbqN1F2Z$JafV=@uVcHnbzWRY7?U_{~^O|^3D zFc11($jA>HM!^9C`(H!p|1Yq%fO^wy3^ zL8dkW)G=_VUOCJi(%nqBa!elep3F`AgXiziE-UPHimW>tc_al~iV6kAvRKS{7%WJ^ z+u$0&Oqa^AuvBPPJ|EgN+yrj$!#7(Q-1fU%twZ#92f}(cJz6TY zGIa+ElmytQdy1i?*K(q=s>UHajE6zUJNPx#q0;>Ds9gP)EP98(>(jOuPo!gfX_foH zh_L225r)<%_D0iDq{=gYF?R?c`DMru_=*b?lHzERJQ(gp*BI-j#Ipo$l1J2Y)$vc7 z^0=Lr^_6H7RBSsF9gOipK;>gif*r~{(7;AIpAv5|gQMLB(~X9f)AgW`w3I4c8D~fg zWA<@~o2+<&@X&8B{j?1gi!8gjY(@jKl33|>bze_m{UW=(Uj8`@xrMKbr^C3dEP;zP z9&A0ii=E_JirZ(ZrD;qy{<`4f%Jbx3JLHHx1TwaB#c=~#`?&Zew3k%wu|wmQSDU6z z@$8akY;Q4a%FpfV0_R|rHXROQ9mgJHqg)VIHyG=BHzD9c*Y}NG@OuUfxmH&{nQL@u zHk{$h_V;N(G=c`NKcVc>#+#~_U;fMm!PSCa_F8d8Y36Y};31@=9@p-@wB9F!(cgDi`aj8SVo zre^*|=yx`RIc&$Emc*S&G!3;#1+V%mP02^r5>brzFfnI_7|ccRXPAXIVlUq2dDT;H zy&<-5ePi9M&oL%we~lq_otz>Az-Cx+fqTi6%yl7)k_coo69gu?rPo?J+gNVQ)gwlC zowYc0`!@{vxz;j4zlYmu^tXZc6T1fV4UM>3^TR{q*jn#i7{$&P*t7J>&bUHq)h0}-?7WzBhQSEQtL}h+L&5wMJgmGk+Voi2VVJ(6)G~neUlaZkZ{5SA_{BC_3rMk5L0@D2(=>H9D zU~ln1J#R{?5>vmYWn1bM$EO&ik0og)=TzpUW+$X)XcWe$>BbqT73^W}oxx%3f&Rz- z|8b=qR4S0n{zJk)oc~J>_|N`^E*93t|Bg1oV_|p1*|_&a^Tta+YGlMEo(ImmF70MY zvF==!U>qyPU2hT5%C*2&m^{2S{&`au873;}n3$U}>I7nwDc*2PjgFOjtf7#&Czg6^ zzY^QD5?My`#DY?)GS51hn3H3YKt>7~ep{;2Vfz}QK`oh?TFBQQNle4tqcUOC(9{H? zl~f@_sNV31npu5s)|5SB!6q^r1?X6K{musZuk!U#wpmDhCR(2b4MfHjX5#-iQS)G{Gmbpj<-#pJHA9@!*y z+W#YQXKkyVb()w^q9|U?p*l=+Doq2a(X@;b#!fvz;xYv??J*gxDV?GlwTDv_*0t&( z6}DhRa*nL(@8foKgbVSTp9Vv6I=#9z`fu53c~dq47{u70gvLjD8e3B++bsyGF9ihy zQ6O)sbL$+aApQv>P2dx7b_^`%d)k{26{yf_oyQeghQ`mC=f?7Nd&N0ySa6q5;B?fb zz+^0{wdm=y$bv|UC$4&y--0C|j?)I+{!r!2jPV9qG-KYnLsD2#pu$>=#OheAFv6LJ z6kscG7PM?}Z;T0v;TW{EO@>M$3&Nm2{s*ru;bHAGWMEQ_i3xdgav(SmiT|0S`4JF3L=}_kg@7#sAE#i*L8Gwc z0j3xsAo|f8K(EcV6Ypgsk7s`^{n9M9TGPW_f-1+C8vY~+5$M42RGSO*?`-~k@>Sy2L&ddk| zjSZW|Zz&X=#Zps>f_lC&26lzaJ{Zi(1pGM3kHS-%S>A4kyd2pu8Qi(iuLfMqx?}Q+ z(eGEY?{N%)Cwxx5R61~b9zy@ws~At~8%?A8^7S`WkmP!przwseeg>}e5q@su;NkW9 zo;v}8&s@P+$6G3}x(byI*7v9d5Y(8?;r($BUs4wv3PZ~A_x-%k(QHRr6F0S-p=(-5 z4&b%j3?Lbu&k8~%RmpG*Y}VdM#v1wquE99@TCkWEeSXK)&N zIi~dNc%(?`f$$bYQEr>n?RNX1^?p!e*1aNN5cz;nyY%O3yTjvOtKO&!Ga4b4ky#0^ ztr-wq2mn4xOnrZ>ol!K`{8Hf-0`YI@5YG91zFFDWqkD#eMzTf*veFpR4)jci)C?RH zLWnp!$&BG~E^?>vjcaibTtR{MT=b|(f%*@Ey$4%eBV4>2j}%d0=4Ej?H|@!fB|>6H zn?#Jsm77<=hXsb}Rl@>RIVrIHt#a56%xM``?p;T*%An0fgXqPf{d+vQwJxfT%M`5{K+e|B9X_$j6!jAz|iJm>lyj#R> zNbys-+QmcYIavTlxAgTzYWk2(Z&u(q6-ije9-0X}C7|!nlM+#`s3Le?xFBOG=Cq4E z*hox%4InEF*6xlXF;XLHV?7xBC&wdbv6G&3gk-@JxwN!A={%OXm|ZrtS;y%Md0VM{ zI!g^bYJUQhwisx_zRTW{>BM9M(BnY~Q7{MGo1@}s6}IR6*e9+l5)^lA<3(?=w!zZptyUn%Lv8sQ&QL{o(^bmLu63v*I}4I{ ztX0J+dqV6}DXm=@+2m$XCTkR6hvK}nB{v2jCE&M2OJOv?N`#Du3$rJUUaT9?q6ka8 zVf73$nE@d$5;L5Wh@v`!(<7tAP>z1au*EE_r%2^L;9oir{%wAl5x3FZHw07`n!f!q#Ql-qUXbvEc zx|~(*E?Nu>A8)qku738;HiuzbA~A{6@enZ6(#f;Qi4WYB0b{Zj*f=5k#ZWH4(M=w?+h zi>zeGVk+}00Fw$7=CQ(=?VS1AjrH522b}a9`;uU84(Kil(-{GP3L3N=+Ry3JUpxrQ z4fPlZ^~K<1z+mXCPv@tJ55R% zUMBb?MpbQUX9!#ML3nnEH&lio$QJ#z6Sm_RZ|FGu5F~3sP%`DJP@&y`U45ft6N^v@W+BaBa@G|cs zMCUYRfw5T6Iz3Gw_O4@i_<+8-UGzoGcKvLS!5Aw|+ifLS&DZ0D&$#iQ8@J-)9*_-U zLf+f*>77jxJ6Nv}P)R9i=v5%nvtI>KWd5TU?M<46wlINiW&{jz zvi$gYbFy;$+1k3(KR#c1QNJN>>PQrc&vS~~nANV!fr%f%e!T9vY3QJVj9!hGh#(`F z#*XMPwI=WLsud@~8~tT!;M05CTCv+}s~W(1O7TsY_6?{^`XX7cPI{!`w*{5V*NL z2rV)rNi?^IyB`=e_5A#<)k5>6*b~wR$pR}J5j|0OhxW!MHkW_rJE|B4m4LqHssSeN z8Y|?s`egY6IDlh!g=NdVv1c2owH1#Vb4l$)q-)c5HSO#$RftB2+-})%zC~CxhEsOr z#d|#psF$Snp8r_hY5siOA~ooZv4@c6ygzhfc(ArJ1d)dF(Yzg@If+WRg@VXqM&nV+la{~bZp^Ly}6a5VD zA7{(ge4T$J@^BRFh*#vN;PuKw+Jw+iq)r#kbU_(KTPds|(T_t`m_UL2LQ&Yso%@%o z7neVb!4gDGy3+0~hO?Lke$HtAAjv{bC;iPy+VdTkd_u+^Ax&;(cP~;+b>qb2%kv$z zPubyQ?&0#r$-RU0Y>$Y{ZqFBB9Fi zN2s~@&v^N?U4ccsGg(k&C_7{jaLde ztj9tqjZTeC`wlw}_akg5qBQ(N?d5S~ZzvMH;LPGA>g=%)oHj$@uVWLK&-msfOqKCj z&(MSg*B}bFc@~8omx=9J7Gs>kiyI54w9ScqxiFuXeES@k_!pX-d2@=FQEU!}Bc_sJw`rpvn`lJzxl zZSS!x43$aK%ULbW$yAEmJB?|{Rn*akRRBsS1@u*qn#(E(W-c{CB)Blf+oe!%)p$lH z*1c%mK?M!PQ~wch84-_}fwU0&+qUwGILWeI>F&flX_aF4(iIp*9sPqM<>6r{Bq)TI zx%*$g62Gi(6(pXP$bd?f=#sbU$BZKSNSR&}>3ZjOsbi_#98Iv!){0yg92gtO*d`Uk z2CTw4UT7w} zLR3bWL{DI_(PVuz#2ES1riysR2dq(O_@NEF_8saqH6bt<>m^YX68vrioF!7pV{=rr`0SSnpoqyJoGH6MW@TWMls;7d?*KV6dqEe?I&v zG9{?te}96;Xwh}+m3119j@WTLoCeN7lH>&|(V;zoFBHr(y1{6sD>)Sr7W4z+xDm%h zoLY41(Z)1MQDOm|s9oDBB#KO>KEwmaNY~6Fjzrh?*f4!5OGF9L>DV1Aud5iTmsZJk zquSw-5f49A9AP)(XHrDj-rjy+Ti0h#N=`0|`Vc?eYcc9q{P;ecuIMktI4|odT?Z|z zAY7r!pLG3Q$5SFv_rI8Uw%jS*-b=R?)d&dPxjl9gxAZl1R@Y%tF@9nysrNWVFJQ`U zUGD6&&@Iu|5b-DIeQ|PV*fyhgsn!fJi}ZM{>{jA@dxl8bUE=go{j4@#kq;qML)~1J z=e;`#YYDCTmZD`hYd6*Wq67X~{aOft!wQex7AMHz!BW@1v8&L8P@Fr7XsJ&bKhGLW zirT2l_crU(o#xNM*ZFaG{Shi1WBEb)b!!q)AOIG>zFx=+Pprly^=&r4*rR5V6<}IpS0CTTtT14g(W$t!#>+QE z|I5+v3aC^A)Ik~fw054`B5Dc-_zeA?=gKC*MTfR&BjHO41+94s_7|ZW)d~o~*HUWw zW*l{vR3rMTy9|2E?L;(^vwItBn&+d#6UGaM!#P|-%f9{Wu3rmB_O_d@(+~yotFDjj zctO$;2=M@kssJ9-v1IcxNZ^MJp}dvpK7lW$!zMM4%|-0YE(9dkt4j{PFw7aeV=vxoOYp# z#7nA)UA;>@ZkOb;R~Cj|h9x~-9k5^t@xz(K8pzGnXA_@Wd$+)ZK#7myTO4IqE2ItU zI<)AYVEGT+bI=pMbWP3-s&gf@mGYTwl@f{Wy=|0@Y+A||lufi$8Mf0NL`J#SSo^|X zsu7B*H*R{{p~PtpsjD(LObku;n&W&STd#16x)Uky=)wpSN*YSI-F!Z7j~CypoPVE* z+PmA`{n!k1yg{j z(|HW63jt-k?uu%tN7Rn=KXVXd1t!I;E}jnZB(|bAE`k@_mr12RG}%$TZ!RW>b8vb2 z8M}CXBt7I}WHQWKd|Um{|4?DJtq-L^(uD}2Y^sDD2@er99IoUQrdJCTXB2iHlZ6K- zSm6fvpnKcYYvgIKcaPh)fnOr)Z8uO-mNc#(wf?it1t1#Cchl?5N?11BrfeM?# zBzs^D&j8L;vPHosUf&!O#|RF$I9C9c(cr>Ni(m=7vSJ286$o_w;ZZKB*yU}{tH4NY z#KRZtf@Sx+z!7WSRMMYVz0CkcA`T4)8^PHXD;P?-N)zoT$KQ5z@rwQ*Y|tWhc=3ni z@M0h$bvF5M43`>xgK6mfGO7LBSmAjWHQ*abBd)?zMrqV}XAbn%J1SBj#z8a9y{LiN zX(uH20W+Swtv!qZeX!RfS)}L{xXUyh>>X-_#U^@foSv)Rt|?RRx0Omu$CvU?JE~cy zRYkNjXQ_d#aJ8zedpauheLPEcZ0kw8-mYez<-?tQeR6(s>WMb+$POgP=!xbV#5C#J zP^H&2JTd`10fn!xf0oPNx#fn9>q_r$+V(OvV#<@23K#IN*!wbuxfsL%@UQDt{q(Z% z2zKrc>dF@dp`t8Da9;869FwC6nWJ5kK}42YcQWcHG2d!+yi>;@f=IRH5p_jA;_=*u z4H6piELWvG$IRRqVPS< zEM#D#HrQtQLNm}p6PSIOb4;;-Auf5Rb^)OxBHE>yb|YJ`E&M=MdXpm=Dn~iJY5BTJ z26y^RBe3fBod1jvs?lydDKYS%0-dir*xHb6W&`H)vy>6>MCv2 zpaQ)p%k^QRhd^tpT7TB0mN#Z|%4 z>)Eg)aF{vcueiMEPMjsaG5hVKC%~9(4%VehHmehRW_KvlYXeZTX|G`ZSr=AF)(mj| zDssMw59KSCQ;CZr-+0_F#7}9$@Vvp%V6@z>uPqT{mv4K&AocyHetmC*A4tJfvjpS~ zuS$a4jum1q+{&;lCI-R9?$kuDl{pjaj0qOqJ-6PVIFG843DULWpNT`pd7ZFZ(qWv{ zXb_2{L9OlJb#Y>c(xELy@H6bga0Ak0K-Tq!h^zv3Z2$;E__?_T;A5(|t2j}IBf_Zd z_|oA4KV9tD=d}G?4X~?-obD+PY`4V$JgvDvLUsi(YVUoX5Qjl9w8jwyv;81LAOXc3 z#=zCG7)eH~o=E!dXCblbJq1-EmZ~bt$mb7$r664S2ev`SkdnzWkoyMWf}l^?`{yRj4-k*E{*} zgvtLy);o4-!ZksX^lliLq{g-7p1Um=)nn*+?fll@}~;6#YmW+{DS3M!ljFCYThdf z6FHH09}S;eOwGhJDyK>mbpBG1U;#9aH`U&LVxtOUV;b=o!3$#vE(qv$l&M+9ejH7f zd&7^aPl24%v_?-Pb4jf%syecDh-7YeIG9MWjvvoSxPH?=e-p%L?fVH7jVRAB{&wMP zjV`SyUN6&iaPo=AOsMlgABT_+r|6`aNj)yFfSpfL4cEACbl2o!~=2ud}|b z#gJ)r4huWu9|$T^Y82G!@m!GIckhj?)PcJqmiu9Isp+^=A!VkU`{G+be^-&Hb(((c zoitF*DVCbNdG)O)tOb~Qe`@M21dqOPK`OztOqNY?s^Au&y3@5zofJyMsHVioR6Dy; zW737$xMP+09(XkL+*$s!ZHgMupbv%9sCbtCm|BR1?m{*2p`l`RC`|~O!2rQ`IEz|; z4#S*W$m;t3{+<**(#2F%5`_pAY8GQk*%qZU{5{-~xGG zAXTGJ%OG^I7()oqbAVv<idz5z|?iab#^{L^qbD;_!f$%U0=Yz=Z zB*7$F+b~CEIU3%xT8pi$X5Mm8gIH|r@66{8VN--`QFWUvH^;&JneL-1EGKqs3$?K@_D))bv4jmbWiy@LTt(wKDdLN zEi;j;B#;>n03wLTvv$af4&OHW2B&bE!NEU*OpS#e7 zVM|bsWN$gUqX;e)I94FWF6bC#jcyC@-bDAJvz0(ambqnJbry*TLLH$BetjK0RB<2N zvQIxy*Cr7PM@Ax>JPNWp>JdM~{vIe@fIxl}0OCZxTIVFe2OaYYC4tV2T*PE~ti}=x_9hGHYSG`UiP^ z@*J^Uus@t^4R$`Xh=bNJ#%&B@hI%2qBZ}`$&pl)%SyRx@}_3xRpUa|Mmx3Iogvw6fhEt&80Gbyt9QM)0 zfBcZ^v*EnAJO<~sKYY^1KLiL@9EwwQ)NCCqV)oW60j}!}(Da}}yp8K6pdJp-cHSK{ zmk8}!&pstw9y0uWII!-l!z?YUeyzk40tlp;==EzanL!9%oKiCr!1?(QE`Tt{^8=CN z4L8-%$O`%fs8oeJG5q}0nr*jjuFtdB4ckQOm}LYB+1af5-L-&UT5G}I+JLFIVf-b7 zaPURNipJ)wnmgnoWc^%Wc0dn`TmPxey7dR-0VAYoG&84t+Co86mSgNi4@Kg0-<+yl>S?gJE@pa z%;6>-+ajBJ?CEVyKSxOC#dIn&KZt5BB@EmUUml1DXL#e54`E#*Z$c)8E0UQ!EZo1BG7R8juoI7#PjF{w>##6u~e`fZ_2+Go+XHbQA>xudtFPWRQS$)&hd8Bl8 zCsk)JbFKr5ivS3eqIVo=6|bj*pGgQKXO2^E*-QV?e1&%=HFY<+BaD=Gpo!qRo)*Oj z!oCO% zDz5XRJyr~bYGZ}TSI@)+ave?~7NECn&p<)O`*d0(wj889f)PW2)~%3*@jS*bt4bM` z;3^r%nmUcDtEs6Z?^v6DF+~7lVu2*8i_G=Kg5{CSL&swZ$Mf_U(#K_ZMj`4VDtfUF zjna_N<%Dd*pu6L(^z;ZIPYGsytaL~|GBE*iRI_Zs{!e0{vOWx(ft`NmU2pX+G7ioW z6M}rlI%c5NuM)CE z(P4y*OroTUP{-|ALUTselG)Zaf8J7u1?24F1kZF({A1NG}+VXLY7_bdhCc?SgUEUXqZcZT+G58ivIC$K)uI=6k{}gep^~*?UQyY zPkdMldcA&aYiqmhNi195kQG*d#wRQ}&%*qd8Rxc(nbirZ7>!QkqlyG6(?c=$V;0`Z z=CsJS^6gQXYjemGr!?#!_2I8>?vbdU=7EKK}*%XQCxwTqZ1!;Ivm>w`V=vO6WCoB=tKCY zN>lv>MO;mSJ47(mD2$DcqP)cFtOf?;s>k+w(4;g13#3R(wWth73@S(x=64kvgsOC~ z%7swzfIq9pLjtltQVH>+t;Vtoj-WD|-6yWk&_N7=Ai{kCoo5fnu|?8PfO2;Noj3D3 z;K;8D#g*FaPj^uRWf@#x24n0%H7bo#ieDUKpw8H2YKaM!>K5Gm3X8E@C?6@gMs`k!#8vVP{9{7FH%2~?mX4XQTaC``-$qh17KO@|3ujxd!cOK|yCSy(48w@3t-VZq+p)B^JW# zs3>)|#+_+|L?MW9Ou&g@m;BS_vzhtL*{cQ~~`Tgtosb8cKcuA{TWt_Im+K36=Xj&;A` zGKwW(WOjb}-1}b*iM|alGn!Ig(IeBbJ+3l0^=`MmXf;m4L?A9zcl!qruisVL8!pwy z_cYptnojKv@{5x<$;oNtV-pKQ$9%eGfwYcB~TK(TK6}vG(@Pi!FcORU~icR zo_MWuTm$!js_9kX%^scVSt-4NDy_#nd=nLG``o!JK+AeID#D!!wOcb&&GnWC5f)bB z)=E;tOkB%s9+&I1(MYEW@s*6EbVXG#A$=M!0jTAzlSSEDshw&hQCP=^R>_V-vkCZRl{pV*P&?(^Wpifx!m z`K+FsLdk+yG5kdLUr?;v>FU(q#NkaG)Tn9!YtIioMh*V!XoGDZJ-5^SonPSp>tFl- z{AJ{V6iPS$#mxet|6hUC!QR};;y;7gvf8fACL@yntO42m~2w->03E6it0L}URY~P4cLm(dCCfD zhJyV$A5OJUMlyLtjj-47QJhCQh;;qo(QB#X@xC_ALrvIm#Ew|>p{Qx;7{VpA-nCH(7>;hf zBHz;@qR5y)w=qWbkVCMS1l&IpJANJ3rB_OfogyFNvbQcCqn065E=|OkbwlmPgM&1J z59Z0A1IY~1dRrmm{aALk?#0`w_G%q#Ecb7b-}noV`!`5j9w}hFFqc;VF`sN|1&i6p zx|c3pXaO2W(U^Z>0Wu(|;JU&=Pnx`lkHfmueIML;$H^`Be2 zHl1x0QqH@coryn$lmM^NX*`KK8@niTpQZbzgNjp@f+)MXP}hpLw$%rm#T#10bAMMJ z-@%ISTp*uaEV*e@?Pp1&S6wN%+=lfm*qj*@ZbU8}TFaEpkpuXTghE6)+^8Ph{eqik z2%jPNx=JU7+3(i|P*y=?*8p;*j4$CPPnMR!m3FU`l6#+F*$mO!#k=*mi2sRWhUvl@ zQqThdiH`vRVgAntgoC}Sk(Irf^M6m|+Rw&ile2a2^#@&dwl9)=s-u}j6_pv`2h-^LA)uK(kGKvg^lM`r$i<1Fpu_{Nx zYAb>~JDM_^VWMijukX`7sxDmQSy)v~Yx%l-l6>-csD$={oIXpthtL21;cOcaeSbec zGXM6zyVLXI=Ij5^r(f|fy)As!ID1Hf>_uR3a?o8V%8Qsz9Zfz1qco6i<&IAKSR{#Q zrp`(e^;J`?(c@2-mEHJ}fv(Xw=dnxXrMp`8UM%LGwQW9f)&<4?D?h|2YfkdcSu3hX z4-kFwiKO1%EHkdm5O-P}9(-2*jsiGql_;@SyWfBg)5y=p?u_2bUYgOQ-bPNb6GJu1xyQjQ-G|fksZJibl{Dt=y(I-&Ulh z{#O7dx~dz*x~j=0aaW9K3V2HNPgOe=fL%-U7;Rv1Z7Bpwda7QBr2XShz7b}3^-@Q<^sbwdO&h0!$fYX_TLK#vGPWV#p2 zU44Q{aPi&?AboPY8$mM%j;lqT5RFF75gQdJjFd8t;-_w|Sbom^&j}^of68dD#{9t|Zaa*t z$G$_2)x*1BKoE41sI0_mTKoxsDq5&{4FWPpM zV~Rym7(I%hGC;A+{+#;iUI8{5D$YHhR=1DzGTC%C;A^cVx;=q^RV|@lHLE`+gM>d6 zfAIfNaUKbT{3}|q3yCaI28W9(G0}Y-WkZoz^ynK)Lk;d<&@ zHfK+LmY_Q$J?&2Io#jMueKcnTqcs;I(mn19r|YY_-JzzHcw%EDthRcd7QYx;y9TkDG+j zE`-46iXdf!mX+2@IT)Xq{Q0woyN=~gb-dsEc+)gg!pHKbr-Bj}OXTm&?~7oOs2jDQ zQ5u2<2o%H27;ik|zo4I3#dM~@IVWRWzMqs9CI$6nB}Cm`Z6v} z+Ws$KSQbo_5Qvqf7f<=;LGo3R1PU3&)_LDln;Nr6@l#>W$+{0&eKZY4l3+5TU~K)F zfeBI~{qcNrxuyzj&7q5U=$JCjNIX=9fU?utl>x z3CiCDpWet+fXo<2HE(143SGz(R2{rl>kjDrfX!RLTo~UNQ@BUcl=f|A${t&Q)v9@w zaQ9m_S^hGI0q-9Y&o62J%t%m=2MXd#<&=o5X zRN%iYQ=-MX+)jCbx_%U~qHTUd+108Pj^zj=h$jlN-BO?nWdUa-lj;2#eyFc2fngY^ z{-_G@T9nK>W<@MH$WF5(5VYRdBN8`#8czq9y-!vErk5`!dViE!nkYqO*H=H%Im~I( zLm0uDBr+OSHwe1ZV=(O<4)t4(ovVU|^#R;jEBzg&Y)GT%RT3{By*615#v8~RDni&34S6; zJz8G|C1jZnWnTQd+EO(H)tfbF01n>lyFZUu=1hwxEi@c)+c=5sDfm(O2coeL?W{#c z&>7lwUsJ|0Z#mWh3tum!Swcn=*p6!UZ9S6wfIS33ehI1DN{+Eprr4V}$u>)~?WvckzIGQaOaFl3G|(Z%OC zG6X0VL~ZJj90j|BiXyot{=hz(cz<>1lG7ln28i*zt3oFzcDaG5rjvs3Nj zTy?;@qFJ`HIb&IE9-uTNTn=E-Dqv;GDTINaCmm&?EXN=EL`|GVX#IWsM6OOI^b9#vYIK$vtZq}0-gkm6Al{W!H3ltdP;GxOfz68{mp`-lN}8P(8+%Rxhp zALTs>k8~l59u{lWoObu=*r2$&){(v7;Jl)xPFmfS~i-*n6`JVwufJP{gYD96{7HqSHq(D*aAXHol1 zRij`KNkcomO9F!p4F+C0K}cK-w`i4i%LgbUfCnbL4wU@Q4v;LD;({~6kOlBiLsD(0 z+uVs0bKD}@Q2NA!AfMoOAe$poZ4-cGhU1E~$ebgVzp^_sG2IFu${M~2hjDnOB?#tz zpfgJlp>dh%%&pA>Pw)JW2zhx~-j<;Rto(-yX}`mehjrOx==b0ecTYK3d0CM)up zn-$eX(Q4pHQ-LnHb6x#VpKkqZi9qJn@KN~coMLJufJVESksCM*vZyISO6e~Zrd0AS zleU%}$ZrGLsN;)ABMG|T1y#QlmzL?Jh;;2*;)dk`26J$Mx?S>(^dCc|Rnb2@F+WQ5 zK192)OX<$8U``N0$bl{OF35^;{S|uV;Kil;hZ|vH;;2*vS1+ur&|nb3dW-P#v3kzN zu@}V>7M$R7>QTgd67f?spWrX-BdJ&|;n_(k>E6TR@Sx3@wN0v;(sa=9UD1@fb98Af z#g8jzaupZ}F>!l}a6Ld);540Vu`oJawTnWaLCvZKJ)XV){+eaNg`4VM>7EES6)QEj zhX~Q=`bi&hLTrCBNt#?YtmwXu=N_61oo{va?0y`ThIdw&6AYkK1^kAfnwAJfo5XvH zDJvEY{EK9L3v2%*2VH=?R@tJLKEjA0vbMDR+VW7pVPWKj_}=*$SllQ0+6>R^M_&K2 ztpsS zc!;G`n=-e%=ZU6!n#T;@u#9Ks*Qu+_irHE=Tf9 zMy776bE5T{S6)1XmO^Ei7Jwj%pCJJDetjGaT+IgCt|=dQ{#%grGU zP-F_!D!TRK^{rYp$KeFaT|ugCI-)2DeUSDjSf#`3C770i%u&v8gg{H6HR3#^gn?AW z`hQbu?U#e2gP#mqGjnt8RAY_Ao54QqeuwZ%31L0T--2oBw9WBKHi*FqUD&GML|SIi zmlPY@3!4GnjJyS<&wEmk_@iDJtHTV7jiT}$F#x3aJ&M_=cunPaGRI_%IWi5O(ouy4 zv}Hdp-fROagKeTc@P|BCrWiu=lZc#jZ%|P!y6Ch7<6qdck@_GwL#HU{zJm%vRaICw zP8*4LY`4&mEixy2eNQcFc|SBp9C!rKUVu`H3-96fc!NrgUkZ7Kl)ymafS8%+8jg92 z=b?BM&CVw9_rpoC^{ujHi{)3rjeFo@^kMSq)gaR9*;s~h74c_v=%)PQ*7<})L5E5p zUmQk@X4&z~$cTV$9ako(-!Z$;b<9GFtpLmkyl$(?3T-$Iq*F~LU(sBobc~yEY|a_t zwWmqQkcBKf_D+uMjzcbfZvOAf$@TsI_4V}%WI|D);`~uEeH&X;YyH`&`>;H{qn)sC zX{Ypti6WaB-HHu5h7Yt0R+7y|x$W2xm7?9-OpV3-i&8VN5bmsNmx{#S=Y>j>_X;%~ z3nvzpiwIx3?@Tkd)5cJDi_Pj;1#F|rySmX$WjI%eKoM4I^+@(0jw_m;gd15+dRN^2 zMb5~$BNJWm@#RJkgO{$l!bd9jegyCxH~6Vv1Z5iZH3{ufm`|OMhpDG8h_rQxweU)pl~?6LA~kx0T+ z^Z@^d$?;2AhRtmRwhGr+*mst-{=mnIeGlzVKVI|QCCZImSf|QTKP+X|TWtdGU}{R&?z(r?t~?H%_0S*Nd)Du1F7icWXmCGcr*iiHHc>OT!mRago%v@AsJ9Ta z7&c^VbTLiAY^{+JZqRxE*%a$-)=wy3!wQ^eEyCDT7n!4U9{M65oE`WMQjNXt=lgr5 zcNp$EDRdOmomG+gk@R2cehnrXU%^92le)iO|5PA83_q z@O*YBaB)S5>!M2RDlvCqi%BXc^q#WTG5Vocg3#eETWs9gr=V-Z;G_Zwc7+sf^I4)NvqcOyFb00ua*DRJo`?AhET@nzL73@stZw8kSmS z5*vKotIcuej{*wiEVGx52fhkgWBlY^v7z$kiBVqN+<$DctV9lFl^j$9&D3!ZfbR|7 zsm+6q%6DP~$KY2SV_S#|7xc-qK_!-sVx}XF=_8yf{NO=ViidmA5&w+a`2 zVICaBe*>Z-$7P#oBf5g^SDbMV9Q5<6(9UC{qGnKv1oT5CIFs5{AB+#?jKb1HH+T<) zk?qr`Tg}J8Vb+c_5|a`#){8+-#uE(SLF`P6Y+&xSVrn?Fk=H#ZzWl0l`pZd3h@YR= zJ?fwT^YJl#pSG%F%UUBS=Fs9DGb=pZ*@8LAL|LtsX+2H&_$}tNJeO9>>FxhQpF}1| zoNXbc2B8)Z`c!AOJ`6KgsfH#*Or+jc%5Q72JH{`h+W=!}ve%|LYmBDUC`DVD*Id31 zfTcdc`lYl1qAunUE@er{DAL;L2a7b7`e3e@@ZpIc%8q)4_{`HI+sugWus{6IBUPfJ zR2Fe?9=+)8qn6xDR<6h>=e*O9AwNF`w+$|8(8t3UbKzyqQ`NXU&-VBx|8QPpE|40HU%`t|2iub!$P@8-Fb+fOMg%DObHKF8<1z% zAux_MR^3|CX+IR{=ys2oIf`BfR-6sf(1b(;ZJiBMuZ?F@gWg*|ClOSim#y}-z^|Qc z&~0Jv-aYjdEaA%=DjsjBT)70rjdbKm@TmZ|zC&AB>0&g${PG^;7wliC?`4vzpRMo$ zlnSc?+?h9)#?s1wyfKk>YZg644eaaob=+7a(1E*wtiH?3!6%ZOjgl zcVZ&zEsJp7xb&DYK{MsXOn?@~Gbg598jR>ko=N90k5l5|{b}E@Mdm!*L5%{F54oGO zX!KHZxUkwHb=pnE%v*7KM?k;@U?o87!I6jzK}-0>nzY6tUxC`_o2#}qfYa%cn8cHw z$OQ*1^KBfia1`Xl}4B23j&yu92f^ddzL!E$Bi%x!4w(DIi=ovh81 z4BqbTo-<|nxpXpp(9o~_#2?7S{Qh|@zM=I*mBOvR+iTl3tx$JK*rN{)|9R@7(ZDMz z!G@`R%|`c^jcu1kmd8$g235wXy8|fa8HKxQ>Fasv8?~L-39~(0_I~8gn%%403QvtW zYn-q$n846-YGe1{iAyZt>|`QUBavjo)j%(Iw&Cg>CWL3{{h ze9;t_*@MZDoYEUxaxH5!#aI)8s3O)T_3=rsCOC+Xf4CfI>iBXOqdpv8Vod?pl;)vQ z%c>Rz(}_cshBeWHNFEeSpmlO9Ufk&>9=orsB|8m;?4>V{#q+E4_7j;B0w%L6poKM} zFn_XUyDO^}7z9asgyUeUIzJ`?uwOLGofZZvqVIDyTrIw_XEO-(6{+&%I7W^cKqUuK z?{R)fAsUSapK^xQlp$M>ZBThoXB3l|8hL=jZLEoRi`e_k@$IuZlK$KrVz6Qy|Bw5a1E+CjX;cm~9s%iBRe1}F~2Q09! zpVbub&J>k=kFqyRl7pNn?+(TmgaIk;I@L1SM9(C=EtAYtWKYI)R`C421KgC3-)fOk0JTZH9z0UVxpUv8D%5Lpz3U2>+=C z0`oCHx~pgjrxw)^{0GdTBJ(PSLJvr3uu^QsQoX~H>Zofe?Wb*AB9=s|z-l0A-7j46 z+U8xcpct!`raLI$>Y70bgt%;QDH9ZgGbV0{D)eT_yt-;K-fL;6t;n(LP|bm6W18{t zMq2ejymw)Kg_cgDnu?S^D|WI6z(!MdLD+pyOgtCJEfzQ*iq|cnRXjs9)F$fb2ft;- z3gN|@xyOZijyhNZYUK|#ST)#Z zxALM>JN&7)ZcL5RX)s%WTzEYPxEvefQrhrv2i#NBq_xqhniCD4r65T7aE?jL@qQwj zyX2NO{K`;@6i3y8d5ANS2}COwxZ*)sf%5R2T6y>U^gm5hV_ONg;&cI$$vL)uX+9Hb zR4~jIWO(>*gRM@YD}kMf?=q~TrYtWg1WVfCHeAp4t7En^7Dl<7Mwck>HgGvqy<6%i z1<$gN7OG~Wro56h;oUc?s=bnb`3}B+!{Y<6X`7yq+}`x-cPuco$)q0Z8{g!67n@EH zw{Z;g(^p>P^DGzl-v{R0l-gqLz2+?G5L*kt8-{>h>q$CRskE=z^+D(iu% z!SB6Qx~rktIEOS#VBevaZR{vJ;qAR&Qrk=scJ_GWn>OFczF1~W0RwD zLjHX+odCse#;MXU5?6BtUI;F>6c(8%zG&oQtBb(yS#p2Rtet|Z2ajn!F; z;Wc^FPiL{{o}lO~nKEVcV0>CVaedpQBuH7@GZWvS9WiIe=f_)pT}KRge4J~BZ0Rc2 z&s3@oZDeLnE#J)M0H1NYUnYNK>3muSMtogKOCImM5~M5WzV|C2N_6}%x0q_xxSZVx zIJ9%U?<~el60jMHmitUv-{8oqw&-y0BOG)T%O>J^n;uWur9}1uml>~-vw=fbljcc7 zE9-5&&uWiFdun%@0bBehbFFtzv99aH46Ci1Hmmq?Z}Z~DOVqk=^m{GN15$hM6Uwa) zm)P?g@gv)?htRGQ}}`8eSJYi}*SSNnsSDQ~BW3 zsyT+C=@||q;dk{;&wgrAJsIb@Z^fLCKiSzcJq*JD2yx&pnvBZCveZ!E(8=T#YMvil zLJ1P`>UH-iTetH1L+?~hcIPPhdaRe0fA`GUBl;uT!Rb>|x`MOjzq9fA{$}_#^xFLT z=yXc}8|q`VVlLJ8%6Y~&UAFkbbc-K7CKW{7Bu&mMB&-fwO#The)4ESjhq0T(4k3sQ7%LDWz<~!Zi3AubL`C3DvP3~fm z0_^m#QAodtIvz{7mu|LPjpnUeqapE{$Rlh2gC$xWT)Ep0lih`MdLHu#okUE4>E zpATxsFO`YfVO7&zVis5${7Y$->uQx&ATz(eijKcS^Up{0RpOvVma>j+Ke$j$wzdVP zvlVX>RbA3s7&1deQzcwvxl)RJ8A5@=!MxW0ZA`LG?hBu2!qjDM#zmRxvzO2aX2j7& zyN_e5#sW){VDPL^+S3L5E?n0f-i|fK$wyz9x{A((_IzOzToZ^H$Q1Yy@sbnBs!R2F zri?%pH^U|MHP8R|D4YV+Pkla_kg(0K!o@YfWcoj%iv`c850B3$=I3rafdD?AS8LO& ztLT5{y5eUK(6TZs+V1;RJcJ`h0|R~!q@SCGGbi3b{&~Ve^rtE_W62OHgN+gV3wgQn zA1Yw=H;Fz*DEDphmXQu69)^U^Kxd|G0&Ij=Liu}Jo5ec|Q|g;+oTKk&%-5%g(=ZT28=&Rj`mfo6zv2l?^1Hu|^nUzQDlrB`a(Jv_+#yzWdvX zgF+-Xul61pM((U-Je>GEn!Tqr+r-a?hpAho2KsXJ#G1o-5XqPQ7sPm$Or#Om&k~b#lKop~65#@ABMc_{9WpTTeQj_lN%+nIrJSInO zsTqj#!rAlB!FLZxRG}}i6;%d<^2NoQebtF!R+>RR< zEQ7C70-@eW(<@+?O+2!LkofzBIufoM2t|*{2L60r&(_TE@_ThD4tdmKo z1SvhUZ^NL!+EUn#&GN{KKBM15P}N5KF_NGKgf}2nHxb(QvZMt@*S&GHQJ`n)`XDwmak&W3b1+^#Rz-L^3ucI_2c z8(QC1jB&Kw*vjDp|CNCcD5m<*WO(&rfG8TtK=meKCfGEMX*P1L2RpMM!(8^Ov*H~Z zJq0ruMakhX5~qffx+G>K$NmA7 ztQHBY(MoSAn9D0Vi($A_5ZtGKEhb!dGEwmB$FhuoO_FM+|xy*rQ^O0cP7+UZHW=)X9a z!I9(r+(me=C8=6-s2SHZ78DiZ4Lc5qdeNR_;Y(B09(w5wXRu-#Ww=4V8kPs3fk|-n zf5x!-L7;&({T#weo`jL8fh%Y(7f;;j+M{u?uD@=U>>Tbf4hr~uBeu!!YQr}(M2{hs zOI3!HMqP5wF8s+{LF1Q8#ZBBKjv<^r(d%4dE#@nmCW0wXeR13p@Vglo$@s`Pr5YQF zuV{@kCK+h5zVN&<3$(AUb6!C1+WEP=f9>fP3=2EF)diTa;+b0KdPlPV*-4_w2J0*( z2j#OVv{wQO+KITRIMS{vR<@~-Z>_A1>uSros9w3>TrK1lKLRM?$4^RE>DUzRIj_1| zy^r>i{FqcpKhIay*qTekk4bydcwRR`_d)4PzTlm5mjl?e^e$agP^4dv#y=j^S3hw` zT&YgN;<8w1bspoeS|+v4Q2n@kvKT+epF&y?q=emic$72KvOBPD`9cOH*~?f=Iw5AmZVNsD}B$7*6R(@jMeMvaXMzMwfJdG{jHUU9x29l zU$C@5=G(;O+l)?2Cvr_M{-zk}p+J_>C*yw8I?JpWmwI7f`n=iUC?clx@ze;WT8 zV3iM86Yxy>dNX0pErZ-uC^r_^@o9Zk)#dN-<^E#i$!8B~T=ZH|Oh51D zOs|FCuuE=mR}~UE8*rkLuz1ZL%V51L|Z8z7I-%m>tKtQPjY)UGaRGdIT_AX%rNeKIfoo)l}dj^%zc*6 z1jsA00n(*NM74kKE5V3C8gj_gH9u^?{DKlfqIh%Fq)B}ltZZw~@gFXkw&`6xvGA|1 zxpdiQVYZg4W!L#N8zFZ$@gNSCHY5taejbdE)bw9X5~IW7{SDU2|1AODLSXoHpJ!i##F%0eoEj?@+I`Wqt_|2P#RyfINI@h(snvYc6_G?CJCQnP0 zpW36zRh<}2#q9lXrq)h-nZ}^D*0fH6c%@2}IsDUfa{+f102>G6tpMY8nmZTLDTLLe zf9z6BA=!d}2cQ%88{nZ#s_aOpdTsqpvbA!t@^G19P|0 zbk5}cgeg>+3pHC!*wL)67-7R7Tx#B=_LH*Z=bm{!(5Dq9|FD~2Q-3P9a&f)H*OH$& z&A^Ps`w30k@Y+)Orp~kp>f88*ZS}Z$!M`+|ZhVk2Czo%NAmK=j$i(_D7($azHPOPF94OK;k)(`K$iE zQt9i!m>>a}P?}L7tZp76pCwc1ZFIcpGY53}&F8|i$T5l=8)Gtrv=dKUziAW~DDk(q zS2{RRz)o$OY6ZK@Rr>pw(He9k@EcBIt-lvR#l8N>TxVyN<8%T;L0KOV7UF@0&WCT2 zx=LDQ*MtGh@9i3MS~_7uDSkXUV_lMk5Z(Kan#w^R2VBbU88bS5yaRowk$ zmDh*Xm#dIeFyfrJ8_{rbvXD3HKs(a~T!%26>ti&<`#0fJA#ybe+js0;rXeiHPW{>1 zP~@mV?Nrs0dI;yEAVOJ-Fg6;ntxV)(#S@pmO>VXThtPhPbgf6A#n~P^b%pcWo3QGo z+c~9`x`;V(XD$DrMMIZ)PyEQ6G~-4oYt2F}COUh;3pF&d4vAPa^66{)Xmyv;Y#{n_ z3eu>?l{`4^!DK#O*>GB*3a8>g4JvHn-DhDoK4y{Z1aF2gg1sQmartB%I5b+BaX9YX zctx2AQN*RO(c;jdD*~qMzAPoRa__6?2|mhhV|p(xeH)4~yl~Fw zQa`Qd5S-xw7bHfXoWccKJGxKyh-)W|1C zFwvAsvk?}Y5^JQ?MzuMdR=^N|5%Cnn#dBEq9A^>!qtMk+X{FF!;9^U^2JY=qigIer zxKvX?pX=nj&EsZmC%ooobJ=05^b(`PWUMW^SQ;Q+HQnE`V>|8q^!2Qn-x7H+TrgE- z(F`SM_53r@$51mJAO%{8dM!=*Rn1BhfsZNd1@z2O_*r!owZ@_8EqyQ^dwN|$uyZR+ z8L3X`%Rht%+rDFD*p2YzOJ3%d>>#(O4y{WqQwLMQDub!`w^8~Wqr8*~$4?&czgOP2 zKds6urb^nC=y;vOH9oA$;=mvO!TTrFGrPvHfMBwbO#G6Yy>Q2*A)}3W7WQxDN5mz* zn5u%_!Zm--j`kt4ce)(B+U+=o%C6QaarVuAifMO!A^0G#HK3wx#3KJl4+p`nYLjnZyM4-}=Tg+K`s09U6z;c;QVTwUY=A;?Pub9Kv}m{8{xv|4M< z?Ayd8t~j}#HS=q9<}^!$Z&y6S^m{_cn7rFj@yF1o(8FHXeVbkJ%kQ@CE$>#PjBSVh z_H0laBea0mfOhtbY=F^h6DdQ0hbU)J20m!Al{kU)4CqeaF1Pk}09>zfBq&%e|*5I3pweh1`2x$qZhIO2O#qe6duF~^E&3;dl)$RiGu)W2usRI*P zhz<(Ph`~Z_f^>XrC?4Io;0)45bd;^D(x5Kg8W9JWv+_g%XnDG?W=*I^+ueB@!X#ru z6-ybrNa1r44c53rU&}Oc&~tYXiF=ROclzDt5}mL>m%XmR4v1&o!JFog;e4+7+}nRf zq_QeqaAvAT2q4kdKpobTD0J_<02a-e|C9+F|JWrlEVguD@kKLo%Bds`a;@vlo*Og6 zd1$O3HzH@-AYTZd7PgN(&Qr?%s1H{@A-h+hrt!eoL^bpM?nqJ-fD+#)>m zF#M^C{KHqhVoQdo``><@APH(NCiH!gHb@(oN|X}7^Vqv0dHnl7jq_%m-84x5wf=ej zXDt68xQ(fince@-Ene2#jQbCG@As;Klns&uEMcE?QV4dfgvs){Qmypb&{T3 zqL&c6$q>r3WQbYhR8`-!PD@wPa_~1)StGs0yYxo2B@6n?Z-hjul3I=Z_yi(Gtuv}v zV*IdtK1YoCpIF)$MwIUj$NcTVK@n~MsBHpTY$^|H!$b>JsfgHkHL5pgEmP_>+Z@A; z>ct6-6P0BkZV49@XbUiGs>(9L=_4K-|6cQQtdvm6*{3`%xO<6=dZwd~Vi>87pc@Ax zqm5;hDh7F4^~F%sQ1ga4w;v=qut{^n_;EZ#onWkK)NlSo^JF|;yt zp=xR{m#dv1!$6}AP=~tc2rPJc%#v;=BQvBcfwTn7PhZHvz^goY5&5c>Fjk?9ygl&1 za1WdOj+OK>Qwv0>>E;~cpxN{X`MdnLOm*Wtmm!4E+=f9rYVuVuW@ptX#2gE!#dHTYHL$ATdkvP*BXFpZR4!O&%3D=M zNUKOCER9-^+x5a45>TWj4+jYmb!J9EaKe<5qLbk_+sDw|F4L0C^eE#lkyey2UV8ls zw(IIwKz_;c*#Tc9Zn(8KrdpWwS^tNua|jYGSh{uFwr$%uZQHhO+qP}nwr#sl+jjrw zM!d~UQs(UGS~W6j53eci?sd-GbCsK8$;4+vIPSch9 zdmI^2ya@GzaQ5uq8pqF+q%LztSHLx9v`d0J1oGJ6>ZIBRnsA|`SW*b__Mfw;F}Ylx z_lKx5y&q0i_p5gXbQ=;NjAA3JsTw{~zTzW5wVmXF!@A;XmXpLA$ija(!%h;~ z=8ymxW#>-t6zC8W0Ha__BRYtv8=^V6l&F?lX9?a?x5}s#l0jx_i65r_a$PNxKvjWC zuHGU8at2}WzK({WrD+^@Sljr9!M$=%x@2e_USKLZhIRNH;6PHGVH~~Yzl}p}_H6n8 zJ%V1yKs|ADFTpmB&4p3@cHn`q6!aVIHm=P<2dv3Y$jS>__grbE9qD$NHjLKauanQ! z13sifstr=H@eSM8*%jB8VHz|0G>~D+o^FrkZCmm&`B1LO$0@va*8GrllCwX+oIn=z z`*3q4t@NMU`>0)U58Zc^kY7&IjiL-^UqgzdBAe=AxRL0a44^9Nkxnf|l@Ma&qX9|< zmw7&)LseBKcOK{Lq}`wM)+iW_YP-rF8&C$ZM~B(htxi}(qsojJlcOL@a5tpp@p>Wx>Ub+D`>zS-2xGZh^#36vq-12_N_E`tU8 zfr^Hb(_RYS#A09T?h&ckT51-`3o*5t1VSBtVt{TZ-VpkTi8liz4@5xXrMoiDhYFhW zW<(Dzf}a2IxHw}mlGq?)k?ZR5q^2uk)fS^v$EeAI_~RjSu}+VOWnf(nuOR|s9`5vm zRc5hLxijHx zr*^y}nmbjeViJ3+Cvz#=@B9IHenu^cv-|+QKwhgnWNIa78Bf@PtBiL@BQ=J?mJfg} zpz7ajRd2NHor;fPmd)iV6w&4G}me-bvV$H@-j-Ocl zirw2TCf&^Kz2f%NAiUKrUx+J9((Z7;^eeaOeUP9L%1N@j8QO#X`3OT>)8c|%Id>mF zm*};SP1&d2Ryz~cV2eunlVUSucZ0Dymgo0Fm`rX?E$56-WHr?9_x>@mQkS)sR#%I5 z__nU}R9V({JnSi0W(ji23G|sAnT5M*2Zmmy%pM;u1>^z6`nvft6;v>qa4)4Ohm~9+ zdGo4R^FxsGH`PyW%<}W)H)2_I3O0m0bMD<&gx?$eIl{az)6nSLk2;?f5@HYZQMo*kRbzm_{#EN-8rE0|!;a%=Cm8)IH@4wuO z&;XLonExs$*uM(;U-W$wcM~JMf0+D#=BycYEj!{iRNvP+g52mZMx$Fzh4Im|Eqdbha+U+t97YdfCzU@F0zvU;R?R zmR4@p^{WpGsfW5K*V0D8x+D_@jD?=bnkv`|8zXX+K<}#OVS*QTst{9;&kq7u(OH~1 zZiZw@670Q*tM#R(-HzZUjZCR(9sT|erCF7UD?WaQPsK;w^RK3OHZ?_tN=DD;**lIt z^jG@6U1*xoC^jYMXV}c~G53+S)jUa|)GHSLW$yyXCr|O{I zu}5NXS^N_K zBMd1R1li1{zrHR|EK0u0;RB=s2Nu)^3F^vo^OuC@6 zHSCVfBd*l!7+@B7vD^mz!h-r%cY)YP19?m&>Dxzx&EK(LM4Ri{m|GUP`u?Id?(~Xnod-xGkduIyz%A@WBgphEaYzDV-6py5 z_3BCHcmv1>#*V`T+4J!e4AB3=R>=vwLlftLv7aI`hO|RVZ zEt-l2J+g4zJ=n?i`&fG93<))spM7By6xnWAom?jsd7uoQ-tI+v!cbI-hB?+33C}yU z8!g9zLT{`pMg+7pUXqvmtT+^RxM%_vI^m}tDWWjo^81`v`ihP0WFrnve>C*LN^bFZ zzet3Fk9<}T_{f+zca$HmPM<0xQy(PfCU2**B&GiBn^C-WM+xX*g%jJ;uMpvuR2Y*> zsv_cyM%26xU~?FEL?GUl_GJGJOCJdQqA(nvUe_G|bXofvAFS20bl&B_oHbWg3fruq zmdR!WllYJ9V4qSObB?fYOqyl_KBFLQ28{mSv;6y&WH@AYru9>i)n3B~!L z)F2Le6CxP4yFYY&^Jck$+26%8;hb@&6jQ%njph!oZwL--Ypi*Ioo zwCdml?`ku4_Q3f3Cl5{zx);(etTCm4+FI*D&^nX+*RdLu{CRoF;+{gqNb;e&q?89} zA#JpPUw;i<@s9&O!(jJk{-VU$&EQ)-JxkuN&gI3-He~yK-JMAd6$*TEfbNN#?%9?u zzTMfMakmuvfi6(+ty60<&;EG3 zQupT9B_LVlU3&&3m34+?qF~YsMenmcHAF-rwLoh63tHMLiWn1*i=Q~@O%0acP5UaL@IXaOY<=hkv0}Q37+|5W)g=j0!LP+Mq=7w~ zr=e?u$bK{REe2^4~7M)vhR_{&tetDe%dP_-Fy67(S#jGEH~@4w&|a9 z8VV50bgL_NGg?cz8a@{r@O{bx$RO`hVd$>9YS5HDh68U}o|kn={To zoAc;Bx8F$0H-KYkAPu*K8HY)!q)nUU(Yg`0j|US81kOa&AO8`+M2)rY>zy&c_MsqS z5^fdl18_)?n-|yD7a!=#Yq}Xn#Inm4$yMMHJtba@>PBa3Z@qLafdo4;K~s&)^9Tw@ z)JsS4bTTgZMC~-AJU%bq_wP2lQ#txQ-C4iS&)dGwqpz8jy;?JB=X4S3%p%7OkldyeW_Kk@+21n>=}aHE7;;dlmV zy>109RPc;(r3AZTb(%t!?$nI=ff#KX;dI+J0i^dJs8y5J)n}?VLUF_5M{6FFO3()& z0U*NJ`Ai^2MG3g0y}?3>2A#n~|24-vDO#osbPXcnH!5QU+u%tPv|}n69R0Td&hQsa zG7h2{Z-*8jqFyQFeqW+O0{Gz?pu#jofIy_XNMV4jZ0HiLc_vIr7h+;Po|LNm@W%>w z8eMNCr#G&?{dLqq!;m%Jw1zO>sXWyI{Vb>Lj%g7BWGvNaFmC%ab` zs-v}l;3}3pk0IPv6c>ykQ=ng~r|j?}!79V|7{#}!1wuhj%>(bnmub@OVs92@tY}_! zMY)GJFp3KCI12RL*>}|t4*smmj=gao4Ia-Y65k~q3d$Tt)3qSIG zoZy7FXd(lmzWdZvO5{MU1=dQ_&>oN?m~CIg$tgLOMdP^XmM+~;|-`B@+n#U*LrELLTt!4wp!xEs*Xjrd`Tjoy0 z@T(`0WOpv?4+mh?$;+ng5oQQ1W3)T6=aa<>VouW#`c7V;=zO+fI?7kJSSiGdF_d-{1=ZGgntX#LFS3s!-@RQ zg6KU>UQk?<*@4`7Df9A1F0fQ}esn@Tgr+LvMj==l7;A3z!IDbIllw{7YZ`f@BoZ^%OSp*WLFYlQvHMaHbCF!|`8 zu6!um(uv|Ur#$GP<_UU|3N)`nU|Sm$a+zD$tVB#i7PLJ}I*e^Sj{-_!Mycm)rdUt6 zigK@shE!HLG8-9**#M-HRh0_^rXg?QXRw;)N*OkD)HB&1`#e>XngK^BeHQJM!ugZF zuC9HJLvZB2()QZGjz+=jR577eUXD=)w(*%BEHTx{N-;&17 z;}*&P@BoW45FqTqARH9kd+TW-%gEDf9F*!P0F--&(eNPVuRSJ2mqbt?xuojKCn(~sM;nIOTDsEr@OeDvQE}t4|4`!4;XXeiRrd zE~$gRkdpAGteJxj=gJA+63%`pp36r8hlW$5uc-c0f*T&IByS9pM?v)5^*n(lLOx{Md}H!mfP;QvU}Mzz8rCC8;>Vox$Us;yU)Ozh=4cB6gZ*XHkQw*E;#Sd&7(@5 z)NQXrUPT&i8GQ0}Y76cO_C`4d;0|+C2<3bQ#U)j4f{`Eumpqha}?EHcP{Vchy3)IAf z+OPn;g(Lt~5UB2i$~;ao?w647%1OHNV3c1FdyF0OP4r7qzxBtzU2`hH@LWc7SRrH9 z1xSkq3W1LAh{Tr`O}(H;rU}AUd&#8c&S@z*NHe6QF;YH#o^3>n@jbO34_ke^iB<8k8z&nrS zfW&FNS>3D-v$T33RO7b-EdWP?;q%S7<3{zkZg!>tK{$_Fb%O!?e2fCCrv@DDr12zm zv_w)1G&>quLkx4Xw;?Aj^-Zt}?j%mba|+3SiOQX{*qg;1utZ~|ju$g#Lt#V|>1ywP zR!_C;(YmB}%bVxd-4V6{CN3uzfS})h&~teYB`$yP|03xy&Ml0y^-sP z-Oox)stB_E$c-ksG0i*0GXnB~2Eu9i$!I@o5@ef1WATf7g9kVg*1}qfiR)`nkW^2?av4S>3Iw5GJV;qN!Vu}UP zSl5(Suh3B=ak^nO$euNNQW=St3n!qg0}VIDEf0NUMo5z@czj5|ZI{KBUlCPel?>;x zBW+|UMZ;;6Jh}z!KsBc(xuxO@VZJ8)nQX2d@Akq`dc_nO<^xW^?oD)cgK8vR7vvao zO72DTL=VQW50p^QTE(TBnc4>Ips`7GaZvO7^(GTY9UFcc7 zQr$*%&<;_zRkU#nQuc|8nJ!W=Wwf*bORESCKpDQr*}n+VA*}1d`Xi9h|hRizb++-;p+E!;t*-;C4i|nE_-kc3}gWyD+N=V5w zVeeLbA(+}-Y`@{$?sP9k z7vpXint@QPW2h42uus)isi-yiC`~X}pFvkWFU?Y9S+WX1K0H3RXaz)Ce4i&yu%6HJ z$VJpjQ33PW5&4J{5rIwVV-%(1g;U{<(nNUp8Bo3wS67}h0%T448{^Y}y~g;yppu6a{s z#<@9#2eYWeTVz)@1rLbZ_01;u(1QG}T|Qd#qS*iuem1nf;wS>_hO%)nn6AeKf<**c zk;e3tqUgzV(LHfvf83GhV)l6=_k+ubaGw8;jEp4J8Q+n7F>wGyQ(p)~*U?=`@S1=a z>s9T@9lV7~&MeE33d5<5n^(5%{=>AbrUqMYuwyXmO zPFn-H2o^MKRdIVafG+C_y>|se9!y#DmfbT~N9ej8-AaNnXlas};1T&d5L~elMBu+P zpX0pNd5Z|Oo2&pRWSM_dmFjKcX0!$_)vYN<9sN86!F!vX{gK(7s=mzB6;1DLbhM?4 z%Om3}4rWH($l71^AxUu87tdYVT1rt7rqi%U>127!H*5}wT}e6(Rcj`XhgevZ_6 zIHhN-3}a|;(FI+JvuNdb-XYpU@ObG#+>vJaVML!HKUc~|_i;k7C=TJX zWjEcNh1{(tXp`qrmeIn$U*R08*F@v4u2{_lw3o?5R|m0g7=NvQc(WT`?$*ujzJ1Og zGb>R~Ue4-JvUNm$?Hvfiw(h&pMnizgPa$9Lkc;b-TX-6+2uoe*OkHsj-J%RO!^do; zY5{$j5V>bMk{;NI6Ie&W3p`8zE=C&!h!_T9r%9i4k(>FikNOnCPOd)Qd~oBlx4um< z*2LM(&e7`Mh-U%~Lxzl2vxtt(d{e~Vg4{d`6ivWj2?^JUC_+xO?9t zhu+rhs=+F%+HuNOBnTG=hXhk4(%X0?C!XDm^tZq7-q7{WzQjf*im5;h%G4^d;(T_+ zyO;uiPi|)$>l_t9v0u!Lt~XdvfZuOU)g*CN;vCN@W=b(q@g_r~b}3PZ!Jj%d?^Zz*X8EpvV|&K!(LLo33caeE2XS45zA!&6u7z0M6N zSy4(ks`aPcpHNt8QAtXqQWU8Oisp1(u72Ja1d9V($}{5>#xU1aKu%#92{_dpy&g9D zFp9mby8K%BW*~HhU@k5p5g6$-G$J5P8ekswE4)`Z&AgMk0b;8lP4WIr%ou0;gQ5%L zCApGL`i(Ek_~lBZ_x-*g71+UhLx1y}&TKt@Psl-VwBO-MO*C2+4i_(Et)9r0JemsS z_8i9%%`RXg?7F4`4&JVA_b|JuSORn_8~zaz^Ca;h>k;qzo&K*2`{NsS3@?A;OL^v5t3&}f8jMd*=2S>$W~}Ny2aOu7G}AEU{QbAo{O>?# zPHrtq_uJqQTCkC+8N$)KyL}E?7b*)U!1%SgsSruGVnWf^@`H0Eo@-V`kniA6Rf>B4 zJ`7|_idH5f7~u6JQP_|URL_W}qnqRFMjgr21J31V0m?*7@*f`|J@Xy%pJ63w@z3J$YUvJ$Ruwe%zd`<# zn;|$aPX3#|91^fR?v2)Uv{GuM5>hEJBRj#VrF3_XnGPNkwHgj<=S@cdwFw#l`Dv)iD~vi_4`MvIp-Uy9kog`#R@%wPa#nLZn1l5uOH#g2KvPY zhTY(}LBNzvSTVejC}xtzSjQGZ+ssg;saA#oihTdBkYjjz78y)NOhG|c-w^Bu0X{TN z9CMR(s=n3=jA}suTnoCK-=+!2S-jK!UAr;3?pDaWd;<-nvO(P36sigFkJ=&LN)wN&bUatWHoO%A9|egGU}I(qG7J6F?tGd{ zP(=t&hR~LVegv&T!utd64Zz*IbHs}F_~>LXFHVt3o3vKGCZRuFZ>FU_^pg-e=McMbXN zZ?M4qEn1LZ-(Jtk^`~s}JJlHh7I99*O4VBN$&B53c;9U}ZtyT-xQ-44`?%r050)7m z!7(wl5Gfb2lwe7`#_NQUJ^MxOVUV@9_peyphfMUHr-sn7!n78y)PnX{zX0MmO|6PI z^P%6fT(DmF-IRG1@-#;a&a>)m7RNYw&_onFTkjKya<6C)?*>^*d#~j05LsN*0(Z^I zFOb6IV%}0wA2KmiJ&#?LKTF^=2g|}{&*3vWriN_=@M-8pADH7*r*`EnHg=pHePi3}8lK_7R|R`Z|S7O7m+Dogse8I%U&!pi!Fay!#HzLc3)|=QG0$YHg)^ z%I?43W6fD-bZP-sbE{tF*)X{D4NGFyG2g~S*fQjQ0ijG-I+-^-nVjE!!b>)%yBNGW zx(F>#96T3g;%K|uZlAd5HT*qQDDkoz4Ok#(bc3jA>HI=BQK|L-|*Se5puev3&45YQe7jS>t z%0Kh$5o9of4N8YV)hD0dQ|433tNLL+sb3Cx+G)b~Y3zJeA3TU}yfF@x$L)a}lEnkW zbZ`uf=W_yEJQi}OL6s8Dyg0rXJ*ctNYi_a*;&RS|hw|WXImSLI7v2;Ku0eb~m+l;Y zdlwM5HUayrS$*lo)?>KF)?f2BfN*Z<0|{GX0EU;T{XGRG{5ZV*Hhm(!85*-SGUK7S0D_WQw>@-u1KsNdkjcz74l8BgdoGzYdzthHPFpNYrq3nNdXm7=KAkHPYYhZw~HG!5o%Z3(6;%@r{K+d$1V12LhAF=M% z09~8c-3Ibuzx^q|OyLD~*@}KqxLGX>wQm>4w?P36om2OB1m25CAdCpE0O;tx^;PuB z0pVks(!tt<)-T+UrYq>_?Bp8gYlVp#dEY(mt^OSf-^20kq2(~F_Ms^VR)^r@F$Bi>bV33Me zSQ`%th)uE*_Gh{p=zmnI_SP1sEp8VgGgSz`S7J|2iD)S zHF}K)uf&U{swPdQ-4hOp$iZQcQ<|lXrT-3Uii>e)1;x-viWn-SQFaAvrCHHY>vPge zEypiIO?8gy1k^Y$80~rgsH*v69i_>nkmyURPUzCBYBoX=*TtE- za^EdruyHHea@tm~R^lI(1rPY7qGOn8qA=SjiS^Wfa$#@pY|GuOz5=IG&e$5ZniksE zi46+c79Mn&5)YOsG%AnI?qUmLS7LX;B7Za}%-1bxW26^cVOAPbBNxOQND+0!CS=XR zi8K#Yfe8!YtA7_^RxnA0#BMy;DaiUBEcWvOaC?OB0`c)Ef!Ja0E?y*Vp*B^PB*636 z1`bpCbWumwPW6`1)J2na*5mAHn5B`&AqE)m-J+&E3L2YpO$CFPrSDawG-e2dT`7bd zjunO|BFS{fdqe;{=n~TI7n!6KTotzxWBa?mCm*6{?F>=mJ$HNoRyDLCu#PZpDAYX^K`?7BvZ^kt?eqANl2gxthyF{5_?}6xjPmq%AEx(eJp-{P`=-4MU)`#=Pp1 zJ88wBgp%P2B3sUWc7Taqi=e?!Zh8Ex9!Q?EKH})E%rGT6X-mR-Jo(QuIf6BHiWI$O z{2+?@Dd-)M*v-wGV;zdkHbZmfDinfeCr)k(q!Y%{>>taMM`LlOHv0D(L!b$3j^D-H z&KDuDTZR@!=N%l2Y2Lr4&+1eQ%J3hh=j!(5qu~Xi_M_o#1FZ!TAZpy3eLeP6aUXqW zTI3(jy(Z+TXVU-X8|iTAj{&Sk+j4jP4x8IBoi+-D1)WCFt(Qs5AtF~r4BDfPR;%J0 zdy4%zK3idT53URtUZXmMARn6@J1U?JF}kbF-9xPp^#|PF#hKA3)H{?4|K2q^TB+c~-jZYb zmFW?a!&ntjXE35Qh9Y#)`RM~)G2NG&m$%Y`xARSH<#ogZNBW0Urr%fbnU~9-FiBn+ zXJipJQcWCi6j?lh3%s-0WAGK@-3JNReDgTEzm|x~;0saelo*-F$2e&OLFDuvTi!0l z&`V-nk?u@~Y&D77*wfpNmZcQTNT$To@5zKp`S7(~_dta6?u;9dVd ziP1-$tyYARxh#Rw+KUu2ljv|m;Tnf{_qTk5%y^syO|f_y2k6O znz}6GI7DD)9#?LqZQko;T4PtJP@>AYiAL@Qdu5V*S~8bev0rE$_N9?y?|haX*>Lci z^8H9>_!@`s(a?vVt@e;}ms@4ZwWc_efQEGviOBwS0Ev4}Q|&?d@YTnglIxxM1CmJ$pMuD&-tBCm?Q ze*T=t2Kn+p&8S4=C~QKX?hJ+Umj5hGd1$JGo8X6B8X0`wH4KXqcKawVxjpfZ=H6Ef zQG$H|PuYfV<~HpHjeY-`y_)fM{r9wj#UOhn6&L_O2>O5Oj+2Rzqlxpsy0fCXW3?rY z;J2pNa4f>qZt1i}JraK;El4;IEmrqbg5pIRlWn2aWyqhM8UNeUgx^TJC4qbP535s^ zbDOa@P1l;Um`d9oz+Tr>y-;alGQofsv?`hPtz@Q&GnY4C#PN&1Pj z%dJYYiUtEY3^FWKwH`QJy(o_#K4Pz~U}Pd;JE^(rV!W&+#gbT-eW>`cql6c1Tz^RA zO`l?IkEyI08{Nj+0|ipnQSy{_)yXM;oR(A?1ce>!i4(18(~g`vb4o#LJ~86GTh%Q@ z=p8*P9}Mh*-_J$ccCVxNY>{kFzFM*Q>?_`dIvgrtf{B$p>Zl=r7!a?>%YgpigUClZ zF1aFqJj+JEi`3u9TMBXOcz@z@_;gz2Q=4BIS{|7N#kluCqufK5`xyZLjv8^C1hGaq zG89e$I4d;yDQ{Ugl4%zXzhR4~*trlK?Y;~@M4q~CT+v}lxn|>5qBS>B&jI!9!U&J=+7$IbndrCvtjDjr2qM6!yE!LZ+XrG z#NlTojljB1S{9ls#$lm%Tu<~VJq=NY8*~xSH$p9l5CA?XB3Txb`_qy_aSNruP7SBTK5=Y=Y^>wW<5{5Jjb#-_X7fnC!|yph%$h$U<*ljsBHmeWs17tBRJCSb z1LF>8u5((J+UMywVUj)>sh@P>6XneiLrq0r`e^u8*R|=OM!-Kr{t}k=U_gwuD1xns zdz?!tejU(xu-biAi`*k+ayLIeYUS&S^)YwwhE%S?SCQM>@a^Fhq|&D>g`Q024p%-M zSS3(8&AKz^PGKk*5A;Wt`SG3j?mlp!dCz_86HT^qcUJ$l{iKF|`+MjHbc37aj_AR6 z7MXFIvVu9KcyV2$5as+cI)g!Wlm5_*naKCQBD_^y#jy|I008PF{%7jwWa8**Vf6om zWp+nw4_>~Y3-pPAb#8TTBhP`%_5w{?(6w1~jpxt;`pihz<y?ug`T%W`2TrNU zBScz*t|FQ#8ic0Zh7)hWPdqLer*0@O@|U7zHtT=W&**R|E(?oh83wdOEzNjs+RcgX^=VRcCd5*s{5Gz{d^< znKT*U#42nDmcsrG%$IkhaB+!TM;`-aY*PU!_WED{pWaMLO17+w24#fnDA zYLnypwD$gD_K6w6$@j-5OltWR0q(_u<$ky5e&eCZ9dBl7&8x2u5?Mp;w}o%G4OVvhk4nZRUEr$6=D3Xc7uh~==jo>uERrXky&VCoI6S$*3$ zOU9pX5J?r^lakiIDxO0!oXm`{1EDwAA6Pwho zLMgiVCpfLvsb3e?ZJyL&rV@t|{BUarw3P1gA@-yQlG6;jb2enSS%c{uoffGrN);~& z2G0_fp&~Ty@93Dpfuh=xgXD=5O8xsbExEI#euEam#mHdwV=KG+bwro~1yY`BmXZaE z?5W4-2#)+493NtCF3CtZaRdGA{m@VW=;5A4hPQr8Csw*P6@Z!G{4w5=qswGRGTA%v z;Z>eQlWuZ=k@UxN_V6_lGS0D%j%qa;rat{m1py@OI4*JI%Ow_zaPsaA3*gw4$vp+V zh2)=Z^MvN>KM<7ACz4p(u`V3M<*Ma~&!fYV6!-pf-o6fedC1Ngp&R*^@1k29%|?1% zsb^5ck+Zh6zUHoHRxwR(=ymrtH@F{#33#ejWdSVm=tRh4e4F$I(0FsW(xz;KTyL{w zMXWoYh~BF%aJ6za5VsCbic67w%E8tqu<;tD{z=#j#?+n0LX})b>a2^1bhQEa@(@^e z`yHqZ_FKJEt~VL8q+Ysy(&^18%itS+DjOEsk zt#Y_g*4XAxiN1+e*Op^d@hAQRZeZA(!D(f!D~bzY!wn;kv(n0(w_TOK!=4?g%|7dr zWL(*_8NhwESP^jbVFcM_<)ev3U}Qx~LGXBa^Bjl;h>Osq$63yfQQEL=7Ws>b&6#sC zw~(&ARwMj}ddt6ETTbC+-8jyn_#2vB2F84qD>5t4<~0wTLWGfD@qCn8BJx5wIR0UgK5iXosM9>Qm{z)x>D2uA$Dg-Qsx zzt@!0D?fxF1=iSCZ_RGE&3#L*E|-W}Atob<7hWf=>+Wr{DhHUh+07(sZhsZ-QJB}< z=KM9@%d3A|vZQbzCe#)Q&BBNa+qRAI0$P+{F`uGd>AApW+$;<32?ww%fPYLTbAUUco63{LBbmQin{15@O1c5~} zgyAUGIENf^4yMHQvRbqHr7vCMj{bFHDF}i~5Yr7+Q7e5_g}t-e{lI~i32$s=)stR? zSjWJWaL9K=*p@LESm>l%nw+_@y9gj)MgKY`s!+G&k$0S+E!zozJYb|ZZFG_9uCYo% z>XbBxZYC}mXzV#6753YhSC=Da87cbtwZ5?rr(h^kcL)h^;#Swlxg~&%xR-kCu+HYX z7glGoyoo8&+t5Ku;Mo)JkI+F60bBw|3j7&%Iz|2FA2b+3dnkrsI{*Gy8NGmnIaQct zR~3!%_8FEyd-{uj zjU}z}j^YPEXTsON#0K~xGS>(g>EPkR4Xa`84trSpON|hT^iF#B$q?%`KO^cPVEOu$ zV#q{Kf~a{GRP013Q?b@U=GVlvvard0TjRjJbpGbH77g(5q~2)oIpGtyCPpvbwWj_m z*bs0aF5n#Lj3_vgToD50cWj3bho_>)HUUaNV^;9V$dvxv=?|0Gwol`RzNw|xc>$;h zfr6@`nhC@XJ_G~=CpRFZvV=Yzx;p_TBVF)4ia=dPn~n`E)#VZ$bRdF>#zRgQUTVtB z#N&!UE(!P~MG%5OJnKjbe^wGp4d|>+s8~}f3PfzmIEJnOvXT`Vnm^BT0bOTjq=vV4 zCn#Ay_U{Zpd!|e(auO~t_5Kjb)03UmPpXg+*kDaHpjxYxQt|)Vz~Vp&S|txg%1~!v zBn8)Y&=oAP%q+VoAt=InO9YImjG`SbdlG# zObyccR`0ATb9y!*K!Zri29-GTmI}B@Y5B;GzWX>MpF?}JIeT8d{)_pVVoYeQBhMdz zYK5{y=y=miE!_`m5Os6!4MmKch7S`vX1gzC(@jBmfttNuxh-UuO#7pfe3PIddi|}y z)oUSpmS+-uleKJ11MeZA+VliU#tTgJVuPO5I5-b?oF_5)_8D@XSnwN#;d5&kTzmD3 zQa$7rRcbZNmKzLgwYV0CbRlpK+~8&>mfNYfqI`wgvvReA(hsTKfv-OV&?~7v-el6NZa(A?v(f0<_`rR9l)w4zE-3id&jx zE>1a3$IZ#ByE^|y37)MkT`ZG8(Yu><%P=Oa(l*_9&}3ve3z3C zi%-nuMaK2x;_KFAPqjP`ZZy7xr_2XC2Yrn%>6uYr;cFqNRK`A);Z~GsXsh*o#YEb* z?3dUoKdWdKN%b?L*D3D|90M-)OGjvtcHXbp$2my6v(rj_S+Jw}_T;MFLS8{UzKY8O zAiF+TGi!a?eqra;HSCb2ua5i`6cjIh_SN2_>pJPe!ciQ$tEU=je{M5kg;B`;7U&n% z*rY^1Jv3+MICR>CwZl@_Gh_P(W9x2(|DBGj)@3}ebt4|be6e|Y)Mj@r$O25z>QpDEg>Rlay<+FI$v!vN>p%2j8yGUtVmxKr~T}O!-t|5E(b9inJVn*>VWbEfsl{SI?(1Q zc_K&yLW%J5as~`rUMKCf-56hMN6aod1(phllfs`E`|=tHPfKkoP*+G zam7Ui6*t-k&}wWj(BU%_q3|+#uLoB+8xGdDrAwDe8kcyn$1<*x(Bz8074~3Cr+X9r z>ObXxgUl8C;)J*C$&<*X7P*ol=S{qOIdQJ>(dZ(?c=LENTX1$yKV=NhslJUpDgNFt`~Fdc5BSnHNpk8V;@_qV3HM>)JrgE5g9*Jp$#?@o+E{AmpW{kR#=>#)@>w7dP!eNR{r;rZ z`n}}R6t3|IbWeCBeQ&GQj7r@u|3omEFf$T%R|l$R3bT9DZpTIQ6Xuj%h@6C~i%yAg zw@CwM%5WoP0Z%(+30I_nY;_s}<3 zz6%L1oFWWM1|x$sLkvO1ca(%YN-JACSB(Z^9Ft$tn6`vAwzvEe6@|0+6~)>%@JOKQ z?BzF?qxmC#^i+lhevf8O*lE~zoL1(`Mk1~&(JF<6qhm%Vs40f|#v|LVt z1NaH0*K2&0q1}$!LSzFR>C0Oo-mPsGCDN)mhC zG57q;LN)X>7eU5{;!C0MK`VL85LrIud`SnWAMON7#qbq_hk#Vqoz!~?UwR?!3Ak3q z+SMS{P#2LPVNcolQ0J><{w$kJ$ZL_o*jA|oKHl2e3e`Fy?#bz;(oj+opAeb_aff~w zQ`z=9Mmw2SmI&-1Igb^M0JR7mN(WP$mj7Fg^u3EoBDetqAVh6(1XF|Tjk7DST(0&uf)n#i#^jEptx%wqKB~@gjN8C$QB_hD zl@l&aaoR1K=|FT{HUc_&JJR`Za+7WMS2m1w6Q0?^{9vSpN+Fk6C1{|3MvMX~h%)#;DUMg$@9@Cu6~O;8jZ+^atECO1F_)|QPovfCCzu>t2CJ!O zl(>{m8GL)pG);efYC!y5P(^(>0m@PIP_$LQ3>l_SYG2IWQdFWDHZDvv#y;f08Mn|;Q;lO2Kpj29)cvrG+WKzx1qGJWOzMDqjw|>RL1#E z3ddsn4Jh#l*2~2=OLHJNdc>^TcDTfmlNVnqEmf9bf-x}Qeh^v)@OOuKzFus@HDQ)`LjFWZ-8`*{M(< z19E0Ot-3~Hy#&B3O|#tz9HuSXJ^B;U4-eU)AmlWj1QOrMR*AA_0+b|-TG&n{#4MDJ zDp(g&4a!A8r7A>7H-o2cewayx0{KRT>ry33CcwCooqQZK{P86^>>4|)BR;fqx{Y)> zQbaV%u?FTy+i~yzk*H^EC@5EF6bb$N40GSuw4mRUvdDyu-|aRjcEdZMwcB1|@s-xq2M z8!Q3%jQVU&AFnK_nKHBF9L+gn*HzBy|77xZ&3jl-0#=0Jg!X?Jah8R z=zSWcADEYYnKktShs5miI;gA6GS{1g7Z;3ITiqV;S`I~ZWoP5~lu1srpFhp{I_-SL zgt=$n9s!%H@8?`Ni?Z>5v}_FU>wzl!-Y}TY_?D^{hBPac;%Yqb%OAl}qB2aA1DgUb z8>D_~^bL@DMwWqzmO00qYPLwH@u=)WDA*mw>zc;m<%Lhy#`|BIA~?I0H$*g7X)JDM z*^jbsmX}+@3Y=^2a#FQ^=RsFgpT=@;taDW^L<*UfXr zz^a?OpZ{dhFdN zU8*sN!weFQV?C|ZD2+?5d^wuS6qcnt;9p}&pGuf@yVAXKk@M+_E*TwDLQ6~P!xY%wF_?M=_EpMph8Y;ftnBc^jAv>l9fm*jK9meZi-W;8XRbU6F`A9!4lw~RdRZOlfi#-6Kcf>`%=PZ&%g+1Q2+?i5`(r?n}Gk{!Bt*kz7o`3KQc z%D}X5eshbc=vkFnYToU`^l*kKK)NunDX!IL8lb5sj**&CEk-X0%|$ty?;77jRJN&; z96=-+YHigD%D=pL=GuU)nO>!DTeYH<(wy%mIVu`$l-VvL-xyu#QL40BYSToPa@!N? zmydJGxqUWd94QUgwz;OvW}IdzmqLYyeHF!6M83@Z60cO|g@`wORLlno?d?vYq0Ifj zx#;%pK~;sa=>d`SxbE<3%lN}o?4(06jJkC!%&+(yuA%bhnZx9y&K)aAzp;_OqzJHJ zX_jl#;F>KVL{8huZ9xI-jl8~D1Hz1n=iwn>$x21GAc>iMaB1mLJHF2&B8brQNzWsx zWXa6`A&MABd>s0#@>UmnU#X~CQf=|{p|HJd4UtkCK99oAwcahGEQ=L4o(;LCYS3)l z*$W1IAkxk7(|#Im+}P$7>)P7!(|_cz3XH@H?;FggGlhzCL1q# zxlq%kJo?k5DSM989H&T6qaA0zqH7wR8HV>S-VMz2Cy=1+#}qm8UBK+0OZHJ>D<`fJh2mcWn@gz96=+$0;d?g{S}2bK;+2bc#Z+J2C`?Khv}Cc z%V{C;3796<$SzWyh#<{P&7Q1H>YA=`{E_Vrszn-gud}d5OuU)yy**mvtmhCENQ~X7 z{=6@9n`bfOTZ7^c$lJ+bRwbx&6+KBx%%_z%PZbVXPX1(Pwgr%{+4HfYKYb;FDF%LrP-_s zT#)?O#pkocLR@c3X;>BMX^jL;=w%d7Y4I@b0w{T}R_)5^Q*;;$oUP zmiOL%yE%92LwvB`XCOzP#xWOaqk^t5oF}bt*OafOBwlY)ulyDG!u@yEpgRp?UlkMp zpbznXbi_E@SUOq#bCLd!*V#G?(vQ~}+f9TaUQ-8*7yXfL-y9I&nzgEbCrFUsAI1J) z0?>H-^Iu=roSkC%RGd!1j-@zM3LLE26C)0aWNQ76kd>8%417uP5;5Ul^J{d~q6Kop zVN15uZd!8<;a<8rX{j*)HJK>2&NEKsLEjx4tLAsQ<6r7mjEC4iF}BDz&a5)_7H!BiQx&MI>3*N>5=n5$?v;gOVp+ms!{5Zj1;glQ&oGHINZNKv;mRO=6oW@2WuU>eu~IcK%*3TBvcg}t3}%)%dVJ3=@)mPO??QlWOZu0wifec30wzcA-|Ifb ztQT8CQ27E1(KAOFXb*T#?EG`z9fkztD9Nqpr=@d#s`S?t;n=_v6cwm>yh1y)M6ef} zHHO#gJ+gLxb}yrAIiCc`9!CK`tMJ7gWD`TDQ@>pac1Y$9Qci1n^v>K}LP`){u(fBv zR?j~XDV_v$8R|YbMprY=#OGby&b#sC0gh7R-Lmil=>S!qcc{>AWSlRzA&OJlSff1* z&@I{EhEo?s?u;)cOg^10J z-#)THjM;fIF3GgBm8Z07!De$=|&W*wW~Y7`6{YAqQFC5&GHJu5Zq^FNT= z_wV2J?lRHr%}k^yh;V71;s{MiMisnnbK!-D=7A}_8~&am?o~A5NSW6H}45 z&)Bm*Y!-55y)~HLM%<4P>96YUW9N^-86s(B7uM6+~blqX6Ic z4!#xPp+&EP`u#u*7?*6790<0e=n?52=3IC(v;!qA=g|?zx_vIv{^=GMdUb_^|4wh( ztpOl+c~XA(lzNEQMGUTFgk38%_2(i?vPxls75x+HUr3Az6fQSL*U8HGGeIf#b1?oj zNoinX?P%ocNUNh`W^LxEqw|Bu3d&*=;*-)%weq7Aw2}uBl;bl>fB#I+P>NTP$&F4@ zkJ3`e*#_I@#fO2WnIc33W^4Yp_9=AE8e4)N(8ovrxAv+3{Hp)!aCxb^`A`47&$CY7 zDKUdF*)NBoND^5_m=Gkzc$>pP;%$Ct65Ox!q8MoQ9K15 z;z>uyAL5k!Utjkvp>FYVW}o;LAG(A zX~jFXI5;~8XU~w1CixO7tZNaS3!Md)@bo=^Z?89$jO9nezNboD;6lVr-X^k&$6l%?xMe zboz?BnP-<8c!P*H@_szkNua53L$%*uaeB<%RR#VgCE&;zC>MrLba0#1nR|^L02g>sBU7)2RH=-*hf^F@LS>G4o!U;KEmWNbFSZ}AB`LZCSzs$m=>E897 zc-|M!k)s%)kZ`KkYiS^IQVT(XFd6Rj2<)MA&h2$pc#IO@h?;!;6i!2j#VZ<4cnQJ{qh|%D8#A0k=EqrH%RwbX zdmRJ;Bzgg`avb(M$4?WQaD1e%chiG?E95<)S*IK8+<}=&DAQa2n;*$uh!)qCBeH9J zdAbF~u?cDhpDljiSF8R8pWy_a#(q18`(^5{vjX*c%xan!4C~^cOm{%!6L$UH>+@er ztW9M@V>GQs-*20rGQBzes^@!5%>SHeKi0&pA#skodUVAlzMRH%` zaW_q9OuFY^OALwL(AsJ6q-Z&nX<&Y9pIWX&Vm*)=nc+DA_b9%vVL;LsTl5rPbz@vN zB_NqQod3e_O)FdllJ9r#CLjO+BX9r!wEv0UKj3O?X7YpHT}l(t^K?j?$COkJrUU{g z;BXk^5kK}@6da79&P-z9!g+QWuw~e*G>qW4*P1=)CT^CaBw=1NZO>Rb>kofz^Wahd zn{;5~8Nam->&s75@W?=UbN#Qo5&Skb~dRFRqLq>DM>3yEQC501^}iB-)=-k4Dt>7)|F*I_z_p+sbvl zQ<)FRKUU1h}h4AutKJ%FaUvq zbteBw>@WN2-e(aM?YXDT`uMLn5r7E*qlShkVm6Ih8xCCbEBdfmIE3Xc!xLUxoX z^e@J|M^Oy)lBYqWW^~(04Eh4=pM+qvHXH=)X9H5fDjMA6db?o|57ro$=^cMyhz^gq zga|FTlE!jd+P~SjEew)Vse;8$wj7MY#!XtA2Wxr@=s5Q)H`?|`gI8wa%agCY>dyhy zW>jUc-@P7k(bdI17@lWo6c#c;j&3VEK?Q8N}qL`{_4 zt_L$DULRDVz-nRL;4+j9?r-b-V(}(}8AO7R>C)bHeqEtii_Cwz^2KP=+?Wp6qIkA7i_P6dfv;fou|5h`OweP`~U%@ zzjv3v7aVt@j!O6}+(Lc)!bRFjI=N)Elh%X1AlSk`1YBkJph_ze?(%S7_3KL4&9R#F zCqVsV;)!?>qyTVG_AZmJ#MD@{1|}G=%{nH;Rj_+2xhrr_M%9Kqn%gfqU4t4IRo1LR zx=&xoazM$Cf#+(x%huwI|2V8%h%Gzt`<&|5mZOu?KglF$0KnG*pUX@oTPIB7<;H@} z;ZgFBbN_YTkpTwEb)@mFLIqffp~;nl&*jP4WPFh7>WIk%r-eoK@ohL**06W*y1$y~ zNr2-9+Q%Fh+fhG<47GLCbh2yv}0Aup>OMyrGAhN;dOE9v%~_XX=c9{NBm_!w;$Z=?LtraiX#5ofVgt#c9(&Du{JP1(33&5qhNL4_DuHb*O} zi%-c(*NcyEG7mg1p0vJK@B;*gfC1drKMGR>BwqgDr;o-W-N-ChkB{0y^b(uk$%+Lk z7RM?iYu!D%_W-)&cnUusWRT+tKE|5NW1li6E;FEkga82%B+a;?VF8AatJfd9w%P?u z@;rHENJInb!E!C@6;B1Wq0v-?-81RZCfrMCjEIj>kP0K*fm;f*vqKCs&>oLg3)%0> zE-L1#%^r|P*kul|00u-H`(f@hWMN|WrKETg4Qi9}PJq}~*aengQAl4Y zB}d9ClMZ8@x!L1x%=j&7D#}l!Gq8$b7^$gPK`kn~eS*nVaf8~-fE?Q+bo2ZsY#)5|3oR!7=3L^PHxVT{dXz46evrC1&9 za2}~}|DN^_kVOVWk8m2Hj<;MIxzgpu&^nz3k=?%MvlIdRv!U)h_AO9{q@`sG>N$iXpSTmb6z5SK?%Xn z8M$qenl-S&_qUbFE6}Oh^f#^s-6NLDY0xq~sPkXDLJOmY%+YN=d&FH5&YIK-v%q>Ns>Vqe6NYWS z>yqd*%yX1TIa}c2fF`Hk-76TGKNiE@AVghIy&K@iXlD)c;JJW-{^qSIu%VH{0n;Pf zx74Mk9uc`o>JNFTa50c^mzAEa@9V{qH~y_k&GOYrVjprem@BD&9FlwOF_u|Zp3$TI zK&rrC0-#pBc_E<4Rb5KG@>g1d7U70Wt0V_@(*&Xfp)BRpKqK)M;j?kSqY~-dL&zchjI&IVKqC7{( zHjVIjKglG2981(3JFT+KK~TQ$yB3PMfNU3^yM~s5wbgel}J%z79D)1>1`EqfDSSHZo zHa0nWLN#IMH}Mor;TeYHz7Pu21l;q*#D&%OpuZ{mP-4qEV?=7v&Uu!!!`56wryu7` zn&H_ASH>s}J5!YrexxDDfEq@gNxqW&oSYeAFJcd3Sd?9J&f^xG#uXG)UTQwacBd|x zm(hr!`&Qc;PV)lWsqj+pV(gnR6RAZ7jJ-$<9;f@R5jiaVUh`r@ULM2sWYIkv*$&YY zEHPrYk1q#@h!i!nz*lw*>Uvr5PIc1{k^j}T$cw+~QJp|HPi zVeLW5sii^7DafU%DJCSPg-h>XMdTB7G~=?=(=y{y(?Vq7uTD)Y17#Jm)4=Mbv!MQ4 zm>imVVxWKk0Ng)?I@bRlrjfn9jr~6{dd2Ze575C0Kl2QgVv@>_Vc^#Z;MJY_dUfF@`F0L=gW=W}qhvH$1N zpi6nv27?{W=eQ=d02Ycu?Qj=IT8v8(zAa*b5ZE)OU<@pCG)aK9RB+~>e8qO zud(F4mhWyY`*zaih!v-9mBI?JDY=}qf5fEVz|K1SP?<7%_`y9*88b9*V^;!WqL4Yu zNxta8uCA7VH7QWUn4Z54QGEKnY`nJ2y`M zmpDOTtvCZ+stF<9AC+_~k-x3_36J+Q1>aJssg9I_KLqtq+R4ZW?*y(gsn zVi6n$SbgOZ8&TBMlwJ6Mfy9jd0r|wnp!h(I`-_lm7=9uZpjW0_^1X%v01_TvKP{6-$>?U-k0{a-~_c+7R+$g)zo z)wY8+8xXjV%%gC1zTapdb*R#LlovoPjrr--d@2w2`U(Q4<~!_aOXM=^upF)Xsy_?8 zz7oP6u9+&!)+S*Ghs@IPMqG|BmS*&Y1gLEMD~o_AA2R5yQbgf^22-;r)L}@T(e}U{5@+h)`=xIHWlCg(}j?4HcRW#!6>djEE&SG!SDc z6%qK45s{IZ@p6&63Bm`H-#MCflJ$x0!Y%4eiX0zuq^fuvgmfTes4Nc{^$Pe#219|( z*~@fdm(#432zl=Vy*t4@@w)B<1PNj&!OZvm5g`J>Q>&97s|gL~)GJjwIUdW6Q%f_P z){_(qR=&e3ZvJ@yJanb_u7yzq3L%ARA7jhj#tGbz$rEVuWR_3y1fW1PLZ8PbgPff< z+;0>1U43DjzUI<;25J@!#+4Q(xRtA;lGk@r&xbs(T*$@Nr>ctn5erRsO)H$>8u<#4 zMnUQr(zptiE;+xAbKey6zYEweI=P=V<5FPI*ER)nihKt`vN3`q-_MOW@(fn_e9`+k zLAe`2n@%4No}Va+N4RIQ1llv%^J~Y|Bnh71f1?g#ka@QAu^yB9sFFPsn)9_eiy<)? zRyNhD<`T}gUhk*obKgali`75pqNR$ut_HVU#F}}heix}PI*RMOO zAU;L2{N-1_C+*fRi1snR3wZ-+bJD91e>Qk0#)rkY?xBKppJiHTj6+@H>L^H&N7dQ5 zX)Qh`xN>ylO!Gv_;F+e$Ih=ZS+}bozTWeZst%2w0^lj|$J|2f{?ND=%9*lh&#QJ}I z{lx`cAbB5n#_n5Dy%ZJ|UHNY2CB78Me)l(j3te!S(8jjnS6I3A+($$e&YShcuW)(s--KK29-+{|yrJN+?BR%b zECD)Lw`AFO8#w=c30ds-iT6q6nbOK>58UM-L-%sa&11j@*e%p3DPLH3uEYmpxVt{J zd6|OiVt*Ja5x{uEW*hjf{P!A_X_N@N>RO4325V;%Wt?y|26sHn`VD9pf8~3&OI{1r zA>;vUFxGOk*1(Z6xY;y^obA0qa&SUtz9Z3itVDt135k*%yWr$}EI^H$)^=?ht>Vs7 zV3jY;Fy#>w&tphHHJ2oELs|eey&mIy&jP2h9w#j;F4H%0oLEZowMuO3Dxu zj5vYK4i=YuaL)PFxCJRrGI@)Tr+@Y)Tmv;4k3Wgu{0Qe!{|MUD84Z+IB(CFW*7vTRw;s5At8~U7e z@;`4r{`d#|7oF`tUi`l@+dt{iq`3a0v%z`Is6@WSJ2o8vQ}8Kj@FnR6k=ZC6x+jR! zXROSwXsPCXx(qwdHEt$LXnq{H((sr}+fgvU9JE;?mliW0=)ReGD^M=blnF%sO{Yd) z8R1PwIJan}cZv#95Fr(pUzk(pnM+zT#Mk2z_gyw+N*92icGwDGRDwLkD(k2cbOk;2 zOeVpX)dv-TYbFvhuB&b*@rG}wHY*jO^?4Jc5o%Qc-!faxg_A)PGnn+@EvgZ%JI_d# zj5xq?ad~-3`^wuYXqa%E)sL%AKBX=xsQ@IZ6{pE?sO&5nFxUbb`KXRa#4w~m^m%eQ4DlPyIXShLIJcMG2o81cMIWqkcviTkfc=t;ygw+^4d&P{f zQxxp34YWA&@h?D!NUWOZzBnsM>daFXq8PT4vBy@Jum#O`KgUPby>*m_Npm~bDOZaH zY!N@y8e1>!c>4$L${K6T(Wzl09&_OM#1aqE`wEMMhWA4C^Az5;t89xg#_?sV&o$We z#jvh}YN^O#{0HX)^b+==w{(+MjoUVpd`eG~K#_TfAwH$juIjij+7MKQ#E*{@ND-^9 z`ZwIAa6}-3LLX?w%J*H$8!)?-$Jv-@<58Mb@PkHhL8V32=ys)7Uj z4#8LGGPyEXrvw0yFaI~B`d1!0>X}&^{hvzm(96PQT_pa* zcT!W7Y9t#EAtm>j$zZTnmPuBs3qDpWMv+oKa4OUpu}EUFN-HDPH0Fq!Q0(D$^YBhD zqOf`B09CZw>!g32$?jou`@XYxcD8q8;QT!NJl8QnJ^sGaOi@u%QY^lC5eLbcC$QOL zQdxBHWDlDT9|C*1wab$Lu|mkI+1Ge%H`PY6%9bpRenqCHKxQ>xIyy6eFpwL&81T~E zTw**s8>_x*b0bSSeM!l;&RsWhuh40cN>5vMDKF1EUbQMX@CwIEeFll`EK}5KTogEU zDfv~BaH14fdNGzj8bMWkZk=i1-t8eoxVpL;ri~K87D1sTVBoufW+6Jn5Uv+oD6P2h z@q0?TfDsgyA!&!wx2LN0fx|oZ=*FQS-?dKG38pArNvW}g@}(lb;BJ@9I{nNv`g`df z{JW6Vs-QSj7Bpy&WE>7{KABuz)UGIBxKp+4z(>RihOA$DS3Fs6!eX&9`Y35UoGndM zN-zDTMOg_J1YpK8anKwFk2WGan`W)tUry9WDY4vKUTL6m*edI&r5FbGp}1F1*&Kol zIJ6ie<>5J}h+ITGKUrvLU)|_WU%M6tZwdfdGJhqaB*yi;?yV!bo`C|8v3o`O?FsV& z&ZUSM_MtHF$)wUUqBq5ly`{BM#~#JON+)8{dO7a{NUof3fWFR8Zg3XG7bN)iZ z+o7qc@pkcjM~;AUd3Af-E>Z`hLO7#5%cG`*qK=wYS{-McLw zvD*f`ditMa%q)%|p?!Mtw6ZDa;%lEWr)$XjwGR=P zUJ=w-22Up6rsq)03E%~hBEoUL(iepKXy4X$i=ciF1bzeO*l~V-3gbDp;i9DZKDoSV4SR+ z>jtgF-}C%ySBkDa0Jlvb-m-blByKpR19&QkSWv!$F!vmw6oViK9>8Rvfk7)&ia~hm zy0rKf8ay^}oWb96(dGcavMM`}B(+qY^gG;%pAWu)$iS$Xu2N&Yp}iiu>{gkydY_ER z(XVgizi4JTP-M`b+d@YUj7otb1pXTw7|K;=?Y?=}XG*&8Thefgvl7eyHP zm|JSZS6}!lv(+su(@B;X&S?kKqI#KQG@@wdVaL^NHh^{@2HAjVq5+aK%j?02ysf=y z2huxbQkNQ2pC%3uHA;WaX>M9-qSvkuTHxUr*UzTusj#un0iepmNW>X1cV*30?#=l@ zJkm*D19Y&hx<4J?Yo+L4bGm!MO73ZI-sGAO(AK`cWdFL`_NBNW$0djsuG20_r{MD; zJ3~V08=!~OsvX|bcx?{Sl`caU^}jo(t>;pD zp=@R4yUl@&(#tPLn214DNX<`AXkMW{TMi#(1i^*j+#m@75>>TIw{};gMw>E;PQ5uz zCXwaqm=}uqPI>6&4Mi*~7o!`$)}&0@74M_XETx8fc`aDyPNDew<}yIKh!0nz)GK$$ z%bUJ}&j6SjGlwfmQVQ(HaYMmP ziAJ{8b4DXJ$nS@8Lq{v>6Cy1dR`IZ7wy(aUkblJ1*x|9rSWn%agxg zXmsPLkji4r>4Bs8TDSCJ7)LdJ7OEk}RkY)pd4CX0n;V8s1$aIlH&)JZ_HI^5IGQ!u zVa4!KiR5cnJ{Z9B1h45;S3y;L&{TzErR3G>C-x;Y#_NQsx8Szj^hWkrxP^z+5jcp8 z!#NaMM(}622a6MS%POt)#sh{3{VvrqGKgleAkA8!%|x^e`F^DAIPd5Q)= zL0M!GACh)TjA&7jxwpM!a-l$U_Gt1$Xm3YP@5Io(ms6`?A%CKw{nl^dd(?s$`71$M zw$HSv~!mk8CTfPSFy>nQ8En^ za8`zc`hnPnWN8>a356NgAGoceWw<@QN>mQD+YGMS6N6&4iDUsQdBU;UQ^QvtBO6nU zUAeW=(e&4qw8`{!P(JO}PLh_Y3p_aq3<#*33QjCBX7vkj(6Q0ocKh4p$mn%DcI z)qy)l6fntx=i6}n5=)p<^`XJ4rZ>hGND9Sjul+UGx`aKQ1;nUjMMEdm42(2wBWyrIyW2@u(b= z^nG`huuryN8TcRcTM!lW`n;S_h$uuf2Wz|1%FF=E;&ek|H2y#K*-ydz<^2D;`C-T?ipn=*(Co1+m6X+fgt94y$xr!O%&yx^hRWg^I_{`Zu&6(@Yf&*WnhjbNMlJxGa z+4iri&^t?%fV9Xx^E!#^1!J@6UgD3G$5m&qf>9n3D0Nwgji)1gc{2W52p8yzw<0e!1unF1AFZV`>$IMtt`D z4yFN}Q4qz-Pns>E4%}~-|I=WUsxr?X5*CD~VKE6Gc_8x<&f2cb{{Z-+I)Q?7KsG(X zRI%z+7Urn8@d52_Q0~zvTcmjLY>gw}&Bw1D%w$;1%ES~#3pm>1Abr8Ai(-umA2hO@ zNZVz9y{GsP2mB{-Wh)F>CDhl-GbpCdoh0(}N!e`F%n4qFXm3i1fM#T={pW#iY}Eu`zdw(f*P@1D8-$(FI~EPdifNOdnrix zS2>qO44&N74(CH>*Y4&`uo4 z@@PI_fcFv`=K>o`8|TaRVKYW_``he#XQUti*plwgJ#2~{sILC(tO+hmt+p9IfkrQX zy8~mE^zDqjMEORl#M^+Nvf6@q=Q}Y~(+qW34Z?tDVOum0He*_A#oXQmuI?q2VDKvs3(WH6>n6#k{2Ph7|Y%pm`nzF=M;wgNk#%SJB zb&R;R2^N!#U})xOYX;M;=1UDod|ZPG7LfOitd1dku_bh}3u;O(^qF&7_5cw>0DR5t zE;k>DpEZo51(P<#SNAU0IC89p6y_&rA&UYXez~78E3kBpPOI2!T9x4*=dVjBdyPF} zTcdq7s{$Nlcm-Zc9~8D$DBawE$4(gBCJ{i>$e~9qnqAwmWc!sUV3oXf$!%hVU|mMp zw0wbnQHr~{9dd9up~Y=tSerlz6ND9o%LTubl0etM6*OI2NtbC_j69P2UZB2K*!{OA@rRrM63pp7ImsPSuHTn^nlLXP{6G2XsH0Tc)l1p{El<>sDK!-8T$ zze}pqVJcUc2DQ6&idR$TF*JVu15f#p!;IA~P0sLih5kq}G*j~@N)hodBaK&WC~;Uk zBw1h_%<*kJO>uAQOEEXV2M?tlaGhd;P93UbNuGUnS3c0PQ1T%ppvJI|DRM%bL|3;5 zE=>NUi@{vYVzAex7X?GX=GaIWo&v26lDBgK;aB06S_!Z^T2ymrFq^FmT4%QD{I{G7 z@-2OG5KO!I^CjnV`*I4cusbuYFlpF;KDQ#jH~kvLDY{>D)P=Z2co0`!B9Y#da;O-i zCMRuK7&ax)k8dH|f}jx)+akHrQ%he6A;Q&Brtj1@?`>wN56(r}`UvpT;mioplj!*G zB#K%pjDaQy&6ERHND$%tLrmK2$(rHAHY%GjKKpzAzRfSXj4M31zt}t!sJvASxA2qg zt`C(3xN_jT67>}J>+tO>e#Hqz+vAlnM&2%q9HG$1rki}%wv$Wb`@qx5RYBi&W-l*b zCYIDu)lN6=dZC6NU`YtnswZ>mj8_*70K-hFQ1h)ea11VY>u%9@n=W}cNPCwQmleu7 z@cLSt+vW{R!^rL=Y~y zOa>O8%0`P~lYr-2o0}?{-36D(1zg^~9MbQY#IZHX!*y3PKK1XHo-48v_2bX8Jk6m? zh!10NzlGX9f!^ltG(0W`;%p)u1;-B9Yh*{P{qW-?WP#{mA<|(bX31a{HjIrS9?Y+_ zBJG!g>LB|@qwPt|$&!}IrmAG=e@~$s74$D}AAKC3&=5}JB7i4@s z3FG{8&Jf`SXbRY+@b*d9D-~|RJrEsP;z;v>cHrYGEj`F=s(~e|E@X7vfZKwrrRFoS zT9wKM%7J#i%%!qkTt3x;VYuZGhaWNNgF2DOEx$}OpKRLifi=`!QXdzV>fE*Qj?}UG z;FaJd7O~nzIQJd+^nCIm#Z;~MD{4y*2^?hw6kUk<{~_xfctmNyB|Wxn+qP}nwr9@R zwr$%uW81cE+k3uble?Sy7dm-6)m>Fjy+V=jBJ3&X^YL(SIBaMqUstQBYLRrbq)~!F zXZQHv=k&CNkCcJpffnB4TxnUN>KYKZWK~$PA9(6H|E{1}WWO)0lxMDLbVpLduw28NQcR89h?elG>%y~NFcD0nkwn&*xP zP8z*w1V*GZ{V=cmfE6Xh6TIr1g+Xm%TEdRil<`WMF=nIB;NG< zys4_DaiJJ5JgluZm0&{TL^))cmlguj6++|+K)@=c#^r6A##uh8Jum{tu>PFMPeh~* z5Z59MqCnH&0f0Z86Yeh;%2BPF#;qgCAaUs|71(S?%(Q)dgd?&QhR*n=95L@!la#Xi z$gvL)wDN-SpIN_kBkhd&cN z!<{uYr|QN2loJrDNPP+eVU27;@-3iG)T)lOC=pl@m_4I8f0x{ju6FzVsCz#fU+KSh z0R>w|<;DxV1Y3ltelhf15QTn7+ZfCyZLbv9Kk_5NzaJ12f;1SJW6y!_1Qokw0YMp- zWe^ElJV#ML@O)0zk72u3{s-iuwB>?8mmD{>VSgSK4C<$v0R4BgE10MP|H2YJe4Ea{D|EGNZ-~lyZY^qirp;BfEfd>ERX_g zx}GnNXXCHH;_)7-Xdf$B7>k^4Ol<)b19BIBY(Rs!TdWybk+ro&tCxo%@aH})YJGgY z>T#9hM!mPk*ZJ>Z3>vp=W#QGUXXvcZc1MeSRUs{4s|hNKlrONhMM>PDX;yeKg!&mP zkk)FU#baN9$fPHrrPAT<0uSYlb)(qLhpfL-n}RO!ZF?n83liHOO0RlNc*nT2kp*4K z`-BPm_c1CmA4RD?A)T_QN`_I4?^K+Y=M+_xtbx!mee(F?5xK=e{^o!qI1t~sa#+~% z9fA!rucdwC{(psVl;l+_W$TWyl@q)=H?KdvD)+G?kMI3EZu=k@;7P*thoTak<}J+N zoUpkCl|7#px;bMqL34k`|N6A(6p}y;f(q#O`u#z2gb;%_?WR!Oa_yc2oT_!6g!H4y zpnfq}CwX}CBGsds?6G3T=~Bh@7|RC2WM$tkL_~)z|H*Fdf8B(AifpKC%4%E*4(%m& zdNAq5Db{K5yloWMqEYSE+g^iOV+ehXa+?F>8Syo!!w9CP4fO9HVT4e1h(GGHjY|x2 zW`|#7FSohu16#e>m)?h!|8<@yM6H3!2h^?QAO6`O=3R!zU}HwrsP-Gt%tU>M>GX6R z;$Q4yw&`Q;7B`#%_ds5n#lh6|^Q@SA0lfR>iikU#9OZsf+djm^uDS9IVn_5fXs&vT zr2!kqBTi=)wc;V@E84gK*Xofz?9(BN+P5j_U;z>q#O+z!>>Dr?^}5ut404Qtv!vdn zl=t%$Te*-eVg8e~7FAB3OyuGzHW%?HG*md^=p&jAe$WRH8xOoi+`Nun#QF7dCbAK- zsXQ2#mEtOuEDXl%Nd}3}2eQPcVOX1GW=YgFjB66nmt6;Tg zBz^^FVu!|tc!EV9o1Ix=W;PJ6AB3{m9bY|Sc7ubX6itzm?(zm_{?eHZMSC2^F3zA$ z@?4|8LYvOa+6ivIvMsh@<9$<^>D?BWe$Ln?t7>*SNQ_p^BLTIQM7BlE1R|Ur#rT}< zIge8-L8UHh(a(Wyk5|q24=m3#+|^;8Yk42xguco?f+)S`%My=QWCpJ*?#!NjYBK{= zPLtXr!NafWWuu3IsW(OGZP~@~TD-QS`OQq8mnuJZ=T!gQc2ovuM;9CPR|gz>}7d z0#KRlM9|=Jw%83E+Cc`~d`bF6Q2N(lsuxaviWCbqE{-( zy~b%(dd;jUDfJccULX(N;d~d~SER_&Y1a{}(*Ohf5N<=Kx`Vj$4p2}l*%jJ+uu~2m zf=g~~GD@s2SH@5Nz1CIMzgz@3k5{xE&7n$bsE+K=ri*8&9RVo-A}uz|{@`T1=E^X* zixT;uTp_%1=+u52jLyLn4ny_lL$UPmbMZV{+U_C15Za_RhzCmM$uRC7FI2}N8ZqvF z$4-XWIQ=s$aZ9fhuD_8rlRcL?$D1Nh>k~CD)Vu4+rxQpU6bMEE9_mBeL9fp!r`(^= zAuUp@RLYUTOX%}*Gt%7JElDY#RWbu8xn~)(09`^#6?BdQuB9@`GfHNkp1B=&&X}5W zBG|)F?wIg4W3a~Q#h-BBwchar9FUO>cJXQDqTz;Kh9<)Vt#YUX7g*@B6XIWCJv4mD9(uh7-8wRAf?9V zsL1x0$w1Mm3uKhjl0UE&^9qHQivVT70yrmv(2(McxS-CF#TBc~&wlGF1`$T>sYQdx z&CPwEPo}A3QOm#BE;Iavu)f{t%w&OJWxNy*x=f{CUQ?GEE z)lZtja>pNf$fOiV#p{+WV!wZ79EwfRpO^VIuxno=S7)=V<;O?hHJh}bOj0DoXV~FU zD%YsnZ8)h!$|^?^lfl+Oqm-Vl&+ll-Z|D`;rNA6c1p~bXz@H7g|IpHsrb5g+^FeILHc&8;WYX!W@|VCWcOtSzF?k!!la;jB7wEB=I$RUM zi9BPD09E6@U=j7&#~|0yPK_3FQYy9e2m!QGMu(Dy2X%cZDbNlq4~g!i63edSvQmPd@)eF^%X5A-5_6|R{g7iL96u=u0_s5BY%lqNr_5a0< zB}434!wuHVx;D`Q+{4Rn9$U#*DCOV?;?R#Y%#hesHdt@Oi!!qYQ4f>v{q#lh`5ol{ zasPgw|IE5-@YEI^**%o^joipn6jH+%J!J&Fm}|k6Q@)1Hw_^qF_an2B*YcjUU+dIu zs$?ixutWj9I-4Nj^qRp;fBl>G4p;RNg`0Wty4Mz`alasUF)_9ZXThhFwfK8e=2?=QHg%L{oJjmVQfn$P)Ay<~OG4^Q{1m zKKfk;MMwtt)j{fGYRkzrKbgkJb>(nltV5yY@P{4W{JlbT{vfnSa8rvN$_e>A2tw5N z&89PNA^0rF4-Iu^T%L{R!s63VsBXEiX5qx}&7su%V^v$-fcd}}0Y(um2|x0zPEYU5 z_%VWSGLkO0SLX4>7(RJf%V~?V@)MLV@aEmcu7%B!BaGi`2QazNMJ%gO54o30)hRXa zaW$O^eV1~I7C1V-Hm1;Est06cl8IzJq_bLDcY=`2=^DZVM~CI@p2^D#ccUU=09Pru zkblmw9_Axpwt7gL>kut8=Z|Hpgm>!R;q+;>rxx9eAD^EOW_o7fK-En6%u@mwe-zT* zWLx;rU0pLPlM$?*c^}qLHfLgV)R752UU75c_T^-$`9Dg{{XUvTK zW1-RfhHWQgsGnUHk6s*KKG3`a^XA@}tnW@D zFDZ|&P+b+-e&GqKa8B{wPmhJtamEds@2Z2l$Mq01FEgJqcWEj8HJvxT9ZvGU`bV{l zCM}1l;P9`81(W^#FfO@q@Gl4FU+v@SUY0p^5ls#foK5!5{URcV?_c~c$15p5oa%4g zbWR$yx-gA-TDl`K!X|y$rR0FN<6QW!T9-3Jvc8LbT7jo)bFx`4hfUKZVB26JZrFFz zoT^VhUou|5k<1Lb2Co>jE4SozpXA9-VW5Aw8G?-`~f>YGXdRmIUiNO*+Qbw-z4>6r1j{@qDS>b1Oto zZMn0;La;skE;Z>mP!-LDlXZ{^fcLr^Zm}nDWxL;VVbL;A% zcQAA0%A4=I(&Q;Mn%P*x7r{@MEZXK>u_iAJZ7iCB^KFO8p~3J+2eS+3Q{m)_H`8vh z8Np!JGX+^gI0=PAvM=jmen@;m^5NM=%$#%19r)^QEIYo@I;}a#3aW!B>eWMZ)w^I` zHMl?Pwl2j!tBh)19AWWq2F;!=gDD1dt2Qq?VA_ffoowNl#yP_rMmc`zhc{A!T8N>Q!63!A`|9$7Q#Ygk z4a(RFZqE?f!J~fuynTUm4?brOnQcGQhG94L;ZjNz?eJ1=(sgyXxU$CHGMUNL49L)2 z2PU6p73L{(D3%oGBXr`>UkZfkL}3yZ64p(hJME0v&_~ zU<`-wqL6uZrJ(%mLSy)46V8qeZ3?E-X7(hMwd8z5UsroGq%l`?0BuVxXTq-{Ls6!3 zYaUr8E=jf0X$igsc8u!EvAZ+o6mGasZ{uE3f`9I&cLuz~973LaKh>6RI`HE9&U|h} zk{;SV3Eg^8xLdph^{AGA1cXa+~#$+c+k0XYY%SjdG z#Jd+>qj@U?Rn`C^+8X$pqqmvq*gE)NRLNgDl)vhi0KdWuC!5`&NYx_C+Lp?NHyS+IWN)$BEAb1dE@g0 zGJXWWTMyb!SaB`S!tK1q$C?a51|DF}-5JfDfyddt{} z(l(ttTA$|YdiGbmQc-EyL|Ejvx^Ba)%YSA}>8EuOShc7-U@RSNJ^mV|hDVqMNWTQ$ z(Q&lWvzf2wk#BWBlNC>8+d#&B83&&Jjwcv@%+4Kmj&HjF9p3S?ov5#<^Yn*vgwQ%(Klv= zNo)qr&a&xinzPysl;AQ4u8!?GsM_cvY{&NomM{olIKdW*V$MW^jTctm4QPlySc-ud z=`R2SqilpX$=o_;7c0LpNuaw+k@ucW9lPH;44`M-DZ7oax~OM8@l)oIP4r~hbPdGX z$g3r$_T!Wu8!sLg%11e~!t&L75r_-XGxLq&E-4VANEgVv>JX;e2PP~6UPapQswHtL z1xe>FPPf&KH%^T=ekGwa16r&BOxI=zAyvS=T5u&Ns>K0jaSGPAi;v1Cb7fCL;#7x? z#EDe=?u`ZSO=;djzfbFZb2-q>hjQ=0Fxi(NiKctwELf~D#VsUBop{>VdoqiYW!Uwy zpk*j1(*#ZH?mEMrqEd!TCy`ldYozsiJu3Je4FKiMYUK+*$n5|8=+4LuWvyUfy785V z;o3p=;w4o$lh5J!ZtbnP{&TjlOUAb(>5@U5mcc6LZ6OPa3a?eqgIoKxC5pL{Kx@S( zTZEtze(??n5JpDNzL^uI@m_wfF3Kb9>o5f$vb`_BXQVqWezS}7ui0k7yc^y3HJcI4 zAR77RQ40=CCuJ73-IK*n4XddB4&0L`?gO;K?Rk zcj&(Wmv2o-dfhY0#Un^ru$XjJsIoJjorNqSwMF8SNRp18;ZTH~xv z*zT70wBs1nqgP0sq#ctp-d;5t-EgrcMBd1D#t0srl!y4-t~qLD#mAoD!eTJ4Mp{Fv zZ_dY1!`V#HG_DlGP{oQXt3NPf+F-z-BHIc3`=etniCn%1ku^_OdIFrqXE-@Hjsw1f zdmnoPEw9V#*VFam=6(G5alNiLr|a__Xgu(PEfl2G!kLVuS0)zqyI4A6ftRsX_ah;N zdXOhE8});Ill=(%lk8Goji%GrWc5m1?cy}2$nkZkZSg`}_A$TrrTen_H08%G=XQA{uE^x~A5(D!xk;_#iR&X_+|gJ~ESK%YZKBi&Pa+cKQQMqj9zJ`B z)Xc~51om;TxQIcXWHMOOp9?zpyH85kfd3{DOhdji-S06T=&JLWX8!n_)fT=6pTwG< zJ)rKR0FJxGca;uAmn6|+0iI%kUM61QwJ)}w@oG47kztm^V8BRlV|a(h=pUFnVUBw1 z4$qbKuV#XKcBXjDr}n1%v;1b!yw4b&vYABVM0^ErzpPzTcbXd)Z9o8vyZCBGCNp@` zas3;q+&efs#;;#$hIeeSTR6eGUcxhwL3`5flpuX3 z#8k{uBf+hrs0^44xqvHO814PJj$C<&I&2JTVxUmLI4%d^e5D%94vxYoB3yX~e`3{z zTz5P1hox&NJi8m1&waUK4!0s>v~9a);80h`gxDj;)dXqGB0BIuvzoPCa^0994R)b( z2Z8EpXS^|xT>k~?B=x#THfb6`t%p1k3(3Mhro>q?MO_W28+NBl+er33Ck5xy)EGR% zR$Its7hmc@5JDBCB#16%E9+<-5QSrR(kBMvn3T}vc7*8O?-lW2!ZmaZD1SH>fGXi; z41zk@aukHS{LW^rCgLX*=#t?ELScbA7G7Ii6H$^dN|T*0Ew6?zLC zv7fIZtuEq695~3wYNndl4s;hjiT)Bk%uskJjJP7Avgox zAUc1{rQ>S<4I_DzKrg;i*ZKSqr@>#q|H%aZmrc(%I}8N=M^ZER$6!bQmlQU!H?}r) zqW`~{U`ty=bJPE#>DxTk&e-hbFqkxvR?nZ(n;Ax^t5 zjbko<*~G=Gh;}2_Wp0}5XJ>Zxc%)kGg8`UM~i}-rvI>-9s@=p8To&e)k$COsPI+6KW^DV6zt%b|%) zL$^%E&^;b7&>wd&I=*y|H?>njleXF^GMJpAO&qBzqZe~BjN1Ikcopl z$#)X%_LJg&tyJigFEz8fj_scU6U;P;^dK$ZN@68g6o%2jHSMGb3{cSyXAtn1Xri4k zd8V3EcgNP6S*yktse^E2HpkhdorJu(a0hp+_jOPGal(Hyvcs<2AWbc-e7I(Fl(hT(!xGC|uUnw@Vf?H494TLsgn8$ynAuIoemDjc z0rV88yn&il7WeD0Tq^K=HNT7idS`X}Z;O?aiKP|)kM}|wNl&I5fgt{#q624U>puy% z>QS0$-e^F_P2L_%4zz}54w0jY03!7@ni1YJ1F*8F{DZtccyQ0Qkq@x@XW%u{ zmmj@K09xY$LnKWNZd_p+R(hea+|!)U(qEd4bw0XFk%b3zq_*+0ecn&q92m=;O2L-I zoZi%G2_WLPT8ePLF)~DE5zJ@Ut9!YEMj=+iEFCFW7$?fKXM2JM5&|-^Q*;DNoN-0d z^47S9NmYWQV9k1M38`S?Uak>k)2baYg2ps#jDXN&jHK#96g26$KR_adk-00JLkuqV zkWz5p7OfIEMi!_XO2Mr|WQ2Z6=^Q&{YRI`IF~3-D82SF1Jtjp&<$!+40Ggq~fo>xi z0=5{Fyvv=5bb|8&2}@JY^$y^vM6Bhk8f#0)2sDxwC_6O-Mq_Y$7L=-lj)A}k$B%-F zi_fliA%wEqeE@)oy)tm|jXZfpqqxsLSQmUvC}N_XZW*$^Ob-_b6X}$4OBC#EyZng( zv>INh1S*ETUJ1RazdNn(j~%t75OEE%Klh*mJk1_*ld^R8f;3mQ$#U#g28Rjj#-Z0! z@Tpkau=6Am1w_aeFxn(+c1+vZub%N6C_UfAH63Wo7Qp?}xw7@+%)f9SrjPkEpO(r= z{TP34sR5)cXQm5UtpVa%mJLo$^5%9#j^ET{e-*{t{2F~>Zc1M$$?BNg6nJrpmKZ`A zR72)9bo?qK?O6b*7Cn3Y-`xwl)fuOA5*B5Wfa&YN_A&LexZ19HvM3N=2&e0gb_-CZ zy73&{N=CsPs7CCZPN&YouY-QxqZ^eklrcivFxM?^RQ{@Y@<87xE(o{yKs6|Po$jqT z&j6VY2xLJBt7$gi7cdPoxxUeQs%DyiV?dee{fgx!6!BSwWx3(HeH35!s_X7zz!wK~c%`*&pEvq8Z+y0HWow12;eAevnVqwU z1F8nlNpUhPT)cQXY$;UNXA}(63^hoQGNB!by*SazzL+%9OwmPj>vNejwv|k#CdE4t z4x+$rZ!0PX>XD=j{jFTBSrRJud;){#I70RxXQ6cOdtQ-(*Uw0{4bR%C#yM^RU6((Y zq*zOSn6M+rz2)JR^kNU`H}NNb%~Jpi_J*GR^o#p)u>1L;MmM8-$(>|Fs%O22 zqugOL^Ih_2z~|&6apUU%{|dwb*N#%~ucEgh#L2!L%LnY>KbMnX(b_f}5xtuK#sG}P zp6sCirn&op-bfpuvMo$)J6w){(Os^K(bf(77VULa`>yU8nzFuIufoO{(mv0?cuM4X z&7Rd5D-FJTl&eq${W1Zco;-ly_Dm*WYg%NasH;1wQ#SGQi5fJ9;*&}9>C>hWembHg z)-l)jUcquB$zc0mI1q~~-Si)MS43?*D1*@^jLv(V(z=n}Ls>G!DGiQQGpl+T+^jF{ zC_mCM-Ui~>lTT04Et9_0(c+`NNc7j0oFm_>e1X+bVZ3Yc+5&Xb1?UYE-T zWD;9#Zvir&n=dfmQ%=abOo)S`zr4%@@t)%i26RNzK#Qwa69a4|RdE+QBb0=SIVwPI z6jG@GJUEhLCl|OB_qDgEo$+2a@0<9084Gv@G8i2A*jQieaAo0_#zUo?G#bxdn9>nJ zcw_FdLSRjL1pb8RsZg}&`gjb93!Uwu`qxh>t|nqLTf?zG4*kLM(D7?2w{>I{D2RB* zL`z3#t$f78&vZH!j70+(OVmvp{9(48I~0sU&s1^1xix7QWDVR^=ThAZ>6^6$4R{CI zo>dqPB;zJnj4 zhJru9ka3Q+0A{68P4iGBz$3UqZTq$Q8)|vkd#Q^f-=VT0EoUI$J#1IA71c%Mrh3jp zL$rj#jPtfwCoT(Hdw;_6Gj3&dq?^e@OvkZ%ZvQNvbFUHY`$Q&h6F3?q`S|TvY4_hU zdE2G}5HyGR8Le;YsVoZ~x-nUC$x;S$+VeB(AW;uibNvwdbIU%WZDgq)H}WC7h4?qG zn+pQ41=SP*A9oo(hBR5kphpRFMq@Nf>bHVr8@RdO?+H)*79?U*C=KW{^W|=Zt*YgU|K_FIk0zDT+*Nt%qM*Jpp zmJLhS`#qz(Rf+7cp|4AwhF0BjY&(N|5*!aS@cKdr>JeCwjlmryno~q3C1F59iJk>R zci2hESq;#RtH(~S_uJh{4C@K2=%VuRbnI6d$~6+VsgF}EK6!G%?aip#QEG#KkdzDi z08*sExkU#9qVmD8I zl^Z&{Oo-5~M(v&@_#;)-podxVNo>UEP(oxejcPt00gvM-*rn?cOdQ8Ll0Rj%B(JtvS(2tbddJ9*& z+5-yzXg*tOGO1CnDBxe>U@%8yz$<;Lmw&tUSRRm5mwW5Iy=WY!OsJ!A_auAH`Kp)C zRE|cobd$QEj;wcOo2ToWx53ze^1({C1P7kol%1RcdUaA?tM>o^3}a=VF?xxaX_V=Z z1$>pJ!=k7RR!x@liHMzdaDu~f$-itOZf3?n({;0Smt z&MfO(SUI?>E=_0Z{*#a4)oyUDLJ<%;UJNB0g+y!zuf4X*7B-Sz@sn>2)4&_W%Bx24 zPI=0seHfQ0AQ4b#06~k_I!$-c1JWJ)Axs`pN4A)aK)S$Q%yo=KC?BAs1~Dti*am9? z+>lFB($n%>n=s*ar4v4SISq8h|MmPmd3FR6K$0m%Mmv#i68clMq99bR z5L`?v!Ljo6Vf|9?!`BPow3n>j*#yMjHyV~>Ti(Up{_BMG8xA+tb5ds;^ayQdktu2go4yS+Pn^mYSq ziLQ;!9Kga1#cJnAL=Q3M_qF>qe-Zc+=)Q>7L}nx{F7}rqPF=k>_se|g7D01~R!TjG zlhZblUJ6G&QQ*K`%Z z*Gv)If7W)NFMGYPdBXra@%-}Qf{b#E2wYJgjY9_h67rII(ECjLTXWr6=ZlM8|3ozv zhKf-;YXbE&YFXTN!Y?Dx+hP_|q=!44bd32ZQd_?^SsVBaDl3iK?av11ibGHp7=0lX z`^tJ-m5X>9zM6NtVbs7|UIgjDIiT83gg0<8wTsarXGq~g($E>eHM0VEeMO_3-Lwx4 z%Wkn^IX)GQbO9yQU*JI_HV@N5TTTF)*nV;9I|K%NT*hXl5&yE>K7h~$6j%y6HgCAj zuxIztXAvuPryr)B-?VzOBDegCU!T~Y=(TE(_VfpSFNJ~L!J;HG3O)P*E8f>}pG;+b zm?PlBe`CWoSui4-TXCGCahOqOZV{u@(X6(6OBYOj`3ha*ef5}EMJ)ydchgO*@0RT; zJiF+~qf?%;jbI)OR%5nDl^QjU3hcW1<#$XFAZKLVtDF_Zuk$Ldz>`@D#j0sQTS>W~aIc{X)1le?qK>D-g z0&{Y4ZSbU&x_JF62B)`4ChYHWz%RqOKeM#M-8YOy9JL{7CV)Rxr2n!!Pt-aqdiTd? zM3}m=61!-DnP$^;6p$Z*1g$@Ce|k0F*bT^dDxRg! zGPCv-E@eZ+0D=HI6(?u0RJsbS>!<$Qf2n+}VQ`@)-Cw1lDYKYi=ikejO5&1uTc)pi z4_BdH$a2M0wB%c(IbLT)%li3g_%TyipxOj8&HPhc8f9Qib#T?6W44ke(zn&kUKDzX zh~0Ofkn8~qHcK;+l3=S`p(_HmZlrA7O2RR9#7@kv>C_|;Hx6v-1#2swb9-~ZGo-EZ z=YPa}QgjIH)kQ0qH%Q0ZUat&AZKz@$Nk0pQtzSkW@V)OdA)e(|Yw;IuqPSVno}b=c zWIx@YF$P+Gb$~jriIJo|#S=&;7;zXk%tud_T8DR1Tcu z?O?H;6LFwH)(+}R)xZy!Y2x1O(q$@&Td+vpv?_9{5KM74fnzmv$%UkJd+8TwQT&dH zmhgOnKR8U_IuyK4I;8>T%fwsra<_avy|LTT2RrT5lID~VzbPB*c3*lcr|gA9%V@>U zZV}6H#3&E~pv~CwKKbVQE=fTya#y9&0jJ5%MxK6+12x|WY~Y4xuvRrWzaGS)vGvT1 zqjt~*-Noq1_7CX9*zDTiivXF{m%AzM|IIUJ#sxytR8A?H6Cks?=(jo94ZiQp<(NI` ztJb>$lySB)`A}wHF?dFx&a?rKp9B{b5f9au^|sqts-400oj0o5-NSrtbJs10`RumZ zak2S#y1{G*-y}+Bhx)Abr>4zg8xM*GFIueoLJY~pxdFd$^0ds+?r%>N`TajkhyP#@ zs^w8o|8Y~X|DmJ)Hw?ng)Wyx-$@;%PXUCe`_J?dpezW?5Z^KUe<=Y0GXPBqMpjp%Z zaE978pH2{HNVM~8*qTcT$;yWtKi4_?X+23Un>)A;o)JRRFy^6;_t>7)!vRB#H5~h4 zQWCOs{99er9MsS2E522%^vS=TCQ6QqWZctRuQJJ*4@fJ#)7-rW6eP-pshE$u_M$V9 zr17YrlPnV4+}x8;l_>4TABtmPV+u5C<{-K2HfBG1iPQcpAkT4S$?AmfpO3%|k=OY3JW|&^F0aWmX$WDCkPHq)~6vV^7@r`1P}8E#}-$ zIC-`Bmb@wT?}(AGfL z#1qQiii|Hbclz~DhMmeZu+TFUNAN<>A&_g@O#{&pUnQV}ZiFCd-po9|V)j)XUIw3V zCJP=HK_va00N+=Yf&@UxHb*!uITQ9-4NvCWzfFf7S_8F+N6DbjFP%>3Rn2DY7Q=UN zQHqE~1*_9@o;wT65H){EZ`mZ`U}D7X*+NE|5%kl*U+i2at&zL$dqZ-^D4S zM{_)6w|{V(b|Q0`S{i&xaGovJ(9tUE-Y`>wlJKzXzrL|ey<%_Hpd{5-P%lAMMegI! zpL$DkWXCNuPiZVw77*g1DXZFVNB+r;dl6nm0uUOi#Ul$KpC@wkjT~{)&?4l)S9ucX zwdfF>S-!P_P!|*`BgZIy0RIyrHeR4%0~^HLQd78#1!j`BdeDgpz>4Ir(ToUmhuY5e zd(H-g$?Ol;ujo()`++L*#Y&43{Pn9o#9nI!%FA^P59>7!cko7%`E5Z_O7zz2j)d&n zga%5^X-@NzB*088GHq?o;7~mAOu%sNcA2Yp{+Xk!ZT z9*fTb03ElXe7ZeHccqrI!a&1d#^Bg;Y{yX?&CR@%NZJ{t=!S0LxX48g?1PA#~yeW~tfV*5qjbT%s|I zq^>H^y!>ySCjNS_6_^1*8G=wr12kn!{X!TJ(SqO`l?$vVn_XIsVz`PGnc}gT@*SOq z%v#(H^fZ%*)b=_J#J}F)gfaZ*9PHBV-h;LlX1uYw;9sMSuxIGM7|bClF3R;Fg8KC* z-I`4jwn87t0}P{pmF!n~SSp~MkV{NjCpnD%ofQEIx`b@a7`c*Q!jDKmdda8h4Lp}J zgZa1<{Z9c)s(`uJpv@S-C({CKh#F?nd33v~G>4nYS)R2#l9^b=8Ku$=VXOqQqg>9J zR1`>IEV@qv7UqJkhm;(1CGsK^*|`IsmyWZBW=?(15GV@Llvc1drwj?#^X+El%Ih1T zyDKMlik8II>VV2&--BzRkK4q>9jc7Kv#;@ecR%8uT~>}wqkl?5egFULIZ>+;zJl7tuHJsHxGZ| z0rII<5;F_2h=GDKjc7zA@>^P^ma*g4;_g{|p3|bgW&Zdb-?U@54D;fqn4K zDPbJUKr9pVyuUjZ9q%HH=g7=Yu^}G9mLpZjyGJ|Q7=H~l<*CArEOKv(pDP0Ipsac@?%W&z$L>HZhoa3LttW&)g=|xp&qe2B zFUmko(cq*)joFp!b!W+WZ!EVp?bvaxb_u+=7J*O;FFJM?Z@Yx9`X&b7G{033?ACtf zX`kE%_n`gBkWYPg5GTs_NCUb@R_{;`|Cyp=VvSTuR8?slk^$M4xi$xnPC%V;BjnA6 zIBVF4t*h0c>!SJT9qz1EkjcfSK%qo&36Q~on}f{Fp&FrI>-n>4oeJc-v4OCi?b*lS zmxrDVC4Bs(d-t2Q;SNTf+@-rg@xhc;q3oH8g7>4%l208#h6y&@!5x}7FYf0ywfnie! zU4PxdiOKC5uqBNX96)QakOOvEh{9#BlNV@MX_Fe9qaU|0<;GsqRRf~e05`Wrc?W-X zxr*WPlknGXzjTn(Q`W|5G^M<-T{oLPBBOLe)}$7lt0Ewrb?3Fkr+S;|Ae|R5z z2E0uf*yL^HGNQiW+1hSNozxLO&E)4_!P0D}lfn6r?PgCEi;TcKf|MF$x(LwsPDi$& z+C=w*8zXJe8pl$bTYifSbB2UtmbtUn)mj*t95PrS(f@Vec8k|e-sy$}baw23gY zl5@*H8kqw$007$m^7QQf@v8n4Cevz)|AYz5zl|hye!y2mD!0PU4r9gKQiCH7G+eJX% z)|&?zHqgPay9woJe&)@4$L<97Bg|u`CFL$%c-s;VE4Nt5=5%~b9HApH=KSq?CQ+=q z51Rrs05RLI(1ZZm(s>=~o8%i!Sgy>ma|xBN zY|$jG{fv#=ZbV|M6K#^1^D8QZ^Nt{siz24>xUz{TIGdDvJVdv>A8fRv1vW`4)t8Gr zFxq9@@s?5w{Q)s&!k~b?9<5Ti)toBxQGi8bGE!-*f-c@^E}c~kQ^%N=>-aSOv{lSF z7e05}F&8d-vUel4J}ChK?YD>;l4B_Vbj77AOwqM2-q0cyW_HiOP&Vspl1py+8 zKP_*N$`85U$pGJxao{wZyf3rplaD{DRFy;iMMg(gH^#{mlK$L?wiqcyWx;-dvpCSb zZN%l}A862va{ce zR~NjH%si?foDJZfyuxeen_T=UDm$5_nC7K}= z_=T5Mf%#f9Mi2_mY(L6x;zitT(rLae?cad|-ct{!a94cCV6UtT#cS#VEBGODLCccS zveB}7E}*eA0Xs8R@|7Gqw+fy=x!V$5=dZzFu&oLy+BfyIFJwXXLgN>*xt`jFC*xGJ z=1(x&JhfObzwTQ>HjmlAQAh11bh)SN*xb9^+~`-T1dE7LZFx?vFF4^Cj1xXU^!iF( z410QIWg0K9xz}zSWo4iF*w9>0y~1>j^hv^**Dk-3Kj8m!=>M7bJ8pK6eE(K)`u<({ z{|3uB*!(fKwEOSWmo*gs8^-zX)E|s6$AbB=C+i6;!+>?^P-+t?;#IWl z&-`|ACC8Ix#~oY4WZ-LP9%4stdv0T83QVRKk|R1&CKwc?sJbbx)Iqget)Rd6Vydau zun4oHUz(;0v}n*aBdw=zs%lYWjreOm5 z>%n61KW>flPk~2H3w5oyIb-A=3D-&68Kufd(@i|Wz$TZMHsw`$E76PVnLA7~fV6dM8S(K8+;)@iy6|7_ zvb7v-JS)R(^PUX}4PX4zsjXdD%ig}_D>TAwS+e?SufMo?G8UZMDoTJ9mu1%FI1pWA zZMdxll$7+KRty}RF-VNr+z{q$Q=Om4BOl0eB!nDvawa%ilZEF0>$I0KG}hWmKJsPlZ7)?e|y}FP8L6B zy1isfnnDmZAHdtHx)e%b&R|BtQukK7)Fm*ouw}iP`f6drhHdID5$RkDu@0dr+gI75 zeG=bPcV!?w$%8G(eX+jarsM=tGlJR zQAR4ZP@^M>xr*C%4fx52ebh~c+ueq-(S@^7mv%tHI}-t_uwRhI?kWJbxl*3qFRIlqlI%jxMN$9J}w#uA$e9x>4;YePlssJjHCPTS><*9p8)8`(qPzOgc|J>Koq4uze{Ji;mHy(~8vj)w z4bwr0u}jz?#8eYBa$LKs#A^ARVk}M6)?0s7{{HQ$@-F(bV?+{;+<$GV;c`Rck8AA> z5m&h_&Y=2INJ@8c#%XFFr-1Or{c(oD8yx*6LW09*9*iA~R(HUs^Ag4GdsASlrHr?1 z2v2`~_9<%~W8+PWPG%OBaaqEQG`gcrk=)HL)qSn!QpaHIpfzODcn6l97#Tx^E23?< zp3&LdGw7H{iF!nKesmi* z%>VztbFYar7IfRXv2ELSvSJ%6wr$(CZQHh;tk||~CpZ7Or?tKB zIr~1$_o|0kHOA<@z7F+24SpPq9c`T*4F7|ZPF9hLU1vb(exMdDSBXQ#zIqOmTteLf zR_Hv>Ppzm3kRaQ&2~*sl6bbv;uFr-Kjdd9(CB*A>_hEhzOkghFZ4_tBh4HH)fVliZ zOpzueap6HmB1u6)Maw{^*2_ChAr3o|lV%A6dc+dQ|BPlj2fSl3(U9t?Vi`aQd2r&W zgQhe=8135Sj1hx+u!14`E0ZhYZ#eOfQvE^b@Xyg+K^?u|=#rK#nefuEAf=m(oTt<2 z-1l*XzGY5CSujI;A(nxLA?zoJE@Y+Q?w)m&4Oop)g78=jV<(Ry{4R)QgEcvQ;~mij z<8;yLDlv~w`irC5IK=k$25HV)WssrLg)rAzH{UBOqt~ASQwfIit-N-Q!Fe$dWavDnDl!q@#DVgN4QnGu-=(ccq%!Hcl>x60rM#71$u6Ry` zSp7Hl{Bvtj>u_$&i#C(dOdS<+AuRyy)((C=Ln6hD1nS3lV&Nt+^aDS8AIY)*TVfx% zI``(pLwGIXZeY2EN^u`FG8omU-j8<05_vrUwGA{v|0I3h;&Q~ngFC3FWABa9!nKn< zu)hy;w+ggj=#yDuz@_e1K+vH)yw43Kg1FPJ( z9kZwKAti`+ z8{)Y43tI<#H1=RNtc=LL;87tuvn$3yAJO?uRGAQ4)pft(4dmeU;UCraq5ez4+~6GB z2^{t$P({y88_k71L%04dXHDdA7B_PI{R@6^%yWAu=0ihmhLCg_$;3U*#dV-Y8LQ)B z#y;p0VIs`JytYpBOZ^8Wdu*Z@rGkd7LfO^VW+XsF$i)|*!>=g;+Ht8)yv z|Bhe&PYr}BZwT!A3)f}+P51e~YamBsLkHvk#qa-x>;8wm?ERvO;8U+?^zNsJjn=e* zphq3zY%7pg#+Gf~Oe>_+fhzLjon$mBkhvC_`i2dn0{j3(_j=z8gV66ny4tOyN}Jj0T*E4h)*x-`$# zLwtNHh*TpYR@x<{s1(<;zLENWuHo(uX(T_>SoQP&wc&lPGC_uYc%``CTOC|ZW& zMkv@ipn&YOtjSlJzJ2{o7yo$~)6RnqjfUeJ`|{mQmZ$k9c%$`X;yW6!fivb|X4Ltz^np3oP3}iH^9N&`ANAI$ zhPrPoPoT4$dzzxm1uII4xsoQYWw7K59Ib%P`2Z;St9%!cw!vw&-0T&Y^a(vvw^{sO z6DqfUsz+U&cD}g84rDpeorCbvf)(GlA?whI)mxY|Hoe+}o&UN#+8ja@^lY*)9N>OU z3M~KA<>6@T;9_q0|2F5EzfqPgXunaG0#)!19z2FGto(kU<{g;Y3k1*0Tp+@H;$PZicEJF^+jiwKgbsJxZOjA~sm`JhOO>&TYsN#g>`y$%PL<{FS@+9Bt z4HphBy@YpPwp@3#k&OAI_l8;Sy(F4bKJ(|IwBoFu$*|Mm`IZ$HrO&(FC)Yxhnv4vG zBccmW%;;SHDNZGwp@bdCF>Q@S?6y%(7hN-Nnm?cMcKY|Ml?pBJFqZ2{0W*h~X01CD zD=YFcNDPIXx(FyT4Z6a0g%(3v_x3jhQF*~7)$sun?!P>E`06lqbLp}=!!c>Z%P3+# zCz$G>giJTa#RjSTS&JNL0+U2F{4*C&Md@TMA)x}1Q9A~_0WtnhRmU1~CCEnLbD{t1 z$&G!BiD%lUQFD6w@}g>D?c~x5g@at3GABeBHRnWQ(d4bga-c!})LE?EprY81Z!=!L z{z2J*bYXI1jg_}L;rcbRnFtVYjfXNVJ1xG{wTF&lbuek!%ObVYNs5&#>z;eP18hT~ z#9NT9YqqaE5?j6=*y}Zzx)Rw0XD?Yfg_pXof-A~yah&7C()+gnm5{Jh;`;$~0&wz} z>cbL2l~L%+TEI*65!%@s%}HE}IH_C$`7RJ>C;z=d&SAByq2BwTE`x})s~t+(jNV=( z3!iHY!ZnWZQ7CJyoo&{LXxJgI;hUl*rx#oEak`9|AfSi2XfmMhM{^5h54?}Pm&jkQ zQBITA)vNE{55Gk0M0p))D`0on5{Pn3ji#k^{)R&ZRjL2c zc?a}Qc#x&W&`lwD6X$?_A5*%xw4mCH-GhAXUZ(sy8W6_jFJYUg?tvBPC2CBt!IV^Q z_+c$uL@ofK0^pd&RaP$PFJwx>0Qo2CZ)jZvQZEn`RWx+L>Jm^mJiVyr*e&8N6DNn*J^)ZD?D- zGD`z_OAXu9vlBggiPHxoj&r4O2&SXAO7U!xgq;syewytF^`l(yj;Dpl;l~frF#zrt zhDuA|wR@;3jM;wJwo!OTW12S$I@AbG2*8-|Cd-ZdtS*JcE5PBo-yY097VLxKImp&T z$ud&g+VuBs{k9d54_N67o$uEuSwp=_ zp4W~1K%E^a8v16<(!`AE*R8RJhrq1M4~4S=sW5v$TI2>A=L6FM5#-aI{uOGb!vwKy zjO#Rl5JDEdUj_QeGw_M8kh&M%+|d2+p$$`QnxF4kR2|yLX!PVZAW9(I-bO7}`&6cH z!zYRGu`esRp(|EtxuBdyfstmw+ud~vppE0yh9xqO`2ai4YpD?Ep^;WLdOZg)Zkm5d z-vU7kc3xx?H^oUwB%eHNpMzta$?jeW8nSE*;w27|96*G&dD~Z;f)S5HU9d&%6K;F9 zO!hGDa{;jQwA;c?^%Qh#g6=YR%)j|sM!;e}Kg!6tf8{aGH`7pc29m|7Gq%uXB=PY* zhEglD0~E{bMG3hXStcI4*rEc8sanbPcr{!3@I$Xn6zc{pz`aqRd?&nE|p)I_W8vd6ahQ zo+e=gePoc}b5Q^05nk05k^V^v(ke~oCIyd(fT)9?P$UEWAlz`gQh*%pYosMiwo1@m zCC>ZCtl1cl4M^(~oQ2$^SJR~nys>vYKDx9y11%_aW3|WdO@`1uR|GYg-TLFj4P#0>SJdCDA=1(}98S>;trs1lc%Cu?{xvYaaySs{6t^ zTljoyi^WK*?GZIhKdz3Yc2ji-T_!n(C65I!gmHeY;r;`a?O%i+&z|8Gt_C)*|S~L^@HxnKbFw=F=Q~9zOiV6etrz(rlnaNE<98 zK-8|WqUbi?Kg~fd6)sM0zc5J7zi@WD39o27lqSZu0+-A+LVyXu<0_Sm$roEe5Y8d| zKoZX^ljfWAN*e10GxX1>EJ4exeouK+geYVSD((I@Bam@-&7Q*)z)d#RfJw~gAIovr ze06_u80tD(ku9{6%0KkH%=8 zS~yMq)!~#0ba#G#0R`x#e#%lr8vOPV-pb}I`ff<&1*qt-@P+Dxd zHbtexeJtJ)L70pnru0WSbQ`)GPHZ1P2vA)4>Ns}qyO@}PWnFu2tiz+0F0SBJWeJ6V zzJ6?8K}uE3aM>mLB&sFp#|1L~;TMFm!zZJRpV4N9AoEL4T==5(H4r;eWweF{Jg^CW zuBx8vkTn4dUYOb5&E0;7=(WM zEF4eYGFJiQ7xYXN?r`ESBr&N}ptl5MG_a-E`>1wrUcAk2yBU4dVDuxazs5P7+I;MK z$e(}c#@}P}FMArp(JJ`^YJrSZnRs_5*g!^mexxGEtu2VMOZ3wJGEdO~>9Tn~#e6i< zk895)TAfDY9-KCn{Rh(u$_%Y*gt&E7j$oBZJ9HA)YLU=T6Ql{tpUkSk;h*>{vx%NpXfi8hZ2aKi-xDCfM_7#&y;$IS*ZbUnH>KCuc08YlyY zA(ZjeC^9^k%o=IJ4_TRt*#j@^`i^6>8)N6OjsGYq8VV)>X?AIor~8*gH(vdWe|zWy zW!2@VV=2YssCR7qoQ@k9rayphEX!O=I_4@w4uf;v#=sW9CB_FnDF06UxV4D)5x5a# z1l^2eDD(82X1O4YFT|L>+r0(!7J6Xq>v<0T>_Hzi^q>y+!c+S(k8NyGI#AIHN)YPff(J61&y=J7Yp?g`lfK7Y)` zz1+{5r0#UsRvwCa_xlh)Blr!xZ*n3fSoU$(nb6Qi*$y_!laJm0S*;a=!gX@QLGJks zS{A5CmPxRV$oADVeffH*ePo#Sb*-7j!(BU>J&~G@v~qOPIShY|;eIJzEfY^c!ghu8 z39+e70$XXNo|K^7NaNHl}E%yFzo${WKC6(@^9OzP?J1dQU%FV zGpVjzu|0MuYr9;JloVKalN||wd|BFR>8q0U)z;!Vde)Xu>rjjpUEhK(ts8KN_vKpm zGtk98sjCvJ^MX4t@i!!@fBtWrgKN5y;sGrK!;c-!X+;!|WF4Zf{Q0AIrba`Cq~;MV zn5-f(F;MqFr=5KHTi$ak8ftEF0F91IiiKA%ANW^6x)b4#I_!$+6L?>2vWyL&WxKHS`27I60cwQWO+ zm^@PuffU?W{|@!G%#O9zosaWrAYAPbMPX!U%~AWne_0nj(xa~It*K^t1y+N-v1c-6VBu?w{9<1?z>&(OgJtjN*Ft9apXYG_UG(4w#0 z*!s3>X}uU7T@YTGXfYC6gjs;lYYRkxh^o4-aJ+rKU$?F;^$`&fx)jHU(o0}%ol7bG zG*<>j>uC4(_NYG|ho7%ha|liGvb<%usR?U_wlYV}&fxjWxwSfnXF|P>d&H~iiS^M= z7G+B?~tdSMju~8O5yQJrj2BUANR!`aIJu^#rJd9cfAp6Qtf& z`zGvYtJMP6&EP$QBTL|{%tCBh_qrcu-IE#_Pm8ok?#A#kdP1TJffYeqb3iqKAY1>7 zR(F&cj%QGV!xW%)Y>Yv%D(qJ4Bx-okjQQC~^~Yesvg@g<17Kp}Wz)mKJj+QOj zE&MJMWKwL&#G2&8Sfv!pi)0qc5sy5kdrmwIcMm=`JU>%=0l(8q&^$P$I75WyV-#vI zp`;udEb09pmp}G^!bL4yC(o?vsPP=+U*PmM84w?QN4M#GJ$)PXG%YO~Ie53lJFQhD zbgp8ug*M>LrHTLDt<9A3<%$^a+xkyeQyU8hs8~y91QMrL&?H94=;mb2tW_rBo7Tg< z7Phktq(7%>sOr&o-oU`xus0|eo%r=SD?lU2jVLv0LT-61#i_0#^#UsG(pLy`d6Cc3 z+}>;}gEaiPqCfvKAis2pXLSbT7+>v>ZyzSUHdar_`jFgVs)1^$#nQMUq1@9;btJeF z`J-zLFzs9ndIjW^-V|lqrZj$f)l?U)GQAcimI#nmnpk^1keL3_p%mDUF^f*ENzUns>6b6g4ms2yC%p29H62SA_Qf;d?`hVz{offeL? z7R<_`Du;G;3V2ftknDLEFUR(+A_&=!pWowB4M9~NMHxUHHjO6ePMz^20#af!4r(tF z-ATF}oydz6m7GHgHGB{NK|?#o`G{Vn3VHf#ZM_L1etzXtQ6vm;csPjlM2d%{E?sr6X*upO9izdi5n&6C5WDl_J>Uw)_E|P z3)`puDC!ObZa6so6&7elUhZ*P^))C3WNul?wt$krb6+KJ1tX?Bllc}>_=T)UOl@y> z=X+ldi)1(wf#xDAL&Mn${V&nX5Fw(72e#al00sD!Qk(}mpAnu9kaGP2auB@s0dpPR zeIMzherTJc29yG!q?`u3PFOucMl~)00K(Qj^ax=G4c_rB&?EK_vMT^$dkn2MkbAu; zYv=~QejpAih2WcQA9ArE+wcWprBLCCu_|5+etbzZ7;^TGdPD=cPL2aFK8Oe@i-1n&Hmy6L|f06&2))$r>^{HLMQ zfV-k>qM{*D_IQh4-6`$?X#pXzH|Izest8u{1oU4vv|EV;hn;ie|8RMM4;* z#X)}NQ?EIEW7>_-*fhHlbNj;#pL`}e{;nvsfWT~|$=3i}I*tJxARc{ z=m{t^dh(kz3D29TBAd3@>f3yvts-Cu9CZaI*^aNS^%*>H%u+mt6>g<12n33G<<8;@ z{d+pc#K*~u+iI{xvJ2KKvshV$%BxZ*R?>LfN|B5T)T~3N@>?_k*9<_hDU%vDR5~kh zv&7N?R3*$$0Ua5_(w&z_wuxOVscqe&C_q_)B^5Vb>h(n2zpH)N9gQ_A_a6Rz*8WV0P3+n8wXQ#}Z^CLKRo>NI_<2t#F z-8fye%;BQdsqicy%WP?9*%1HL9`rBfFcyX2fQaCFGzW@hUi{2wHJTGTqBv=nH*d16 zFDWMh{Rp&E)OldE=O+{o`|dfL7#jIKs||K<-kMoCwj`&xpr^Z2IeT` zuYW(jpVu8yc}YM0i7wl#j+q=p*rx_;F6_p^sq*y`hPrY9ysP62iJFA~vn7o&zaemK zn+&iY+qE`5^0Fj3%$UYoQ4Oq2SeT5r5KhML9_Z=%h-%Y>?_wV1JwBN7JU4{%$1elU z;46exaHHKUx6gkw)#y8`S(!zJW!89YFN&>q?5)mASd6Z@Q&hksNfATIR}V+ZVA$7T zKTsKVrQfuSnehcZim`svjw(bgzG+#7Pac)c%!%sxVXcuu(&|S|;ee@s_>0*@loL@b zzh0jeF|Rf3v^3g14j}*S$B~b&v90g<9Kx&J7(lf^VkVjT|~VlTl3GC^eRoq9Qf=R=}L zVMyR@w;g>!hc;Ncc(GEOo{QV|2fF+Iz=_lAR<7iHw6FU3G1 z{S%OlJ4?SkO~SLnoZF(fgEkV;hBMsFpO&NL1UI+i-9H0;Q?BP5_~zWybSPH(Ag*=E z*vc&Gqwt_DhY@dBz^5DeM~T?L=a)N#u|%mCoqT`nWiZmIbSk+a=e)6b-H46`Ci&j9 zDqA?Xhejrzl}pEzQDE}p!;9Og%D0RQO02z(&5d#0pe@GZzTR|=f&M_6WikLH3L0XJCi0#JmfQ0$ zP_xql59X;6P%xStY=RigPILxudkRAB=`*D+1JSt{DseVn`bXU`zT@Gld=3Hk#ogW1 z4p*hvfFd|26-qbbZ}e z;?h0Zbq~xr!=YP`_f485w~Q42ak~75CVe5?OuJpOm}fRXypD-v4&^ZO zo&4iyo`aoq+=e2{P{AIh+v({@07{aw&|ubcHkCYG**S$e4A3^G%y$y3B$1FDuQtYS zzQh_c8}v$N=rU`dL#33}w}v^*e#QtKbh z7$=bEEPSqCN?J|&;0H1KH`6X>VOr}{H=idq_ZF$A9dNV{#4WUnrL=?dRB^D7?#G8~ z6Ydw}2AA}6WU7fJII}Mz!6ci8A?qqDPrMkN_bOmN5svF6G=`oQ*6tErh%&CP8MEDpe;7ZgfN}iH7cld_j#MgC zRr4`xXp-{KeFm?_f5nNi>gqs2!Mrt{uHzp9apeJ#xA!GYf$a%zEHNXMM!Wuo&-NjBW~HJR%B4Hc^Qu<9pF{-4`U)$iNYP9iiS~)My(7&t7=LVhvK3 z)$E%^k!qjHRLje<%B;ys`7QH~z@RKfVB}APh;90Z>0tbV%cdW4d&tx3UV?GQh3M}yIF{U zqG)asEVkg=$4UnMv+Lp|LjAZgooC5z$v)l3FmzdOC&H21rhC~+9|>g3#vj3VcJOqq z%GzL-xta0EpcF)WzruU7c~oA`kiFuY0CIO?i|xvN8z7i0kgIBq{vqUBPe2Dn>!PTm z`l#I!I`9#@|8Jq^Z#oJJ%DZH05x>S?yx&;j|CSl=2@mmSPY_NhjoGzjT<>eN-L<{jwCnQv>NuugZrKxT%33jCdXNXe?)L^1RgQ zC3{96g*Hf;INT3GMvoj22*-(BDon1FyOULZyZ*P`_lw7?^AH;pQ!CGBpJ`jWD4*UK5lmtec#Tu^2?AO2uzB%mw@3KEvXRJ$q^X8#{ zRbJfxY1uY*=61%vnZGu_3vO1m{*N#7yGB=_2;a&Ou3N8<0pvEcYO)T%9Ek-|qlp4U zgHtSsRDrmhe)=TM)M#bMA2AiKobXR5&8?3DB07xfC>Q#TLo# zb^-9I=*_g0R_ZuXq}n*YVL=#3WG~gPetPurnf``(Yp9p!sHH-5T0zDBA?{}?#S|qc=OF42 zFdud@29l1|l77!g>_bAeQ0qq`wi@}3F%VBw8fI=rOO@a@ftThBWMm2kK;!d&VC&od+I&3r#SAFY_Ixo0!Xo0e`zkQ6AiCw=V1o|R-4fJ=v^=*6+ zgir6)SiU1Z)?t!UH$<~mV?Uo$h%5s3Dn-oIA`%utT2IoLB(g$JNl3aZiE;`m`Va4) znoUCzWQq`!MbCRrq8^N@q(xVT*H%m4H4~l|;z53q1C58Q*%CMn z)wD=+UFZW>UaV1Z!C1^uAanf#3{1B4*RIk&u5tX;6Lr;*#)JB=(3z-J(_Uoazu#Q) z3_pzO$jE>ux&^jR&K);HW5WWfxjC2l9ysc)?0DZBM>puPEAV$y2c56i&(H7QVefqz z#2q(uydGPx-{%X)zH!nT-iGw-e~*d$-LtzMmY_n%ty*3?0U1{D(t-s8U-HXlXd-aB z5n!d9aVklrNOkDuuC0p`oarKDsMOr2Pp?BKyEO%8KJOs3ohYq1?J=aBiM-*Y3U%$m zs>(l}2HH|FI;UZIucUgcYd)A3QxP2*udSLqi%OT0r8DOkcWt+%$@ptymM9xDHU?O- zf#>qkvr}{D2Ibg~0TKMw`6#k`vpVz_Zq^Ee-g+ zx0wu1bFRTxaUm};#hfPac648E6<}4SZW9H#6*Y@D5|KcszqPLYj#19Y)Noi89P!<{ z+TX{{;SslmI#bx>#ia2Ks`qv#73h715MhzZPde%Ya zo)!_bAsxzHYkVaKyisU6=&<0}Hs*~{Ef-q1_dz3oBs61W{(}A0niZ2{Nn!bw7X1ml zk@$4(UTh3kt8Gf-+r^eKbj@E8I3)$`U;E(p{NF=KOaGD znVQt+%ej5&j)Kn@L#`PTb#k`tsn}mK|9>s<&+)V%=-u-@J{{~VM2M=weQ4pNuJ{6o z=hO&8NAe&w2HZqkRN?aa&QeV8p}IheD#Amy{hO4tMa%h)n|_iKBkx+r;TDGdk?8be zNl?RP{I{P#5QGXW0t4O!Y~XpS3y6DiVW_by2V4?FSOH>9+~&A>v~1EUN4rq50X!a> z4bDN_5s9b>P61-GY7xgwB(kWma1CaM`IDgMUbKdG=`&hL0qb^h3ENQeFyehh0cQMV z7lKtZljq1({GNaKT47)~SsL3MIlM>p5fx(+I~)QzfiYs-L4pg}PikUQY*E2B2>Yt< zwjRGNn(R^>H{SGibZCDxI6U$PEQW|m-ODdC7Dl!-vBbyfF$umAtB2ut_xU~Wd!GJnN0{=%4u&R|D;nh5bBElnYE{Wj+tak4mkl` zYSWNy|4o#68tp*jN8Q}FRV7?+f^S`B=iu#?~oOs=zJzk2UcN*D0fR*s*YBu z@8afyE=E@;bOcS^R85&2WDe7@JyP#e35fW@EVlLixte)!jGTCFCjpV7RD&2i#fOt< zmeE?a@{p)uC}&smG3Z|j2m$%C1O~r3C>{rrszM#b)q^S_K}3@fAxg(0uHipZFMjD) zRgY!JXfQ$alB7SmaP3w=lShrl&@3m3pbRyjhRil5S(rA#@E5A&IAzViT))T(L_vQoBJP?~V z(m^PFH%f8uK67aLGx@e6YxreW8A3_2DZA5C7{+nCsdKeHb&ZdFOe|pV3v*ot z1CiE}F_Iuv+q|gh@V=jna}sGam$XvJS-8X)9g{TRZ*7=6%rMDrD`N;QD5Z`TT^Y1G z!-bnLo?4qm(6%-XoOrr_Ue5XRFvsV@3Kn|YVl?1zjFm?ZX8fR_=-%G4WT8kDurcOIYc6aq zzyvz%XFW!Q1Pqq$|H%OiSMdaeD1lUFF(R77^fhn~Z$3v-tJYxRdCviA4gvbK9!G!?mxFIt0mhM6>7yIkE%02k-XPuhS;Q_Adr7B& z5+cxRU!}*QA=Ik7Y(){$%=W6F`Q!1#SA{D#vGdZArQ~eH(d>4=o|ZS7L5?u7=@UfL z_XpH&Dp3p&Lr4eFn^Fa9IO1fBZJ?N?nBx!cfbzldVbfxQQ)c!3D_!OQo7W0kY^f?l z@kaT;Y@p#-)b+nuCE>whnWA>AnuM&5gVhm^>qq$2jG;4}iQ(Ut>&{Rt zf2}I1isM=Gvt_fDL4_{RX|kX)&)RIpR+DMpL6r}zibXnU0*V_?ULCM)@Y*in{r?ce zN^gMYN`83{VZT=%_WyM2IXasC@2Y+aL)-SC?QW|#;Fec>+oPEl>XFdT|G_w0yKs9b ztXq6Ti=P4sw=qRHTbw)-&9%3i8HF-FA?womCg03YJN@vVT@T;bgMv~-l0E9lCxK{} z&X1RomWzEq291PpFF+*oK< zPE$y2^q${D>K=4Zs1HEGY3hDqWJHr{1srwQut2e*g(Q*1B$-pC(JI<%mJAhqiSPSK zR}jTryAkt$8?4w#JqfQUzsC*7E9{V1|4xPTR+~@LpWZvvXRkjUpMTamHFoR#r<_UiQevCfvU@w|JY~^Ep79Ni#fN4RBQE5`q-U5YTO$#oh3M( z!3Vg}Mw8ZD?UauNsW?JKGTtqlC7c8HLYLNV26q-ldZR%Nd_A;(maRyN>?2fAiSjmv z+`^4C>Kh5RBVy99Ii0${A6%LWsZo8n8eV!b&2?2er^|ZHTnFP!6n-LSshqk$xJS}% zQJ+5=oeU4%+_PPAn2r!z75}p;HwK~7g%oV~%uZ4*ETMvbYVmgP^!a|{#Ixf=WFIdm zTyy%i?;%B>QW-3TprjQd01ny|VUhj_$ioS{ns?BA#-tIMfa-$)P7?M_>4s?Wlj&h< zw*mA0mgz9lVAWC`Q`K0jV6Vjd(sJZ67q~Y(Nf5mpi8&FJb6bFpkRoxsW-%{{>0Qxg zKsGk7HXP%Nfo{o4TH%6dE=%|XJyzKxr_2}%jn0`a1SP8I<=|8mZqRaAZ(xq{_&KN8 zBLj?_fKQma$(%40x2f20fO?2RE|5ekQugREj#Tz?K)8%u>&s=o)3JPO`&kp9%I zRdktYys!Z)H^??DmFNw_kZvD7XDQ7&48En|`0P0p*mG5MvP9Mk??dH76=3T+`;3Ft zoQ19@%HjN;@u0zH=DCm}vbx^9QJRTUR@QWe>YS2}H0&61c0uo3l}XV3HI@B04)PXb z2wFqocmu#C=%I}tyTcNH@h?yw-Bd`zh6XGfW>4`4j*}L`d8-U7o>~xUkR$}-;%8AP zibM%aV*ca@K#}Zf_?Tl^ZM$7CvR5{H2G8UuKrO++LX%oXjWf(k{>h-7rTmoh`zXjm6 zTfD9dh6T@e)0yEc24=^5t@4N+eAG%YIIi;Cd65(&(^ z5lf*mI*YlsnE;=aFf{jaPNsF33gfd_9P&SNMH-@Dok&w#yAo53O;~X>3NR8m_>KX0 zWnz(n{F(BMOn9O$TJT`({Nqe_K@Kl{T!siH9Dl!;@IJ{WOKyGRj7b1_QT`Glh{R|H z_OAITSQfyMULm*SnjK72pH2@-uez53qA#LQM)y;a6z}SGlNXN(glULl$YI+6J>o*X z(K6_S@@;S%sJ^>P1^UNO?*CPC*b?5(mY#k+74ARPQMuj_TyTtHv>eTZkBodvT}sjM zd6QmIRjr%?=op;`xITH?VWHci`Kia~TRFfMxu!EHE8TkTSsDqC@9M`FpKEe~ve*HK zEuOV7VG44nm~JuODCn$Ou=@cgLKLU9-)LA2E!N`cS#w3^TtZNk4kc;zeeFIy>y1|=0eP6h`$+# z0h@xRHMv9m1Q{@l-KZ}nLhS7&( z`2JSi_vQDM8Z?Kl{}ntJeYE?$@J!nGhUIw9A=9*jqolu_&3uHqt*JDD-85feGzs%T zIG-O>z0mHhA{4idu{%i=w8nz6YYdqT;=q}#E49N%%+=PP_;|NE2KWNH_>1i}{ZQ@A zH6rWfbpq8T8gOD#$DwXWO#M_n)2|I*IMaZ7+}gNNu$>;VnAbtR^}+4h)E!&%26*iS zj*eA5D$wnD?{aa(3*PpDi=$@XO~=xYhYrY69lU>z$@9o{%~fZ5wK?eOG1Qsdm(EhR zR`L{8F$oFU;9$1Ta2tnjK27@k4a=Pr9z{N*e^ASAuME)Fv7O_#_WlIz zqW{!&$qI!R_5c$p(O7*h?+Y;dF#a#NAF%8<1@`&YNzbiJIV6<$<`&l6d3BnW!%qNR zhtaUJ|IcuF?^Dq%v!-hZFQUBARR;0nPi!`Jcr&DJzgNeQo9LPP`Qb*z)mR75hHZ>t z;1B-)cWk--A}iYXtMtJAzG}q#pUWGo{~EL=tL*%*_v9qYDrZ9)jBk|Hy_v6oy2G3MnJj6tZzCRuS(+H zzCY*`mQwFZSXFBhbx1ErS408l<5|>~2D~$q)pY@+A;}wW^r@;V50jN|H|dNjXRzdW z-|YEGbDt^?Gxxd$PA6@uru1J^7P=2+m zKDB8UJkGz4UrnXp2kaaCjh%Gc7Xl zjfPu!+I-s^I^m3hCbR@;GED=$+c}O|Cc?r#;40XGt$yR69usx~Cny8sXC?*9o#Ga1 zt+QtLu1_G_T`UNP2B)J`oAZWBxGM2lDtHs?X>fP;fyZjpmL(EK7O8MzAGSWa&^ii9 z2LaOgKCtR6I1R2!$H;@%>Kd?PJiPTYzmZb3x~3-QATWPw5ny4WH`*no$uNS7G!FFX z{G%);sQtR>Z)Wb1q%`5t6_V~Dpk$Xj_r}1U1M@xWYQCVS4tDiX-SaHP_L8n-m6(U} z$Y!Graz>{U3aiXCR zQMhF^W*jD$6oZUgvIQ2TtI5$yThi-}SOcb&JqqoWS<@Lu_(ZKtWo^erO5Ych=ob#E zj2muq2N#~KhldLxXSJ$~=FRW8Rj^_vj8qpK6gUgRQtvLaKe4voO&HIsxunUAh#3p< z0c8r~z_I3es-&;Pih;c9vt*I!=NQz$|g z#9e8N_sY`4gfsB{B-u#={{$&tCUd0s$DC`Q z?S|7icd$BgjvGTwKT6~>ozVk_E4u(evCM=r448TApw+rG3V=z%vO;OzY{@=f$xY7n zU$lCm{DI@%|J#A&40`qcz8~dYk(dAUwXYfooz}XY#jJTaA#)JvCc2`nX5>dA|0Tad zUo26{38B+Rn~G5CfFBElU&mcu|3YrI&N#K(+OP2oQ{Gp9g#EAI9WInmaXd#U9_Ux4 z@Q3;T5r~{^%-#NXJ5#Nq9lJq+;{8&~zYfk-E#=ZQUlEZM+QhXKAscqzGvc5f? zhGZJRY>u$xta>|2v0k?C=U`b;C$D5-8I50VvOJ_u1bz<}@}pCIjXq`9h;iV;NnOOI zgoP_2nr(s@5DTxC!m_bIyU?Zp1o5dq-nJ9QV_L;>TA|}mu9OcHwM-L%rv_#pwxH4Y z=}icGgd{$#2`$|q2$6yb7j&y`2rv$^gjG%I+d|kMWu-zw$IgM1^RFO7dYUZ^fv%m9 zWKP;j!KhKB&ozRIpIByJ(dgA5H97s~?V~7s(5HhcU6QOV@YLiIJ(8%`mf!S@3j%dN;N=3U3^c+*efqArr%vf*#&#V8Pk-nQRfiG-Hzoqv^WEpN%y z<^A;+pHaI!)tQ=?Vy}#>gv8YJifshkqx!?o>gWE?oCEyndM;Y)Xj`Je)`yKf@_5XUi7ka~ ztEwrLFoJ0xGj6>kFpy5xptrLKD<;ZX%Qb>vw0s6an7-0OeJj9AO6}aqYK6e4IsY4Y z?<({Odb}2v4DHffxb)Eh4`vKNjdyVJ%Q>nt;9Z<=f&x1Q6$IaF@h1fPI=JvsWz#H00oG;DlnPd%lan8&07VqusYeR~UJwNS%Y${-+c z0Rg5V%Dn!*`q|+sA7?X)U-O6M69j$8V3Ye>=dp}?hC?->^+GE;`e3#L=UH>;zh?BdWvEzRimW}26ZGMI2?iXsJs|Jas=>;2zI5zWN zGzWOvVzGR78wprTuWlZsv4-r-^yI_CWTFM6hnJ^nOzhvLoNAAyOOPlb{G@tdPx+bP z2-BPo#HQoF74UEgcj)*`oALFclFfaMb8YN5w3%T8@N0U`HhYX@;WR3AGXdh zNOWlJ(rw$eZQHhO+xBVOwr!ubZQG}9WBPvcWA02%QmLdWe^RN+&b#+o>v=1Z<-Xe- z0PUSQo?0-F+xw5(^4$d3<%9Uo9-C>R01=u>t_V`hOqc_ut@R zXlZBa^gkpqU47?Gjzs^LvOQ0HiV_sgagz%>m5U|MgQ;kD_A4k&B2Pe&?%PZLo`qQAX;{b!&39H;C zW5q2KRm~|;Mfl6ES=W?k^AeE|pxxv3-eHc}NNbM<2`Wg5ww5`G^I?%K6Uy$$Bcj=J zN3EGtNk&W&g}+l1Mm#m55AmzPIX!m&Oo{$j?i;4A;M<`Kp-+n>t~R-lEm#ZRIX_sL zo0Cr?Qx>%yKe}q_m@1p3*he1why=yhC;CvDG}p0)@!#Dv(&Xxyc7%gZOM6m3I8E$+ z>d{pZjgxhIwA2aF!RjM@vx&^mM(@)o7{{JM*->AtF@(o(_&J}EhXG8v@iE?pB* z3$aA<%nHNNR6Ubqhe)JMl2H_uWYa9}%IP4@n%i-wMR~DxKW~a<>O@&((AMXIVDz(k z;n3E*E}hk27Ntm92=D=wixAL-gWk5nYz;q@j9Qo*t<<(C`H|0H^2iKhi1J?rU4$JmQMAT=kVPLu$8 zwhN1bFRR2>|Fu%ETuO3X#upWzOH#5xv7nJQrzlB4&}v9F!oU?#T2k~x4a{hapi4o6 z@n`yXhSdqi7=R=(E~%?t1Z}-SxI#~l0|I!>9lZlAj%xWM>Z=z?A*tL@4(LII7S!nr z0wrvr7(f*APZtj7v7e$tvXQ4_3Y%W@NcvSBj<#aKa0wW7DL)E$yS=QE$_2H^)Re3^ z*gxsq4I}3WsIy*~x~(TPvc%l-xWbbxLrRqtZmFd`Wy8&$kNiQDPK-NsZ@Eex5f*hr zQ6kT*yxz)f>;Z*KYq25Tc$axh;Yo{h>O032e?SA)*C*G3@M}^iY zqGS&$iImccreIl`Gd+^Y?d;|w)`dBlZkl;cDL?M1&+mQqi^rAIcGLoJEm6;>Be^Z@ z_|yYo*tG?PcAZ#l{d=lTupnrcMnsEQ<3s(2=Nl6sneH&|v_aM8b6#kBm?OTxYfS-X zIMWW~_yUE)Vtwy>2PR7K5k0-}TS9C;tC!Ea$C#_*NUUu!#Hl!#NkNLnol*L%6D(y9~@&Sza1AZER!h;`F7n@CVFWnDwcq1v)5RRwIf^ac~P~f74m@ zMtnMUNf@KZTCoKY%!Fr|q{w`Zkf`|6}4@ zx?~B9h@K9>+b}3xDLVQi7GB>O!!W|}@Sj}&ZA*|Ej-x%fs+Q$hzzu88$iFmL{n!b- zn)1Wl-Hb#Oh%pOG@t06#AWk5F_F#M#(CFi?TM=X0_Zw$tX*^lxuI3gZ!T9CQk|qG4 zI$qB}xONv7bOay_2b{u9Ctp+;&dD6Z_N_GS6N{&Jq?q*DfZA_KN ze5Icmw2L^tL1F2R}^qSxpcKA6E2x0WNpj<4@4F^)-8jwQZ%?8ehChLA2f4CjIXH@ zP-8?*(Z;qUQo!!4#^058G+LQ<`6ImdEEvzMJY35kWJt|Xm}8F};0$q#a?uf$m!qF5W< zXaqlcFW~&2vluoh!z8=41MJFe1^S^4Q4taZkfVep~wpQ5YsffA_0VhJG<@;W=*Qi4qNry zzd~$R3rUV*=fPRMDiG%%F|5wB&NG@29idGXr@--j<%PW*~19=eu*G ztud9v&f@7VoXTqGP@r|y)J&({y|pJi2Jeg3cIV2OiT0+-%3a;xwZU8Tn%mkIvtjq> zgkQ5-1MMw!8PKhLnV%iGJdE0r^k5W5=6oA;@vaxf&C{meu4aI>=>UTh%=ZbcdUW9- z**NjNn?>On8~3xC*u?My>}`53XhVJ>x1wRYKRy z+vsv-b91mni~;U1V$Jy>HcRK{`*TFzS;)j*!nM;G(r*D7Vf-Esz3`P8PY*ET~e^P%K~VdqFQLMmKtMb6Ywqr)J5 zJ7=37TcM$OjIw3OGQso640MSjwRq3SpG$h6VOQjn95s*H#JJZ(qLOKqo_{UMB4MaOYg*KMO zQe~Gx%G*Vp$atqW=kBg!AnR;g??#L5l%}Yr?Q+811hik$p z8|RLNxX|$Yfoh^oo~*8`VVc-)Ha|@{@%0BIt$4;s=pv#wCo#{MKiV7-JgFDCZbS;M z$TCq7O|{g3T;91axMD8y#g1X37b3t>9`69Z8Lz?g6eX^kCbeoGH60xPd8m_3X1}Q> z(_A2-gyA!|Q~}58r>Qcb%6Q<^tmW@oIyblEeBa?N<+ZtjCwWEg>TBS4f-l6VjMVO~)+O||Vo`~SIxQcB zv7$!pM}E)bYZfD?gvqr=c;KRVShw*D)kafL5k7;kEImmzm~QRJjY&K>9Ym);g1aU}wY_w%jmk2n^4HD8RQElw|V^Q#p#roUsg!AQ$TKX_laEDsV(d#M97?78E8h{99i*1v|qA^>0%2}R<}u5anTC9K>Vnt zk5QLbkAtoJgn5Gl7&+Sn>X6$DyAjk^5CQk}3nG~y^brGJ8R@?$jZ`KO>0E5Au0v@& zc4ZE9Q$+~kq&dPwMG_Le5V&O(YPRR9J74rUMxJPQ;5HN0njyp+?{n_D#C({TYbd9C zU9A{zA^Q+0@5!fx*o?w`o1}^~)J>ytzJ*kO@>y@P`*y4drYx&RTH$Jn!uhyhQ~)(C zWy=bbL%oR@P|_Qi-_q5#l0?5p)>y%pSqd+$(8_NAyfEMmA)1VGsST?fHk#vAMTDkg zX_zUOV$ZIZENlk4WOsX9$bp*Y=T+CQkbKkgx4o%uk&*9FH2Tf zWM&bSjH~@)<}iLn^6@|rhh?WO@=-irMUr*oJX~(Q(RF(doJ8qRWKTdM&aVs0k?fD_ zEeH6I0U3f`RPcgx?$)^mk+t#{cbN*8PU7G-cx;0dH2#mhl z{knWhuGiai*7Y@^*7PK8AQvc)oWnAV6=S#UNrbcKHNxJqL*yb=*@@2F?Oa7~@$>pk zHte^fncS`8D$I>xV8UJ7^fm`RdPRR&6|@suFZ&qhy3BzSlO#`H6EtqReeOZPx>$eO4p zZ$j6-8s}c=(|$)7G2Bz9ssXE{dMANVOk82-|K8APgN10@lW|N(qrmG0C475Pw{)aT1Z! zZ4lj9@7tu=BqodSaqRYDlSlf?_jZgj`(oz2|HK51zR>aQac7%cOYL31!n%7{^%rrh z&XRgK&x)he6ZVXbd(C{tH79G4&*+2G=F-n&yZS0Fx9f=ns>Dumw~L=(-(I9GD)J;c z$7%&LGt5G}iO0-~2ml|v*Q-uK&4-zo1<1|>It9gAQ=|w)$@+Qoi>t`vD9#cAo(u1_ z@k=w*0=jhs!fe-o>CKRE912fl49G2SD3q-JQNJGyjoZ%t@HMHXPjqt(rk60-92|OK z9o1oQT=*Sm!M|oEU`@|nVfpKATQI8C(VxQ${|o_QVVfAwAR=_X>Irfct^0Rm{ChyS zl5e-4RTSuWDd=6)bAM`7XDGX-1Ts>1pOWNe3MxprruFr)jZYlpsF&N$Vfs#w%!-MCd; z@tAB&nAe)+*@-&lZi7{-uQ!$k)pnCnKDKAgZ=$Xn!ko1M)kFInIA57vC4Mb>`s;q( z=3XZw+fQe>NlU%*TV{U!rVTdhqGq`AD=y9ssM@aNIxapSyX5vGWu5IKX1Ih)-Na@M z*VQg%H>~ng8inJDlb+swxo((g_NC{yK}?k8ke(%%uy&En4!qeoJefME zgf}}+V&)ea>d=m0-C60a-nmJ>uyUFMsfk0(m5+Q zz->=nr~OTw)n0d8dcH**RPlDeHZx%xgW;};GoQpcjkzYE)tRD(vF$5QHE+te2&-ik zSzU8~gX6tkYTO&O@lhMWM*{0Qb(1xta4VXOpkUM%oZzSoYxZ71&zrI(Be_qgz021J zDn1;i-?ln+qD|Ro6Sq*|sbTP@%-SlQe=D*HQ(O-9%1h3BX7bcO^35)8ribCm)7JYv zyI8ZvWi#>-(Myhab6h(}TUZuEmGgm)4_h-&_i-CaLG_ECo|3)7p>(R9In9{H2 z0%;Jwy}a)k_=uTnEa_oahg2LfW{$ARgc%dHM1@ta+Ua?mnoMbZeNCu!eUx4W%*#!m z6UkKG{nYf;y9lxI@`P+8w+3VtqOM)~8$sCUm>%2Edp{%syWEhL6%b>XR}%3!B_=nHprpd`ddoR)En4o&^gT``Y2JTyz=<+bi5Ev^$*{z&E)yRG=^Y%epkz0ojre2 z^$hY~zg(9Oe9Y}*8iR&4O_qBtKznx54X6f`ytku~@8O+jK)-vhaR&hL3L(4UHwc2D zkjV#hTxQ8H%DoCh7eCWt-GyPz zE(q+ccPh!Cn6Ehrv0**ltPKafdAFa;&EdzcR+$ zFFW?XC@240$}llBwYC3GN-HHr)*hP>A@t^hT5P=Edi;1nyX0g+L`tsaK#jAOf%~Fl zL;!Gfy!Qs6>)B7#>c!yjI42C#19P&7l`eq&AfSLE$ooeLfS0M){q;12&%>;PQkywnL8p}Mk4@2zFjrq;t#5Eyd@w})a#PHuRdmU(% z$Qu;9U}3+hsjRH5$DG~%bw}%YL1UcbiRChaIEdFsu2)!!rZRb$AVDqeW(d4(YA!XB zi9u|Btv{H!d0kyybXYw>3W;JgKXj|aiaHFk0ZY2S-eim-`HNyW(@gBq9iUa#a1{f& zXlvmPPO13Fa`Z++A<0KN7tAAsWbe4-5E!sqQY#(Z8^+}p z5tCl3yU3vpce=}K7I~gdEd5yAaQRAF*PalymqzUMM0ZxabO%6X9TKw};k0I*lu05W zF@vO5^4ArNiyZ0BinK{pKZ5Gc&)HdSg3UVCD$;w}9{nl89N6yRVV1<^z=l{`Pk?xuK7Y}NT9uuX^xkUG%t2b?MF>dFj^E}hX4qe8;5!{mmQ52lS%?15o zM`LyKk44EjRnH3F=zFq7^b?E>$E~0~?Xg$Iei8M(?_9U@vdDYH#~Z4J^MZ+b?fGtX z_WbSp*pqkl`3L^LQ{Mj(diFt-U~PZBKWo3tE*9tQc8UzH3iLC=gI`XsFb70aOcSXvN^sCPZl;XM74daF-9f{ zVP&=3RGl*N-1XELL}gMXe=-Y4brur=BGd^#g_?uBq%bU*IS*WCjpjpa7ydR0jsj4Te zuqb6APM@d8eKQnYtw2l+>V5 zh|i$o>jZ6rrkLg_?kBC<$Tbio6M4=k_|CzpwmC%Bj^VHwqVC97vo?Fxk7h|ccX{%P zR?)3}4LXhmFKtOtAw_R2XU$OwXUS|^^VsO;Es0pJWIXRP8G*7*bGbA5b@s&J1hb8( z@3ia&{#8_=vMixEqJKQ+)Jd(a@VeHPsnS}n-k_Yo?1w4+lGl1Ki`IdgBt_PuGY5;jzq%g!wkl>viUdr|*b?|AV(}PQzOx8#=Rx4ajb| z&cX%a&R=%%VTAp!W*TKp+&uS=DetR5k<|1i`l$1ieWha>3#wD$Ihk8etq6H`tz)i zJ`D14ZBDbzyPA^zaeSn+|MkRYrM@4)cIyb?ir48XUOs9^t8nq}8=mBDFqc^MFD*yi zx;Cl18&qTUtz6aL^7{E)8Z#%PMdG-67+6x3fr zWHO^U0H($eQM%aIkc1yfNgi5ip^5|G{jTgC!fO+F3~Y-+819s>NT8>lsFYY(ZDP@( zxBhv?tR(qYq9`zGDgL-9F@z5$&CB{V9BpOFS#>Jc>63^(S-Whk;Qb1y{FaX`Of$c2 z*UqC&!w+rrf>5IdzNw@Y%0z0_b}qu*RkOQFuKSlr`B_`v690ED;@gjVs`KhLPg|&E z*pkG&(+KS`C}zi8H1#oRs$R=l>oXg-5PKAP8xVy4=1BnC58Ikvid#Qz;jMyQ_a|;f zJLOHAl&<)G@sTDa14@{aw!LpSH00`^fTWh@1@Mn!^;ixFKG-j*XjLblJgD9Yj36C1 zcpkEGvx%Z{6Cq~AkMy9#WVU%tuefnY0)d^Co6t`;Ng2s7CHkURil);KcBs`@$6;_^ z;p?v<2y}j-f*XZSO+tpgOB{4Jskc&iLdsMsJ&Ba0;dDVYy~?FZy{BvTO~l%ClK+C! zgN#N9H5O`S(U?O^^%<{kiDh4kNM~T04K&aqj+S$*5Z#(Ztlwq$h-E4u2toK9 z?YKjZ@MOPGV)1(~h|mUus^&>3MyybTassow(}XBcLYf3$0h4m+NjK}@eft(=;Dt3j zW&WfA7r-i(Pf|i$*d?{2%DgtmoDdTo6RKe6e5NT3|5*kOe_!|VkRh*AyoY(JuL)+i z_wWZ5Ib6i*>S|7!D165i0;mZh22@T(JfloSpMR3_S(F^)U>}c6P{TxQxu= z;QTc2bEO#_Txj9--WY_UZb<-{&jZ;Aj3Wd4-IuhqL9@%XJH*-2pt14mrvE=|2wuah z@MOj=oq`P}mKcWyCErCjsnX~sa)3rgdJO-vmyag6I!6pQ4>az=?4%)5T1kaJn4xcJ zIoYg1x7YP&O+Cyn-F`u4jn4kSJbk2VG!v`gYl_zfwSg}+Afa|@ZM(cd`7~CMT~q~P zBMA^%j5;=wda07wF`~^J5q;7&^E%N6&?O%IqkKTlflT1!REB*uzSsb(bJ>(a!5aVvQD%<+@8b-sOxi=6p*1HDA$b$WwOL>7(H_yA;|X=&Wko{Q;V+&oO5M40RLfJ}2<0OhAW8pdGG&Y6=12L-)C2j?OM7w=w+?-X zg)59%zM8BL8@fF%VBG+?LvSUy05ux|$>xW8Pn+AG6n~D)T|3j3k|x4Jdq(FumsywA z>pU`vzw$^Ab8fu&;M1V*cd3XSij>_!JX^l$2>V(A7uSEJgM)m5>zaC-X*-+e`j&#v z&)<9h?=n0)aLpI**LBS0`TrT({tJq~%xmquDdDvHL`~KMU#!G3yVC^^dC~03HNK;q zLt91T$xgXRNN6NM2nGlOKhBl*u(=rLX)GY2XHTcNTq|i%T2@xp^}CmKR7~ci&x*GG z&gxJbYbQH7*KQYGHCb$xnq&NY-8w#xFFzlr>C+~o)JN6nce{OSHr;Gfv)mSe0sSwq zJHDH%O_klAv}T4%tKB8Ll80^8(uU>GYJ8tNYLbp+*PEwhR3x{@j-Py~voHazDtWBa zE}Yt=BVEVBK_*sj&Q;qV2NlEOwzE81q=yhmDC9u zk_aZb6zK%KW)54x&wh39)FpEPLqSqn_DCPyFy6|rR^=2Gzb~!+!1C4Lk;)RpT#YNe z(Q%&U<%-SdTg5*h@y^`+Q%6@tO6LZgJhj43R8jef2T7Ck6vHg1R=jST>LzKY=){0E z3|!GvJ;9^Bi_G-;71RSHl(utz(2N*;PTHOp95u`mTme|CNc1*2Hwc+-FUyR+2>peq zz?f$^BCG9gEmFbA!AihpnKtQly+=H>E=EE$i*@$rkZmkuO`nVa5tH{%*fty<^G)T- z@d&Umk?x?(#z>9;5!&)skcfE$6GW|u=U1N7ww6qDc|^q`-l!&__nk*)0!1P&0(_~f zTjY<22gmko$D89O5dU8NR2_A;xDfm{X;>K=Za(H1|9BC~V)U3djPqrr8WC%fTC;2G z_CX`*9|hQBS_l^~k5oLVmZ@V}3vLo9gB_!?tRpobMn%9al3}${XZfgNC*st}YJjWe zY&NFdDWJeSO+ZdAdT35)j1+t?i`VKRFU&~B%ntW-d zkIuo%2rHrqD+73Im75~dSKHFs1@?`*!iBKNDk2wa;==rqcf7s@WBX|AQ8yzblnQ?s zqQxPwf(XG2%pFtW46(@7k-kM_sU0;+QyHT?=d^o~Rjy@LL3Y>lMs9m_Ywv@%8l)aCTZ`*IyOE;-Q1`6{w855GqN)c9> zpsU6AxAWb7ek)lwcVQ>t^cZV(6liV5R6WKKwAv*U1`sdQYL?8XK0dWF-%>Cq_z;MM zm{0;ITM!a`vQ$=(n4`Qm@Hh5Tcv_WG6p`ejiPpg`YXp-=mL#@BdfAZ$1M-45^?`d& z@cgVGA_4fpvW`Y>R&tNj9O@O$1+vl30|P9YJ%ycdbOpY7YZWN zdX}J{K05?=Q9C0rGePCRK@4NKZ_1#Vn}1x*{7{{8kyQw?`IKu+y86O5)~>_qdK1bK_tkBch;b)*m3zC--->e{?N z`&e7v&9L>nEdE!&s;-_AzQfE4Sq;{4cS#QKD)=1QUR{{M3p@0@*daeDs;X5;{KO}-!Mr-N3t??-YxhgH zh{xLI(oIeKN8%-~92Ia6jt;_o5I4{nQkK4gwBO0=8Ndr{54i6;S3#J9hSgjX5 z*f$3okGU}^gv@RfJ@L4cjaz>a7ztO*=&Gj!elHm0_k!H{dU$TM=;rg2f~x6C@%*Yz z9vofX5#Tw~rfHGA+orHuW4~BRZrf}mn$6iLZ>>c;kWAK3kGE-c`D|Qmf0=Sy<()tr z{XWnLyDbQc+am~(O)o~>(F`oW0Js%WHWG%`Jbe3=ofU}swmAe@MN~(%zd%`n*j>c+ z(W+A;VZZI)sb9;@=y5Ct3HE{`77|!);$}#zCC5r6F)ywY6xaIUy*w0$1J87!pAkI#RvPNd3RD+%IN<2;$u>eSIWIDH(*znbMYpL+*^Cwy|Ic_ zov1Xn-_6e?vpp~nlZ4Br3ZS{DVeQ8gk#`OPo)Tvbk1Sk&M^OVSCNNbKQx{=fFu*M5 zE{w9azcdixGi!82IRV7iX3~cfVh|e8 z+%fAmver=Pl^R&zI@$J;aYQ(}hR&6`|X^ zujhuw+$N2$p|0hvtQY^0!p(&wU4z$nSv57-EfDvK9^eRe^u}U|UXdU0k{{T$(P8wA z^#_Y68Rcd1WhxX99P8S(!{Ow1b5!u+y+B%SED!a<3B1cK^c0Ls!xEX%fUQlFswP%+ zAW{+sO)>AdcXxm(dTKjG>GD!O6rTl>JU(Y3KPvhXY4a;I7Bt&I zKWDKr^gaWe4?e%XA#_@fZJMLqPM!FVpw6_|d>bPx?>jT65BIH}N_c{k!ux(btDG*j z*NQE`PeXwPX-~RxxG$F`#~rFlNMpLvpzvMM>tJ0IkqWY@po0pM3J}!nx#iwY1njhKU+;{hv zyL!C>z<4W%Gr0iwn7sHNc8N6TOcf6>%*D(K4hM2#0*L5_u`n<^=)D-Hbo7(*<#|#G zsoAzmmkbe|CwPbw9(;t1!os!MpCOd80P4SxH*elgR{~;s1LUh0{9mlYyUY_X9T@#B zyiCVC9R%w$#`HVI3MFG+@}bduV}u?VKP{RVmtt(Ljm${aOj9^Xq%snEiHFaq!(8Wi zs%Puqp`P279NiA2AHcO3_>5LCF|YqK{*P20h0-3)xZL&Ucik~uQwB_U?`sc9EI5FP zZ&eV6o65^w@MvtG5(dZ~5Kk-8Sz=9^933wmf|D4D_a2V>uFlScj=M|ya6o<*s*s0B7*#ze6*g0Kn9-)Yf)6-N&T_H4sSbm8p8)4;``slQcO#%CpuJ+|m-?vUPbNXsi^7L45M9gRuR=DX_O!nQH~t z=mU4;KQOlm6p?2KCUaemVO(k<)UM3W@mSN?Ld8?R35Kc=R8us$RH^g`2w46IY`oF=D&H#rwAd84jMv?Z`F&rnfx6yg7X{JE+A&`7O-R-dxX9 zoDuPyGSs;jKD3+MkNV3h3I9X^Kjet##T}-|9})ZPbjdDmDXePhoLa}p$MHHdptj$J zYGd-WwcLlJ;VC96`|UwXM%-K2axeha_%B+jwWRDypX}#UZ>K19YOBvk@(NTXSLehT ze6LAf*&s`6Rt&;*$uH!qQk?Ajz7gAIPx(KiF044pWYNl7c%>O)=gP1rFjrx32TTP3 zZnSa>kMOi^5@)4l?X^7S@;o!noYQ4%(E9J;x!k!mOzw};qi4dOm2xMP$q$pk5unsU zHQU;b$s@+SY((!Ro81M%H1?2GNpl$}*;aTSqj}a(>5wyfOmn=_FjcJTJFf=prKJ?+ zIQx!1_Xg(wB-DcL!I9DVo*sybnRlln#J>2kX~L>~M#iyG>Pz!WS`3US!MB^7NvzB_ zVMZk|>HAu8WLo%T48a(jK--FjSy$yELmrq*qNBm%x-RZ+!$uGL&;WyBJ3?UbcYFau zvY*P6D0ys{kVAeqC6?>Ezp_A%ES-o*hMfsXGLN++h`-u|c>eS+NrO$FM<^e6_Xibo zq;89w@Kn&j_vDp@dF(BBuWn__I)7gpZ!IFm_48ixC}V}1Kji;=9BFGM2+VvO==-AM zk36L){zCUhn(dKZa>Gw`ylT0L@7K&ZYC5QEgGf=Q#F^BlS9APW3D?GGAXa@&MnQ+d zsbqY*`T%M6A5k=;+~#jmF&g z`e_}}v4gbup4$o^)6Z!6hvdRAe4oGqA1~*^rze%!(Yu zIh7JHj00^Q@T^cTK9?)NW$ed@-y2#hyvL0JbXLs#jn<5HUlJYRQ4L`9Vp6m=HR)C~U2-?hCJx9!% zGOqNL$cRFc@{if+kAGe-%SZcUXmLQEHwcWGc3XNUEYOs_&%t}GPR%aAf9}=S!j$N z3gtS)VT-uRGO}tM^vhxC{?-|jWS$;5=X;!Sg1j6KT;q>&g*?@R9Ck^k4FuN!tKP$) zqRzI=VS(PtCUBNUJ*uo-lU1Q?q@)&$E3YGaPG5ctZZdl{vRk&y2a>XxObom$aCTlL z6xj0!uPPAnxr2~`VdCocbiMT*)tF2gvmp4N1FS0g!t>gG+V+HhNa7mhG^p=EJZ_oYFxM%ZO1;RXD72KeNSj&uF8tnDZnXvJ42@1an)Hlo{ zye~yxiBtUfiYs_D=o-AAbXzjJ1aC-%ADI}9cqzJ2$%S+r*)0~$aLKOPpuV#sA!lYf z^xUWPRsFE*#NC<6s^y(z2k@Q@WMO|k zkgqd}sZwabyGz*M?VcY)ghdPrGhi+Z?E28~u{0@lRW;%>X)B7q$$!IpsPy*UgX1~T z<8@$6X*;0?E1^?Y2EWET_7jeCMY$b{K`@o_Ff-})JMgt;y^55X#Rf*6IX@T4k`ARU zbL@&FE2{7B^*Xi~BvO>~Q2v-_rLE5Vbz07lcF0(es!-mYn;C-_+1IaErAm?!KU8xw z`MZ2~wj)bkfXLD_*AZd-kKOq$QHPTm@sHafN(ZLm7&9_W z2d zW~Ll#t{)&lTk|Yl&EQ;`<~eHPfO(QwcFxEK7+tdEbQ-yBF5xBlk(E+$70suLUiD7% zDEi>47Zlgr)Sz}#54lCDNK#aMW0}m^l6cVr+4uG3l3FftB{3dAMR!rxX2L7-w=FLL zKP+HDBU!M(7IiAU1?3N_g$R-WBUE9AFYEfGSG@9?uaN$mnD<4x|dn1 z6uQF1LIKEZjo+{tcfs<5MTUN~{sj!Gt%ut=+vI=}zeMHOG|zJudg}Bo$Y4hDF2)M( z1`)kL(|FUI&{u?>eVAU-RV%`dZf2cbi+tO{T0GdkS#Jzj11h5*G;HCgoIKdlS8Fbq zqAhSgdyT&}?7(20b$m{Q=#ze#pbx>10<6)Br$%r(8MAvyZx@)MA0yTfCe?<5 zB|`94n>B*F(vLUR(8>hf9Bymh*G2`~4*=)^>L+f3BXFC#VZwQ@5mA-$+v2}HZ*Q@F zSO6uzzwHiKmFY-(era2yCT?Nm8+x?<30w1`L{p{%NL?`&T%Un}B+{Z!$fp?5m%>Gn z6J(*P<;V(=XWJ&5*yEtg5BG5V{WdF1q^`JK1%K*~%q^D6MKx*^#sb$iy?F!$X>|de z!Zi8-Pq!5cHu198VM4!3W9SBk=rh(IQEuhP+)leMthZhuBzAA%$|wB7swr#3v;( zN@0} z?FbT;s~l1yUrzBMoUa^?A>8zw-=bZhfsFNs;cK*i=*C)~ zc*%}sPe420W6lkvxt36W)eIax^n z?iwHK*^(%4*fAO+P>cOs5Uqe?yJINDEE_OS7;VlV?v1wWjqS;e!Oi3H=j%QKl0sJl zja6$E&u8fBJ=m`rW84UNy4I9Z0j7b!BDC)XWZj<Nkx zJ{y8PmshiAt8V^sfDNc9!hB+M@4D;QLrZr?>wq_m`sLgWy+6zo?d~Sf_j8lyq#m6S z(rY5E;d`hC#WvrJ|5+(J%;)@sx_-Zr;=aLL-Cuo4Sroah9{~?NYmpKRUbuGRRUkLB z$VPkzSbb(^Uz!=SBvpBP0S(-=IQOW_X+7ErEF-a>S>3cKBCuF;Q9*9C-vdxa3fz(OSjhSIRoRO`}j8^5> z0>*1`UPc5!Wj65nWM8M}-|q8pf1Y;OM$gwhv*Nm*ob?=xclmi9+z8?a1{R|_^?vKD z)`n}t=ue*V(eGgSK&Y`hN8ka|k%2Dk%tYNeJIP{AQMO(Y;a`cT+vD*^ws1RW*G5sc zBbm+iZC=kcV^V_Ni)V|PqOrnz{%~JUXDNR-CU4X4gQt-X)m1itqX-Ud?Ipr?siDO5 z7J`xqESk#sb=$(OK&-7j69ufdurFW^){7ZXfXC&K?vi4p{|Zy_Vh}vmOh^lnK~E0U z3=QNj<19gS_X9^0V<1BEO#7T@6lV>bKIa6a(s4DXJHb%%~ zOu`=dTV00JQI@whmamb%Pf6q`J+D;S`c5cRiNapA1v&r2mVpbKnky zS=M!Ib7I@JZQHhOI}_WsZA|QBV%xTpoA2&**WP!Z^A~z`RaaHl`@GeDqhU%4VdUtI z;SU$e8k-D{HRpKc5`2TSxKwVQlX)-494}6@fo6}QW>Qv(FMj_)FZhR2Q8H@1eDJd_ zLxThWfcoF`g8%1VH>CbA{{EGoz(JHXzS27EyI~b*^q@cxCtdiw4$}}r_#De$_ ztl7HPN9=50DS0WjWJ2LSh5WH%s zbiu|ZL=Woa0_7hJCVR1D{2_AkDr1;?R-L+B2~pt8++6%8^9)6qdIKtg<~Ug7U|{WP zNt`m#uY7I-LN+}Wab7BO=F(T&jDRiK-jB@i7eHfiCp1c6B+W97Y1$R0eFN$M%kT@u zqSw9@eK)CCQ}?k1ew zK^FB)CT(sJY+eSzqaHNX1@j|4Kr-U3BoYg@D<*wWcXEoVC+d^Z2EC80lHA&@Y5ctW zhl zT9k1}!Q7LWm|oGIADd+GIk>3*YbtNDX6F256mJl0v6B9Ft7SAt4L56&dhT-NdTWa- zLw&Blv;bYoL;n)TN$T6``J%Pe$Lr}$2SU4%WwT-fUEJRGhFl~QcgdLCE|uhK>;gGS z;~W!Pzt8w_Ca-VhGXOgcc!Q)r&AM^c;%Z=M7o73$ao=;{{$$>^y1kSr*&ZB5v8o<{ z81JPftfC}mb$@2W7ku`o%PrOk_QM{2sZX*Md4mj8KU9LuW_5W|AfDt_1Ls47G~iddkpg zg+ZuAkg*&3S$p!Jgh>d6k;Dl50nvw%B-ak@08)&|K92jG-5Je7P<7`r<4--K^VX3% zlrZ(0YR$PC>A1SFM*nXD1Yu+)p z5ZW_zFpi>+Aam(=-j!4L~240T|!=f|46JhToO5 z=czd6&G~!rByrO84x)6QL4fziZ3ML)J*tx`e$BN*)fI}kSkmlXrU)gCiewQwHL%Xc zHIhQAMT~3l<}7C&0^i{OUbXorE&hf^E$01!_vrrr@E#Xu3+w+6-Xjw);5dK}Bl64( z%CyO3FbtC zhWx9`{~nuEyC1VHv`N^0ablrr?0yNS3_^Pd^R`Qg5X6vf@G>9+e=;V2?vH>12J{h0 zCu$o3s#OYR=Mo67rNuFI;Awz6UbJt3<0H(BK=QJmL-$B_oiO$B6LoD;3e37dBbLAj zR#~zn?Bd>31mAi$r$VCFviGgGZOyyA{1Tb{AaR9_%rjM)HNo;SDev<84X$=6M>f_i zfqe&LlTqPD%sl(kdRtQ^-h1PTft-@kw}ocgv5`zABo~*NUI7nC{hK#L59aDwGC9sT zqAJX$IKedUE?!%(iSJl7;4_*UKkeXs&gRN`F_u_KLjFl3UUOyLcFjg;tij8FocTZd z)lxhJCOrS_R{x-*|Kln8*O?o-SXdkXW0QdK`GZt^a{ETDg3c;hGD$!k04v0;akFXx z&{EO{MhT;)H;!uIkSf4el-RWSe(xTEk55W^uqVT>C+@N9k&9IOZH~HYI6RddcU5C@ zC3|=ollm2}^4mA(Qd0r3qq0)l27ZusU93~QwIGGEHre@H4R1NOX6xJi^K}1hfX>d2 zw)Xq++?rL(&-*!`%AW#X8CG5{v60U&h-wUCTZRBpRT7Pe7(z6 zr(gA2WD2baVV!7xduniqm}tG8ZMN_GEQ zWPZIG@oTm0$#vke1$?9$CRD~O0$2OQsFWkt4R>$nd3@uSExxt1FTW!Ljb2N59k`V7*P<=}yJY;k;1-IRB)kP6i zB0XzyhRx`*p*@#kRMGM+46^GBlHhs2qYii_zh_N-BPUzK5HLn9U&v_wxqbpdjyJRf*gs@e?HC+?n{BSJ>X zqC)cXuT9D*j5yMY>rh;JPJ(QS|z>ksl8_U8Gt&PrPes|}571H6iTE}mWqgz(~!qZwRb8_+z33ByD z_yBl)4nS1369LC;j&meAf+@rx$>moOuVUP;zhllbPGnHy%w(-zVN{*9m@>n?Of--6 zfWClol&^@NXl#^e1*ghd5Li%ddS{|F8PWB--yAv@C()#Ud-4&Qo-5qkhd+2nr=z7E zrE)|(KLb#$>!)m%%hw_6tj_P|z3o7NM^dCnbSW5(uMhPXvyQC+s++N1rx0buev*Z1 zGE2t8xNZLXBU-?T%Cy6;w37u<6xm9Sgj+=DxNTtbBRbyewCg4D`*S@sG(^pcn97Ay zUXNM9LnD?h>{Si7)0dy%3jEugcFZ<9k7BNioEaJ}ALp3Q98|q<^l`+^hH8z$H`7TR z%GD#w`F4%u8^mn@1r(zZzXWB8b|d8=R(GK{0Wl!YA?Si>V-&A@75(7u><-iSpq$df zCn-sBMSo)p)B9J{L#PGhUUhg98;?z{k#zm(`d@ZbP!4b)_R(B653djc9CUIqliv;+ z{`{3+s4TUAi8#Rzjs}#~R2t2I*qCd_ahFZt3ZO z=L4#yZN=2}-i0!Kc{y38-R>L+jXAo{_vf+^dd8MN*OApysv013xT?B=R#_9g<{=Y! z*l;x7NiP!D(s8Xs0`${`;UbJ=p%YeUyY>p=XhUL29pfy@Yem1U z2I$Fp7CnlrCTUksDW8Yx0y{u+NV!2m6{7w8HDv7N!8NPP9saI%h~y4B$|QA5AxG(> zr0aLI(m1;7GnRX|8XCF_#r>=NCEg_-Fno9Bb!gthh-&0A?@C+tb&kt-b{#P0bjLJt z?cqU)b#oRNj;Y&@)D1p!!Rij;pc*kX_OYI1=%jjxWS+}1@`+(9UFuHpiL)8Cie^m& zPKcqQQ2Us%ocG3=T(#k`2^2OAdbU*o;@krGl*H~Ke&>7a^Y5mfL0w? zIZ@(fFy+P@Gyrgbj1wPP|ElgZMpu!SWF%-sncZ?eqVozHVm40@;8e1}%xIy4S z{UX=47hS3eTLGo7+3Zx%12(Kc0Kn3*o^p*&5ZY^-WA-<Sb&U~@=Q!9o4RITJD@Cb^nzAEAhhb;w!D}Y?U3?TnCfgu6J z7cX`veTG2w8YF**Nf9&>9Anz4ftE3yK8a3jGsv0{D+5Fm0WCfm3PMEJ^s6Nels2@A zL+!WZVx`n&o$)0Z2~FL!1bFaxaxm`_9f3q9j^9A*n9o49O05mV_e|i`-5(xyKO@RH zqP5Cx>ygpHGLMT*M8M}(^vIeiJX?nttYt9xnh+gp(sRj{TgdaSX3~&agv(6yJr*6$ z?6!ATAoNOssp23k{-h3u5Pxk5m1{+h+c8Ynw(@`ebS=q8V)*FOxk+lblf~h&n&`C( zQh_;2DrikPuBRbkou0T^I7a_fV({^I40za3cQ5FX#z)ZB^ebUg=x_ePHhmHJ%6&FM z6G!%x#G(M0gP!Zn!w~IMA+Ya{s2g`@Kb7g%vI9Nd9bvQ)kS0RtHlZ{pAw0N3!;fSz zo7j1179aQ#6gL6C3Pa0(3-0eP81u9+ePXSI*J5*E%sBO%2ZPL1_Xd2>mg|0S5W)D4 zQ>rNO7mi}5+JO2#umrRVbpN-35z(EC=>XsP1}|Dp4imr+(}tOKpkbK^GIeO@CZYP!s%k9_Mn(iAut8-3nPg0wr<>)evP|#g}qVD>#uBCV%xCBwCH>5r~hJk zPb3ixum05cT|XvW|DkIASH1ZIZZx$p`zbg>RMutJ`4N1c)uILCZ75t8CyZ)9Ngs3`&7f6q-(OX#Bx6Cnj$z##4>DA2iMU%~INyQRcZyN>GHhC*As&J^K81i;JU7==fl4K4 zURn@GS&A%C#NJE%RZWD^A)!hKbcWHv0*x`Ps_P0H zT5v|Acke;J%28mHe$Ww9Bx9nX&584uL8`<5CGqw`3LqW(X?UT3g5f_XrvC~C;~yhV zM+0ZO|4T8gR_?bg`q8%DqxOW9%k%0tCwrdcJDnQ9dzDirkxVaGipwLJ!l``wAVY*> zm~$ncN%cK7;`zcYxGsUpcUuHDuc3!Hwt!9t3`205WzTGlt%6IIhX{jCL9^C23)y)s z>vQldh&HvotME4^k=EDCf}BexcaL2i4SyU69~;@nkSII4l1s&Es?aZ!dc2#%s@fB6 z^pETxJtpO#B`3yf3i@*sqd*WDOdf;7WJag9P&;q|a;@tC&~YV_?FZ3Mq{mh9DhCb(9s{Z~BJ2ClNHIUoX;MJ)1F;}8X#gdUV#J~@pY&Q%nyHPBGd=<)Z zdc@!)8?af`o<`RJaC{FPdbvx)<5iP!;mO8F_;@UXF_*8&jkfX2aU%4+&*@$>3~+=@ z6*X)AO+Kod14`!3?kmlPWov7mkPLQEAr9@EIk3U@46t|iGW+(#LS%(Dp1J{Rsinru zHM70*`qV4C=!!|=T{hDH5gH1^W2&MU0mCVTQ~~}8LGYPgRUh%E^97G~&p#i=6anu| zV1RYGHPTN9UZ1s*_R3Jo*)QI-zH=Tve62#Tj8#iI+7}u zW{{#t*^7Wq6h}-ZXPEDTjVPY6t{kiL12p?hjtIw!4#p52&^{_+UC%rgO=Zf?V?9Pr z>O3BO4_ioRnL0-9WMF5Hq!N)`)nGtCeUg~9KP8;7ER}vkHg!~vt4-RRTdr!xgP4IH#{5(Fyk+(o2wVKq{ zWj1&)IBl&`%*yks^Dow4R=bFWE1E7|pyCurRAm7?YW=_4Ss%Lg0F;$ee95vCLi^JF zD2&CV9p1Ev=|ZrZS4%!N)*r_BelQk$mR42%n@=W2nGrM=)`9cxLnu+ZeHgOLep#$A zZfL5$E6<@~TMZT`XDTZk15}lrgT!&XC>f*eo0}$CFF-;v4Ag{fdukCe>l*Y7bg%Xx z)JULb)*5ob%2+9+-?!~tsnps&-bCsGr`4?9!13Hikj|!u`!IIsP01VwB%I_x$Y94v zJbBnSPYzO|CZFE6wu;(qwdBb&8!1~gg$wG#W;Tnhf>T1p(H+K^nS7*~fWKnqHy)Ef z?*wAw3yL!liwrtrjf-b-`4im_Ij0j8OP3q1ssK`7!3Lz*-03aPg&r)Xy}x?MNZr#r zWWJE@Cugs{xfCTUK9Mnx7H{mmlQPRFMID!e9#7DBQgE~gnws=|Rz(2GI(Ja0Kb24a z_*C<6kyd!Ns*OL$Lg}JZ;M%Cd)=}Dx7U`0v55Yel(&5Y}^ga zzTmWvbsw4X2XW-UVUKie^5Erq#(54MUz?NQODuzk>gFXIYa+yyg7hh9^f@yCFY+yw zWnsn6v66+Kw=~N&%1ll%PZAl=v3KHkHR#2|{e}Bhi$5G$X!-dSmo|)kGfKPS3Li!z ze?7=%9dT{63tX5sD+Dvw;~X>-ErQ6l(AS zmtn$lMkH3YuA1Lr1$Kbo|9A=0so=NLS!K4GV-T-nUfE-SK^jk_>7M%#m#K=l&?R#f zHqRsJ(J}vIB7{7Gq8n-}pTefe(3-&uccZmS2K&;Stl5~p#8O|=tsbj6Xen0< z=b;nvBbpt6<&MW>nN*K@oWZ3hM>NumBFY0DAUhzW->udq8hcoE z@R**g^cuPA`WG+?``75|Yf~{^X87~Apzt8c0T(t6XYI=^tA~rI9g6~s#+n)GGsZH* zgge_6=;Qii{Ff5h%YUUbIUq!QiyvS^;Ex~Oe*hc)mC`Jo>}>U%oE=RJY<|+3i|W6C z4ex3Q-7BIxz}>Kbj^r)+=Wsd!uImO=Ktm;1%`GV6j`JVy3P~3$7AaAD!o0p+Vw?@@ z7W+FxmdT_0J{m^FR?HHAe{BkA6fmr*hm*oj=bc=I)VJM%OC-40x;zA$0K9(P>|aT_ zCm$Ls83Cv0EdQy&>FK2AK8gZ4adU9!U#`7_MGZHH?g*Ib&j+>X<3h#9LO9!j-#`=K zydY;8g6|JA2<|^ow|ERqV#9FWVJ=LvzHduL%g|MkwFFI;uM?nOIc2L7sDv`O&egF) z@e=W#m{!yXE5Jp2hRmjVwZHQii!*_yxw1B6_j^DgSyhC;_|TSMrz6&#%)*n`dL& zTQ@n|evuU`;pmq~M8)*o&^$;a)ebW^HQtU_$ij+V!R0_1wd|$O5L1FW5gyq7zI3oc zIQe`Kq>F389S!2#UwYx>KfY9zH1HA1%=oGaX~|ab^%zCplV@-Nx|kBa+3X;K2q;%t zVF4Fgb#9F&e8YO-z zn3=5N1ZO4rW_a{izwhyZG5?r%1XrHle@N#PDx>uuBh}44Ua??o>)!?jW~&j6&@#hjQkCMf%hVJYhba7 zsRui6Laz;XJZnOY&BcW@BdK-M>DN@&pB&z%?3f9rQzIojBK>84ow4QpHppn#3uWQP zMIfO0Q+Vpo(-0&yYLKAK3UJ6|b=Ef-0Jbz?1UFWfv~0!rTzsh`eV$1;MLpowzfKnP z1m0>?w5rPEDUzKt#@EoX7xf*36h)Svh-*HU`(-z3Uh@t3?{AiWM*gtD?~qkL5qk48 z_WvIve|tMe=YO#IL#pexKhDTL%WBe_G{htg-9PQUL6sGX4b+1Hn`rAvR262Eu$Hii z0)9F3D)aZ&t_T|!t>QtxD1aHe*|au06Z5*7HaWt=eTo_$U-h?^Zchlucw*8umFjFC z@JDn{G(gUelC+q^`n&+39E8eE730_8;qQV1Vo+sa@;*`LFW0^XB#>ZF{w)0@*6tDw;m2!cM$3|m z?zMzUJ|X>|&}0lKMxY}?`aFoT392j%&lVgY`9Q#ckkgqRc3gE50Zt3%nIqfX7QVSy`yCrHstYiz;9FgMMm*f5?=CUcyJCM3sT%HFzDG+{H2% z%t|UzK{ak;gwYZmriUyP>NCG57R`5=C@eiGK+pre`w49-3eg==0wz6ljO+4u;Asm# zUmU1Ua;P4ZrjVX%NyA5Y2+~PPFJN6Y+pFVWZh+p{mJad6MJ9(*G(f=cPP>zCeH=PT zmxED_mDJttpFy;mGYb=_=$AIT+dIBr&_%#1yq!2~h2Z=?u>7 zD#d7leJjiEVxcSkz{gqsjP=u_fQi;xL^#Ra7?%QjMb#3Fh<2oDf3UnZjwDg3jIBC% z7*W=;y)9;$a(_yOykn}hDv_GV96szFPN;qUs@c++;%}W{0o5%*X}JhB^|4b2se0B& z-%UHMm7r_JfACyu={vHw+bZH{ihUoPF7DRxu=41Sq)d}iJ032a(SG%M2|TyW6s>)@!Ou3pFlRi-bf`y@xhDSHwKN0V zLvot(C6l?TB#}kTmDvRRzr*{VUsM*YEr6z<2}|bB1N=Y3+tJS5<0rg-tIWx+)1&yz zsA=~LY0?y3i;E}5vAScR?iaJJy8s=q)30o0x|=8NcWL&^;*u zd-m_cl9+dduFeJEo?O8^DpD=P$c3COaG=|*5e0;wZibHfz2fjbk++Ts>f6*M);h{V zu4j5JzXI>DGC;fsY!d!lA>RRI_pO(L`>VW)DE|d)GpHuabF^&Ss^?@u`j;2Or%Snc zi(>)@2pCkZ(hLwJtQV$ZU^=>E6bEHFi}@G>G&Q3OZcI0ozedHdBhhsoSozMS`PHVF zs90=q2fP>aZXlT{ai`VnpQVIaSux5e+Pu!+(r&&zG-jzJqU=G-t?c+B=uWlEE6#ym zP>fdv-}kSGDQf**csx zNO-sd#lWk%B@0oXnNNhL)e_B}Leu6W{Y*YUjB_{a3Ng|t6;^Fx5+Y&(!cQkE!Z9qA zF^9g2U^u)oA$OjPTxjX<00Dy$}zYG$c?2N2ToPX|lwc5YT0H5{xi{Vq`waTLm zR|4DlJB|5g^8o)E`#?YirI=^_mWCouUcq|my^bj&R#Z&ko#aROY~$MUdEOL@yrwFL zF_47h*u4@xJCbZnI4tQ-dx}CZ32c5Y&RUduiW8 zec$t5B``}SNPU_LQB>sE?hB=k;83N0r3RHEOB_pGzd!HPa_{Jyh|0uj^M;1#vAp}!)5p!_>-OyJS*|>4 zkWE+|K*}i}7L~*59)|yRY;Wd~%;`J9%k0BO^y)GfevNggwyrP(vv6%zY4qCxQ`m(i zT@zBzHWV#Fe1M#Y!#2G>0Lzu%JoWbQk=ciUw~09XdRsCZbZVTn%UF<-1O*sn2&F`B z)U%Tal!ZAm7T#Zy)p}3TcMT8%#9sWyMADb2fJ(3~NW-Hv?a+AZRoF(@T(cFCy&#{n z9e5t9Y#7SX;d4X+eT??ab2TIb#HQ&PPW9cl@Fb_&H4fiOogDxThb1t0?axWh4?%qD z+fZ2Z!kXBSXcxKj3;8fKiiRPfDjhU$z5om|<5&@O3u<3k5;J`wf!|Y`-(V$`iH(EH zh|zk?G4IZ?tXJ)lq36C@fXy!in1beh(IhD z@jJ<$E5NsgA9up5q397b-w_;H)$Br3@QG|vqoy*mpLoeNA1+*2<>@4CPUxqE;qt=s zcwnX4Mx88GG)GKJqyFp3fL=s775+Uk;T3(LuXP*HREWs4 zIWhwO!aIvn3iuNR43jo%XwpHaCO5P8C^l(o3{@P<3YHXHoe2<0UK;2e0f6*=4=rq1 z5*$A;Ew?}ug|Q7#cw?C_wuuw=6RCsO;^bmx0xZD36goi@)s1avpIgs@H3HoO0;4mg zYo!@IuV#0shN$ahLr5phuQei3`KEq(9_|bVO4$-y6&&Tif2E6zU%QZm&p_UuNL7nj z2Hnkb+gw0Aw%L@Vg_yuO(?mtR=T`u!ZlV!K`tabG&{?8%@ztqj=c`xyp~$OfC-FUv z+b)j7d({r8f^c5v&QyAw{&3bg5{Kgk710g6%uNuPnalxh8M7IWLo>hnsoxF2U|4Am zh5?)*a_bE@gcSyjfj;c;_qxDlIY-s%-&L*=!!gFmw$#E;@R3WK!`Dg$kqf+XnLOVG z0D!6I2fx-2m)iQ&s^cxFzHg2&!lDz8X^uCz`2$%rdQ5ilx5NJJ!!PeinbMrQSb=j> zU@zke`v4tcVrt1qDV{gd5)VB$Xap<3fCuw3(2(4k23{mvDV4wY<|2bX%Sc9Y+i`_o zCa;_cZxli(&}!m@(PPORV8ZgJYBK7*>wr9}YZzW$0GZ4A^{TtS3i=9E3%1Fq*JYI5}0d;^S0WxZ8sgV7%T^ zP2oL;p@o@blWl!oH4x3uylzdggB{IA`-u++(mw^Xe7WOq$5@h~v>|shwLpUYyPKuW z@17y+cZ%1nuXjd4o2?yy;W z;*Y-%5K8@r2J98Z4nBQjSIvZ`vzW;e%#aCzv9h?qQ4g2L_tpLL@ow1tedEo5T<$bp z@W;pgY43m>AI|srfx!yijO>i8XnxP<;RncEw%=dy)dh_dT7SQ0^B2Mj>SR#g>|O4u z%gaj=@3FlM;Q2pIk#}{J6O(?pi)x0$IedD0`>m&QxIwv`l7QKUGB-H2mbe2A2jH}7 zCVR*bU+$6HIz`r~kS#l1`YbaOG;%<$DGu@=Edkr%9yEbP(aT+M2Q_^xr20~j@Q z=)HI94JdFkg~akV^8rKvekrGmc)k!JPtVx<>IQAk_>i#^!C~geyHF(_mzD4`d}VHf zM{9wBLz&B#0e}q#H$=1Z_Bn?Wy`GjmM~+J9#%=zk| zFR{i?mGE6+9^b)o*)QZQuul`vrU8%2;_HqI|I9Ff-n&8wD~&VtdpUt;TxUGcC(=%^ ztUz??_kO|!QjLK#pcG@T2-Ar^hDu-*gh8NN#QTRmKAHuISu;X%cRcbY3FfG7A>Mak z6qYini_N%&8kCEVDGY7wq%*XaGxFMa0O(`TW%$Gmpgph2(5>;%Dtw}T4D}z9Q_GtP zUA4v$m-9LRFb<3|;%tBOX0;gO6=~IC=Np3=P^HkOYI5(e!{m@%nE&RCg0W;@Bi{pG znT_5YfpzTU6I%_<&AYZC<~2v(KVD%PX8}lpdNR`B4j#S7?Ibw~+|EtAT4gOh!kSrS zBiQAVYEJE_`X(ad0*M3owB3kk;rO=kcVevSO&j!W?a4_+=(ggt4 z9c#P05J>^EHKPtnvRDBF0K7Zg^VJgwn}Zi0c|ufm3u~Izbf!rHr>z5q(outX(gmBWqp=Y0Jz3RQw2557Jl6ouJRG0xOvL zj@F4PN;Kpnb3p=R=X*bc-@ow zh>4R&P&P4rS3|*$(q{_niX^Nu6!r636uWiyaCL})^?@6nhMRlF!agP0Mo(#RPw9)k zGBdWiiRswN;xXH&t4Sdq9fCpO<>G?DW|?}r79!3YBMXkoJ*m3t40J#3XKyISP23CT zn`#9cH3UNi+$z`L^Tj|AQQcxGvH5SK(Fj^Eg5)XyQLyRiLD4Y{%2@zr-lY1tBir%$V!T=9V zTRY)N<9%Pe=)9o8w5DXo#89wf>M1-jvl|?lo)cg!@6d;VPhjv0_97}hFch%7C`2WT zHhRe$UxSGzM5!)s;{bQaIigw6c5c7Go?^J6BdmpR zM9^Lt{<$bI-NtLgVO?vp_=ItniJz+4doQV#;%{c5T5Xqtva8x}eTc=4{w6bH5_crq zGnf(?vFKmLCK{(5$rMp(NcBz{krtmA!2Bb zLW0A^sVSh`MpP73fFoMg_@}k5jw)yZ8hYK5AuBh%AFq#J{h45%Y2NVez*rOxUTG(- zvg6p{p_$}mVg~N%?mD^pZ^jE}9PJSt9*lVWiydu~br%In$9WkXbbW`I$2Za0we0!? z^8IxdAb^ZAzdj;B&B_Hb6qT0?jR4RhX%|PNK(b<1*?1Tz;pkx84;l+ zD-AIuBd4$F3V zp{^zPL+eTzjLQD%X62Gzs%WTz7=NEPE5}$mIXX*?@XENTdlYeT1GbtU*kTaM)(6wD z3}^&JejpIt6zaQv<9QrSeSQMv;=>v(01@s3Ii=&9oz(lJ4u`QbsW4i-p>W<4n)O~z zA&JT!%}IVPLsRUGtOKv4m#EhKrHTXc-SL_OCz+kNY9Zpq-@xQ@g4U(Lb6LJY8vl3U zncr!+w!j@6kOV2NdTND5tQpM$sH0*(rm<18+)?6kS>Nbuoiv0@9xm(e`P)x-kheth?8f%hoRuW&@{hIxA+!{3(%c@ z1!<2rF>5`n<^+YrNjF z{55@Y8N@=L31#L>hM;pzzYp}$K1CaVNq9opp9kYJ%5+F%U_ki7d>2tU`Bo64sU6nk* znJ^o+++*Tvbwx8_Dh!>)YwC%tYi@r_$99R+5GNn`XBWg`(CzbeG87aEbYm%v>;*2R zFn&Wv(V#=vO~Jk41|gJ+ly&BIT^aGYOQYLC#L7JELvUmBPo8620&WtX#<{+b|HX#U z^~v^vKi#l_k8lGEdoAzdLM;1xnK%_{AQxpc0M*!MI@4FNU)iytY(~@ER^#J{w!wjB zo6V0^*YOR{a2C?F@+N3}gys^XU^ohD~&#CJpGUSHV zT*9j12h=Ew|E=Wq^;vpzoETer?RT5uZ%j9M6s)w|OkN((5XZ;KzZ8@VTcIKXk}g|j zIh2wZ3G1ma&*6_Gz@i5mZ(F5`fR5W!5)c8mNtSThNonkQ5yBkO7ho%H8DQga{#>lg zYJvMA1Ij^RY}I`IIg=>}1G`{_wYAW1QxEF262tRgr9$^q2jQ zy5VtZLD4UA9ufd;M3XodGOmU5KrqGe9Eth0;D*l9_;!*cX!sbxjnEl@GWqL`rhMvY z#o2ZQ4z_2U9F|EC+TG{8J&rnS`Z1$Is%7s|G)<~~@k_QIorO(lNTaRs;_Qaa)JGrI z;S!Hy4Zx1&717Ns*9XQadWMI`W24#{mY2R_m+yjd>PA_?hGJeAc32nCQYA@6kmKo& z#9f$eEuseKw2r1psZF+dn?~R$w^Q*uX8^94$_t6Ppc&h4IBEK4n03?P_U4k->I4~G z$WKLq`{7hy1BN7%@Z35x-PZ^X=xzrQAVA=EZ{Llc8wfBUqByKZ({zt9irsWiQ0a!$ zsX%=qBbdNT()a99$S9zGfiFl`szoQHOAxPVIK6>fyRD0BE)9lFl(zvk2YG>a3SAbO zM#h9j3qCu$j-fPwa@7}Kc=KKd<-NVb-MNXN2>>p+MasYoc<^{PVT{J?pTrXD11Fh$^uZVJLkojKlhnC<9R@+~ew z_!X8C$TEVZMpOicqY#tdkEG7GPw$C{`2%azpuZIDqetDnY}8QNBv(1_G;YCvEHB(e z&Z%?c`Y?})WwOgNeKwGWjO$K3)FB^rrEpEJCsJhGrPqLCAP2fJ(Ms~3N?<-$`Ppht z71^1B?Pc+%4zpe|*qbQvFjD8J&okI}AhgNIa;b*ypX zb}c{Ln#g~Xcf0{2@w~|yG#`iFtBEi`dWyDjj@#xhYD#MdXYkAroV>lw`}C)Mi3v5X z1Dq^Irp*eTYi(!RX26~Vfz2cdIR%82msF-&u7W{_6V%t&j7&{0`LLzxetFedYUiyY3!IpagaO zxfB5h002e_0Pq7*1~C3-FzZOeLQ7A}NNa52YidU)Eg>W#t0c0ispYiJisn00 z+h=ZSc7dTO(P-ng&f8u;Uy(VEF}5X*M}U-6M*xY2Ph;ixnFDQ`WK72O-jXhjB{A6F z-|l_P1@2AK^KjgedMFzK-=UnXRIBTLmpjgB!+GoaRf5nvW}Ebczt!V$f7ux2IxzeF z^7iQ4n=7?uYJ2hIGN9GITx-Akd3pBS+@`w~?&da;IrO<_+m3d9t-5F6qZPh*IkLDp zHNf@JkymPqcK*J&cMSd!3gXR#&Q`IMjmyu$=6Bef{)#*mygpWfSe=mlYo{ovp&GfN zQrMy+QY~Uloq!v0obSDkZ!DSppUP}XFEAg9fMEwA8!jt4^LJB-BE z&zf4o#Rj9-?>P`fT4r;>D+jL4!XnLO{VCm5BoRID=Oen*rfk6by4|2W2YX<393KGN zhH=mce8)mgdcpGkWaQKIoUuc{GzU^zeVVU{Xw?ngERiTf~i&c_0r9s(1289lj@2HMvvB&8Uz-#%7yqd&cYpuAoZm`Sn!h)YrA zb=pU#0a$bTRjH~15XUOAInD=v%-EOnGY zcRb0Ef0>>BIcZ-D7Mni~E;rD1-U;E91Wzth6XNa*WHp3tiQ}_j^JoNA0i#XqZI6Qf zB&PH&x5sOTC7tQ5G!tFaxlgc(dJ(2LzZF0<^ur%fRunO>sB=z2Jfq`kI(lfw!b)TE zruiMkhPY3iTSJP-mE>zczeHL8@Q(f=Sb52~l;kS$kd1!W3Kx!Gp(z~Hl(+=TBEP`R z*yPw%$pg*yxhNP>QiV7TtV=NLR%{#YV|>n z#Y;<8kJZ-psmif2ZD5{I&=5#QNe=)KggB9=j&TQ!6JjT!@6v_UPeq>$Q~~&M_zhI>i>uCv z5YD~eLW7`RnjIs<-v`At*=Jk7(}L5UQv;)ZqEeMrF{t}>^}=3X1Svs_ZO;^Z^*pO7 zqoJ|IpEtiyfpejU`<8Blq^Z9|sfQ5g1CZ$d^mW!@QEgou9zt4LrKLgXP*NJCQ%X99 zW`F^tV<>4Alx~p}q>%>cZbbnJ326xl0r}3{dzH&v{Py#lXW)vdxv_7lNp5J;f1@*NK7nh!l>em5N@+XO61ALn| z@{Oe-_EFB-=A6PZ)-nq!C#1q0(sT!qF%+swH9dA@8DYoZ4BVpFClJUt2lA&8n;P8NHI=MCzOK%11JY&bN!fM26xlx2Y zQlj#j1gkMM;zbXWr1PiR7mtJNI+;=V^H8c2XNR#_pXdiv5Zon4T40WTI^2Aw^tx-b zDpBE(2RP8L6^auhQK%W-pbxy|pe^1)s`JHh-Ip-jk-HyS!L}N)>ePe;8F!RIElT;( zv59|{Lh(S|hkujaH;bEWf6ClzXO>aTdi`aI-*RSjJAS~vxEl%6)V*3eub{UiBg{m4 z2W+I0r70@|;Hq*>6nY&3cjx!-G~7UBlsDNY`5_6&SyF#&CQ0dMM#c6!Dt5i77YFvc%UJ^bc@m+fx;xs8w=2>Jy_s27xip6I%Ppi; zWB8Z*+uT*@%x43K2*Tf#+A=QH2M>OF5pdOK_{yPC}!M;+I5wc=oFU=8*e@)Y3fI-cK>qRv1u zw}gr58O+h(4f9bBEN7U=m}b)RW*!J_zQb=)?oT;N?n0>^aq2?9CuL*!EK_lOyGA5ycva32Y0E4z$z*u?oo6Sr5{mqgN-Q+!cHZamld6olVgw2cK)D{Vrp*4+NH4;=me5%U{Y$K#{s za&Sf;DQr;25vcb^0dIE-h>cK9$jsTd$+_xgk#6a5RY~c6U19!)CnA|gr=e2NN1f)+ zN7hzQRN?)`Wy^nIeb7YcL{Cp9SXt{PhR)HNf>gvfh?H=Jmhc76^kepXPgw2z(Cl03{`8LR#kQJw{tw7q=>~7wP45wj8ojx(W;~@5acs0j zwb`D#HoofV(e&0JqE6G7&F{capW_VwOo!FMf77ZF$@kq#o&wWw5R2wrMkP`yXLVA? zRge;UVmKMC7gnip-*Nlt<4NS#jr9*%XWm@zHG=px8GODme=s>-XC&UcmVV>r^#eau zj0U4A4u=mXKbkA!x3@j7;CdZ8HW1#tsdaPfeYL**QB_Gx@|B^c$4Ymm1&8`^+=53P zkp^`~^`iDtaP=i!=IDt1FrCUhZmE!`q9_M-UUe*@q^aY16>ZNQSleXz%G%C%*z;2# zbp6x^H$70!X&9Z2uQs!H_llMw(q1mPEM6Rv(H-7(RLacJ0U5SAMr>rOuKQ@IpYD=P zXy>y>xKA1=%G5aR?6$i%8E5(PoXR+a4n2eFrQC1xiYQt1ccA94r4&uS8JQNl1Cvag zEt47T@TCa5pjjgsoE%)^f$7V=W{(fz@<>T~B z=H$kBeg-LJ&aC;$v3{!>vhEzJIw?pVMw$l^ssj?IyR+A~jvnz@V+vYvQK~i%Ql|v= z!uv|`*_D1iDBR8DH1$)n?apW?oHsr&yhp8&5Hp-Q61=v`dP`*EX|2lW_rtPp?Q2!d z61}Nh!dG6&EiaU%S`;@=+DN-2tKKK;DSqG`n%0>?b&5;uRSLN*TECP~oEVh@4QMy6Ji* zP4O8SjJJh(MM05iI*VRPB{qu{=LFbQ#c04IV)o9tG1h+7Dp`JfsQ4R}amRS#a7_gp zjT-fb;qY6j_iab*6VoYB7$vo%`)}i^MU2*LFU@w#2o52!J+&k2J`suNh`cLf!0+!6 z&!?k3*noDwDOV_?+M)5ta4KPkr`BosMg3>5w>@t+_Fgp7`Z=lS&!TKkzwJ#|m70zE z${9i`x`gAR;MQo6fggR(n^l_D)zU&zo& z-Rc;#|Iz1BB}XSZM7NFA_GeEefjrt!PUk`hgRsABu!?@{Vz;fQ)MR!#1Lmj)XxTA& zGCu}C;#mhJ3Cq<-J#!;pX62QG794#iUoPBu@y()#G0)Y;-X=iHmUf+&d{~vC=$-1( zsG{=@4AXkM*A;~41i|4O(*9^B!HYR&M0c3~u=efN2=Y@zEnZNxVz`Hkbdw9i)5lrzEfZTj z!IN3x2-J8Qx2GfAOP@p5?@zUO#Snd6?$~Lw-Fg`wnycI$XJalf%qmAQOD36Sf+Z;X ztOh-_HaAvsaV0sBz!IJAGgaiFFN)I}b%NT!MzTqPQSZ}{0|gNs0&JGUrE%8P-WgfE zLiTZ+kZLkk7Dww$Vg|R9K}9P_(v=2KE#-|01&9Qjdc1x=_F`G<-K||>g^xRylkfI- ziSujpTR4JCk@}9h-tJZPb6#iPwV56uxYy$O#v#H+A8K}WtZ~h_)l1-W=G(pNdcUU+}M`9?x`**uL*v$zm(cB@`bZO7Oyw4e+ zSpA|rb*q3jtM+9_hebTm^?>z*H>qh~c*2W3Gzd%!CNor*^Icb-DLX$F5)e z3)mbsWLX%``f|WAb4;VEb%WHK?@)lq=|NR==O=|9gu6=Z6-)A>QD%4eid2V$!}RE` zEAihc?|#A$G3Vc)#}V=`K2xc5mB39fA1cRpR!q?c^Ham*q-sr_=Ud-R;Xf6BXC8z+ z#cTXrm&Eo(vp)aFV6M0vw4bNPH-{3Xqy*lpQe_s~9N2v?^(54XlB-7^v#fjZtIkiT zuuE({LlH4EmE^KC*6M?hV4&EA?2c^R?wqTt#?nv94aiBmuIV}dAp-yXEq%GxtB@ny{u^y_!Y6JRR~N8;QpMruRdt7jH%>Ru)?&erHLhq-bz+ss&gZE!jaM!* z>7FL(E+;#?2fd*tD&i(>c;02jT9H`ATTRZF2aU9%s+%aSPRkZ;2W{6c4;GYc+i6jl#yNaJ@@;zbY?6XjaQA@I%ZNe#mW# zMQW}*vLKCcD8b~n7vgfcH?l?qopeNEfv{0q4QR%9yek#}J$yH3SXd`s*IOJl?}ev4 z1v}oXvz?RJYxiPTwoYnyDq8hC;*mK`#bbHC#{LmShf(_0!{?DI!Ag!EXK5d2agQT8 zf}ONnV#d=WG&@g6{DNxN*g~9}-8c=RV`s^8MY4W$MhgZYwQf$thN=Gw1P+^!E-bj4SmO28EH(Nxl8o4psQF zArL8%gb5gg4qWtqHq6Dr(Z~+`2yDmh;_jl*tumm@Hjj*ef(le8KLgH)x&lY$DgTU8 zmzGpfmvT+$j4RY3lwLk%%OZ0?yVooP3ySA8nM1{3N%4QDBm zMg2asr6ZWcgvYS7#hUf@X`eR#jYaj6}Yv66ntxe4=i6R;;?!e!6sW6%2gl7RJklq$Yh|C z>J2uaKD>>?CM;d>XhXbm7?=Kgu7&+i4Rp>UX`%`lN1s=Xbx&CMhbUV2FjP3{(LXP^ z^z+m_h~nbHWv+T0Y-ZRYG=eF;E}M2|sX{e-=^cBFSZgyKWr=!MPbH`fmBGBp{mj*0 zH8SX+#37a1`T!GRVl|A@^eyUGGEkrAOjY9%L3~8Ng zl-KF;)p1s3ktNv(al<>B813%j@?*q!>2NbWYdW2nvys3;E$QnM4=;V#n2LlPtrS>E zd1@US-De=}YB9GXn}r^k{dpixTRdr9M@bpkk#Db5{-YYowS#M&_@c;)Ox3wr&EQ;T z`|FL+3~zsN477t1K~h5{?RCd%pof~MQ%`?<_lyHQW{zC+Jj~#>>?vZ-70XDu@dYO2 zz=N69rq^1zn6Py0MNV{e(FwiFpQy*h+ZU=mmRp-q6SiWiC-Akd_3rdoR0EZ44E27A zNLa1;jAQL6T1LF3G`nYo!Z9a94>M!skpF6&F+HRp_2KcHWVW-v9HGZ!R}HF-ttc`x zO84v=pL^e(IGJ)9dDng?AdmZKS%++i6R}hlQgpobzLEZCwAU4b%0Ovo*n zAnUEQq%cQCN~4d5dUEaXbAzp?Ug}bK-a*<}{oUxdi}hGRr?Zj%qQx<-)joroZ`N_B z9ErsnM;iMZ>uM?I^-sMYURz^DN#K&}jd=8IX;n}uq9V;Lkh`I8@}D&l7mYBJ^Sz%rUe2g+Ra>+|)go}a2zAHG}t z`9dz77Ozvi-W^GD;Ki%(pa-^m=3T=>o|J(#c2QP5tn*B(Dk7nBcp7%K?^DAwlA9wJ=B*TK=TV_X44 z6jeCebj}nze1qSQigBzy7hm%gd>l#YcK?O0W}JAa6mqAashPz`PYJDLC5T9Sq0Ril zGFc{SC;3L;a}pMiw_dR@NMpjBm#{pK)4=xH79(xq9jt*lmd%$u2g`vRS~p#BKQMku z(5>m|?18e{)tJBiCX1$6RfPl_)jghCcuJkQ)r@EPi6@m+OvpX5b*?A-4rp!lD0Jzz z=bWCD_?=Fn`C>zi4kc_Mw=jFf487Zk~Fe)E;DgrvJ`WIM%&obO9;Hcn5p4ReQgg zXr3ytfQO->VS5r2l*&T7KoTjac%%|7qu@YNwa+;B#$k%Vhv$)luVZ?=GkElL zBV|9$^r`>|nR}q5XFOI3CWKk>m?Y-q#LAnDt3E}0kM%a5@V^G_OVHt{m%W^?SJ!1R zX~EoT7sLIUj|uh@SW&?xva;k!7+ly#Kdd&}2(!?U@`(O1joC7=T4rUTTlkbpK-kpq z>9<$d1@9&n2;^GW+UX8I?EhSS$RRe4ja_HT?Q=6dLAhgEgT`h`hWo%2M_wG;O@-*q z?WRQJ?}<%kEk1|ulb=qP6f~Kl9*=p9Hx{NHBx%$ZefjoCUu6++Wtvxl7j5C zZ_YsVz<%`9%7CfEmV%MXSehfnZacki33vDUeS(J>+MQ#rT5>`KNHM;F^D~JiLrfnz zE5s=(TJ>bTsj;BXhIW#~_%a(ge929u`9y*aWnJt8xA9n@RL_^v`0nM-ZhfuopEM`m z@mVV6tm#=YXNW4J{g|(&mf%>!;(fb9xM6LbZ9$tb|8|BmE{2TBnZ$ z!`cMDcJatc!ulL1n$?f5Rb*ccKqsX4eG6;kXqsV(EzgS};=aio6PFc)`8W!#YWRh= zKq}U_d&CP|rN~}0a<@paCbLe#^rn<+D7xth`bkvM>NJAp25aT_(YU2evVDEoFt!B= z200sFomz;_rXx|tZE*Y9yK@;gw#J5zPX{K;(hiU6^cQh*;?}2n$;8t2bx5ABZmizKjD?arE(&O~LTmTqXIBOI zMk6ehp5IEwRTbGVsnQc4tDx<(Adf7M#0u@~{kZv5OytWZ`tBrF>)NS?EJid8Zf{j+g8V4)tzs2>W5aj_REFm$-qV;J6W(eE44 z#n)3jnKHLsz{B`{lsJ!a7--I&_a(72`c-VKXVZRy%YEu6!htXl#{spI*X#5iewtk{ zxeSI>BViLWBd6t)?dOIhR3_*)8~1V7{R6xcCe=OWHhL-=MikqV*|N}y&mzVAI@8iU zRVgGgL)>oyO2SM#8o5Roi6j%@i|A5OPj$t2tiHBkr$8bYehwVh&g8}g4k{DyURkha zJVMppQ&c{ZFnZo>x+fxWn2AGOjroIb^k;@o#G>1Jflf`nj;U{tVVpg4p^EH1rQw+N zHIGn@5})B-5hY=zhl-j5OqYb}uo4h<^T0&!)G*<3ScF zcYyzV4wC+yz4s$$|2R`2z$Z#KO=UUWlkmfk+s^lAPxvFajszn$1M^0%uCA4vi@oM* zsIm{Do=I#PvpwtJEB=~_?4MT6B&vLCOz24RF$rTOk(vrWR+#ui1b7&?ihxG6bMxlI z4}HDSal+SzG1-^R49vJCS1XowtDhH>J#?hI<$=7L1+K3uia0?EY2mo`)8dvD(_Ixk zQf;qMmGV^o<<`h}7{%`Tm69^7xR(Ywu`dTt;-tbj9v>$ya$(&OMy_quYW0%&VJGwR zp%}_e5|vwYLIG4n%NzyiR(Z`zoU-o>h5zZ5pI6SVEuVrGzBe3gsabeT&z~iXwKZ-Y zzGD8t=JO@WSHIi8kQJxi&LXc0dZ$1mQ7cxaYcg8Q_^fB#J$cD0`R8sFa~MCNdnlqVuAl9`G2DCX!8G;6Wn?~50x}(Vn%L-|uQGr1C4C_UR_nR3ZWRQ@aDSDG zBkigsTnttA#1a!RlV1_+Gg9?kMx9BJ9Q^_2W>_?86+W>Ttu;0s>wZU8@ucBV(noTo z2-&tOykn}nzL|_&r0LT3h2LEHVppb-&;gDjEt-y)-Fayz;TX$_lKVW;oEnsQ3W=Ybnt*cz{l^F4XZux zZ{q3#m(D@#o9vYTVj6fNO8|DG;Q#Ik0%gPQ0;fv;`P*i8)?f(y_#k3$q}K8LG2m=% z7NFTfbfLF6Am8(=w*$o4#RT%#F?vLRuI`D|0Prf25%9*vKQ99aK>Y&%L!p1GJ|Xrd zEEXKV0<@yqfv&*2$lom+CPDqXw~HP8{QkeY%7xKr=%6G%kOw;G0vB*%@^{OIxiS9k z`UnhlwswFZbcctmNjJxk73jnUTyWX8Uo9KwDgg2y=fMGgj31*IliDT_KY!r4{34-5 z=_28m5*?xqA^O!MKf6a zEy9H3?)iH%5*FS$T)2Ae_uIunc-Qmsd_7Cf|unG1Gy zIT;pT0#JYnY7ESBxLV(@mJKVQM*6k>{4=V*Y9=BC9(K*V2rT%-fD7(lbj>^uBIKXC zc^O8MN8Py+2$LgF_AV{}zQX^(0FFjvz{m614T32GO!Z~}aM8V%Vu*~t>+fZh4fU&j zx_~7-z)Em&K$Fsl6e!r)!4-OG3B9IfhT;aq`VKJVFB)Sjhlu&Rlp`AR78;^%3`rq@ z0=1lz7tt6J#s54pK_G4*NEf}^^6)>HOG-LC(19!NP62>lsDTJw z98jk@BIEC>j%dk|p}M-}ETc|1kZ4rEw7gg){H%UcT%aZpXSj0H|10b?vAMjD08%q> z(E-=5mJO4%zJz3I;taNOad9*;H*s{i^e*OPV$ePpC_C7Izv2Is_|>vuKQ0489IYJz zNmIyWi+FmuYf}v{$@KtdUo5OskV|a)3-w#$!&8?2#NmHfR8oE}FN20K)PRUVfa~H7hj=Ig1)d2A3oG2s zqFRpw3W0bX*dX3;v>_6Jk^H%;S}WgK9s$NO1Wf#kb1gR=!ID4T4$q;gU$qA!H33BG zV#tfK5Excq6FV0xGb^we;{7Pxx!OmIX0L!SL4k+Ci_X=^K>+=sIR8~XU=u!6K*k7q zAX3;15h%{!ON$WP7Q}A}JD*raP={yn72c5R)rxQPD9`n87(5r(+Q;2btc z@<-TTTMiIOh`R#LNmitPBwg4efJj8#9Po=+fmHry;@?{ZR28lOt1kSZQ5KX0+}Zju I0)-g#KhNfV%K!iX literal 173568 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 diff --git a/salt/salt/module_packages/docker/websocket_client-1.8.0-py3-none-any.whl b/salt/salt/module_packages/docker/websocket_client-1.8.0-py3-none-any.whl new file mode 100644 index 0000000000000000000000000000000000000000..a2d768d7937a90e7c5ecbd51c1332b00c9e3cdac GIT binary patch literal 58826 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%0DCms_LKk0sdE$TuK|H_S+W&{PH9J=l4HHq1$`V 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 WD$1bVxG Date: Wed, 7 Aug 2024 16:21:49 -0400 Subject: [PATCH 011/303] remove docker 7.1.0 wheels --- .../docker/certifi-2022.12.7-py3-none-any.whl | 2469 ----------------- .../docker/chardet-4.0.0-py2.py3-none-any.whl | 2469 ----------------- ...linux_2_17_x86_64.manylinux2014_x86_64.whl | 2469 ----------------- .../docker/docker-7.1.0-py3-none-any.whl | Bin 147774 -> 0 bytes .../docker/idna-2.10-py2.py3-none-any.whl | 2469 ----------------- .../requests-2.25.1-py2.py3-none-any.whl | 1817 ------------ .../urllib3-1.26.15-py2.py3-none-any.whl | 1817 ------------ .../websocket_client-1.5.1-py3-none-any.whl | 1817 ------------ 8 files changed, 15327 deletions(-) delete mode 100644 salt/salt/module_packages/docker/certifi-2022.12.7-py3-none-any.whl delete mode 100644 salt/salt/module_packages/docker/chardet-4.0.0-py2.py3-none-any.whl delete mode 100644 salt/salt/module_packages/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl delete mode 100644 salt/salt/module_packages/docker/docker-7.1.0-py3-none-any.whl delete mode 100644 salt/salt/module_packages/docker/idna-2.10-py2.py3-none-any.whl delete mode 100644 salt/salt/module_packages/docker/requests-2.25.1-py2.py3-none-any.whl delete mode 100644 salt/salt/module_packages/docker/urllib3-1.26.15-py2.py3-none-any.whl delete mode 100644 salt/salt/module_packages/docker/websocket_client-1.5.1-py3-none-any.whl diff --git a/salt/salt/module_packages/docker/certifi-2022.12.7-py3-none-any.whl b/salt/salt/module_packages/docker/certifi-2022.12.7-py3-none-any.whl deleted file mode 100644 index 7f561460a..000000000 --- a/salt/salt/module_packages/docker/certifi-2022.12.7-py3-none-any.whl +++ /dev/null @@ -1,2469 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - securityonion/setup/files/salt_module_deps/docker/certifi-2022.12.7-py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- - - -
- Skip to content - - - - - - - - - - - -
- - - - - - - - - - - - - - - -
- -
- - - - - - - - -
- - - - - -
- - - - - - - - - -
-
-
- - - - - - - - - - - - -
- -
- -
- -
- - - - / - - securityonion - - - Public -
- - -
- -
- - -
-
- -
-
- - - - -
- - - - - - -
- - - - - - - - - - - - - - - - - - -

Latest commit

 

History

History
152 KB

certifi-2022.12.7-py3-none-any.whl

File metadata and controls

152 KB
Raw
View raw
- - - - - -
- - - -
-
- -
- -
-

Footer

- - - - -
-
- - - - - © 2024 GitHub, Inc. - -
- - -
-
- - - - - - - - - - - - - - - - - - - -
- -
-
- - - diff --git a/salt/salt/module_packages/docker/chardet-4.0.0-py2.py3-none-any.whl b/salt/salt/module_packages/docker/chardet-4.0.0-py2.py3-none-any.whl deleted file mode 100644 index 3b4094eb5..000000000 --- a/salt/salt/module_packages/docker/chardet-4.0.0-py2.py3-none-any.whl +++ /dev/null @@ -1,2469 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - securityonion/setup/files/salt_module_deps/docker/chardet-4.0.0-py2.py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - - -
- Skip to content - - - - - - - - - - - -
- - - - - - - - - - - - - - - -
- -
- - - - - - - - -
- - - - - -
- - - - - - - - - -
-
-
- - - - - - - - - - - - -
- -
- -
- -
- - - - / - - securityonion - - - Public -
- - -
- -
- - -
-
- -
-
- - - - -
- - - - - - -
- - - - - - - - - - - - - - - - - - -

Latest commit

 

History

History
175 KB

chardet-4.0.0-py2.py3-none-any.whl

File metadata and controls

175 KB
Raw
View raw
- - - - - -
- - - -
-
- -
- -
-

Footer

- - - - -
-
- - - - - © 2024 GitHub, Inc. - -
- - -
-
- - - - - - - - - - - - - - - - - - - -
- -
-
- - - diff --git a/salt/salt/module_packages/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl b/salt/salt/module_packages/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl deleted file mode 100644 index 87df81cbc..000000000 --- a/salt/salt/module_packages/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl +++ /dev/null @@ -1,2469 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - securityonion/setup/files/salt_module_deps/docker/charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - - -
- Skip to content - - - - - - - - - - - -
- - - - - - - - - - - - - - - -
- -
- - - - - - - - -
- - - - - -
- - - - - - - - - -
-
-
- - - - - - - - - - - - -
- -
- -
- -
- - - - / - - securityonion - - - Public -
- - -
- -
- - -
-
- -
-
- - - - -
- - - - - - -
- - - - - - - - - - - - - - - - - - -

Latest commit

 

History

History
195 KB

charset_normalizer-3.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

File metadata and controls

195 KB
Raw
View raw
- - - - - -
- - - -
-
- -
- -
-

Footer

- - - - -
-
- - - - - © 2024 GitHub, Inc. - -
- - -
-
- - - - - - - - - - - - - - - - - - - -
- -
-
- - - diff --git a/salt/salt/module_packages/docker/docker-7.1.0-py3-none-any.whl b/salt/salt/module_packages/docker/docker-7.1.0-py3-none-any.whl deleted file mode 100644 index c324efbd08e43702330255be41022230df757452..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 147774 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νsv=4VNYjF8rcz{%)OXa%MGl~1G&aaT9M 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 diff --git a/salt/salt/module_packages/docker/idna-2.10-py2.py3-none-any.whl b/salt/salt/module_packages/docker/idna-2.10-py2.py3-none-any.whl deleted file mode 100644 index 7dfbd65fd..000000000 --- a/salt/salt/module_packages/docker/idna-2.10-py2.py3-none-any.whl +++ /dev/null @@ -1,2469 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - securityonion/setup/files/salt_module_deps/docker/idna-2.10-py2.py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - - -
- Skip to content - - - - - - - - - - - -
- - - - - - - - - - - - - - - -
- -
- - - - - - - - -
- - - - - -
- - - - - - - - - -
-
-
- - - - - - - - - - - - -
- -
- -
- -
- - - - / - - securityonion - - - Public -
- - -
- -
- - -
-
- -
-
- - - - -
- - - - - - -
- - - - - - - - - - - - - - - - - - -

Latest commit

 

History

History
57.4 KB

idna-2.10-py2.py3-none-any.whl

File metadata and controls

57.4 KB
Raw
View raw
- - - - - -
- - - -
-
- -
- -
-

Footer

- - - - -
-
- - - - - © 2024 GitHub, Inc. - -
- - -
-
- - - - - - - - - - - - - - - - - - - -
- -
-
- - - diff --git a/salt/salt/module_packages/docker/requests-2.25.1-py2.py3-none-any.whl b/salt/salt/module_packages/docker/requests-2.25.1-py2.py3-none-any.whl deleted file mode 100644 index 68e34c862..000000000 --- a/salt/salt/module_packages/docker/requests-2.25.1-py2.py3-none-any.whl +++ /dev/null @@ -1,1817 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - securityonion/setup/files/salt_module_deps/docker/requests-2.25.1-py2.py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - - -
- Skip to content - - - - - - - - - - - -
- - - - - - - - - - - - - - - -
- -
- - - - - - - - -
- - - - - -
- - - - - - - - - -
-
-
- - - - - - - - - - - - -
- -
- -
- -
- - - - / - - securityonion - - - Public -
- - -
- -
- - -
-
- -
-
- - - - -
- - - - - - -
- - - - - - - - - - - - - - - - - - -
- - - - - -
- - - -
-
- -
- -
-

Footer

- - - - -
-
- - - - - © 2024 GitHub, Inc. - -
- - -
-
- - - - - - - - - - - - - - - - - - - -
- -
-
- - - diff --git a/salt/salt/module_packages/docker/urllib3-1.26.15-py2.py3-none-any.whl b/salt/salt/module_packages/docker/urllib3-1.26.15-py2.py3-none-any.whl deleted file mode 100644 index 686d9a9e5..000000000 --- a/salt/salt/module_packages/docker/urllib3-1.26.15-py2.py3-none-any.whl +++ /dev/null @@ -1,1817 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - securityonion/setup/files/salt_module_deps/docker/urllib3-1.26.15-py2.py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - - -
- Skip to content - - - - - - - - - - - -
- - - - - - - - - - - - - - - -
- -
- - - - - - - - -
- - - - - -
- - - - - - - - - -
-
-
- - - - - - - - - - - - -
- -
- -
- -
- - - - / - - securityonion - - - Public -
- - -
- -
- - -
-
- -
-
- - - - -
- - - - - - -
- - - - - - - - - - - - - - - - - - -
- - - - - -
- - - -
-
- -
- -
-

Footer

- - - - -
-
- - - - - © 2024 GitHub, Inc. - -
- - -
-
- - - - - - - - - - - - - - - - - - - -
- -
-
- - - diff --git a/salt/salt/module_packages/docker/websocket_client-1.5.1-py3-none-any.whl b/salt/salt/module_packages/docker/websocket_client-1.5.1-py3-none-any.whl deleted file mode 100644 index fa5dfd9fd..000000000 --- a/salt/salt/module_packages/docker/websocket_client-1.5.1-py3-none-any.whl +++ /dev/null @@ -1,1817 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - securityonion/setup/files/salt_module_deps/docker/websocket_client-1.5.1-py3-none-any.whl at 2.4/main · Security-Onion-Solutions/securityonion · GitHub - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - - -
- Skip to content - - - - - - - - - - - -
- - - - - - - - - - - - - - - -
- -
- - - - - - - - -
- - - - - -
- - - - - - - - - -
-
-
- - - - - - - - - - - - -
- -
- -
- -
- - - - / - - securityonion - - - Public -
- - -
- -
- - -
-
- -
-
- - - - -
- - - - - - -
- - - - - - - - - - - - - - - - - - -
- - - - - -
- - - -
-
- -
- -
-

Footer

- - - - -
-
- - - - - © 2024 GitHub, Inc. - -
- - -
-
- - - - - - - - - - - - - - - - - - - -
- -
-
- - - From a28ac3bee6ce73221e7b35575a0ebe535b2ebad6 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 9 Aug 2024 11:53:07 -0400 Subject: [PATCH 012/303] virt --- salt/allowed_states.map.jinja | 9 +++--- salt/libvirt/init.sls | 28 ++++++++----------- salt/libvirt/packages.sls | 20 +++++++++++++ salt/salt/cloud/cloud.profiles.d/socloud.conf | 8 +++--- .../libvirt.conf | 14 +++++----- salt/salt/cloud/init.sls | 24 ++++++++++++++++ salt/salt/map.jinja | 9 ++++-- salt/salt/master.sls | 5 ++++ salt/vars/hypervisor.map.jinja | 7 ++++- 9 files changed, 90 insertions(+), 34 deletions(-) create mode 100644 salt/libvirt/packages.sls rename salt/salt/cloud/{cloud.provides.d => cloud.providers.d}/libvirt.conf (55%) create mode 100644 salt/salt/cloud/init.sls diff --git a/salt/allowed_states.map.jinja b/salt/allowed_states.map.jinja index 1cdf6145e..4c518fa92 100644 --- a/salt/allowed_states.map.jinja +++ b/salt/allowed_states.map.jinja @@ -1,7 +1,7 @@ -# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at -# https://securityonion.net/license; you may not use this file except in compliance with the -# Elastic License 2.0. +{# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. #} {% set ISAIRGAP = salt['pillar.get']('global:airgap', False) %} {% import_yaml 'salt/minion.defaults.yaml' as saltversion %} @@ -85,6 +85,7 @@ ], 'so-manager': [ 'salt.master', + 'salt.cloud', 'ca', 'ssl', 'registry', diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 1e4e3dde0..4c87e22e7 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -5,6 +5,9 @@ {% from 'libvirt/map.jinja' import LIBVIRTMERGED %} +include: + - libvirt.packages + install_libvirt: pkg.installed: - name: libvirt @@ -38,22 +41,6 @@ libvirt_service: - watch: - file: libvirt_config -libvirt_source-packages_dir: - file.directory: - - name: /opt/so/conf/libvirt/source-packages - -libvirt_python_wheel: - file.recurse: - - name: /opt/so/conf/libvirt/source-packages/libvirt-python - - source: salt://libvirt/source-packages/libvirt-python - - clean: True - -libvirt_python_module: - cmd.run: - - name: /opt/saltstack/salt/bin/python3.10 -m pip install --no-index --find-links=/opt/so/conf/libvirt/source-packages/libvirt-python libvirt-python - - onchanges: - - file: libvirt_python_wheel - # places cacert, clientcert, clientkey, servercert and serverkey # /etc/pki/CA/cacert.pem # /etc/pki/libvirt/clientcert.pem and /etc/pki/libvirt/servercert.pem @@ -74,5 +61,14 @@ install-guestfs-tools: pkg.installed: - name: guestfs-tools +# this should only run during the first highstate after setup. it will transfer connection from mgmt to br0 +down_original_mgmt_interface: + cmd.run: + - name: "nmcli con down {{ pillar.host.mainint }}" + - unless: + - nmcli -f GENERAL.CONNECTION dev show {{ pillar.host.mainint }} | grep bridge-slave-{{ pillar.host.mainint }} + - order: last + + # virtlogd service may not restart following reboot without this #semanage permissive -a virtlogd_t diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls new file mode 100644 index 000000000..dc7db9cf8 --- /dev/null +++ b/salt/libvirt/packages.sls @@ -0,0 +1,20 @@ +#libvirt_source-packages_dir: + # file.directory: + # - name: /opt/so/conf/libvirt/source-packages + +install_libvirt-libs: + pkg.installed: + - name: libvirt-libs + +libvirt_python_wheel: + file.recurse: + - name: /opt/so/conf/libvirt/source-packages/libvirt-python + - source: salt://libvirt/source-packages/libvirt-python + - makedirs: True + - clean: True + +libvirt_python_module: + cmd.run: + - name: /opt/saltstack/salt/bin/python3.10 -m pip install --no-index --find-links=/opt/so/conf/libvirt/source-packages/libvirt-python libvirt-python + - onchanges: + - file: libvirt_python_wheel diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf b/salt/salt/cloud/cloud.profiles.d/socloud.conf index c410fd7c3..9949e219d 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf @@ -50,16 +50,16 @@ sensor: - setHostname core: - provider: local-kvm + provider: kvm-via-ssh base_domain: jppol9vm ip_source: qemu-agent - ssh_username: jpatterson - private_key: /home/jpatterson/.ssh/id_rsa + ssh_username: onionuser + private_key: /home/onionuser/.ssh/id_ed25519 sudo: True deploy_command: sh /tmp/.saltcloud-*/deploy.sh script_args: -F -x python3 stable 3006.1 minion: - master: jppvirt + master: jpp90man master_port: 4506 startup_states: sls sls_list: diff --git a/salt/salt/cloud/cloud.provides.d/libvirt.conf b/salt/salt/cloud/cloud.providers.d/libvirt.conf similarity index 55% rename from salt/salt/cloud/cloud.provides.d/libvirt.conf rename to salt/salt/cloud/cloud.providers.d/libvirt.conf index 8c57cc1e5..587653010 100644 --- a/salt/salt/cloud/cloud.provides.d/libvirt.conf +++ b/salt/salt/cloud/cloud.providers.d/libvirt.conf @@ -1,11 +1,11 @@ # Set up a provider with qemu+ssh protocol -#kvm-via-ssh: -# driver: libvirt -# url: qemu+ssh://jpatterson@jppvirt/system?socket=/var/run/libvirt/libvirt-sock +kvm-via-ssh: + driver: libvirt + url: qemu+ssh://onionuser@jpphype1/system?socket=/var/run/libvirt/libvirt-sock # Or connect to a local libvirt instance -local-kvm: - driver: libvirt - url: qemu:///system +#local-kvm: +# driver: libvirt +# url: qemu:///system # work around flag for XML validation errors while cloning - validate_xml: no +# validate_xml: no diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls new file mode 100644 index 000000000..baaf44e88 --- /dev/null +++ b/salt/salt/cloud/init.sls @@ -0,0 +1,24 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +{% from 'allowed_states.map.jinja' import allowed_states %} +{% if sls in allowed_states %} +{% from 'salt/map.jinja' import SALTVERSION %} + +include: + - libvirt.packages + +install_salt_cloud: + pkg.installed: + - name: salt-cloud + - version: {{SALTVERSION}} + +{% else %} + +{{sls}}_state_not_allowed: + test.fail_without_changes: + - name: {{sls}}_state_not_allowed + +{% endif %} diff --git a/salt/salt/map.jinja b/salt/salt/map.jinja index 5f687ef3f..9a08304ca 100644 --- a/salt/salt/map.jinja +++ b/salt/salt/map.jinja @@ -1,15 +1,20 @@ +{# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. #} + {% import_yaml 'salt/minion.defaults.yaml' as saltminion %} {% set SALTVERSION = saltminion.salt.minion.version %} {% if grains.os_family == 'Debian' %} {% set SPLITCHAR = '+' %} {% set SALTNOTHELD = salt['cmd.run']('apt-mark showhold | grep -q salt ; echo $?', python_shell=True) %} - {% set SALTPACKAGES = ['salt-common', 'salt-master', 'salt-minion'] %} + {% set SALTPACKAGES = ['salt-common', 'salt-master', 'salt-minion', 'salt-cloud'] %} {% set SYSTEMD_UNIT_FILE = '/lib/systemd/system/salt-minion.service' %} {% else %} {% set SPLITCHAR = '-' %} {% set SALTNOTHELD = salt['cmd.run']('yum versionlock list | grep -q salt ; echo $?', python_shell=True) %} - {% set SALTPACKAGES = ['salt', 'salt-master', 'salt-minion'] %} + {% set SALTPACKAGES = ['salt', 'salt-master', 'salt-minion', 'salt-cloud'] %} {% set SYSTEMD_UNIT_FILE = '/usr/lib/systemd/system/salt-minion.service' %} {% endif %} diff --git a/salt/salt/master.sls b/salt/salt/master.sls index 84e18b8fc..9558352dd 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -1,3 +1,8 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + {% from 'salt/map.jinja' import SALTNOTHELD %} {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls in allowed_states %} diff --git a/salt/vars/hypervisor.map.jinja b/salt/vars/hypervisor.map.jinja index 964f69663..b8fd4ac1f 100644 --- a/salt/vars/hypervisor.map.jinja +++ b/salt/vars/hypervisor.map.jinja @@ -1 +1,6 @@ -{% set ROLE_GLOBALS = {} %} +{% import 'vars/init.map.jinja' as INIT %} +{% + set ROLE_GLOBALS = { + 'node_ip': INIT.GRAINS.ip_interfaces.get('br0')[0] + } +%} From 64a0c171f3b3e6335948d173a88a9cde867e34c0 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 12 Aug 2024 12:47:04 -0400 Subject: [PATCH 013/303] ssh user, build cloud profiles and providers --- pillar/hypervisor/nodes.sls | 34 +++++++++++ pillar/top.sls | 1 + salt/libvirt/packages.sls | 5 ++ salt/libvirt/ssh/files/config | 2 + salt/libvirt/ssh/users.sls | 56 +++++++++++++++++++ .../{socloud.conf => socloud.conf.jinja} | 8 ++- .../salt/cloud/cloud.providers.d/libvirt.conf | 11 ---- .../cloud.providers.d/libvirt.conf.jinja | 19 +++++++ salt/salt/cloud/init.sls | 16 ++++++ setup/so-setup | 1 + 10 files changed, 140 insertions(+), 13 deletions(-) create mode 100644 pillar/hypervisor/nodes.sls create mode 100644 salt/libvirt/ssh/files/config create mode 100644 salt/libvirt/ssh/users.sls rename salt/salt/cloud/cloud.profiles.d/{socloud.conf => socloud.conf.jinja} (95%) delete mode 100644 salt/salt/cloud/cloud.providers.d/libvirt.conf create mode 100644 salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja diff --git a/pillar/hypervisor/nodes.sls b/pillar/hypervisor/nodes.sls new file mode 100644 index 000000000..0cdec95d3 --- /dev/null +++ b/pillar/hypervisor/nodes.sls @@ -0,0 +1,34 @@ +{% set node_types = {} %} +{% for minionid, ip in salt.saltutil.runner( + 'mine.get', + tgt='G@role:so-hypervisor', + fun='network.ip_addrs', + tgt_type='compound') | dictsort() +%} + +# only add a node to the pillar if it returned an ip from the mine +{% if ip | length > 0%} +{% set hostname = minionid.split('_') | first %} +{% set node_type = minionid.split('_') | last %} +{% if node_type not in node_types.keys() %} +{% do node_types.update({node_type: {hostname: ip[0]}}) %} +{% else %} +{% if hostname not in node_types[node_type] %} +{% do node_types[node_type].update({hostname: ip[0]}) %} +{% else %} +{% do node_types[node_type][hostname].update(ip[0]) %} +{% endif %} +{% endif %} +{% endif %} +{% endfor %} + + +hypervisor: + nodes: +{% for node_type, values in node_types.items() %} + {{node_type}}: +{% for hostname, ip in values.items() %} + {{hostname}}: + ip: {{ip}} +{% endfor %} +{% endfor %} diff --git a/pillar/top.sls b/pillar/top.sls index 1a0d5f8c6..031ff5d3d 100644 --- a/pillar/top.sls +++ b/pillar/top.sls @@ -66,6 +66,7 @@ base: - kafka.nodes - kafka.soc_kafka - kafka.adv_kafka + - hypervisor.nodes - stig.soc_stig '*_sensor': diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index dc7db9cf8..bc39d4df1 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -6,6 +6,11 @@ install_libvirt-libs: pkg.installed: - name: libvirt-libs +# provides virsh +install_libvirt-client: + pkg.installed: + - name: libvirt-client + libvirt_python_wheel: file.recurse: - name: /opt/so/conf/libvirt/source-packages/libvirt-python diff --git a/salt/libvirt/ssh/files/config b/salt/libvirt/ssh/files/config new file mode 100644 index 000000000..25af86b73 --- /dev/null +++ b/salt/libvirt/ssh/files/config @@ -0,0 +1,2 @@ +Host * + IdentityFile /home/soqemussh/.ssh/id_ed25519 diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls new file mode 100644 index 000000000..5913deb15 --- /dev/null +++ b/salt/libvirt/ssh/users.sls @@ -0,0 +1,56 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +{% from 'vars/globals.map.jinja' import GLOBALS %} + +# used for qemu+ssh connection between manager and hypervisors +create_soqemussh_user: + user.present: + - name: soqemussh + - shell: /bin/bash + - home: /home/soqemussh +{% if not GLOBALS.is_manager %} + - groups: + - wheel +{% endif %} + +{% if GLOBALS.is_manager %} + +create_local_libvirt_ssh_key_dir: + file.directory: + - name: /opt/so/saltstack/local/salt/libvirt/ssh/keys + - user: socore + - group: socore + - mode: 755 + - makedirs: True + +# generate the key pair and put the pub key in salt local files roots +generate_ssh_key_soqemussh: + cmd.run: + - name: ssh-keygen -q -N '' -t ed25519 -f /home/soqemussh/.ssh/id_ed25519 + - runas: soqemussh + - unless: test -f /home/soqemussh/.ssh/id_ed25519 + - require: + - user: create_soqemussh_user + +soqemussh_ssh_key_to_local: + cmd.run: + - name: cp /home/soqemussh/.ssh/id_ed25519.pub /opt/so/saltstack/local/salt/libvirt/ssh/keys + - onchanges: + - cmd: generate_ssh_key_soqemussh + +qemu_ssh_client_config: + file.managed: + - name: /root/.ssh/config + - source: salt://libvirt/ssh/files/config + +{% else %} + +soqemussh_pub_key: + ssh_auth.present: + - user: soqemussh + - source: salt://libvirt/ssh_keys/id_ed25519.pub + +{% endif %} diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja similarity index 95% rename from salt/salt/cloud/cloud.profiles.d/socloud.conf rename to salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 9949e219d..da8044323 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -49,8 +49,10 @@ sensor: sls_list: - setHostname -core: - provider: kvm-via-ssh +{%- for hv in HYPERVISORS %} + +core-{{hv}}: + provider: kvm-ssh-{{hv}} base_domain: jppol9vm ip_source: qemu-agent ssh_username: onionuser @@ -64,3 +66,5 @@ core: startup_states: sls sls_list: - setHostname + +{%- endfor %} diff --git a/salt/salt/cloud/cloud.providers.d/libvirt.conf b/salt/salt/cloud/cloud.providers.d/libvirt.conf deleted file mode 100644 index 587653010..000000000 --- a/salt/salt/cloud/cloud.providers.d/libvirt.conf +++ /dev/null @@ -1,11 +0,0 @@ -# Set up a provider with qemu+ssh protocol -kvm-via-ssh: - driver: libvirt - url: qemu+ssh://onionuser@jpphype1/system?socket=/var/run/libvirt/libvirt-sock - -# Or connect to a local libvirt instance -#local-kvm: -# driver: libvirt -# url: qemu:///system - # work around flag for XML validation errors while cloning -# validate_xml: no diff --git a/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja b/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja new file mode 100644 index 000000000..5ead21f1f --- /dev/null +++ b/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja @@ -0,0 +1,19 @@ +# Set up a provider with qemu+ssh protocol +#kvm-ssh-jpphype1: +# driver: libvirt +# url: qemu+ssh://soqemussh@jpphype1/system?socket=/var/run/libvirt/libvirt-sock + +{%- for hv in HYPERVISORS %} + +kvm-ssh-{{hv}}: + driver: libvirt + url: qemu+ssh://soqemussh@{{hv}}/system?socket=/var/run/libvirt/libvirt-sock + +{%- endfor %} + +# Or connect to a local libvirt instance +#local-kvm: +# driver: libvirt +# url: qemu:///system + # work around flag for XML validation errors while cloning +# validate_xml: no diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index baaf44e88..60ee23067 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -15,6 +15,22 @@ install_salt_cloud: - name: salt-cloud - version: {{SALTVERSION}} +cloud_providers: + file.managed: + - name: /etc/salt/cloud.providers.d/libvirt.conf + - source: salt://salt/cloud/cloud.providers.d/libvirt.conf.jinja + - defaults: + HYPERVISORS: {{pillar.hypervisor.nodes}} + - template: jinja + +cloud_profiles: + file.managed: + - name: /etc/salt/cloud.profiles.d/socloud.conf + - source: salt://salt/cloud/cloud.profiles.d/socloud.conf.jinja + - defaults: + HYPERVISORS: {{pillar.hypervisor.nodes}} + - template: jinja + {% else %} {{sls}}_state_not_allowed: diff --git a/setup/so-setup b/setup/so-setup index 5ae0a5218..1c7efbd68 100755 --- a/setup/so-setup +++ b/setup/so-setup @@ -629,6 +629,7 @@ if ! [[ -f $install_opt_file ]]; then check_requirements networking_needful configure_hyper_bridge + MNIC=br0 collect_mngr_hostname add_mngr_ip_to_hosts check_manager_connection From 957235a6566dec6568d455768ee4215c41dd441b Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 12 Aug 2024 13:31:51 -0400 Subject: [PATCH 014/303] fix dns-search --- setup/so-functions | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup/so-functions b/setup/so-functions index f80f702c1..1cd59b9da 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -769,7 +769,7 @@ configure_hyper_bridge() { logCmd "nmcli con mod br0 ipv4.addresses $addresses" logCmd "nmcli con mod br0 ipv4.gateway $gateway" logCmd "nmcli con mod br0 ipv4.dns $dns" - logCmd "nmcli con mod br0 ipv4.dns-search $dns-search" + logCmd "nmcli con mod br0 ipv4.dns-search $dnssearch" logCmd "nmcli con mod br0 ipv4.method manual" logCmd "nmcli con up br0" # we cant bring down MNIC here since it would disrupt ssh sessions. we will need to bring it down at the end of the first highstate From f9eeb76518a861388951763b026abf8616f3e072 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 12 Aug 2024 14:58:10 -0400 Subject: [PATCH 015/303] mine for hyper --- salt/salt/etc/minion.d/mine_functions.conf.jinja | 8 +++++++- setup/so-setup | 1 - 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/salt/salt/etc/minion.d/mine_functions.conf.jinja b/salt/salt/etc/minion.d/mine_functions.conf.jinja index 529dee3b0..fb721512f 100644 --- a/salt/salt/etc/minion.d/mine_functions.conf.jinja +++ b/salt/salt/etc/minion.d/mine_functions.conf.jinja @@ -1,7 +1,13 @@ +{% if grains.role == 'so-hypervisor' %} +{% set interface = 'br0' %} +{% else %} +{% set interface = pillar.host.mainint %} +{% endif %} + mine_interval: 25 mine_functions: network.ip_addrs: - - interface: {{ pillar.host.mainint }} + - interface: {{ interface }} {%- if grains.role in ['so-eval','so-import','so-manager','so-managersearch','so-standalone'] %} x509.get_pem_entries: - glob_path: '/etc/pki/ca.crt' diff --git a/setup/so-setup b/setup/so-setup index 1c7efbd68..5ae0a5218 100755 --- a/setup/so-setup +++ b/setup/so-setup @@ -629,7 +629,6 @@ if ! [[ -f $install_opt_file ]]; then check_requirements networking_needful configure_hyper_bridge - MNIC=br0 collect_mngr_hostname add_mngr_ip_to_hosts check_manager_connection From aa5de9f7bd6a0da592df176881f8ada5361a5272 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 13 Aug 2024 10:17:45 -0400 Subject: [PATCH 016/303] cloud profiles and providers. libvirt net setup --- salt/libvirt/init.sls | 17 +++++++++++------ salt/libvirt/packages.sls | 19 +++++++++++++++++++ salt/libvirt/ssh/users.sls | 2 +- .../cloud/cloud.profiles.d/socloud.conf.jinja | 8 +++++--- .../cloud.providers.d/libvirt.conf.jinja | 8 +++++--- salt/salt/cloud/init.sls | 2 +- 6 files changed, 42 insertions(+), 14 deletions(-) diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 4c87e22e7..7d1d19240 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -53,13 +53,18 @@ install_qemu: pkg.installed: - name: qemu-kvm -install_libguestfs: - pkg.installed: - - name: libguestfs +create_host_bridge: + virt.network_running: + - name: host-bridge + - bridge: br0 + - forward: bridge + - autostart: True -install-guestfs-tools: - pkg.installed: - - name: guestfs-tools +disable_default_bridge: + cmd.run: + - name: virsh net-destroy default && virsh net-autostart default --disable + - require: + - pkg: install_libvirt-client # this should only run during the first highstate after setup. it will transfer connection from mgmt to br0 down_original_mgmt_interface: diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index bc39d4df1..9b56c6f64 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -11,6 +11,25 @@ install_libvirt-client: pkg.installed: - name: libvirt-client +# allows for creating vm images +# any node manipulating images needs this +install_qemu-img: + pkg.installed: + - name: qemu-img + +install_guestfs-tools: + pkg.installed: + - name: guestfs-tools + +install_xorriso: + pkg.installed: + - name: xorriso + +install_virt-install: + pkg.installed: + - name: virt-install +### + libvirt_python_wheel: file.recurse: - name: /opt/so/conf/libvirt/source-packages/libvirt-python diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls index 5913deb15..28d9afe0d 100644 --- a/salt/libvirt/ssh/users.sls +++ b/salt/libvirt/ssh/users.sls @@ -51,6 +51,6 @@ qemu_ssh_client_config: soqemussh_pub_key: ssh_auth.present: - user: soqemussh - - source: salt://libvirt/ssh_keys/id_ed25519.pub + - source: salt://libvirt/ssh/keys/id_ed25519.pub {% endif %} diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index da8044323..1a5243666 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -49,10 +49,11 @@ sensor: sls_list: - setHostname -{%- for hv in HYPERVISORS %} +{%- for node_type, hosts in HYPERVISORS.items() %} +{%- for host in hosts %} -core-{{hv}}: - provider: kvm-ssh-{{hv}} +core-{{host}}: + provider: kvm-ssh-{{host}} base_domain: jppol9vm ip_source: qemu-agent ssh_username: onionuser @@ -67,4 +68,5 @@ core-{{hv}}: sls_list: - setHostname +{%- endfor %} {%- endfor %} diff --git a/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja b/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja index 5ead21f1f..3f18a9124 100644 --- a/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja +++ b/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja @@ -3,12 +3,14 @@ # driver: libvirt # url: qemu+ssh://soqemussh@jpphype1/system?socket=/var/run/libvirt/libvirt-sock -{%- for hv in HYPERVISORS %} +{%- for node_type, hosts in HYPERVISORS.items() %} +{%- for host in hosts %} -kvm-ssh-{{hv}}: +kvm-ssh-{{host}}: driver: libvirt - url: qemu+ssh://soqemussh@{{hv}}/system?socket=/var/run/libvirt/libvirt-sock + url: qemu+ssh://soqemussh@{{host}}/system?socket=/var/run/libvirt/libvirt-sock +{%- endfor %} {%- endfor %} # Or connect to a local libvirt instance diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index 60ee23067..63c624bdb 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -28,7 +28,7 @@ cloud_profiles: - name: /etc/salt/cloud.profiles.d/socloud.conf - source: salt://salt/cloud/cloud.profiles.d/socloud.conf.jinja - defaults: - HYPERVISORS: {{pillar.hypervisor.nodes}} + HYPERVISORS: {{pillar.hypervisor.nodes.hypervisor}} - template: jinja {% else %} From 2a35e459202f157c509dc88f391b62d329ddcc97 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 13 Aug 2024 13:17:09 -0400 Subject: [PATCH 017/303] hyper --- salt/libvirt/init.sls | 3 +++ salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja | 8 +++----- salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja | 8 +------- salt/salt/cloud/init.sls | 2 +- 4 files changed, 8 insertions(+), 13 deletions(-) diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 7d1d19240..f4c9e1d5b 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -7,6 +7,7 @@ include: - libvirt.packages + - libvirt.ssh.users install_libvirt: pkg.installed: @@ -65,6 +66,8 @@ disable_default_bridge: - name: virsh net-destroy default && virsh net-autostart default --disable - require: - pkg: install_libvirt-client + - onlyif: + - virsh net-info | grep default # this should only run during the first highstate after setup. it will transfer connection from mgmt to br0 down_original_mgmt_interface: diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 1a5243666..6bc914fd1 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -49,15 +49,14 @@ sensor: sls_list: - setHostname -{%- for node_type, hosts in HYPERVISORS.items() %} -{%- for host in hosts %} +{%- for host in HYPERVISORS %} core-{{host}}: provider: kvm-ssh-{{host}} base_domain: jppol9vm ip_source: qemu-agent - ssh_username: onionuser - private_key: /home/onionuser/.ssh/id_ed25519 + ssh_username: soqemussh + private_key: /home/soqemussh/.ssh/id_ed25519 sudo: True deploy_command: sh /tmp/.saltcloud-*/deploy.sh script_args: -F -x python3 stable 3006.1 @@ -68,5 +67,4 @@ core-{{host}}: sls_list: - setHostname -{%- endfor %} {%- endfor %} diff --git a/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja b/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja index 3f18a9124..a8b72faf2 100644 --- a/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja +++ b/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja @@ -1,16 +1,10 @@ # Set up a provider with qemu+ssh protocol -#kvm-ssh-jpphype1: -# driver: libvirt -# url: qemu+ssh://soqemussh@jpphype1/system?socket=/var/run/libvirt/libvirt-sock - -{%- for node_type, hosts in HYPERVISORS.items() %} -{%- for host in hosts %} +{%- for host in HYPERVISORS %} kvm-ssh-{{host}}: driver: libvirt url: qemu+ssh://soqemussh@{{host}}/system?socket=/var/run/libvirt/libvirt-sock -{%- endfor %} {%- endfor %} # Or connect to a local libvirt instance diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index 63c624bdb..3cbb2d991 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -20,7 +20,7 @@ cloud_providers: - name: /etc/salt/cloud.providers.d/libvirt.conf - source: salt://salt/cloud/cloud.providers.d/libvirt.conf.jinja - defaults: - HYPERVISORS: {{pillar.hypervisor.nodes}} + HYPERVISORS: {{pillar.hypervisor.nodes.hypervisor}} - template: jinja cloud_profiles: From 30e998edf79b01d8e317b5e6e62141b030b3ca72 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 16 Aug 2024 11:58:49 -0400 Subject: [PATCH 018/303] bridge and pools --- salt/libvirt/defaults.yaml | 6 ++--- salt/libvirt/init.sls | 49 ++++++++++++++++++++++++++++---------- salt/libvirt/ssh/users.sls | 2 ++ 3 files changed, 41 insertions(+), 16 deletions(-) diff --git a/salt/libvirt/defaults.yaml b/salt/libvirt/defaults.yaml index 1905b2e8f..b8da19cb2 100644 --- a/salt/libvirt/defaults.yaml +++ b/salt/libvirt/defaults.yaml @@ -10,9 +10,9 @@ libvirt: unix_sock_rw_perms: "0770" unix_sock_admin_perms: "0700" unix_sock_dir: "/run/libvirt" - auth_unix_ro: "none" - auth_unix_rw: "none" - auth_tcp: "none" + auth_unix_ro: "polkit" + auth_unix_rw: "polkit" + auth_tcp: "sasl" auth_tls: "none" tcp_min_ssf: 112 access_drivers: ["polkit"] diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index f4c9e1d5b..327bc1150 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -23,10 +23,11 @@ libvirt_conf_dir: libvirt_config: file.managed: - name: /opt/so/conf/libvirt/libvirtd.conf - - source: salt://libvirt/etc/libvirtd.conf.jinja - - template: jinja - - defaults: - LIBVIRTMERGED: {{ LIBVIRTMERGED }} + - source: salt://libvirt/configstockstock +# - source: salt://libvirt/etc/libvirtd.conf.jinja +# - template: jinja +# - defaults: +# LIBVIRTMERGED: {{ LIBVIRTMERGED }} # since the libvirtd service looks for the config at /etc/libvirt/libvirtd.conf, and we dont want to manage the service looking in a new location, create this symlink to the managed config config_symlink: @@ -34,6 +35,8 @@ config_symlink: - name: /etc/libvirt/libvirtd.conf - target: /opt/so/conf/libvirt/libvirtd.conf - force: True + - user: qemu + - group: qemu libvirt_service: service.running: @@ -54,20 +57,40 @@ install_qemu: pkg.installed: - name: qemu-kvm -create_host_bridge: +#create_host_bridge: +# virt.network_running: +# - name: host-bridge +# - bridge: br0 +# - forward: bridge +# - autostart: True + +set_default_bridge: virt.network_running: - - name: host-bridge + - name: default - bridge: br0 - forward: bridge - autostart: True -disable_default_bridge: - cmd.run: - - name: virsh net-destroy default && virsh net-autostart default --disable - - require: - - pkg: install_libvirt-client - - onlyif: - - virsh net-info | grep default +# set the default storage pool to point to the location we want +set_default_pool: + virt.pool_running: + - name: default + - ptype: dir + - target: /var/lib/libvirt/images/coreol9 + - permissions: + - mode: 0711 + - owner: qemu + - group: qemu + - label: "system_u:object_r:virt_image_t:s0" # this doesnt seem to set the selinux context + - autostart: True + +#disable_default_bridge: +# cmd.run: +# - name: virsh net-destroy default && virsh net-autostart default --disable +# - require: +# - pkg: install_libvirt-client +# - onlyif: +# - virsh net-info | grep default # this should only run during the first highstate after setup. it will transfer connection from mgmt to br0 down_original_mgmt_interface: diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls index 28d9afe0d..a893b9a7d 100644 --- a/salt/libvirt/ssh/users.sls +++ b/salt/libvirt/ssh/users.sls @@ -14,6 +14,8 @@ create_soqemussh_user: {% if not GLOBALS.is_manager %} - groups: - wheel + - qemu + - libvirt {% endif %} {% if GLOBALS.is_manager %} From 67f093493030db066a377b044788ae64f0f66887 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 16 Aug 2024 12:21:41 -0400 Subject: [PATCH 019/303] set new bridge --- salt/libvirt/init.sls | 25 +++++++++---------------- 1 file changed, 9 insertions(+), 16 deletions(-) diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 327bc1150..689ee278e 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -57,16 +57,9 @@ install_qemu: pkg.installed: - name: qemu-kvm -#create_host_bridge: -# virt.network_running: -# - name: host-bridge -# - bridge: br0 -# - forward: bridge -# - autostart: True - -set_default_bridge: +create_host_bridge: virt.network_running: - - name: default + - name: host-bridge - bridge: br0 - forward: bridge - autostart: True @@ -84,13 +77,13 @@ set_default_pool: - label: "system_u:object_r:virt_image_t:s0" # this doesnt seem to set the selinux context - autostart: True -#disable_default_bridge: -# cmd.run: -# - name: virsh net-destroy default && virsh net-autostart default --disable -# - require: -# - pkg: install_libvirt-client -# - onlyif: -# - virsh net-info | grep default +disable_default_bridge: + cmd.run: + - name: virsh net-destroy default && virsh net-autostart default --disable + - require: + - pkg: install_libvirt-client + - onlyif: + - virsh net-info | grep default # this should only run during the first highstate after setup. it will transfer connection from mgmt to br0 down_original_mgmt_interface: From 7698243cafbb9688049290a9359adef3428cf456 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 16 Aug 2024 13:37:44 -0400 Subject: [PATCH 020/303] fix reactors --- salt/reactor/createEmptyPillar.sls | 10 ++-------- salt/reactor/setup.sls | 6 ++---- salt/reactor/virtReleaseHardware.sls | 8 ++------ salt/reactor/virtUpdate.sls | 6 ++---- salt/salt/master.sls | 10 +++++----- 5 files changed, 13 insertions(+), 27 deletions(-) diff --git a/salt/reactor/createEmptyPillar.sls b/salt/reactor/createEmptyPillar.sls index 95e41eef6..a182e1338 100644 --- a/salt/reactor/createEmptyPillar.sls +++ b/salt/reactor/createEmptyPillar.sls @@ -1,20 +1,14 @@ +#!py + # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. -#!py - import logging -import salt.client -local = salt.client.LocalClient() -from subprocess import call -import yaml - import os def run(): - #logging.error("createEmptyPillar reactor: data: %s" % data) vm_name = data['kwargs']['name'] logging.error("createEmptyPillar reactor: vm_name: %s" % vm_name) pillar_root = '/opt/so/saltstack/local/pillar/minions/' diff --git a/salt/reactor/setup.sls b/salt/reactor/setup.sls index b8c5ad16c..609691223 100644 --- a/salt/reactor/setup.sls +++ b/salt/reactor/setup.sls @@ -1,13 +1,11 @@ +#!py + # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. -#!py - import logging -import salt.client -local = salt.client.LocalClient() from subprocess import call import yaml diff --git a/salt/reactor/virtReleaseHardware.sls b/salt/reactor/virtReleaseHardware.sls index 6211fc611..ccf15a618 100644 --- a/salt/reactor/virtReleaseHardware.sls +++ b/salt/reactor/virtReleaseHardware.sls @@ -1,16 +1,12 @@ +#!py + # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. -#!py - import logging -import salt.client -local = salt.client.LocalClient() -from subprocess import call import yaml - import os def run(): diff --git a/salt/reactor/virtUpdate.sls b/salt/reactor/virtUpdate.sls index e44bc8070..8ccee26f0 100644 --- a/salt/reactor/virtUpdate.sls +++ b/salt/reactor/virtUpdate.sls @@ -1,17 +1,15 @@ +#!py + # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. -#!py - import logging import salt.client local = salt.client.LocalClient() -from subprocess import call import yaml - def run(): def claim_compute(hw_type): diff --git a/salt/salt/master.sls b/salt/salt/master.sls index 9558352dd..40e1d6210 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -57,14 +57,14 @@ salt_master_service: #- salt/cloud/*/creating': #- salt/cloud/*/requesting # - 'salt/cloud/*/deploying': -# - /srv/salt/reactor/createEmptyPillar.sls +# - /opt/so/saltstack/default/salt/reactor/createEmptyPillar.sls # - 'setup/so-minion': -# - /srv/salt/reactor/setup.sls +# - /opt/so/saltstack/default/salt/reactor/setup.sls # - 'salt/cloud/*/created': -# - /srv/salt/reactor/virtUpdate.sls +# - /opt/so/saltstack/default/salt/reactor/virtUpdate.sls # - 'salt/cloud/*/destroyed': -# - /srv/salt/reactor/virtReleaseHardware.sls -# - /srv/salt/reactor/deleteKey.sls +# - /opt/so/saltstack/default/salt/reactor/virtReleaseHardware.sls +# - /opt/so/saltstack/default/salt/reactor/deleteKey.sls {% else %} From 205560cc952211e8c2f9f37aa41cd042367f97f3 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 20 Aug 2024 08:31:46 -0400 Subject: [PATCH 021/303] updates --- salt/hypervisor/pillarExample.sls | 0 salt/reactor/setup.sls | 2 +- salt/reactor/virtReleaseHardware.sls | 33 +++++--- salt/reactor/virtUpdate.sls | 20 +++-- .../cloud/cloud.profiles.d/socloud.conf.jinja | 81 +++++++------------ .../cloud.providers.d/libvirt.conf.jinja | 15 +++- salt/salt/cloud/init.sls | 15 +++- salt/setup/virt/setHostname.sls | 9 ++- salt/setup/virt/soinstall.map.jinja | 6 +- 9 files changed, 96 insertions(+), 85 deletions(-) create mode 100644 salt/hypervisor/pillarExample.sls diff --git a/salt/hypervisor/pillarExample.sls b/salt/hypervisor/pillarExample.sls new file mode 100644 index 000000000..e69de29bb diff --git a/salt/reactor/setup.sls b/salt/reactor/setup.sls index 609691223..3e98b174e 100644 --- a/salt/reactor/setup.sls +++ b/salt/reactor/setup.sls @@ -11,8 +11,8 @@ import yaml def run(): minionid = data['id'] - hv_name = 'jppvirt' DATA = data['data'] + hv_name = DATA['HYPERVISOR_HOST'] logging.error("setup reactor: %s " % DATA) vm_out_data = { diff --git a/salt/reactor/virtReleaseHardware.sls b/salt/reactor/virtReleaseHardware.sls index ccf15a618..8e95e080f 100644 --- a/salt/reactor/virtReleaseHardware.sls +++ b/salt/reactor/virtReleaseHardware.sls @@ -1,32 +1,43 @@ #!py # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. import logging import yaml import os +import glob def run(): - def release_compute(hw_type): + def release_compute(): compute = hv_data['hypervisor']['hardware'][hw_type] compute.update({'free': compute.get('free') + vm_data.get(hw_type)}) logging.error("virtReboot reactor: claiming %s compute: %s " % (hw_type,compute)) - def release_pci(hw_type): + def release_pci(): free_hw = hv_data['hypervisor']['hardware'][hw_type]['free'] - for hw in vm_data[hw_type]: - f_hw = {hw: hv_data['hypervisor']['hardware'][hw_type]['claimed'].pop(hw)} - free_hw.update(f_hw) - logging.error("virtReleaseHardware reactor: released %s: %s" % (hw_type, f_hw)) - + # this could be 0 if nothing is assigned + if vm_data[hw_type] != 0: + for hw in vm_data[hw_type]: + f_hw = {hw: hv_data['hypervisor']['hardware'][hw_type]['claimed'].pop(hw)} + free_hw.update(f_hw) + logging.error("virtReleaseHardware reactor: released %s: %s" % (hw_type, f_hw)) + def get_hypervisor(): + base_dir = '/opt/so/saltstack/local/pillar/hypervisor' + pattern = os.path.join(base_dir, '**', vm_name + '.sls') + files = glob.glob(pattern, recursive=True) + logging.error("virtReleaseHardware reactor: files: %s " % files) + if files: + return files[0].split('/')[7] vm_name = data['name'] - hv_name = 'jppvirt' + # since the vm has been destroyed, we can't get the hypervisor_host grain + hv_name = get_hypervisor() + logging.error("virtReleaseHardware reactor: hv_name: %s " % hv_name) with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls") as f: try: @@ -45,10 +56,10 @@ def run(): logging.error(exc) for hw_type in ['disks', 'copper', 'sfp']: - release_pci(hw_type) + release_pci() for hw_type in ['cpu', 'memory']: - release_compute(hw_type) + release_compute() # update the free hardware for the hypervisor with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + hv_name + ".sls", 'w') as f: diff --git a/salt/reactor/virtUpdate.sls b/salt/reactor/virtUpdate.sls index 8ccee26f0..8fbd5b2d6 100644 --- a/salt/reactor/virtUpdate.sls +++ b/salt/reactor/virtUpdate.sls @@ -23,10 +23,13 @@ def run(): # if a list of devices was defined if type(vm_data[hw_type]) == list: for hw in vm_data[hw_type]: - c_hw = {hw: hv_data['hypervisor']['hardware'][hw_type]['free'].pop(hw)} - claimed_hw.update(c_hw) - host_devices.append(c_hw[hw]) - #hv_data['hypervisor']['hardware'][hw_type].update({'claimed': claimed_hw}) + try: + c_hw = {hw: hv_data['hypervisor']['hardware'][hw_type]['free'].pop(hw)} + claimed_hw.update(c_hw) + host_devices.append(c_hw[hw]) + except KeyError: + logging.error("virtUpdate reactor: could not claim %s with key %s " % (hw_type,hw)) + return {'key1': 'val1'} # if a number of devices was defined else: n = vm_data[hw_type] @@ -44,7 +47,8 @@ def run(): logging.error("virtUpdate reactor: claimed_hw: %s " % claimed_hw) vm_name = data['name'] - hv_name = 'jppvirt' + hv_name = local.cmd(vm_name, 'grains.get', ['hypervisor_host']) + host_devices = [] with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls") as f: @@ -63,7 +67,7 @@ def run(): except yaml.YAMLError as exc: logging.error(exc) - local.cmd('jppvirt', 'virt.stop', ['name=' + vm_name]) + local.cmd(hv_name, 'virt.stop', ['name=' + vm_name]) for hw_type in ['disks', 'copper', 'sfp']: claim_pci(hw_type) @@ -85,9 +89,9 @@ def run(): yaml.dump(vm_data, f, default_flow_style=False) mem = vm_data['memory'] * 1024 - r = local.cmd('jppvirt', 'virt.update', ['name=' + vm_name, 'mem=' + str(mem), 'cpu=' + str(vm_data['cpu']), 'host_devices=' + str(host_devices)]) + r = local.cmd(hv_name, 'virt.update', ['name=' + vm_name, 'mem=' + str(mem), 'cpu=' + str(vm_data['cpu']), 'host_devices=' + str(host_devices)]) logging.error("virtUpdate reactor: virt.update: %s" % r) - local.cmd('jppvirt', 'virt.start', ['name=' + vm_name]) + local.cmd(hv_name, 'virt.start', ['name=' + vm_name]) return {} diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 6bc914fd1..21d050d88 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -1,59 +1,14 @@ -searchnode: - provider: local-kvm - base_domain: jppol9vm - ip_source: qemu-agent - ssh_username: jpatterson - private_key: /home/jpatterson/.ssh/id_rsa - sudo: True - # /tmp is mounted noexec.. do workaround - deploy_command: sh /tmp/.saltcloud-*/deploy.sh - script_args: -F -x python3 stable 3006.1 - # grains to add to the minion - #grains: - # clones-are-awesome: true - # override minion settings - minion: - master: jppvirt - master_port: 4506 - startup_states: sls - sls_list: - - setHostname +{#- Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. #} -sensor: - provider: local-kvm - base_domain: jppol9vm - ip_source: qemu-agent - ssh_username: jpatterson - private_key: /home/jpatterson/.ssh/id_rsa - sudo: True - #preflight_cmds: - # - echo "do something" - # - hostname - # /tmp is mounted noexec.. do workaround - deploy_command: sh /tmp/.saltcloud-*/deploy.sh - script_args: -F -x python3 stable 3006.1 - # the destination directory will be created if it doesn't exist - #file_map: - # /srv/salt/filemap.txt: /remote/path/to/use/custom/filemap.txt - #inline_script: - # - echo "SLEEPING" - # - hostname - # grains to add to the minion - #grains: - # clones-are-awesome: true - # override minion settings - minion: - master: jppvirt - master_port: 4506 - startup_states: sls - sls_list: - - setHostname - -{%- for host in HYPERVISORS %} +{%- for role, hosts in HYPERVISORS.items() %} +{%- for host in hosts.keys() -%} core-{{host}}: provider: kvm-ssh-{{host}} - base_domain: jppol9vm + base_domain: coreol9 ip_source: qemu-agent ssh_username: soqemussh private_key: /home/soqemussh/.ssh/id_ed25519 @@ -61,10 +16,28 @@ core-{{host}}: deploy_command: sh /tmp/.saltcloud-*/deploy.sh script_args: -F -x python3 stable 3006.1 minion: - master: jpp90man + master: {{ grains.host }} master_port: 4506 startup_states: sls sls_list: - - setHostname + - setup.virt.setHostname + use_superseded: + - module.run + features: + x509_v2: true + log_level: info + log_level_logfile: info + log_file: /opt/so/log/salt/minion + grains: + hypervisor_host: {{host ~ "_" ~ role}} + #preflight_cmds: + # - echo "preflight_cmds" + # the destination directory will be created if it doesn't exist + file_map: + /opt/so/saltstack/default/salt/repo/client/files/oracle/keys/securityonion.pub: /tmp/securityonion.pub + inline_script: + - "rpm --import /tmp/securityonion.pub" + # grains to add to the minion +{%- endfor %} {%- endfor %} diff --git a/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja b/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja index a8b72faf2..c6ba0b96a 100644 --- a/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja +++ b/salt/salt/cloud/cloud.providers.d/libvirt.conf.jinja @@ -1,15 +1,22 @@ -# Set up a provider with qemu+ssh protocol -{%- for host in HYPERVISORS %} +{# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. #} + +{#- provider with qemu+ssh protocol #} +{%- for role, hosts in HYPERVISORS.items() %} +{%- for host in hosts.keys() %} kvm-ssh-{{host}}: driver: libvirt url: qemu+ssh://soqemussh@{{host}}/system?socket=/var/run/libvirt/libvirt-sock +{%- endfor %} {%- endfor %} -# Or connect to a local libvirt instance +{#- local libvirt instance #} #local-kvm: # driver: libvirt # url: qemu:///system - # work around flag for XML validation errors while cloning +{#- work around flag for XML validation errors while cloning #} # validate_xml: no diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index 3cbb2d991..5e160581b 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -6,6 +6,7 @@ {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls in allowed_states %} {% from 'salt/map.jinja' import SALTVERSION %} +{% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {} ) %} include: - libvirt.packages @@ -20,7 +21,7 @@ cloud_providers: - name: /etc/salt/cloud.providers.d/libvirt.conf - source: salt://salt/cloud/cloud.providers.d/libvirt.conf.jinja - defaults: - HYPERVISORS: {{pillar.hypervisor.nodes.hypervisor}} + HYPERVISORS: {{HYPERVISORS}} - template: jinja cloud_profiles: @@ -28,9 +29,19 @@ cloud_profiles: - name: /etc/salt/cloud.profiles.d/socloud.conf - source: salt://salt/cloud/cloud.profiles.d/socloud.conf.jinja - defaults: - HYPERVISORS: {{pillar.hypervisor.nodes.hypervisor}} + HYPERVISORS: {{HYPERVISORS}} - template: jinja +{% for role, hosts in HYPERVISORS.items() %} +{% for host in hosts.keys() %} + +hypervisor_{{host}}_{{role}}_pillar_dir: + file.directory: + - name: /opt/so/saltstack/local/pillar/hypervisor/{{host}}_{{role}} + +{% endfor %} +{% endfor %} + {% else %} {{sls}}_state_not_allowed: diff --git a/salt/setup/virt/setHostname.sls b/salt/setup/virt/setHostname.sls index e77ebd5a7..5654b859f 100644 --- a/salt/setup/virt/setHostname.sls +++ b/salt/setup/virt/setHostname.sls @@ -3,7 +3,7 @@ # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. -{% from 'soinstall.map.jinja' import DATA %} +{% from 'setup/virt/soinstall.map.jinja' import DATA %} setHostname_{{grains.id.split("_") | first}}: network.system: @@ -16,6 +16,7 @@ create_pillar: event.send: - name: setup/so-minion - data: + HYPERVISOR_HOST: {{ grains.hypervisor_host }} MAINIP: {{ DATA.MAINIP }} MNIC: {{ DATA.MNIC }} NODE_DESCRIPTION: '{{ DATA.NODE_DESCRIPTION }}' @@ -35,6 +36,10 @@ create_pillar: COPPER: {{ DATA.COPPER }} SFP: {{ DATA.SFP }} +set_role_grain: + grains.present: + - name: role + - value: so-{{ grains.id.split("_") | last }} # set event for firewall rules - so-firewall-minion @@ -47,7 +52,7 @@ clean_sls_list: clean_setHostname: file.line: - name: /etc/salt/minion - - match: '- setHostname' + - match: '- setup.virt.setHostname' - mode: delete - onchanges: - file: clean_sls_list diff --git a/salt/setup/virt/soinstall.map.jinja b/salt/setup/virt/soinstall.map.jinja index 1c82fe3dd..e2649aab1 100644 --- a/salt/setup/virt/soinstall.map.jinja +++ b/salt/setup/virt/soinstall.map.jinja @@ -1,10 +1,10 @@ {# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one - or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at https://securityonion.net/license; you may not use this file except in compliance with the Elastic License 2.0. #} {% set nodetype = grains.id.split("_") | last %} -{% import_yaml nodetype ~ '.yaml' as DATA %} +{% import_yaml 'setup/virt/' ~ nodetype ~ '.yaml' as DATA %} {% set total_mem = grains.mem_total %} {% do DATA.update({'MAINIP': grains.ip_interfaces.get(DATA.MNIC)[0]}) %} @@ -12,7 +12,7 @@ {% do DATA.update({'CPUCORES': grains.num_cpus}) %} -{% if nodetype = "searchnode" %} +{% if nodetype == "searchnode" %} {% do DATA.update({'LSHOSTNAME': grains.host}) %} From 64bf7eb363268ed0eddcade2c79afac90700da5d Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 20 Aug 2024 15:26:05 -0400 Subject: [PATCH 022/303] hyper --- salt/repo/client/oracle.sls | 2 + .../cloud/cloud.profiles.d/socloud.conf.jinja | 9 ++-- salt/setup/virt/setHostname.sls | 50 ++++++++++--------- 3 files changed, 33 insertions(+), 28 deletions(-) diff --git a/salt/repo/client/oracle.sls b/salt/repo/client/oracle.sls index 8b55964f4..89d41beae 100644 --- a/salt/repo/client/oracle.sls +++ b/salt/repo/client/oracle.sls @@ -53,10 +53,12 @@ so_repo: - baseurl: file:///nsm/repo/ {% else %} - baseurl: https://{{ GLOBALS.repo_host }}/repo + - sslverify: 0 {% endif %} - enabled: 1 - gpgcheck: 1 + {% endif %} # TODO: Add a pillar entry for custom repos diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 21d050d88..c8db663af 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -21,6 +21,7 @@ core-{{host}}: startup_states: sls sls_list: - setup.virt.setHostname + - salt.minion use_superseded: - module.run features: @@ -33,10 +34,10 @@ core-{{host}}: #preflight_cmds: # - echo "preflight_cmds" # the destination directory will be created if it doesn't exist - file_map: - /opt/so/saltstack/default/salt/repo/client/files/oracle/keys/securityonion.pub: /tmp/securityonion.pub - inline_script: - - "rpm --import /tmp/securityonion.pub" + #file_map: + # /opt/so/saltstack/default/salt/repo/client/files/oracle/keys/securityonion.pub: /tmp/securityonion.pub + #inline_script: + # - "rpm --import /tmp/securityonion.pub" # grains to add to the minion {%- endfor %} diff --git a/salt/setup/virt/setHostname.sls b/salt/setup/virt/setHostname.sls index 5654b859f..3dd20098f 100644 --- a/salt/setup/virt/setHostname.sls +++ b/salt/setup/virt/setHostname.sls @@ -6,36 +6,14 @@ {% from 'setup/virt/soinstall.map.jinja' import DATA %} setHostname_{{grains.id.split("_") | first}}: + cmd.run: + - name: hostnamectl set-hostname --static {{grains.id.split("_") | first}} network.system: - name: {{grains.id.split("_") | first}} - enabled: True - hostname: {{grains.id.split("_") | first}} - apply_hostname: True -create_pillar: - event.send: - - name: setup/so-minion - - data: - HYPERVISOR_HOST: {{ grains.hypervisor_host }} - MAINIP: {{ DATA.MAINIP }} - MNIC: {{ DATA.MNIC }} - NODE_DESCRIPTION: '{{ DATA.NODE_DESCRIPTION }}' - ES_HEAP_SIZE: {{ DATA.ES_HEAP_SIZE }} - PATCHSCHEDULENAME: {{ DATA.PATCHSCHEDULENAME }} - INTERFACE: {{ DATA.INTERFACE }} - NODETYPE: {{ DATA.NODETYPE }} - CORECOUNT: {{ DATA.CORECOUNT }} - LSHOSTNAME: {{ DATA.LSHOSTNAME }} - LSHEAP: {{ DATA.LSHEAP }} - CPUCORES: {{ DATA.CPUCORES }} - IDH_MGTRESTRICT: {{ DATA.IDH_MGTRESTRICT }} - IDH_SERVICES: {{ DATA.IDH_SERVICES }} - CPU: {{ DATA.CPU }} - MEMORY: {{ DATA.MEMORY }} - DISKS: {{ DATA.DISKS }} - COPPER: {{ DATA.COPPER }} - SFP: {{ DATA.SFP }} - set_role_grain: grains.present: - name: role @@ -64,3 +42,27 @@ set_highstate: - repl: 'startup_states: highstate' - onchanges: - file: clean_setHostname + +create_pillar: + event.send: + - name: setup/so-minion + - data: + HYPERVISOR_HOST: {{ grains.hypervisor_host }} + MAINIP: {{ DATA.MAINIP }} + MNIC: {{ DATA.MNIC }} + NODE_DESCRIPTION: '{{ DATA.NODE_DESCRIPTION }}' + ES_HEAP_SIZE: {{ DATA.ES_HEAP_SIZE }} + PATCHSCHEDULENAME: {{ DATA.PATCHSCHEDULENAME }} + INTERFACE: {{ DATA.INTERFACE }} + NODETYPE: {{ DATA.NODETYPE }} + CORECOUNT: {{ DATA.CORECOUNT }} + LSHOSTNAME: {{ DATA.LSHOSTNAME }} + LSHEAP: {{ DATA.LSHEAP }} + CPUCORES: {{ DATA.CPUCORES }} + IDH_MGTRESTRICT: {{ DATA.IDH_MGTRESTRICT }} + IDH_SERVICES: {{ DATA.IDH_SERVICES }} + CPU: {{ DATA.CPU }} + MEMORY: {{ DATA.MEMORY }} + DISKS: {{ DATA.DISKS }} + COPPER: {{ DATA.COPPER }} + SFP: {{ DATA.SFP }} From d110503639b4ac01ce8e7a6d1d1e53be8e599e6b Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 20 Aug 2024 15:27:19 -0400 Subject: [PATCH 023/303] example pilalr --- salt/hypervisor/pillarExample.sls | 48 +++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) diff --git a/salt/hypervisor/pillarExample.sls b/salt/hypervisor/pillarExample.sls index e69de29bb..4bc11434b 100644 --- a/salt/hypervisor/pillarExample.sls +++ b/salt/hypervisor/pillarExample.sls @@ -0,0 +1,48 @@ +hypervisor: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 128 + free: 128 + disks: + free: + 3: pci_0000_c7_00_0 + 4: pci_0000_c8_00_0 + claimed: + 1: pci_0000_c5_00_0 + 2: pci_0000_c6_00_0 + copper: + free: + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + claimed: {} + sfp: + free: + 5: pci_0000_41_00_0 + 6: pci_0000_41_00_1 + claimed: {} + + +hypervisor: + hardware: + cpu: + total: 16 + free: 16 + memory: + total: 16 + free: 16 + disks: + free: {} + claimed: {} + copper: + free: + 2: pci_0000_00_13_0 + claimed: + 1: pci_0000_00_12_0 + sfp: + free: {} + claimed: {} From 21c383532284a9d0664d1a8637b30349d98d04c3 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 27 Aug 2024 09:25:40 -0400 Subject: [PATCH 024/303] salt3006.9, redo reactors, use virt.shutdown --- salt/reactor/setHostname.sls | 22 +++++++ salt/reactor/setSalt.sls | 22 +++++++ salt/reactor/sominion.sls | 21 +++++++ .../reactor/{setup.sls => sominion_setup.sls} | 8 +-- salt/reactor/virtUpdate.sls | 30 +++++++--- .../cloud/cloud.profiles.d/socloud.conf.jinja | 13 +++-- salt/salt/master.defaults.yaml | 2 +- salt/salt/master.sls | 8 ++- salt/salt/minion.defaults.yaml | 2 +- salt/setup/virt/sensor.yaml | 11 ++-- salt/setup/virt/setHostname.sls | 57 +------------------ salt/setup/virt/setSalt.sls | 16 ++++++ salt/setup/virt/sominion.sls | 30 ++++++++++ 13 files changed, 159 insertions(+), 83 deletions(-) create mode 100644 salt/reactor/setHostname.sls create mode 100644 salt/reactor/setSalt.sls create mode 100644 salt/reactor/sominion.sls rename salt/reactor/{setup.sls => sominion_setup.sls} (82%) create mode 100644 salt/setup/virt/setSalt.sls create mode 100644 salt/setup/virt/sominion.sls diff --git a/salt/reactor/setHostname.sls b/salt/reactor/setHostname.sls new file mode 100644 index 000000000..3733a71bb --- /dev/null +++ b/salt/reactor/setHostname.sls @@ -0,0 +1,22 @@ +#!py + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +import logging +import salt.client +local = salt.client.LocalClient() + +def run(): + + vm_name = data['name'] + logging.error("setHostname reactor: start for: %s " % vm_name) + + r = local.cmd(vm_name, 'state.apply', ['setup.virt.setHostname']) + + logging.error("setHostname reactor: return for %s: %s " % (vm_name,r)) + logging.error("setHostname reactor: end for: %s " % vm_name) + + return {} diff --git a/salt/reactor/setSalt.sls b/salt/reactor/setSalt.sls new file mode 100644 index 000000000..5d8b33a4a --- /dev/null +++ b/salt/reactor/setSalt.sls @@ -0,0 +1,22 @@ +#!py + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +import logging +import salt.client +local = salt.client.LocalClient() + +def run(): + + vm_name = data['name'] + logging.error("setSalt reactor: start for: %s " % vm_name) + + r = local.cmd(vm_name, 'state.apply', ['setup.virt.setSalt']) + + logging.error("setSalt reactor: return for: %s: %s " % (vm_name,r)) + logging.error("setSalt reactor: end for: %s " % vm_name) + + return {} diff --git a/salt/reactor/sominion.sls b/salt/reactor/sominion.sls new file mode 100644 index 000000000..24b448f2e --- /dev/null +++ b/salt/reactor/sominion.sls @@ -0,0 +1,21 @@ +#!py + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +import logging +import salt.client +local = salt.client.LocalClient() + +def run(): + + vm_name = data['name'] + logging.error("sominion reactor: start for: %s " % vm_name) + + r = local.cmd(vm_name, 'state.apply', ['setup.virt.sominion']) + + logging.error("sominion reactor: end for: %s " % vm_name) + + return {} diff --git a/salt/reactor/setup.sls b/salt/reactor/sominion_setup.sls similarity index 82% rename from salt/reactor/setup.sls rename to salt/reactor/sominion_setup.sls index 3e98b174e..91a4a6cb9 100644 --- a/salt/reactor/setup.sls +++ b/salt/reactor/sominion_setup.sls @@ -1,7 +1,7 @@ #!py # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. @@ -13,7 +13,7 @@ def run(): minionid = data['id'] DATA = data['data'] hv_name = DATA['HYPERVISOR_HOST'] - logging.error("setup reactor: %s " % DATA) + logging.error("sominion_setup reactor: %s " % DATA) vm_out_data = { 'cpu': DATA['CPU'], @@ -23,13 +23,13 @@ def run(): 'sfp': DATA['SFP'] } - logging.error("setup reactor: vm_out_data: %s " % vm_out_data) + logging.error("sominion_setup reactor: vm_out_data: %s " % vm_out_data) with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + minionid + ".sls", 'w') as f: yaml.dump(vm_out_data, f, default_flow_style=False) rc = call("NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVirt -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -a=" + DATA['INTERFACE'] + " -c=" + str(DATA['CORECOUNT']) + " -d='" + DATA['NODE_DESCRIPTION'] + "'", shell=True) - logging.error('setup_reactor: rc: %s' % rc) + logging.error('sominion_setup reactor: rc: %s' % rc) return {} diff --git a/salt/reactor/virtUpdate.sls b/salt/reactor/virtUpdate.sls index 8fbd5b2d6..d4b56fdf6 100644 --- a/salt/reactor/virtUpdate.sls +++ b/salt/reactor/virtUpdate.sls @@ -1,7 +1,7 @@ #!py # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. @@ -9,6 +9,7 @@ import logging import salt.client local = salt.client.LocalClient() import yaml +from time import sleep def run(): @@ -17,7 +18,6 @@ def run(): compute.update({'free': compute.get('free') - vm_data.get(hw_type)}) logging.error("virtUpdate reactor: claiming %s compute: %s " % (hw_type,compute)) - def claim_pci(hw_type): claimed_hw = hv_data['hypervisor']['hardware'][hw_type]['claimed'] # if a list of devices was defined @@ -46,8 +46,10 @@ def run(): host_devices.append(hw[1]) logging.error("virtUpdate reactor: claimed_hw: %s " % claimed_hw) - vm_name = data['name'] - hv_name = local.cmd(vm_name, 'grains.get', ['hypervisor_host']) + vm_name = data['id'] + logging.error("virtUpdate reactor: vm_name: %s " % vm_name) + hv_name = local.cmd(vm_name, 'grains.get', ['hypervisor_host']).get(vm_name) + logging.error("virtUpdate reactor: hv_name: %s " % hv_name) host_devices = [] @@ -67,7 +69,20 @@ def run(): except yaml.YAMLError as exc: logging.error(exc) - local.cmd(hv_name, 'virt.stop', ['name=' + vm_name]) + r = local.cmd(hv_name, 'virt.shutdown', ['vm_=' + vm_name]) + logging.error("virtUpdate reactor: virt.shutdown: %s return: %s " % (vm_name,r)) + + c = 0 + while True: + if c == 60: + logging.error("virtUpdate reactor: vm_name: %s failed to shutdown in time " % vm_name) + return {} + r = local.cmd(hv_name, 'virt.list_inactive_vms') + logging.error("virtUpdate reactor: virt.list_inactive_vms: %s " % r.get(hv_name)) + if vm_name in r.get(hv_name): + break + c += 1 + sleep(1) for hw_type in ['disks', 'copper', 'sfp']: claim_pci(hw_type) @@ -90,8 +105,9 @@ def run(): mem = vm_data['memory'] * 1024 r = local.cmd(hv_name, 'virt.update', ['name=' + vm_name, 'mem=' + str(mem), 'cpu=' + str(vm_data['cpu']), 'host_devices=' + str(host_devices)]) - logging.error("virtUpdate reactor: virt.update: %s" % r) + logging.error("virtUpdate reactor: virt.update: vm_name: %s return: %s" % (vm_name,r)) - local.cmd(hv_name, 'virt.start', ['name=' + vm_name]) + r = local.cmd(hv_name, 'virt.start', ['name=' + vm_name]) + logging.error("virtUpdate reactor: virt.start: vm_name: %s return: %s" % (vm_name,r)) return {} diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index c8db663af..3e797890a 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -1,5 +1,5 @@ {#- Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one - or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at https://securityonion.net/license; you may not use this file except in compliance with the Elastic License 2.0. #} @@ -14,14 +14,14 @@ core-{{host}}: private_key: /home/soqemussh/.ssh/id_ed25519 sudo: True deploy_command: sh /tmp/.saltcloud-*/deploy.sh - script_args: -F -x python3 stable 3006.1 + script_args: -F -x python3 stable 3006.9 minion: master: {{ grains.host }} master_port: 4506 - startup_states: sls - sls_list: - - setup.virt.setHostname - - salt.minion + #startup_states: sls + #sls_list: + # - setup.virt.setSalt + # - setup.virt.setHostname use_superseded: - module.run features: @@ -37,6 +37,7 @@ core-{{host}}: #file_map: # /opt/so/saltstack/default/salt/repo/client/files/oracle/keys/securityonion.pub: /tmp/securityonion.pub #inline_script: + # - "systemctl start salt-minion" # - "rpm --import /tmp/securityonion.pub" # grains to add to the minion diff --git a/salt/salt/master.defaults.yaml b/salt/salt/master.defaults.yaml index fc7a6ae16..e133dbd0b 100644 --- a/salt/salt/master.defaults.yaml +++ b/salt/salt/master.defaults.yaml @@ -1,4 +1,4 @@ # version cannot be used elsewhere in this pillar as soup is grepping for it to determine if Salt needs to be patched salt: master: - version: 3006.1 + version: 3006.9 diff --git a/salt/salt/master.sls b/salt/salt/master.sls index 40e1d6210..fc572be96 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -58,14 +58,18 @@ salt_master_service: #- salt/cloud/*/requesting # - 'salt/cloud/*/deploying': # - /opt/so/saltstack/default/salt/reactor/createEmptyPillar.sls -# - 'setup/so-minion': -# - /opt/so/saltstack/default/salt/reactor/setup.sls # - 'salt/cloud/*/created': +# - /opt/so/saltstack/default/salt/reactor/setSalt.sls +# - /opt/so/saltstack/default/salt/reactor/setHostname.sls +# - /opt/so/saltstack/default/salt/reactor/sominion.sls +# - 'setup/so-minion': +# - /opt/so/saltstack/default/salt/reactor/sominion_setup.sls # - /opt/so/saltstack/default/salt/reactor/virtUpdate.sls # - 'salt/cloud/*/destroyed': # - /opt/so/saltstack/default/salt/reactor/virtReleaseHardware.sls # - /opt/so/saltstack/default/salt/reactor/deleteKey.sls + {% else %} {{sls}}_state_not_allowed: diff --git a/salt/salt/minion.defaults.yaml b/salt/salt/minion.defaults.yaml index 0aa315264..be405b9e8 100644 --- a/salt/salt/minion.defaults.yaml +++ b/salt/salt/minion.defaults.yaml @@ -1,6 +1,6 @@ # version cannot be used elsewhere in this pillar as soup is grepping for it to determine if Salt needs to be patched salt: minion: - version: 3006.1 + version: 3006.9 check_threshold: 3600 # in seconds, threshold used for so-salt-minion-check. any value less than 600 seconds may cause a lot of salt-minion restarts since the job to touch the file occurs every 5-8 minutes by default service_start_delay: 30 # in seconds. diff --git a/salt/setup/virt/sensor.yaml b/salt/setup/virt/sensor.yaml index e4946bc1e..e90bece35 100644 --- a/salt/setup/virt/sensor.yaml +++ b/salt/setup/virt/sensor.yaml @@ -11,9 +11,8 @@ LSHEAP: CPUCORES: 4 IDH_MGTRESTRICT: IDH_SERVICES: -CPU: 16 -MEMORY: 16 -DISKS: 1 -COPPER: - - 1 -SFP: 2 +CPU: 8 +MEMORY: 8 +DISKS: 0 +COPPER: 0 +SFP: 0 diff --git a/salt/setup/virt/setHostname.sls b/salt/setup/virt/setHostname.sls index 3dd20098f..648559f0c 100644 --- a/salt/setup/virt/setHostname.sls +++ b/salt/setup/virt/setHostname.sls @@ -1,10 +1,8 @@ # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. -{% from 'setup/virt/soinstall.map.jinja' import DATA %} - setHostname_{{grains.id.split("_") | first}}: cmd.run: - name: hostnamectl set-hostname --static {{grains.id.split("_") | first}} @@ -13,56 +11,3 @@ setHostname_{{grains.id.split("_") | first}}: - enabled: True - hostname: {{grains.id.split("_") | first}} - apply_hostname: True - -set_role_grain: - grains.present: - - name: role - - value: so-{{ grains.id.split("_") | last }} - -# set event for firewall rules - so-firewall-minion - -clean_sls_list: - file.line: - - name: /etc/salt/minion - - match: 'sls_list:' - - mode: delete - -clean_setHostname: - file.line: - - name: /etc/salt/minion - - match: '- setup.virt.setHostname' - - mode: delete - - onchanges: - - file: clean_sls_list - -set_highstate: - file.replace: - - name: /etc/salt/minion - - pattern: 'startup_states: sls' - - repl: 'startup_states: highstate' - - onchanges: - - file: clean_setHostname - -create_pillar: - event.send: - - name: setup/so-minion - - data: - HYPERVISOR_HOST: {{ grains.hypervisor_host }} - MAINIP: {{ DATA.MAINIP }} - MNIC: {{ DATA.MNIC }} - NODE_DESCRIPTION: '{{ DATA.NODE_DESCRIPTION }}' - ES_HEAP_SIZE: {{ DATA.ES_HEAP_SIZE }} - PATCHSCHEDULENAME: {{ DATA.PATCHSCHEDULENAME }} - INTERFACE: {{ DATA.INTERFACE }} - NODETYPE: {{ DATA.NODETYPE }} - CORECOUNT: {{ DATA.CORECOUNT }} - LSHOSTNAME: {{ DATA.LSHOSTNAME }} - LSHEAP: {{ DATA.LSHEAP }} - CPUCORES: {{ DATA.CPUCORES }} - IDH_MGTRESTRICT: {{ DATA.IDH_MGTRESTRICT }} - IDH_SERVICES: {{ DATA.IDH_SERVICES }} - CPU: {{ DATA.CPU }} - MEMORY: {{ DATA.MEMORY }} - DISKS: {{ DATA.DISKS }} - COPPER: {{ DATA.COPPER }} - SFP: {{ DATA.SFP }} diff --git a/salt/setup/virt/setSalt.sls b/salt/setup/virt/setSalt.sls new file mode 100644 index 000000000..aa6618b25 --- /dev/null +++ b/salt/setup/virt/setSalt.sls @@ -0,0 +1,16 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +set_role_grain: + grains.present: + - name: role + - value: so-{{ grains.id.split("_") | last }} + +# set event for firewall rules - so-firewall-minion + +set_highstate: + file.append: + - name: /etc/salt/minion + - text: 'startup_states: highstate' diff --git a/salt/setup/virt/sominion.sls b/salt/setup/virt/sominion.sls new file mode 100644 index 000000000..328f50311 --- /dev/null +++ b/salt/setup/virt/sominion.sls @@ -0,0 +1,30 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +{% from 'setup/virt/soinstall.map.jinja' import DATA %} + +create_pillar: + event.send: + - name: setup/so-minion + - data: + HYPERVISOR_HOST: {{ grains.hypervisor_host }} + MAINIP: {{ DATA.MAINIP }} + MNIC: {{ DATA.MNIC }} + NODE_DESCRIPTION: '{{ DATA.NODE_DESCRIPTION }}' + ES_HEAP_SIZE: {{ DATA.ES_HEAP_SIZE }} + PATCHSCHEDULENAME: {{ DATA.PATCHSCHEDULENAME }} + INTERFACE: {{ DATA.INTERFACE }} + NODETYPE: {{ DATA.NODETYPE }} + CORECOUNT: {{ DATA.CORECOUNT }} + LSHOSTNAME: {{ DATA.LSHOSTNAME }} + LSHEAP: {{ DATA.LSHEAP }} + CPUCORES: {{ DATA.CPUCORES }} + IDH_MGTRESTRICT: {{ DATA.IDH_MGTRESTRICT }} + IDH_SERVICES: {{ DATA.IDH_SERVICES }} + CPU: {{ DATA.CPU }} + MEMORY: {{ DATA.MEMORY }} + DISKS: {{ DATA.DISKS }} + COPPER: {{ DATA.COPPER }} + SFP: {{ DATA.SFP }} From a425a7fda2034af268b8fc2819d1fdfc6518e2da Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 27 Aug 2024 09:37:23 -0400 Subject: [PATCH 025/303] update docker modules for 3006.9 --- .../docker/docker-5.0.2-py2.py3-none-any.whl | Bin 145967 -> 0 bytes .../docker/docker-7.1.0-py3-none-any.whl | Bin 0 -> 147774 bytes ...none-any.whl => idna-3.8-py3-none-any.whl} | Bin 66836 -> 66894 bytes .../websocket_client-1.8.0-py3-none-any.whl | Bin 58826 -> 0 bytes 4 files changed, 0 insertions(+), 0 deletions(-) delete mode 100644 salt/salt/module_packages/docker/docker-5.0.2-py2.py3-none-any.whl create mode 100644 salt/salt/module_packages/docker/docker-7.1.0-py3-none-any.whl rename salt/salt/module_packages/docker/{idna-3.7-py3-none-any.whl => idna-3.8-py3-none-any.whl} (85%) delete mode 100644 salt/salt/module_packages/docker/websocket_client-1.8.0-py3-none-any.whl diff --git a/salt/salt/module_packages/docker/docker-5.0.2-py2.py3-none-any.whl b/salt/salt/module_packages/docker/docker-5.0.2-py2.py3-none-any.whl deleted file mode 100644 index f1ed95ee122f37731b51226ccbc8d6eb07405f39..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 145967 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 I0)-g#KhNfV%K!iX diff --git a/salt/salt/module_packages/docker/docker-7.1.0-py3-none-any.whl b/salt/salt/module_packages/docker/docker-7.1.0-py3-none-any.whl new file mode 100644 index 0000000000000000000000000000000000000000..c324efbd08e43702330255be41022230df757452 GIT binary patch literal 147774 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νsv=4VNYjF8rcz{%)OXa%MGl~1G&aaT9M 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 literal 0 HcmV?d00001 diff --git a/salt/salt/module_packages/docker/idna-3.7-py3-none-any.whl b/salt/salt/module_packages/docker/idna-3.8-py3-none-any.whl similarity index 85% rename from salt/salt/module_packages/docker/idna-3.7-py3-none-any.whl rename to salt/salt/module_packages/docker/idna-3.8-py3-none-any.whl index fa4c95b123751094438c2f747e5389c32d870c5b..84d04cdf9f227bef8b255e71874beff94417dd74 100644 GIT binary patch delta 8176 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 delta 8143 zcmZvBWl$X2mTor|2rj|hA-KD{ySuwIu1yHRN$|!R3GVJ1+%>qnORxl=bMBpa=f0`g zKiB@&s@l71RedrU4VN4Zho+_o3x@*$01yGCW^+2VXfi-J5X4)zUJvL93-@;^X$bBJ z%=a}~FAcU-Hy0TI@L>l4Q2y$$w{kIOwR8npv$*-q6F#}F@;v&yeK5NJ%*4f$1@Ym| z02(K{tQQ_n7Y(>onNM?AdnC|6>G$0SUVlG{Bqqu!1m7*>*^+xpC2T&)bBrf`IL7W$ zNMfQ3B%R}*u$L8`YB3Wx5&6K5p2!d8q_e8PrVM*#*#Gq%?uOz(K2UC>i2r$3PWkwT zZ_2L2?0c^cn$lDA#kupJT{iND8=e{K&M`ViwGPVYuU$B)T%NVyl% zPGTLXN+r?_7@URc??Tp5I4}Z$zm33(!F$KxlfjIbsliYh#Y>z;-^2VIC-v#gW=)TS zZ%v-=ak@1`ioI%-8rPRIQanL8Mns*W>m>W7i|K|=YpLhcZSWH{m4NA25Pw_*-%S?E zPe$Re3wI*@KJM2TNoMk#gnLYq_b7JR;NGm-j$sQ> zb^4A4V`yw~tCj5DGKKoowfHrUVxpZ@m9wuQ@5q7NuKE6b5WH0E{AK^*(JW=KL}*)Y z$Xha}IR!@0G2)i{eqc46T1c#$JA*I4g85EF=t+n$>-DvG@!gbxdfJ&IyaH4;pjXGDXO=*fC3lcVNNa)HnZ6VL zp(j;G8QQ~?Dv$Z8d1wYZon2y%t2YhCijg0~Ss=8dy|c<$M@~)-9HOBWrGRExa(4Yd zg^~Pdx6Z_(!}OW&dxfrrp+^e4NB%V5dvI2171*|s z-yMzz;J)ARi|7yV12cEKc0^5N(74-U$jEV+%=)rKIK;S3DC#F!qVJW|w<}N={W8;# z9_5b3XR>OQ=8YjN>$qQAZZyuT#&=!yyp6V{Sj)pC2IX+5mYP=C`_8EU9}MRTaZjWUd~diJ^54(_oko?`v4ZZ$cNha%e3(d<^s+>{IIXl)eH@5#qI{> z_`h!`{5JGioULwFbUfU~k`2@+me1OR5l_mW@ka#4xSnbb>ugN{OLWATs@S|?m!4@k z&KqcWc@$qFT5SAErH=2#QnsSyVRVbf#9MNRO$R1~splc4QMz2X$yCbq_Fcn0V#3E4 zpow=xckq4KEIe%PR~rFSfp%h8oPA6~QRA4V( zX;JwSRW26Vx1J5%#BIlGPzLrhkS63(8f41){5d^$?|U~WoY>M{%$%!Hhmje2@xoK? zzk&&8oiI(1-0+9Ptfzc!rv8A;dHDGrww?9}LzFuUhE~u79PVr_^QVf4qnmO#2QOkl zKD;ZFz1T`6aWiuW1E@*sQktqWx5%)zeoK&&Bym0>eN0BVa+A(HJKqQ|IG4kS`c#K{ z?hrTIIUIZVVuR^4f06h7K~JiYARougSFprx(^6x^2nuP0WX;))0S@cr{?^Sp4RB5p zNz!$X5#zJ@pFn1NZw|YHv&4p)xCS@T*>L9q)b6x~RJOwA`glNqt&R+1r*MoY*Vxfq zfj$BVsO_t=o4ewA+*UpwrgzaWviX`-I&ndX9`MHYeru)tJSkM>&bLv)y-(h!63l3@ zGGFeBB9PMcP}UhSL%vUn-E!0>O#4}sPDe1aV&djAsLMS>tN}&d9)O=4$z-E7&==RzRu!K6RvGA|~bgLYA>#H!Z!T(*&m5GC6mZmLSN zO~y&A=3J|7T`h{0Db=z#9Z|zfkz2mUl9*btbmpKY*$dO@N~ZK<%GxPr%g9{g-6ic7 zPmkqz+eKZ}Dc)cxv&dDr3_dcsQ|Fnz^#Ia?vLOY+E_{ykBN~hpgpFaR)t3MJh@n2C z9e3l!m&Vz=+C@Q&Q=VQY@C4WG2|{#HTsxQdf)s;n-ag}QfA_$v)0m^1{zasti!fNT zq$XBF(1t}NVlKAQZUsvBaX4ll8W|YOkwUks{Vf{4P^j{oHf^rD;*&w^#g8991Q%di zP6p+@HjFpKXNq^Y5Od9X->$;~TY|s>{U61E*jv{z!G0g5*FzKg!4}_HT*b9vK^hu+ z_6gWRgH@-z+Fd~J_F&D940vLbP>lx_h+EB|DVYZK36ozB>_B34EfB7~^6?m+UxY|O z(a|MgIKU$4j&oox+65kC#|Rb9zZmS-#rhxPG2jpX+g*<{aE#r;Sn`va<<4bv{yb(6xLFYrS4^Z3ZVfF%Myzek zPJm?j#;@jGtMNw*E@64zWiqQT%8gGX${RPVXpxy;g)s1WC<=RyEc}#=8!xz&G=F(d zpgYzW`-pMM{w_?q0!@s9mNk!k9D?)BDS=41-t-cUKFUieW8#cP>DMyMjh6(EOAOSo zxmOBvd)ik6yfZ6Mf76_-VOoG0abL1&Agpz>7SQOQex*!uyu8n!b9-28YkXtB`A4nk zG>bU8jE95R2hCdcWuXS3h&x|ps5h(Otcql~)1a=EjOD>Aq+S%1QKaVWHGqa%GM2AD z#pm-f{!x!MBfa<#*{`qla-=@BD#J>?>pb*(jVq-K_#~L6@OfRPx?`+#_jA?d>(@VK zx+bXsml$XYQH|0eBpu)&<;T~ZJ4Y_+cE0u1ln*fhPc@^3j?cdJ;41f%@SC^!U?W&b z*B5^iqrfqfv*nAQZo6+V|B(N`34RgQAHOSp0N{!p2*CIsg8w(mx61Fv6!@1IsP9u$ zf<+|!3%sfcok_w|Wyj&vJ=}o-{4?oan!!kw;omYMO0_kMSm!T%-%jQgBP;*_j{pFW z{P%EXP8QyJlQSz=Aa7FNr5iX%{UYuN4FJfc1ptWt1H)ov@8QX8?_%T1sw}M~E+wud zzHYGYLOhhxRb5PP1shpln~^Lx!eNOlNVy+Y8;qDRN~=4TagmWe>*;gn?d8GOrNBfk z7k|2TPKg-*1Si)q43l~G#WW=N3!>hc<(ZF)_T6oK1K66d^*vCWb6vZ5^3o^RA^TXy zx=g)~?0AL1@M0`r#Q2xd2Y=Iy3a#$}U6~!MDl6aB?m(ubDREVb^ILJF6U72a5lw1E z$qjSzf%w|mE*d7=dxJCEH#0@}jT7Swl5r^yUC;eE*J@CriZ?fx=-*}5)~|jmxUD)# z{R?xlJK)0C=7patsNWzAige;S>&{E%y^ei<#ekEjW(}OD#Nju|a)<{P9Su#koQ@i^ zWUf2#P^{W0aYwzjDRvrkq{WG{%Rnn-3}lC1{xOBO_P?7>(_1-AH@wNl16N7VT{?GP z3@?3sPf5tu{D;<|tFEm9Pt3nvTK7vzK*|*T?8>TWT`9=M#U33(CcnRF8m1>Na*Q8^ zi-57~hOv!vsHpb_w{MarGJj_+$=9njn#4Q?MK`!tI!I)G5S+qzY4zsC_McB%<60so z|LF+j>C4&W*3QC$3loyb7$+uC0+CdUqJp!`XGde9ljr z!(#;}Vz5-s2!N{Qv0CCMyN5N6fr&{215sEGnE%2@LD;$=T_HtVSw&9pf z(I%9xA2mYJ%*;|VQ*pnb+*2WSByz4ELPj?Hgf80hQ6!dwcj17Ay=^;LoA%n%#_g-63uxYMao8hgwg8Ig-zHEwZdX|U#Ra8S_cW@?k$7FtV&7Ht1?;n< zy0N>$ z`_rdqunFsL*_vORzT8wjzcNaA@a_!o|o+bXX*Qw<#eeUEa1A<~;w_ z9Q~6u2k1|8zK1%pq5roKTWxW&Kd&Azq08XBl;>23%uu-spN5fGV2^cX_CzMF>Dy>pE{=xbj?cif&Zr&s1b9%aoU$*d~+$ zGE7_T=aM=fl*G4D_7C|Tl~Dq~KdwI1gt0*aw}`!PGqcB?{fYJqn&7uDW>8NEKJwnI zJg{g<-*2S!N$3vYr! z88#y>!?9HA;8z}XgD&@|I7oK|>GBgkyb$3+3`J}YF)Bs=B(y*bIR`#krbX8>9+)~J zn)>d!zo|}5@kp;eG|GU{5~sfG58@*XdFJxCIdf2-gS+>j(iQCzxF_PV(xU&elX4k4 zCTje8ciqh@+Wo8udN^bSdq0SpzMhOtvAnrGK*mH(gM*7TsWHj_#7g+DTl;9QsB~bF zUX(mIb!0)Rf79yT{r)-+b*Rq1ZX8E)pMFS6DrMZq&z99kl7olS+Vk6}rsq;p&Ad8D zH5E&03U|?dZn|~`b0!qhA{KWYulv)&2QU)(y#Bs1ec8MOcOF;^=CDLRq1Oradx|Ox z!S?n494w#1eozfS=NSkveWU9i{-IiuKv;da@N`YIx9|io`|9crn`(>8kl%p%IuBnQ zG+iA}j_<|6DXvpkQpMEhf^h7XmzrF*HOu|fWLjl~jv_$|{uZrGeJ?ht*iN5t81`LD z$CsHr0u}KsS3kl?2`R9{DxmTP>55!aF%3p&dRtQRZWK;m1Jns`Ln2VgRWn(4KW!VA zUcN7;i?oFGuK8FA;Xcs9n0~g~m4*sTi3@Wj7van4oG`2!8VO$H06yC55Nr738y5I} zp)`LFsgm9Ud(BFE&3~Ln=%0}|Y-Qz8>y=nE!TZQxnReWf_(fcC+OAsC6s2Fl!6(jc zr#`Yv?I#t=a6wMsubjg4wqv~Rrybs7B}ff(dTK`uY<&n6rI3#-*UaYh_~`bil@FhU z4Ei;Dv{+R|HK!vv$H{B;dW|Lb8r7E$52dtBjbfhzyoee*_2HKmssKeTXGGs(X2Ub|y^gSzf`L*%1TMGb!HCUFNm2BVQdn7yfh9;NnHre$Ww{iZT@7 z!0R{$_Bj|LYJ!u?G3Ed8W6|eFSxiI0zb4Y7H5v8@*wt7d)-J|k*5=DiR3LCABP_1)I&aH-!|b)cL)O5=ZE(!bjiODVIHLE$s?=5uS7;EqIB+K15{MQSb=& zH=Gb$erdGAJ`1O3rwEX272QNltz^h%tRT;ioFmN6#ABs-#yA2UKh-xApVt&8_#ct* zKfRz__K>b|0kQj9;_g>~3$5+-?H$fStdDx@21-hrHvog;e|d7v+{cJ%p z(V3`BK}r?Yc5yLXVsF2_R%%EDFd{(+lSpU^W3;I>8K~t~mRx;5ivgnWpX0IZ9L;j1Gq_;$SQ))dm-DSZn*d zz->pJRJ;TD!UflvyOi`C5K-ts0&q!#uy9~4EsRxI14(#iP|MsStEaS=Z_kv7bZT+O zoXeo*wuY?IV6^RY+c9g76Bb;&@GA3hD~5pY^;(VZ+HG_knOj?d<8~2~ZXa7{>*I7i zP)7#E5guMJ>e*z6{)HNpi?hEh zZ1SXdEprQ68(C@F2<&QF3JxkAZ@<%0;a3gf&9LMm7*gVgtYKzTYxjJlEH8CNM_T;p zri=u#Ah!eMyXYeYO=#ft_0_on9N}L~Q9x|Ckb@R@~8ypI)!d?7~bWs@iS_EE4eHneq{)z6CGt z7cjp4Fi!lHHtKl7J9O@;@XK;FT)^pcSyC5e?#{=1PFI7s-jc`L9|d%tD2~+8&pTt|^QOM}l7caS16;eSYeC1TwDD zIjb0)M}1a7D{1l^q#=D=D%VnY`1Uwg$2=&9A;mL}qi$I_NJgsV--g{saD1L#h&7SO zpX#2)PmG{SU3`j=oV>n{+A7SaIpvps5O_Dp_=)M`biw`x=JGdiX(Wzu#0;4h_l*wEWIc9Sm2log%V5=GOSCk)BW}fH zKPh6gu+vD1>XlZGTD9?1ZHMfLV0*$u{N>_IIh<#5=r@x(s*^6=EM;CNzYm%D?ChaFq7(79Rqn5vt|X&MaV!k$;QZj~go!K$EG$0y(C&vgy zA`)x&H3KI$kyIll{A*^8+QZjvr%yCTI1N}2@3S9CKvn2I-Pi#z)B5Ej^l{VVc$X4= z3qHh`gwQQva5Lf~|2&semiG+S{lxQLEM>&S(QR4N&*+n+rZMTQ!y)Gz8x>(0?Q+wS2w6Iu!)F5@9zpWcnTYH$q80GnmkM!`I_}uf##t$a4^l9~1WC?#svOUy|GS zm`#P*(xECfV%FWgiQq!@}lZmNY&-(SIB@_HvF0{UQg%nfK78;EV`1SL-7s?UyT z7X$KkS%c|_j>!6^RST6(V=X2#1gr=1#1b$-XTpN1jls3UPp`C!mO|_AcpR1HU?Ot~ zz8VHIne+;kcySWD^^b^YE0AlwBG0Gfq#U(h8!schYmrxW7Y-- z5otpj0`gQOkS8bYuRf3lw2j>kNpumSAX=@c4Dz{-*kzX)Rl4AXhF=BfV-N7P6>NVq zA-!Pe)R@y}W~7m?II6uij=ia3W9430fTbkz)@&ZEq|K(|zWJV$$>m2F0-3IAm5_F$ z;<)`eOQ)}_6k&X_mB<|@bMtwE!{Z&;Pc`t8@Da^Tv~2n@MDVSNWM@evb(~G`T^7{C z&#^2WlTiujdj!7j0_r(Z_>SJmsWYf`3r~LI&dLOO`n!^ma!xwt8r(@6Vrb7*-Bq`m zvNU3I_QjrtB+2qFvvnceU zs<;s7UpN28SN??u(n5w|fyDNIr`ktqqoQB40DxjzSODf<8}dJ=;FG56e+SxLo*rC0 zR_31Of2G?0`Go(=!}_Nk++bWjLTHir3|TRMOypk2%zX0QAVl@B& diff --git a/salt/salt/module_packages/docker/websocket_client-1.8.0-py3-none-any.whl b/salt/salt/module_packages/docker/websocket_client-1.8.0-py3-none-any.whl deleted file mode 100644 index a2d768d7937a90e7c5ecbd51c1332b00c9e3cdac..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 58826 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%0DCms_LKk0sdE$TuK|H_S+W&{PH9J=l4HHq1$`V zI(yig7z6(|N@Wrg{C}+YE#Uqe^X_cod19X@d$tb z0Q;uJAW9mSj!oq%*Yc=={Lv z-%sVk6Zc29+1m-_Ma_Q|OwNYr8->^!Q@__U*uE(-aCo&pL1LCM_IHL$Mg|9>{#CjE(DRj3q z9f~?Ln2fBSzPfEfaEx2|m;umoJQrCB{l}OJ?NeWn2-U?$Rld zGjVa~Q6VzOsjkGNBLb0$BP(CFcJ$}Cgh~Uicwo|!2$v_B&?u*s{==gKMR4`dr$DoK zoQNFWRa0;GMBf_|-5vAc`2iVE?6vmJl`B&!3ZOYWRNqx>7C*y&4)aMo)nNty zhw+myv}^jx#*E?mMU0_4?i`C>MCVeWRMBBN!;fa%MC=}A86%7LIeRDbYP7J(ML z!T#(k)a^<-4J9osRQkUk%a}UR)0LGAr$Rr80LLz_sy5UIk6}f)EOa+Hwk01FscX@n z9URq6QSFV(TxQ#2lHhyD*jw>UfEuJfqrw^kw(aoQsGn3 zt0?^GK!3mZvYda#r}zs?G$z5s1%Ekw{baw`B*5=%GvckzmU&DbL2Lhk^S3y~icZw0 z1rUCM`MtjQ_2L6wdWPAJR9MrSf?iK*GRUajTR^O%N*RkUM>qZ6xULi+X-P=$tH*0>spn%iR1RuE93E>t)8JW zlL=G*mIV4DrK+E;*AZ1jNlW#iR0do=#tSc?+_^~qDK#*byPDRm(Iqw|7f=VS42k*B zV$~fR)2h4Fk%L11)6H!=FD(McQKiJyt@Yha&$6wZUR97yBe&KAl9_WYZ%OXjdK(tk zN!1nJ&1_RHSEx2k(nKp0tq<`%e2A>B@SFTrBmj%^vp)m>+^h#S%g*C)K&~=nvIY>3 z!J;F_1(d|@h!=o(B`TFlP540Gw9|!Wm8cdfBDh`dYXk7GH^GI3Y;Xfyv1I}g@Q@5k zpKJTvpO!SYUg7_%z?J9DV02u}Vfd5^e`JV;ue*|t`Xe@?VIMo(!sixa5lIt#n%OS~k~nZD zZ&`##$n#!H#Jv#i&7QJ~EtfuV^3}*uc7_QQM8+OR|CDPUv?zx@6>E^i5`@1AV%imD zsHpwwO`s`1wMrpUjHziST5X^yd9X%oyPKo}@!m$!n4PY|vPC0?t zi6*cj-P3NDG!rHsCis!iY6`2Wh8t@;W{Ads;tBO3!~cyEl=69-5W~F%kS0cjYj>U$ z2Z6Y<8N2-$UWrJtIg1kkT1tSyw3A5VF%4e(pivJJGpvxoamILywQAQq5n)2FyeBgv zK#K;X0=dArO;Dj0=wkupwJ6?QG&NnhUMSL*P$w>Fn3o@}J-KsaPKxoyFE;Xt5GEy( zT%IJ8=kFSd_qz*7qZ8;zw1G?tt3d`ak}6Ew45GUKB~+wYN+p|wYFCETE3P!n*QT0n zmI5FvL~HJH3 zOYn;!x5FLm=c$M2ibGDu1vxb5LTg`+Zdl(x)$UGXe0WRz$p6zUbrzYB(rzRP5*eRP zicL4?fg}Q59dFlOD7C}B=-?8sL2m3iVH7wJYFf}6mq>schjMFzQM=ywFlT*T;JfY4 zgfB~8#Ci5I7P9n=(-a`;#)Fv9Wmsv%9$_7}dg6-iv5M}h0_SYlE*#Q7TySflP8Lp* zNSbd)xA-(=Z-3>J?a?&%7&f=)<;R?pbn{;9X3zr1N@_(cyyl7S+E$oF$js7zG~3BB zl_?KCG`BnT1Oag(IZiWiFAO!0R>2*9z-hidmeBvVi!i17LleB0Fb{&&=p0$;n9#T1 z40tr}5KTruoPmKvPm~2_&e&2GP;?X*R!MAGS*$FQ1|zE9Hu5svv1KJer9bucR(Lak zM%#6Qwbh((GSfrIXPL73OcQjhm*|?-s3ENw@m~SCp?cj83Dx77bKK!!7?9ylM|FSS zcIdd)P3jd79#2+WI8Q1G(H&6bsgX9+29;P+n<4g9){EN)uPrz2NAI2?gq!gF3y~d( zf2iQMoZw1sbNsv$EM3Jg&)QH5j%q#>!Kl$Ac>qcR9Pd>CPO&=W0OU@9F{qkugdXP5(pBdFRs71c<1|z$1pN zrc_vW;h5CmO4SCfuFCMQr8W8^l#0eEQ!zCxBVmXo04v}HyebL}gF+1(%`OAdwdJPF zDIqfgGZXUW*OTSTI#i;l;D~M$1Io_Y*81xoNvGB1zeub{@Bdn1t856e^BY}x!i>|r zmLriVVspH!J0c->Y=ayym;2W6ITF!r%!fC9g7Cs%Wus7K@;!in%0X4+a@Mh=y{HR# zyV^gSyx{!kbbsbm(fnF+)~jh~KGxif6egBu=&^<}mOhS5BD_D zn0><0Ay^^c_!AOi*AFV~3C96bj`c=m4x3|09D$ZyH%anMdE+iqvZKbB>e?=Z>cr}LX1!8__9{R>FLhjO z$&#NaWN5c(c7n2PsKL}iziVAC;|#IR!k4)|uI8>ld^TI)Op+`~vgGQ~iNxlJ|g&+%fJ@thf`sytnA zf#hFOE_^c(4iQPv;kz-snt0YGa{@t7ET|jx(GBFbW>c*w65l}pWb_V%zoja(*CSbC zi$rnuTU6OT@PXh_>aF~{)LEcV+d|hsgh1{6! z(2_PHDJhMUCOwH(A;mc2bHe&iwX5S-d(`{QF{O7j`Dx%MF`+b^{}_G{WPl4&T&=v$ z;>MOb**P*}ew|;IU7E#SXVQfMb%ZuJ08L33KG7)RB8go2!f&HPZhs|y3Y-e|)P-z> zILU_H$m&;uQ}#PA8(ah1cPs&r%1uio!aBq>Py#RJ0$e< z5=;c!VlXD%v4hCu8D%g65I{EjPpHVZw6K?!+mzUfV%;Ccu{kbnmmK2Qi~3CgeQ11* z9Hh)x;BB?C;JtS=MCrQ!_OsgFe84YXw&U$?{OxXBkD-gKwNb)XxQf1h*qf!em&*@{ zM~?QsHksj4GhY~kHk$R-@2`*j&rckoLYr?t9NYoCYuFfzyXrs`?N*J?*nl z>87T*pgejf6v(DQ&?mbd@1R3eGr%wbsyszJdDb|1O9YT11i;hAeZ<~ilK``P;kZlS zRKB~gyRQYRN8F53#K9j3JxI4p144u&1Kcbo)Ay~0wa|ehya@@Bf1V`@E)dn@o&4%D zV5C;SVixLGkXnN$wl{n;gnew9{C(yyYV2Vn+28#0;B94-_9=hEpc|6xol{Eu;1uT;BNv+00A*yB~a+>l{p9{R@AIwgm{8Mhl zAN_%O=%i8XC2-S*qoeLwZ0DM3vm|gwl*dHHI>8 zj}Xn25qXi^Eg3sxK%_Jm`f!ADf(l#wg}?@SfT;lD*=XP%Hr>~)PM%5%ix%_aMe%cEib*P95ib$L;aEUe%i!+F9 zSQ=yPB#>(EO?_3uh;OlycmeWSdR8;QILKzk_d3B!W^R=M?D z4%9Js2j^qIJ0{FJgN*(QlT4P0Mj6l?KL!M7hfISj0UALjr&tbRK($p)#UzhdU*+-p zm=o*`?EVcFs?sGWcM(__?YPh1%9Se%C|3YmKfEe@ZoFFXy>UmtyFpO=N2eUH95|2_ z!6L$t8$bamPGl&g7EY<)C1M+IE$5Z3M4Y4S0bM=4sf=M<(L6oszJJYX9uS#c%cT$% z473effbaOa3HxCXrSlx7H%%96zsAdd0~h*rfG|B>;Ks&r4*y{WteGR=W)Hga9#n)z z&=MB8Yh%IVsxuY{#|o<+?q1i5?7y;R6+sDGf#)T-mXM2LQ8JSroLu_k z;I)tPFO4$GTIaA3*^c#f$YV*4VE@p9Oqh89tnTs&-Yey=sbDwiP!pnx|IMKnpgh;v z&fM>HM2NSG*@jHu2~3wd?)9xu-m0^*1i`+@}&_b5B+;hfj#%fSDeU5 zl_H9kldnVil2NfA1l37Zq7I)Z&0F;sN&{*eZO&ilTYRo4{D9R|4R3Jorl!{%LSE;c zetjJ;w3?`onuEuo0J|@QDRxc~d>6+2v<|iBGB^*bxIh=?$phf#DBqs$SIet1lQ)^N zz@J_f8B+vNsc6Q?`~^Tf(O%|1!&W+UdX!&u5x4*CF%j=`)n`Rd)bo(l?u#Kvf$-biL99*A_^Wep9Rzgkiwen70HoqD%Sd z-C{;MMMkbmni5WyMVoSdd31Z3JPl^~-X^eRIQecAUUr;o??*fs-gPrTkVFdqqUSDl zOzDp7|LQ-ymUSPSX_+Z87Q!0q51lgH6-C*+(z6NUZKp}*xdn|d*lAo7k=+&<7;=rD zTzNt6Y5;0UNj4A~VS?b9PLvFrK0$mz4>)ijyztbPz>*{nX64A@&J^GwUFn_S`Pv7& z-H0(m@Vp=({la79a{D#Ciwef;xa`5?V81C%D=J{deDcd#jL9@eFSW?$L-BKMXLY4X z`lm~?@0tCU=P3?5i~`Gn7<2kmSOzRnIwc6FZ?Aa?)oRdk4@#PY;k%Z*F2+&s{rvwk|B0 zF$>w(-0jiQqa{mlTb`udYwV{dtG5O@%p!19eHeq#c7R}PrIFJ{Izy@kPE6DdkujZ~ zJvzyKnpLN&c^8p2qn z6Ec4~Fyp>It_dJP6Nco+0=_S7=2CZcbaxf)>KFw^wiCrpnXLT z#f-%8A=mvF!|fU#kKwgX_pEgf!sic7$N>7s(R0x&!>;FyBu21mQz{^UGF>~oDCm4K zsD_(bk)?*zuY8ISxSj_v?hUOf!H+Z>74e0pUy&wJ71?px2I!k_LXn2Q>uMN)vIct5 zxTSYaPQ&LUoT!RZxLub(eH)DMb$U9CPNhJGXH3d>k;=PL4vnuzdV_qRzNt4&6Sh)` z{Y>$42k2UBY$97+V#*Px+BQ~6di17V#Rgiy6dIAhx)AeMyz7|G8a%HsZiCL&3aDDs zitLOcIc>c^1FH8f{`YfoB9qq!K7TZ0U)D*wW-I^9k7K2niu-D>?tFr`UL z4SEYU3Gb_?G$S?ImRSR=khxiNb}be4hDYK{4FSy=-tgoivA~1IIOMs2KbX^@5ojqnWqEgE#OU5Ayf&JKUC)+?;dQ93p zvWMWc9&W*)|e16*CqOeW=qy{YZ-%q(w4o%*3ZN-XlEC@?t6F&Q`}_A$V=_qKNl| z2f3q@CG6#BV!L2}TGbZrgCrD+D&w3lytYwBzSU!HEOS(dHC_ZxQi^u&(@gZKC{xgC zu%wN67g>|zhmnYXpv@apLdPK0K5cX84TxX1#dg~g^t~IW8*Ovv^sI_!4YGh#P9&MW zy}g{8SAMIquM1rB82kedYKyquw**9Xc}CoOl(#B|F_lAC=cEr)mn@nm1aND+@!wIg zapR$P&8CR|CeL>vKLT&oB@TvrY%ZfUo~4CZ;TB8~Xrzmpsf75Y(a~Gqm5@Y6{u&F) zgF~u_7+%E#<8YW#EExPb9(fF(X)^7~k%Q(M#(GG%OQ8VCE1Ws;rvU}r*lx~0{QQJr zt1UCFSu~N?j|+Fh$wjwL+@jIw=abwOe5F1Yx>^CZO{SqV>%>>+qRflF)@TM0@u96J z*N6^+G4?sRDhZ*miEKXSr;hYfoYvH&k=PHi$^T(~0{JK$0Vq*+8z0wE0I+E>Q!`z) z*`(~qmb2Tp>4h1EaecMgiL;|#gsiL7Lb-P&TNyiP_WiNF#KDe8(zZCo*MgQ2Bi0ux923 z(`S{E*F&P9^3s^d*_4bKBaVH4qk%trw2sK17u>K|ohAwWDyn;O(ZhMVt;nFb(9K+j zj$J;leh8ke@P%jQ5QFOB!hOq@jb*P%mA9p&=%*mVgD_$8xwuCZQkVR8bwDt5exj%A zo;_%`0Ta4(olpI>DLW>|r9uGw5fTcfIin73%qZe0m-%Y)Rrk+hnbHHn8x_mT^^9k` zT-C!{%CphDKHl>1pt@Fis%I$lHzZf*I)y@p=(cKL<$t*qqIH%SV)Wv;fhj_HEx8Be z@aHGch0M{jxWK6dI_Q1lj9tB!)Y?c7Y z(`|;WRFW3l4-~7j)9BAj!+EdO>`W-f7XRtS5V%==27TWn7_>$Tzen2TZPj^2Qvhc;S$^|wA?FIjttt{sXQif z9d~`q)*T_b;T{ic>WN6Rx{@}%Ped*nB;=aon?4vZ!W*D|CYSB_VlCKAsb1r8tCUyX zG)hOFKHxT;E-a74YFuKFLK*LZbxa(b<9#M1r7ynNpw9DdkQKU@W~aJ~oxCi1$prIT zgNhzo5qm(c*?oDFk@Wlx$#ufMBzu<67 z{)ja?pKrLhazL@%#s9DI%71+2v(~48&3-r2*hK#?rbuU$UBRna&LBqvNb+rsF`qkjMw;tcg3 z9GF$Xjsis&&Rycp@aS)m&g!2Xpj4wM`WD(XYEVAXaYhK$O$c;CcX_WT7zNf#Jl>Aj zzX+>caH9EDQm9BQnx?0($qG*Sk z^)-*c+zewWj=mXG{>0VkAY9vYD02T<0C1#xmUwUuawIRF2$p{FjVytv6g+d>{`6`T zB1>B&ag6IOiXixJ$DXyW+O2zVZK|P!pX#bxd2!p_`+R=xc3J7R47$*=ci8H*-e#@S z`aFZ?u=@i3wr!_-MO6vRD0lfo`o-5u=M&*&(R`e>g(je(D=r0Muc;$ZF6K#m zS#xD<)*%Kg)TZ@vHSCykrP}a#h~C;K9VlAAVf5iP_F(W^-5S*`Jt_RQ51?Q{pLt{2 zee^LskFTCaMT5~Uw-T4J?${G=#8ToDOr`zP?qvFk2eRG^J4EmhuzfxVY|%XosnB&Z z;f;jW5rtDqO*R2fNwVoimv(%1hFXo~}{CnfbS- zLhjewZXF3^LSaTSC8&{*WwfMMF71(l?evb^BgAuW8=gWnk;K5yO$89MY*3>>#3Wd& zNOy1QS4Oc$#d(h=uTfY?%IMWvFw$GTEfdBCA)m873It?`Oz)T~?Z@hyh}JI=6Ne*f zJq==Sv+k?M3Qk{WMy|*qaH2pKKvK6R;@s{1ZJ3AZKQm|%{IoWU%Q_zbq9i*Ybql2R zk_YbEGu7?+Nby=YOM<0xbKpzU>50wW6qeAOSL>bmgCM1DqPznpzBkQhikMv+7;nr zlNnFJpk0=9eKP(2^T$ns2pP#!EOunko!n0|rVpyDnR$s!$2^Lk*boyu6|+?mZ4u=I zC~N)_Vmr!8*la0MBaXh-fubZm{}fk7&P#+?HR>y1jWJV1T=Fw~rV=CaR}~@hdhUVyaNO;Cxg#@V@nUy;Ceubi<>z(p zm!NVRL+zoaf2|1X>*r^oPJ0WfLNTgUxK3S)Rlhrs)y2=d_Rvu_(O65bS6+Af%`}nNf%S)N({ZcxS7zkYl-RNqHlRh%uL(VceGNi`xZo;hw?@M7TW z=$9dTU(qm>m}0-t-$4dN8nvMOvY0Iy@qkFth&xyA&=nsCPwfe^CSwDK# z_r}Bg&{AUho)ZNiAWASB2)+=el)UPnAk{CaDvJcUu9h(fYQEsl)9BjA$)ni$EV=Z@ z9<`&nD&Y15T&&~X0M@cl&0T4HEV`4Zfc8El8OA3v@T0%+vnmpe<3OKAT3e-=#>I8J zyWQwWPoL+{_kYWuuKQ)2lo*gqa1a0hmc{=s1n&QGz4?{PE#b)8ZHzum>oJ-@RX3*? zD}IMx35lX=NJeucT8&AfOA06)DwxV9X#0vRg8^nOv&KIKeyQwa&}tGz)NCaT={qt^B_!yT(|=|d_Jm;s02m5 z&bc*9V-3p}*nj~(0T0|}gJx9lZEX;C%a-})O{>nzDd(|^(TBAEBu*0rLo_@Rvy4r| z3e~ZkgOwV6FfOM#vl+z1Df=Lm3!cIorK_&5uDHa#TPQ)^g;-vEhj>aFbw?imVa<<} zXC)0#qC2w;s;a(RQ(7fh%EH? zmY2M0rzSiy+t+lpUJMOKtd_F{v#3 zSb0Zu{bOC#f6DbXD-u@inT6u;(Fs5V-37?fN~LEJ6x1tA3H{&4=ke4zR@(EJ|hS3m78zMMFG$!W*DotwQrwH69=9H;f zE%II$fhmVYa-zY%kdKZ;GGJzOVP=vS?$(k&E5+9v71oqXtD#^ltR@VZncE;}0s(1U z4h-21JeTodKH}s;0XUw7?3V)NU=i zz&@xWAq#~5VDYs?N0Zz&0LRLP?CJK5^*ztoG^{{ksjQ$fIOvlJFA}Y`K;gOrrLB7g zwUm7YSOs+C%VD5E?jd6aSeEYMEp6Wim=^41@z2V@FGz$*@9c*GEm4xz9uRDt;>lSj(q_i-5o zWYT^~NP7Ad<2-uP5r`~C11Zpmm5*ZDHN`!fRYF5ElC>P>&t&CVA_}dcYrK!}a=!0O z!-OrAqo20p@^h5wLgYU!4O_*E4E!VgCzJ8Lm_14ZZn7f)xBs{slLJHoAiA3XBaF$? z%9-JmJ#)&qP_j5T@W*@@Qw2N^ES}kf>~djula|RQf)B80Wl>2m1LuC0k3M4BQ zdtXKAytnE>?OoLHKDHYxWyLVMh5+6HJy*AL!Qr3J1vHIsU`mjFbjd)3@{~t>A)CzB zJ%aBLWXs;bW|~Q7>B4 zWf+yFz&#qT8q<#QtEp%D(uW*EAEt}xpWDx{-H>k9o2TLEgYbLiTpZytH_j>~VYh3+ zD0hir<5WXx_#)0$S=Pr&2(%Xp0KmL;$WXRY1Y7^zncDJ?tf)Wk`ZwcUTfheq6@KV^ z%57;z6=?%^y}6=)Qv`|_D$p8(w4|a~6l`9R&B%Qd-_W_-7zn4sSv)_eGLEnhnaTd` z!$MRSUo=?0Q5rBZWo#(&u{Mwg~Xg<$!_994e|bO~@vihgikNwbt)zhNjk-D*NMHWLz6RXfv+E0L*_d6*ev2;3?oyM)b(kY~s#1H>M7yzC63Hp3daTf~ z(R#b<=w%u^Y2ts$RLl#iJt{_I<7eVPKX7PX3a*~ri%u(C+6t2*zr@7I0)x4&H{F@) zA)0S1T>?Uad(A$(Y;@h_FRbV zNVn-`ED=xCRCQsMCyMmDy3rh`NyK`(Ag6?-+$dDqRyLBqul-F5SYT-Ts!>Z=H)>ic|iE@+WM&tv%9DJcPs_Z?*Y=&~s=~@6J1-%1K#;}UK(KTD;(^VWtxYqYMZNJTO=Z-=VOmLU`sG~9xn_)579V0L zfTw}CPRXg-848~m*k(!i1!(WOx;PPbq5C7OGMZ+8;Ue|2RM*)U|75Lx6 zc*p%~k_&|t>@&?I+2W!*5t$%De@q99M6##9i{qE;Wnz_~wvEY4tPA?r2RSu8!CcYk z3a>gcv2B!h*dTuJ$d!%A>$_CyE5L0J@m7x^`u@tvfaiw)8WBD2%)H+dCTmKPQb96D z;{HJ^n~Ff*Njvsr_iRqp888zcZggB|&)IDpLIxgwoTp+GPae-%MBHx_8;olEA=*WX z*kH3ssOFo$)g+#`8*xkWU7P1H{$YSRFBXI;y2I`GQ{6BRs` zwSw#Z1=Ohj8)v#VwIM3o-!@4|{i}FV&TH|;WI|%DRkuBZGWD6x>9!Mb5R=~k?vlQk ztwSG>BYJFXcI8{u@x6C|BTqPL%riZ@Jj?^SpTPiBw(4VCv@VCc+C7UDOSaTVd5jXc z^r6%KAT&{U$?FFmjf3b-k73`{=(}zIw^RV+=igY34IZzX#v6T>@=Ea<2Rkm6hG$bn ztrx2b`9kcNWPx>A@syYNV_auz8F1HEXS_lv9=~RdY$wA|-LeqyY=F*Gi@em7ngrWi zEy^W5I<1LJ|H5@HCn|lyKkqKkFWy}`0ahii*&WJ2kGr@8M+qY+Jo>Nt1Z4M zwmEolxrZ(ni-qkb?p%1h1|uaa6&Tea@FX}&$6T%Gl-yB=@Zj7z%XM+>@XgS4wmGiY zBBV|ubCP#5{ao@B|8@kqcdne07Km1;uK4!7XJ0dQKAdahjTMWZn=V{wP2TWAz6hU6 z3&&sozGGPdDf|3Ge;cl>nuBxN!*KM5;#BiQEhKb$&U&O+Gt&WGMo3c+Na=#-M*1Yj z@2%pp`t0R8jLqg?rNqO3Z0d6AmP;7e`@`Q{zkBVb4#>WN7-zRW&2=Z*1FaJO`A@Xd z>1FREj{lqVoB!J0`|}~}Ke@L*9~*jAXB~2Gi399nx~iAxm8goUH`WfCMa6BR>-y`4 zwQ^`CLwdR`+Nag+@%TO-OG1iNY`)ylTz3^7!rxn4&)|IofCkF!f^p~7^-LnE$;MYL zl>E9702R>_yJ{zBCRyYitBm_AhA<1u17Ep$IU-@objtYh<&Hvkx|pO0GtO*(z%!9x zJMgFf&_15hey&Wp#V?zy?upnR_xH`*C!lSIoXL=pC+IKZu?!5&&RHa#A~-*JBqd`6 z$IY}S%NaEpEnw#inz~!c>8&7OPVXCOsQ_0o&z{!x{}huKY4}!#`0mo2PxCBUNYmZg zo#)+;u(wBh-V8et^larlY;BzeZcn6-19lCP_s-zWwbwA&(pAd_UH=oT1zU0-ES-10xuY?a;&o#m4?fT)a?0I@WB84CKF(ZS)$zMIf{sKTz-@CZL(x4j$Z>DF zdwqPg=E0?27_f-iiNEf*GXbHlN&0r%<;bczK5?XA6y*KxDTt$>)3UD!;v>v`6k`Ui zBUFh=%Opd8;?xE2cn(B1;@-B8g>U9cAy>G&mbw;V(Ms7bC!*p3+wlHxOhGdb)u@JIDkiwtZlW@f#wF6Y3f-516C~Z>d&g;oNuUeeSfd zY?*QyZG!@2*#|^4E?JB=1rFlcqjYy z${&<9D%m~akqF?*jO^P!DYA36lhXj;F$Q%1EJ4qS(xoqpBtS*Zl`dwNB=s1vb@N6lL1nWmQ#33p^k*O4`!>aA8W22cxL#B9{0nWv+RR&~^`A0r6hls`kb z94JenCP$*?E4sFRH@W1DowLZ_F^;clhxMN z)0D`t=yY9MWqQhQX(rZmc;rQFdTXlN!wO^&WcrSS9w$+QpXFd6yt!sn(dgG?4n1$^ z?6?2szwn<8J|ih>(WqZdSkdqIzte^p8#o)#o0}LIn>aEs(mA_3i$*s<4Kknrya;^n zT`Afm6TxzX2Z0Jg*Muh(k2OIqbtjgdo>UQZZo#^V>ZCCF9v~ngXW18- zl^IwVlp*A0p{C`hj=$$xqMxxs{ldrks|Tlsh_doSvDGmZck;oM}>opp~GP zk^zJg!i1>l)*h%B>$I<}HF9*c6pTm-bof&k*Unl1VYJ z*v%CTMTeBlY!Xrhyce;G|CEFBE_x)HG87{UOm$0b1$bw_s*K{1d>}m(2d_h5@fP5r zY)sFwwUJM=Dy&sxl`M=*JAOnM@EKOTD+H37uVj5h9pU#u4L*f7y9YS|emM}IV*k?b za--1y^}A{t($q)A{)Jn>0{}?V002<@BK=?Vm7bBcg^8^*Eh8NV9Rr=Qg_AR_g{`R_ zy^N%=sGO4MmZnzHMk}iCOPv7g!r3(pEw|h}+jP>t&WI&$jaf@=*4ZN`}vdg;j{?exj z;Wts&pYZI1N0dxKpU8+yxz4V_4KwyJ6q zT}M-vwAg49k{oOiZxgCr*zklMD@IX z?qAZHa{wRe_k!{r?19yBeE@75$3Y_q9E-RZgenG7kk2x5$Bz0k9mwePX}>3?>743@ z^qR+dYQ>UGMDg%-{XKuR0m7mJH>%v?fbtIiBn50aAzN54RfV90JX=N*mbFx`+;9$V2{VGXQKJixHSUT2nPx%JHzEA6Xu_0 z{qw61L9xa|Qj>u{HNn9}o-bWVR|rjh7}*pe>Bro?7z=QE3{2W)_T)|;>e#51l4itt z|6I+B{_+Nb@_J2VA;TGzkfzMYkQOu$srrEV+*av;r5@w zsvz`A9bS!^ha#YVGFnI6cPJQ4VN2b!yS;T<(3{*#Gt&M(@eMN3D8iEDvjY4B^)w*H zjx6f=>w=pQ*YL26o(|eEr^1A?ZedTUG5THW-iRW4IsW3`CrK_KvbDPpMnNhuA*EU@ zbiE6<)QK}#a2yLIEg{J|&p&WIGCpEW>R7XRDhfuNL@`<&;|d(B6&qX0bG3@3>xuOi zfk2-^_Jk14z-tvQ&JlUx!kIZIc;7njD|XrxfeSiblD+L3{DlyCO3ZY*CLvOvS<}C* zc-X;}ms5I+*cUqjhxsZxo`j8X*TB23d?}C-6X*^!UJfxPc;=m#94z<6CiKbDZe!8E ztzDaNYkD>!@MuZrE2bH;(Hk)WKPgo$PFKsPI>W}Sk$F^Joi7zRDF8$W;!K7n-VHEH zn2m&?TL)Gz1Htd#Te@y_h?R4en{T87%Lx7H{ii zX|Aw3^iTj%2ELv60Tp3%)gKYTxfNM!5(><)XJP^Tptz*^=pArfaNc!pWHL-stFbNy z^Ll7n+v|@cA!)N6o`P#!;j~~iF|z^m5fU$QF8A@+*K3zH50WkO76o|)7DLkDrRCN| zfE&iGt!vHaOX{w0^o`=}BwFn3P+va%S%u~lpo%^_O%}A%0PRS5We&);+oV?Mq zI>}8MxWy>JOyIvWyX{7a+3flQ@4hHz(*fcCH}F0J8K+=h2|%1R0M)H`NzQTnFk6^I z^;TS326dPLHA~DeU#0-_DFX>BCfTU>5LET=5}*=F54xdfr@$)JD-(!bGo8c`UxOjV zt1X?a3Lj?X!g37{i7~erVZR`5`xHoAuD-`1QgKZE8U%s3LvS?Mx1FJAZtIlxAiiKD zQHzjqJc?$G;^omg%Pg{k5B%yA*Wwzq#~3*-;e2a3edWj(Si8y)B4V@SId+%ur<0?C zw|U!sBj==8kLbjakqeab;?6oQ86+Kk+5XjZ)=`F zj-naH;{CkgO$^@Ogtl5H5%YraUBc;Gech3T7sWbO^}nOYd2Y2)z-lQF%F@>x%*+k)!y5gEa<=}c5X$^C40~H z>GFXzGZ$w7Qm0&dFsYL^mHuV-F|=|uG{7qprP{sh97ZMY6iVR&0^p<5Kmo0uv0*$S zJI)+=L7|utA&IlW+gI(-!k=8MPRDjc@S9R2g!qpL6&|9YOe!NMXoSlKOj&Uz!m6m> z8-{&J;>Kj8<=3>2tQiXRPq-XJ{K!vA9NXnoODaa#<`*P}K=t-N=$jtV7RI{_!vM_L zvSgX6f-}QB{jno=BcUFb+xyiKifV$*DWOj?0I^_t8Pp2l{NlAtv4<>;%a9YiL%+e7 zHSf0cV^kEL}fk0bVL2Ks!5LR|QdB4q2W6uv4%$^b*r`;)mb14Lt~%~EVe+k#dZ6dfN7)H*_HQN!?2sAw`y75)JMl# z+6FuBDwn(xK`anBMeKyHfx=4+L^hDF3(1QI_}yX(;bwR$n1J1Zbk7l}+LRo5l^kpj z?SOtF<})B5gw?0tosJ_o!pU?rVH2`+_bC{?Bh@k*M>#c(n%ke3T=Gsoeu>YHjWF=z z1hSdq5RtZ2sD80o`gsL|ZUxBK7ymzvodr~sTi3@)M+AoMv`Fbj5NVJu3F+>Z5)_7( zQo1{4M7l##x`&WXDM2ZLA^nDXUtf^x{a&A0vtU?j|IXQmXJ*bmXP^C#lF8UkA}q>N zA}eNxi&O&Fba0Y@$s?(~W}@7vjYpRDxhTas=bS|9lS&(Yag`M?lvBJ-#~^8JwHfki zpPYWOXYWyvKZ{%HLh;{A0rzUQBHs~#8G)GL&qhuy$o1rtUj#cbd7n-gGR1Brz${91 z3w<4gn6_qTJnQk&2&<|>MrU?Cm~3tLtd5eZ3`>sHPM_D*BGqOc-GCwHWih9S;T5V* z#B-Wp_eq;HL6A9Xj2SG0Ht9ct*tTL_w~Ek{g>9@#o+m@SU*&@rSDR{dYv9RKbLTfbUNm3nO42 zb*8IKNg$svjGExs)rEA?@yNeyAl@R9#kbF$Tf@ZRSGEn=3v#o=sU+XVM3JmoTHW&< za#DU|Plu;HW|3)n_= zd5$)>Iq*$}4{`JSI?*Il>tkz4nAGo1j2OjrViGiS*n#Gm5N_DnV$Evs-6Rhcy|>ok z%gb^Xo@V>JXg#w0pvdm=4Y#{~ab)#w{oYh7hDwHVj~P)ux1|t46wRb}ECNTo5(_)x z{1tSoPzklZg)Y$3$??<1edTmQoqfvKg6GW-RdmT&6#Xu6V}H#xy;{X4uqZa$hd8MM ztroq^;uQb2TMxP)g>i%DDAH=P=gwIS@Fpo)sH2oc=fa-HA6evnoHVa#db4Vn%pxo?H@SSZ@Sk$fd2%Z5Qsw62BGn?&7A zVij8HC+4Fq$(ZX*Ss+(s^3o9_9z%zZJ6}MINq)6G$(NRF{V|~YajC_MI ztsoJRdhUs+ryh0B5cR2R9H{oWr3%F$dJsxFObKg_!r0_tT~eF21E6Uy&<*E_oFF3t zFCscwAd%{6d0NyB{5&&0Tk7sNC5}_#oMl*TyxIk}svai(wo<+{K%)M~e5BfUZwwSa zm9=|x*24m(K}iii+?jP;nB@vLgT4`+bPVJfBga^0-x=*upYutnoT-}AI_?69#q3KC zE7I@A3ALd0dyBWoO8s*XkQCB%b1UMnY{|en0{y1{Tx>E&C?41)0FtjI=x#3@4K^P zQMQa9IQkAZ(!sT-7Z43Saz|f@S)V!RLaKYyTj_OQYz*6=h@hvA`%9@>-+=^p-Ccb* zQZinrXAP>#)S^#`?-!O$S)S)zZtqOUMySu+d(HNc)QF!3;TKn5RseQZAE?K?(b*P`b`{_cx7wjzXmYLLWM2@`4`xxPswdJy2yb5-~ z9CWqLctQn7MrY>DzWj~Pt}>QlCLE*MG6wvTkJO|SUY~Ot3o0louymuCkk(<3R(k6- zOYWG_SFmPOu^GM+%0zOzFZ(`6G2)o^ySWyvJnU_gbx}*7 zwg&W6I+#q5vWglt`XocON@mt$I0*ragzP^+UsJ^+#^>UxrCppqx=6XL)|NX!Gb*Kn z#`;mdA7q_PnVU+X>8p`tWS}V4D6Q9aP)56Z%xEoS;wx_?r6x!i82yM@aKHdJYQl~i zo)Xs?WcVi*;^5ApfqELXp*ZK`HrNH|ubvD9`UeV?p_!?q_O@-C8Re^z_bJ-~3Sy`- zzIb!L)a>SjAQq~9z{}npmutMOzi%1PY#yM(PO7H)@zlocd9X&g?hotHn9hjTu*0^zxu?4`OU)m69A{J2^wInLwm#Nj z!&9|zK0UKzn7gN?-sb9}<>4{R&|^)R;E!*y$dC@c#iw0)qdlokIP)2ZthC{^CC1T; z#JMUa6qdm&aW`}ycWHs@hJX6MEO=Ty?Q4y3y$%vxf7Uf@HOR`Yx z?}@MrpV%`KqVSxv6AY0y$G(j-(w|ZL$Q48Gol8ucfSHQVn^^ajYVl;-;BePw zCCAqi?_-A}rNpq4`EK-wVl#((Lre)C^~rn|Ld|PnS(I1dvccYfwVs4T(6R{WB-j6t zjJ`jc5H+oln)}@QJm(2fATFicElt+-IG$TpEsCN0iRS5Q? z+ungSbht;Xo@W?`4=S1s79$5YA6XS5NA7+Kg3>mH1yPZddj~*FD@(=jKYH%QOGWC~ zPi2=KAgs)XcOG#P_|S`CwBy@V_Q>kj8W2kg-+Wr>@(OB#g!kz=IFp57QA{8@OP^+c z?Jz&t2ND@Q=+?)pR02_M|E6Rv*?j2xVuE}lqKivN%Vi!nT_&3$ZcMzliE~K#Rz4PI zy54P7(vsSl24hnrg@GBG^XSyXFyX%T@I*eI>13PZcXMi0Q=c3XrLjGAy*2rx=Mk)# zy0oIkEhBUmYdwspWP9j$`PD|x@mMo!vK@)gEKztxS*oLeNYaS7Ww<9SV!8k;5O(<6 zJMZ#>8;kd#?=bp1WQ{CW`TFs>Y(NT-xGxkp^=QEZJWn)vS%Nx!D-!*sRLTI!AqJzx zMW!VHCCNh#fBCG}oNO$fs|w5;#6Q>!c0g9!B-Acn@sdtoEZ+Va#aM%`8Bfit8w7g| zff|?#ZF^Vou)N%Bi@#TD8%3xfQPsio77Oi77)3uU4JTvsD~_ECQSlx(ph!3?NqJY^e)FvI5=F-*Gymr+BPx z0B4NmOxW{L|0JR7O@B(^<}rx&t}2ZpWt@u(uR#Jr=)HD>DB)m@;0#GRF14{-x?vcD zmXZA(%nX7P=be=|qXFhLo%K|OI+JKQ44-io@tto=envlz0}7cV$pLk{THHBp`{aoW z<;a=QC{SrR)YBM&QetoWagHIy8efnmb*Ba>kMFD;yGCukH*2&rMLN(z<$gf!i;03b zlfcS{4vXxG4yP>GQVC|*u}waCY)1+#3u~eV>fhzCB$c<$dnfGnW5`#I`heQI%T3M5 zRB`)tHFs7T3PcA7Ybq4J!tKp_#}Ma*o~igUMJ0pxR#U#?qeG_+G7^1(oH`*-ojWeX z+s!#vh?QrX+ed;Obz2#?F))x6w6O=oXpX{79;da$t!=O*n^Pk!MXv_kng?!nzj9hC zf7+)*&iqN{Lwk)vD`zbKS!v%a#FH{N^5p^l!S)w$2mO82SSU6TZ)jBP82eqDbx+o9 z2MF{&X0<1?vki@IQuBPnTI3LsxC7>*O3p1k2diXBH1*z0ZSzd-Hwv4ma#HG{%nEv2 zpEm-_v^8q&Z=?`>k>d|dR^k>|x<{D?*KI?MFKTiscWq|+MsNRmqXwPRV?x!vcaqEb zD8^nTa9nIzVzP;(vstp?R)Kv(`)c9sCV?WbmAVM;gLU3cisp(tj9~3gUo?<-4_ild zg$FH2Rj1f^Rwa0sbBR1xz>IY6^Ja{wF5T-@c&3f9EhaNtNARcj#07l*d1ZzwUB>o&5TV$0fF{ceuu*m zyaT!3isOLR*KDV?QAUQcmJC>5%Z>+*DQgIl0G%M1T^BL@3?GHjfSK9NoKaLlp z08iS4>`URLXcDas4I>&&ZEBBOp?W#p-YUs6m#cT(j(5k9#H}OVV9e}oBbqk!nX_0v zZTa^0t<#&+8DGJ}_B^ot>c?kFas(MECvyNDLYD$4tny*H#4hr&Ct@2JjkB*+=>QNd z-X1M%org@G7}W5tY*D`X#U7L#aB6U>S5zzBKTn3EK~5I68y9e^dqlpRjt)C z9krx9L>S6(&3e8ty@B_nJ1XO8~t+wPyliN9-_`U-#xtfiGmV;gkG} zC(WNs_SL1t#bwb4q~!XBFlCq+`Y-lLSw}eL9Toayn4Uc7VkuRYdeZfPIhX|iQ5s|& z=8V`Ul@nbadCVx3jQycDmRx4Uz93VC)}|4r7sL?tVZ=AHK}M zB2VAPq*$y*ry$4h*GBMANMMlWGL7kq1LC#jAGXqYW5An**MLA^{*&gN?dmZ#y{dZ_0jBbiMGoS*{HXY6 zEGB&6=M7eI{ISt0aOu;Yd|SLX!&x3IAQ3*s*@`FAo5FV<2%ql2@MOv|CZ!DcP-|D| zQy(^bI}f6eK?VTV+jfRZEetBwH%Z-%=X?O5C=?kljiu_0RHV5)!Z-OAcJdI;uhC%U z{(GBhN|Cy9;)frIVq+5ZG*I5~irPWQTMFr?zE>h@hHs02b!)}+@@On48lLsVWI0NG zh^>3i3fXOVcWFh_$&hJgwMRg4$c_AAX9%MfEeX=nEoiaK! z1?xWr7(J-0=r+?0cR~)dxH}uKD~-y1W5R|fTLO2ZmXXjw768J1lyZ}jhEb@;5fWwh z)}Ts11=yCfUdi|#FLr+|=fHHe+zJwxvsPx>DLE~u)ltX!d?m4>mNlCxcyL5vR=|!- z7`xlqcVXgvinO7m41!WzrY(BlnV?2TWwg#q+PyvDz?(pg)7CEwN7ERqn6&R~2cx2* zJt#Jb&?5!Br~ovBh9n!#X{9e_KgKF5>R=)wc$)w4vSWRb3`+6k*{4n)5R5=YSTwg0 zzwwOQ$Zi#J6|`i*hw}*`!~Ppy(y^-^i%~7ApsSG3c9KH;i=x#+3>O^IcfcA_0YT@% zcXuL6UDQZjBC*NMgqltY=A?9J2s9l;Tw_s}kl8fV9ytQ&+bdu+;aR3PvvMK+j^&Pi zNciWs`{Wu^fN|-|!Ut(PN_t@p66*AFl81aEzG0Nec|C87L5$#GVo~$(^I}RBheqp@ z2?|a908y9}Dsb^X~m@e9B z4NB}ey0u=$P}O~;BCpK-I^$Pa;6{WVYca8T~o=ER+R z?kO9t$WuLN(-?^BpHLce>*-}nEes+RfqI{ieZRY1Onh80wL+_}LmYGe(| zorxm8jTU}fajL>h-j@%R1ZumKgOfil+yWaA|nGGQu&XEl@W9(r^|K&HWI zc>$pClr6?x!r}l|^S0`Wp8HgwA(BELCcSyq7jorUK-A!Qj6ED~vhN)oUuhJFHU*%@ zh_$3rYr`b|#b942Y;~7h2B_R<7;>z1RMBl-8T(f$MR!t$?VcwPE@QSfuB@J>FzYa5 zcVrkc7naK>a}BifH@ZaQ?L;5gM=J`E#HrG7g^AlI!qQmBTdI%w=@N7F!*{^}7_~a~ zUd9d1H+=P&4VMB|HpO;^xg zHRG8u#j23n@gn$ih`Vp;U<8emnXn5fjx#>!5Lna8fR>^2SE`P)D)se1!e|pLs=qX2j}gVx zPwim6u8y3qz5_blu~U>mM8ZeDkhQsqpa}oont#Rgc>!MUTo_)Aiva%DpI5oh#c%)3 zfVo;W{VKu_eiUr9mXHkyKMKaii-2%Zqy6Vq?t>36-F^k}pK{+A$oSXbgxGIx;mGV1z+e^wz z^Is@`7ZSK?{yT-fOY>v9U(Nrc*LM~0J0+=0K-BYJ0RPpMx=Q$+{=rW|whz^-tAw9w z2v_ZYr-ty;zT8LY7yEx`BU}ajP8;D86#5&`uSyA5S=sR0Z($} zRnqT@a9@&Y{Qr&gj}MXG)g!zF9lrS&(7%10{H`9`B~BvxUvU4a&UV$q-_^mmBoU|m z3+bOX^Y0GqUV^G~{{{5l_xiOr=;&QA1|K9zTy?Pb*yTs5-TxiV|-2X@uy-vNpfAy1E?(?wg52!zPv#w*WN6MF2 zy3s$t{uMW0XI_tPe=@UuI{$=uJ=VRBzaG6_;w8uapv%9+ve((yBiNtpa-Xz6VgDV^ WD$1bVxG Date: Tue, 27 Aug 2024 09:42:11 -0400 Subject: [PATCH 026/303] script to fix libvirt in salt 3006.2+ --- salt/salt/scripts/fixLibvirt.py | 80 +++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 salt/salt/scripts/fixLibvirt.py diff --git a/salt/salt/scripts/fixLibvirt.py b/salt/salt/scripts/fixLibvirt.py new file mode 100644 index 000000000..853b452d6 --- /dev/null +++ b/salt/salt/scripts/fixLibvirt.py @@ -0,0 +1,80 @@ + +#!/usr/bin/env python3 + +# resolves https://github.com/saltstack/salt/issues/64962 +# 3006.2+ has and issue with libvirt +# use pip to install lief then run this script to resolve + +import datetime +import grp +import os +import pathlib +import pwd +import shutil +## +import dbus # dnf -y install python3-dbus +## +import lief # https://pypi.org/project/lief/ + +# https://github.com/saltstack/salt/issues/64962 + +salt_root = pathlib.Path('/opt/saltstack') +src_lib = pathlib.Path('/lib64/libldap.so.2') +dst_lib = salt_root.joinpath('salt', 'lib', 'libldap.so.2') + +uname = 'root' +gname = 'root' + +lib = lief.parse(str(src_lib)) +sym = next(i for i in lib.imported_symbols if i.name == 'EVP_md2') +if sym: + # Get the Salt services from DBus. + sysbus = dbus.SystemBus() + sysd = sysbus.get_object('org.freedesktop.systemd1', '/org/freedesktop/systemd1') + mgr = dbus.Interface(sysd, 'org.freedesktop.systemd1.Manager') + svcs = [] + for i in mgr.ListUnits(): + # first element is unit name. + if not str(i[0]).startswith('salt-'): + continue + svc = sysbus.get_object('org.freedesktop.systemd1', object_path = mgr.GetUnit(str(i[0]))) + props = dbus.Interface(svc, dbus_interface = 'org.freedesktop.DBus.Properties') + state = props.Get('org.freedesktop.systemd1.Unit', 'ActiveState') + if str(state) == 'active': + svcs.append(i[0]) + # Get the user/group + u = pwd.getpwnam(uname) + g = grp.getgrnam(gname) + # Modify + print('Modifications necessary.') + if svcs: + # Stop the services first. + for sn in svcs: + mgr.StopUnit(sn, 'replace') + if dst_lib.exists(): + # 3.10 deprecated .utcnow(). + #dst_lib_bak = pathlib.Path(str(dst_lib) + '.bak_{0}'.format(datetime.datetime.now(datetime.UTC).timestamp())) + dst_lib_bak = pathlib.Path(str(dst_lib) + '.bak_{0}'.format(datetime.datetime.utcnow().timestamp())) + os.rename(dst_lib, dst_lib_bak) + print('Destination file {0} exists; backed up to {1}.'.format(dst_lib, dst_lib_bak)) + lib.remove_dynamic_symbol(sym) + lib.write(str(dst_lib)) + os.chown(dst_lib, u.pw_uid, g.gr_gid) + os.chmod(dst_lib, src_lib.stat().st_mode) + # Before we restart services, we also want to remove any python caches. + for root, dirs, files in os.walk(salt_root): + for f in files: + if f.lower().endswith('.pyc'): + fpath = os.path.join(root, f) + os.remove(fpath) + print('Removed file {0}'.format(fpath)) + if '__pycache__' in dirs: + dpath = os.path.join(root, '__pycache__') + shutil.rmtree(dpath) + print('Removed directory {0}'.format(dpath)) + # And then start the units that were started before. + if svcs: + for sn in svcs: + mgr.RestartUnit(sn, 'replace') + +print('Done.') From 9ddccba7807172afbed5297932c7522daf15ce94 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 28 Aug 2024 10:09:42 -0400 Subject: [PATCH 027/303] LSHEAP and pipeline workers for virt --- salt/manager/tools/sbin/so-minion | 6 +++++- salt/reactor/sominion_setup.sls | 2 +- salt/setup/virt/soinstall.map.jinja | 12 +++++++++++- salt/setup/virt/sominion.sls | 2 +- 4 files changed, 18 insertions(+), 4 deletions(-) diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index 18c8c3224..0956840b1 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -44,6 +44,10 @@ for i in "$@"; do ES_HEAP_SIZE="${i#*=}" shift ;; + -l=*|--lsheap=*) + LSHEAP="${i#*=}" + shift + ;; -n=*|--mgmtnic=*) MNIC="${i#*=}" shift @@ -214,7 +218,7 @@ function add_logstash_to_minion() { "logstash:"\ " enabled: True"\ " config:"\ - " pipeline_x_workers: $CPUCORES"\ + " pipeline_x_workers: $CORECOUNT"\ " settings:"\ " lsheap: $LSHEAP"\ " " >> $PILLARFILE diff --git a/salt/reactor/sominion_setup.sls b/salt/reactor/sominion_setup.sls index 91a4a6cb9..a78475e6c 100644 --- a/salt/reactor/sominion_setup.sls +++ b/salt/reactor/sominion_setup.sls @@ -28,7 +28,7 @@ def run(): with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + minionid + ".sls", 'w') as f: yaml.dump(vm_out_data, f, default_flow_style=False) - rc = call("NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVirt -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -a=" + DATA['INTERFACE'] + " -c=" + str(DATA['CORECOUNT']) + " -d='" + DATA['NODE_DESCRIPTION'] + "'", shell=True) + rc = call("NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVirt -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -a=" + DATA['INTERFACE'] + " -c=" + str(DATA['CPU']) + " -d='" + DATA['NODE_DESCRIPTION'] + "'" + " -e=" + DATA['ES_HEAP_SIZE'] + " -l=" + DATA['LS_HEAP_SIZE'], shell=True) logging.error('sominion_setup reactor: rc: %s' % rc) diff --git a/salt/setup/virt/soinstall.map.jinja b/salt/setup/virt/soinstall.map.jinja index e2649aab1..a589250df 100644 --- a/salt/setup/virt/soinstall.map.jinja +++ b/salt/setup/virt/soinstall.map.jinja @@ -14,7 +14,8 @@ {% if nodetype == "searchnode" %} -{% do DATA.update({'LSHOSTNAME': grains.host}) %} +{# we can't use the host grain here because the grain may not be updated yet from the hostname change #} +{% do DATA.update({'LSHOSTNAME': salt['cmd.run']('hostname')}) %} {# this replicates the function es_heapsize in so-functions #} {% if total_mem < 8000 %} @@ -31,4 +32,13 @@ {% endif %} {% do DATA.update({'ES_HEAP_SIZE': ES_HEAP_SIZE}) %} +{% if total_mem >= 32000 or nodetype in ['managersearch','heavynode','standalone'] %} +{% set LS_HEAP_SIZE="1000m" %} +{% elif nodetype == 'eval' %} +{% set LS_HEAP_SIZE="700m" %} +{% else %} +{% set LS_HEAP_SIZE="500m" %} +{% endif %} +{% do DATA.update({'LS_HEAP_SIZE': LS_HEAP_SIZE}) %} + {% endif %} diff --git a/salt/setup/virt/sominion.sls b/salt/setup/virt/sominion.sls index 328f50311..55e3a796a 100644 --- a/salt/setup/virt/sominion.sls +++ b/salt/setup/virt/sominion.sls @@ -19,7 +19,7 @@ create_pillar: NODETYPE: {{ DATA.NODETYPE }} CORECOUNT: {{ DATA.CORECOUNT }} LSHOSTNAME: {{ DATA.LSHOSTNAME }} - LSHEAP: {{ DATA.LSHEAP }} + LS_HEAP_SIZE: {{ DATA.LSHEAP }} CPUCORES: {{ DATA.CPUCORES }} IDH_MGTRESTRICT: {{ DATA.IDH_MGTRESTRICT }} IDH_SERVICES: {{ DATA.IDH_SERVICES }} From d44ce0a070b9b7e9b70e4aeccccb301f84d97f06 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 28 Aug 2024 12:41:38 -0400 Subject: [PATCH 028/303] add so-salt-cloud as salt-cloud wrapper --- salt/manager/tools/sbin/so-salt-cloud | 76 +++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 salt/manager/tools/sbin/so-salt-cloud diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud new file mode 100644 index 000000000..d0b87f5e7 --- /dev/null +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -0,0 +1,76 @@ +#!/usr/bin/python3 + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +import argparse +import subprocess +import re +import threading + +def call_so_firewall_minion(ip, role): + print("call_so_firewall_minion called") + try: + # Start so-firewall-minion as a subprocess + process = subprocess.Popen( + ['/usr/sbin/so-firewall-minion', f'--ip={ip}', f'--role={role}'], + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, + text=True + ) + + except Exception as e: + print(f"An error occurred while calling the command: {e}") + +def call_salt_cloud(profile, vm_name): + try: + # Start the salt-cloud command as a subprocess + process = subprocess.Popen( + ['salt-cloud', '-p', profile, vm_name, '-l', 'info'], + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, + text=True + ) + + role = vm_name.split("_")[1] + + ip_search_string = '[INFO ] Address =' + ip_search_pattern = re.compile(re.escape(ip_search_string)) + + # Continuously read the output + while True: + # Read stdout line by line + line = process.stdout.readline() + if line: + print(line.rstrip('\n')) + + if ip_search_pattern.search(line): + parts = line.split("Address =") + if len(parts) > 1: + ip_address = parts[1].strip() + print("Extracted IP address:", ip_address) + # Create and start a thread to run so-firewall-minion + thread = threading.Thread(target=call_so_firewall_minion, args=(ip_address,role.upper())) + thread.start() + else: + print("No IP address found.") + + # Check if the process has terminated + elif process.poll() is not None: + # process finished + break + + except Exception as e: + print(f"An error occurred while calling the command: {e}") + +if __name__ == "__main__": + + parser = argparse.ArgumentParser(description="Call salt-cloud and pass the profile and VM name to it.") + parser.add_argument('-p', '--profile', type=str, required=True, help="The cloud profile to build the VM from.") + parser.add_argument('vm_name', type=str, help="The name of the VM.") + + args = parser.parse_args() + + call_salt_cloud(args.profile, args.vm_name) From f5e6e49075aa5aa576832b8d8e16f88b90764b9d Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 28 Aug 2024 14:12:23 -0400 Subject: [PATCH 029/303] set initial schedule for vm to deal with possible manager firewall state.apply delay --- salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja | 10 +++++----- salt/salt/master.sls | 8 ++++---- salt/setup/virt/init.sls | 4 ++++ salt/setup/virt/initial_schedule.sls | 7 +++++++ salt/setup/virt/setSalt.sls | 5 ++++- 5 files changed, 24 insertions(+), 10 deletions(-) create mode 100644 salt/setup/virt/init.sls create mode 100644 salt/setup/virt/initial_schedule.sls diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 3e797890a..4d3d33ac2 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -20,7 +20,7 @@ core-{{host}}: master_port: 4506 #startup_states: sls #sls_list: - # - setup.virt.setSalt + # - setup.virt.initial_schedule # - setup.virt.setHostname use_superseded: - module.run @@ -34,10 +34,10 @@ core-{{host}}: #preflight_cmds: # - echo "preflight_cmds" # the destination directory will be created if it doesn't exist - #file_map: - # /opt/so/saltstack/default/salt/repo/client/files/oracle/keys/securityonion.pub: /tmp/securityonion.pub - #inline_script: - # - "systemctl start salt-minion" + file_map: + /opt/so/saltstack/default/salt/setup/virt/initial_schedule.sls: /opt/so/conf/salt/cloud_file_map/salt/initial_schedule.sls + inline_script: + - "sudo salt-call state.apply initial_schedule --local --file-root=/opt/so/conf/salt/cloud_file_map/salt/" # - "rpm --import /tmp/securityonion.pub" # grains to add to the minion diff --git a/salt/salt/master.sls b/salt/salt/master.sls index fc572be96..0dd522e81 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -58,10 +58,10 @@ salt_master_service: #- salt/cloud/*/requesting # - 'salt/cloud/*/deploying': # - /opt/so/saltstack/default/salt/reactor/createEmptyPillar.sls -# - 'salt/cloud/*/created': -# - /opt/so/saltstack/default/salt/reactor/setSalt.sls -# - /opt/so/saltstack/default/salt/reactor/setHostname.sls -# - /opt/so/saltstack/default/salt/reactor/sominion.sls +## - 'salt/cloud/*/created': +## - /opt/so/saltstack/default/salt/reactor/setSalt.sls +## - /opt/so/saltstack/default/salt/reactor/setHostname.sls +## - /opt/so/saltstack/default/salt/reactor/sominion.sls # - 'setup/so-minion': # - /opt/so/saltstack/default/salt/reactor/sominion_setup.sls # - /opt/so/saltstack/default/salt/reactor/virtUpdate.sls diff --git a/salt/setup/virt/init.sls b/salt/setup/virt/init.sls new file mode 100644 index 000000000..be89c8588 --- /dev/null +++ b/salt/setup/virt/init.sls @@ -0,0 +1,4 @@ +include: + - setup.virt.setSalt + - setup.virt.setHostname + - setup.virt.sominion diff --git a/salt/setup/virt/initial_schedule.sls b/salt/setup/virt/initial_schedule.sls new file mode 100644 index 000000000..7535ee960 --- /dev/null +++ b/salt/setup/virt/initial_schedule.sls @@ -0,0 +1,7 @@ +init_node_schedule: + schedule.present: + - name: init_node + - function: state.sls + - job_args: + - setup.virt.init + - minutes: 1 diff --git a/salt/setup/virt/setSalt.sls b/salt/setup/virt/setSalt.sls index aa6618b25..f777d6005 100644 --- a/salt/setup/virt/setSalt.sls +++ b/salt/setup/virt/setSalt.sls @@ -8,7 +8,10 @@ set_role_grain: - name: role - value: so-{{ grains.id.split("_") | last }} -# set event for firewall rules - so-firewall-minion +# disable the initial schedule +remove_init_node_schedule: + schedule.absent: + - name: init_node set_highstate: file.append: From 267d1a27acb206a101b8719ace3c79d7c9340b67 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 28 Aug 2024 15:52:14 -0400 Subject: [PATCH 030/303] use cron instead of schedule for vm init. ensure vm shutdown --- salt/reactor/virtUpdate.sls | 14 +++++++++++++- salt/setup/virt/initial_schedule.sls | 20 +++++++++++++------- salt/setup/virt/setSalt.sls | 10 ++++++---- 3 files changed, 32 insertions(+), 12 deletions(-) diff --git a/salt/reactor/virtUpdate.sls b/salt/reactor/virtUpdate.sls index d4b56fdf6..2e691b5b1 100644 --- a/salt/reactor/virtUpdate.sls +++ b/salt/reactor/virtUpdate.sls @@ -75,7 +75,19 @@ def run(): c = 0 while True: if c == 60: - logging.error("virtUpdate reactor: vm_name: %s failed to shutdown in time " % vm_name) + logging.error("virtUpdate reactor: vm_name: %s failed virt.shutdown in time " % vm_name) + return {} + r = local.cmd(hv_name, 'virt.shutdown', ['vm_=' + vm_name]) + logging.error("virtUpdate reactor: virt.shutdown: %s return: %s " % (vm_name,r)) + if r.get(hv_name): + break + c += 1 + sleep(1) + + c = 0 + while True: + if c == 60: + logging.error("virtUpdate reactor: vm_name: %s failed to go inactive in time " % vm_name) return {} r = local.cmd(hv_name, 'virt.list_inactive_vms') logging.error("virtUpdate reactor: virt.list_inactive_vms: %s " % r.get(hv_name)) diff --git a/salt/setup/virt/initial_schedule.sls b/salt/setup/virt/initial_schedule.sls index 7535ee960..6388e7c31 100644 --- a/salt/setup/virt/initial_schedule.sls +++ b/salt/setup/virt/initial_schedule.sls @@ -1,7 +1,13 @@ -init_node_schedule: - schedule.present: - - name: init_node - - function: state.sls - - job_args: - - setup.virt.init - - minutes: 1 +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +# initially tried to use schedule.present here, but that state trys to return data to the master even if run with --local +# that causes it to fail since th firewall may not yet be open on the manager +init_node_cron: + cron.present: + - name: salt-call state.apply setup.virt.init + - identifier: init_node_cron + - user: root + - minute: '*/1' diff --git a/salt/setup/virt/setSalt.sls b/salt/setup/virt/setSalt.sls index f777d6005..c48282747 100644 --- a/salt/setup/virt/setSalt.sls +++ b/salt/setup/virt/setSalt.sls @@ -8,10 +8,12 @@ set_role_grain: - name: role - value: so-{{ grains.id.split("_") | last }} -# disable the initial schedule -remove_init_node_schedule: - schedule.absent: - - name: init_node +# remove the initial cron +remove_init_node_cron: + cron.absent: + - name: salt-call state.apply setup.virt.init + - identifier: init_node_cron + - user: root set_highstate: file.append: From 0766a5da91eeb06196a6f0c59b970da4f9ff5e1a Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 28 Aug 2024 16:59:24 -0400 Subject: [PATCH 031/303] change to LSHEAP. LSHOSTNAME from id grain --- salt/setup/virt/soinstall.map.jinja | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/salt/setup/virt/soinstall.map.jinja b/salt/setup/virt/soinstall.map.jinja index a589250df..566b27445 100644 --- a/salt/setup/virt/soinstall.map.jinja +++ b/salt/setup/virt/soinstall.map.jinja @@ -14,8 +14,7 @@ {% if nodetype == "searchnode" %} -{# we can't use the host grain here because the grain may not be updated yet from the hostname change #} -{% do DATA.update({'LSHOSTNAME': salt['cmd.run']('hostname')}) %} +{% do DATA.update({'LSHOSTNAME': grains.id.split("_") | first}) %} {# this replicates the function es_heapsize in so-functions #} {% if total_mem < 8000 %} @@ -33,12 +32,12 @@ {% do DATA.update({'ES_HEAP_SIZE': ES_HEAP_SIZE}) %} {% if total_mem >= 32000 or nodetype in ['managersearch','heavynode','standalone'] %} -{% set LS_HEAP_SIZE="1000m" %} +{% set LSHEAP="1000m" %} {% elif nodetype == 'eval' %} -{% set LS_HEAP_SIZE="700m" %} +{% set LSHEAP="700m" %} {% else %} -{% set LS_HEAP_SIZE="500m" %} +{% set LSHEAP="500m" %} {% endif %} -{% do DATA.update({'LS_HEAP_SIZE': LS_HEAP_SIZE}) %} +{% do DATA.update({'LSHEAP': LSHEAP}) %} {% endif %} From aaa48f6a1adf56fdde5f9b072f32fbd402a1392f Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 29 Aug 2024 13:41:58 -0400 Subject: [PATCH 032/303] support for fleet, heavynode, receiver, idh --- salt/manager/tools/sbin/so-salt-cloud | 1 - salt/setup/virt/fleet.yaml | 18 ++++++++++++++++++ salt/setup/virt/heavynode.yaml | 18 ++++++++++++++++++ salt/setup/virt/idh.yaml | 18 ++++++++++++++++++ salt/setup/virt/receiver.yaml | 18 ++++++++++++++++++ salt/setup/virt/searchnode.yaml | 12 ++++++------ salt/setup/virt/sensor.yaml | 4 ++-- salt/setup/virt/soinstall.map.jinja | 26 +++++++++++++++----------- 8 files changed, 95 insertions(+), 20 deletions(-) create mode 100644 salt/setup/virt/fleet.yaml create mode 100644 salt/setup/virt/heavynode.yaml create mode 100644 salt/setup/virt/idh.yaml create mode 100644 salt/setup/virt/receiver.yaml diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index d0b87f5e7..b34252730 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -11,7 +11,6 @@ import re import threading def call_so_firewall_minion(ip, role): - print("call_so_firewall_minion called") try: # Start so-firewall-minion as a subprocess process = subprocess.Popen( diff --git a/salt/setup/virt/fleet.yaml b/salt/setup/virt/fleet.yaml new file mode 100644 index 000000000..8a6aa06de --- /dev/null +++ b/salt/setup/virt/fleet.yaml @@ -0,0 +1,18 @@ +MAINIP: +MNIC: eth0 +NODE_DESCRIPTION: 'vm' +ES_HEAP_SIZE: +PATCHSCHEDULENAME: +INTERFACE: +NODETYPE: FLEET +CORECOUNT: 8 +LSHOSTNAME: +LSHEAP: +CPUCORES: 8 +IDH_MGTRESTRICT: +IDH_SERVICES: +CPU: 8 +MEMORY: 8 +DISKS: 0 +COPPER: 0 +SFP: 0 diff --git a/salt/setup/virt/heavynode.yaml b/salt/setup/virt/heavynode.yaml new file mode 100644 index 000000000..8cf2e0392 --- /dev/null +++ b/salt/setup/virt/heavynode.yaml @@ -0,0 +1,18 @@ +MAINIP: +MNIC: eth0 +NODE_DESCRIPTION: 'vm' +ES_HEAP_SIZE: +PATCHSCHEDULENAME: +INTERFACE: bond0 +NODETYPE: HEAVYNODE +CORECOUNT: 8 +LSHOSTNAME: +LSHEAP: +CPUCORES: 8 +IDH_MGTRESTRICT: +IDH_SERVICES: +CPU: 8 +MEMORY: 16 +DISKS: 0 +COPPER: 0 +SFP: 0 diff --git a/salt/setup/virt/idh.yaml b/salt/setup/virt/idh.yaml new file mode 100644 index 000000000..0e1ef8be0 --- /dev/null +++ b/salt/setup/virt/idh.yaml @@ -0,0 +1,18 @@ +MAINIP: +MNIC: eth0 +NODE_DESCRIPTION: 'vm' +ES_HEAP_SIZE: +PATCHSCHEDULENAME: +INTERFACE: +NODETYPE: IDH +CORECOUNT: 2 +LSHOSTNAME: +LSHEAP: +CPUCORES: 2 +IDH_MGTRESTRICT: +IDH_SERVICES: +CPU: 2 +MEMORY: 1 +DISKS: 0 +COPPER: 0 +SFP: 0 diff --git a/salt/setup/virt/receiver.yaml b/salt/setup/virt/receiver.yaml new file mode 100644 index 000000000..5a5c714aa --- /dev/null +++ b/salt/setup/virt/receiver.yaml @@ -0,0 +1,18 @@ +MAINIP: +MNIC: eth0 +NODE_DESCRIPTION: 'vm' +ES_HEAP_SIZE: +PATCHSCHEDULENAME: +INTERFACE: +NODETYPE: RECEIVER +CORECOUNT: 2 +LSHOSTNAME: +LSHEAP: +CPUCORES: 2 +IDH_MGTRESTRICT: +IDH_SERVICES: +CPU: 2 +MEMORY: 8 +DISKS: 0 +COPPER: 0 +SFP: 0 diff --git a/salt/setup/virt/searchnode.yaml b/salt/setup/virt/searchnode.yaml index f48502b94..2e1568f29 100644 --- a/salt/setup/virt/searchnode.yaml +++ b/salt/setup/virt/searchnode.yaml @@ -1,18 +1,18 @@ MAINIP: MNIC: eth0 -NODE_DESCRIPTION: 'virt search' +NODE_DESCRIPTION: 'vm' ES_HEAP_SIZE: PATCHSCHEDULENAME: -INTERFACE: bond0 +INTERFACE: NODETYPE: SEARCHNODE -CORECOUNT: 16 +CORECOUNT: 8 LSHOSTNAME: LSHEAP: -CPUCORES: 16 +CPUCORES: 8 IDH_MGTRESTRICT: IDH_SERVICES: -CPU: 16 -MEMORY: 32 +CPU: 8 +MEMORY: 16 DISKS: 1 COPPER: 0 SFP: 0 diff --git a/salt/setup/virt/sensor.yaml b/salt/setup/virt/sensor.yaml index e90bece35..e7064bdfe 100644 --- a/salt/setup/virt/sensor.yaml +++ b/salt/setup/virt/sensor.yaml @@ -1,6 +1,6 @@ MAINIP: MNIC: eth0 -NODE_DESCRIPTION: 'virt sensor' +NODE_DESCRIPTION: 'vm' ES_HEAP_SIZE: PATCHSCHEDULENAME: INTERFACE: bond0 @@ -12,7 +12,7 @@ CPUCORES: 4 IDH_MGTRESTRICT: IDH_SERVICES: CPU: 8 -MEMORY: 8 +MEMORY: 12 DISKS: 0 COPPER: 0 SFP: 0 diff --git a/salt/setup/virt/soinstall.map.jinja b/salt/setup/virt/soinstall.map.jinja index 566b27445..c16f6cd78 100644 --- a/salt/setup/virt/soinstall.map.jinja +++ b/salt/setup/virt/soinstall.map.jinja @@ -11,11 +11,24 @@ {% do DATA.update({'CORECOUNT': grains.num_cpus}) %} {% do DATA.update({'CPUCORES': grains.num_cpus}) %} +{% if nodetype in ['searchnode', 'receiver', 'fleet', 'heavynode'] %} -{% if nodetype == "searchnode" %} - +{# we can't use the host grain here because the grain may not be updated yet from the hostname change #} {% do DATA.update({'LSHOSTNAME': grains.id.split("_") | first}) %} +{% if total_mem >= 32000 or nodetype in ['managersearch','heavynode','standalone'] %} +{% set LSHEAP="1000m" %} +{% elif nodetype == 'eval' %} +{% set LSHEAP="700m" %} +{% else %} +{% set LSHEAP="500m" %} +{% endif %} +{% do DATA.update({'LSHEAP': LSHEAP}) %} + +{% endif %} + +{% if nodetype in ['searchnode', 'heavynode'] %} + {# this replicates the function es_heapsize in so-functions #} {% if total_mem < 8000 %} {% set ES_HEAP_SIZE = "600m" %} @@ -31,13 +44,4 @@ {% endif %} {% do DATA.update({'ES_HEAP_SIZE': ES_HEAP_SIZE}) %} -{% if total_mem >= 32000 or nodetype in ['managersearch','heavynode','standalone'] %} -{% set LSHEAP="1000m" %} -{% elif nodetype == 'eval' %} -{% set LSHEAP="700m" %} -{% else %} -{% set LSHEAP="500m" %} -{% endif %} -{% do DATA.update({'LSHEAP': LSHEAP}) %} - {% endif %} From e7ea27a1b346f1e4bfb6de0f9a26206de49749f9 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 13 Sep 2024 15:26:59 -0400 Subject: [PATCH 033/303] script to update ip address to static or dhcp inside qcow2 image --- salt/hypervisor/tools/sbin/modify_network.py | 216 +++++++++++++++++++ 1 file changed, 216 insertions(+) create mode 100644 salt/hypervisor/tools/sbin/modify_network.py diff --git a/salt/hypervisor/tools/sbin/modify_network.py b/salt/hypervisor/tools/sbin/modify_network.py new file mode 100644 index 000000000..de493e75c --- /dev/null +++ b/salt/hypervisor/tools/sbin/modify_network.py @@ -0,0 +1,216 @@ +#!/usr/bin/python3 + +import argparse +import guestfs +import re +import sys +import logging +import os +import ipaddress +import configparser +from io import StringIO + +logging.basicConfig(level=logging.INFO) +logger = logging.getLogger(__name__) + +NETWORK_CONFIG_DIR = "/etc/NetworkManager/system-connections" + +def validate_ip_address(ip_str, description="IP address"): + """ + Validates that the given string is a properly formatted IPv4 address or IPv4 interface. + """ + try: + # Try to parse as IPv4 interface (e.g., "192.168.1.10/24") + ipaddress.IPv4Interface(ip_str) + except ValueError: + try: + # Try to parse as IPv4 address (e.g., "192.168.1.10") + ipaddress.IPv4Address(ip_str) + except ValueError: + raise ValueError(f"Invalid {description}: {ip_str}") + +def validate_dns_addresses(dns_str): + """ + Validates a comma-separated list of DNS server IP addresses. + """ + dns_list = dns_str.split(',') + for dns in dns_list: + dns = dns.strip() + validate_ip_address(dns, description="DNS server address") + +def validate_interface_name(interface_name): + """ + Validates that the network interface name contains only valid characters. + """ + if not re.match(r'^[a-zA-Z0-9_\-]+$', interface_name): + raise ValueError(f"Invalid interface name: {interface_name}") + +def update_ipv4_section(content, mode, ip=None, gateway=None, dns=None, search_domain=None): + """ + Updates the IPv4 section of the network configuration file with either DHCP or static settings. + """ + config = configparser.ConfigParser(strict=False) + config.optionxform = str # Preserve case sensitivity + config.read_string(content) + + if 'ipv4' not in config.sections(): + # Handle missing [ipv4] section gracefully + config.add_section('ipv4') + + if mode == "dhcp": + config.set('ipv4', 'method', 'auto') + # Remove static addresses, DNS settings, and search domains + config.remove_option('ipv4', 'address1') + config.remove_option('ipv4', 'addresses') + config.remove_option('ipv4', 'dns') + config.remove_option('ipv4', 'dns-search') + elif mode == "static": + config.set('ipv4', 'method', 'manual') + if ip and gateway: + config.set('ipv4', 'address1', f"{ip},{gateway}") + else: + raise ValueError("Both IP address and gateway are required for static configuration.") + if dns: + config.set('ipv4', 'dns', f"{dns};") + else: + config.remove_option('ipv4', 'dns') + if search_domain: + config.set('ipv4', 'dns-search', f"{search_domain};") + else: + config.remove_option('ipv4', 'dns-search') + else: + raise ValueError(f"Invalid mode '{mode}'. Expected 'dhcp' or 'static'.") + + # Write the updated content back to a string + output = StringIO() + config.write(output, space_around_delimiters=False) + updated_content = output.getvalue() + output.close() + + return updated_content + +def modify_network_config(image_path, interface, mode, ip=None, gateway=None, dns=None, search_domain=None): + """ + Modifies the network configuration file for the given interface inside the QCOW2 image. + """ + # Check for write permissions to the image file + if not os.access(image_path, os.W_OK): + raise PermissionError(f"Write permission denied for image file: {image_path}") + + # Initialize the guestfs instance and add the image + g = guestfs.GuestFS(python_return_dict=True) + try: + g.set_network(False) # Disable network access if not needed + + # Disable SELinux relabeling + g.selinux = False # Correct way to disable SELinux relabeling + + g.add_drive_opts(image_path, format="qcow2") + g.launch() + except RuntimeError as e: + raise RuntimeError(f"Failed to initialize GuestFS or launch appliance: {e}") + + try: + # Detect and mount the operating system + os_list = g.inspect_os() + if not os_list: + raise RuntimeError(f"Unable to find any OS in {image_path}.") + + root_fs = os_list[0] + try: + g.mount(root_fs, "/") + except RuntimeError as e: + raise RuntimeError(f"Failed to mount the filesystem: {e}") + + # Check if NetworkManager configuration directory exists + if not g.is_dir(NETWORK_CONFIG_DIR): + raise FileNotFoundError(f"NetworkManager configuration directory not found in the image at {NETWORK_CONFIG_DIR}.") + + # Path to the network configuration file for the given interface + config_file_path = f"{NETWORK_CONFIG_DIR}/{interface}.nmconnection" + + # Read the current configuration file + try: + file_content = g.read_file(config_file_path) + current_content = file_content.decode('utf-8') + except RuntimeError: + raise FileNotFoundError(f"Configuration file for {interface} not found at {config_file_path}.") + except UnicodeDecodeError: + raise ValueError(f"Failed to decode the configuration file for {interface}.") + + # Update the content based on the provided arguments + updated_content = update_ipv4_section(current_content, mode, ip, gateway, dns, search_domain) + + # Write the updated content back to the configuration file + try: + g.write(config_file_path, updated_content.encode('utf-8')) + except RuntimeError as e: + raise IOError(f"Failed to write updated configuration to {config_file_path}: {e}") + + logger.info(f"Updated {interface} network configuration in {image_path} using {mode.upper()} mode.") + + except Exception as e: + raise e + finally: + g.umount_all() + g.close() + +def parse_arguments(): + """ + Parses command-line arguments for the script. + """ + parser = argparse.ArgumentParser(description="Modify IPv4 settings in a QCOW2 image for a specified network interface.") + parser.add_argument("-I", "--image", required=True, help="Path to the QCOW2 image.") + parser.add_argument("-i", "--interface", required=True, help="Network interface to modify (e.g., eth0).") + group = parser.add_mutually_exclusive_group(required=True) + group.add_argument("--dhcp", action="store_true", help="Configure interface for DHCP (IPv4).") + group.add_argument("--static4", action="store_true", help="Configure interface for static IPv4 settings.") + parser.add_argument("--ip4", help="IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration.") + parser.add_argument("--gw4", help="IPv4 gateway (e.g., 192.168.1.1). Required for static IPv4 configuration.") + parser.add_argument("--dns4", help="Comma-separated list of IPv4 DNS servers (e.g., 8.8.8.8,8.8.4.4).") + parser.add_argument("--search4", help="DNS search domain for IPv4.") + + args = parser.parse_args() + + # Validate arguments + if args.static4: + if not args.ip4 or not args.gw4: + parser.error("Both --ip4 and --gw4 are required for static IPv4 configuration.") + return args + +def main(): + """ + Main entry point for the script. + """ + try: + args = parse_arguments() + + validate_interface_name(args.interface) + + # Validate mode + if args.dhcp: + mode = "dhcp" + elif args.static4: + mode = "static" + if not args.ip4 or not args.gw4: + raise ValueError("Both --ip4 and --gw4 are required for static IPv4 configuration.") + # Validate IP addresses + validate_ip_address(args.ip4, description="IPv4 address") + validate_ip_address(args.gw4, description="IPv4 gateway") + if args.dns4: + validate_dns_addresses(args.dns4) + else: + raise ValueError("Either --dhcp or --static4 must be specified.") + + # Modify the network configuration inside the image + modify_network_config(args.image, args.interface, mode, args.ip4, args.gw4, args.dns4, args.search4) + + except KeyboardInterrupt: + logger.error("Operation cancelled by user.") + sys.exit(1) + except Exception as e: + logger.error(f"An error occurred: {e}") + sys.exit(1) + +if __name__ == "__main__": + main() From 75e8c60fe29a51c19f05d44f2b244fba8e71f05b Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 20 Sep 2024 11:03:16 -0400 Subject: [PATCH 034/303] add tools to set dhcp/static ip inside the qcow2 image --- salt/_modules/qcow2.py | 73 ++++++++++++ salt/hypervisor/init.sls | 5 + ...ify_network.py => so-qcow2-modify-network} | 75 ++++-------- salt/libvirt/packages.sls | 2 +- salt/manager/tools/sbin/so-salt-cloud | 111 +++++++++++++++--- 5 files changed, 196 insertions(+), 70 deletions(-) create mode 100644 salt/_modules/qcow2.py rename salt/hypervisor/tools/sbin/{modify_network.py => so-qcow2-modify-network} (72%) diff --git a/salt/_modules/qcow2.py b/salt/_modules/qcow2.py new file mode 100644 index 000000000..56ccb36a0 --- /dev/null +++ b/salt/_modules/qcow2.py @@ -0,0 +1,73 @@ +#!py + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +import logging +import subprocess +import shlex + +log = logging.getLogger(__name__) + +__virtualname__ = 'qcow2' + +def __virtual__(): + return __virtualname__ + +def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, search4=None): + ''' + Wrapper function to call so-qcow2-modify-network + + :param image: Path to the QCOW2 image. + :param interface: Network interface to modify (e.g., 'eth0'). + :param mode: 'dhcp4' or 'static4'. + :param ip4: IPv4 address with CIDR notation (e.g., '192.168.1.100/24'). Required for static configuration. + :param gw4: IPv4 gateway (e.g., '192.168.1.1'). Required for static configuration. + :param dns4: Comma-separated list of IPv4 DNS servers (e.g., '8.8.8.8,8.8.4.4'). + :param search4: DNS search domain for IPv4. + + :return: A dictionary with the result of the script execution. + + CLI Example: + + .. code-block:: bash + + salt '*' qcow2.modify_network_config image='/path/to/image.qcow2' interface='eth0' mode='static4' ip4='192.168.1.100/24' gw4='192.168.1.1' dns4='8.8.8.8,8.8.4.4' search4='example.com' + + ''' + + cmd = ['/usr/sbin/so-qcow2-modify-network.py', '-I', image, '-i', interface] + + if mode.lower() == 'dhcp4': + cmd.append('--dhcp4') + elif mode.lower() == 'static4': + cmd.append('--static4') + if not ip4 or not gw4: + raise ValueError('Both ip4 and gw4 are required for static configuration.') + cmd.extend(['--ip4', ip4, '--gw4', gw4]) + if dns4: + cmd.extend(['--dns4', dns4]) + if search4: + cmd.extend(['--search4', search4]) + else: + raise ValueError("Invalid mode '{}'. Expected 'dhcp4' or 'static4'.".format(mode)) + + log.info('qcow2 module: Executing command: {}'.format(' '.join(shlex.quote(arg) for arg in cmd))) + + try: + result = subprocess.run(cmd, capture_output=True, text=True, check=False) + ret = { + 'retcode': result.returncode, + 'stdout': result.stdout, + 'stderr': result.stderr + } + if result.returncode != 0: + log.error('qcow2 module: Script execution failed with return code {}: {}'.format(result.returncode, result.stderr)) + else: + log.info('qcow2 module: Script executed successfully.') + return ret + except Exception as e: + log.error('qcow2 module: An error occurred while executing the script: {}'.format(e)) + raise diff --git a/salt/hypervisor/init.sls b/salt/hypervisor/init.sls index e69de29bb..3fcd33934 100644 --- a/salt/hypervisor/init.sls +++ b/salt/hypervisor/init.sls @@ -0,0 +1,5 @@ +hypervisor_sbin: + file.recurse: + - name: /usr/sbin + - source: salt://hypervisor/tools/sbin + - file_mode: 744 diff --git a/salt/hypervisor/tools/sbin/modify_network.py b/salt/hypervisor/tools/sbin/so-qcow2-modify-network similarity index 72% rename from salt/hypervisor/tools/sbin/modify_network.py rename to salt/hypervisor/tools/sbin/so-qcow2-modify-network index de493e75c..a520871d1 100644 --- a/salt/hypervisor/tools/sbin/modify_network.py +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -1,5 +1,10 @@ #!/usr/bin/python3 +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + import argparse import guestfs import re @@ -16,55 +21,39 @@ logger = logging.getLogger(__name__) NETWORK_CONFIG_DIR = "/etc/NetworkManager/system-connections" def validate_ip_address(ip_str, description="IP address"): - """ - Validates that the given string is a properly formatted IPv4 address or IPv4 interface. - """ try: - # Try to parse as IPv4 interface (e.g., "192.168.1.10/24") ipaddress.IPv4Interface(ip_str) except ValueError: try: - # Try to parse as IPv4 address (e.g., "192.168.1.10") ipaddress.IPv4Address(ip_str) except ValueError: raise ValueError(f"Invalid {description}: {ip_str}") def validate_dns_addresses(dns_str): - """ - Validates a comma-separated list of DNS server IP addresses. - """ dns_list = dns_str.split(',') for dns in dns_list: dns = dns.strip() validate_ip_address(dns, description="DNS server address") def validate_interface_name(interface_name): - """ - Validates that the network interface name contains only valid characters. - """ if not re.match(r'^[a-zA-Z0-9_\-]+$', interface_name): raise ValueError(f"Invalid interface name: {interface_name}") def update_ipv4_section(content, mode, ip=None, gateway=None, dns=None, search_domain=None): - """ - Updates the IPv4 section of the network configuration file with either DHCP or static settings. - """ config = configparser.ConfigParser(strict=False) - config.optionxform = str # Preserve case sensitivity + config.optionxform = str config.read_string(content) if 'ipv4' not in config.sections(): - # Handle missing [ipv4] section gracefully config.add_section('ipv4') - if mode == "dhcp": + if mode == "dhcp4": config.set('ipv4', 'method', 'auto') - # Remove static addresses, DNS settings, and search domains config.remove_option('ipv4', 'address1') config.remove_option('ipv4', 'addresses') config.remove_option('ipv4', 'dns') config.remove_option('ipv4', 'dns-search') - elif mode == "static": + elif mode == "static4": config.set('ipv4', 'method', 'manual') if ip and gateway: config.set('ipv4', 'address1', f"{ip},{gateway}") @@ -79,9 +68,8 @@ def update_ipv4_section(content, mode, ip=None, gateway=None, dns=None, search_d else: config.remove_option('ipv4', 'dns-search') else: - raise ValueError(f"Invalid mode '{mode}'. Expected 'dhcp' or 'static'.") + raise ValueError(f"Invalid mode '{mode}'. Expected 'dhcp4' or 'static4'.") - # Write the updated content back to a string output = StringIO() config.write(output, space_around_delimiters=False) updated_content = output.getvalue() @@ -89,29 +77,21 @@ def update_ipv4_section(content, mode, ip=None, gateway=None, dns=None, search_d return updated_content +# modify the network config file for the interface inside the qcow2 image def modify_network_config(image_path, interface, mode, ip=None, gateway=None, dns=None, search_domain=None): - """ - Modifies the network configuration file for the given interface inside the QCOW2 image. - """ - # Check for write permissions to the image file if not os.access(image_path, os.W_OK): raise PermissionError(f"Write permission denied for image file: {image_path}") - # Initialize the guestfs instance and add the image g = guestfs.GuestFS(python_return_dict=True) try: - g.set_network(False) # Disable network access if not needed - - # Disable SELinux relabeling - g.selinux = False # Correct way to disable SELinux relabeling - + g.set_network(False) + g.selinux = False g.add_drive_opts(image_path, format="qcow2") g.launch() except RuntimeError as e: raise RuntimeError(f"Failed to initialize GuestFS or launch appliance: {e}") try: - # Detect and mount the operating system os_list = g.inspect_os() if not os_list: raise RuntimeError(f"Unable to find any OS in {image_path}.") @@ -122,14 +102,11 @@ def modify_network_config(image_path, interface, mode, ip=None, gateway=None, dn except RuntimeError as e: raise RuntimeError(f"Failed to mount the filesystem: {e}") - # Check if NetworkManager configuration directory exists if not g.is_dir(NETWORK_CONFIG_DIR): raise FileNotFoundError(f"NetworkManager configuration directory not found in the image at {NETWORK_CONFIG_DIR}.") - # Path to the network configuration file for the given interface config_file_path = f"{NETWORK_CONFIG_DIR}/{interface}.nmconnection" - # Read the current configuration file try: file_content = g.read_file(config_file_path) current_content = file_content.decode('utf-8') @@ -138,16 +115,14 @@ def modify_network_config(image_path, interface, mode, ip=None, gateway=None, dn except UnicodeDecodeError: raise ValueError(f"Failed to decode the configuration file for {interface}.") - # Update the content based on the provided arguments updated_content = update_ipv4_section(current_content, mode, ip, gateway, dns, search_domain) - # Write the updated content back to the configuration file try: g.write(config_file_path, updated_content.encode('utf-8')) except RuntimeError as e: raise IOError(f"Failed to write updated configuration to {config_file_path}: {e}") - logger.info(f"Updated {interface} network configuration in {image_path} using {mode.upper()} mode.") + logger.info(f"so-qcow2-modify-network: Updated {interface} network configuration in {image_path} using {mode.upper()} mode.") except Exception as e: raise e @@ -156,14 +131,11 @@ def modify_network_config(image_path, interface, mode, ip=None, gateway=None, dn g.close() def parse_arguments(): - """ - Parses command-line arguments for the script. - """ parser = argparse.ArgumentParser(description="Modify IPv4 settings in a QCOW2 image for a specified network interface.") parser.add_argument("-I", "--image", required=True, help="Path to the QCOW2 image.") parser.add_argument("-i", "--interface", required=True, help="Network interface to modify (e.g., eth0).") group = parser.add_mutually_exclusive_group(required=True) - group.add_argument("--dhcp", action="store_true", help="Configure interface for DHCP (IPv4).") + group.add_argument("--dhcp4", action="store_true", help="Configure interface for DHCP (IPv4).") group.add_argument("--static4", action="store_true", help="Configure interface for static IPv4 settings.") parser.add_argument("--ip4", help="IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration.") parser.add_argument("--gw4", help="IPv4 gateway (e.g., 192.168.1.1). Required for static IPv4 configuration.") @@ -172,44 +144,37 @@ def parse_arguments(): args = parser.parse_args() - # Validate arguments if args.static4: if not args.ip4 or not args.gw4: parser.error("Both --ip4 and --gw4 are required for static IPv4 configuration.") return args def main(): - """ - Main entry point for the script. - """ try: args = parse_arguments() validate_interface_name(args.interface) - # Validate mode - if args.dhcp: - mode = "dhcp" + if args.dhcp4: + mode = "dhcp4" elif args.static4: - mode = "static" + mode = "static4" if not args.ip4 or not args.gw4: raise ValueError("Both --ip4 and --gw4 are required for static IPv4 configuration.") - # Validate IP addresses validate_ip_address(args.ip4, description="IPv4 address") validate_ip_address(args.gw4, description="IPv4 gateway") if args.dns4: validate_dns_addresses(args.dns4) else: - raise ValueError("Either --dhcp or --static4 must be specified.") + raise ValueError("Either --dhcp4 or --static4 must be specified.") - # Modify the network configuration inside the image modify_network_config(args.image, args.interface, mode, args.ip4, args.gw4, args.dns4, args.search4) except KeyboardInterrupt: - logger.error("Operation cancelled by user.") + logger.error("so-qcow2-modify-network: Operation cancelled by user.") sys.exit(1) except Exception as e: - logger.error(f"An error occurred: {e}") + logger.error(f"so-qcow2-modify-network: An error occurred: {e}") sys.exit(1) if __name__ == "__main__": diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index 9b56c6f64..c79f42dd8 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -39,6 +39,6 @@ libvirt_python_wheel: libvirt_python_module: cmd.run: - - name: /opt/saltstack/salt/bin/python3.10 -m pip install --no-index --find-links=/opt/so/conf/libvirt/source-packages/libvirt-python libvirt-python + - name: /opt/saltstack/salt/bin/python3 -m pip install --no-index --find-links=/opt/so/conf/libvirt/source-packages/libvirt-python libvirt-python - onchanges: - file: libvirt_python_wheel diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index b34252730..c62519182 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -1,4 +1,4 @@ -#!/usr/bin/python3 +#!/opt/saltstack/salt/bin/python3 # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at @@ -8,7 +8,26 @@ import argparse import subprocess import re +import sys import threading +import salt.client + +local = salt.client.LocalClient() + +import logging + +logger = logging.getLogger(__name__) +logger.setLevel(logging.INFO) + +file_handler = logging.FileHandler('/opt/so/log/salt/so-salt-cloud.log') +console_handler = logging.StreamHandler() + +formatter = logging.Formatter('%(asctime)s %(message)s') +file_handler.setFormatter(formatter) +console_handler.setFormatter(formatter) + +logger.addHandler(file_handler) +logger.addHandler(console_handler) def call_so_firewall_minion(ip, role): try: @@ -20,8 +39,16 @@ def call_so_firewall_minion(ip, role): text=True ) + # Read and log the output + for line in iter(process.stdout.readline, ''): + if line: + logger.info(line.rstrip('\n')) + + process.stdout.close() + process.wait() + except Exception as e: - print(f"An error occurred while calling the command: {e}") + logger.error(f"An error occurred while calling so-firewall-minion: {e}") def call_salt_cloud(profile, vm_name): try: @@ -38,38 +65,94 @@ def call_salt_cloud(profile, vm_name): ip_search_string = '[INFO ] Address =' ip_search_pattern = re.compile(re.escape(ip_search_string)) - # Continuously read the output + # continuously read the output from salt-cloud while True: # Read stdout line by line line = process.stdout.readline() if line: - print(line.rstrip('\n')) + logger.info(line.rstrip('\n')) if ip_search_pattern.search(line): parts = line.split("Address =") if len(parts) > 1: ip_address = parts[1].strip() - print("Extracted IP address:", ip_address) + logger.info(f"Extracted IP address: {ip_address}") # Create and start a thread to run so-firewall-minion - thread = threading.Thread(target=call_so_firewall_minion, args=(ip_address,role.upper())) + thread = threading.Thread(target=call_so_firewall_minion, args=(ip_address, role.upper())) thread.start() else: - print("No IP address found.") + logger.error("No IP address found.") + else: + # check if salt-cloud has terminated + if process.poll() is not None: + break - # Check if the process has terminated - elif process.poll() is not None: - # process finished - break + process.stdout.close() + process.wait() except Exception as e: - print(f"An error occurred while calling the command: {e}") + logger.error(f"An error occurred while calling salt-cloud: {e}") -if __name__ == "__main__": +# This function requires the cloud profile to be in the form: basedomain_hypervisorhostname. The profile name will be used to target the hypervisor. +def run_qcow2_modify_network_config(profile, mode, ip=None, gateway=None, dns=None, search_domain=None): + hv_name = profile.split('-')[1] + target = hv_name + "_*" + image = '/var/lib/libvirt/images/coreol9/coreol9.qcow2.MODIFIED' + interface = 'eth0' + try: + r = local.cmd(target, 'qcow2.modify_network_config', [ + 'image=' + image, + 'interface=' + interface, + 'mode=' + mode, + 'ip4=' + ip if ip else '', + 'gw4=' + gateway if gateway else '', + 'dns4=' + dns if dns else '', + 'search4=' + search_domain if search_domain else '' + ]) + logger.info(f'qcow2.modify_network_config: {r}') + except Exception as e: + logger.error(f"An error occurred while running qcow2.modify_network_config: {e}") + +def parse_arguments(): parser = argparse.ArgumentParser(description="Call salt-cloud and pass the profile and VM name to it.") parser.add_argument('-p', '--profile', type=str, required=True, help="The cloud profile to build the VM from.") parser.add_argument('vm_name', type=str, help="The name of the VM.") + group = parser.add_mutually_exclusive_group(required=True) + group.add_argument("--dhcp4", action="store_true", help="Configure interface for DHCP (IPv4).") + group.add_argument("--static4", action="store_true", help="Configure interface for static IPv4 settings.") + parser.add_argument("--ip4", help="IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration.") + parser.add_argument("--gw4", help="IPv4 gateway (e.g., 192.168.1.1). Required for static IPv4 configuration.") + parser.add_argument("--dns4", help="Comma-separated list of IPv4 DNS servers (e.g., 8.8.8.8,8.8.4.4).") + parser.add_argument("--search4", help="DNS search domain for IPv4.") args = parser.parse_args() - call_salt_cloud(args.profile, args.vm_name) + if args.static4: + if not args.ip4 or not args.gw4: + parser.error("Both --ip4 and --gw4 are required for static IPv4 configuration.") + return args + +def main(): + try: + args = parse_arguments() + + if args.dhcp4: + mode = "dhcp4" + elif args.static4: + mode = "static4" + else: + mode = "dhcp4" # Default to DHCP if not specified + + run_qcow2_modify_network_config(args.profile, mode, args.ip4, args.gw4, args.dns4, args.search4) + call_salt_cloud(args.profile, args.vm_name) + + except KeyboardInterrupt: + logger.error("so-salt-cloud: Operation cancelled by user.") + sys.exit(1) + except Exception as e: + logger.error(f"so-salt-cloud: An error occurred: {e}") + sys.exit(1) + +if __name__ == "__main__": + main() From d0963baad4bba999a9b894dbb8607d0aff92927e Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 20 Sep 2024 14:50:08 -0400 Subject: [PATCH 035/303] update logging --- salt/hypervisor/init.sls | 4 ++ .../tools/sbin/so-qcow2-modify-network | 41 ++++++++++++++++--- 2 files changed, 39 insertions(+), 6 deletions(-) diff --git a/salt/hypervisor/init.sls b/salt/hypervisor/init.sls index 3fcd33934..3fa63bbcb 100644 --- a/salt/hypervisor/init.sls +++ b/salt/hypervisor/init.sls @@ -1,3 +1,7 @@ +hypervisor_log_dir: + file.directory: + - name: /opt/so/log/hypervisor + hypervisor_sbin: file.recurse: - name: /usr/sbin diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin/so-qcow2-modify-network index a520871d1..7d4612730 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -5,6 +5,17 @@ # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +""" +Script to modify the NetworkManager config within a qcow2 image. + +Usage: + python so-qcow2-modify-network.py -v [-c ] [-m ] [-p ] + +Example: + python so-qcow2-modify-network.py -I path_to_image -i interface --static4 --ip4 192.168.1.10 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --seearch4 example.local + python so-qcow2-modify-network.py -I path_to_image -i interface --dhcp4 +""" + import argparse import guestfs import re @@ -15,11 +26,28 @@ import ipaddress import configparser from io import StringIO -logging.basicConfig(level=logging.INFO) -logger = logging.getLogger(__name__) - NETWORK_CONFIG_DIR = "/etc/NetworkManager/system-connections" +def setup_logging(): + logger = logging.getLogger('so-qcow2-modify-network') + logger.setLevel(logging.INFO) + + # Create handlers + c_handler = logging.StreamHandler() + f_handler = logging.FileHandler('/opt/so/log/hypervisor/so-qcow2-modify-network.log') + c_handler.setLevel(logging.INFO) + f_handler.setLevel(logging.INFO) + + # Create formatter and add it to handlers + formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s') + c_handler.setFormatter(formatter) + f_handler.setFormatter(formatter) + + # Add handlers to the logger + logger.addHandler(c_handler) + logger.addHandler(f_handler) + return logger + def validate_ip_address(ip_str, description="IP address"): try: ipaddress.IPv4Interface(ip_str) @@ -122,7 +150,7 @@ def modify_network_config(image_path, interface, mode, ip=None, gateway=None, dn except RuntimeError as e: raise IOError(f"Failed to write updated configuration to {config_file_path}: {e}") - logger.info(f"so-qcow2-modify-network: Updated {interface} network configuration in {image_path} using {mode.upper()} mode.") + logger.info(f"Updated {interface} network configuration in {image_path} using {mode.upper()} mode.") except Exception as e: raise e @@ -151,6 +179,7 @@ def parse_arguments(): def main(): try: + logger = setup_logging() args = parse_arguments() validate_interface_name(args.interface) @@ -171,10 +200,10 @@ def main(): modify_network_config(args.image, args.interface, mode, args.ip4, args.gw4, args.dns4, args.search4) except KeyboardInterrupt: - logger.error("so-qcow2-modify-network: Operation cancelled by user.") + logger.error("Operation cancelled by user.") sys.exit(1) except Exception as e: - logger.error(f"so-qcow2-modify-network: An error occurred: {e}") + logger.error(f"An error occurred: {e}") sys.exit(1) if __name__ == "__main__": From 0b326370bd7cf5c7bca4f98e77a661717f0a2786 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 20 Sep 2024 14:51:36 -0400 Subject: [PATCH 036/303] script for modifying hardware of a vm --- .../tools/sbin/so-kvm-modify-hardware | 186 ++++++++++++++++++ 1 file changed, 186 insertions(+) create mode 100644 salt/hypervisor/tools/sbin/so-kvm-modify-hardware diff --git a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware new file mode 100644 index 000000000..299cf8df0 --- /dev/null +++ b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware @@ -0,0 +1,186 @@ +#!/usr/bin/env python3 + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +""" +Script to modify hardware parameters of a KVM virtual machine. + +Usage: + python so-kvm-modify-hardware.py -v [-c ] [-m ] [-p ] + +Example: + python so-kvm-modify-hardware.py -v my_vm -c 4 -m 8192 -p 0000:00:1f.2 +""" + +import argparse +import logging +import sys +import time +import libvirt +import xml.etree.ElementTree as ET + +def setup_logging(): + logger = logging.getLogger('so-kvm-modify-hardware') + logger.setLevel(logging.INFO) + + # Create handlers + c_handler = logging.StreamHandler() + f_handler = logging.FileHandler('/opt/so/log/hypervisor/so-kvm-modify-hardware.log') + c_handler.setLevel(logging.INFO) + f_handler.setLevel(logging.INFO) + + # Create formatter and add it to handlers + formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s') + c_handler.setFormatter(formatter) + f_handler.setFormatter(formatter) + + # Add handlers to the logger + logger.addHandler(c_handler) + logger.addHandler(f_handler) + return logger + +def parse_arguments(): + parser = argparse.ArgumentParser(description='Modify hardware parameters of a KVM virtual machine.') + parser.add_argument('-v', '--vm', required=True, help='Name of the virtual machine to modify.') + parser.add_argument('-c', '--cpu', type=int, help='Number of virtual CPUs to assign.') + parser.add_argument('-m', '--memory', type=int, help='Amount of memory to assign in MiB.') + parser.add_argument('-p', '--pci', help='PCI hardware ID to passthrough to the VM (e.g., 0000:00:1f.2).') + args = parser.parse_args() + return args + +def stop_vm(conn, vm_name, logger): + try: + dom = conn.lookupByName(vm_name) + if dom.isActive(): + logger.info(f"Shutting down VM '{vm_name}'...") + dom.shutdown() + # Wait for the VM to shut down + while dom.isActive(): + time.sleep(1) + logger.info(f"VM '{vm_name}' has been stopped.") + else: + logger.info(f"VM '{vm_name}' is already stopped.") + return dom + except libvirt.libvirtError as e: + logger.error(f"Failed to stop VM '{vm_name}': {e}") + sys.exit(1) + +def modify_vm(dom, cpu_count, memory_amount, pci_id, logger): + try: + # Get the XML description of the VM + xml_desc = dom.XMLDesc() + root = ET.fromstring(xml_desc) + + # Modify CPU count + if cpu_count is not None: + vcpu_elem = root.find('./vcpu') + if vcpu_elem is not None: + vcpu_elem.text = str(cpu_count) + logger.info(f"Set CPU count to {cpu_count}.") + else: + logger.error("Could not find element in XML.") + sys.exit(1) + + # Modify memory amount + if memory_amount is not None: + memory_elem = root.find('./memory') + current_memory_elem = root.find('./currentMemory') + if memory_elem is not None and current_memory_elem is not None: + memory_elem.text = str(memory_amount * 1024) # Convert MiB to KiB + current_memory_elem.text = str(memory_amount * 1024) + logger.info(f"Set memory to {memory_amount} MiB.") + else: + logger.error("Could not find elements in XML.") + sys.exit(1) + + # Add PCI device passthrough + if pci_id is not None: + devices_elem = root.find('./devices') + if devices_elem is not None: + hostdev_elem = ET.SubElement(devices_elem, 'hostdev', attrib={ + 'mode': 'subsystem', + 'type': 'pci', + 'managed': 'yes' + }) + source_elem = ET.SubElement(hostdev_elem, 'source') + domain_id, bus_slot_func = pci_id.split(':') + bus_slot, function = bus_slot_func.split('.') + address_attrs = { + 'domain': f'0x{domain_id}', + 'bus': f'0x{bus_slot}', + 'slot': f'0x{bus_slot}', + 'function': f'0x{function}' + } + ET.SubElement(source_elem, 'address', attrib=address_attrs) + logger.info(f"Added PCI device passthrough for {pci_id}.") + else: + logger.error("Could not find element in XML.") + sys.exit(1) + + # Convert XML back to string + new_xml_desc = ET.tostring(root, encoding='unicode') + return new_xml_desc + except Exception as e: + logger.error(f"Failed to modify VM XML: {e}") + sys.exit(1) + +def redefine_vm(conn, new_xml_desc, logger): + try: + conn.defineXML(new_xml_desc) + logger.info("VM redefined with new hardware parameters.") + except libvirt.libvirtError as e: + logger.error(f"Failed to redefine VM: {e}") + sys.exit(1) + +def start_vm(dom, logger): + try: + dom.create() + logger.info("VM started successfully.") + except libvirt.libvirtError as e: + logger.error(f"Failed to start VM: {e}") + sys.exit(1) + +def main(): + try: + logger = setup_logging() + args = parse_arguments() + + vm_name = args.vm + cpu_count = args.cpu + memory_amount = args.memory + pci_id = args.pci + + # Connect to libvirt + try: + conn = libvirt.open(None) + except libvirt.libvirtError as e: + logger.error(f"Failed to open connection to libvirt: {e}") + sys.exit(1) + + # Stop VM if running + dom = stop_vm(conn, vm_name, logger) + + # Modify VM XML + new_xml_desc = modify_vm(dom, cpu_count, memory_amount, pci_id, logger) + + # Redefine VM + redefine_vm(conn, new_xml_desc, logger) + + # Start VM + dom = conn.lookupByName(vm_name) + start_vm(dom, logger) + + # Close connection + conn.close() + except KeyboardInterrupt: + logger.error("Operation cancelled by user.") + sys.exit(1) + except Exception as e: + logger.error(f"An error occurred: {e}") + sys.exit(1) + +if __name__ == '__main__': + main() From 50bd8448cc8910ba59a71c1ef21410df149a61b3 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 23 Sep 2024 10:13:22 -0400 Subject: [PATCH 037/303] add arg to start vm after modification --- salt/hypervisor/tools/sbin/so-kvm-modify-hardware | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware index 299cf8df0..7bbb500af 100644 --- a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware +++ b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware @@ -9,10 +9,10 @@ Script to modify hardware parameters of a KVM virtual machine. Usage: - python so-kvm-modify-hardware.py -v [-c ] [-m ] [-p ] + python so-kvm-modify-hardware.py -v [-c ] [-m ] [-p ] [-s] Example: - python so-kvm-modify-hardware.py -v my_vm -c 4 -m 8192 -p 0000:00:1f.2 + python so-kvm-modify-hardware.py -v my_vm -c 4 -m 8192 -p 0000:00:1f.2 -s """ import argparse @@ -48,6 +48,7 @@ def parse_arguments(): parser.add_argument('-c', '--cpu', type=int, help='Number of virtual CPUs to assign.') parser.add_argument('-m', '--memory', type=int, help='Amount of memory to assign in MiB.') parser.add_argument('-p', '--pci', help='PCI hardware ID to passthrough to the VM (e.g., 0000:00:1f.2).') + parser.add_argument('-s', '--start', action='store_true', help='Start the VM after modification.') args = parser.parse_args() return args @@ -152,6 +153,7 @@ def main(): cpu_count = args.cpu memory_amount = args.memory pci_id = args.pci + start_vm_flag = args.start # Connect to libvirt try: @@ -169,9 +171,12 @@ def main(): # Redefine VM redefine_vm(conn, new_xml_desc, logger) - # Start VM - dom = conn.lookupByName(vm_name) - start_vm(dom, logger) + # Start VM if -s or --start argument is provided + if start_vm_flag: + dom = conn.lookupByName(vm_name) + start_vm(dom, logger) + else: + logger.info("VM start flag not provided; VM will remain stopped.") # Close connection conn.close() From 9f76371449143134071d53e44e5b93ce161e8a00 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 1 Oct 2024 08:33:37 -0400 Subject: [PATCH 038/303] add libs --- salt/common/tools/sbin/so_logging_utils.py | 53 ++++++++++++++++ .../tools/sbin/so-kvm-modify-hardware | 61 ++++--------------- .../tools/sbin/so-qcow2-modify-network | 41 +++++-------- salt/hypervisor/tools/sbin/so_vm_utils.py | 60 ++++++++++++++++++ 4 files changed, 140 insertions(+), 75 deletions(-) create mode 100644 salt/common/tools/sbin/so_logging_utils.py create mode 100644 salt/hypervisor/tools/sbin/so_vm_utils.py diff --git a/salt/common/tools/sbin/so_logging_utils.py b/salt/common/tools/sbin/so_logging_utils.py new file mode 100644 index 000000000..dae734ac6 --- /dev/null +++ b/salt/common/tools/sbin/so_logging_utils.py @@ -0,0 +1,53 @@ +#!/usr/bin/python3 + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +import logging +import os +import sys + +def setup_logging(logger_name, log_file_path, log_level=logging.INFO, format_str='%(asctime)s - %(levelname)s - %(message)s'): + """ + Sets up logging for a script. + + Parameters: + logger_name (str): The name of the logger. + log_file_path (str): The file path for the log file. + log_level (int): The logging level (e.g., logging.INFO, logging.DEBUG). + format_str (str): The format string for log messages. + + Returns: + logging.Logger: Configured logger object. + """ + logger = logging.getLogger(logger_name) + logger.setLevel(log_level) + + # Create directory for log file if it doesn't exist + log_file_dir = os.path.dirname(log_file_path) + if log_file_dir and not os.path.exists(log_file_dir): + try: + os.makedirs(log_file_dir) + except OSError as e: + print(f"Error creating directory {log_file_dir}: {e}") + sys.exit(1) + + # Create handlers + c_handler = logging.StreamHandler() + f_handler = logging.FileHandler(log_file_path) + c_handler.setLevel(log_level) + f_handler.setLevel(log_level) + + # Create formatter and add it to handlers + formatter = logging.Formatter(format_str) + c_handler.setFormatter(formatter) + f_handler.setFormatter(formatter) + + # Add handlers to the logger if they are not already added + if not logger.hasHandlers(): + logger.addHandler(c_handler) + logger.addHandler(f_handler) + + return logger diff --git a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware index 7bbb500af..cf4c20c49 100644 --- a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware +++ b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware @@ -1,4 +1,4 @@ -#!/usr/bin/env python3 +#!/usr/bin/python3 # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at @@ -16,31 +16,12 @@ Example: """ import argparse -import logging import sys -import time import libvirt +import logging import xml.etree.ElementTree as ET - -def setup_logging(): - logger = logging.getLogger('so-kvm-modify-hardware') - logger.setLevel(logging.INFO) - - # Create handlers - c_handler = logging.StreamHandler() - f_handler = logging.FileHandler('/opt/so/log/hypervisor/so-kvm-modify-hardware.log') - c_handler.setLevel(logging.INFO) - f_handler.setLevel(logging.INFO) - - # Create formatter and add it to handlers - formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s') - c_handler.setFormatter(formatter) - f_handler.setFormatter(formatter) - - # Add handlers to the logger - logger.addHandler(c_handler) - logger.addHandler(f_handler) - return logger +from so_vm_utils import start_vm, stop_vm +from so_logging_utils import setup_logging def parse_arguments(): parser = argparse.ArgumentParser(description='Modify hardware parameters of a KVM virtual machine.') @@ -52,23 +33,6 @@ def parse_arguments(): args = parser.parse_args() return args -def stop_vm(conn, vm_name, logger): - try: - dom = conn.lookupByName(vm_name) - if dom.isActive(): - logger.info(f"Shutting down VM '{vm_name}'...") - dom.shutdown() - # Wait for the VM to shut down - while dom.isActive(): - time.sleep(1) - logger.info(f"VM '{vm_name}' has been stopped.") - else: - logger.info(f"VM '{vm_name}' is already stopped.") - return dom - except libvirt.libvirtError as e: - logger.error(f"Failed to stop VM '{vm_name}': {e}") - sys.exit(1) - def modify_vm(dom, cpu_count, memory_amount, pci_id, logger): try: # Get the XML description of the VM @@ -136,17 +100,8 @@ def redefine_vm(conn, new_xml_desc, logger): logger.error(f"Failed to redefine VM: {e}") sys.exit(1) -def start_vm(dom, logger): - try: - dom.create() - logger.info("VM started successfully.") - except libvirt.libvirtError as e: - logger.error(f"Failed to start VM: {e}") - sys.exit(1) - def main(): try: - logger = setup_logging() args = parse_arguments() vm_name = args.vm @@ -155,6 +110,14 @@ def main(): pci_id = args.pci start_vm_flag = args.start + # Set up logging using the so_logging_utils library + logger = setup_logging( + logger_name='so-kvm-modify-hardware', + log_file_path='/opt/so/log/hypervisor/so-kvm-modify-hardware.log', + log_level=logging.INFO, + format_str='%(asctime)s - %(levelname)s - %(message)s' + ) + # Connect to libvirt try: conn = libvirt.open(None) diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin/so-qcow2-modify-network index 7d4612730..6ec83d3e3 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -6,14 +6,15 @@ # Elastic License 2.0. """ -Script to modify the NetworkManager config within a qcow2 image. +Script to modify the NetworkManager config within a QCOW2 image. Usage: - python so-qcow2-modify-network.py -v [-c ] [-m ] [-p ] + python so-qcow2-modify-network.py -I -i (--dhcp4 | --static4 --ip4 --gw4 ) [--dns4 ] [--search4 ] -Example: - python so-qcow2-modify-network.py -I path_to_image -i interface --static4 --ip4 192.168.1.10 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --seearch4 example.local - python so-qcow2-modify-network.py -I path_to_image -i interface --dhcp4 +Examples: + python so-qcow2-modify-network.py -I path_to_image -i eth0 --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --search4 example.local + + python so-qcow2-modify-network.py -I path_to_image -i eth0 --dhcp4 """ import argparse @@ -25,29 +26,11 @@ import os import ipaddress import configparser from io import StringIO +from so_logging_utils import setup_logging + NETWORK_CONFIG_DIR = "/etc/NetworkManager/system-connections" -def setup_logging(): - logger = logging.getLogger('so-qcow2-modify-network') - logger.setLevel(logging.INFO) - - # Create handlers - c_handler = logging.StreamHandler() - f_handler = logging.FileHandler('/opt/so/log/hypervisor/so-qcow2-modify-network.log') - c_handler.setLevel(logging.INFO) - f_handler.setLevel(logging.INFO) - - # Create formatter and add it to handlers - formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s') - c_handler.setFormatter(formatter) - f_handler.setFormatter(formatter) - - # Add handlers to the logger - logger.addHandler(c_handler) - logger.addHandler(f_handler) - return logger - def validate_ip_address(ip_str, description="IP address"): try: ipaddress.IPv4Interface(ip_str) @@ -179,7 +162,13 @@ def parse_arguments(): def main(): try: - logger = setup_logging() + # Set up logging using the so_logging_utils library + logger = setup_logging( + logger_name='so-qcow2-modify-network', + log_file_path='/opt/so/log/hypervisor/so-qcow2-modify-network.log', + log_level=logging.INFO, + format_str='%(asctime)s - %(levelname)s - %(message)s' + ) args = parse_arguments() validate_interface_name(args.interface) diff --git a/salt/hypervisor/tools/sbin/so_vm_utils.py b/salt/hypervisor/tools/sbin/so_vm_utils.py new file mode 100644 index 000000000..a6820b885 --- /dev/null +++ b/salt/hypervisor/tools/sbin/so_vm_utils.py @@ -0,0 +1,60 @@ +#!/usr/bin/python3 + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +import sys +import time +import libvirt +import logging + +def stop_vm(conn, vm_name, logger): + """ + Stops the specified virtual machine if it is running. + + Parameters: + conn (libvirt.virConnect): The libvirt connection object. + vm_name (str): The name of the virtual machine. + logger (logging.Logger): The logger object. + + Returns: + libvirt.virDomain: The domain object of the VM. + + Raises: + SystemExit: If the VM cannot be found or an error occurs. + """ + try: + dom = conn.lookupByName(vm_name) + if dom.isActive(): + logger.info(f"Shutting down VM '{vm_name}'...") + dom.shutdown() + # Wait for the VM to shut down + while dom.isActive(): + time.sleep(1) + logger.info(f"VM '{vm_name}' has been stopped.") + else: + logger.info(f"VM '{vm_name}' is already stopped.") + return dom + except libvirt.libvirtError as e: + logger.error(f"Failed to stop VM '{vm_name}': {e}") + sys.exit(1) + +def start_vm(dom, logger): + """ + Starts the specified virtual machine. + + Parameters: + dom (libvirt.virDomain): The domain object of the VM. + logger (logging.Logger): The logger object. + + Raises: + SystemExit: If the VM cannot be started. + """ + try: + dom.create() + logger.info(f"VM '{dom.name()}' started successfully.") + except libvirt.libvirtError as e: + logger.error(f"Failed to start VM '{dom.name()}': {e}") + sys.exit(1) From 0b0ff62bc58931157d87722f21e6a1a995d7d27b Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 8 Oct 2024 09:40:44 -0400 Subject: [PATCH 039/303] update comments --- salt/_modules/qcow2.py | 6 +++--- salt/manager/tools/sbin/so-salt-cloud | 12 ++++++++++++ 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/salt/_modules/qcow2.py b/salt/_modules/qcow2.py index 56ccb36a0..8a4f89b59 100644 --- a/salt/_modules/qcow2.py +++ b/salt/_modules/qcow2.py @@ -23,7 +23,7 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, :param image: Path to the QCOW2 image. :param interface: Network interface to modify (e.g., 'eth0'). :param mode: 'dhcp4' or 'static4'. - :param ip4: IPv4 address with CIDR notation (e.g., '192.168.1.100/24'). Required for static configuration. + :param ip4: IPv4 address with CIDR notation (e.g., '192.168.1.10/24'). Required for static configuration. :param gw4: IPv4 gateway (e.g., '192.168.1.1'). Required for static configuration. :param dns4: Comma-separated list of IPv4 DNS servers (e.g., '8.8.8.8,8.8.4.4'). :param search4: DNS search domain for IPv4. @@ -34,11 +34,11 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, .. code-block:: bash - salt '*' qcow2.modify_network_config image='/path/to/image.qcow2' interface='eth0' mode='static4' ip4='192.168.1.100/24' gw4='192.168.1.1' dns4='8.8.8.8,8.8.4.4' search4='example.com' + salt '*' qcow2.modify_network_config image='/path/to/image.qcow2' interface='eth0' mode='static4' ip4='192.168.1.10/24' gw4='192.168.1.1' dns4='8.8.8.8,8.8.4.4' search4='example.local' ''' - cmd = ['/usr/sbin/so-qcow2-modify-network.py', '-I', image, '-i', interface] + cmd = ['/usr/sbin/so-qcow2-modify-network', '-I', image, '-i', interface] if mode.lower() == 'dhcp4': cmd.append('--dhcp4') diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index c62519182..600d7bb8e 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -5,6 +5,18 @@ # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +""" +Script to assist with salt-cloud VM provisioning. This is only intended to work with a libvirt salt-cloud provider. + +Usage: + python so-salt-cloud -p (--dhcp4 | --static4 --ip4 --gw4 ) [--dns4 ] [--search4 ] + +Examples: + python so-salt-cloud -p core-hype1 hostname_nodetype --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,192.168.1.2 --search4 example.local + + python so-salt-cloud -p core-hype1 hostname_nodetype --dhcp4 +""" + import argparse import subprocess import re From dcc173897823499b4d627b02c55c2af48796ddc5 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 11 Oct 2024 10:46:07 -0400 Subject: [PATCH 040/303] dynamic annotations --- salt/hypervisor/defaults.sls | 138 ++++++++++-------- salt/hypervisor/pillar.map.jinja | 29 ++++ salt/hypervisor/pillar.sls | 0 salt/hypervisor/soc_hypervisor.yaml | 35 +++++ .../hypervisor/hypervisor.yaml | 0 .../dynamic_annotations/hypervisor/init.sls | 0 .../hypervisor/soc_hypervisor.yaml.jinja | 0 7 files changed, 142 insertions(+), 60 deletions(-) create mode 100644 salt/hypervisor/pillar.map.jinja create mode 100644 salt/hypervisor/pillar.sls create mode 100644 salt/hypervisor/soc_hypervisor.yaml create mode 100644 salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml create mode 100644 salt/soc/dynamic_annotations/hypervisor/init.sls create mode 100644 salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja diff --git a/salt/hypervisor/defaults.sls b/salt/hypervisor/defaults.sls index d1feb6d34..5157e4aed 100644 --- a/salt/hypervisor/defaults.sls +++ b/salt/hypervisor/defaults.sls @@ -1,61 +1,79 @@ hypervisor: - model1: - hardware: - cpu: - total: 128 - free: 128 - memory: - total: 128 - free: 128 - disks: - free: - 3: pci_0000_c7_00_0 - 4: pci_0000_c8_00_0 - claimed: - 1: pci_0000_c5_00_0 - 2: pci_0000_c6_00_0 - copper: - free: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - claimed: {} - sfp: - free: - 5: pci_0000_41_00_0 - 6: pci_0000_41_00_1 - claimed: {} - model2: - hardware: - cpu: - total: 128 - free: 128 - memory: - total: 512 - free: 512 - disks: - free: - 3: pci_0000_c8_00_0 - 4: pci_0000_c9_00_0 - 5: pci_0000_c10_00_0 - 6: pci_0000_c11_00_0 - claimed: - 1: pci_0000_c6_00_0 - 2: pci_0000_c7_00_0 - copper: - free: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - 5: pci_0000_c5_00_0 - 6: pci_0000_c5_00_1 - 7: pci_0000_c5_00_2 - 8: pci_0000_c5_00_3 - claimed: {} - sfp: - free: - 9: pci_0000_41_00_0 - 10: pci_0000_41_00_1 - claimed: {} + nodes: + jpphype1: + add_guest: [] + guests: + - sen1_sensor: + cpu: 2 + mem: 8192 + + jpphype1: + guests: + sen1_sensor: + hardware: + cpu: 2 + mem: 8192 + + + + models: + model1: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 128 + free: 128 + disks: + free: + 3: pci_0000_c7_00_0 + 4: pci_0000_c8_00_0 + claimed: + 1: pci_0000_c5_00_0 + 2: pci_0000_c6_00_0 + copper: + free: + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + claimed: {} + sfp: + free: + 5: pci_0000_41_00_0 + 6: pci_0000_41_00_1 + claimed: {} + model2: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 512 + free: 512 + disks: + free: + 3: pci_0000_c8_00_0 + 4: pci_0000_c9_00_0 + 5: pci_0000_c10_00_0 + 6: pci_0000_c11_00_0 + claimed: + 1: pci_0000_c6_00_0 + 2: pci_0000_c7_00_0 + copper: + free: + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + 5: pci_0000_c5_00_0 + 6: pci_0000_c5_00_1 + 7: pci_0000_c5_00_2 + 8: pci_0000_c5_00_3 + claimed: {} + sfp: + free: + 9: pci_0000_41_00_0 + 10: pci_0000_41_00_1 + claimed: {} diff --git a/salt/hypervisor/pillar.map.jinja b/salt/hypervisor/pillar.map.jinja new file mode 100644 index 000000000..3b6c275a3 --- /dev/null +++ b/salt/hypervisor/pillar.map.jinja @@ -0,0 +1,29 @@ +{% set HYPERVISORHOSTS = salt['pillar.get']('hypervisor:hosts', {}) %} + +{% import_yaml 'setup/virt/sensor.yaml' as SENSOR %} +{% import_yaml 'setup/virt/searchnode.yaml' as SEARCHNODE %} + +{% set vars = { + 'sensor': SENSOR, + 'searchnode': SEARCHNODE +} %} + +{% for host, guestDetails in HYPERVISORHOSTS.items() %} +{% if guestDetails['add_guest'] | length > 0 %} +{% for newGuest in guestDetails['add_guest'] %} +{% set indx = guestDetails['add_guest'].index(newGuest) %} +{% do guestDetails['add_guest'].pop(indx) %} +{% set NODETYPE = newGuest.split('_') | last %} +{% do guestDetails['guests'].update({ + newGuest: { + 'cpu': vars[NODETYPE].CPU, + 'memory': vars[NODETYPE].MEMORY, + 'disk': vars[NODETYPE].DISKS, + 'copper': vars[NODETYPE].COPPER, + 'sfp': vars[NODETYPE].SFP + } +}) %} + +{% endfor %} +{% endif %} +{% endfor %} diff --git a/salt/hypervisor/pillar.sls b/salt/hypervisor/pillar.sls new file mode 100644 index 000000000..e69de29bb diff --git a/salt/hypervisor/soc_hypervisor.yaml b/salt/hypervisor/soc_hypervisor.yaml new file mode 100644 index 000000000..8865b27ab --- /dev/null +++ b/salt/hypervisor/soc_hypervisor.yaml @@ -0,0 +1,35 @@ +hypervisor: + hosts: + defaultHost: + add_guest: + description: List of hypervisor nodes. + forcedType: "[]string" + global: True + multiline: True + guests: + defaultGuest: + copper: + description: Copper nics + forcedType: "[]int" + global: True + multiline: True + sfp: + description: sfp nics + forcedType: "[]int" + global: True + multiline: True + disks: + description: disk + forcedType: "[]int" + global: True + multiline: True + cpu: + description: cpu + forcedType: int + global: True + multiline: True + memory: + description: mem + forcedType: int + global: True + multiline: True diff --git a/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml b/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml new file mode 100644 index 000000000..e69de29bb diff --git a/salt/soc/dynamic_annotations/hypervisor/init.sls b/salt/soc/dynamic_annotations/hypervisor/init.sls new file mode 100644 index 000000000..e69de29bb diff --git a/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja new file mode 100644 index 000000000..e69de29bb From 047658537052b0e7df68ef3402d740366c4c69c9 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 22 Oct 2024 09:03:02 -0400 Subject: [PATCH 041/303] dynamic annotations --- salt/hypervisor/pillar.sls | 5 +++ .../hypervisor/hypervisor.yaml | 35 +++++++++++++++++++ .../dynamic_annotations/hypervisor/init.sls | 5 +++ .../hypervisor/soc_hypervisor.yaml.jinja | 12 +++++++ 4 files changed, 57 insertions(+) diff --git a/salt/hypervisor/pillar.sls b/salt/hypervisor/pillar.sls index e69de29bb..92c1cbfec 100644 --- a/salt/hypervisor/pillar.sls +++ b/salt/hypervisor/pillar.sls @@ -0,0 +1,5 @@ +soc_hypervisor_pillar: + file.managed: + - name: /opt/so/saltstack/local/pillar/hypervisor/soc_hypervisor.sls + - source: salt://hypervisor/pillar.map.jinja + - template: jinja diff --git a/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml b/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml index e69de29bb..f52779e9c 100644 --- a/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml +++ b/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml @@ -0,0 +1,35 @@ +hypervisor: + hosts: + defaultHost: + add_guest: + description: Add a new guest to the hypervisor. + forcedType: "[]string" + global: True + multiline: True + guests: + defaultGuest: + copper: + description: Copper nics + forcedType: "[]int" + global: True + multiline: True + sfp: + description: sfp nics + forcedType: string + global: True + multiline: True + disks: + description: disk + forcedType: "[]int" + global: True + multiline: True + cpu: + description: cpu + forcedType: int + global: True + multiline: True + memory: + description: mem + forcedType: int + global: True + multiline: True diff --git a/salt/soc/dynamic_annotations/hypervisor/init.sls b/salt/soc/dynamic_annotations/hypervisor/init.sls index e69de29bb..74db9d9a2 100644 --- a/salt/soc/dynamic_annotations/hypervisor/init.sls +++ b/salt/soc/dynamic_annotations/hypervisor/init.sls @@ -0,0 +1,5 @@ +hypervisor_annotation: + file.managed: + - name: /opt/so/saltstack/default/salt/hypervisor/soc_hypervisor.yaml + - source: salt://soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja + - template: jinja diff --git a/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja index e69de29bb..f96b3ea13 100644 --- a/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja @@ -0,0 +1,12 @@ +{% import_yaml 'soc/dynamic_annotations/hypervisor/hypervisor.yaml' as ANNOTATION %} +{% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {}) %} + +{% set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') %} +{# remove defaultGuest so that it is not shown in Grid Configuration UI #} +{% do TEMPLATE['guests'].pop('defaultGuest') %} + +{% for hypervisor in HYPERVISORS.hypervisor %} +{% do ANNOTATION.hypervisor.hosts.update({hypervisor: TEMPLATE}) %} +{% endfor %} + +{{ ANNOTATION | yaml(False) }} From c64a05f2ff914b632e0642b0b0697a0de6f3d2ee Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 29 Oct 2024 10:20:31 -0400 Subject: [PATCH 042/303] dynamic annotations --- .../dynamic_annotations/hypervisor/add_node | 11 +++++++++ .../hypervisor/hypervisor.yaml | 11 ++++++--- .../dynamic_annotations/hypervisor/init.sls | 23 +++++++++++++++++++ .../dynamic_annotations/hypervisor/map.jinja | 1 + .../hypervisor/soc_hypervisor.yaml.jinja | 7 +++--- 5 files changed, 47 insertions(+), 6 deletions(-) create mode 100644 salt/soc/dynamic_annotations/hypervisor/add_node create mode 100644 salt/soc/dynamic_annotations/hypervisor/map.jinja diff --git a/salt/soc/dynamic_annotations/hypervisor/add_node b/salt/soc/dynamic_annotations/hypervisor/add_node new file mode 100644 index 000000000..498db1460 --- /dev/null +++ b/salt/soc/dynamic_annotations/hypervisor/add_node @@ -0,0 +1,11 @@ +hostname: +network_mode: +ip4: +gw4: +dns4: +sarch4: +cpu: +memory: +disk: +copper: +sfp: diff --git a/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml b/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml index f52779e9c..0ec53ff30 100644 --- a/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml +++ b/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml @@ -1,9 +1,14 @@ hypervisor: hosts: defaultHost: - add_guest: - description: Add a new guest to the hypervisor. - forcedType: "[]string" + add_searchnode: + description: Add a new searchnode to the hypervisor. + file: True + global: True + multiline: True + add_sensor: + description: Add a new sensor to the hypervisor. + file: True global: True multiline: True guests: diff --git a/salt/soc/dynamic_annotations/hypervisor/init.sls b/salt/soc/dynamic_annotations/hypervisor/init.sls index 74db9d9a2..8c857e72f 100644 --- a/salt/soc/dynamic_annotations/hypervisor/init.sls +++ b/salt/soc/dynamic_annotations/hypervisor/init.sls @@ -1,5 +1,28 @@ +{% from 'soc/dynamic_annotations/hypervisor/map.jinja' import HYPERVISORS %} + hypervisor_annotation: file.managed: - name: /opt/so/saltstack/default/salt/hypervisor/soc_hypervisor.yaml - source: salt://soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja - template: jinja + - defaults: + HYPERVISORS: {{ HYPERVISORS }} + +{% for role in HYPERVISORS %} +{% for hypervisor in HYPERVISORS[role].keys() %} +hypervisor_host_directory_{{hypervisor}}: + file.directory: + - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}} + - makedirs: True + +add_searchnode_file_{{hypervisor}}: + file.managed: + - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}}/add_searchnode + - source: salt://soc/dynamic_annotations/hypervisor/add_node + +add_sensor_file_{{hypervisor}}: + file.managed: + - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}}/add_sensor + - source: salt://soc/dynamic_annotations/hypervisor/add_node +{% endfor %} +{% endfor %} diff --git a/salt/soc/dynamic_annotations/hypervisor/map.jinja b/salt/soc/dynamic_annotations/hypervisor/map.jinja new file mode 100644 index 000000000..b14a437b5 --- /dev/null +++ b/salt/soc/dynamic_annotations/hypervisor/map.jinja @@ -0,0 +1 @@ +{% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {}) %} diff --git a/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja index f96b3ea13..c9dd8200d 100644 --- a/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja @@ -1,12 +1,13 @@ {% import_yaml 'soc/dynamic_annotations/hypervisor/hypervisor.yaml' as ANNOTATION %} -{% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {}) %} {% set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') %} {# remove defaultGuest so that it is not shown in Grid Configuration UI #} {% do TEMPLATE['guests'].pop('defaultGuest') %} -{% for hypervisor in HYPERVISORS.hypervisor %} -{% do ANNOTATION.hypervisor.hosts.update({hypervisor: TEMPLATE}) %} +{% for role in HYPERVISORS %} +{% for hypervisor in HYPERVISORS[role].keys() %} +{% do ANNOTATION.hypervisor.hosts.update({hypervisor: TEMPLATE}) %} +{% endfor %} {% endfor %} {{ ANNOTATION | yaml(False) }} From 3394588602508bcde6e3c58b018b901f027363fd Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 29 Oct 2024 10:56:18 -0400 Subject: [PATCH 043/303] sync hypervisor state remote to local --- salt/hypervisor/defaults.brainstorm.yaml | 0 salt/hypervisor/defaults.sls | 79 ------------------- salt/hypervisor/defaults.yaml | 62 +++++++++++++++ salt/hypervisor/soc_hypervisor.yaml | 46 +++-------- .../tools/sbin/so-kvm-modify-hardware | 16 ++-- .../tools/sbin/so-qcow2-modify-network | 18 ++--- 6 files changed, 92 insertions(+), 129 deletions(-) create mode 100644 salt/hypervisor/defaults.brainstorm.yaml delete mode 100644 salt/hypervisor/defaults.sls create mode 100644 salt/hypervisor/defaults.yaml diff --git a/salt/hypervisor/defaults.brainstorm.yaml b/salt/hypervisor/defaults.brainstorm.yaml new file mode 100644 index 000000000..e69de29bb diff --git a/salt/hypervisor/defaults.sls b/salt/hypervisor/defaults.sls deleted file mode 100644 index 5157e4aed..000000000 --- a/salt/hypervisor/defaults.sls +++ /dev/null @@ -1,79 +0,0 @@ -hypervisor: - nodes: - jpphype1: - add_guest: [] - guests: - - sen1_sensor: - cpu: 2 - mem: 8192 - - jpphype1: - guests: - sen1_sensor: - hardware: - cpu: 2 - mem: 8192 - - - - models: - model1: - hardware: - cpu: - total: 128 - free: 128 - memory: - total: 128 - free: 128 - disks: - free: - 3: pci_0000_c7_00_0 - 4: pci_0000_c8_00_0 - claimed: - 1: pci_0000_c5_00_0 - 2: pci_0000_c6_00_0 - copper: - free: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - claimed: {} - sfp: - free: - 5: pci_0000_41_00_0 - 6: pci_0000_41_00_1 - claimed: {} - model2: - hardware: - cpu: - total: 128 - free: 128 - memory: - total: 512 - free: 512 - disks: - free: - 3: pci_0000_c8_00_0 - 4: pci_0000_c9_00_0 - 5: pci_0000_c10_00_0 - 6: pci_0000_c11_00_0 - claimed: - 1: pci_0000_c6_00_0 - 2: pci_0000_c7_00_0 - copper: - free: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - 5: pci_0000_c5_00_0 - 6: pci_0000_c5_00_1 - 7: pci_0000_c5_00_2 - 8: pci_0000_c5_00_3 - claimed: {} - sfp: - free: - 9: pci_0000_41_00_0 - 10: pci_0000_41_00_1 - claimed: {} diff --git a/salt/hypervisor/defaults.yaml b/salt/hypervisor/defaults.yaml new file mode 100644 index 000000000..4a762e677 --- /dev/null +++ b/salt/hypervisor/defaults.yaml @@ -0,0 +1,62 @@ +hypervisor: + nodes: [] + model1: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 128 + free: 128 + disks: + free: + 3: pci_0000_c7_00_0 + 4: pci_0000_c8_00_0 + claimed: + 1: pci_0000_c5_00_0 + 2: pci_0000_c6_00_0 + copper: + free: + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + claimed: {} + sfp: + free: + 5: pci_0000_41_00_0 + 6: pci_0000_41_00_1 + claimed: {} + model2: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 512 + free: 512 + disks: + free: + 3: pci_0000_c8_00_0 + 4: pci_0000_c9_00_0 + 5: pci_0000_c10_00_0 + 6: pci_0000_c11_00_0 + claimed: + 1: pci_0000_c6_00_0 + 2: pci_0000_c7_00_0 + copper: + free: + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + 5: pci_0000_c5_00_0 + 6: pci_0000_c5_00_1 + 7: pci_0000_c5_00_2 + 8: pci_0000_c5_00_3 + claimed: {} + sfp: + free: + 9: pci_0000_41_00_0 + 10: pci_0000_41_00_1 + claimed: {} diff --git a/salt/hypervisor/soc_hypervisor.yaml b/salt/hypervisor/soc_hypervisor.yaml index 8865b27ab..571b1661d 100644 --- a/salt/hypervisor/soc_hypervisor.yaml +++ b/salt/hypervisor/soc_hypervisor.yaml @@ -1,35 +1,15 @@ +# This is the start of an example of what this file will look like. It will be generated by Salt, so this yaml file is not used by Salt. hypervisor: hosts: - defaultHost: - add_guest: - description: List of hypervisor nodes. - forcedType: "[]string" - global: True - multiline: True - guests: - defaultGuest: - copper: - description: Copper nics - forcedType: "[]int" - global: True - multiline: True - sfp: - description: sfp nics - forcedType: "[]int" - global: True - multiline: True - disks: - description: disk - forcedType: "[]int" - global: True - multiline: True - cpu: - description: cpu - forcedType: int - global: True - multiline: True - memory: - description: mem - forcedType: int - global: True - multiline: True + jpphype1: + add_searchnode: + description: Add a new searchnode to the hypervisor. + file: true + global: true + multiline: true + add_sensor: + description: Add a new sensor to the hypervisor. + file: true + global: true + multiline: true + guests: {} diff --git a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware index cf4c20c49..4191373c4 100644 --- a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware +++ b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware @@ -101,6 +101,14 @@ def redefine_vm(conn, new_xml_desc, logger): sys.exit(1) def main(): + # Set up logging using the so_logging_utils library + logger = setup_logging( + logger_name='so-kvm-modify-hardware', + log_file_path='/opt/so/log/hypervisor/so-kvm-modify-hardware.log', + log_level=logging.INFO, + format_str='%(asctime)s - %(levelname)s - %(message)s' + ) + try: args = parse_arguments() @@ -110,14 +118,6 @@ def main(): pci_id = args.pci start_vm_flag = args.start - # Set up logging using the so_logging_utils library - logger = setup_logging( - logger_name='so-kvm-modify-hardware', - log_file_path='/opt/so/log/hypervisor/so-kvm-modify-hardware.log', - log_level=logging.INFO, - format_str='%(asctime)s - %(levelname)s - %(message)s' - ) - # Connect to libvirt try: conn = libvirt.open(None) diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin/so-qcow2-modify-network index 6ec83d3e3..8829d3223 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -12,9 +12,9 @@ Usage: python so-qcow2-modify-network.py -I -i (--dhcp4 | --static4 --ip4 --gw4 ) [--dns4 ] [--search4 ] Examples: - python so-qcow2-modify-network.py -I path_to_image -i eth0 --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --search4 example.local + python so-qcow2-modify-network.py -I /var/lib/libvirt/images/coreol9/coreol9.qcow2 -i eth0 --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --search4 example.local - python so-qcow2-modify-network.py -I path_to_image -i eth0 --dhcp4 + python so-qcow2-modify-network.py -I /var/lib/libvirt/images/coreol9/coreol9.qcow2 -i eth0 --dhcp4 """ import argparse @@ -161,14 +161,14 @@ def parse_arguments(): return args def main(): + # Set up logging using the so_logging_utils library + logger = setup_logging( + logger_name='so-qcow2-modify-network', + log_file_path='/opt/so/log/hypervisor/so-qcow2-modify-network.log', + log_level=logging.INFO, + format_str='%(asctime)s - %(levelname)s - %(message)s' + ) try: - # Set up logging using the so_logging_utils library - logger = setup_logging( - logger_name='so-qcow2-modify-network', - log_file_path='/opt/so/log/hypervisor/so-qcow2-modify-network.log', - log_level=logging.INFO, - format_str='%(asctime)s - %(levelname)s - %(message)s' - ) args = parse_arguments() validate_interface_name(args.interface) From 9ac5ef09adcbd52273fb262b93c21e65d9d479ae Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 29 Oct 2024 11:01:04 -0400 Subject: [PATCH 044/303] update comment --- salt/_modules/qcow2.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/_modules/qcow2.py b/salt/_modules/qcow2.py index 8a4f89b59..48a90137b 100644 --- a/salt/_modules/qcow2.py +++ b/salt/_modules/qcow2.py @@ -34,7 +34,7 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, .. code-block:: bash - salt '*' qcow2.modify_network_config image='/path/to/image.qcow2' interface='eth0' mode='static4' ip4='192.168.1.10/24' gw4='192.168.1.1' dns4='8.8.8.8,8.8.4.4' search4='example.local' + salt '*' qcow2.modify_network_config image='/path/to/image.qcow2' interface='eth0' mode='static4' ip4='192.168.1.10/24' gw4='192.168.1.1' dns4='192.168.1.1,8.8.8.8' search4='example.local' ''' From 39391c8088be1646e9899cae86bdaa92b21e7df9 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 29 Oct 2024 11:27:49 -0400 Subject: [PATCH 045/303] sync pillar top --- pillar/top.sls | 2 ++ 1 file changed, 2 insertions(+) diff --git a/pillar/top.sls b/pillar/top.sls index 6dece952b..0f449a67c 100644 --- a/pillar/top.sls +++ b/pillar/top.sls @@ -69,6 +69,8 @@ base: - kafka.soc_kafka - kafka.adv_kafka - hypervisor.nodes + - hypervisor.soc_hypervisor + - hypervisor.adv_hypervisor - stig.soc_stig '*_sensor': From efbf62f56aec04f9469f10f159c79d98927d95ae Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 4 Nov 2024 08:30:40 -0500 Subject: [PATCH 046/303] adding beacon --- salt/_beacons/add_virtual_node_beacon.py | 113 ++++++++++++ salt/_modules/qcow2.py | 60 ++++++- .../tools/sbin/so-kvm-modify-hardware | 91 +++++++--- salt/manager/tools/sbin/so-salt-cloud | 162 ++++++++++++++++-- salt/salt/minion.sls | 5 + .../dynamic_annotations/hypervisor/add_node | 2 +- 6 files changed, 389 insertions(+), 44 deletions(-) create mode 100644 salt/_beacons/add_virtual_node_beacon.py diff --git a/salt/_beacons/add_virtual_node_beacon.py b/salt/_beacons/add_virtual_node_beacon.py new file mode 100644 index 000000000..6cbd3574c --- /dev/null +++ b/salt/_beacons/add_virtual_node_beacon.py @@ -0,0 +1,113 @@ +''' +Add Virtual Node Beacon + +This beacon monitors for creation or modification of files matching a specific pattern +and sends the contents of the files up to the Salt Master's event bus, including +the hypervisor and nodetype extracted from the file path. + +Configuration: + + beacons: + add_virtual_node_beacon: + - base_path: /path/to/files/* + +If base_path is not specified, it defaults to '/opt/so/saltstack/local/salt/hypervisor/hosts/*/add_*' +''' + +import os +import glob +import logging +import re + +log = logging.getLogger(__name__) + +__virtualname__ = 'add_virtual_node_beacon' +DEFAULT_BASE_PATH = '/opt/so/saltstack/local/salt/hypervisor/hosts/*/add_*' + +def __virtual__(): + ''' + Return the virtual name of the beacon. + ''' + return __virtualname__ + +def validate(config): + ''' + Validate the beacon configuration. + + Args: + config (list): Configuration of the beacon. + + Returns: + tuple: A tuple of (bool, str) indicating success and message. + ''' + if not isinstance(config, list): + return False, 'Configuration for add_virtual_node_beacon must be a list of dictionaries' + for item in config: + if not isinstance(item, dict): + return False, 'Each item in configuration must be a dictionary' + if 'base_path' in item and not isinstance(item['base_path'], str): + return False, 'base_path must be a string' + return True, 'Valid beacon configuration' + +def beacon(config): + ''' + Monitor for creation or modification of files and send events. + + Args: + config (list): Configuration of the beacon. + + Returns: + list: A list of events to send to the Salt Master. + ''' + if 'add_virtual_node_beacon' not in __context__: + __context__['add_virtual_node_beacon'] = {} + + ret = [] + + for item in config: + base_path = item.get('base_path', DEFAULT_BASE_PATH) + file_list = glob.glob(base_path) + + log.debug('Starting add_virtual_node_beacon. Found %d files matching pattern %s', len(file_list), base_path) + + for file_path in file_list: + try: + mtime = os.path.getmtime(file_path) + prev_mtime = __context__['add_virtual_node_beacon'].get(file_path, 0) + if mtime > prev_mtime: + log.info('File %s is new or modified', file_path) + with open(file_path, 'r') as f: + contents = f.read() + + data = {} + # Parse the contents of the file + for line in contents.splitlines(): + if ':' in line: + key, value = line.split(':', 1) + data[key.strip()] = value.strip() + else: + log.warning('Line in file %s does not contain colon: %s', file_path, line) + + # Extract hypervisor and nodetype from the file path + match = re.match(r'^.*/hosts/(?P[^/]+)/add_(?P[^/]+)$', file_path) + if match: + data['hypervisor'] = match.group('hypervisor') + data['nodetype'] = match.group('nodetype') + else: + log.warning('Unable to extract hypervisor and nodetype from file path: %s', file_path) + data['hypervisor'] = None + data['nodetype'] = None + + event = {'tag': f'add_virtual_node/{os.path.basename(file_path)}', 'data': data} + ret.append(event) + __context__['add_virtual_node_beacon'][file_path] = mtime + else: + log.debug('File %s has not been modified since last check', file_path) + except FileNotFoundError: + log.warning('File not found: %s', file_path) + except PermissionError: + log.error('Permission denied when accessing file: %s', file_path) + except Exception as e: + log.error('Error processing file %s: %s', file_path, str(e)) + + return ret diff --git a/salt/_modules/qcow2.py b/salt/_modules/qcow2.py index 48a90137b..0cbcd8707 100644 --- a/salt/_modules/qcow2.py +++ b/salt/_modules/qcow2.py @@ -1,10 +1,5 @@ #!py -# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at -# https://securityonion.net/license; you may not use this file except in compliance with the -# Elastic License 2.0. - import logging import subprocess import shlex @@ -71,3 +66,58 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, except Exception as e: log.error('qcow2 module: An error occurred while executing the script: {}'.format(e)) raise + +def modify_hardware_config(vm_name, cpu=None, memory=None, pci=None, start=False): + ''' + Wrapper function to call so-kvm-modify-hardware + + :param vm_name: Name of the virtual machine to modify. + :param cpu: Number of virtual CPUs to assign. + :param memory: Amount of memory to assign in MiB. + :param pci: PCI hardware ID to passthrough to the VM (e.g., '0000:00:1f.2'). + :param start: Boolean flag to start the VM after modification. + + :return: A dictionary with the result of the script execution. + + CLI Example: + + .. code-block:: bash + + salt '*' qcow2.modify_hardware_config vm_name='my_vm' cpu=4 memory=8192 pci='0000:00:1f.2' start=True + + ''' + + cmd = ['/usr/sbin/so-kvm-modify-hardware', '-v', vm_name] + + if cpu is not None: + if isinstance(cpu, int) and cpu > 0: + cmd.extend(['-c', str(cpu)]) + else: + raise ValueError('cpu must be a positive integer.') + if memory is not None: + if isinstance(memory, int) and memory > 0: + cmd.extend(['-m', str(memory)]) + else: + raise ValueError('memory must be a positive integer.') + if pci: + cmd.extend(['-p', pci]) + if start: + cmd.append('-s') + + log.info('qcow2 module: Executing command: {}'.format(' '.join(shlex.quote(arg) for arg in cmd))) + + try: + result = subprocess.run(cmd, capture_output=True, text=True, check=False) + ret = { + 'retcode': result.returncode, + 'stdout': result.stdout, + 'stderr': result.stderr + } + if result.returncode != 0: + log.error('qcow2 module: Script execution failed with return code {}: {}'.format(result.returncode, result.stderr)) + else: + log.info('qcow2 module: Script executed successfully.') + return ret + except Exception as e: + log.error('qcow2 module: An error occurred while executing the script: {}'.format(e)) + raise diff --git a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware index 4191373c4..b6e2ea281 100644 --- a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware +++ b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware @@ -8,11 +8,48 @@ """ Script to modify hardware parameters of a KVM virtual machine. -Usage: - python so-kvm-modify-hardware.py -v [-c ] [-m ] [-p ] [-s] +**Usage:** + python so-kvm-modify-hardware.py -v [-c ] [-m ] [-p ] [-p ...] [-s] + +**Options:** + -v, --vm Name of the virtual machine to modify. + -c, --cpu Number of virtual CPUs to assign. + -m, --memory Amount of memory to assign in MiB. + -p, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:00:1f.2). Can be specified multiple times. + -s, --start Start the VM after modification. + +**Examples:** + +1. **Modify VM with Multiple PCI Devices:** + + ```bash + python so-kvm-modify-hardware.py -v my_vm -c 4 -m 8192 -p 0000:00:1f.2 -p 0000:00:1f.3 -s + ``` + + This command modifies the VM named `my_vm`, setting the CPU count to 4, memory to 8192 MiB, and adds two PCI devices for passthrough (`0000:00:1f.2` and `0000:00:1f.3`). The VM is then started after modification due to the `-s` flag. + +2. **Modify VM with Single PCI Device:** + + ```bash + python so-kvm-modify-hardware.py -v my_vm -p 0000:00:1f.2 + ``` + + This command adds a single PCI device passthrough to the VM named `my_vm`. + +3. **Modify VM Without Starting It:** + + ```bash + python so-kvm-modify-hardware.py -v my_vm -c 2 -m 4096 + ``` + + This command sets the CPU count and memory for `my_vm` but does not start it afterward. + +**Notes:** + +- The `-p` or `--pci` option can be specified multiple times to pass through multiple PCI devices to the VM. +- The PCI hardware IDs should be in the format `0000:00:1f.2`. +- If the `-s` or `--start` flag is not provided, the VM will remain stopped after modification. -Example: - python so-kvm-modify-hardware.py -v my_vm -c 4 -m 8192 -p 0000:00:1f.2 -s """ import argparse @@ -28,12 +65,12 @@ def parse_arguments(): parser.add_argument('-v', '--vm', required=True, help='Name of the virtual machine to modify.') parser.add_argument('-c', '--cpu', type=int, help='Number of virtual CPUs to assign.') parser.add_argument('-m', '--memory', type=int, help='Amount of memory to assign in MiB.') - parser.add_argument('-p', '--pci', help='PCI hardware ID to passthrough to the VM (e.g., 0000:00:1f.2).') + parser.add_argument('-p', '--pci', action='append', help='PCI hardware ID(s) to passthrough to the VM (e.g., 0000:00:1f.2). Can be specified multiple times.') parser.add_argument('-s', '--start', action='store_true', help='Start the VM after modification.') args = parser.parse_args() return args -def modify_vm(dom, cpu_count, memory_amount, pci_id, logger): +def modify_vm(dom, cpu_count, memory_amount, pci_ids, logger): try: # Get the XML description of the VM xml_desc = dom.XMLDesc() @@ -61,26 +98,28 @@ def modify_vm(dom, cpu_count, memory_amount, pci_id, logger): logger.error("Could not find elements in XML.") sys.exit(1) - # Add PCI device passthrough - if pci_id is not None: + # Add PCI device passthrough(s) + if pci_ids: devices_elem = root.find('./devices') if devices_elem is not None: - hostdev_elem = ET.SubElement(devices_elem, 'hostdev', attrib={ - 'mode': 'subsystem', - 'type': 'pci', - 'managed': 'yes' - }) - source_elem = ET.SubElement(hostdev_elem, 'source') - domain_id, bus_slot_func = pci_id.split(':') - bus_slot, function = bus_slot_func.split('.') - address_attrs = { - 'domain': f'0x{domain_id}', - 'bus': f'0x{bus_slot}', - 'slot': f'0x{bus_slot}', - 'function': f'0x{function}' - } - ET.SubElement(source_elem, 'address', attrib=address_attrs) - logger.info(f"Added PCI device passthrough for {pci_id}.") + for pci_id in pci_ids: + hostdev_elem = ET.SubElement(devices_elem, 'hostdev', attrib={ + 'mode': 'subsystem', + 'type': 'pci', + 'managed': 'yes' + }) + source_elem = ET.SubElement(hostdev_elem, 'source') + domain_id, bus_slot_func = pci_id.split(':', 1) + bus_slot, function = bus_slot_func.split('.') + bus, slot = bus_slot[:2], bus_slot[2:] + address_attrs = { + 'domain': f'0x{domain_id}', + 'bus': f'0x{bus}', + 'slot': f'0x{slot}', + 'function': f'0x{function}' + } + ET.SubElement(source_elem, 'address', attrib=address_attrs) + logger.info(f"Added PCI device passthrough for {pci_id}.") else: logger.error("Could not find element in XML.") sys.exit(1) @@ -115,7 +154,7 @@ def main(): vm_name = args.vm cpu_count = args.cpu memory_amount = args.memory - pci_id = args.pci + pci_ids = args.pci # This will be a list or None start_vm_flag = args.start # Connect to libvirt @@ -129,7 +168,7 @@ def main(): dom = stop_vm(conn, vm_name, logger) # Modify VM XML - new_xml_desc = modify_vm(dom, cpu_count, memory_amount, pci_id, logger) + new_xml_desc = modify_vm(dom, cpu_count, memory_amount, pci_ids, logger) # Redefine VM redefine_vm(conn, new_xml_desc, logger) diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index 600d7bb8e..2691ea382 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -6,15 +6,119 @@ # Elastic License 2.0. """ -Script to assist with salt-cloud VM provisioning. This is only intended to work with a libvirt salt-cloud provider. +Script to assist with salt-cloud VM provisioning. This is intended to work with a libvirt salt-cloud provider. -Usage: - python so-salt-cloud -p (--dhcp4 | --static4 --ip4 --gw4 ) [--dns4 ] [--search4 ] +**Usage:** + python so-salt-cloud -p (--dhcp4 | --static4 --ip4 --gw4 ) + [-c ] [-m ] [-P ] [-P ...] [--dns4 ] [--search4 ] -Examples: - python so-salt-cloud -p core-hype1 hostname_nodetype --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,192.168.1.2 --search4 example.local +**Options:** + -p, --profile The cloud profile to build the VM from. + The name of the VM. + --dhcp4 Configure interface for DHCP (IPv4). + --static4 Configure interface for static IPv4 settings. + --ip4 IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration. + --gw4 IPv4 gateway (e.g., 192.168.1.1). Required for static IPv4 configuration. + --dns4 Comma-separated list of IPv4 DNS servers (e.g., 8.8.8.8,8.8.4.4). + --search4 DNS search domain for IPv4. + -c, --cpu Number of virtual CPUs to assign. + -m, --memory Amount of memory to assign in MiB. + -P, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:00:1f.2). Can be specified multiple times. + +**Examples:** + +1. **Static IP Configuration with Multiple PCI Devices:** + + ```bash + python so-salt-cloud -p core-hype1 vm1_sensor --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 \ + --dns4 192.168.1.1,192.168.1.2 --search4 example.local -c 4 -m 8192 -P 0000:00:1f.2 -P 0000:00:1f.3 + ``` + + This command provisions a VM named `vm1_sensor` using the `core-hype1` profile with the following settings: + + - Static IPv4 configuration: + - IP Address: `192.168.1.10/24` + - Gateway: `192.168.1.1` + - DNS Servers: `192.168.1.1`, `192.168.1.2` + - DNS Search Domain: `example.local` + - Hardware Configuration: + - CPUs: `4` + - Memory: `8192` MiB + - PCI Device Passthrough: `0000:00:1f.2`, `0000:00:1f.3` + +2. **DHCP Configuration with Default Hardware Settings:** + + ```bash + python so-salt-cloud -p core-hype1 vm2_master --dhcp4 + ``` + + This command provisions a VM named `vm2_master` using the `core-hype1` profile with DHCP for network configuration and default hardware settings. + +3. **Static IP Configuration without Hardware Specifications:** + + ```bash + python so-salt-cloud -p core-hype1 vm3_search --static4 --ip4 192.168.1.20/24 --gw4 192.168.1.1 + ``` + + This command provisions a VM named `vm3_search` with a static IP configuration and default hardware settings. + +4. **DHCP Configuration with Custom Hardware Specifications and Multiple PCI Devices:** + + ```bash + python so-salt-cloud -p core-hype1 vm4_node --dhcp4 -c 8 -m 16384 -P 0000:00:1f.4 -P 0000:00:1f.5 + ``` + + This command provisions a VM named `vm4_node` using DHCP for network configuration and custom hardware settings: + + - CPUs: `8` + - Memory: `16384` MiB + - PCI Device Passthrough: `0000:00:1f.4`, `0000:00:1f.5` + +**Notes:** + +- When using `--static4`, both `--ip4` and `--gw4` options are required. +- The script assumes the cloud profile name follows the format `basedomain-hypervisorname`. +- Hardware parameters (`-c`, `-m`, `-P`) are optional. If not provided, default values from the profile will be used. +- The `-P` or `--pci` option can be specified multiple times to pass through multiple PCI devices to the VM. +- The `vm_name` should include the role of the VM after an underscore (e.g., `hostname_role`), as the script uses this to determine the VM's role for firewall configuration. + +**Description:** + +The `so-salt-cloud` script automates the provisioning of virtual machines using SaltStack's `salt-cloud` utility. It performs the following steps: + +1. **Network Configuration:** + + - Modifies the network settings of the base QCOW2 image before provisioning. + - Supports both DHCP and static IPv4 configurations. + - Uses the `qcow2.modify_network_config` module via SaltStack to apply these settings on the target hypervisor. + +2. **VM Provisioning:** + + - Calls `salt-cloud` to provision the VM using the specified profile and VM name. + - The VM is provisioned but not started immediately to allow for hardware configuration. + +3. **Hardware Configuration:** + + - Modifies the hardware settings of the newly defined VM. + - Supports specifying multiple PCI devices for passthrough. + - Uses the `qcow2.modify_hardware_config` module via SaltStack to adjust CPU count, memory allocation, and PCI device passthrough. + - Starts the VM after hardware modifications. + +4. **Firewall Configuration:** + + - Monitors the output of `salt-cloud` to extract the VM's IP address. + - Calls the `so-firewall-minion` script to apply firewall rules based on the VM's role. + +**Exit Codes:** + +- `0`: Success +- Non-zero: An error occurred during execution. + +**Logging:** + +- Logs are written to `/opt/so/log/salt/so-salt-cloud.log`. +- Both file and console logging are enabled for real-time monitoring. - python so-salt-cloud -p core-hype1 hostname_nodetype --dhcp4 """ import argparse @@ -23,11 +127,12 @@ import re import sys import threading import salt.client - -local = salt.client.LocalClient() - import logging +# Initialize Salt local client +local = salt.client.LocalClient() + +# Set up logging logger = logging.getLogger(__name__) logger.setLevel(logging.INFO) @@ -77,7 +182,7 @@ def call_salt_cloud(profile, vm_name): ip_search_string = '[INFO ] Address =' ip_search_pattern = re.compile(re.escape(ip_search_string)) - # continuously read the output from salt-cloud + # Continuously read the output from salt-cloud while True: # Read stdout line by line line = process.stdout.readline() @@ -95,7 +200,7 @@ def call_salt_cloud(profile, vm_name): else: logger.error("No IP address found.") else: - # check if salt-cloud has terminated + # Check if salt-cloud has terminated if process.poll() is not None: break @@ -105,7 +210,29 @@ def call_salt_cloud(profile, vm_name): except Exception as e: logger.error(f"An error occurred while calling salt-cloud: {e}") -# This function requires the cloud profile to be in the form: basedomain_hypervisorhostname. The profile name will be used to target the hypervisor. +def run_qcow2_modify_hardware_config(profile, vm_name, cpu=None, memory=None, pci_list=None, start=False): + hv_name = profile.split('-')[1] + target = hv_name + "_*" + + try: + args_list = [ + 'vm_name=' + vm_name, + 'cpu=' + str(cpu) if cpu else '', + 'memory=' + str(memory) if memory else '', + 'start=' + str(start) + ] + + # Add PCI devices if provided + if pci_list: + # Join the list of PCI IDs into a comma-separated string + pci_devices = ','.join(pci_list) + args_list.append('pci=' + pci_devices) + + r = local.cmd(target, 'qcow2.modify_hardware_config', args_list) + logger.info(f'qcow2.modify_hardware_config: {r}') + except Exception as e: + logger.error(f"An error occurred while running qcow2.modify_hardware_config: {e}") + def run_qcow2_modify_network_config(profile, mode, ip=None, gateway=None, dns=None, search_domain=None): hv_name = profile.split('-')[1] target = hv_name + "_*" @@ -130,13 +257,18 @@ def parse_arguments(): parser = argparse.ArgumentParser(description="Call salt-cloud and pass the profile and VM name to it.") parser.add_argument('-p', '--profile', type=str, required=True, help="The cloud profile to build the VM from.") parser.add_argument('vm_name', type=str, help="The name of the VM.") + group = parser.add_mutually_exclusive_group(required=True) group.add_argument("--dhcp4", action="store_true", help="Configure interface for DHCP (IPv4).") group.add_argument("--static4", action="store_true", help="Configure interface for static IPv4 settings.") + parser.add_argument("--ip4", help="IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration.") parser.add_argument("--gw4", help="IPv4 gateway (e.g., 192.168.1.1). Required for static IPv4 configuration.") parser.add_argument("--dns4", help="Comma-separated list of IPv4 DNS servers (e.g., 8.8.8.8,8.8.4.4).") parser.add_argument("--search4", help="DNS search domain for IPv4.") + parser.add_argument('-c', '--cpu', type=int, help='Number of virtual CPUs to assign.') + parser.add_argument('-m', '--memory', type=int, help='Amount of memory to assign in MiB.') + parser.add_argument('-P', '--pci', action='append', help='PCI hardware ID(s) to passthrough to the VM (e.g., 0000:00:1f.2). Can be specified multiple times.') args = parser.parse_args() @@ -156,9 +288,15 @@ def main(): else: mode = "dhcp4" # Default to DHCP if not specified + # Step 1: Modify network configuration run_qcow2_modify_network_config(args.profile, mode, args.ip4, args.gw4, args.dns4, args.search4) + + # Step 2: Provision the VM (without starting it) call_salt_cloud(args.profile, args.vm_name) + # Step 3: Modify hardware configuration + run_qcow2_modify_hardware_config(args.profile, args.vm_name, cpu=args.cpu, memory=args.memory, pci_list=args.pci, start=True) + except KeyboardInterrupt: logger.error("so-salt-cloud: Operation cancelled by user.") sys.exit(1) diff --git a/salt/salt/minion.sls b/salt/salt/minion.sls index a5953e8e1..0d995e96c 100644 --- a/salt/salt/minion.sls +++ b/salt/salt/minion.sls @@ -70,6 +70,11 @@ enable_startup_states: - regex: '^startup_states: highstate$' - unless: pgrep so-setup +# manager with hypervisors with need this beacon added to the minion config +#beacons: +# add_virtual_node_beacon: +# - base_path: /opt/so/saltstack/local/salt/hypervisor/hosts/*/add_* + # prior to 2.4.30 this managed file would restart the salt-minion service when updated # since this file is currently only adding a sleep timer on service start # it is not required to restart the service diff --git a/salt/soc/dynamic_annotations/hypervisor/add_node b/salt/soc/dynamic_annotations/hypervisor/add_node index 498db1460..ecbde7b41 100644 --- a/salt/soc/dynamic_annotations/hypervisor/add_node +++ b/salt/soc/dynamic_annotations/hypervisor/add_node @@ -3,7 +3,7 @@ network_mode: ip4: gw4: dns4: -sarch4: +search4: cpu: memory: disk: From a0a18973d8d0dfd214dc4fa16fb93e8f1c677db3 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 9 Dec 2024 15:29:51 -0500 Subject: [PATCH 047/303] add new salt bootstrap --- salt/salt/scripts/bootstrap-salt.sh | 4188 ++++++++------------------- 1 file changed, 1223 insertions(+), 2965 deletions(-) diff --git a/salt/salt/scripts/bootstrap-salt.sh b/salt/salt/scripts/bootstrap-salt.sh index a016524e6..4e65008dc 100644 --- a/salt/salt/scripts/bootstrap-salt.sh +++ b/salt/salt/scripts/bootstrap-salt.sh @@ -1,9 +1,12 @@ -#!/bin/sh - +#!/bin/sh # WARNING: Changes to this file in the salt repo will be overwritten! # Please submit pull requests against the salt-bootstrap repo: # https://github.com/saltstack/salt-bootstrap - +# shellcheck disable=SC2317 +# shellcheck disable=SC2086 +# shellcheck disable=SC2329 +# #====================================================================================================================== # vim: softtabstop=4 shiftwidth=4 expandtab fenc=utf-8 spell spelllang=en cc=120 #====================================================================================================================== @@ -14,7 +17,7 @@ # # BUGS: https://github.com/saltstack/salt-bootstrap/issues # -# COPYRIGHT: (c) 2012-2022 by the SaltStack Team, see AUTHORS.rst for more +# COPYRIGHT: (c) 2012-2024 by the SaltStack Team, see AUTHORS.rst for more # details. # # LICENSE: Apache 2.0 @@ -23,7 +26,7 @@ #====================================================================================================================== set -o nounset # Treat unset variables as an error -__ScriptVersion="2023.08.03" +__ScriptVersion="2024.11.07" __ScriptName="bootstrap-salt.sh" __ScriptFullName="$0" @@ -121,16 +124,35 @@ __check_command_exists() { command -v "$1" > /dev/null 2>&1 } +#--- FUNCTION ------------------------------------------------------------------------------------------------------- +# NAME: __check_services_systemd_functional +# DESCRIPTION: Set _SYSTEMD_FUNCTIONAL = BS_TRUE or BS_FALSE case where systemd is functional (for example: container may not have systemd) +#---------------------------------------------------------------------------------------------------------------------- +__check_services_systemd_functional() { + + # check if systemd is functional, having systemctl present is insufficient + + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_FALSE ]; then + # already determined systemd is not functional, default is 1 + return + fi + + if __check_command_exists systemctl; then + # shellcheck disable=SC2034 + _SYSTEMD_HELP="$(systemctl --help)" + else + _SYSTEMD_FUNCTIONAL=$BS_FALSE + echoerror "systemctl: command not found, assume systemd not implemented, _SYSTEMD_FUNCTIONAL $_SYSTEMD_FUNCTIONAL" + fi +} # ---------- end of function __check_services_systemd_functional ---------- + #--- FUNCTION ------------------------------------------------------------------------------------------------------- # NAME: __check_pip_allowed # DESCRIPTION: Simple function to let the users know that -P needs to be used. #---------------------------------------------------------------------------------------------------------------------- __check_pip_allowed() { - if [ $# -eq 1 ]; then - _PIP_ALLOWED_ERROR_MSG=$1 - else - _PIP_ALLOWED_ERROR_MSG="pip based installations were not allowed. Retry using '-P'" - fi + + _PIP_ALLOWED_ERROR_MSG="pip based installations were not allowed. Retry using '-P'" if [ "$_PIP_ALLOWED" -eq $BS_FALSE ]; then echoerror "$_PIP_ALLOWED_ERROR_MSG" @@ -228,6 +250,7 @@ _TEMP_KEYS_DIR="null" _SLEEP="${__DEFAULT_SLEEP}" _INSTALL_MASTER=$BS_FALSE _INSTALL_SYNDIC=$BS_FALSE +_INSTALL_SALT_API=$BS_FALSE _INSTALL_MINION=$BS_TRUE _INSTALL_CLOUD=$BS_FALSE _VIRTUALENV_DIR=${BS_VIRTUALENV_DIR:-"null"} @@ -266,19 +289,16 @@ _CUSTOM_REPO_URL="null" _CUSTOM_MASTER_CONFIG="null" _CUSTOM_MINION_CONFIG="null" _QUIET_GIT_INSTALLATION=$BS_FALSE -_REPO_URL="repo.saltproject.io" -_ONEDIR_DIR="salt" -_ONEDIR_NIGHTLY_DIR="salt-dev/${_ONEDIR_DIR}" +_REPO_URL="packages.broadcom.com/artifactory" _PY_EXE="python3" -_INSTALL_PY="$BS_FALSE" -_TORNADO_MAX_PY3_VERSION="5.0" -_POST_NEON_INSTALL=$BS_FALSE _MINIMUM_PIP_VERSION="9.0.1" -_MINIMUM_SETUPTOOLS_VERSION="9.1" -_POST_NEON_PIP_INSTALL_ARGS="--prefix=/usr" +_MINIMUM_SETUPTOOLS_VERSION="65.6.3" +_MAXIMUM_SETUPTOOLS_VERSION="69.0" +_PIP_INSTALL_ARGS="--prefix=/usr" _PIP_DOWNLOAD_ARGS="" _QUICK_START="$BS_FALSE" _AUTO_ACCEPT_MINION_KEYS="$BS_FALSE" +_SYSTEMD_FUNCTIONAL=$BS_TRUE # Defaults for install arguments ITYPE="stable" @@ -297,9 +317,9 @@ __usage() { - stable Install latest stable release. This is the default install type - stable [branch] Install latest version on a branch. Only supported - for packages available at repo.saltproject.io + for packages available at packages.broadcom.com - stable [version] Install a specific version. Only supported for - packages available at repo.saltproject.io + packages available at packages.broadcom.com To pin a 3xxx minor version, specify it as 3xxx.0 - testing RHEL-family specific: configure EPEL testing repo - git Install from the head of the master branch @@ -307,17 +327,11 @@ __usage() { commit) - onedir Install latest onedir release. - onedir [version] Install a specific version. Only supported for - onedir packages available at repo.saltproject.io + onedir packages available at packages.broadcom.com - onedir_rc Install latest onedir RC release. - onedir_rc [version] Install a specific version. Only supported for - onedir RC packages available at repo.saltproject.io - - old-stable Install latest old stable release. - - old-stable [branch] Install latest version on a branch. Only supported - for packages available at repo.saltproject.io - - old-stable [version] Install a specific version. Only supported for - packages available at repo.saltproject.io - To pin a 3xxx minor version, specify it as 3xxx.0 + onedir RC packages available at packages.broadcom.com Examples: - ${__ScriptName} @@ -326,16 +340,15 @@ __usage() { - ${__ScriptName} stable 3006.1 - ${__ScriptName} testing - ${__ScriptName} git - - ${__ScriptName} git 2017.7 - - ${__ScriptName} git v2017.7.2 + - ${__ScriptName} git 3006.7 + - ${__ScriptName} git v3006.8 + - ${__ScriptName} git 3007.1 + - ${__ScriptName} git v3007.1 - ${__ScriptName} git 06f249901a2e2f1ed310d58ea3921a129f214358 - ${__ScriptName} onedir - ${__ScriptName} onedir 3006 - ${__ScriptName} onedir_rc - - ${__ScriptName} onedir_rc 3006 - - ${__ScriptName} old-stable - - ${__ScriptName} old-stable 3005 - - ${__ScriptName} old-stable 3005.1 + - ${__ScriptName} onedir_rc 3008 Options: @@ -349,7 +362,7 @@ __usage() { step. -c Temporary configuration directory -C Only run the configuration function. Implies -F (forced overwrite). - To overwrite Master or Syndic configs, -M or -S, respectively, must + To overwrite Master, Syndic or Api configs, -M,-S or -W, respectively, must also be specified. Salt installation will be ommitted, but some of the dependencies could be installed to write configuration with -j or -J. -d Disables checking if Salt services are enabled to start on system boot. @@ -401,8 +414,8 @@ __usage() { And automatically accept the minion key. -R Specify a custom repository URL. Assumes the custom repository URL points to a repository that mirrors Salt packages located at - repo.saltproject.io. The option passed with -R replaces the - "repo.saltproject.io". If -R is passed, -r is also set. Currently only + packages.broadcom.com. The option passed with -R replaces the + "packages.broadcom.com". If -R is passed, -r is also set. Currently only works on CentOS/RHEL and Debian based distributions and macOS. -s Sleep time used when waiting for daemons to start, restart and when checking for the services running. Default: ${__DEFAULT_SLEEP} @@ -414,23 +427,15 @@ __usage() { -v Display script version -V Install Salt into virtualenv (only available for Ubuntu based distributions) - -x Changes the Python version used to install Salt. - For CentOS 6 git installations python2.7 is supported. - Fedora git installation, CentOS 7, Ubuntu 18.04 support python3. + -W Also install salt-api + -x Changes the Python version used to install Salt (default: Python 3). + Python 2.7 is no longer supported. -X Do not start daemons after installation - -y Installs a different python version on host. Currently this has only been - tested with CentOS 6 and is considered experimental. This will install the - ius repo on the box if disable repo is false. This must be used in conjunction - with -x . For example: - sh bootstrap.sh -P -y -x python2.7 git v2017.7.2 - The above will install python27 and install the git version of salt using the - python2.7 executable. This only works for git and pip installations. EOT } # ---------- end of function __usage ---------- - -while getopts ':hvnDc:g:Gyx:k:s:MSNXCPFUKIA:i:Lp:dH:bflV:J:j:rR:aqQ' opt +while getopts ':hvnDc:g:Gx:k:s:MSWNXCPFUKIA:i:Lp:dH:bflV:J:j:rR:aqQ' opt do case "${opt}" in @@ -450,6 +455,7 @@ do s ) _SLEEP=$OPTARG ;; M ) _INSTALL_MASTER=$BS_TRUE ;; S ) _INSTALL_SYNDIC=$BS_TRUE ;; + W ) _INSTALL_SALT_API=$BS_TRUE ;; N ) _INSTALL_MINION=$BS_FALSE ;; X ) _START_DAEMONS=$BS_FALSE ;; C ) _CONFIG_ONLY=$BS_TRUE ;; @@ -476,7 +482,6 @@ do q ) _QUIET_GIT_INSTALLATION=$BS_TRUE ;; Q ) _QUICK_START=$BS_TRUE ;; x ) _PY_EXE="$OPTARG" ;; - y ) _INSTALL_PY="$BS_TRUE" ;; \?) echo echoerror "Option does not exist : $OPTARG" @@ -488,7 +493,6 @@ do done shift $((OPTIND-1)) - # Define our logging file and pipe paths LOGFILE="/tmp/$( echo "$__ScriptName" | sed s/.sh/.log/g )" LOGPIPE="/tmp/$( echo "$__ScriptName" | sed s/.sh/.logpipe/g )" @@ -596,7 +600,15 @@ fi echoinfo "Running version: ${__ScriptVersion}" echoinfo "Executed by: ${CALLER}" echoinfo "Command line: '${__ScriptFullName} ${__ScriptArgs}'" -echowarn "Running the unstable version of ${__ScriptName}" + +# Defaults +STABLE_REV="latest" +ONEDIR_REV="latest" +_ONEDIR_REV="latest" +YUM_REPO_FILE="/etc/yum.repos.d/salt.repo" + +# check if systemd is functional +__check_services_systemd_functional # Define installation type if [ "$#" -gt 0 ];then @@ -606,17 +618,11 @@ if [ "$#" -gt 0 ];then fi # Check installation type -if [ "$(echo "$ITYPE" | grep -E '(stable|testing|git|onedir|onedir_rc|old-stable)')" = "" ]; then +if [ "$(echo "$ITYPE" | grep -E '(stable|testing|git|onedir|onedir_rc)')" = "" ]; then echoerror "Installation type \"$ITYPE\" is not known..." exit 1 fi -# Due to our modifications to install_centos_onedir it is easiest to just lock down to only allowing stable install -if [ "$(echo "$ITYPE" | grep stable)" = "" ]; then - echoerror "This script has been modified to only support stable installation type. Installation type \"$ITYPE\" is not allowed..." - exit 1 -fi - # If doing a git install, check what branch/tag/sha will be checked out if [ "$ITYPE" = "git" ]; then if [ "$#" -eq 0 ];then @@ -632,45 +638,25 @@ if [ "$ITYPE" = "git" ]; then # If doing stable install, check if version specified elif [ "$ITYPE" = "stable" ]; then if [ "$#" -eq 0 ];then + STABLE_REV="latest" ONEDIR_REV="latest" _ONEDIR_REV="latest" ITYPE="onedir" else - if [ "$(echo "$1" | grep -E '^(nightly|latest|3005|3006)$')" != "" ]; then + if [ "$(echo "$1" | grep -E '^(latest|3006|3007)$')" != "" ]; then + STABLE_REV="$1" ONEDIR_REV="$1" _ONEDIR_REV="$1" ITYPE="onedir" shift elif [ "$(echo "$1" | grep -E '^([3-9][0-5]{2}[5-9](\.[0-9]*)?)')" != "" ]; then - ONEDIR_REV="minor/$1" + STABLE_REV="$1" + ONEDIR_REV="$1" _ONEDIR_REV="$1" ITYPE="onedir" shift else - echo "Unknown stable version: $1 (valid: 3005, 3006, latest)" - exit 1 - fi - fi - -# If doing old-stable install, check if version specified -elif [ "$ITYPE" = "old-stable" ]; then - if [ "$#" -eq 0 ];then - ITYPE="stable" - else - if [ "$(echo "$1" | grep -E '^(3003|3004|3005)$')" != "" ]; then - STABLE_REV="$1" - ITYPE="stable" - shift - elif [ "$(echo "$1" | grep -E '^([3-9][0-5]{3}(\.[0-9]*)?)$')" != "" ]; then - # Handle the 3xxx.0 version as 3xxx archive (pin to minor) and strip the fake ".0" suffix - ITYPE="stable" - STABLE_REV=$(echo "$1" | sed -E 's/^([3-9][0-9]{3})\.0$/\1/') - if [ "$(uname)" != "Darwin" ]; then - STABLE_REV="archive/$STABLE_REV" - fi - shift - else - echo "Unknown old stable version: $1 (valid: 3003, 3004, 3005)" + echo "Unknown stable version: $1 (valid: 3006, 3007, latest), versions older than 3006 are not available" exit 1 fi fi @@ -678,52 +664,54 @@ elif [ "$ITYPE" = "old-stable" ]; then elif [ "$ITYPE" = "onedir" ]; then if [ "$#" -eq 0 ];then ONEDIR_REV="latest" + STABLE_REV="latest" else - if [ "$(echo "$1" | grep -E '^(nightly|latest|3005|3006)$')" != "" ]; then + if [ "$(echo "$1" | grep -E '^(latest|3006|3007)$')" != "" ]; then ONEDIR_REV="$1" - shift - elif [ "$(echo "$1" | grep -E '^(3005(\.[0-9]*)?)')" != "" ]; then - # Handle the 3005.0 version as 3005 archive (pin to minor) and strip the fake ".0" suffix - ONEDIR_REV=$(echo "$1" | sed -E 's/^(3005)\.0$/\1/') - ONEDIR_REV="minor/$ONEDIR_REV" + STABLE_REV="$1" shift elif [ "$(echo "$1" | grep -E '^([3-9][0-9]{3}(\.[0-9]*)?)')" != "" ]; then - ONEDIR_REV="minor/$1" + ONEDIR_REV="$1" + STABLE_REV="$1" shift else - echo "Unknown onedir version: $1 (valid: 3005, 3006, latest, nightly.)" + echo "Unknown onedir version: $1 (valid: 3006, 3007, latest), versions older than 3006 are not available" exit 1 fi fi elif [ "$ITYPE" = "onedir_rc" ]; then - # Change the _ONEDIR_DIR to be the location for the RC packages - _ONEDIR_DIR="salt_rc/salt" + echoerror "RC Releases are not supported at this time" - # Change ITYPE to onedir so we use the regular onedir functions - ITYPE="onedir" - - if [ "$#" -eq 0 ];then - ONEDIR_REV="latest" - else - if [ "$(echo "$1" | grep -E '^(latest)$')" != "" ]; then - ONEDIR_REV="$1" - shift - elif [ "$(echo "$1" | grep -E '^([3-9][0-9]{3}?rc[0-9]-[0-9]$)')" != "" ]; then - # Handle the 3xxx.0 version as 3xxx archive (pin to minor) and strip the fake ".0" suffix - #ONEDIR_REV=$(echo "$1" | sed -E 's/^([3-9][0-9]{3})\.0$/\1/') - ONEDIR_REV="minor/$1" - shift - elif [ "$(echo "$1" | grep -E '^([3-9][0-9]{3}\.[0-9]?rc[0-9]$)')" != "" ]; then - # Handle the 3xxx.0 version as 3xxx archive (pin to minor) and strip the fake ".0" suffix - #ONEDIR_REV=$(echo "$1" | sed -E 's/^([3-9][0-9]{3})\.0$/\1/') - ONEDIR_REV="minor/$1" - shift - else - echo "Unknown onedir_rc version: $1 (valid: 3005-1, latest.)" - exit 1 - fi - fi +## # Change the _ONEDIR_DIR to be the location for the RC packages +## _ONEDIR_DIR="salt_rc/salt" +## +## # Change ITYPE to onedir so we use the regular onedir functions +## ITYPE="onedir" +## +## if [ "$#" -eq 0 ];then +## ONEDIR_REV="latest" +## else +## if [ "$(echo "$1" | grep -E '^(latest)$')" != "" ]; then +## ONEDIR_REV="$1" +## shift +## elif [ "$(echo "$1" | grep -E '^([3-9][0-9]{3}?rc[0-9]-[0-9]$)')" != "" ]; then +## # Handle the 3xxx.0 version as 3xxx archive (pin to minor) and strip the fake ".0" suffix +## #ONEDIR_REV=$(echo "$1" | sed -E 's/^([3-9][0-9]{3})\.0$/\1/') +## ## ONEDIR_REV="minor/$1" don't have minor directory anymore +## ONEDIR_REV="$1" +## shift +## elif [ "$(echo "$1" | grep -E '^([3-9][0-9]{3}\.[0-9]?rc[0-9]$)')" != "" ]; then +## # Handle the 3xxx.0 version as 3xxx archive (pin to minor) and strip the fake ".0" suffix +## #ONEDIR_REV=$(echo "$1" | sed -E 's/^([3-9][0-9]{3})\.0$/\1/') +## ## ONEDIR_REV="minor/$1" don't have minor directory anymore +## ONEDIR_REV="$1" +## shift +## else +## echo "Unknown onedir_rc version: $1 (valid: 3006-8, 3007-1, latest)" +## exit 1 +## fi +## fi fi # Doing a quick start, so install master @@ -773,7 +761,7 @@ if [ "$($whoami)" != "root" ]; then fi # Check that we're actually installing one of minion/master/syndic -if [ "$_INSTALL_MINION" -eq $BS_FALSE ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && [ "$_CONFIG_ONLY" -eq $BS_FALSE ]; then +if [ "$_INSTALL_MINION" -eq $BS_FALSE ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && [ "$_INSTALL_SALT_API" -eq $BS_FALSE ] && [ "$_CONFIG_ONLY" -eq $BS_FALSE ]; then echowarn "Nothing to install or configure" exit 1 fi @@ -806,6 +794,12 @@ if [ "$_CUSTOM_MINION_CONFIG" != "null" ]; then fi fi + +# Default to Python 3, no longer support for Python 2 +PY_PKG_VER=3 +_PY_PKG_VER="python3" +_PY_MAJOR_VERSION="3" + # Check if we're installing via a different Python executable and set major version variables if [ -n "$_PY_EXE" ]; then if [ "$(uname)" = "Darwin" ]; then @@ -814,19 +808,21 @@ if [ -n "$_PY_EXE" ]; then _PY_PKG_VER=$(echo "$_PY_EXE" | sed -E "s/\\.//g") fi - _PY_MAJOR_VERSION=$(echo "$_PY_PKG_VER" | cut -c 7) - if [ "$_PY_MAJOR_VERSION" != 3 ] && [ "$_PY_MAJOR_VERSION" != 2 ]; then - echoerror "Detected -x option, but Python major version is not 2 or 3." - echoerror "The -x option must be passed as python2, python27, or python2.7 (or use the Python '3' versions of examples)." + TEST_PY_MAJOR_VERSION=$(echo "$_PY_PKG_VER" | cut -c 7) + if [ "$TEST_PY_MAJOR_VERSION" -eq 2 ]; then + echoerror "Python 2 is no longer supported, only Python 3" + return 1 + fi + + if [ "$TEST_PY_MAJOR_VERSION" != 3 ]; then + echoerror "Detected -x option, but Python major version is not 3." + echoerror "The -x option must be passed as python3, python38, or python3.8 (use the Python '3' versions of examples)." exit 1 fi if [ "$_PY_EXE" != "python3" ]; then echoinfo "Detected -x option. Using $_PY_EXE to install Salt." fi -else - _PY_PKG_VER="" - _PY_MAJOR_VERSION="" fi # If the configuration directory or archive does not exist, error out @@ -843,7 +839,7 @@ fi # -a and -V only work from git if [ "$ITYPE" != "git" ]; then - if [ $_PIP_ALL -eq $BS_TRUE ]; then + if [ "$_PIP_ALL" -eq $BS_TRUE ]; then echoerror "Pip installing all python packages with -a is only possible when installing Salt via git" exit 1 fi @@ -853,7 +849,7 @@ if [ "$ITYPE" != "git" ]; then fi fi -# Set the _REPO_URL value based on if -R was passed or not. Defaults to repo.saltproject.io. +# Set the _REPO_URL value based on if -R was passed or not. Defaults to packages.broadcom.com if [ "$_CUSTOM_REPO_URL" != "null" ]; then _REPO_URL="$_CUSTOM_REPO_URL" @@ -938,6 +934,7 @@ __fetch_url() { # DESCRIPTION: Retrieves a URL, verifies its content and writes it to standard output #---------------------------------------------------------------------------------------------------------------------- __fetch_verify() { + fetch_verify_url="$1" fetch_verify_sum="$2" fetch_verify_size="$3" @@ -959,6 +956,7 @@ __fetch_verify() { # DESCRIPTION: Checks if a URL exists #---------------------------------------------------------------------------------------------------------------------- __check_url_exists() { + _URL="$1" if curl --output /dev/null --silent --fail "${_URL}"; then return 0 @@ -1035,17 +1033,12 @@ __derive_debian_numeric_version() { INPUT_VERSION="$(cat /etc/debian_version)" fi if [ -z "$NUMERIC_VERSION" ]; then - if [ "$INPUT_VERSION" = "wheezy/sid" ]; then - # I've found an EC2 wheezy image which did not tell its version - NUMERIC_VERSION=$(__parse_version_string "7.0") - elif [ "$INPUT_VERSION" = "jessie/sid" ]; then - NUMERIC_VERSION=$(__parse_version_string "8.0") - elif [ "$INPUT_VERSION" = "stretch/sid" ]; then - NUMERIC_VERSION=$(__parse_version_string "9.0") - elif [ "$INPUT_VERSION" = "buster/sid" ]; then - NUMERIC_VERSION=$(__parse_version_string "10.0") - elif [ "$INPUT_VERSION" = "bullseye/sid" ]; then + if [ "$INPUT_VERSION" = "bullseye/sid" ]; then NUMERIC_VERSION=$(__parse_version_string "11.0") + elif [ "$INPUT_VERSION" = "bookworm/sid" ]; then + NUMERIC_VERSION=$(__parse_version_string "12.0") + elif [ "$INPUT_VERSION" = "trixie/sid" ]; then + NUMERIC_VERSION=$(__parse_version_string "13.0") else echowarn "Unable to parse the Debian Version (codename: '$INPUT_VERSION')" fi @@ -1129,6 +1122,7 @@ __gather_linux_system_info() { DISTRO_VERSION="" # Let's test if the lsb_release binary is available + # shellcheck disable=SC2327,SC2328 rv=$(lsb_release >/dev/null 2>&1) # shellcheck disable=SC2181 @@ -1186,7 +1180,7 @@ __gather_linux_system_info() { # We already have the distribution name and version return fi - # shellcheck disable=SC2035,SC2086 + # shellcheck disable=SC2035,SC2086,SC2269 for rsource in $(__sort_release_files "$( cd /etc && /bin/ls *[_-]release *[_-]version 2>/dev/null | env -i sort | \ sed -e '/^redhat-release$/d' -e '/^lsb-release$/d'; \ @@ -1288,127 +1282,6 @@ __gather_linux_system_info() { } -#--- FUNCTION ------------------------------------------------------------------------------------------------------- -# NAME: __install_python() -# DESCRIPTION: Install a different version of python on a host. Currently this has only been tested on CentOS 6 and -# is considered experimental. -#---------------------------------------------------------------------------------------------------------------------- -__install_python() { - if [ "$_PY_EXE" = "" ]; then - echoerror "Must specify -x with -y to install a specific python version" - exit 1 - fi - - __PACKAGES="$_PY_PKG_VER" - - if [ ${_DISABLE_REPOS} -eq ${BS_FALSE} ]; then - echoinfo "Attempting to install a repo to help provide a separate python package" - echoinfo "$DISTRO_NAME_L" - case "$DISTRO_NAME_L" in - "red_hat"|"centos") - __PYTHON_REPO_URL="https://repo.ius.io/ius-release-el${DISTRO_MAJOR_VERSION}.rpm" - ;; - *) - echoerror "Installing a repo to provide a python package is only supported on Redhat/CentOS. - If a repo is already available, please try running script with -r." - exit 1 - ;; - esac - - echoinfo "Installing IUS repo" - __yum_install_noinput "${__PYTHON_REPO_URL}" || return 1 - fi - - echoinfo "Installing ${__PACKAGES}" - __yum_install_noinput "${__PACKAGES}" || return 1 -} - - -#--- FUNCTION ------------------------------------------------------------------------------------------------------- -# NAME: __gather_sunos_system_info -# DESCRIPTION: Discover SunOS system info -#---------------------------------------------------------------------------------------------------------------------- -__gather_sunos_system_info() { - if [ -f /sbin/uname ]; then - DISTRO_VERSION=$(/sbin/uname -X | awk '/[kK][eE][rR][nN][eE][lL][iI][dD]/ { print $3 }') - fi - - DISTRO_NAME="" - if [ -f /etc/release ]; then - while read -r line; do - [ "${DISTRO_NAME}" != "" ] && break - case "$line" in - *OpenIndiana*oi_[0-9]*) - DISTRO_NAME="OpenIndiana" - DISTRO_VERSION=$(echo "$line" | sed -nE "s/OpenIndiana(.*)oi_([[:digit:]]+)(.*)/\\2/p") - break - ;; - *OpenSolaris*snv_[0-9]*) - DISTRO_NAME="OpenSolaris" - DISTRO_VERSION=$(echo "$line" | sed -nE "s/OpenSolaris(.*)snv_([[:digit:]]+)(.*)/\\2/p") - break - ;; - *Oracle*Solaris*[0-9]*) - DISTRO_NAME="Oracle Solaris" - DISTRO_VERSION=$(echo "$line" | sed -nE "s/(Oracle Solaris) ([[:digit:]]+)(.*)/\\2/p") - break - ;; - *Solaris*) - DISTRO_NAME="Solaris" - # Let's make sure we not actually on a Joyent's SmartOS VM since some releases - # don't have SmartOS in `/etc/release`, only `Solaris` - if uname -v | grep joyent >/dev/null 2>&1; then - DISTRO_NAME="SmartOS" - fi - break - ;; - *NexentaCore*) - DISTRO_NAME="Nexenta Core" - break - ;; - *SmartOS*) - DISTRO_NAME="SmartOS" - break - ;; - *OmniOS*) - DISTRO_NAME="OmniOS" - DISTRO_VERSION=$(echo "$line" | awk '{print $3}') - _SIMPLIFY_VERSION=$BS_FALSE - break - ;; - esac - done < /etc/release - fi - - if [ "${DISTRO_NAME}" = "" ]; then - DISTRO_NAME="Solaris" - DISTRO_VERSION=$( - echo "${OS_VERSION}" | - sed -e 's;^4\.;1.;' \ - -e 's;^5\.\([0-6]\)[^0-9]*$;2.\1;' \ - -e 's;^5\.\([0-9][0-9]*\).*;\1;' - ) - fi - - if [ "${DISTRO_NAME}" = "SmartOS" ]; then - VIRTUAL_TYPE="smartmachine" - if [ "$(zonename)" = "global" ]; then - VIRTUAL_TYPE="global" - fi - fi -} - - -#--- FUNCTION ------------------------------------------------------------------------------------------------------- -# NAME: __gather_bsd_system_info -# DESCRIPTION: Discover OpenBSD, NetBSD and FreeBSD systems information -#---------------------------------------------------------------------------------------------------------------------- -__gather_bsd_system_info() { - DISTRO_NAME=${OS_NAME} - DISTRO_VERSION=$(echo "${OS_VERSION}" | sed -e 's;[()];;' -e 's/-.*$//') -} - - #--- FUNCTION ------------------------------------------------------------------------------------------------------- # NAME: __gather_osx_system_info # DESCRIPTION: Discover MacOS X @@ -1428,12 +1301,6 @@ __gather_system_info() { linux ) __gather_linux_system_info ;; - sunos ) - __gather_sunos_system_info - ;; - openbsd|freebsd|netbsd ) - __gather_bsd_system_info - ;; darwin ) __gather_osx_system_info ;; @@ -1454,21 +1321,23 @@ __gather_system_info() { #---------------------------------------------------------------------------------------------------------------------- # shellcheck disable=SC2034 __ubuntu_derivatives_translation() { - UBUNTU_DERIVATIVES="(trisquel|linuxmint|linaro|elementary_os|neon|pop)" + UBUNTU_DERIVATIVES="(trisquel|linuxmint|elementary_os|pop|neon)" # Mappings - trisquel_6_ubuntu_base="12.04" - linuxmint_13_ubuntu_base="12.04" - linuxmint_17_ubuntu_base="14.04" - linuxmint_18_ubuntu_base="16.04" - linuxmint_19_ubuntu_base="18.04" - linuxmint_20_ubuntu_base="20.04" - linaro_12_ubuntu_base="12.04" - elementary_os_02_ubuntu_base="12.04" - neon_16_ubuntu_base="16.04" - neon_18_ubuntu_base="18.04" + trisquel_10_ubuntu_base="20.04" + trisquel_11_ubuntu_base="22.04" + trisquel_12_ubuntu_base="24.04" neon_20_ubuntu_base="20.04" neon_22_ubuntu_base="22.04" + neon_24_ubuntu_base="24.04" + linuxmint_20_ubuntu_base="20.04" + linuxmint_21_ubuntu_base="22.04" + linuxmint_22_ubuntu_base="24.04" + elementary_os_06_ubuntu_base="20.04" + elementary_os_07_ubuntu_base="22.04" + elementary_os_08_ubuntu_base="24.04" + pop_20_ubuntu_base="22.04" pop_22_ubuntu_base="22.04" + pop_24_ubuntu_base="24.04" # Translate Ubuntu derivatives to their base Ubuntu version match=$(echo "$DISTRO_NAME_L" | grep -E ${UBUNTU_DERIVATIVES}) @@ -1511,42 +1380,24 @@ __check_dpkg_architecture() { return 1 fi - __REPO_ARCH="$DPKG_ARCHITECTURE" - __REPO_ARCH_DEB='deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg]' __return_code=0 case $DPKG_ARCHITECTURE in "i386") - error_msg="$_REPO_URL likely doesn't have all required 32-bit packages for $DISTRO_NAME $DISTRO_MAJOR_VERSION." + error_msg="$_REPO_URL likely doesn't have required 32-bit packages for $DISTRO_NAME $DISTRO_MAJOR_VERSION." # amd64 is just a part of repository URI, 32-bit pkgs are hosted under the same location - __REPO_ARCH="amd64" + __return_code=1 ;; "amd64") error_msg="" ;; "arm64") - if [ "$_CUSTOM_REPO_URL" != "null" ]; then - warn_msg="Support for arm64 is experimental, make sure the custom repository used has the expected structure and contents." - else - # Saltstack official repository has arm64 metadata beginning with Debian 11, - # use amd64 repositories on arm64 for anything older, since all pkgs are arch-independent - if [ "$DISTRO_NAME_L" = "debian" ] && [ "$DISTRO_MAJOR_VERSION" -lt 11 ]; then - __REPO_ARCH="amd64" - else - __REPO_ARCH="arm64" - fi - __REPO_ARCH_DEB="deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=$__REPO_ARCH]" - warn_msg="Support for arm64 packages is experimental and might rely on architecture-independent packages from the amd64 repository." - fi + # Saltstack official repository has full arm64 support since 3006 error_msg="" ;; "armhf") - if [ "$DISTRO_NAME_L" = "ubuntu" ] || [ "$DISTRO_MAJOR_VERSION" -lt 8 ]; then - error_msg="Support for armhf packages at $_REPO_URL is limited to Debian/Raspbian 8 platforms." - __return_code=1 - else - error_msg="" - fi + error_msg="$_REPO_URL doesn't have packages for your system architecture: $DPKG_ARCHITECTURE." + __return_code=1 ;; *) error_msg="$_REPO_URL doesn't have packages for your system architecture: $DPKG_ARCHITECTURE." @@ -1562,10 +1413,10 @@ __check_dpkg_architecture() { if [ "${error_msg}" != "" ]; then echoerror "${error_msg}" if [ "$ITYPE" != "git" ]; then - echoerror "You can try git installation mode, i.e.: sh ${__ScriptName} git v2017.7.2." + echoerror "You can try git installation mode, i.e.: sh ${__ScriptName} git v3006.6." echoerror "It may be necessary to use git installation mode with pip and disable the SaltStack apt repository." echoerror "For example:" - echoerror " sh ${__ScriptName} -r -P git v2017.7.2" + echoerror " sh ${__ScriptName} -r -P git v3006.6" fi fi @@ -1617,8 +1468,14 @@ __ubuntu_codename_translation() { "22") DISTRO_CODENAME="jammy" ;; + "23") + DISTRO_CODENAME="lunar" + ;; + "24") + DISTRO_CODENAME="noble" + ;; *) - DISTRO_CODENAME="trusty" + DISTRO_CODENAME="noble" ;; esac } @@ -1637,20 +1494,21 @@ __debian_derivatives_translation() { DEBIAN_DERIVATIVES="(cumulus|devuan|kali|linuxmint|raspbian|bunsenlabs|turnkey)" # Mappings - cumulus_2_debian_base="7.0" - cumulus_3_debian_base="8.0" - cumulus_4_debian_base="10.0" - devuan_1_debian_base="8.0" - devuan_2_debian_base="9.0" + cumulus_5_debian_base="11.0" + cumulus_6_debian_base="12.0" + devuan_4_debian_base="11.0" + devuan_5_debian_base="12.0" kali_1_debian_base="7.0" kali_2021_debian_base="10.0" - linuxmint_1_debian_base="8.0" - raspbian_8_debian_base="8.0" - raspbian_9_debian_base="9.0" - raspbian_10_debian_base="10.0" + linuxmint_4_debian_base="11.0" + linuxmint_5_debian_base="12.0" raspbian_11_debian_base="11.0" + raspbian_12_debian_base="12.0" bunsenlabs_9_debian_base="9.0" - turnkey_9_debian_base="9.0" + bunsenlabs_11_debian_base="11.0" + bunsenlabs_12_debian_base="12.0" + turnkey_11_debian_base="11.0" + turnkey_12_debian_base="12.0" # Translate Debian derivatives to their base Debian version match=$(echo "$DISTRO_NAME_L" | grep -E ${DEBIAN_DERIVATIVES}) @@ -1718,14 +1576,9 @@ __debian_codename_translation() { ;; "12") DISTRO_CODENAME="bookworm" - # FIXME - TEMPORARY - # use bullseye packages until bookworm packages are available - DISTRO_CODENAME="bullseye" - DISTRO_MAJOR_VERSION=11 - rv=11 ;; *) - DISTRO_CODENAME="stretch" + DISTRO_CODENAME="bookworm" ;; esac } @@ -1738,8 +1591,8 @@ __debian_codename_translation() { __check_end_of_life_versions() { case "${DISTRO_NAME_L}" in debian) - # Debian versions below 9 are not supported - if [ "$DISTRO_MAJOR_VERSION" -lt 9 ]; then + # Debian versions below 11 are not supported + if [ "$DISTRO_MAJOR_VERSION" -lt 11 ]; then echoerror "End of life distributions are not supported." echoerror "Please consider upgrading to the next stable. See:" echoerror " https://wiki.debian.org/DebianReleases" @@ -1750,18 +1603,18 @@ __check_end_of_life_versions() { ubuntu) # Ubuntu versions not supported # - # < 16.04 - # = 16.10 - # = 17.04, 17.10 - # = 18.10 - # = 19.04, 19.10 + # < 20.04 # = 20.10 - if [ "$DISTRO_MAJOR_VERSION" -lt 16 ] || \ - [ "$DISTRO_MAJOR_VERSION" -eq 17 ] || \ - [ "$DISTRO_MAJOR_VERSION" -eq 19 ] || \ - { [ "$DISTRO_MAJOR_VERSION" -eq 16 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ - { [ "$DISTRO_MAJOR_VERSION" -eq 18 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ - { [ "$DISTRO_MAJOR_VERSION" -eq 20 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; }; then + # = 21.04, 21.10 + # = 22.10 + # = 23.04, 23.10 + if [ "$DISTRO_MAJOR_VERSION" -lt 20 ] || \ + { [ "$DISTRO_MAJOR_VERSION" -eq 20 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ + { [ "$DISTRO_MAJOR_VERSION" -eq 21 ] && [ "$DISTRO_MINOR_VERSION" -eq 04 ]; } || \ + { [ "$DISTRO_MAJOR_VERSION" -eq 21 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ + { [ "$DISTRO_MAJOR_VERSION" -eq 22 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ + { [ "$DISTRO_MAJOR_VERSION" -eq 23 ] && [ "$DISTRO_MINOR_VERSION" -eq 04 ]; } || \ + { [ "$DISTRO_MAJOR_VERSION" -eq 23 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; }; then echoerror "End of life distributions are not supported." echoerror "Please consider upgrading to the next stable. See:" echoerror " https://wiki.ubuntu.com/Releases" @@ -1805,8 +1658,8 @@ __check_end_of_life_versions() { ;; fedora) - # Fedora lower than 33 are no longer supported - if [ "$DISTRO_MAJOR_VERSION" -lt 33 ]; then + # Fedora lower than 38 are no longer supported + if [ "$DISTRO_MAJOR_VERSION" -lt 39 ]; then echoerror "End of life distributions are not supported." echoerror "Please consider upgrading to the next stable. See:" echoerror " https://fedoraproject.org/wiki/Releases" @@ -1815,8 +1668,8 @@ __check_end_of_life_versions() { ;; centos) - # CentOS versions lower than 7 are no longer supported - if [ "$DISTRO_MAJOR_VERSION" -lt 7 ]; then + # CentOS versions lower than 8 are no longer supported + if [ "$DISTRO_MAJOR_VERSION" -lt 8 ]; then echoerror "End of life distributions are not supported." echoerror "Please consider upgrading to the next stable. See:" echoerror " http://wiki.centos.org/Download" @@ -1825,8 +1678,8 @@ __check_end_of_life_versions() { ;; red_hat*linux) - # Red Hat (Enterprise) Linux versions lower than 7 are no longer supported - if [ "$DISTRO_MAJOR_VERSION" -lt 7 ]; then + # Red Hat (Enterprise) Linux versions lower than 8 are no longer supported + if [ "$DISTRO_MAJOR_VERSION" -lt 8 ]; then echoerror "End of life distributions are not supported." echoerror "Please consider upgrading to the next stable. See:" echoerror " https://access.redhat.com/support/policy/updates/errata/" @@ -1835,8 +1688,8 @@ __check_end_of_life_versions() { ;; oracle*linux) - # Oracle Linux versions lower than 7 are no longer supported - if [ "$DISTRO_MAJOR_VERSION" -lt 7 ]; then + # Oracle Linux versions lower than 8 are no longer supported + if [ "$DISTRO_MAJOR_VERSION" -lt 8 ]; then echoerror "End of life distributions are not supported." echoerror "Please consider upgrading to the next stable. See:" echoerror " http://www.oracle.com/us/support/library/elsp-lifetime-069338.pdf" @@ -1845,8 +1698,8 @@ __check_end_of_life_versions() { ;; scientific*linux) - # Scientific Linux versions lower than 7 are no longer supported - if [ "$DISTRO_MAJOR_VERSION" -lt 7 ]; then + # Scientific Linux versions lower than 8 are no longer supported + if [ "$DISTRO_MAJOR_VERSION" -lt 8 ]; then echoerror "End of life distributions are not supported." echoerror "Please consider upgrading to the next stable. See:" echoerror " https://www.scientificlinux.org/downloads/sl-versions/" @@ -1855,8 +1708,8 @@ __check_end_of_life_versions() { ;; cloud*linux) - # Cloud Linux versions lower than 7 are no longer supported - if [ "$DISTRO_MAJOR_VERSION" -lt 7 ]; then + # Cloud Linux versions lower than 8 are no longer supported + if [ "$DISTRO_MAJOR_VERSION" -lt 8 ]; then echoerror "End of life distributions are not supported." echoerror "Please consider upgrading to the next stable. See:" echoerror " https://docs.cloudlinux.com/index.html?cloudlinux_life-cycle.html" @@ -1875,20 +1728,11 @@ __check_end_of_life_versions() { fi ;; - freebsd) - # FreeBSD versions lower than 11 are EOL - if [ "$DISTRO_MAJOR_VERSION" -lt 11 ]; then - echoerror "Versions lower than FreeBSD 11 are EOL and no longer supported." - exit 1 - fi - ;; - *) ;; esac } - __gather_system_info echo @@ -1963,8 +1807,16 @@ if [ "$_INSTALL_SYNDIC" -eq $BS_TRUE ]; then fi fi +if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + if [ "$_CONFIG_ONLY" -eq $BS_FALSE ]; then + echoinfo "Installing salt api" + else + echoinfo "Configuring salt api" + fi +fi + if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ] && [ "$_CONFIG_ONLY" -eq $BS_FALSE ]; then - echoinfo "Installing salt-cloud and required python-libcloud package" + echoinfo "Installing salt-cloud and required python3-libcloud package" fi if [ $_START_DAEMONS -eq $BS_FALSE ]; then @@ -2008,16 +1860,14 @@ fi if [ "$ITYPE" = "git" ]; then if [ "${GIT_REV}" = "master" ]; then - _POST_NEON_INSTALL=$BS_TRUE __TAG_REGEX_MATCH="MATCH" else case ${OS_NAME_L} in - openbsd|freebsd|netbsd|darwin ) + darwin ) __NEW_VS_TAG_REGEX_MATCH=$(echo "${GIT_REV}" | sed -E 's/^(v?3[0-9]{3}(\.[0-9]{1,2})?).*$/MATCH/') if [ "$__NEW_VS_TAG_REGEX_MATCH" = "MATCH" ]; then - _POST_NEON_INSTALL=$BS_TRUE __TAG_REGEX_MATCH="${__NEW_VS_TAG_REGEX_MATCH}" - echodebug "Post Neon Tag Regex Match On: ${GIT_REV}" + echodebug "Tag Regex Match On: ${GIT_REV}" else __TAG_REGEX_MATCH=$(echo "${GIT_REV}" | sed -E 's/^(v?[0-9]{1,4}\.[0-9]{1,2})(\.[0-9]{1,2})?.*$/MATCH/') echodebug "Pre Neon Tag Regex Match On: ${GIT_REV}" @@ -2026,9 +1876,8 @@ if [ "$ITYPE" = "git" ]; then * ) __NEW_VS_TAG_REGEX_MATCH=$(echo "${GIT_REV}" | sed 's/^.*\(v\?3[[:digit:]]\{3\}\(\.[[:digit:]]\{1,2\}\)\?\).*$/MATCH/') if [ "$__NEW_VS_TAG_REGEX_MATCH" = "MATCH" ]; then - _POST_NEON_INSTALL=$BS_TRUE __TAG_REGEX_MATCH="${__NEW_VS_TAG_REGEX_MATCH}" - echodebug "Post Neon Tag Regex Match On: ${GIT_REV}" + echodebug "Tag Regex Match On: ${GIT_REV}" else __TAG_REGEX_MATCH=$(echo "${GIT_REV}" | sed 's/^.*\(v\?[[:digit:]]\{1,4\}\.[[:digit:]]\{1,2\}\)\(\.[[:digit:]]\{1,2\}\)\?.*$/MATCH/') echodebug "Pre Neon Tag Regex Match On: ${GIT_REV}" @@ -2037,18 +1886,16 @@ if [ "$ITYPE" = "git" ]; then esac fi - if [ "$_POST_NEON_INSTALL" -eq $BS_TRUE ]; then - echo - echowarn "Post Neon git based installations will always install salt" - echowarn "and its dependencies using pip which will be upgraded to" - echowarn "at least v${_MINIMUM_PIP_VERSION}, and, in case the setuptools version is also" - echowarn "too old, it will be upgraded to at least v${_MINIMUM_SETUPTOOLS_VERSION}" - echo - echowarn "You have 10 seconds to cancel and stop the bootstrap process..." - echo - sleep 10 - _PIP_ALLOWED=$BS_TRUE - fi + echo + echowarn "git based installations will always install salt" + echowarn "and its dependencies using pip which will be upgraded to" + echowarn "at least v${_MINIMUM_PIP_VERSION}, and, in case the setuptools version is also" + echowarn "too old, it will be upgraded to at least v${_MINIMUM_SETUPTOOLS_VERSION} and less than v${_MAXIMUM_SETUPTOOLS_VERSION}" + echo + echowarn "You have 10 seconds to cancel and stop the bootstrap process..." + echo + sleep 10 + _PIP_ALLOWED=$BS_TRUE fi @@ -2080,12 +1927,17 @@ __wait_for_apt(){ # Timeout set at 15 minutes WAIT_TIMEOUT=900 + ## see if sync'ing the clocks helps + if [ -f /usr/sbin/hwclock ]; then + /usr/sbin/hwclock -s + fi + # Run our passed in apt command "${@}" 2>"$APT_ERR" APT_RETURN=$? # Make sure we're not waiting on a lock - while [ $APT_RETURN -ne 0 ] && grep -q '^E: Could not get lock' "$APT_ERR"; do + while [ "$APT_RETURN" -ne 0 ] && grep -q '^E: Could not get lock' "$APT_ERR"; do echoinfo "Aware of the lock. Patiently waiting $WAIT_TIMEOUT more seconds..." sleep 1 WAIT_TIMEOUT=$((WAIT_TIMEOUT - 1)) @@ -2109,6 +1961,7 @@ __wait_for_apt(){ # PARAMETERS: packages #---------------------------------------------------------------------------------------------------------------------- __apt_get_install_noinput() { + __wait_for_apt apt-get install -y -o DPkg::Options::=--force-confold "${@}"; return $? } # ---------- end of function __apt_get_install_noinput ---------- @@ -2118,6 +1971,7 @@ __apt_get_install_noinput() { # DESCRIPTION: (DRY) apt-get upgrade with noinput options #---------------------------------------------------------------------------------------------------------------------- __apt_get_upgrade_noinput() { + __wait_for_apt apt-get upgrade -y -o DPkg::Options::=--force-confold; return $? } # ---------- end of function __apt_get_upgrade_noinput ---------- @@ -2148,12 +2002,14 @@ __temp_gpg_pub() { # PARAMETERS: url #---------------------------------------------------------------------------------------------------------------------- __apt_key_fetch() { + + url=$1 tempfile="$(__temp_gpg_pub)" - __fetch_url "$tempfile" "$url" || return 1 - cp -f "$tempfile" /usr/share/keyrings/salt-archive-keyring.gpg && chmod 644 /usr/share/keyrings/salt-archive-keyring.gpg || return 1 + mkdir -p /etc/apt/keyrings + cp -f "$tempfile" /etc/apt/keyrings/salt-archive-keyring.pgp && chmod 644 /etc/apt/keyrings/salt-archive-keyring.pgp || return 1 rm -f "$tempfile" return 0 @@ -2166,6 +2022,7 @@ __apt_key_fetch() { # PARAMETERS: url #---------------------------------------------------------------------------------------------------------------------- __rpm_import_gpg() { + url=$1 tempfile="$(__temp_gpg_pub)" @@ -2290,10 +2147,15 @@ __git_clone_and_checkout() { if [ "$(git clone 2>&1 | grep 'single-branch')" != "" ]; then # The "--single-branch" option is supported, attempt shallow cloning echoinfo "Attempting to shallow clone $GIT_REV from Salt's repository ${_SALT_REPO_URL}" - if git clone --depth 1 --branch "$GIT_REV" "$_SALT_REPO_URL" "$__SALT_CHECKOUT_REPONAME"; then + ## Shallow cloning is resulting in the wrong version of Salt, even with a depth of 5 + ## getting 3007.0+0na.246d066 when it should be 3007.1+410.g246d066457, disabling for now + ## if git clone --depth 1 --branch "$GIT_REV" "$_SALT_REPO_URL" "$__SALT_CHECKOUT_REPONAME"; then + echodebug "git command, git clone --branch $GIT_REV $_SALT_REPO_URL $__SALT_CHECKOUT_REPONAME" + if git clone --branch "$GIT_REV" "$_SALT_REPO_URL" "$__SALT_CHECKOUT_REPONAME"; then # shellcheck disable=SC2164 cd "${_SALT_GIT_CHECKOUT_DIR}" __SHALLOW_CLONE=$BS_TRUE + echoinfo "shallow path (disabled shallow) git cloned $GIT_REV, version $(python3 salt/version.py)" else # Shallow clone above failed(missing upstream tags???), let's resume the old behaviour. echowarn "Failed to shallow clone." @@ -2307,10 +2169,13 @@ __git_clone_and_checkout() { fi if [ "$__SHALLOW_CLONE" -eq $BS_FALSE ]; then + echodebug "shallow clone false, BS_FALSE $BS_FALSE, git clone $_SALT_REPO_URL $__SALT_CHECKOUT_REPONAME" git clone "$_SALT_REPO_URL" "$__SALT_CHECKOUT_REPONAME" || return 1 # shellcheck disable=SC2164 cd "${_SALT_GIT_CHECKOUT_DIR}" + echoinfo "git cloned $GIT_REV, version $(python3 salt/version.py)" + if ! echo "$_SALT_REPO_URL" | grep -q -F -w "${_SALTSTACK_REPO_URL#*://}"; then # We need to add the saltstack repository as a remote and fetch tags for proper versioning echoinfo "Adding SaltStack's Salt repository as a remote" @@ -2403,7 +2268,7 @@ __movefile() { exit 1 fi - if [ $_KEEP_TEMP_FILES -eq $BS_TRUE ]; then + if [ "$_KEEP_TEMP_FILES" -eq $BS_TRUE ]; then # We're being told not to move files, instead copy them so we can keep # them around echodebug "Since BS_KEEP_TEMP_FILES=1 we're copying files instead of moving them" @@ -2520,14 +2385,17 @@ __overwriteconfig() { if [ -n "$_PY_EXE" ]; then good_python="$_PY_EXE" # If python does not have yaml installed we're on Arch and should use python2 + # but no more support, hence error out elif python -c "import yaml" 2> /dev/null; then - good_python=python + good_python=python # assume python is python 3 on Arch else - good_python=python2 + ## good_python=python2 + echoerror "Python 2 is no longer supported, only Python 3" + return 1 fi # Convert json string to a yaml string and write it to config file. Output is dumped into tempfile. - "$good_python" -c "import json; import yaml; jsn=json.loads('$json'); yml=yaml.safe_dump(jsn, line_break='\\n', default_flow_style=False); config_file=open('$target', 'w'); config_file.write(yml); config_file.close();" 2>$tempfile + "$good_python" -c "import json; import yaml; jsn=json.loads('$json'); yml=yaml.safe_dump(jsn, line_break='\\n', default_flow_style=False, sort_keys=False); config_file=open('$target', 'w'); config_file.write(yml); config_file.close();" 2>"$tempfile" # No python errors output to the tempfile if [ ! -s "$tempfile" ]; then @@ -2552,6 +2420,7 @@ __overwriteconfig() { # PARAMETERS: servicename #---------------------------------------------------------------------------------------------------------------------- __check_services_systemd() { + if [ $# -eq 0 ]; then echoerror "You need to pass a service name to check!" exit 1 @@ -2559,6 +2428,21 @@ __check_services_systemd() { echoerror "You need to pass a service name to check as the single argument to the function" fi + # check if systemd is functional, having systemctl present is insufficient + + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_FALSE ]; then + # already determined systemd is not functional, default is 1 + return 1 + fi + + _SYSTEMD_ACTIVE=$(/bin/systemctl daemon-reload 2>&1 | grep 'System has not been booted with systemd') + echodebug "__check_services_systemd _SYSTEMD_ACTIVE result ,$_SYSTEMD_ACTIVE," + if [ "$_SYSTEMD_ACTIVE" != "" ]; then + _SYSTEMD_FUNCTIONAL=$BS_FALSE + echodebug "systemd is not functional, despite systemctl being present, setting _SYSTEMD_FUNCTIONAL false, $_SYSTEMD_FUNCTIONAL" + return 1 + fi + servicename=$1 echodebug "Checking if service ${servicename} is enabled" @@ -2578,6 +2462,7 @@ __check_services_systemd() { # PARAMETERS: servicename #---------------------------------------------------------------------------------------------------------------------- __check_services_upstart() { + if [ $# -eq 0 ]; then echoerror "You need to pass a service name to check!" exit 1 @@ -2605,6 +2490,7 @@ __check_services_upstart() { # PARAMETERS: servicename #---------------------------------------------------------------------------------------------------------------------- __check_services_sysvinit() { + if [ $# -eq 0 ]; then echoerror "You need to pass a service name to check!" exit 1 @@ -2631,6 +2517,7 @@ __check_services_sysvinit() { # PARAMETERS: servicename #---------------------------------------------------------------------------------------------------------------------- __check_services_debian() { + if [ $# -eq 0 ]; then echoerror "You need to pass a service name to check!" exit 1 @@ -2652,38 +2539,13 @@ __check_services_debian() { } # ---------- end of function __check_services_debian ---------- -#--- FUNCTION ------------------------------------------------------------------------------------------------------- -# NAME: __check_services_openbsd -# DESCRIPTION: Return 0 or 1 in case the service is enabled or not -# PARAMETERS: servicename -#---------------------------------------------------------------------------------------------------------------------- -__check_services_openbsd() { - if [ $# -eq 0 ]; then - echoerror "You need to pass a service name to check!" - exit 1 - elif [ $# -ne 1 ]; then - echoerror "You need to pass a service name to check as the single argument to the function" - fi - - servicename=$1 - echodebug "Checking if service ${servicename} is enabled" - - # shellcheck disable=SC2086,SC2046,SC2144 - if rcctl get ${servicename} status; then - echodebug "Service ${servicename} is enabled" - return 0 - else - echodebug "Service ${servicename} is NOT enabled" - return 1 - fi -} # ---------- end of function __check_services_openbsd ---------- - #--- FUNCTION ------------------------------------------------------------------------------------------------------- # NAME: __check_services_openrc # DESCRIPTION: Return 0 or 1 in case the service is enabled or not # PARAMETERS: servicename #---------------------------------------------------------------------------------------------------------------------- __check_services_openrc() { + if [ $# -eq 0 ]; then echoerror "You need to pass a service name to check!" exit 1 @@ -2710,9 +2572,10 @@ __check_services_openrc() { # DESCRIPTION: Return 0 or 1 depending on successful creation of virtualenv #---------------------------------------------------------------------------------------------------------------------- __create_virtualenv() { + if [ ! -d "$_VIRTUALENV_DIR" ]; then echoinfo "Creating virtualenv ${_VIRTUALENV_DIR}" - if [ $_PIP_ALL -eq $BS_TRUE ]; then + if [ "$_PIP_ALL" -eq $BS_TRUE ]; then virtualenv --no-site-packages "${_VIRTUALENV_DIR}" || return 1 else virtualenv --system-site-packages "${_VIRTUALENV_DIR}" || return 1 @@ -2727,6 +2590,7 @@ __create_virtualenv() { # DESCRIPTION: Return 0 or 1 depending on successful activation of virtualenv #---------------------------------------------------------------------------------------------------------------------- __activate_virtualenv() { + set +o nounset # Is virtualenv empty if [ -z "$_VIRTUALENV_DIR" ]; then @@ -2753,7 +2617,7 @@ __install_pip_pkgs() { _pip_cmd="${_py_exe} -m pip" if [ "${_py_exe}" = "" ]; then - _py_exe='python' + _py_exe='python3' fi __check_pip_allowed @@ -2781,17 +2645,6 @@ __install_pip_pkgs() { ${_pip_cmd} install ${_pip_pkgs} || return 1 } -#--- FUNCTION ------------------------------------------------------------------------------------------------------- -# NAME: __install_tornado_pip -# PARAMETERS: python executable -# DESCRIPTION: Return 0 or 1 if successfully able to install tornado<5.0 -#---------------------------------------------------------------------------------------------------------------------- -__install_tornado_pip() { - # OS needs tornado <5.0 from pip - __check_pip_allowed "You need to allow pip based installations (-P) for Tornado <5.0 in order to install Salt on Python 3" - ## install pip if its not installed and install tornado - __install_pip_pkgs "tornado<5.0" "${1}" || return 1 -} #--- FUNCTION ------------------------------------------------------------------------------------------------------- # NAME: __install_pip_deps @@ -2829,19 +2682,20 @@ __install_pip_deps() { } # ---------- end of function __install_pip_deps ---------- #--- FUNCTION ------------------------------------------------------------------------------------------------------- -# NAME: __install_salt_from_repo_post_neon +# NAME: __install_salt_from_repo # DESCRIPTION: Return 0 or 1 if successfully able to install. Can provide a different python version to # install pip packages with. If $py_exe is not specified it will use the default python version. # PARAMETERS: py_exe #---------------------------------------------------------------------------------------------------------------------- -__install_salt_from_repo_post_neon() { +__install_salt_from_repo() { + _py_exe="$1" if [ "${_py_exe}" = "" ]; then - _py_exe='python' + _py_exe="python3" fi - echodebug "__install_salt_from_repo_post_neon py_exe=$_py_exe" + echodebug "__install_salt_from_repo py_exe=$_py_exe" _py_version=$(${_py_exe} -c "import sys; print('{0}.{1}'.format(*sys.version_info))") _pip_cmd="pip${_py_version}" @@ -2879,14 +2733,9 @@ except ImportError: EOM ) if ! ${_py_exe} -c "$CHECK_PIP_VERSION_SCRIPT"; then - # Upgrade pip to at least 1.2 which is when we can start using "python -m pip" - if [ "${_py_version}" = "3.5" ]; then - echodebug "Running '${_pip_cmd} install ${_POST_NEON_PIP_INSTALL_ARGS} pip>=${_MINIMUM_PIP_VERSION},<21.0'" - ${_pip_cmd} install ${_POST_NEON_PIP_INSTALL_ARGS} -v "pip>=${_MINIMUM_PIP_VERSION},<21.0" - else - echodebug "Running '${_pip_cmd} install ${_POST_NEON_PIP_INSTALL_ARGS} pip>=${_MINIMUM_PIP_VERSION}'" - ${_pip_cmd} install ${_POST_NEON_PIP_INSTALL_ARGS} -v "pip>=${_MINIMUM_PIP_VERSION}" - fi + # Upgrade pip to at least 1.2 which is when we can start using "python3 -m pip" + echodebug "Running '${_pip_cmd} install ${_PIP_INSTALL_ARGS} pip>=${_MINIMUM_PIP_VERSION}'" + ${_pip_cmd} install ${_PIP_INSTALL_ARGS} -v "pip>=${_MINIMUM_PIP_VERSION}" sleep 1 echodebug "PATH: ${PATH}" _pip_cmd="pip${_py_version}" @@ -2905,26 +2754,43 @@ EOM echodebug "Installed pip version: $(${_pip_cmd} --version)" fi - _setuptools_dep="setuptools>=${_MINIMUM_SETUPTOOLS_VERSION}" - if [ "$_PY_MAJOR_VERSION" -eq 2 ]; then - # We also lock setuptools to <45 which is the latest release to support both py2 and py3 - _setuptools_dep="${_setuptools_dep},<45" + _setuptools_dep="setuptools>=${_MINIMUM_SETUPTOOLS_VERSION},<${_MAXIMUM_SETUPTOOLS_VERSION}" + if [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi - echodebug "Running '${_pip_cmd} install wheel ${_setuptools_dep}'" - ${_pip_cmd} install --upgrade ${_POST_NEON_PIP_INSTALL_ARGS} wheel "${_setuptools_dep}" + _USE_BREAK_SYSTEM_PACKAGES="" + # shellcheck disable=SC2086,SC2090 + if { [ ${DISTRO_NAME_L} = "ubuntu" ] && [ "$DISTRO_MAJOR_VERSION" -ge 24 ]; } || \ + [ ${DISTRO_NAME_L} = "debian" ] && [ "$DISTRO_MAJOR_VERSION" -ge 12 ]; then + _USE_BREAK_SYSTEM_PACKAGES="--break-system-packages" + echodebug "OS is greater than / equal Debian 12 or Ubuntu 24.04, using ${_USE_BREAK_SYSTEM_PACKAGES}" + fi - echoinfo "Installing salt using ${_py_exe}" + echodebug "Running '${_pip_cmd} install ${_USE_BREAK_SYSTEM_PACKAGES} --upgrade ${_PIP_INSTALL_ARGS} wheel ${_setuptools_dep}" + ${_pip_cmd} install ${_USE_BREAK_SYSTEM_PACKAGES} --upgrade ${_PIP_INSTALL_ARGS} wheel "${_setuptools_dep}" + + echoinfo "Installing salt using ${_py_exe}, $(${_py_exe} --version)" cd "${_SALT_GIT_CHECKOUT_DIR}" || return 1 - mkdir /tmp/git/deps + mkdir -p /tmp/git/deps + echodebug "Created directory /tmp/git/deps" + echodebug "Installing Salt dependencies for Salt version $(python3 salt/version.py)" + + if [ ${DISTRO_NAME_L} = "ubuntu" ] && [ "$DISTRO_MAJOR_VERSION" -eq 22 ]; then + echodebug "Ubuntu 22.04 has problem with base.txt requirements file, not parsing sys_platform == 'win32', upgrading from default pip works" + echodebug "${_pip_cmd} install ${_USE_BREAK_SYSTEM_PACKAGES} --upgrade pip" + ${_pip_cmd} install ${_USE_BREAK_SYSTEM_PACKAGES} --upgrade pip || (echo "Failed to upgrade pip" && return 1) + fi + echoinfo "Downloading Salt Dependencies from PyPi" echodebug "Running '${_pip_cmd} download -d /tmp/git/deps ${_PIP_DOWNLOAD_ARGS} .'" ${_pip_cmd} download -d /tmp/git/deps ${_PIP_DOWNLOAD_ARGS} . || (echo "Failed to download salt dependencies" && return 1) echoinfo "Installing Downloaded Salt Dependencies" - echodebug "Running '${_pip_cmd} install --ignore-installed ${_POST_NEON_PIP_INSTALL_ARGS} /tmp/git/deps/*'" - ${_pip_cmd} install --ignore-installed ${_POST_NEON_PIP_INSTALL_ARGS} /tmp/git/deps/* || return 1 + echodebug "Running '${_pip_cmd} install ${_USE_BREAK_SYSTEM_PACKAGES} --ignore-installed ${_PIP_INSTALL_ARGS} /tmp/git/deps/*'" + ${_pip_cmd} install ${_USE_BREAK_SYSTEM_PACKAGES} --ignore-installed ${_PIP_INSTALL_ARGS} /tmp/git/deps/* || return 1 rm -f /tmp/git/deps/* echoinfo "Building Salt Python Wheel" @@ -2934,16 +2800,27 @@ EOM fi echodebug "Running '${_py_exe} setup.py --salt-config-dir=$_SALT_ETC_DIR --salt-cache-dir=${_SALT_CACHE_DIR} ${SETUP_PY_INSTALL_ARGS} bdist_wheel'" - ${_py_exe} setup.py --salt-config-dir="$_SALT_ETC_DIR" --salt-cache-dir="${_SALT_CACHE_DIR}" ${SETUP_PY_INSTALL_ARGS} bdist_wheel || return 1 + ${_py_exe} setup.py --salt-config-dir="$_SALT_ETC_DIR" --salt-cache-dir="${_SALT_CACHE_DIR} ${SETUP_PY_INSTALL_ARGS}" bdist_wheel || return 1 mv dist/salt*.whl /tmp/git/deps/ || return 1 cd "${__SALT_GIT_CHECKOUT_PARENT_DIR}" || return 1 echoinfo "Installing Built Salt Wheel" - ${_pip_cmd} uninstall --yes salt 2>/dev/null || true - echodebug "Running '${_pip_cmd} install --no-deps --force-reinstall ${_POST_NEON_PIP_INSTALL_ARGS} /tmp/git/deps/salt*.whl'" - ${_pip_cmd} install --no-deps --force-reinstall \ - ${_POST_NEON_PIP_INSTALL_ARGS} \ + ${_pip_cmd} uninstall --yes ${_USE_BREAK_SYSTEM_PACKAGES} salt 2>/dev/null || true + + # Hack for getting current Arch working with git-master + if [ "${DISTRO_NAME}" = "Arch Linux" ]; then + _arch_dep="cryptography==42.0.7" # debug matching current Arch version of python-cryptography + echodebug "Running '${_pip_cmd} install --force-reinstall --break-system-packages ${_arch_dep}'" + ${_pip_cmd} install --force-reinstall --break-system-packages "${_arch_dep}" + fi + + echodebug "Running '${_pip_cmd} install ${_USE_BREAK_SYSTEM_PACKAGES} --no-deps --force-reinstall ${_PIP_INSTALL_ARGS} /tmp/git/deps/salt*.whl'" + + echodebug "Running ${_pip_cmd} install ${_USE_BREAK_SYSTEM_PACKAGES} --no-deps --force-reinstall ${_PIP_INSTALL_ARGS} --global-option=--salt-config-dir=$_SALT_ETC_DIR --salt-cache-dir=${_SALT_CACHE_DIR} ${SETUP_PY_INSTALL_ARGS} /tmp/git/deps/salt*.whl" + + ${_pip_cmd} install ${_USE_BREAK_SYSTEM_PACKAGES} --no-deps --force-reinstall \ + ${_PIP_INSTALL_ARGS} \ --global-option="--salt-config-dir=$_SALT_ETC_DIR --salt-cache-dir=${_SALT_CACHE_DIR} ${SETUP_PY_INSTALL_ARGS}" \ /tmp/git/deps/salt*.whl || return 1 @@ -2966,21 +2843,16 @@ EOM return 1 fi return 0 -} # ---------- end of function __install_salt_from_repo_post_neon ---------- +} # ---------- end of function __install_salt_from_repo ---------- -if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - if [ "x${_PY_MAJOR_VERSION}" = "x" ]; then - # Default to python 2 for pre Neon installs - _PY_MAJOR_VERSION=2 - fi -else - if [ "x${_PY_MAJOR_VERSION}" = "x" ]; then - # Default to python 3 for post Neon install - _PY_MAJOR_VERSION=3 - fi +# shellcheck disable=SC2268 +if [ "x${_PY_MAJOR_VERSION}" = "x" ]; then + # Default to python 3 for install + _PY_MAJOR_VERSION=3 fi + ####################################################################################################################### # # Distribution install functions @@ -3064,6 +2936,7 @@ fi # Ubuntu Install Functions # __enable_universe_repository() { + if [ "$(grep -R universe /etc/apt/sources.list /etc/apt/sources.list.d/ | grep -v '#')" != "" ]; then # The universe repository is already enabled return 0 @@ -3078,15 +2951,13 @@ __enable_universe_repository() { __install_saltstack_ubuntu_repository() { # Workaround for latest non-LTS Ubuntu + echodebug "__install_saltstack_ubuntu_repository() entry" + if { [ "$DISTRO_MAJOR_VERSION" -eq 20 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ - # remove 22 version when salt packages for 22.04 are available - [ "$DISTRO_MAJOR_VERSION" -eq 21 ] || [ "$DISTRO_MAJOR_VERSION" -eq 22 ]; then + { [ "$DISTRO_MAJOR_VERSION" -eq 22 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ + { [ "$DISTRO_MAJOR_VERSION" -eq 24 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ + [ "$DISTRO_MAJOR_VERSION" -eq 21 ] || [ "$DISTRO_MAJOR_VERSION" -eq 23 ] || [ "$DISTRO_MAJOR_VERSION" -eq 25 ]; then echowarn "Non-LTS Ubuntu detected, but stable packages requested. Trying packages for previous LTS release. You may experience problems." - UBUNTU_VERSION=20.04 - UBUNTU_CODENAME="focal" - else - UBUNTU_VERSION=${DISTRO_VERSION} - UBUNTU_CODENAME=${DISTRO_CODENAME} fi # Install downloader backend for GPG keys fetching @@ -3102,33 +2973,48 @@ __install_saltstack_ubuntu_repository() { __PACKAGES="${__PACKAGES} apt-transport-https ca-certificates" fi + ## include hwclock if not part of base OS (23.10 and up) + if [ ! -f /usr/sbin/hwclock ]; then + __PACKAGES="${__PACKAGES} util-linux-extra" + fi + # shellcheck disable=SC2086,SC2090 __apt_get_install_noinput ${__PACKAGES} || return 1 - __PY_VERSION_REPO="apt" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PY_VERSION_REPO="py3" + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is not supported, only Python 3" + return 1 fi # SaltStack's stable Ubuntu repository: - SALTSTACK_UBUNTU_URL="${HTTP_VAL}://${_REPO_URL}/${__PY_VERSION_REPO}/ubuntu/${UBUNTU_VERSION}/${__REPO_ARCH}/${STABLE_REV}" - echo "$__REPO_ARCH_DEB $SALTSTACK_UBUNTU_URL $UBUNTU_CODENAME main" > /etc/apt/sources.list.d/salt.list - - __apt_key_fetch "$SALTSTACK_UBUNTU_URL/salt-archive-keyring.gpg" || return 1 - + __fetch_url "/etc/apt/sources.list.d/salt.sources" "https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.sources" + __apt_key_fetch "${HTTP_VAL}://${_REPO_URL}/api/security/keypair/SaltProjectKey/public" || return 1 __wait_for_apt apt-get update || return 1 + + if [ "$STABLE_REV" != "latest" ]; then + # latest is default + STABLE_REV_MAJOR=$(echo "$STABLE_REV" | cut -d '.' -f 1) + if [ "$STABLE_REV_MAJOR" -eq "3006" ]; then + echo "Package: salt-*" > /etc/apt/preferences.d/salt-pin-1001 + echo "Pin: version 3006.*" >> /etc/apt/preferences.d/salt-pin-1001 + echo "Pin-Priority: 1001" >> /etc/apt/preferences.d/salt-pin-1001 + elif [ "$STABLE_REV_MAJOR" -eq "3007" ]; then + echo "Package: salt-*" > /etc/apt/preferences.d/salt-pin-1001 + echo "Pin: version 3007.*" >> /etc/apt/preferences.d/salt-pin-1001 + echo "Pin-Priority: 1001" >> /etc/apt/preferences.d/salt-pin-1001 + fi + fi + } __install_saltstack_ubuntu_onedir_repository() { + + echodebug "__install_saltstack_ubuntu_onedir_repository() entry" # Workaround for latest non-LTS Ubuntu if { [ "$DISTRO_MAJOR_VERSION" -eq 20 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ - [ "$DISTRO_MAJOR_VERSION" -eq 21 ]; then + { [ "$DISTRO_MAJOR_VERSION" -eq 22 ] && [ "$DISTRO_MINOR_VERSION" -eq 10 ]; } || \ + [ "$DISTRO_MAJOR_VERSION" -eq 21 ] || [ "$DISTRO_MAJOR_VERSION" -eq 23 ] || [ "$DISTRO_MAJOR_VERSION" -eq 25 ]; then echowarn "Non-LTS Ubuntu detected, but stable packages requested. Trying packages for previous LTS release. You may experience problems." - UBUNTU_VERSION=20.04 - UBUNTU_CODENAME="focal" - else - UBUNTU_VERSION=${DISTRO_VERSION} - UBUNTU_CODENAME=${DISTRO_CODENAME} fi # Install downloader backend for GPG keys fetching @@ -3144,35 +3030,38 @@ __install_saltstack_ubuntu_onedir_repository() { __PACKAGES="${__PACKAGES} apt-transport-https ca-certificates" fi + ## include hwclock if not part of base OS (23.10 and up) + if [ ! -f /usr/sbin/hwclock ]; then + __PACKAGES="${__PACKAGES} util-linux-extra" + fi + # shellcheck disable=SC2086,SC2090 __apt_get_install_noinput ${__PACKAGES} || return 1 - __PY_VERSION_REPO="apt" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PY_VERSION_REPO="py3" - fi - # SaltStack's stable Ubuntu repository: - SALTSTACK_UBUNTU_URL="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_DIR}/${__PY_VERSION_REPO}/ubuntu/${UBUNTU_VERSION}/${__REPO_ARCH}/${ONEDIR_REV}/" - if [ "${ONEDIR_REV}" = "nightly" ] ; then - SALTSTACK_UBUNTU_URL="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_NIGHTLY_DIR}/${__PY_VERSION_REPO}/ubuntu/${UBUNTU_VERSION}/${__REPO_ARCH}/" - fi - echo "$__REPO_ARCH_DEB $SALTSTACK_UBUNTU_URL $UBUNTU_CODENAME main" > /etc/apt/sources.list.d/salt.list - - if [ "$(echo "${ONEDIR_REV}" | grep -E '(3004|3005)')" != "" ]; then - __apt_key_fetch "${SALTSTACK_UBUNTU_URL}salt-archive-keyring.gpg" || return 1 - elif [ "$(echo "${ONEDIR_REV}" | grep -E '(latest|nightly)')" != "" ]; then - __apt_key_fetch "${SALTSTACK_UBUNTU_URL}salt-archive-keyring.gpg" || \ - __apt_key_fetch "${SALTSTACK_UBUNTU_URL}SALT-PROJECT-GPG-PUBKEY-2023.gpg" || return 1 - else - __apt_key_fetch "${SALTSTACK_UBUNTU_URL}SALT-PROJECT-GPG-PUBKEY-2023.gpg" || return 1 - fi - + __fetch_url "/etc/apt/sources.list.d/salt.sources" "https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.sources" + __apt_key_fetch "${HTTP_VAL}://${_REPO_URL}/api/security/keypair/SaltProjectKey/public" || return 1 __wait_for_apt apt-get update || return 1 + + if [ "$ONEDIR_REV" != "latest" ]; then + # latest is default + ONEDIR_REV_MAJOR=$(echo "$ONEDIR_REV" | cut -d '.' -f 1) + if [ "$ONEDIR_REV_MAJOR" -eq "3006" ]; then + echo "Package: salt-*" > /etc/apt/preferences.d/salt-pin-1001 + echo "Pin: version 3006.*" >> /etc/apt/preferences.d/salt-pin-1001 + echo "Pin-Priority: 1001" >> /etc/apt/preferences.d/salt-pin-1001 + elif [ "$ONEDIR_REV_MAJOR" -eq "3007" ]; then + echo "Package: salt-*" > /etc/apt/preferences.d/salt-pin-1001 + echo "Pin: version 3007.*" >> /etc/apt/preferences.d/salt-pin-1001 + echo "Pin-Priority: 1001" >> /etc/apt/preferences.d/salt-pin-1001 + fi + fi } install_ubuntu_deps() { - if [ $_DISABLE_REPOS -eq $BS_FALSE ]; then + + echodebug "install_ubuntu_deps() entry" + if [ "$_DISABLE_REPOS" -eq $BS_FALSE ]; then # Install add-apt-repository if ! __check_command_exists add-apt-repository; then __apt_get_install_noinput software-properties-common || return 1 @@ -3185,24 +3074,19 @@ install_ubuntu_deps() { __PACKAGES='' - if [ "$DISTRO_MAJOR_VERSION" -lt 16 ]; then - # Minimal systems might not have upstart installed, install it - __PACKAGES="upstart" + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - PY_PKG_VER=3 - else - PY_PKG_VER="" - fi - - if [ "$DISTRO_MAJOR_VERSION" -ge 16 ] && [ -z "$_PY_EXE" ]; then - __PACKAGES="${__PACKAGES} python2.7" + if [ "$DISTRO_MAJOR_VERSION" -ge 20 ] && [ -z "$_PY_EXE" ]; then + __PACKAGES="${__PACKAGES} python${PY_PKG_VER}" fi if [ "$_VIRTUALENV_DIR" != "null" ]; then - __PACKAGES="${__PACKAGES} python-virtualenv" + __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-virtualenv" fi + # Need python-apt for managing packages via Salt __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-apt" @@ -3215,6 +3099,11 @@ install_ubuntu_deps() { # Additionally install procps and pciutils which allows for Docker bootstraps. See 366#issuecomment-39666813 __PACKAGES="${__PACKAGES} procps pciutils" + ## include hwclock if not part of base OS (23.10 and up) + if [ ! -f /usr/sbin/hwclock ]; then + __PACKAGES="${__PACKAGES} util-linux-extra" + fi + # shellcheck disable=SC2086,SC2090 __apt_get_install_noinput ${__PACKAGES} || return 1 @@ -3228,14 +3117,10 @@ install_ubuntu_deps() { } install_ubuntu_stable_deps() { - if [ "${_SLEEP}" -eq "${__DEFAULT_SLEEP}" ] && [ "$DISTRO_MAJOR_VERSION" -lt 16 ]; then - # The user did not pass a custom sleep value as an argument, let's increase the default value - echodebug "On Ubuntu systems we increase the default sleep value to 10." - echodebug "See https://github.com/saltstack/salt/issues/12248 for more info." - _SLEEP=10 - fi - if [ $_START_DAEMONS -eq $BS_FALSE ]; then + echodebug "install_ubuntu_stable_deps() entry" + + if [ "$_START_DAEMONS" -eq $BS_FALSE ]; then echowarn "Not starting daemons on Debian based distributions is not working mostly because starting them is the default behaviour." fi @@ -3246,7 +3131,8 @@ install_ubuntu_stable_deps() { if [ "${_UPGRADE_SYS}" -eq $BS_TRUE ]; then if [ "${_INSECURE_DL}" -eq $BS_TRUE ]; then - if [ "$DISTRO_MAJOR_VERSION" -ge 20 ] || [ "$DISTRO_MAJOR_VERSION" -ge 21 ] || [ "$DISTRO_MAJOR_VERSION" -ge 22 ]; then + ## apt-key is deprecated + if [ "$DISTRO_MAJOR_VERSION" -ge 20 ]; then __apt_get_install_noinput --allow-unauthenticated debian-archive-keyring && apt-get update || return 1 else __apt_get_install_noinput --allow-unauthenticated debian-archive-keyring && @@ -3266,6 +3152,9 @@ install_ubuntu_stable_deps() { } install_ubuntu_git_deps() { + + echodebug "install_ubuntu_git_deps() entry" + __wait_for_apt apt-get update || return 1 if ! __check_command_exists git; then @@ -3278,65 +3167,27 @@ install_ubuntu_git_deps() { __git_clone_and_checkout || return 1 - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - PY_PKG_VER=3 - else - PY_PKG_VER="" + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - - __PACKAGES="" - - # See how we are installing packages - if [ "${_PIP_ALL}" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} python-dev swig libssl-dev libzmq3 libzmq3-dev" - - if ! __check_command_exists pip; then - __PACKAGES="${__PACKAGES} python-setuptools python-pip" - fi - - # Get just the apt packages that are required to build all the pythons - # shellcheck disable=SC2086 - __apt_get_install_noinput ${__PACKAGES} || return 1 - # Install the pythons from requirements (only zmq for now) - __install_pip_deps "${_SALT_GIT_CHECKOUT_DIR}/requirements/zeromq.txt" || return 1 - else - install_ubuntu_stable_deps || return 1 - - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PACKAGES="${__PACKAGES} python3-setuptools" - else - # There is no m2crypto package for Py3 at this time - only install for Py2 - __PACKAGES="${__PACKAGES} python-m2crypto" - fi - - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-crypto python${PY_PKG_VER}-jinja2" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-msgpack python${PY_PKG_VER}-requests" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-tornado python${PY_PKG_VER}-yaml" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-zmq" - __PACKAGES="${__PACKAGES} python-concurrent.futures" - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - # Install python-libcloud if asked to - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-libcloud" - fi - - # shellcheck disable=SC2086 - __apt_get_install_noinput ${__PACKAGES} || return 1 - fi - else - __PACKAGES="python${PY_PKG_VER}-dev python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" - if [ "$DISTRO_MAJOR_VERSION" -ge 22 ]; then - __PACKAGES="${__PACKAGES} g++" - fi - # shellcheck disable=SC2086 - __apt_get_install_noinput ${__PACKAGES} || return 1 + __PACKAGES="python${PY_PKG_VER}-dev python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" + if [ "$DISTRO_MAJOR_VERSION" -ge 22 ]; then + __PACKAGES="${__PACKAGES} g++" fi + ## include hwclock if not part of base OS (23.10 and up) + if [ ! -f /usr/sbin/hwclock ]; then + __PACKAGES="${__PACKAGES} util-linux-extra" + fi + + # shellcheck disable=SC2086 + __apt_get_install_noinput ${__PACKAGES} || return 1 + # Let's trigger config_salt() if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" CONFIG_SALT_FUNC="config_salt" fi @@ -3344,14 +3195,8 @@ install_ubuntu_git_deps() { } install_ubuntu_onedir_deps() { - if [ "${_SLEEP}" -eq "${__DEFAULT_SLEEP}" ] && [ "$DISTRO_MAJOR_VERSION" -lt 16 ]; then - # The user did not pass a custom sleep value as an argument, let's increase the default value - echodebug "On Ubuntu systems we increase the default sleep value to 10." - echodebug "See https://github.com/saltstack/salt/issues/12248 for more info." - _SLEEP=10 - fi - if [ $_START_DAEMONS -eq $BS_FALSE ]; then + if [ "$_START_DAEMONS" -eq $BS_FALSE ]; then echowarn "Not starting daemons on Debian based distributions is not working mostly because starting them is the default behaviour." fi @@ -3362,7 +3207,8 @@ install_ubuntu_onedir_deps() { if [ "${_UPGRADE_SYS}" -eq $BS_TRUE ]; then if [ "${_INSECURE_DL}" -eq $BS_TRUE ]; then - if [ "$DISTRO_MAJOR_VERSION" -ge 20 ] || [ "$DISTRO_MAJOR_VERSION" -ge 21 ]; then + ## apt-key is deprecated + if [ "$DISTRO_MAJOR_VERSION" -ge 20 ]; then __apt_get_install_noinput --allow-unauthenticated debian-archive-keyring && apt-get update || return 1 else __apt_get_install_noinput --allow-unauthenticated debian-archive-keyring && @@ -3382,6 +3228,7 @@ install_ubuntu_onedir_deps() { } install_ubuntu_stable() { + __PACKAGES="" if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ];then @@ -3397,6 +3244,10 @@ install_ubuntu_stable() { __PACKAGES="${__PACKAGES} salt-syndic" fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api" + fi + # shellcheck disable=SC2086 __apt_get_install_noinput ${__PACKAGES} || return 1 @@ -3404,6 +3255,7 @@ install_ubuntu_stable() { } install_ubuntu_git() { + # Activate virtualenv before install if [ "${_VIRTUALENV_DIR}" != "null" ]; then __activate_virtualenv || return 1 @@ -3412,43 +3264,28 @@ install_ubuntu_git() { if [ -n "$_PY_EXE" ]; then _PYEXE=${_PY_EXE} else - _PYEXE=python2.7 + echoerror "Python 2 is no longer supported, only Python 3" + return 1 fi - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - # We can use --prefix on debian based ditributions - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - _POST_NEON_PIP_INSTALL_ARGS="--target=/usr/lib/python3/dist-packages --install-option=--install-scripts=/usr/bin" - else - _POST_NEON_PIP_INSTALL_ARGS="--target=/usr/lib/python2.7/dist-packages --install-option=--install-scripts=/usr/bin" - fi - _POST_NEON_PIP_INSTALL_ARGS="" - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - cd "${_SALT_GIT_CHECKOUT_DIR}" || return 1 + _PIP_INSTALL_ARGS="" + __install_salt_from_repo "${_PY_EXE}" || return 1 + cd "${_SALT_GIT_CHECKOUT_DIR}" || return 1 - # Account for new path for services files in later releases - if [ -d "pkg/common" ]; then - _SERVICE_DIR="pkg/common" - else - _SERVICE_DIR="pkg" - fi - - sed -i 's:/usr/bin:/usr/local/bin:g' ${_SERVICE_DIR}/*.service - return 0 - fi - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/salt/syspaths.py" ]; then - # shellcheck disable=SC2086 - "${_PYEXE}" setup.py --salt-config-dir="$_SALT_ETC_DIR" --salt-cache-dir="${_SALT_CACHE_DIR}" ${SETUP_PY_INSTALL_ARGS} install --install-layout=deb || return 1 + # Account for new path for services files in later releases + if [ -d "pkg/common" ]; then + _SERVICE_DIR="pkg/common" else - # shellcheck disable=SC2086 - "${_PYEXE}" setup.py ${SETUP_PY_INSTALL_ARGS} install --install-layout=deb || return 1 + _SERVICE_DIR="pkg" fi + sed -i 's:/usr/bin:/usr/local/bin:g' "${_SERVICE_DIR}"/*.service return 0 + } install_ubuntu_onedir() { + __PACKAGES="" if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ];then @@ -3464,6 +3301,10 @@ install_ubuntu_onedir() { __PACKAGES="${__PACKAGES} salt-syndic" fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api" + fi + # shellcheck disable=SC2086 __apt_get_install_noinput ${__PACKAGES} || return 1 @@ -3471,6 +3312,7 @@ install_ubuntu_onedir() { } install_ubuntu_stable_post() { + for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot [ $fname = "api" ] && continue @@ -3480,7 +3322,8 @@ install_ubuntu_stable_post() { [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /bin/systemctl ]; then + ## if [ -f /bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then # Using systemd /bin/systemctl is-enabled salt-$fname.service > /dev/null 2>&1 || ( /bin/systemctl preset salt-$fname.service > /dev/null 2>&1 && @@ -3497,6 +3340,7 @@ install_ubuntu_stable_post() { } install_ubuntu_git_post() { + for fname in api master minion syndic; do # Skip if not meant to be installed [ $fname = "api" ] && \ @@ -3512,7 +3356,7 @@ install_ubuntu_git_post() { _SERVICE_DIR="${_SALT_GIT_CHECKOUT_DIR}/pkg" fi - if [ -f /bin/systemctl ] && [ "$DISTRO_MAJOR_VERSION" -ge 16 ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ] && [ "$DISTRO_MAJOR_VERSION" -ge 16 ]; then __copyfile "${_SERVICE_DIR}/salt-${fname}.service" "/lib/systemd/system/salt-${fname}.service" # Skip salt-api since the service should be opt-in and not necessarily started on boot @@ -3521,21 +3365,6 @@ install_ubuntu_git_post() { systemctl is-enabled salt-$fname.service || (systemctl preset salt-$fname.service && systemctl enable salt-$fname.service) sleep 1 systemctl daemon-reload - elif [ -f /sbin/initctl ]; then - _upstart_conf="/etc/init/salt-$fname.conf" - # We have upstart support - echodebug "There's upstart support" - if [ ! -f $_upstart_conf ]; then - # upstart does not know about our service, let's copy the proper file - echowarn "Upstart does not appear to know about salt-$fname" - echodebug "Copying ${_SERVICE_DIR}/salt-$fname.upstart to $_upstart_conf" - __copyfile "${_SERVICE_DIR}/salt-${fname}.upstart" "$_upstart_conf" - # Set service to know about virtualenv - if [ "${_VIRTUALENV_DIR}" != "null" ]; then - echo "SALT_USE_VIRTUALENV=${_VIRTUALENV_DIR}" > /etc/default/salt-${fname} - fi - /sbin/initctl reload-configuration || return 1 - fi # No upstart support in Ubuntu!? elif [ -f "${_SALT_GIT_CHECKOUT_DIR}/pkg/salt-${fname}.init" ]; then echodebug "There's NO upstart support!?" @@ -3548,7 +3377,7 @@ install_ubuntu_git_post() { update-rc.d salt-$fname defaults else - echoerror "Neither upstart nor init.d was setup for salt-$fname" + echoerror "No init.d was setup for salt-$fname" fi done @@ -3556,13 +3385,12 @@ install_ubuntu_git_post() { } install_ubuntu_restart_daemons() { - [ $_START_DAEMONS -eq $BS_FALSE ] && return - # Ensure upstart configs / systemd units are loaded - if [ -f /bin/systemctl ] && [ "$DISTRO_MAJOR_VERSION" -ge 16 ]; then + [ "$_START_DAEMONS" -eq $BS_FALSE ] && return + + # Ensure systemd units are loaded + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ] && [ "$DISTRO_MAJOR_VERSION" -ge 16 ]; then systemctl daemon-reload - elif [ -f /sbin/initctl ]; then - /sbin/initctl reload-configuration fi for fname in api master minion syndic; do @@ -3574,7 +3402,7 @@ install_ubuntu_restart_daemons() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /bin/systemctl ] && [ "$DISTRO_MAJOR_VERSION" -ge 16 ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ] && [ "$DISTRO_MAJOR_VERSION" -ge 16 ]; then echodebug "There's systemd support while checking salt-$fname" systemctl stop salt-$fname > /dev/null 2>&1 systemctl start salt-$fname.service && continue @@ -3586,18 +3414,6 @@ install_ubuntu_restart_daemons() { fi fi - if [ -f /sbin/initctl ]; then - echodebug "There's upstart support while checking salt-$fname" - - if status salt-$fname 2>/dev/null | grep -q running; then - stop salt-$fname || (echodebug "Failed to stop salt-$fname" && return 1) - fi - - start salt-$fname && continue - # We failed to start the service, let's test the SysV code below - echodebug "Failed to start salt-$fname using Upstart" - fi - if [ ! -f /etc/init.d/salt-$fname ]; then echoerror "No init.d support for salt-$fname was found" return 1 @@ -3611,6 +3427,7 @@ install_ubuntu_restart_daemons() { } install_ubuntu_check_services() { + for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot [ $fname = "api" ] && continue @@ -3620,10 +3437,8 @@ install_ubuntu_check_services() { [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /bin/systemctl ] && [ "$DISTRO_MAJOR_VERSION" -ge 16 ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ] && [ "$DISTRO_MAJOR_VERSION" -ge 16 ]; then __check_services_systemd salt-$fname || return 1 - elif [ -f /sbin/initctl ] && [ -f /etc/init/salt-${fname}.conf ]; then - __check_services_upstart salt-$fname || return 1 elif [ -f /etc/init.d/salt-$fname ]; then __check_services_debian salt-$fname || return 1 fi @@ -3641,12 +3456,12 @@ install_ubuntu_check_services() { # Debian Install Functions # __install_saltstack_debian_repository() { - DEBIAN_RELEASE="$DISTRO_MAJOR_VERSION" - DEBIAN_CODENAME="$DISTRO_CODENAME" - __PY_VERSION_REPO="apt" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PY_VERSION_REPO="py3" + echodebug "__install_saltstack_debian_repository() entry" + + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi # Install downloader backend for GPG keys fetching @@ -3665,22 +3480,37 @@ __install_saltstack_debian_repository() { # shellcheck disable=SC2086,SC2090 __apt_get_install_noinput ${__PACKAGES} || return 1 - # amd64 is just a part of repository URI, 32-bit pkgs are hosted under the same location - SALTSTACK_DEBIAN_URL="${HTTP_VAL}://${_REPO_URL}/${__PY_VERSION_REPO}/debian/${DEBIAN_RELEASE}/${__REPO_ARCH}/${STABLE_REV}" - echo "$__REPO_ARCH_DEB $SALTSTACK_DEBIAN_URL $DEBIAN_CODENAME main" > "/etc/apt/sources.list.d/salt.list" - - __apt_key_fetch "$SALTSTACK_DEBIAN_URL/salt-archive-keyring.gpg" || return 1 + ## SALTSTACK_DEBIAN_URL="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_DIR}/${__PY_VERSION_REPO}/debian/${DEBIAN_RELEASE}/${__REPO_ARCH}/${STABLE_REV}" + ## echo "$__REPO_ARCH_DEB $SALTSTACK_DEBIAN_URL $DEBIAN_CODENAME main" > "/etc/apt/sources.list.d/salt.list" + ## __apt_key_fetch "$SALTSTACK_DEBIAN_URL/SALT-PROJECT-GPG-PUBKEY-2023.gpg" || return 1 + ## __wait_for_apt apt-get update || return 1 + __fetch_url "/etc/apt/sources.list.d/salt.sources" "https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.sources" + __apt_key_fetch "${HTTP_VAL}://${_REPO_URL}/api/security/keypair/SaltProjectKey/public" || return 1 __wait_for_apt apt-get update || return 1 + + if [ "$STABLE_REV" != "latest" ]; then + # latest is default + STABLE_REV_MAJOR=$(echo "$STABLE_REV" | cut -d '.' -f 1) + if [ "$STABLE_REV_MAJOR" -eq "3006" ]; then + echo "Package: salt-*" > /etc/apt/preferences.d/salt-pin-1001 + echo "Pin: version 3006.*" >> /etc/apt/preferences.d/salt-pin-1001 + echo "Pin-Priority: 1001" >> /etc/apt/preferences.d/salt-pin-1001 + elif [ "$STABLE_REV_MAJOR" -eq "3007" ]; then + echo "Package: salt-*" > /etc/apt/preferences.d/salt-pin-1001 + echo "Pin: version 3007.*" >> /etc/apt/preferences.d/salt-pin-1001 + echo "Pin-Priority: 1001" >> /etc/apt/preferences.d/salt-pin-1001 + fi + fi } __install_saltstack_debian_onedir_repository() { - DEBIAN_RELEASE="$DISTRO_MAJOR_VERSION" - DEBIAN_CODENAME="$DISTRO_CODENAME" - __PY_VERSION_REPO="apt" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PY_VERSION_REPO="py3" + echodebug "__install_saltstack_debian_onedir_repository() entry" + + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi # Install downloader backend for GPG keys fetching @@ -3699,80 +3529,30 @@ __install_saltstack_debian_onedir_repository() { # shellcheck disable=SC2086,SC2090 __apt_get_install_noinput ${__PACKAGES} || return 1 - # amd64 is just a part of repository URI, 32-bit pkgs are hosted under the same location - SALTSTACK_DEBIAN_URL="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_DIR}/${__PY_VERSION_REPO}/debian/${DEBIAN_RELEASE}/${__REPO_ARCH}/${ONEDIR_REV}/" - if [ "${ONEDIR_REV}" = "nightly" ] ; then - SALTSTACK_DEBIAN_URL="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_NIGHTLY_DIR}/${__PY_VERSION_REPO}/debian/${DEBIAN_RELEASE}/${__REPO_ARCH}/" - fi - echo "$__REPO_ARCH_DEB $SALTSTACK_DEBIAN_URL $DEBIAN_CODENAME main" > "/etc/apt/sources.list.d/salt.list" - - if [ "$(echo "${ONEDIR_REV}" | grep -E '(3004|3005)')" != "" ]; then - __apt_key_fetch "${SALTSTACK_DEBIAN_URL}salt-archive-keyring.gpg" || return 1 - elif [ "$(echo "${ONEDIR_REV}" | grep -E '(latest|nightly)')" != "" ]; then - __apt_key_fetch "${SALTSTACK_DEBIAN_URL}salt-archive-keyring.gpg" || \ - __apt_key_fetch "${SALTSTACK_DEBIAN_URL}SALT-PROJECT-GPG-PUBKEY-2023.gpg" || return 1 - else - __apt_key_fetch "${SALTSTACK_DEBIAN_URL}SALT-PROJECT-GPG-PUBKEY-2023.gpg" || return 1 - fi - - __wait_for_apt apt-get update || return 1 -} - -install_debian_deps() { - if [ $_START_DAEMONS -eq $BS_FALSE ]; then - echowarn "Not starting daemons on Debian based distributions is not working mostly because starting them is the default behaviour." - fi - - # No user interaction, libc6 restart services for example - export DEBIAN_FRONTEND=noninteractive - + __fetch_url "/etc/apt/sources.list.d/salt.sources" "https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.sources" + __apt_key_fetch "${HTTP_VAL}://${_REPO_URL}/api/security/keypair/SaltProjectKey/public" || return 1 __wait_for_apt apt-get update || return 1 - if [ "${_UPGRADE_SYS}" -eq $BS_TRUE ]; then - # Try to update GPG keys first if allowed - if [ "${_INSECURE_DL}" -eq $BS_TRUE ]; then - if [ "$DISTRO_MAJOR_VERSION" -ge 10 ]; then - __apt_get_install_noinput --allow-unauthenticated debian-archive-keyring && apt-get update || return 1 - else - __apt_get_install_noinput --allow-unauthenticated debian-archive-keyring && - apt-key update && apt-get update || return 1 - fi + if [ "$ONEDIR_REV" != "latest" ]; then + # latest is default + ONEDIR_REV_MAJOR=$(echo "$ONEDIR_REV" | cut -d '.' -f 1) + if [ "$ONEDIR_REV_MAJOR" -eq "3006" ]; then + echo "Package: salt-*" > /etc/apt/preferences.d/salt-pin-1001 + echo "Pin: version 3006.*" >> /etc/apt/preferences.d/salt-pin-1001 + echo "Pin-Priority: 1001" >> /etc/apt/preferences.d/salt-pin-1001 + elif [ "$ONEDIR_REV_MAJOR" -eq "3007" ]; then + echo "Package: salt-*" > /etc/apt/preferences.d/salt-pin-1001 + echo "Pin: version 3007.*" >> /etc/apt/preferences.d/salt-pin-1001 + echo "Pin-Priority: 1001" >> /etc/apt/preferences.d/salt-pin-1001 fi - - __apt_get_upgrade_noinput || return 1 fi - - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - PY_PKG_VER=3 - else - PY_PKG_VER="" - fi - - # Additionally install procps and pciutils which allows for Docker bootstraps. See 366#issuecomment-39666813 - __PACKAGES='procps pciutils' - - # YAML module is used for generating custom master/minion configs - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-yaml" - - # shellcheck disable=SC2086 - __apt_get_install_noinput ${__PACKAGES} || return 1 - - if [ "$_DISABLE_REPOS" -eq "$BS_FALSE" ] || [ "$_CUSTOM_REPO_URL" != "null" ]; then - __check_dpkg_architecture || return 1 - __install_saltstack_debian_repository || return 1 - fi - - if [ "${_EXTRA_PACKAGES}" != "" ]; then - echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}" - # shellcheck disable=SC2086 - __apt_get_install_noinput ${_EXTRA_PACKAGES} || return 1 - fi - - return 0 } install_debian_onedir_deps() { - if [ $_START_DAEMONS -eq $BS_FALSE ]; then + + echodebug "install_debian_onedir_git_deps() entry" + + if [ "$_START_DAEMONS" -eq $BS_FALSE ]; then echowarn "Not starting daemons on Debian based distributions is not working mostly because starting them is the default behaviour." fi @@ -3795,10 +3575,9 @@ install_debian_onedir_deps() { __apt_get_upgrade_noinput || return 1 fi - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - PY_PKG_VER=3 - else - PY_PKG_VER="" + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi # Additionally install procps and pciutils which allows for Docker bootstraps. See 366#issuecomment-39666813 @@ -3824,75 +3603,14 @@ install_debian_onedir_deps() { return 0 } -install_debian_git_pre() { - if ! __check_command_exists git; then - __apt_get_install_noinput git || return 1 - fi - - if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then - __apt_get_install_noinput ca-certificates - fi - - __git_clone_and_checkout || return 1 - - # Let's trigger config_salt() - if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" - CONFIG_SALT_FUNC="config_salt" - fi -} - install_debian_git_deps() { - install_debian_deps || return 1 - install_debian_git_pre || return 1 - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - PY_PKG_VER=3 - else - PY_PKG_VER="" - fi + echodebug "install_debian_git_deps() entry" - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - __PACKAGES="libzmq3 libzmq3-dev lsb-release python-apt python-backports.ssl-match-hostname" - __PACKAGES="${__PACKAGES} python-crypto python-jinja2 python-msgpack python-m2crypto" - __PACKAGES="${__PACKAGES} python-requests python-tornado python-yaml python-zmq" - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - # Install python-libcloud if asked to - __PACKAGES="${__PACKAGES} python-libcloud" - fi - - # shellcheck disable=SC2086 - __apt_get_install_noinput ${__PACKAGES} || return 1 - else - __PACKAGES="python${PY_PKG_VER}-dev python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" - echodebug "install_debian_git_deps() Installing ${__PACKAGES}" - # shellcheck disable=SC2086 - __apt_get_install_noinput ${__PACKAGES} || return 1 - fi - - return 0 -} - -install_debian_7_git_deps() { - install_debian_deps || return 1 - install_debian_git_deps || return 1 - - return 0 -} - -install_debian_8_git_deps() { - - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - echodebug "CALLING install_debian_git_deps" - install_debian_git_deps || return 1 - return 0 - fi - - install_debian_deps || return 1 + __wait_for_apt apt-get update || return 1 if ! __check_command_exists git; then - __apt_get_install_noinput git || return 1 + __apt_get_install_noinput git-core || return 1 fi if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then @@ -3901,124 +3619,28 @@ install_debian_8_git_deps() { __git_clone_and_checkout || return 1 - __PACKAGES="libzmq3 libzmq3-dev lsb-release python-apt python-crypto python-jinja2" - __PACKAGES="${__PACKAGES} python-m2crypto python-msgpack python-requests python-systemd" - __PACKAGES="${__PACKAGES} python-yaml python-zmq python-concurrent.futures" - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - # Install python-libcloud if asked to - __PACKAGES="${__PACKAGES} python-libcloud" + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi - __PIP_PACKAGES='' - if (__check_pip_allowed >/dev/null 2>&1); then - __PIP_PACKAGES='tornado<5.0' - # Install development environment for building tornado Python module - __PACKAGES="${__PACKAGES} build-essential python-dev" - - if ! __check_command_exists pip; then - __PACKAGES="${__PACKAGES} python-pip" - fi - # Attempt to configure backports repo on non-x86_64 system - elif [ $_DISABLE_REPOS -eq $BS_FALSE ] && [ "$DPKG_ARCHITECTURE" != "amd64" ]; then - # Check if Debian Backports repo already configured - if ! apt-cache policy | grep -q 'Debian Backports'; then - echo 'deb http://httpredir.debian.org/debian jessie-backports main' > \ - /etc/apt/sources.list.d/backports.list - fi - - __wait_for_apt apt-get update || return 1 - - # python-tornado package should be installed from backports repo - __PACKAGES="${__PACKAGES} python-backports.ssl-match-hostname python-tornado/jessie-backports" - else - __PACKAGES="${__PACKAGES} python-backports.ssl-match-hostname python-tornado" - fi + __PACKAGES="python${PY_PKG_VER}-dev python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" + echodebug "install_debian_git_deps() Installing ${__PACKAGES}" # shellcheck disable=SC2086 __apt_get_install_noinput ${__PACKAGES} || return 1 - if [ "${__PIP_PACKAGES}" != "" ]; then - # shellcheck disable=SC2086,SC2090 - pip install -U ${__PIP_PACKAGES} || return 1 - fi - # Let's trigger config_salt() if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" CONFIG_SALT_FUNC="config_salt" fi return 0 } -install_debian_9_git_deps() { - - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - install_debian_git_deps || return 1 - return 0 - fi - - install_debian_deps || return 1 - install_debian_git_pre || return 1 - - __PACKAGES="libzmq5 lsb-release" - - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - PY_PKG_VER=3 - else - PY_PKG_VER="" - - # These packages are PY2-ONLY - __PACKAGES="${__PACKAGES} python-backports-abc python-m2crypto python-concurrent.futures" - fi - - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-apt python${PY_PKG_VER}-crypto python${PY_PKG_VER}-jinja2" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-msgpack python${PY_PKG_VER}-requests python${PY_PKG_VER}-systemd" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-tornado python${PY_PKG_VER}-yaml python${PY_PKG_VER}-zmq" - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - # Install python-libcloud if asked to - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-libcloud" - fi - - # shellcheck disable=SC2086 - __apt_get_install_noinput ${__PACKAGES} || return 1 - - return 0 -} - -install_debian_10_git_deps() { - - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - install_debian_git_deps || return 1 - return 0 - fi - - install_debian_deps || return 1 - install_debian_git_pre || return 1 - - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - _py=${_PY_EXE} - PY_PKG_VER=3 - __PACKAGES="python${PY_PKG_VER}-distutils" - else - _py="python" - PY_PKG_VER="" - __PACKAGES="" - fi - - __install_tornado_pip ${_py}|| return 1 - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-msgpack python${PY_PKG_VER}-jinja2" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-tornado python${PY_PKG_VER}-yaml python${PY_PKG_VER}-zmq" - - # shellcheck disable=SC2086 - __apt_get_install_noinput ${__PACKAGES} || return 1 - - return 0 -} - install_debian_stable() { + __PACKAGES="" if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ];then @@ -4034,81 +3656,70 @@ install_debian_stable() { __PACKAGES="${__PACKAGES} salt-syndic" fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api" + fi + # shellcheck disable=SC2086 __apt_get_install_noinput ${__PACKAGES} || return 1 return 0 } -install_debian_7_stable() { - install_debian_stable || return 1 +install_debian_11_git_deps() { + + install_debian_git_deps || return 1 return 0 } -install_debian_8_stable() { - install_debian_stable || return 1 - return 0 -} +install_debian_12_git_deps() { -install_debian_9_stable() { - install_debian_stable || return 1 + install_debian_git_deps || return 1 return 0 } install_debian_git() { + if [ -n "$_PY_EXE" ]; then _PYEXE=${_PY_EXE} else - _PYEXE=python + ## _PYEXE=python + echoerror "Python 2 is no longer supported, only Py3 packages" + return 1 fi - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - # We can use --prefix on debian based ditributions - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - _POST_NEON_PIP_INSTALL_ARGS="--target=/usr/lib/python3/dist-packages --install-option=--install-scripts=/usr/bin" - else - _POST_NEON_PIP_INSTALL_ARGS="--target=/usr/lib/python2.7/dist-packages --install-option=--install-scripts=/usr/bin" - fi - _POST_NEON_PIP_INSTALL_ARGS="" - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - cd "${_SALT_GIT_CHECKOUT_DIR}" || return 1 + # We can use --prefix on debian based ditributions - # Account for new path for services files in later releases - if [ -d "pkg/common" ]; then - _SERVICE_DIR="pkg/common" - else - _SERVICE_DIR="pkg" - fi + _PIP_INSTALL_ARGS="" - sed -i 's:/usr/bin:/usr/local/bin:g' ${_SERVICE_DIR}/*.service - return 0 - fi + __install_salt_from_repo "${_PY_EXE}" || return 1 + cd "${_SALT_GIT_CHECKOUT_DIR}" || return 1 - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/salt/syspaths.py" ]; then - # shellcheck disable=SC2086 - "${_PYEXE}" setup.py --salt-config-dir="$_SALT_ETC_DIR" --salt-cache-dir="${_SALT_CACHE_DIR}" ${SETUP_PY_INSTALL_ARGS} install --install-layout=deb || return 1 + # Account for new path for services files in later releases + if [ -d "pkg/common" ]; then + _SERVICE_DIR="pkg/common" else - # shellcheck disable=SC2086 - "${_PYEXE}" setup.py ${SETUP_PY_INSTALL_ARGS} install --install-layout=deb || return 1 + _SERVICE_DIR="pkg" fi + + sed -i 's:/usr/bin:/usr/local/bin:g' "${_SERVICE_DIR}"/*.service + return 0 } -install_debian_7_git() { +install_debian_11_git() { + install_debian_git || return 1 return 0 } -install_debian_8_git() { - install_debian_git || return 1 - return 0 -} +install_debian_12_git() { -install_debian_9_git() { install_debian_git || return 1 return 0 } install_debian_onedir() { + __PACKAGES="" if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ];then @@ -4124,6 +3735,10 @@ install_debian_onedir() { __PACKAGES="${__PACKAGES} salt-syndic" fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api" + fi + # shellcheck disable=SC2086 __apt_get_install_noinput ${__PACKAGES} || return 1 @@ -4131,6 +3746,7 @@ install_debian_onedir() { } install_debian_git_post() { + for fname in api master minion syndic; do # Skip if not meant to be installed [ "$fname" = "api" ] && \ @@ -4147,7 +3763,7 @@ install_debian_git_post() { fi # Configure SystemD for Debian 8 "Jessie" and later - if [ -f /bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then if [ ! -f /lib/systemd/system/salt-${fname}.service ] || \ { [ -f /lib/systemd/system/salt-${fname}.service ] && [ $_FORCE_OVERWRITE -eq $BS_TRUE ]; }; then if [ -f "${_SERVICE_DIR}/salt-${fname}.service" ]; then @@ -4165,29 +3781,12 @@ install_debian_git_post() { /bin/systemctl enable "salt-${fname}.service" SYSTEMD_RELOAD=$BS_TRUE - - # Install initscripts for Debian 7 "Wheezy" - elif [ ! -f "/etc/init.d/salt-$fname" ] || \ - { [ -f "/etc/init.d/salt-$fname" ] && [ "$_FORCE_OVERWRITE" -eq $BS_TRUE ]; }; then - __copyfile "${_SALT_GIT_CHECKOUT_DIR}/pkg/deb/salt-${fname}.init" "/etc/init.d/salt-${fname}" - __copyfile "${_SALT_GIT_CHECKOUT_DIR}/pkg/deb/salt-${fname}.environment" "/etc/default/salt-${fname}" - - if [ ! -f "/etc/init.d/salt-${fname}" ]; then - echowarn "The init script for salt-${fname} was not found, skipping it..." - continue - fi - - chmod +x "/etc/init.d/salt-${fname}" - - # Skip salt-api since the service should be opt-in and not necessarily started on boot - [ "$fname" = "api" ] && continue - - update-rc.d "salt-${fname}" defaults fi done } install_debian_2021_post() { + # Kali 2021 (debian derivative) disables all network services by default # Using archlinux post function to enable salt systemd services install_arch_linux_post || return 1 @@ -4195,6 +3794,7 @@ install_debian_2021_post() { } install_debian_restart_daemons() { + [ "$_START_DAEMONS" -eq $BS_FALSE ] && return 0 for fname in api master minion syndic; do @@ -4206,8 +3806,8 @@ install_debian_restart_daemons() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /bin/systemctl ]; then - # Debian 8 uses systemd + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then + # Debian 8 and above uses systemd /bin/systemctl stop salt-$fname > /dev/null 2>&1 /bin/systemctl start salt-$fname.service && continue if [ "$_ECHO_DEBUG" -eq $BS_TRUE ]; then @@ -4223,6 +3823,7 @@ install_debian_restart_daemons() { } install_debian_check_services() { + for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot [ $fname = "api" ] && continue @@ -4232,7 +3833,7 @@ install_debian_check_services() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then __check_services_systemd salt-$fname || return 1 elif [ -f /etc/init.d/salt-$fname ]; then __check_services_debian salt-$fname || return 1 @@ -4251,54 +3852,55 @@ install_debian_check_services() { # __install_saltstack_fedora_onedir_repository() { - if [ "$ITYPE" = "stable" ]; then - REPO_REV="$ONEDIR_REV" - else - REPO_REV="latest" + + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi - __PY_VERSION_REPO="yum" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PY_VERSION_REPO="py3" - fi - - GPG_KEY="SALT-PROJECT-GPG-PUBKEY-2023.pub" - - REPO_FILE="/etc/yum.repos.d/salt.repo" - - if [ ! -s "$REPO_FILE" ] || [ "$_FORCE_OVERWRITE" -eq $BS_TRUE ]; then - FETCH_URL="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_DIR}/${__PY_VERSION_REPO}/fedora/${DISTRO_MAJOR_VERSION}/${CPU_ARCH_L}/${ONEDIR_REV}" - if [ "${ONEDIR_REV}" = "nightly" ] ; then - FETCH_URL="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_NIGHTLY_DIR}/${__PY_VERSION_REPO}/fedora/${DISTRO_MAJOR_VERSION}/${CPU_ARCH_L}/" + if [ ! -s "$YUM_REPO_FILE" ] || [ "$_FORCE_OVERWRITE" -eq $BS_TRUE ]; then + FETCH_URL="https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.repo" + __fetch_url "${YUM_REPO_FILE}" "${FETCH_URL}" + if [ "$ONEDIR_REV" != "latest" ]; then + # 3006.x is default + REPO_REV_MAJOR=$(echo "$ONEDIR_REV" | cut -d '.' -f 1) + if [ "$REPO_REV_MAJOR" -eq "3007" ]; then + # Enable the Salt 3007 STS repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-3007-sts + fi + else + # Enable the Salt LATEST repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-latest fi + dnf clean expire-cache || return 1 - __fetch_url "${REPO_FILE}" "${FETCH_URL}.repo" - - __rpm_import_gpg "${FETCH_URL}/${GPG_KEY}" || return 1 - - yum clean metadata || return 1 - elif [ "$REPO_REV" != "latest" ]; then + elif [ "$ONEDIR_REV" != "latest" ]; then echowarn "salt.repo already exists, ignoring salt version argument." - echowarn "Use -F (forced overwrite) to install $REPO_REV." + echowarn "Use -F (forced overwrite) to install $ONEDIR_REV." fi return 0 } install_fedora_deps() { + if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then dnf -y update || return 1 fi __PACKAGES="${__PACKAGES:=}" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -lt 3 ]; then - echoerror "There are no Python 2 stable packages for Fedora, only Py3 packages" + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" return 1 fi # Salt on Fedora is Py3 PY_PKG_VER=3 + ## find no dnf-utils in Fedora packaging archives and yum-utils EL7 and F30, none after + ## but find it on 8 and 9 Centos Stream __PACKAGES="${__PACKAGES} dnf-utils libyaml procps-ng python${PY_PKG_VER}-crypto python${PY_PKG_VER}-jinja2" __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-msgpack python${PY_PKG_VER}-requests python${PY_PKG_VER}-zmq" __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-pip python${PY_PKG_VER}-m2crypto python${PY_PKG_VER}-pyyaml" @@ -4313,84 +3915,11 @@ install_fedora_deps() { return 0 } -install_fedora_stable() { - if [ "$STABLE_REV" = "latest" ]; then - __SALT_VERSION="" - else - __SALT_VERSION="$(dnf list --showduplicates salt | grep "$STABLE_REV" | head -n 1 | awk '{print $2}')" - if [ "x${__SALT_VERSION}" = "x" ]; then - echoerror "Could not find a stable install for Salt ${STABLE_REV}" - exit 1 - fi - echoinfo "Installing Stable Package Version ${__SALT_VERSION}" - __SALT_VERSION="-${__SALT_VERSION}" - fi - __PACKAGES="" - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ];then - __PACKAGES="${__PACKAGES} salt-cloud${__SALT_VERSION}" - fi - if [ "$_INSTALL_MASTER" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} salt-master${__SALT_VERSION}" - fi - if [ "$_INSTALL_MINION" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} salt-minion${__SALT_VERSION}" - fi - if [ "$_INSTALL_SYNDIC" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} salt-syndic${__SALT_VERSION}" - fi - - # shellcheck disable=SC2086 - __dnf_install_noinput ${__PACKAGES} || return 1 - - __python="python3" - if ! __check_command_exists python3; then - echoerror "Could not find a python3 binary?!" - return 1 - fi - - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - __check_pip_allowed "You need to allow pip based installations (-P) for Tornado <5.0 in order to install Salt" - __installed_tornado_rpm=$(rpm -qa | grep python${PY_PKG_VER}-tornado) - if [ -n "${__installed_tornado_rpm}" ]; then - echodebug "Removing system package ${__installed_tornado_rpm}" - rpm -e --nodeps "${__installed_tornado_rpm}" || return 1 - fi - __get_site_packages_dir_code=$(cat << EOM -import site -print([d for d in site.getsitepackages() if d.startswith('/usr/lib/python')][0]) -EOM -) - __target_path=$(${__python} -c "${__get_site_packages_dir_code}") - echodebug "Running '${__python}' -m pip install --target ${__target_path} 'tornado<5.0'" - "${__python}" -m pip install --target "${__target_path}" "tornado<5" || return 1 - fi - - return 0 -} - -install_fedora_stable_post() { - for fname in api master minion syndic; do - # Skip salt-api since the service should be opt-in and not necessarily started on boot - [ $fname = "api" ] && continue - - # Skip if not meant to be installed - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - - systemctl is-enabled salt-$fname.service || (systemctl preset salt-$fname.service && systemctl enable salt-$fname.service) - sleep 1 - systemctl daemon-reload - done -} - install_fedora_git_deps() { - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - # Packages are named python3- - PY_PKG_VER=3 - else - PY_PKG_VER=2 + + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi __PACKAGES="" @@ -4409,79 +3938,40 @@ install_fedora_git_deps() { __git_clone_and_checkout || return 1 - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - - if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then - __PACKAGES="${__PACKAGES} ca-certificates" - fi - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-libcloud python${PY_PKG_VER}-netaddr" - fi - - install_fedora_deps || return 1 - - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - if __check_command_exists python3; then - __python="python3" - fi - elif [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 2 ]; then - if __check_command_exists python2; then - __python="python2" - fi - else - if ! __check_command_exists python; then - echoerror "Unable to find a python binary?!" - return 1 - fi - # Let's hope it's the right one - __python="python" - fi - - grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" | while IFS=' - ' read -r dep; do - echodebug "Running '${__python}' -m pip install '${dep}'" - "${__python}" -m pip install "${dep}" || return 1 - done - else - __PACKAGES="python${PY_PKG_VER}-devel python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" - if [ "${DISTRO_VERSION}" -ge 35 ]; then - __PACKAGES="${__PACKAGES} gcc-c++" - fi - # shellcheck disable=SC2086 - __dnf_install_noinput ${__PACKAGES} || return 1 - fi + __PACKAGES="python${PY_PKG_VER}-devel python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc gcc-c++" + # shellcheck disable=SC2086 + __dnf_install_noinput ${__PACKAGES} || return 1 # Let's trigger config_salt() if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" CONFIG_SALT_FUNC="config_salt" fi + _fedora_dep="contextvars" + echodebug "Running '${_PY_EXE} -m pip install --upgrade ${_fedora_dep}'" + ${_PY_EXE} -m pip install --upgrade "${_fedora_dep}" + return 0 } install_fedora_git() { + if [ "${_PY_EXE}" != "" ]; then _PYEXE=${_PY_EXE} echoinfo "Using the following python version: ${_PY_EXE} to install salt" else - _PYEXE='python2' + echoerror "Python 2 is no longer supported, only Py3 packages" + return 1 fi - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - return 0 - fi - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/salt/syspaths.py" ]; then - ${_PYEXE} setup.py --salt-config-dir="$_SALT_ETC_DIR" --salt-cache-dir="${_SALT_CACHE_DIR}" ${SETUP_PY_INSTALL_ARGS} install --prefix=/usr || return 1 - else - ${_PYEXE} setup.py ${SETUP_PY_INSTALL_ARGS} install --prefix=/usr || return 1 - fi + __install_salt_from_repo "${_PY_EXE}" || return 1 return 0 + } install_fedora_git_post() { + for fname in api master minion syndic; do # Skip if not meant to be installed [ $fname = "api" ] && \ @@ -4509,10 +3999,12 @@ install_fedora_git_post() { systemctl is-enabled salt-$fname.service || (systemctl preset salt-$fname.service && systemctl enable salt-$fname.service) sleep 1 systemctl daemon-reload + done } install_fedora_restart_daemons() { + [ $_START_DAEMONS -eq $BS_FALSE ] && return for fname in api master minion syndic; do @@ -4535,6 +4027,7 @@ install_fedora_restart_daemons() { } install_fedora_check_services() { + for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot [ $fname = "api" ] && continue @@ -4567,19 +4060,13 @@ install_fedora_onedir_deps() { fi # If -R was passed, we need to configure custom repo url with rsync-ed packages - # Which is still handled in __install_saltstack_rhel_repository. This call has + # Which is still handled in __install_saltstack_rhel_onedir_repository. This call has # its own check in case -r was passed without -R. if [ "$_CUSTOM_REPO_URL" != "null" ]; then __install_saltstack_fedora_onedir_repository || return 1 fi - if [ "$DISTRO_MAJOR_VERSION" -ge 8 ]; then - __PACKAGES="dnf-utils chkconfig" - else - __PACKAGES="yum-utils chkconfig" - fi - - __PACKAGES="${__PACKAGES} procps" + __PACKAGES="dnf-utils chkconfig procps-ng" # shellcheck disable=SC2086 __yum_install_noinput ${__PACKAGES} || return 1 @@ -4596,6 +4083,7 @@ install_fedora_onedir_deps() { install_fedora_onedir() { + STABLE_REV=$ONEDIR_REV #install_fedora_stable || return 1 @@ -4614,6 +4102,10 @@ install_fedora_onedir() { __PACKAGES="${__PACKAGES} salt-syndic" fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api" + fi + # shellcheck disable=SC2086 __yum_install_noinput ${__PACKAGES} || return 1 @@ -4621,11 +4113,26 @@ install_fedora_onedir() { } install_fedora_onedir_post() { + STABLE_REV=$ONEDIR_REV - install_fedora_stable_post || return 1 + + for fname in api master minion syndic; do + # Skip salt-api since the service should be opt-in and not necessarily started on boot + [ $fname = "api" ] && continue + + # Skip if not meant to be installed + [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue + [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue + [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue + + systemctl is-enabled salt-$fname.service || (systemctl preset salt-$fname.service && systemctl enable salt-$fname.service) + sleep 1 + systemctl daemon-reload + done return 0 } + # # Ended Fedora Install Functions # @@ -4635,133 +4142,40 @@ install_fedora_onedir_post() { # # CentOS Install Functions # -__install_saltstack_rhel_repository() { - if [ "${DISTRO_MAJOR_VERSION}" -ge 9 ]; then - echoerror "Old stable repository unavailable on RH variants greater than or equal to 9" - echoerror "Use the stable install type." - exit 1 - fi - - if [ "$ITYPE" = "stable" ]; then - repo_rev="$STABLE_REV" - else - repo_rev="latest" - fi - - __PY_VERSION_REPO="yum" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PY_VERSION_REPO="py3" - fi - - # Avoid using '$releasever' variable for yum. - # Instead, this should work correctly on all RHEL variants. - base_url="${HTTP_VAL}://${_REPO_URL}/${__PY_VERSION_REPO}/redhat/${DISTRO_MAJOR_VERSION}/\$basearch/${repo_rev}/" - if [ "${DISTRO_MAJOR_VERSION}" -eq 7 ]; then - gpg_key="SALTSTACK-GPG-KEY.pub base/RPM-GPG-KEY-CentOS-7" - elif [ "${DISTRO_MAJOR_VERSION}" -ge 9 ]; then - gpg_key="SALTSTACK-GPG-KEY2.pub" - else - gpg_key="SALTSTACK-GPG-KEY.pub" - fi - - gpg_key_urls="" - for key in $gpg_key; do - gpg_key_urls=$(printf "${base_url}${key},%s" "$gpg_key_urls") - done - - repo_file="/etc/yum.repos.d/salt.repo" - - if [ ! -s "$repo_file" ] || [ "$_FORCE_OVERWRITE" -eq $BS_TRUE ]; then - cat <<_eof > "$repo_file" -[saltstack] -name=SaltStack ${repo_rev} Release Channel for RHEL/CentOS \$releasever -baseurl=${base_url} -skip_if_unavailable=True -gpgcheck=1 -gpgkey=${gpg_key_urls} -enabled=1 -enabled_metadata=1 -_eof - - fetch_url="${HTTP_VAL}://${_REPO_URL}/${__PY_VERSION_REPO}/redhat/${DISTRO_MAJOR_VERSION}/${CPU_ARCH_L}/${repo_rev}/" - for key in $gpg_key; do - __rpm_import_gpg "${fetch_url}${key}" || return 1 - done - - yum clean metadata || return 1 - elif [ "$repo_rev" != "latest" ]; then - echowarn "salt.repo already exists, ignoring salt version argument." - echowarn "Use -F (forced overwrite) to install $repo_rev." - fi - - return 0 -} - __install_saltstack_rhel_onedir_repository() { - if [ "$ITYPE" = "stable" ]; then - repo_rev="$ONEDIR_REV" - else - repo_rev="latest" + + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi - __PY_VERSION_REPO="yum" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PY_VERSION_REPO="py3" - fi - - # Avoid using '$releasever' variable for yum. - # Instead, this should work correctly on all RHEL variants. - base_url="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_DIR}/${__PY_VERSION_REPO}/redhat/${DISTRO_MAJOR_VERSION}/\$basearch/${ONEDIR_REV}/" - if [ "${ONEDIR_REV}" = "nightly" ] ; then - base_url="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_NIGHTLY_DIR}/${__PY_VERSION_REPO}/redhat/${DISTRO_MAJOR_VERSION}/\$basearch/" - fi - if [ "$(echo "${ONEDIR_REV}" | grep -E '(3004|3005)')" != "" ] || [ "${ONEDIR_REV}" = "nightly" ]; then - if [ "${DISTRO_MAJOR_VERSION}" -eq 9 ]; then - gpg_key="SALTSTACK-GPG-KEY2.pub" - else - gpg_key="SALTSTACK-GPG-KEY.pub" - fi - else - gpg_key="SALT-PROJECT-GPG-PUBKEY-2023.pub" - fi - - gpg_key_urls="" - for key in $gpg_key; do - gpg_key_urls=$(printf "${base_url}${key},%s" "$gpg_key_urls") - done - - repo_file="/etc/yum.repos.d/salt.repo" - - if [ ! -s "$repo_file" ] || [ "$_FORCE_OVERWRITE" -eq $BS_TRUE ]; then - cat <<_eof > "$repo_file" -[saltstack] -name=SaltStack ${repo_rev} Release Channel for RHEL/CentOS \$releasever -baseurl=${base_url} -skip_if_unavailable=True -gpgcheck=1 -gpgkey=${gpg_key_urls} -enabled=1 -enabled_metadata=1 -_eof - - fetch_url="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_DIR}/${__PY_VERSION_REPO}/redhat/${DISTRO_MAJOR_VERSION}/${CPU_ARCH_L}/${ONEDIR_REV}/" - if [ "${ONEDIR_REV}" = "nightly" ] ; then - fetch_url="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_NIGHTLY_DIR}/${__PY_VERSION_REPO}/redhat/${DISTRO_MAJOR_VERSION}/${CPU_ARCH_L}/" + if [ ! -s "$YUM_REPO_FILE" ] || [ "$_FORCE_OVERWRITE" -eq $BS_TRUE ]; then + FETCH_URL="https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.repo" + __fetch_url "${YUM_REPO_FILE}" "${FETCH_URL}" + if [ "$ONEDIR_REV" != "latest" ]; then + # 3006.x is default + REPO_REV_MAJOR=$(echo "$ONEDIR_REV" | cut -d '.' -f 1) + if [ "$REPO_REV_MAJOR" -eq "3007" ]; then + # Enable the Salt 3007 STS repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-3007-sts + fi + else + # Enable the Salt LATEST repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-latest fi - for key in $gpg_key; do - __rpm_import_gpg "${fetch_url}${key}" || return 1 - done - - yum clean metadata || return 1 - elif [ "$repo_rev" != "latest" ]; then + dnf clean expire-cache || return 1 + elif [ "$ONEDIR_REV" != "latest" ]; then echowarn "salt.repo already exists, ignoring salt version argument." - echowarn "Use -F (forced overwrite) to install $repo_rev." + echowarn "Use -F (forced overwrite) to install $ONEDIR_REV." fi return 0 } install_centos_stable_deps() { + if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then yum -y update || return 1 fi @@ -4773,48 +4187,18 @@ install_centos_stable_deps() { fi if [ "$_DISABLE_REPOS" -eq "$BS_FALSE" ]; then - __install_saltstack_rhel_repository || return 1 + echoerror "old-stable packages are no longer supported and are End-Of-Life." + return 1 fi # If -R was passed, we need to configure custom repo url with rsync-ed packages - # Which is still handled in __install_saltstack_rhel_repository. This call has + # Which is still handled in __install_saltstack_rhel_onedir_repository. This call has # its own check in case -r was passed without -R. if [ "$_CUSTOM_REPO_URL" != "null" ]; then - __install_saltstack_rhel_repository || return 1 + __install_saltstack_rhel_onedir_repository || return 1 fi - if [ "$DISTRO_MAJOR_VERSION" -ge 8 ]; then - __PACKAGES="dnf-utils chkconfig" - else - __PACKAGES="yum-utils chkconfig" - fi - - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - if [ "$DISTRO_MAJOR_VERSION" -ge 8 ]; then - # YAML module is used for generating custom master/minion configs - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PACKAGES="${__PACKAGES} python3-pyyaml python3-setuptools" - else - __PACKAGES="${__PACKAGES} python2-pyyaml" - fi - elif [ "$DISTRO_MAJOR_VERSION" -eq 7 ]; then - # YAML module is used for generating custom master/minion configs - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PACKAGES="${__PACKAGES} python36-PyYAML python36-setuptools" - else - __PACKAGES="${__PACKAGES} PyYAML" - fi - else - # YAML module is used for generating custom master/minion configs - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PACKAGES="${__PACKAGES} python34-PyYAML python34-setuptools" - else - __PACKAGES="${__PACKAGES} PyYAML" - fi - fi - fi - - __PACKAGES="${__PACKAGES} procps" + __PACKAGES="yum-utils chkconfig procps-ng findutils" # shellcheck disable=SC2086 __yum_install_noinput ${__PACKAGES} || return 1 @@ -4825,11 +4209,11 @@ install_centos_stable_deps() { __yum_install_noinput ${_EXTRA_PACKAGES} || return 1 fi - return 0 } install_centos_stable() { + __PACKAGES="" if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ];then @@ -4845,6 +4229,10 @@ install_centos_stable() { __PACKAGES="${__PACKAGES} salt-syndic" fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api" + fi + # shellcheck disable=SC2086 __yum_install_noinput ${__PACKAGES} || return 1 @@ -4859,6 +4247,7 @@ install_centos_stable() { } install_centos_stable_post() { + SYSTEMD_RELOAD=$BS_FALSE for fname in api master minion syndic; do @@ -4870,7 +4259,7 @@ install_centos_stable_post() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then /bin/systemctl is-enabled salt-${fname}.service > /dev/null 2>&1 || ( /bin/systemctl preset salt-${fname}.service > /dev/null 2>&1 && /bin/systemctl enable salt-${fname}.service > /dev/null 2>&1 @@ -4890,14 +4279,14 @@ install_centos_stable_post() { } install_centos_git_deps() { + # First try stable deps then fall back to onedir deps if that one fails # if we're installing on a Red Hat based host that doesn't have the classic # package repos available. # Set ONEDIR_REV to STABLE_REV in case we # end up calling install_centos_onedir_deps ONEDIR_REV=${STABLE_REV} - install_centos_onedir_deps || \ - return 1 + install_centos_onedir_deps || return 1 if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then __yum_install_noinput ca-certificates || return 1 @@ -4912,111 +4301,23 @@ install_centos_git_deps() { __PACKAGES="" if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - if [ "$DISTRO_MAJOR_VERSION" -ge 8 ]; then - # Packages are named python3- - PY_PKG_VER=3 - __PACKAGES="${__PACKAGES} python3" - else - # Packages are named python36- - PY_PKG_VER=36 - __PACKAGES="${__PACKAGES} python36" - fi + # Packages are named python3- + PY_PKG_VER=3 + __PACKAGES="${__PACKAGES} python3" else - PY_PKG_VER="" - if [ "$DISTRO_MAJOR_VERSION" -ge 8 ]; then - __PACKAGES="${__PACKAGES} python2" - elif [ "$DISTRO_MAJOR_VERSION" -eq 6 ]; then - PY_PKG_VER=27 - __PACKAGES="${__PACKAGES} python27" - else - __PACKAGES="${__PACKAGES} python" - fi + echoerror "Python 2 is no longer supported, only Python 3" + return 1 fi - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - _install_m2crypto_req=false - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - _py=${_PY_EXE} - if [ "$DISTRO_MAJOR_VERSION" -gt 6 ]; then - _install_m2crypto_req=true - fi - else - if [ "$DISTRO_MAJOR_VERSION" -eq 6 ]; then - _install_m2crypto_req=true - fi - _py="python" + __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-devel python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" - # Only Py2 needs python-futures - __PACKAGES="${__PACKAGES} python-futures" + # shellcheck disable=SC2086 + __yum_install_noinput ${__PACKAGES} || return 1 - # There is no systemd-python3 package as of this writing - if [ "$DISTRO_MAJOR_VERSION" -ge 7 ]; then - __PACKAGES="${__PACKAGES} systemd-python" - fi - fi - - if [ "$DISTRO_MAJOR_VERSION" -ge 8 ]; then - __install_tornado_pip ${_py} || return 1 - __PACKAGES="${__PACKAGES} python3-m2crypto" - else - __PACKAGES="${__PACKAGES} m2crypto python${PY_PKG_VER}-crypto" - fi - - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-jinja2" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-msgpack python${PY_PKG_VER}-requests" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-tornado python${PY_PKG_VER}-zmq" - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-libcloud" - fi - - if [ "${_INSTALL_PY}" -eq "${BS_TRUE}" ]; then - # Install Python if "-y" was passed in. - __install_python || return 1 - fi - - if [ "${_PY_EXE}" != "" ] && [ "$_PIP_ALLOWED" -eq "$BS_TRUE" ]; then - # If "-x" is defined, install dependencies with pip based on the Python version given. - _PIP_PACKAGES="m2crypto!=0.33.0 jinja2 msgpack-python pycrypto PyYAML tornado<5.0 zmq futures>=2.0" - - # install swig and openssl on cent6 - if $_install_m2crypto_req; then - __yum_install_noinput openssl-devel swig || return 1 - fi - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # Filter out any commented lines from the requirements file - _REQ_LINES="$(grep '^[^#]' "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - for SINGLE_PACKAGE in ${_PIP_PACKAGES}; do - __REQUIRED_VERSION="$(grep "${SINGLE_PACKAGE}" "${_REQ_LINES}")" - if [ "${__REQUIRED_VERSION}" != "" ]; then - _PIP_PACKAGES=$(echo "$_PIP_PACKAGES" | sed "s/${SINGLE_PACKAGE}/${__REQUIRED_VERSION}/") - fi - done - fi - - if [ "$_INSTALL_CLOUD" -eq "${BS_TRUE}" ]; then - _PIP_PACKAGES="${_PIP_PACKAGES} apache-libcloud" - fi - - __install_pip_pkgs "${_PIP_PACKAGES}" "${_PY_EXE}" || return 1 - else - # shellcheck disable=SC2086 - __yum_install_noinput ${__PACKAGES} || return 1 - fi - else - if [ "${_INSTALL_PY}" -eq "${BS_TRUE}" ] && [ "$DISTRO_MAJOR_VERSION" -lt 8 ]; then - # Install Python if "-y" was passed in. - __install_python || return 1 - fi - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-devel python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" - # shellcheck disable=SC2086 - __yum_install_noinput ${__PACKAGES} || return 1 - fi # Let's trigger config_salt() if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" CONFIG_SALT_FUNC="config_salt" fi @@ -5024,29 +4325,23 @@ install_centos_git_deps() { } install_centos_git() { + if [ "${_PY_EXE}" != "" ]; then _PYEXE=${_PY_EXE} echoinfo "Using the following python version: ${_PY_EXE} to install salt" else - _PYEXE='python2' + echoerror "Python 2 is no longer supported, only Python 3" + return 1 fi echodebug "_PY_EXE: $_PY_EXE" - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - return 0 - fi - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/salt/syspaths.py" ]; then - $_PYEXE setup.py --salt-config-dir="$_SALT_ETC_DIR" --salt-cache-dir="${_SALT_CACHE_DIR}" ${SETUP_PY_INSTALL_ARGS} install --prefix=/usr || return 1 - else - $_PYEXE setup.py ${SETUP_PY_INSTALL_ARGS} install --prefix=/usr || return 1 - fi + __install_salt_from_repo "${_PY_EXE}" || return 1 return 0 } install_centos_git_post() { + SYSTEMD_RELOAD=$BS_FALSE for fname in api master minion syndic; do @@ -5063,7 +4358,8 @@ install_centos_git_post() { else _SERVICE_FILE="${_SALT_GIT_CHECKOUT_DIR}/pkg/rpm/salt-${fname}.service" fi - if [ -f /bin/systemctl ]; then + + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then if [ ! -f "/usr/lib/systemd/system/salt-${fname}.service" ] || \ { [ -f "/usr/lib/systemd/system/salt-${fname}.service" ] && [ "$_FORCE_OVERWRITE" -eq $BS_TRUE ]; }; then __copyfile "${_SERVICE_FILE}" /usr/lib/systemd/system @@ -5087,7 +4383,8 @@ install_centos_git_post() { } install_centos_onedir_deps() { - if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then + + if [ "$_UPGRADE_SYS" -eq "$BS_TRUE" ]; then yum -y update || return 1 fi @@ -5102,19 +4399,13 @@ install_centos_onedir_deps() { fi # If -R was passed, we need to configure custom repo url with rsync-ed packages - # Which is still handled in __install_saltstack_rhel_repository. This call has - # its own check in case -r was passed without -R. + # Which was still handled in __install_saltstack_rhel_repository, which was for old-stable which + # is removed since End-Of-Life. This call has its own check in case -r was passed without -R. if [ "$_CUSTOM_REPO_URL" != "null" ]; then __install_saltstack_rhel_onedir_repository || return 1 fi - if [ "$DISTRO_MAJOR_VERSION" -ge 8 ]; then - __PACKAGES="dnf-utils chkconfig" - else - __PACKAGES="yum-utils chkconfig" - fi - - __PACKAGES="${__PACKAGES} procps" + __PACKAGES="yum-utils chkconfig procps-ng findutils" # shellcheck disable=SC2086 __yum_install_noinput ${__PACKAGES} || return 1 @@ -5125,48 +4416,39 @@ install_centos_onedir_deps() { __yum_install_noinput ${_EXTRA_PACKAGES} || return 1 fi - return 0 } -# This function has been modified to allow for specific versions to be installed -# when not using the salt repo install_centos_onedir() { + yum clean metadata + yum makecache + __PACKAGES="" - local cloud='salt-cloud' - local master='salt-master' - local minion='salt-minion' - local syndic='salt-syndic' - local ver="$_ONEDIR_REV" - - if [ ! -z $ver ]; then - cloud+="-$ver" - master+="-$ver" - minion+="-$ver" - syndic+="-$ver" - fi - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ];then - __PACKAGES="${__PACKAGES} $cloud" + __PACKAGES="${__PACKAGES} salt-cloud-${STABLE_REV}" fi if [ "$_INSTALL_MASTER" -eq $BS_TRUE ];then - __PACKAGES="${__PACKAGES} $master" + __PACKAGES="${__PACKAGES} salt-master-${STABLE_REV}" fi if [ "$_INSTALL_MINION" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} $minion" + __PACKAGES="${__PACKAGES} salt-minion-${STABLE_REV}" fi if [ "$_INSTALL_SYNDIC" -eq $BS_TRUE ];then - __PACKAGES="${__PACKAGES} $syndic" + __PACKAGES="${__PACKAGES} salt-syndic-${STABLE_REV}" + fi + + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api-${STABLE_REV}" fi # shellcheck disable=SC2086 __yum_install_noinput ${__PACKAGES} || return 1 - return 0 } install_centos_onedir_post() { + SYSTEMD_RELOAD=$BS_FALSE for fname in api master minion syndic; do @@ -5178,7 +4460,7 @@ install_centos_onedir_post() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then /bin/systemctl is-enabled salt-${fname}.service > /dev/null 2>&1 || ( /bin/systemctl preset salt-${fname}.service > /dev/null 2>&1 && /bin/systemctl enable salt-${fname}.service > /dev/null 2>&1 @@ -5198,7 +4480,8 @@ install_centos_onedir_post() { } install_centos_restart_daemons() { - [ $_START_DAEMONS -eq $BS_FALSE ] && return + + [ "$_START_DAEMONS" -eq $BS_FALSE ] && return for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot @@ -5209,26 +4492,11 @@ install_centos_restart_daemons() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /sbin/initctl ] && [ -f /etc/init/salt-${fname}.conf ]; then - # We have upstart support and upstart knows about our service - if ! /sbin/initctl status salt-$fname > /dev/null 2>&1; then - # Everything is in place and upstart gave us an error code? Fail! - return 1 - fi - - # upstart knows about this service. - # Let's try to stop it, and then start it - /sbin/initctl stop salt-$fname > /dev/null 2>&1 - # Restart service - if ! /sbin/initctl start salt-$fname > /dev/null 2>&1; then - # Failed the restart?! - return 1 - fi - elif [ -f /etc/init.d/salt-$fname ]; then + if [ -f /etc/init.d/salt-$fname ]; then # Disable stdin to fix shell session hang on killing tee pipe service salt-$fname stop < /dev/null > /dev/null 2>&1 service salt-$fname start < /dev/null - elif [ -f /usr/bin/systemctl ]; then + elif [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then # CentOS 7 uses systemd /usr/bin/systemctl stop salt-$fname > /dev/null 2>&1 /usr/bin/systemctl start salt-$fname.service && continue @@ -5242,21 +4510,25 @@ install_centos_restart_daemons() { } install_centos_testing_deps() { + install_centos_stable_deps || return 1 return 0 } install_centos_testing() { + install_centos_stable || return 1 return 0 } install_centos_testing_post() { + install_centos_stable_post || return 1 return 0 } install_centos_check_services() { + for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot [ $fname = "api" ] && continue @@ -5266,12 +4538,10 @@ install_centos_check_services() { [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /sbin/initctl ] && [ -f /etc/init/salt-${fname}.conf ]; then - __check_services_upstart salt-$fname || return 1 - elif [ -f /etc/init.d/salt-$fname ]; then - __check_services_sysvinit salt-$fname || return 1 - elif [ -f /usr/bin/systemctl ]; then - __check_services_systemd salt-$fname || return 1 + if [ -f "/etc/init.d/salt-$fname" ]; then + __check_services_sysvinit "salt-$fname" || return 1 + elif [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then + __check_services_systemd "salt-$fname" || return 1 fi done @@ -5287,286 +4557,343 @@ install_centos_check_services() { # RedHat Install Functions # install_red_hat_linux_stable_deps() { + install_centos_stable_deps || return 1 return 0 } install_red_hat_linux_git_deps() { + install_centos_git_deps || return 1 return 0 } install_red_hat_linux_onedir_deps() { + install_centos_onedir_deps || return 1 return 0 } install_red_hat_enterprise_stable_deps() { + install_red_hat_linux_stable_deps || return 1 return 0 } install_red_hat_enterprise_git_deps() { + install_red_hat_linux_git_deps || return 1 return 0 } install_red_hat_enterprise_onedir_deps() { + install_red_hat_linux_onedir_deps || return 1 return 0 } install_red_hat_enterprise_linux_stable_deps() { + install_red_hat_linux_stable_deps || return 1 return 0 } install_red_hat_enterprise_linux_git_deps() { + install_red_hat_linux_git_deps || return 1 return 0 } install_red_hat_enterprise_linux_onedir_deps() { + install_red_hat_linux_onedir_deps || return 1 return 0 } install_red_hat_enterprise_server_stable_deps() { + install_red_hat_linux_stable_deps || return 1 return 0 } install_red_hat_enterprise_server_git_deps() { + install_red_hat_linux_git_deps || return 1 return 0 } install_red_hat_enterprise_server_onedir_deps() { + install_red_hat_linux_onedir_deps || return 1 return 0 } install_red_hat_enterprise_workstation_stable_deps() { + install_red_hat_linux_stable_deps || return 1 return 0 } install_red_hat_enterprise_workstation_git_deps() { + install_red_hat_linux_git_deps || return 1 return 0 } install_red_hat_enterprise_workstation_onedir_deps() { + install_red_hat_linux_timat_deps || return 1 return 0 } install_red_hat_linux_stable() { + install_centos_stable || return 1 return 0 } install_red_hat_linux_git() { + install_centos_git || return 1 return 0 } install_red_hat_linux_onedir() { + install_centos_onedir || return 1 return 0 } install_red_hat_enterprise_stable() { + install_red_hat_linux_stable || return 1 return 0 } install_red_hat_enterprise_git() { + install_red_hat_linux_git || return 1 return 0 } install_red_hat_enterprise_onedir() { + install_red_hat_linux_onedir || return 1 return 0 } install_red_hat_enterprise_linux_stable() { + install_red_hat_linux_stable || return 1 return 0 } install_red_hat_enterprise_linux_git() { + install_red_hat_linux_git || return 1 return 0 } install_red_hat_enterprise_linux_onedir() { + install_red_hat_linux_onedir || return 1 return 0 } install_red_hat_enterprise_server_stable() { + install_red_hat_linux_stable || return 1 return 0 } install_red_hat_enterprise_server_git() { + install_red_hat_linux_git || return 1 return 0 } install_red_hat_enterprise_server_onedir() { + install_red_hat_linux_onedir || return 1 return 0 } install_red_hat_enterprise_workstation_stable() { + install_red_hat_linux_stable || return 1 return 0 } install_red_hat_enterprise_workstation_git() { + install_red_hat_linux_git || return 1 return 0 } install_red_hat_enterprise_workstation_onedir() { + install_red_hat_linux_onedir || return 1 return 0 } install_red_hat_linux_stable_post() { + install_centos_stable_post || return 1 return 0 } install_red_hat_linux_restart_daemons() { + install_centos_restart_daemons || return 1 return 0 } install_red_hat_linux_git_post() { + install_centos_git_post || return 1 return 0 } install_red_hat_enterprise_stable_post() { + install_red_hat_linux_stable_post || return 1 return 0 } install_red_hat_enterprise_restart_daemons() { + install_red_hat_linux_restart_daemons || return 1 return 0 } install_red_hat_enterprise_git_post() { + install_red_hat_linux_git_post || return 1 return 0 } install_red_hat_enterprise_linux_stable_post() { + install_red_hat_linux_stable_post || return 1 return 0 } install_red_hat_enterprise_linux_restart_daemons() { + install_red_hat_linux_restart_daemons || return 1 return 0 } install_red_hat_enterprise_linux_git_post() { + install_red_hat_linux_git_post || return 1 return 0 } install_red_hat_enterprise_server_stable_post() { + install_red_hat_linux_stable_post || return 1 return 0 } install_red_hat_enterprise_server_restart_daemons() { + install_red_hat_linux_restart_daemons || return 1 return 0 } install_red_hat_enterprise_server_git_post() { + install_red_hat_linux_git_post || return 1 return 0 } install_red_hat_enterprise_workstation_stable_post() { + install_red_hat_linux_stable_post || return 1 return 0 } install_red_hat_enterprise_workstation_restart_daemons() { + install_red_hat_linux_restart_daemons || return 1 return 0 } install_red_hat_enterprise_workstation_git_post() { + install_red_hat_linux_git_post || return 1 return 0 } install_red_hat_linux_testing_deps() { + install_centos_testing_deps || return 1 return 0 } install_red_hat_linux_testing() { + install_centos_testing || return 1 return 0 } install_red_hat_linux_testing_post() { + install_centos_testing_post || return 1 return 0 } install_red_hat_enterprise_testing_deps() { + install_centos_testing_deps || return 1 return 0 } install_red_hat_enterprise_testing() { + install_centos_testing || return 1 return 0 } install_red_hat_enterprise_testing_post() { + install_centos_testing_post || return 1 return 0 } install_red_hat_enterprise_server_testing_deps() { + install_centos_testing_deps || return 1 return 0 } install_red_hat_enterprise_server_testing() { + install_centos_testing || return 1 return 0 } install_red_hat_enterprise_server_testing_post() { + install_centos_testing_post || return 1 return 0 } install_red_hat_enterprise_workstation_testing_deps() { + install_centos_testing_deps || return 1 return 0 } install_red_hat_enterprise_workstation_testing() { + install_centos_testing || return 1 return 0 } install_red_hat_enterprise_workstation_testing_post() { + install_centos_testing_post || return 1 return 0 } @@ -5580,11 +4907,13 @@ install_red_hat_enterprise_workstation_testing_post() { # Oracle Linux Install Functions # install_oracle_linux_stable_deps() { + # Install Oracle's EPEL. - if [ ${_EPEL_REPOS_INSTALLED} -eq $BS_FALSE ]; then + if [ "${_EPEL_REPOS_INSTALLED}" -eq $BS_FALSE ]; then _EPEL_REPO=oracle-epel-release-el${DISTRO_MAJOR_VERSION} if ! rpm -q "${_EPEL_REPO}" > /dev/null; then - __yum_install_noinput "${_EPEL_REPO}" + # shellcheck disable=SC2086 + __yum_install_noinput ${_EPEL_REPO} fi _EPEL_REPOS_INSTALLED=$BS_TRUE fi @@ -5969,6 +5298,7 @@ install_cloud_linux_check_services() { # Alpine Linux Install Functions # install_alpine_linux_stable_deps() { + _PIP_INSTALL_ARGS="" if ! grep -q '^[^#].\+alpine/.\+/community' /etc/apk/repositories; then # Add community repository entry based on the "main" repo URL __REPO=$(grep '^[^#].\+alpine/.\+/main\>' /etc/apk/repositories) @@ -5987,6 +5317,7 @@ install_alpine_linux_stable_deps() { } install_alpine_linux_git_deps() { + _PIP_INSTALL_ARGS="" install_alpine_linux_stable_deps || return 1 if ! __check_command_exists git; then @@ -5995,33 +5326,14 @@ install_alpine_linux_git_deps() { __git_clone_and_checkout || return 1 - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - apk -U add python2 py-virtualenv py2-crypto py2-m2crypto py2-setuptools \ - py2-jinja2 py2-yaml py2-markupsafe py2-msgpack py2-psutil \ - py2-zmq zeromq py2-requests || return 1 - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # We're on the master branch, install whichever tornado is on the requirements file - __REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - if [ "${__REQUIRED_TORNADO}" != "" ]; then - apk -U add py2-tornado || return 1 - fi - fi - else - apk -U add python3 python3-dev py3-pip py3-setuptools g++ linux-headers zeromq-dev openrc || return 1 - _PY_EXE=python3 - return 0 - fi - - # Let's trigger config_salt() - if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" - CONFIG_SALT_FUNC="config_salt" - fi + apk -U add python3 python3-dev py3-pip py3-setuptools g++ linux-headers zeromq-dev openrc || return 1 + _PY_EXE=python3 + return 0 } install_alpine_linux_stable() { __PACKAGES="salt" + _PIP_INSTALL_ARGS="" if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ];then __PACKAGES="${__PACKAGES} salt-cloud" @@ -6036,26 +5348,23 @@ install_alpine_linux_stable() { __PACKAGES="${__PACKAGES} salt-syndic" fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api" + fi + # shellcheck disable=SC2086 - apk -U add ${__PACKAGES} || return 1 + apk -U add "${__PACKAGES}" || return 1 return 0 } install_alpine_linux_git() { - - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - return 0 - fi - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/salt/syspaths.py" ]; then - python2 setup.py --salt-config-dir="$_SALT_ETC_DIR" --salt-cache-dir="${_SALT_CACHE_DIR}" ${SETUP_PY_INSTALL_ARGS} install || return 1 - else - python2 setup.py ${SETUP_PY_INSTALL_ARGS} install || return 1 - fi + _PIP_INSTALL_ARGS="" + __install_salt_from_repo "${_PY_EXE}" || return 1 + return 0 } install_alpine_linux_post() { + _PIP_INSTALL_ARGS="" for fname in api master minion syndic; do # Skip if not meant to be installed [ $fname = "api" ] && \ @@ -6085,6 +5394,7 @@ install_alpine_linux_post() { } install_alpine_linux_restart_daemons() { + _PIP_INSTALL_ARGS="" [ "${_START_DAEMONS}" -eq $BS_FALSE ] && return for fname in api master minion syndic; do @@ -6103,6 +5413,7 @@ install_alpine_linux_restart_daemons() { } install_alpine_linux_check_services() { + _PIP_INSTALL_ARGS="" for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot [ $fname = "api" ] && continue @@ -6119,6 +5430,7 @@ install_alpine_linux_check_services() { } daemons_running_alpine_linux() { + _PIP_INSTALL_ARGS="" [ "${_START_DAEMONS}" -eq $BS_FALSE ] && return FAILED_DAEMONS=0 @@ -6152,167 +5464,21 @@ daemons_running_alpine_linux() { # Amazon Linux AMI Install Functions # -install_amazon_linux_ami_deps() { - # Shim to figure out if we're using old (rhel) or new (aws) rpms. - _USEAWS=$BS_FALSE - pkg_append="python" - - if [ "$ITYPE" = "stable" ]; then - repo_rev="$STABLE_REV" - else - repo_rev="latest" - fi - - if echo $repo_rev | grep -E -q '^archive'; then - year=$(echo "$repo_rev" | cut -d '/' -f 2 | cut -c1-4) - else - year=$(echo "$repo_rev" | cut -c1-4) - fi - - if echo "$repo_rev" | grep -E -q '^(latest|2016\.11)$' || \ - [ "$year" -gt 2016 ]; then - _USEAWS=$BS_TRUE - pkg_append="python27" - fi - - # We need to install yum-utils before doing anything else when installing on - # Amazon Linux ECS-optimized images. See issue #974. - __yum_install_noinput yum-utils - - # Do upgrade early - if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then - yum -y update || return 1 - fi - - if [ $_DISABLE_REPOS -eq $BS_FALSE ] || [ "$_CUSTOM_REPO_URL" != "null" ]; then - __REPO_FILENAME="salt.repo" - - # Set a few vars to make life easier. - if [ $_USEAWS -eq $BS_TRUE ]; then - base_url="$HTTP_VAL://${_REPO_URL}/yum/amazon/latest/\$basearch/$repo_rev/" - gpg_key="${base_url}SALTSTACK-GPG-KEY.pub" - repo_name="SaltStack repo for Amazon Linux" - else - base_url="$HTTP_VAL://${_REPO_URL}/yum/redhat/6/\$basearch/$repo_rev/" - gpg_key="${base_url}SALTSTACK-GPG-KEY.pub" - repo_name="SaltStack repo for RHEL/CentOS 6" - fi - - # This should prob be refactored to use __install_saltstack_rhel_repository() - # With args passed in to do the right thing. Reformatted to be more like the - # amazon linux yum file. - if [ ! -s "/etc/yum.repos.d/${__REPO_FILENAME}" ]; then - cat <<_eof > "/etc/yum.repos.d/${__REPO_FILENAME}" -[saltstack-repo] -name=$repo_name -failovermethod=priority -priority=10 -gpgcheck=1 -gpgkey=$gpg_key -baseurl=$base_url -_eof - fi - - fi - - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - # Package python-ordereddict-1.1-2.el6.noarch is obsoleted by python26-2.6.9-2.88.amzn1.x86_64 - # which is already installed - __PACKAGES="m2crypto ${pkg_append}-crypto ${pkg_append}-jinja2 ${pkg_append}-PyYAML" - __PACKAGES="${__PACKAGES} ${pkg_append}-msgpack ${pkg_append}-requests ${pkg_append}-zmq" - __PACKAGES="${__PACKAGES} ${pkg_append}-futures" - # shellcheck disable=SC2086 - __yum_install_noinput ${__PACKAGES} || return 1 - fi - - if [ "${_EXTRA_PACKAGES}" != "" ]; then - echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}" - # shellcheck disable=SC2086 - __yum_install_noinput ${_EXTRA_PACKAGES} || return 1 - fi -} - -install_amazon_linux_ami_git_deps() { - if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then - yum -y install ca-certificates || return 1 - fi - - PIP_EXE='pip' - if __check_command_exists python2.7; then - if ! __check_command_exists pip2.7; then - if ! __check_command_exists easy_install-2.7; then - __yum_install_noinput python27-setuptools - fi - /usr/bin/easy_install-2.7 pip || return 1 - fi - PIP_EXE='/usr/local/bin/pip2.7' - _PY_EXE='python2.7' - fi - - install_amazon_linux_ami_deps || return 1 - - if ! __check_command_exists git; then - __yum_install_noinput git || return 1 - fi - - __git_clone_and_checkout || return 1 - - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - __PACKAGES="" - __PIP_PACKAGES="" - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - __check_pip_allowed "You need to allow pip based installations (-P) in order to install apache-libcloud" - __PACKAGES="${__PACKAGES} python27-pip" - __PIP_PACKAGES="${__PIP_PACKAGES} apache-libcloud>=$_LIBCLOUD_MIN_VERSION" - fi - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # We're on the master branch, install whichever tornado is on the requirements file - __REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - if [ "${__REQUIRED_TORNADO}" != "" ]; then - __PACKAGES="${__PACKAGES} ${pkg_append}-tornado" - fi - fi - - if [ "${__PACKAGES}" != "" ]; then - # shellcheck disable=SC2086 - __yum_install_noinput ${__PACKAGES} || return 1 - fi - - if [ "${__PIP_PACKAGES}" != "" ]; then - # shellcheck disable=SC2086 - ${PIP_EXE} install ${__PIP_PACKAGES} || return 1 - fi - else - __PACKAGES="python27-pip python27-setuptools python27-devel gcc" - # shellcheck disable=SC2086 - __yum_install_noinput ${__PACKAGES} || return 1 - fi - - # Let's trigger config_salt() - if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" - CONFIG_SALT_FUNC="config_salt" - fi - - return 0 -} - +# Support for Amazon Linux 2 install_amazon_linux_ami_2_git_deps() { if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then yum -y install ca-certificates || return 1 fi + if [ "$_PY_MAJOR_VERSION" -eq 2 ]; then + echoerror "Python 2 is no longer supported, only Python 3" + return 1 + fi + install_amazon_linux_ami_2_deps || return 1 - if [ "$_PY_MAJOR_VERSION" -eq 2 ]; then - PY_PKG_VER=2 - PIP_EXE='/bin/pip' - else - PY_PKG_VER=3 - PIP_EXE='/bin/pip3' - fi + PY_PKG_VER=3 + PIP_EXE='/bin/pip3' __PACKAGES="python${PY_PKG_VER}-pip" if ! __check_command_exists "${PIP_EXE}"; then @@ -6326,61 +5492,14 @@ install_amazon_linux_ami_2_git_deps() { __git_clone_and_checkout || return 1 - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then + __PACKAGES="python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools python${PY_PKG_VER}-devel gcc" - __PACKAGES="" - __PIP_PACKAGES="" - - if [ "$_INSTALL_CLOUD" -eq "$BS_TRUE" ]; then - __check_pip_allowed "You need to allow pip based installations (-P) in order to install apache-libcloud" - if [ "$PARSED_VERSION" -eq "2" ]; then - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq "3" ]; then - __PACKAGES="${__PACKAGES} python3-pip" - __PIP_PACKAGES="${__PIP_PACKAGES} tornado<$_TORNADO_MAX_PY3_VERSION" - else - __PACKAGES="${__PACKAGES} python2-pip" - fi - else - __PACKAGES="${__PACKAGES} python27-pip" - fi - __PIP_PACKAGES="${__PIP_PACKAGES} apache-libcloud>=$_LIBCLOUD_MIN_VERSION" - fi - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # We're on the master branch, install whichever tornado is on the requirements file - __REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - if [ "${__REQUIRED_TORNADO}" != "" ]; then - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq "3" ]; then - __PIP_PACKAGES="${__PIP_PACKAGES} tornado<$_TORNADO_MAX_PY3_VERSION" - else - __PACKAGES="${__PACKAGES} ${pkg_append}${PY_PKG_VER}-tornado" - fi - fi - fi - - if [ "${__PIP_PACKAGES}" != "" ]; then - __check_pip_allowed "You need to allow pip based installations (-P) in order to install ${__PIP_PACKAGES}" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-pip" - fi - - if [ "${__PACKAGES}" != "" ]; then - # shellcheck disable=SC2086 - __yum_install_noinput ${__PACKAGES} || return 1 - fi - - if [ "${__PIP_PACKAGES}" != "" ]; then - # shellcheck disable=SC2086 - ${PIP_EXE} install ${__PIP_PACKAGES} || return 1 - fi - else - __PACKAGES="python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools python${PY_PKG_VER}-devel gcc" - # shellcheck disable=SC2086 - __yum_install_noinput ${__PACKAGES} || return 1 - fi + # shellcheck disable=SC2086 + __yum_install_noinput ${__PACKAGES} || return 1 # Let's trigger config_salt() if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" CONFIG_SALT_FUNC="config_salt" fi @@ -6388,26 +5507,9 @@ install_amazon_linux_ami_2_git_deps() { } install_amazon_linux_ami_2_deps() { - # Shim to figure out if we're using old (rhel) or new (aws) rpms. - _USEAWS=$BS_FALSE - pkg_append="python" - - if [ "$ITYPE" = "stable" ]; then - repo_rev="$STABLE_REV" - else - repo_rev="latest" - fi - - if echo $repo_rev | grep -E -q '^archive'; then - year=$(echo "$repo_rev" | cut -d '/' -f 2 | cut -c1-4) - else - year=$(echo "$repo_rev" | cut -c1-4) - fi - - if echo "$repo_rev" | grep -E -q '^(latest|2016\.11)$' || \ - [ "$year" -gt 2016 ]; then - _USEAWS=$BS_TRUE - pkg_append="python" + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi # We need to install yum-utils before doing anything else when installing on @@ -6420,56 +5522,24 @@ install_amazon_linux_ami_2_deps() { fi if [ $_DISABLE_REPOS -eq $BS_FALSE ] || [ "$_CUSTOM_REPO_URL" != "null" ]; then - __REPO_FILENAME="salt.repo" - __PY_VERSION_REPO="yum" - PY_PKG_VER="" - repo_label="saltstack-repo" - repo_name="SaltStack repo for Amazon Linux 2" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __REPO_FILENAME="salt.repo" - __PY_VERSION_REPO="py3" - PY_PKG_VER=3 - repo_label="saltstack-py3-repo" - repo_name="SaltStack Python 3 repo for Amazon Linux 2" + if [ ! -s "${YUM_REPO_FILE}" ]; then + FETCH_URL="https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.repo" + __fetch_url "${YUM_REPO_FILE}" "${FETCH_URL}" + if [ "$STABLE_REV" != "latest" ]; then + # 3006.x is default + REPO_REV_MAJOR=$(echo "$STABLE_REV" | cut -d '.' -f 1) + if [ "$REPO_REV_MAJOR" -eq "3007" ]; then + # Enable the Salt 3007 STS repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-3007-sts + fi + else + # Enable the Salt LATEST repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-latest + fi + dnf clean expire-cache || return 1 fi - - base_url="$HTTP_VAL://${_REPO_URL}/${__PY_VERSION_REPO}/amazon/2/\$basearch/$repo_rev/" - gpg_key="${base_url}SALTSTACK-GPG-KEY.pub,${base_url}base/RPM-GPG-KEY-CentOS-7" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - gpg_key="${base_url}SALTSTACK-GPG-KEY.pub" - fi - - # This should prob be refactored to use __install_saltstack_rhel_repository() - # With args passed in to do the right thing. Reformatted to be more like the - # amazon linux yum file. - if [ ! -s "/etc/yum.repos.d/${__REPO_FILENAME}" ]; then - cat <<_eof > "/etc/yum.repos.d/${__REPO_FILENAME}" -[$repo_label] -name=$repo_name -failovermethod=priority -priority=10 -gpgcheck=1 -gpgkey=$gpg_key -baseurl=$base_url -_eof - fi - - fi - - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - # Package python-ordereddict-1.1-2.el6.noarch is obsoleted by python26-2.6.9-2.88.amzn1.x86_64 - # which is already installed - if [ -n "${PY_PKG_VER}" ] && [ "${PY_PKG_VER}" -eq 3 ]; then - __PACKAGES="${pkg_append}${PY_PKG_VER}-m2crypto ${pkg_append}${PY_PKG_VER}-pyyaml" - else - __PACKAGES="m2crypto PyYAML ${pkg_append}-futures" - fi - - __PACKAGES="${__PACKAGES} ${pkg_append}${PY_PKG_VER}-crypto ${pkg_append}${PY_PKG_VER}-jinja2 procps-ng" - __PACKAGES="${__PACKAGES} ${pkg_append}${PY_PKG_VER}-msgpack ${pkg_append}${PY_PKG_VER}-requests ${pkg_append}${PY_PKG_VER}-zmq" - - # shellcheck disable=SC2086 - __yum_install_noinput ${__PACKAGES} || return 1 fi if [ "${_EXTRA_PACKAGES}" != "" ]; then @@ -6480,20 +5550,9 @@ _eof } install_amazon_linux_ami_2_onedir_deps() { - # Shim to figure out if we're using old (rhel) or new (aws) rpms. - _USEAWS=$BS_FALSE - pkg_append="python" - - if [ "$ITYPE" = "onedir" ]; then - repo_rev="$ONEDIR_REV" - else - repo_rev="latest" - fi - - if echo $repo_rev | grep -E -q '^archive'; then - year=$(echo "$repo_rev" | cut -d '/' -f 2 | cut -c1-4) - else - year=$(echo "$repo_rev" | cut -c1-4) + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi # We need to install yum-utils before doing anything else when installing on @@ -6506,64 +5565,24 @@ install_amazon_linux_ami_2_onedir_deps() { fi if [ $_DISABLE_REPOS -eq $BS_FALSE ] || [ "$_CUSTOM_REPO_URL" != "null" ]; then - __REPO_FILENAME="salt.repo" - __PY_VERSION_REPO="yum" - PY_PKG_VER="" - repo_label="saltstack-repo" - repo_name="SaltStack repo for Amazon Linux 2" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __REPO_FILENAME="salt.repo" - __PY_VERSION_REPO="py3" - PY_PKG_VER=3 - repo_label="saltstack-py3-repo" - repo_name="SaltStack Python 3 repo for Amazon Linux 2" + if [ ! -s "${YUM_REPO_FILE}" ]; then + FETCH_URL="https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.repo" + __fetch_url "${YUM_REPO_FILE}" "${FETCH_URL}" + if [ "$ONEDIR_REV" != "latest" ]; then + # 3006.x is default + REPO_REV_MAJOR=$(echo "$ONEDIR_REV" | cut -d '.' -f 1) + if [ "$REPO_REV_MAJOR" -eq "3007" ]; then + # Enable the Salt 3007 STS repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-3007-sts + fi + else + # Enable the Salt LATEST repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-latest + fi + dnf clean expire-cache || return 1 fi - - base_url="$HTTP_VAL://${_REPO_URL}/${_ONEDIR_DIR}/${__PY_VERSION_REPO}/amazon/2/\$basearch/$repo_rev/" - if [ "${ONEDIR_REV}" = "nightly" ] ; then - base_url="$HTTP_VAL://${_REPO_URL}/${_ONEDIR_NIGHTLY_DIR}/${__PY_VERSION_REPO}/amazon/2/\$basearch/" - fi - - if [ "$(echo "${ONEDIR_REV}" | grep -E '(3004|3005)')" != "" ] || [ "${ONEDIR_REV}" = "nightly" ]; then - gpg_key="${base_url}SALTSTACK-GPG-KEY.pub,${base_url}base/RPM-GPG-KEY-CentOS-7" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - gpg_key="${base_url}SALTSTACK-GPG-KEY.pub" - fi - else - gpg_key="${base_url}SALT-PROJECT-GPG-PUBKEY-2023.pub" - fi - - # This should prob be refactored to use __install_saltstack_rhel_repository() - # With args passed in to do the right thing. Reformatted to be more like the - # amazon linux yum file. - if [ ! -s "/etc/yum.repos.d/${__REPO_FILENAME}" ]; then - cat <<_eof > "/etc/yum.repos.d/${__REPO_FILENAME}" -[$repo_label] -name=$repo_name -failovermethod=priority -priority=10 -gpgcheck=1 -gpgkey=$gpg_key -baseurl=$base_url -_eof - fi - - fi - - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - # Package python-ordereddict-1.1-2.el6.noarch is obsoleted by python26-2.6.9-2.88.amzn1.x86_64 - # which is already installed - if [ -n "${PY_PKG_VER}" ] && [ "${PY_PKG_VER}" -eq 3 ]; then - __PACKAGES="${pkg_append}${PY_PKG_VER}-m2crypto ${pkg_append}${PY_PKG_VER}-pyyaml" - else - __PACKAGES="m2crypto PyYAML ${pkg_append}-futures" - fi - - __PACKAGES="${__PACKAGES} ${pkg_append}${PY_PKG_VER}-crypto ${pkg_append}${PY_PKG_VER}-jinja2 procps-ng" - __PACKAGES="${__PACKAGES} ${pkg_append}${PY_PKG_VER}-msgpack ${pkg_append}${PY_PKG_VER}-requests ${pkg_append}${PY_PKG_VER}-zmq" - - # shellcheck disable=SC2086 - __yum_install_noinput ${__PACKAGES} || return 1 fi if [ "${_EXTRA_PACKAGES}" != "" ]; then @@ -6573,41 +5592,6 @@ _eof fi } -install_amazon_linux_ami_stable() { - install_centos_stable || return 1 - return 0 -} - -install_amazon_linux_ami_stable_post() { - install_centos_stable_post || return 1 - return 0 -} - -install_amazon_linux_ami_restart_daemons() { - install_centos_restart_daemons || return 1 - return 0 -} - -install_amazon_linux_ami_git() { - install_centos_git || return 1 - return 0 -} - -install_amazon_linux_ami_git_post() { - install_centos_git_post || return 1 - return 0 -} - -install_amazon_linux_ami_testing() { - install_centos_testing || return 1 - return 0 -} - -install_amazon_linux_ami_testing_post() { - install_centos_testing_post || return 1 - return 0 -} - install_amazon_linux_ami_2_stable() { install_centos_stable || return 1 return 0 @@ -6658,6 +5642,133 @@ install_amazon_linux_ami_2_onedir_post() { return 0 } +# Support for Amazon Linux 2023 +# the following code needs adjustment to allow for 2023, 2024, 2025, etc - 2023 for now +install_amazon_linux_ami_2023_git_deps() { + if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then + yum -y install ca-certificates || return 1 + fi + + install_amazon_linux_ami_2023_onedir_deps || return 1 + + PY_PKG_VER=3 + PIP_EXE='/bin/pip3' + __PACKAGES="python${PY_PKG_VER}-pip" + + if ! __check_command_exists "${PIP_EXE}"; then + # shellcheck disable=SC2086 + __yum_install_noinput ${__PACKAGES} || return 1 + fi + + if ! __check_command_exists git; then + __yum_install_noinput git || return 1 + fi + + __git_clone_and_checkout || return 1 + + __PACKAGES="python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools python${PY_PKG_VER}-devel gcc" + + # shellcheck disable=SC2086 + __yum_install_noinput ${__PACKAGES} || return 1 + + # Let's trigger config_salt() + if [ "$_TEMP_CONFIG_DIR" = "null" ]; then + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" + CONFIG_SALT_FUNC="config_salt" + fi + + return 0 +} + +install_amazon_linux_ami_2023_onedir_deps() { + + # We need to install yum-utils before doing anything else when installing on + # Amazon Linux ECS-optimized images. See issue #974. + __yum_install_noinput yum-utils + + # Do upgrade early + if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then + yum -y update || return 1 + fi + + if [ $_DISABLE_REPOS -eq $BS_FALSE ] || [ "$_CUSTOM_REPO_URL" != "null" ]; then + if [ ! -s "${YUM_REPO_FILE}" ]; then + FETCH_URL="https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.repo" + __fetch_url "${YUM_REPO_FILE}" "${FETCH_URL}" + if [ "$ONEDIR_REV" != "latest" ]; then + # 3006.x is default + REPO_REV_MAJOR=$(echo "$ONEDIR_REV" | cut -d '.' -f 1) + if [ "$REPO_REV_MAJOR" -eq "3007" ]; then + # Enable the Salt 3007 STS repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-3007-sts + fi + else + # Enable the Salt LATEST repo + dnf config-manager --set-disable salt-repo-* + dnf config-manager --set-enabled salt-repo-latest + fi + dnf clean expire-cache || return 1 + fi + fi + + if [ "${_EXTRA_PACKAGES}" != "" ]; then + echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}" + # shellcheck disable=SC2086 + __yum_install_noinput ${_EXTRA_PACKAGES} || return 1 + fi +} + +install_amazon_linux_ami_2023_stable() { + install_centos_stable || return 1 + return 0 +} + +install_amazon_linux_ami_2023_stable_post() { + install_centos_stable_post || return 1 + return 0 +} + +install_amazon_linux_ami_2023_restart_daemons() { + install_centos_restart_daemons || return 1 + return 0 +} + +install_amazon_linux_ami_2023_git() { + install_centos_git || return 1 + return 0 +} + +install_amazon_linux_ami_2023_git_post() { + install_centos_git_post || return 1 + return 0 +} + +install_amazon_linux_ami_2023_testing() { + install_centos_testing || return 1 + return 0 +} + +install_amazon_linux_ami_2023_testing_post() { + install_centos_testing_post || return 1 + return 0 +} + +install_amazon_linux_ami_2023_check_services() { + install_centos_check_services || return 1 + return 0 +} + +install_amazon_linux_ami_2023_onedir() { + install_centos_stable || return 1 + return 0 +} + +install_amazon_linux_ami_2023_onedir_post() { + install_centos_stable_post || return 1 + return 0 +} + # # Ended Amazon Linux AMI Install Functions # @@ -6685,7 +5796,8 @@ install_arch_linux_stable_deps() { fi if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 2 ]; then - PY_PKG_VER=2 + echoerror "Python 2 is no longer supported, only Python 3" + return 1 else PY_PKG_VER="" fi @@ -6693,6 +5805,7 @@ install_arch_linux_stable_deps() { # YAML module is used for generating custom master/minion configs # shellcheck disable=SC2086 pacman -Su --noconfirm --needed python${PY_PKG_VER}-yaml + pacman -Su --noconfirm --needed python${PY_PKG_VER}-tornado if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then # shellcheck disable=SC2086 @@ -6716,33 +5829,21 @@ install_arch_linux_git_deps() { __git_clone_and_checkout || return 1 - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - pacman -R --noconfirm python2-distribute - pacman -Su --noconfirm --needed python2-crypto python2-setuptools python2-jinja \ - python2-m2crypto python2-markupsafe python2-msgpack python2-psutil \ - python2-pyzmq zeromq python2-requests python2-systemd || return 1 - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # We're on the master branch, install whichever tornado is on the requirements file - __REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - if [ "${__REQUIRED_TORNADO}" != "" ]; then - pacman -Su --noconfirm --needed python2-tornado - fi - fi + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 2 ]; then + echoerror "Python 2 is no longer supported, only Python 3" + return 1 else - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 2 ]; then - PY_PKG_VER=2 - else - PY_PKG_VER="" - fi - __PACKAGES="python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" - # shellcheck disable=SC2086 - pacman -Su --noconfirm --needed ${__PACKAGES} + PY_PKG_VER="" fi + __PACKAGES="python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" + + # shellcheck disable=SC2086 + pacman -Su --noconfirm --needed ${__PACKAGES} + # Let's trigger config_salt() if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" CONFIG_SALT_FUNC="config_salt" fi @@ -6770,19 +5871,16 @@ install_arch_linux_stable() { } install_arch_linux_git() { + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 2 ]; then + echoerror "Python 2 is no longer supported, only Python 3" + return 1 + fi - _POST_NEON_PIP_INSTALL_ARGS="${_POST_NEON_PIP_INSTALL_ARGS} --use-pep517" + _PIP_INSTALL_ARGS="${_PIP_INSTALL_ARGS} --use-pep517" _PIP_DOWNLOAD_ARGS="${_PIP_DOWNLOAD_ARGS} --use-pep517" - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - return 0 - fi - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/salt/syspaths.py" ]; then - python2 setup.py --salt-config-dir="$_SALT_ETC_DIR" --salt-cache-dir="${_SALT_CACHE_DIR}" ${SETUP_PY_INSTALL_ARGS} install || return 1 - else - python2 setup.py ${SETUP_PY_INSTALL_ARGS} install || return 1 - fi + __install_salt_from_repo "${_PY_EXE}" || return 1 + return 0 } @@ -6806,7 +5904,7 @@ install_arch_linux_post() { # Skip salt-api since the service should be opt-in and not necessarily started on boot [ $fname = "api" ] && continue - if [ -f /usr/bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then # Using systemd /usr/bin/systemctl is-enabled salt-$fname.service > /dev/null 2>&1 || ( /usr/bin/systemctl preset salt-$fname.service > /dev/null 2>&1 && @@ -6837,7 +5935,7 @@ install_arch_linux_git_post() { _SERVICE_DIR="${_SALT_GIT_CHECKOUT_DIR}/pkg/rpm" fi - if [ -f /usr/bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then __copyfile "${_SERVICE_DIR}/salt-${fname}.service" "/lib/systemd/system/salt-${fname}.service" # Skip salt-api since the service should be opt-in and not necessarily started on boot @@ -6859,7 +5957,7 @@ install_arch_linux_git_post() { } install_arch_linux_restart_daemons() { - [ $_START_DAEMONS -eq $BS_FALSE ] && return + [ "$_START_DAEMONS" -eq $BS_FALSE ] && return for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot @@ -6870,7 +5968,7 @@ install_arch_linux_restart_daemons() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /usr/bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then /usr/bin/systemctl stop salt-$fname.service > /dev/null 2>&1 /usr/bin/systemctl start salt-$fname.service && continue echodebug "Failed to start salt-$fname using systemd" @@ -6886,7 +5984,7 @@ install_arch_linux_restart_daemons() { } install_arch_check_services() { - if [ ! -f /usr/bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then # Not running systemd!? Don't check! return 0 fi @@ -6928,57 +6026,91 @@ install_arch_linux_onedir_post() { # __install_saltstack_photon_onedir_repository() { - if [ "$ITYPE" = "stable" ]; then - REPO_REV="$ONEDIR_REV" - else - REPO_REV="latest" + echodebug "__install_saltstack_photon_onedir_repository() entry" + + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi - __PY_VERSION_REPO="yum" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - __PY_VERSION_REPO="py3" - fi - - REPO_FILE="/etc/yum.repos.d/salt.repo" - - if [ ! -s "$REPO_FILE" ] || [ "$_FORCE_OVERWRITE" -eq $BS_TRUE ]; then - FETCH_URL="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_DIR}/${__PY_VERSION_REPO}/photon/${DISTRO_MAJOR_VERSION}/${CPU_ARCH_L}/${ONEDIR_REV}" - if [ "${ONEDIR_REV}" = "nightly" ] ; then - FETCH_URL="${HTTP_VAL}://${_REPO_URL}/${_ONEDIR_NIGHTLY_DIR}/${__PY_VERSION_REPO}/photon/${DISTRO_MAJOR_VERSION}/${CPU_ARCH_L}/" + if [ ! -s "$YUM_REPO_FILE" ] || [ "$_FORCE_OVERWRITE" -eq $BS_TRUE ]; then + ## Photon tdnf doesn't support config-manager + ## FETCH_URL="https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.repo" + ## __fetch_url "${YUM_REPO_FILE}" "${FETCH_URL}" + # shellcheck disable=SC2129 + if [ "$ONEDIR_REV" != "latest" ]; then + # 3006.x is default + REPO_REV_MAJOR=$(echo "$ONEDIR_REV" | cut -d '.' -f 1) + if [ "$REPO_REV_MAJOR" -eq "3007" ]; then + # Enable the Salt 3007 STS repo + ## tdnf config-manager --set-disable salt-repo-* + ## tdnf config-manager --set-enabled salt-repo-3007-sts + echo "[salt-repo-3007-sts]" > "${YUM_REPO_FILE}" + echo "name=Salt Repo for Salt v3007 STS" >> "${YUM_REPO_FILE}" + echo "baseurl=https://packages.broadcom.com/artifactory/saltproject-rpm/" >> "${YUM_REPO_FILE}" + echo "skip_if_unavailable=True" >> "${YUM_REPO_FILE}" + echo "priority=10" >> "${YUM_REPO_FILE}" + echo "enabled=1" >> "${YUM_REPO_FILE}" + echo "enabled_metadata=1" >> "${YUM_REPO_FILE}" + echo "gpgcheck=1" >> "${YUM_REPO_FILE}" + echo "exclude=*3006* *3008* *3009* *3010*" >> "${YUM_REPO_FILE}" + echo "gpgkey=https://packages.broadcom.com/artifactory/api/security/keypair/SaltProjectKey/public" >> "${YUM_REPO_FILE}" + else + # Salt 3006 repo + echo "[salt-repo-3006-lts]" > "${YUM_REPO_FILE}" + echo "name=Salt Repo for Salt v3006 LTS" >> "${YUM_REPO_FILE}" + echo "baseurl=https://packages.broadcom.com/artifactory/saltproject-rpm/" >> "${YUM_REPO_FILE}" + echo "skip_if_unavailable=True" >> "${YUM_REPO_FILE}" + echo "priority=10" >> "${YUM_REPO_FILE}" + echo "enabled=1" >> "${YUM_REPO_FILE}" + echo "enabled_metadata=1" >> "${YUM_REPO_FILE}" + echo "gpgcheck=1" >> "${YUM_REPO_FILE}" + echo "exclude=*3007* *3008* *3009* *3010*" >> "${YUM_REPO_FILE}" + echo "gpgkey=https://packages.broadcom.com/artifactory/api/security/keypair/SaltProjectKey/public" >> "${YUM_REPO_FILE}" + fi + else + # Enable the Salt LATEST repo + ## tdnf config-manager --set-disable salt-repo-* + ## tdnf config-manager --set-enabled salt-repo-latest + echo "[salt-repo-latest]" > "${YUM_REPO_FILE}" + echo "name=Salt Repo for Salt LATEST release" >> "${YUM_REPO_FILE}" + echo "baseurl=https://packages.broadcom.com/artifactory/saltproject-rpm/" >> "${YUM_REPO_FILE}" + echo "skip_if_unavailable=True" >> "${YUM_REPO_FILE}" + echo "priority=10" >> "${YUM_REPO_FILE}" + echo "enabled=1" >> "${YUM_REPO_FILE}" + echo "enabled_metadata=1" >> "${YUM_REPO_FILE}" + echo "gpgcheck=1" >> "${YUM_REPO_FILE}" + echo "gpgkey=https://packages.broadcom.com/artifactory/api/security/keypair/SaltProjectKey/public" >> "${YUM_REPO_FILE}" fi - - __fetch_url "${REPO_FILE}" "${FETCH_URL}.repo" - - GPG_KEY="SALT-PROJECT-GPG-PUBKEY-2023.pub" - - __rpm_import_gpg "${FETCH_URL}/${GPG_KEY}" || return 1 - tdnf makecache || return 1 - elif [ "$REPO_REV" != "latest" ]; then + elif [ "$ONEDIR_REV" != "latest" ]; then echowarn "salt.repo already exists, ignoring salt version argument." - echowarn "Use -F (forced overwrite) to install $REPO_REV." + echowarn "Use -F (forced overwrite) to install $ONEDIR_REV." fi return 0 } install_photon_deps() { + echodebug "install_photon_deps() entry" + + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 + fi + if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then tdnf -y update || return 1 fi __PACKAGES="${__PACKAGES:=}" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -lt 3 ]; then - echoerror "There are no Python 2 stable packages for Fedora, only Py3 packages" - return 1 - fi - PY_PKG_VER=3 __PACKAGES="${__PACKAGES} libyaml procps-ng python${PY_PKG_VER}-crypto python${PY_PKG_VER}-jinja2" __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-msgpack python${PY_PKG_VER}-requests python${PY_PKG_VER}-zmq" __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-pip python${PY_PKG_VER}-m2crypto python${PY_PKG_VER}-pyyaml" __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-systemd" + if [ "${_EXTRA_PACKAGES}" != "" ]; then echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}" fi @@ -6990,6 +6122,8 @@ install_photon_deps() { } install_photon_stable_post() { + echodebug "install_photon_stable_post() entry" + for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot [ $fname = "api" ] && continue @@ -7006,17 +6140,21 @@ install_photon_stable_post() { } install_photon_git_deps() { - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - # Packages are named python3- - PY_PKG_VER=3 - else - PY_PKG_VER=2 + echodebug "install_photon_git_deps() entry" + + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi + # Packages are named python3- + PY_PKG_VER=3 + __PACKAGES="" if ! __check_command_exists ps; then __PACKAGES="${__PACKAGES} procps-ng" fi + if ! __check_command_exists git; then __PACKAGES="${__PACKAGES} git" fi @@ -7029,55 +6167,28 @@ install_photon_git_deps() { __git_clone_and_checkout || return 1 - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then + __PACKAGES="python${PY_PKG_VER}-devel python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc glibc-devel linux-devel.x86_64 cython${PY_PKG_VER}" - if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then - __PACKAGES="${__PACKAGES} ca-certificates" - fi - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-libcloud python${PY_PKG_VER}-netaddr" - fi + echodebug "install_photon_git_deps() distro major version, ${DISTRO_MAJOR_VERSION}" - install_photon_deps || return 1 - - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then - if __check_command_exists python3; then - __python="python3" - fi - elif [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 2 ]; then - if __check_command_exists python2; then - __python="python2" - fi - else - if ! __check_command_exists python; then - echoerror "Unable to find a python binary?!" - return 1 - fi - # Let's hope it's the right one - __python="python" - fi - - grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" | while IFS=' - ' read -r dep; do - echodebug "Running '${__python}' -m pip install '${dep}'" - "${__python}" -m pip install "${dep}" || return 1 - done - else - __PACKAGES="python${PY_PKG_VER}-devel python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc glibc-devel linux-devel.x86_64" - # shellcheck disable=SC2086 - __tdnf_install_noinput ${__PACKAGES} || return 1 + ## Photon 5 container is missing systemd on default installation + if [ "${DISTRO_MAJOR_VERSION}" -lt 5 ]; then + __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-tornado" fi + # shellcheck disable=SC2086 + __tdnf_install_noinput ${__PACKAGES} || return 1 + if [ "${DISTRO_MAJOR_VERSION}" -gt 3 ]; then # Need newer version of setuptools on Photon - _setuptools_dep="setuptools>=${_MINIMUM_SETUPTOOLS_VERSION}" - echodebug "Running '${_PY_EXE} -m pip --upgrade install ${_setuptools_dep}'" + _setuptools_dep="setuptools>=${_MINIMUM_SETUPTOOLS_VERSION},<${_MAXIMUM_SETUPTOOLS_VERSION}" + echodebug "Running '${_PY_EXE} -m pip install --upgrade ${_setuptools_dep}'" ${_PY_EXE} -m pip install --upgrade "${_setuptools_dep}" fi # Let's trigger config_salt() if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" CONFIG_SALT_FUNC="config_salt" fi @@ -7085,11 +6196,14 @@ install_photon_git_deps() { } install_photon_git() { + echodebug "install_photon_git() entry" + if [ "${_PY_EXE}" != "" ]; then _PYEXE=${_PY_EXE} echoinfo "Using the following python version: ${_PY_EXE} to install salt" else - _PYEXE='python2' + echoerror "Python 2 is no longer supported, only Python 3" + return 1 fi if [ -f "${_SALT_GIT_CHECKOUT_DIR}/salt/syspaths.py" ]; then @@ -7101,6 +6215,8 @@ install_photon_git() { } install_photon_git_post() { + echodebug "install_photon_git_post() entry" + for fname in api master minion syndic; do # Skip if not meant to be installed [ $fname = "api" ] && \ @@ -7132,7 +6248,9 @@ install_photon_git_post() { } install_photon_restart_daemons() { - [ $_START_DAEMONS -eq $BS_FALSE ] && return + [ "$_START_DAEMONS" -eq $BS_FALSE ] && return + echodebug "install_photon_restart_daemons() entry" + for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot @@ -7154,6 +6272,8 @@ install_photon_restart_daemons() { } install_photon_check_services() { + echodebug "install_photon_check_services() entry" + for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot [ $fname = "api" ] && continue @@ -7170,6 +6290,8 @@ install_photon_check_services() { } install_photon_onedir_deps() { + echodebug "install_photon_onedir_deps() entry" + if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then tdnf -y update || return 1 @@ -7186,8 +6308,8 @@ install_photon_onedir_deps() { fi # If -R was passed, we need to configure custom repo url with rsync-ed packages - # Which is still handled in __install_saltstack_rhel_repository. This call has - # its own check in case -r was passed without -R. + # Which was handled in __install_saltstack_rhel_repository buu that hanlded old-stable which is for + # releases which are End-Of-Life. This call has its own check in case -r was passed without -R. if [ "$_CUSTOM_REPO_URL" != "null" ]; then __install_saltstack_photon_onedir_repository || return 1 fi @@ -7209,6 +6331,8 @@ install_photon_onedir_deps() { install_photon_onedir() { + echodebug "install_photon_onedir() entry" + STABLE_REV=$ONEDIR_REV __PACKAGES="" @@ -7226,6 +6350,10 @@ install_photon_onedir() { __PACKAGES="${__PACKAGES} salt-syndic" fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api" + fi + # shellcheck disable=SC2086 __tdnf_install_noinput ${__PACKAGES} || return 1 @@ -7243,526 +6371,6 @@ install_photon_onedir_post() { # ####################################################################################################################### -####################################################################################################################### -# -# FreeBSD Install Functions -# - -# Using a separate conf step to head for idempotent install... -__configure_freebsd_pkg_details() { - _SALT_ETC_DIR="/usr/local/etc/salt" - _PKI_DIR=${_SALT_ETC_DIR}/pki - _POST_NEON_PIP_INSTALL_ARGS="--prefix=/usr/local" -} - -install_freebsd_deps() { - __configure_freebsd_pkg_details - pkg install -y pkg -} - -install_freebsd_git_deps() { - install_freebsd_deps || return 1 - - if ! __check_command_exists git; then - /usr/local/sbin/pkg install -y git || return 1 - fi - __git_clone_and_checkout || return 1 - - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - - SALT_DEPENDENCIES=$(/usr/local/sbin/pkg rquery %dn py39-salt) - # shellcheck disable=SC2086 - /usr/local/sbin/pkg install -y ${SALT_DEPENDENCIES} python || return 1 - - /usr/local/sbin/pkg install -y py39-requests || return 1 - /usr/local/sbin/pkg install -y py39-tornado4 || return 1 - - else - /usr/local/sbin/pkg install -y python py39-pip py39-setuptools libzmq4 libunwind || return 1 - fi - - echodebug "Adapting paths to FreeBSD" - # The list of files was taken from Salt's BSD port Makefile - for file in doc/man/salt-key.1 doc/man/salt-cp.1 doc/man/salt-minion.1 \ - doc/man/salt-syndic.1 doc/man/salt-master.1 doc/man/salt-run.1 \ - doc/man/salt.7 doc/man/salt.1 doc/man/salt-call.1; do - [ ! -f $file ] && continue - echodebug "Patching ${file}" - sed -in -e "s|/etc/salt|${_SALT_ETC_DIR}|" \ - -e "s|/srv/salt|${_SALT_ETC_DIR}/states|" \ - -e "s|/srv/pillar|${_SALT_ETC_DIR}/pillar|" ${file} - done - if [ ! -f salt/syspaths.py ]; then - # We still can't provide the system paths, salt 0.16.x - # Let's patch salt's source and adapt paths to what's expected on FreeBSD - echodebug "Replacing occurrences of '/etc/salt' with ${_SALT_ETC_DIR}" - # The list of files was taken from Salt's BSD port Makefile - for file in conf/minion conf/master salt/config.py salt/client.py \ - salt/modules/mysql.py salt/utils/parsers.py salt/modules/tls.py \ - salt/modules/postgres.py salt/utils/migrations.py; do - [ ! -f $file ] && continue - echodebug "Patching ${file}" - sed -in -e "s|/etc/salt|${_SALT_ETC_DIR}|" \ - -e "s|/srv/salt|${_SALT_ETC_DIR}/states|" \ - -e "s|/srv/pillar|${_SALT_ETC_DIR}/pillar|" ${file} - done - fi - echodebug "Finished patching" - - # Let's trigger config_salt() - if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" - CONFIG_SALT_FUNC="config_salt" - - fi - - return 0 -} - -install_freebsd_stable() { -# -# installing latest version of salt from FreeBSD CURRENT ports repo -# - # shellcheck disable=SC2086 - /usr/local/sbin/pkg install -y py39-salt || return 1 - - return 0 -} - -install_freebsd_git() { - - # /usr/local/bin/python3 in FreeBSD is a symlink to /usr/local/bin/python3.7 - __PYTHON_PATH=$(readlink -f "$(command -v python3)") - __ESCAPED_PYTHON_PATH=$(echo "${__PYTHON_PATH}" | sed 's/\//\\\//g') - - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - __install_salt_from_repo_post_neon "${__PYTHON_PATH}" || return 1 - for script in salt_api salt_master salt_minion salt_proxy salt_syndic; do - __fetch_url "/usr/local/etc/rc.d/${script}" "https://raw.githubusercontent.com/freebsd/freebsd-ports/master/sysutils/py-salt/files/${script}.in" || return 1 - sed -i '' 's/%%PREFIX%%/\/usr\/local/g' /usr/local/etc/rc.d/${script} - sed -i '' "s/%%PYTHON_CMD%%/${__ESCAPED_PYTHON_PATH}/g" /usr/local/etc/rc.d/${script} - chmod +x /usr/local/etc/rc.d/${script} || return 1 - done - - return 0 - fi - - # Install from git - if [ ! -f salt/syspaths.py ]; then - # We still can't provide the system paths, salt 0.16.x - ${__PYTHON_PATH} setup.py ${SETUP_PY_INSTALL_ARGS} install || return 1 - else - ${__PYTHON_PATH} setup.py \ - --salt-root-dir=/ \ - --salt-config-dir="${_SALT_ETC_DIR}" \ - --salt-cache-dir="${_SALT_CACHE_DIR}" \ - --salt-sock-dir=/var/run/salt \ - --salt-srv-root-dir="${_SALT_ETC_DIR}" \ - --salt-base-file-roots-dir="${_SALT_ETC_DIR}/states" \ - --salt-base-pillar-roots-dir="${_SALT_ETC_DIR}/pillar" \ - --salt-base-master-roots-dir="${_SALT_ETC_DIR}/salt-master" \ - --salt-logs-dir=/var/log/salt \ - --salt-pidfile-dir=/var/run \ - ${SETUP_PY_INSTALL_ARGS} install \ - || return 1 - fi - - for script in salt_api salt_master salt_minion salt_proxy salt_syndic; do - __fetch_url "/usr/local/etc/rc.d/${script}" "https://raw.githubusercontent.com/freebsd/freebsd-ports/master/sysutils/py-salt/files/${script}.in" || return 1 - sed -i '' 's/%%PREFIX%%/\/usr\/local/g' /usr/local/etc/rc.d/${script} - sed -i '' "s/%%PYTHON_CMD%%/${__ESCAPED_PYTHON_PATH}/g" /usr/local/etc/rc.d/${script} - chmod +x /usr/local/etc/rc.d/${script} || return 1 - done - - # And we're good to go - return 0 -} - -install_freebsd_stable_post() { - for fname in api master minion syndic; do - # Skip salt-api since the service should be opt-in and not necessarily started on boot - [ $fname = "api" ] && continue - - # Skip if not meant to be installed - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - - enable_string="salt_${fname}_enable=YES" - grep "$enable_string" /etc/rc.conf >/dev/null 2>&1 - [ $? -eq 1 ] && sysrc $enable_string - - done -} - -install_freebsd_git_post() { - install_freebsd_stable_post || return 1 - return 0 -} - -install_freebsd_restart_daemons() { - [ $_START_DAEMONS -eq $BS_FALSE ] && return - - for fname in api master minion syndic; do - # Skip salt-api since the service should be opt-in and not necessarily started on boot - [ $fname = "api" ] && continue - - # Skip if not meant to be installed - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - - service salt_$fname stop > /dev/null 2>&1 - service salt_$fname start - done -} - -install_freebsd_onedir() { -# -# call install_freebsd_stable -# - install_freebsd_stable || return 1 - - return 0 -} -# -# Ended FreeBSD Install Functions -# -####################################################################################################################### - -####################################################################################################################### -# -# OpenBSD Install Functions -# - -install_openbsd_deps() { - if [ $_DISABLE_REPOS -eq $BS_FALSE ]; then - OPENBSD_REPO='https://cdn.openbsd.org/pub/OpenBSD' - echoinfo "setting package repository to $OPENBSD_REPO" - echo "${OPENBSD_REPO}" >/etc/installurl || return 1 - fi - - if [ "${_EXTRA_PACKAGES}" != "" ]; then - echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}" - # shellcheck disable=SC2086 - pkg_add -I -v ${_EXTRA_PACKAGES} || return 1 - fi - return 0 -} - -install_openbsd_git_deps() { - install_openbsd_deps || return 1 - - if ! __check_command_exists git; then - pkg_add -I -v git || return 1 - fi - __git_clone_and_checkout || return 1 - - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - pkg_add -I -v py3-pip py3-setuptools - fi - - # - # Let's trigger config_salt() - # - if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" - CONFIG_SALT_FUNC="config_salt" - fi - - return 0 -} - -install_openbsd_git() { - # - # Install from git - # - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - return 0 - fi - - if [ ! -f salt/syspaths.py ]; then - # We still can't provide the system paths, salt 0.16.x - /usr/local/bin/python2.7 setup.py ${SETUP_PY_INSTALL_ARGS} install || return 1 - fi - return 0 -} - -install_openbsd_stable() { - pkg_add -r -I -v salt || return 1 - return 0 -} - -install_openbsd_post() { - for fname in api master minion syndic; do - [ $fname = "api" ] && continue - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - - rcctl enable salt_$fname - done - - return 0 -} - -install_openbsd_check_services() { - for fname in api master minion syndic; do - # Skip salt-api since the service should be opt-in and not necessarily started on boot - [ $fname = "api" ] && continue - - # Skip if not meant to be installed - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && continue - - if [ -f /etc/rc.d/salt_${fname} ]; then - __check_services_openbsd salt_${fname} || return 1 - fi - done - - return 0 -} - -install_openbsd_restart_daemons() { - [ $_START_DAEMONS -eq $BS_FALSE ] && return - - for fname in api master minion syndic; do - # Skip salt-api since the service should be opt-in and not necessarily started on boot - [ $fname = "api" ] && continue - - # Skip if not meant to be installed - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - - rcctl restart salt_${fname} - done - - return 0 -} - -install_openbsd_onedir() { -# -# Call install_openbsd_stable -# - install_openbsd_stable || return 1 - - return 0 -} -# -# Ended OpenBSD Install Functions -# -####################################################################################################################### - -####################################################################################################################### -# -# SmartOS Install Functions -# -install_smartos_deps() { - smartos_deps="$(pkgin show-deps salt | grep '^\s' | grep -v '\snot' | xargs) py27-m2crypto" - pkgin -y install "${smartos_deps}" || return 1 - - # Set _SALT_ETC_DIR to SmartOS default if they didn't specify - _SALT_ETC_DIR=${BS_SALT_ETC_DIR:-/opt/local/etc/salt} - # We also need to redefine the PKI directory - _PKI_DIR=${_SALT_ETC_DIR}/pki - - # Let's trigger config_salt() - if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - # Let's set the configuration directory to /tmp - _TEMP_CONFIG_DIR="/tmp" - CONFIG_SALT_FUNC="config_salt" - - # Let's download, since they were not provided, the default configuration files - if [ ! -f "$_SALT_ETC_DIR/minion" ] && [ ! -f "$_TEMP_CONFIG_DIR/minion" ]; then - # shellcheck disable=SC2086 - curl $_CURL_ARGS -s -o "$_TEMP_CONFIG_DIR/minion" -L \ - https://raw.githubusercontent.com/saltstack/salt/master/conf/minion || return 1 - fi - if [ ! -f "$_SALT_ETC_DIR/master" ] && [ ! -f $_TEMP_CONFIG_DIR/master ]; then - # shellcheck disable=SC2086 - curl $_CURL_ARGS -s -o "$_TEMP_CONFIG_DIR/master" -L \ - https://raw.githubusercontent.com/saltstack/salt/master/conf/master || return 1 - fi - fi - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - pkgin -y install py27-apache-libcloud || return 1 - fi - - if [ "${_EXTRA_PACKAGES}" != "" ]; then - echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}" - # shellcheck disable=SC2086 - pkgin -y install ${_EXTRA_PACKAGES} || return 1 - fi - - return 0 -} - -install_smartos_git_deps() { - install_smartos_deps || return 1 - - if ! __check_command_exists git; then - pkgin -y install git || return 1 - fi - - __git_clone_and_checkout || return 1 - - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # Install whichever tornado is in the requirements file - __REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - __check_pip_allowed "You need to allow pip based installations (-P) in order to install the python package '${__REQUIRED_TORNADO}'" - - # Install whichever futures is in the requirements file - __REQUIRED_FUTURES="$(grep futures "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - __check_pip_allowed "You need to allow pip based installations (-P) in order to install the python package '${__REQUIRED_FUTURES}'" - - if [ "${__REQUIRED_TORNADO}" != "" ]; then - if ! __check_command_exists pip; then - pkgin -y install py27-pip - fi - pip install -U "${__REQUIRED_TORNADO}" - fi - - if [ "${__REQUIRED_FUTURES}" != "" ]; then - if ! __check_command_exists pip; then - pkgin -y install py27-pip - fi - pip install -U "${__REQUIRED_FUTURES}" - fi - fi - else - if ! __check_command_exists pip; then - pkgin -y install py27-pip - fi - pkgin -y install py27-setuptools - fi - - # Let's trigger config_salt() - if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" - CONFIG_SALT_FUNC="config_salt" - fi - - return 0 -} - -install_smartos_stable() { - pkgin -y install salt || return 1 - return 0 -} - -install_smartos_git() { - - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - return 0 - fi - - # Use setuptools in order to also install dependencies - # lets force our config path on the setup for now, since salt/syspaths.py only got fixed in 2015.5.0 - USE_SETUPTOOLS=1 /opt/local/bin/python setup.py --salt-config-dir="$_SALT_ETC_DIR" --salt-cache-dir="${_SALT_CACHE_DIR}" ${SETUP_PY_INSTALL_ARGS} install || return 1 - return 0 -} - -install_smartos_post() { - smf_dir="/opt/custom/smf" - - # Install manifest files if needed. - for fname in api master minion syndic; do - # Skip if not meant to be installed - [ $fname = "api" ] && \ - ([ "$_INSTALL_MASTER" -eq $BS_FALSE ] || ! __check_command_exists "salt-${fname}") && continue - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - - svcs network/salt-$fname > /dev/null 2>&1 - if [ $? -eq 1 ]; then - if [ ! -f "$_TEMP_CONFIG_DIR/salt-$fname.xml" ]; then - # shellcheck disable=SC2086 - curl $_CURL_ARGS -s -o "$_TEMP_CONFIG_DIR/salt-$fname.xml" -L \ - "https://raw.githubusercontent.com/saltstack/salt/master/pkg/smartos/salt-$fname.xml" - fi - svccfg import "$_TEMP_CONFIG_DIR/salt-$fname.xml" - if [ "${VIRTUAL_TYPE}" = "global" ]; then - if [ ! -d "$smf_dir" ]; then - mkdir -p "$smf_dir" || return 1 - fi - if [ ! -f "$smf_dir/salt-$fname.xml" ]; then - __copyfile "$_TEMP_CONFIG_DIR/salt-$fname.xml" "$smf_dir/" || return 1 - fi - fi - fi - done - - return 0 -} - -install_smartos_git_post() { - smf_dir="/opt/custom/smf" - - # Install manifest files if needed. - for fname in api master minion syndic; do - # Skip if not meant to be installed - [ $fname = "api" ] && \ - ([ "$_INSTALL_MASTER" -eq $BS_FALSE ] || ! __check_command_exists "salt-${fname}") && continue - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - - svcs "network/salt-$fname" > /dev/null 2>&1 - if [ $? -eq 1 ]; then - svccfg import "${_SALT_GIT_CHECKOUT_DIR}/pkg/smartos/salt-$fname.xml" - if [ "${VIRTUAL_TYPE}" = "global" ]; then - if [ ! -d $smf_dir ]; then - mkdir -p "$smf_dir" - fi - if [ ! -f "$smf_dir/salt-$fname.xml" ]; then - __copyfile "${_SALT_GIT_CHECKOUT_DIR}/pkg/smartos/salt-$fname.xml" "$smf_dir/" - fi - fi - fi - done - - return 0 -} - -install_smartos_restart_daemons() { - [ $_START_DAEMONS -eq $BS_FALSE ] && return - - for fname in api master minion syndic; do - # Skip salt-api since the service should be opt-in and not necessarily started on boot - [ $fname = "api" ] && continue - - # Skip if not meant to be installed - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - - # Stop if running && Start service - svcadm disable salt-$fname > /dev/null 2>&1 - svcadm enable salt-$fname - done - - return 0 -} -install_smartos_onedir() { -# -# call install_smartos_stable -# - install_smartos_stable || return 1 - - return 0 -} -# -# Ended SmartOS Install Functions -# -####################################################################################################################### ####################################################################################################################### # @@ -7844,7 +6452,7 @@ __zypper_install() { __opensuse_prep_install() { # DRY function for common installation preparatory steps for SUSE - if [ $_DISABLE_REPOS -eq $BS_FALSE ]; then + if [ "$_DISABLE_REPOS" -eq $BS_FALSE ]; then # Is the repository already known __set_suse_pkg_repo # Check zypper repos and refresh if necessary @@ -7876,7 +6484,7 @@ install_opensuse_stable_deps() { # YAML module is used for generating custom master/minion configs # requests is still used by many salt modules # Salt needs python-zypp installed in order to use the zypper module - __PACKAGES="python-PyYAML python-requests python-zypp" + __PACKAGES="python${PY_PKG_VER}-PyYAML python${PY_PKG_VER}-requests python${PY_PKG_VER}-zypp" # shellcheck disable=SC2086 __zypper_install ${__PACKAGES} || return 1 @@ -7903,27 +6511,11 @@ install_opensuse_git_deps() { __git_clone_and_checkout || return 1 - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - __zypper_install patch || return 1 - - __PACKAGES="libzmq5 python-Jinja2 python-m2crypto python-msgpack-python python-pycrypto python-pyzmq python-xml python-futures" - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # We're on the master branch, install whichever tornado is on the requirements file - __REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - if [ "${__REQUIRED_TORNADO}" != "" ]; then - __PACKAGES="${__PACKAGES} python-tornado" - fi - fi - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} python-apache-libcloud" - fi # Check for Tumbleweed - elif [ "${DISTRO_MAJOR_VERSION}" -ge 20210101 ]; then + if [ "${DISTRO_MAJOR_VERSION}" -ge 20210101 ]; then __PACKAGES="python3-pip gcc-c++ python3-pyzmq-devel" else - __PACKAGES="python-pip python-setuptools gcc" + __PACKAGES="python3-pip python3-setuptools gcc" fi # shellcheck disable=SC2086 @@ -7931,7 +6523,7 @@ install_opensuse_git_deps() { # Let's trigger config_salt() if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" CONFIG_SALT_FUNC="config_salt" fi @@ -7958,6 +6550,10 @@ install_opensuse_stable() { __PACKAGES="${__PACKAGES} salt-syndic" fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ]; then + __PACKAGES="${__PACKAGES} salt-api" + fi + # shellcheck disable=SC2086 __zypper_install $__PACKAGES || return 1 @@ -7965,12 +6561,7 @@ install_opensuse_stable() { } install_opensuse_git() { - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - return 0 - fi - - python setup.py ${SETUP_PY_INSTALL_ARGS} install --prefix=/usr || return 1 + __install_salt_from_repo "${_PY_EXE}" || return 1 return 0 } @@ -7988,7 +6579,7 @@ install_opensuse_stable_post() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /bin/systemctl ] || [ -f /usr/bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then systemctl is-enabled salt-$fname.service || (systemctl preset salt-$fname.service && systemctl enable salt-$fname.service) sleep 1 systemctl daemon-reload @@ -8011,7 +6602,7 @@ install_opensuse_git_post() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if command -v systemctl; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then use_usr_lib=$BS_FALSE if [ "${DISTRO_MAJOR_VERSION}" -ge 15 ]; then @@ -8052,7 +6643,7 @@ install_opensuse_onedir_post() { } install_opensuse_restart_daemons() { - [ $_START_DAEMONS -eq $BS_FALSE ] && return + [ "$_START_DAEMONS" -eq $BS_FALSE ] && return for fname in api master minion syndic; do # Skip salt-api since the service should be opt-in and not necessarily started on boot @@ -8063,7 +6654,7 @@ install_opensuse_restart_daemons() { [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - if [ -f /bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then systemctl stop salt-$fname > /dev/null 2>&1 systemctl start salt-$fname.service && continue echodebug "Failed to start salt-$fname using systemd" @@ -8079,7 +6670,7 @@ install_opensuse_restart_daemons() { } install_opensuse_check_services() { - if [ ! -f /bin/systemctl ]; then + if [ "$_SYSTEMD_FUNCTIONAL" -eq $BS_TRUE ]; then # Not running systemd!? Don't check! return 0 fi @@ -8113,11 +6704,10 @@ install_opensuse_15_stable_deps() { # SUSE only packages Salt for Python 3 on Leap 15 # Py3 is the default bootstrap install for Leap 15 - # However, git installs might specify "-x python2" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 2 ]; then - PY_PKG_VER=2 - else - PY_PKG_VER=3 + # However, git installs that specify "-x python2" are disallowed + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi # YAML module is used for generating custom master/minion configs @@ -8145,47 +6735,20 @@ install_opensuse_15_git_deps() { __git_clone_and_checkout || return 1 - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 2 ]; then - PY_PKG_VER=2 - else - PY_PKG_VER=3 + if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -ne 3 ]; then + echoerror "Python version is no longer supported, only Python 3" + return 1 fi - __PACKAGES="python${PY_PKG_VER}-xml" - - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - - # Py3 is the default bootstrap install for Leap 15 - # However, git installs might specify "-x python2" - if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 2 ]; then - # This is required by some of the python2 packages below - __PACKAGES="${__PACKAGES} libpython2_7-1_0 python2-futures python-ipaddress" - fi - - __PACKAGES="${__PACKAGES} libzmq5 python${PY_PKG_VER}-Jinja2 python${PY_PKG_VER}-msgpack" - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-pycrypto python${PY_PKG_VER}-pyzmq" - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # We're on the master branch, install whichever tornado is on the requirements file - __REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - if [ "${__REQUIRED_TORNADO}" != "" ]; then - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-tornado" - fi - fi - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-apache-libcloud" - fi - else - __PACKAGES="${__PACKAGES} python${PY_PKG_VER}-devel python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" - fi + PY_PKG_VER=3 + __PACKAGES="python${PY_PKG_VER}-xml python${PY_PKG_VER}-devel python${PY_PKG_VER}-pip python${PY_PKG_VER}-setuptools gcc" # shellcheck disable=SC2086 __zypper_install ${__PACKAGES} || return 1 # Let's trigger config_salt() if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" + _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf" CONFIG_SALT_FUNC="config_salt" fi @@ -8196,17 +6759,12 @@ install_opensuse_15_git() { # Py3 is the default bootstrap install for Leap 15 if [ -n "$_PY_EXE" ]; then - _PYEXE=${_PY_EXE} + _PYEXE="${_PY_EXE}" else _PYEXE=python3 fi - if [ "${_POST_NEON_INSTALL}" -eq $BS_TRUE ]; then - __install_salt_from_repo_post_neon "${_PY_EXE}" || return 1 - return 0 - fi - - ${_PYEXE} setup.py ${SETUP_PY_INSTALL_ARGS} install --prefix=/usr || return 1 + __install_salt_from_repo "${_PY_EXE}" || return 1 return 0 } @@ -8291,266 +6849,6 @@ install_suse_15_restart_daemons() { # ####################################################################################################################### -####################################################################################################################### -# -# SUSE Enterprise 12 -# - -install_suse_12_stable_deps() { - __opensuse_prep_install || return 1 - - # YAML module is used for generating custom master/minion configs - # requests is still used by many salt modules - # Salt needs python-zypp installed in order to use the zypper module - __PACKAGES="python-PyYAML python-requests python-zypp" - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} python-apache-libcloud" - fi - - # shellcheck disable=SC2086,SC2090 - __zypper_install ${__PACKAGES} || return 1 - - # SLES 11 SP3 ships with both python-M2Crypto-0.22.* and python-m2crypto-0.21 and we will be asked which - # we want to install, even with --non-interactive. - # Let's try to install the higher version first and then the lower one in case of failure - __zypper_install 'python-M2Crypto>=0.22' || __zypper_install 'python-M2Crypto>=0.21' || return 1 - - if [ "${_EXTRA_PACKAGES}" != "" ]; then - echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}" - # shellcheck disable=SC2086 - __zypper_install ${_EXTRA_PACKAGES} || return 1 - fi - - return 0 -} - -install_suse_12_git_deps() { - install_suse_12_stable_deps || return 1 - - if ! __check_command_exists git; then - __zypper_install git-core || return 1 - fi - - __git_clone_and_checkout || return 1 - - __PACKAGES="" - # shellcheck disable=SC2089 - __PACKAGES="${__PACKAGES} libzmq4 python-Jinja2 python-msgpack-python python-pycrypto" - __PACKAGES="${__PACKAGES} python-pyzmq python-xml" - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # We're on the master branch, install whichever tornado is on the requirements file - __REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - if [ "${__REQUIRED_TORNADO}" != "" ]; then - __PACKAGES="${__PACKAGES} python-tornado" - fi - fi - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} python-apache-libcloud" - fi - - # shellcheck disable=SC2086 - __zypper_install ${__PACKAGES} || return 1 - - # Let's trigger config_salt() - if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" - CONFIG_SALT_FUNC="config_salt" - fi - - return 0 -} - -install_suse_12_onedir_deps() { - install_suse_12_stable_deps || return 1 - return 0 -} - -install_suse_12_stable() { - install_opensuse_stable || return 1 - return 0 -} - -install_suse_12_git() { - install_opensuse_git || return 1 - return 0 -} - -install_suse_12_onedir() { - install_opensuse_stable || return 1 - return 0 -} - -install_suse_12_stable_post() { - install_opensuse_stable_post || return 1 - return 0 -} - -install_suse_12_git_post() { - install_opensuse_git_post || return 1 - return 0 -} - -install_suse_12_onedir_post() { - install_opensuse_stable_post || return 1 - return 0 -} - -install_suse_12_restart_daemons() { - install_opensuse_restart_daemons || return 1 - return 0 -} - -# -# End of SUSE Enterprise 12 -# -####################################################################################################################### - -####################################################################################################################### -# -# SUSE Enterprise 11 -# - -install_suse_11_stable_deps() { - __opensuse_prep_install || return 1 - - # YAML module is used for generating custom master/minion configs - __PACKAGES="python-PyYAML" - - # shellcheck disable=SC2086,SC2090 - __zypper_install ${__PACKAGES} || return 1 - - # SLES 11 SP3 ships with both python-M2Crypto-0.22.* and python-m2crypto-0.21 and we will be asked which - # we want to install, even with --non-interactive. - # Let's try to install the higher version first and then the lower one in case of failure - __zypper_install 'python-M2Crypto>=0.22' || __zypper_install 'python-M2Crypto>=0.21' || return 1 - - if [ "${_EXTRA_PACKAGES}" != "" ]; then - echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}" - # shellcheck disable=SC2086 - __zypper_install ${_EXTRA_PACKAGES} || return 1 - fi - - return 0 -} - -install_suse_11_git_deps() { - install_suse_11_stable_deps || return 1 - - if ! __check_command_exists git; then - __zypper_install git || return 1 - fi - - __git_clone_and_checkout || return 1 - - __PACKAGES="" - # shellcheck disable=SC2089 - __PACKAGES="${__PACKAGES} libzmq4 python-Jinja2 python-msgpack-python python-pycrypto" - __PACKAGES="${__PACKAGES} python-pyzmq python-xml python-zypp" - - if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then - # We're on the master branch, install whichever tornado is on the requirements file - __REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")" - if [ "${__REQUIRED_TORNADO}" != "" ]; then - __PACKAGES="${__PACKAGES} python-tornado" - fi - fi - - if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then - __PACKAGES="${__PACKAGES} python-apache-libcloud" - fi - - # shellcheck disable=SC2086 - __zypper_install ${__PACKAGES} || return 1 - - # Let's trigger config_salt() - if [ "$_TEMP_CONFIG_DIR" = "null" ]; then - _TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/" - CONFIG_SALT_FUNC="config_salt" - fi - - return 0 -} - -install_suse_11_onedir_deps() { - install_suse_11_stable_deps || return 1 - return 0 -} - -install_suse_11_stable() { - install_opensuse_stable || return 1 - return 0 -} - -install_suse_11_git() { - install_opensuse_git || return 1 - return 0 -} - -install_suse_11_onedir() { - install_opensuse_stable || return 1 - return 0 -} - -install_suse_11_stable_post() { - install_opensuse_stable_post || return 1 - return 0 -} - -install_suse_11_git_post() { - install_opensuse_git_post || return 1 - return 0 -} - -install_suse_11_onedir_post() { - install_opensuse_stable_post || return 1 - return 0 -} - -install_suse_11_restart_daemons() { - install_opensuse_restart_daemons || return 1 - return 0 -} - - -# -# End of SUSE Enterprise 11 -# -####################################################################################################################### - -####################################################################################################################### -# -# SUSE Enterprise General Functions -# - -# Used for both SLE 11 and 12 -install_suse_check_services() { - if [ ! -f /bin/systemctl ]; then - # Not running systemd!? Don't check! - return 0 - fi - - for fname in api master minion syndic; do - # Skip salt-api since the service should be opt-in and not necessarily started on boot - [ $fname = "api" ] && continue - - # Skip if not meant to be installed - [ $fname = "master" ] && [ "$_INSTALL_MASTER" -eq $BS_FALSE ] && continue - [ $fname = "minion" ] && [ "$_INSTALL_MINION" -eq $BS_FALSE ] && continue - [ $fname = "syndic" ] && [ "$_INSTALL_SYNDIC" -eq $BS_FALSE ] && continue - - __check_services_systemd salt-$fname || return 1 - done - - return 0 -} - -# -# End of SUSE Enterprise General Functions -# -####################################################################################################################### ####################################################################################################################### # @@ -8608,9 +6906,15 @@ __gentoo_pre_dep() { mkdir /etc/portage fi - # Enable Python 3.7 target for Salt Neon using GIT - if [ "${ITYPE}" = "git" ] && [ "${GIT_REV}" = "v3000" ]; then - EXTRA_PYTHON_TARGET=python3_7 + # Enable Python 3.10 target for Salt 3006 or later, otherwise 3.7 as previously, using GIT + if [ "${ITYPE}" = "git" ]; then + GIT_REV_MAJOR=$(echo "${GIT_REV}" | awk -F "." '{print $1}') + if [ "${GIT_REV_MAJOR}" = "v3006" ] || [ "${GIT_REV_MAJOR}" = "v3007" ]; then + EXTRA_PYTHON_TARGET=python3_10 + else + # assume pre-3006, so leave it as Python 3.7 + EXTRA_PYTHON_TARGET=python3_7 + fi fi if [ -n "${EXTRA_PYTHON_TARGET:-}" ]; then @@ -8626,7 +6930,6 @@ __gentoo_post_dep() { echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}" # shellcheck disable=SC2086 __autounmask ${_EXTRA_PACKAGES} || return 1 - # shellcheck disable=SC2086 __emerge ${_EXTRA_PACKAGES} || return 1 fi @@ -8670,27 +6973,6 @@ install_gentoo_git_deps() { GENTOO_GIT_PACKAGES="${GENTOO_GIT_PACKAGES:-} dev-vcs/git" fi - # Salt <3000 does not automatically install dependencies. It has to be done manually. - if [ "${_POST_NEON_INSTALL}" -eq $BS_FALSE ]; then - GENTOO_GIT_PACKAGES="${GENTOO_GIT_PACKAGES:-} - sys-apps/pciutils - dev-python/pyyaml - dev-python/pyzmq - dev-python/libnacl - dev-python/pycryptodome - dev-python/py - dev-python/requests - /etc/paths.d/salt fi @@ -9159,17 +7404,20 @@ install_macosx_stable_post() { } install_macosx_onedir_post() { + install_macosx_stable_post || return 1 return 0 } install_macosx_git_post() { + install_macosx_stable_post || return 1 return 0 } install_macosx_restart_daemons() { - [ $_START_DAEMONS -eq $BS_FALSE ] && return + + [ "$_START_DAEMONS" -eq $BS_FALSE ] && return if [ "$_INSTALL_MINION" -eq $BS_TRUE ]; then /bin/launchctl unload -w /Library/LaunchDaemons/com.saltstack.salt.minion.plist || return 1 @@ -9194,6 +7442,7 @@ install_macosx_restart_daemons() { # the -c options is passed. # config_salt() { + # If the configuration directory is not passed, return [ "$_TEMP_CONFIG_DIR" = "null" ] && return @@ -9237,7 +7486,7 @@ config_salt() { # Check if a minion config file already exists and move to .bak if needed if [ -f "$_SALT_ETC_DIR/minion" ] && [ "$CREATE_BAK" -eq "$BS_TRUE" ]; then - __movefile "$_SALT_ETC_DIR/minion" "$_SALT_ETC_DIR/minion.bak" $BS_TRUE || return 1 + __movefile "$_SALT_ETC_DIR/minion" "$_SALT_ETC_DIR/minion.bak" "$BS_TRUE" || return 1 CONFIGURED_ANYTHING=$BS_TRUE fi @@ -9280,8 +7529,11 @@ config_salt() { if [ "$_INSTALL_SYNDIC" -eq $BS_TRUE ] && [ "$_CONFIG_ONLY" -eq $BS_TRUE ]; then OVERWRITE_MASTER_CONFIGS=$BS_TRUE fi + if [ "$_INSTALL_SALT_API" -eq $BS_TRUE ] && [ "$_CONFIG_ONLY" -eq $BS_TRUE ]; then + OVERWRITE_MASTER_CONFIGS=$BS_TRUE + fi - if [ "$_INSTALL_MASTER" -eq $BS_TRUE ] || [ "$_INSTALL_SYNDIC" -eq $BS_TRUE ] || [ "$OVERWRITE_MASTER_CONFIGS" -eq $BS_TRUE ] || [ "$_CUSTOM_MASTER_CONFIG" != "null" ]; then + if [ "$_INSTALL_MASTER" -eq $BS_TRUE ] || [ "$_INSTALL_SYNDIC" -eq $BS_TRUE ] || [ "$_INSTALL_SALT_API" -eq $BS_TRUE ] || [ "$OVERWRITE_MASTER_CONFIGS" -eq $BS_TRUE ] || [ "$_CUSTOM_MASTER_CONFIG" != "null" ]; then # Create the PKI directory [ -d "$_PKI_DIR/master" ] || (mkdir -p "$_PKI_DIR/master" && chmod 700 "$_PKI_DIR/master") || return 1 @@ -9290,7 +7542,7 @@ config_salt() { # Check if a master config file already exists and move to .bak if needed if [ -f "$_SALT_ETC_DIR/master" ] && [ "$CREATE_BAK" -eq "$BS_TRUE" ]; then - __movefile "$_SALT_ETC_DIR/master" "$_SALT_ETC_DIR/master.bak" $BS_TRUE || return 1 + __movefile "$_SALT_ETC_DIR/master" "$_SALT_ETC_DIR/master.bak" "$BS_TRUE" || return 1 CONFIGURED_ANYTHING=$BS_TRUE fi @@ -9304,7 +7556,7 @@ config_salt() { CONFIGURED_ANYTHING=$BS_TRUE fi - # Copy the master's keys if found + # Copy the masters keys if found if [ -f "$_TEMP_CONFIG_DIR/master.pem" ]; then __movefile "$_TEMP_CONFIG_DIR/master.pem" "$_PKI_DIR/master/" || return 1 chmod 400 "$_PKI_DIR/master/master.pem" || return 1 @@ -9334,7 +7586,7 @@ config_salt() { done fi - if [ "$_CONFIG_ONLY" -eq $BS_TRUE ] && [ $CONFIGURED_ANYTHING -eq $BS_FALSE ]; then + if [ "$_CONFIG_ONLY" -eq $BS_TRUE ] && [ "$CONFIGURED_ANYTHING" -eq $BS_FALSE ]; then echowarn "No configuration or keys were copied over. No configuration was done!" exit 0 fi @@ -9352,6 +7604,7 @@ config_salt() { # as long as the -k option is passed. # preseed_master() { + # Create the PKI directory if [ "$(find "$_TEMP_KEYS_DIR" -maxdepth 1 -type f | wc -l)" -lt 1 ]; then @@ -9386,6 +7639,7 @@ preseed_master() { # This function checks if all of the installed daemons are running or not. # daemons_running_onedir() { + [ "$_START_DAEMONS" -eq $BS_FALSE ] && return 0 FAILED_DAEMONS=0 @@ -9423,6 +7677,7 @@ daemons_running_onedir() { # This function checks if all of the installed daemons are running or not. # daemons_running() { + [ "$_START_DAEMONS" -eq $BS_FALSE ] && return 0 FAILED_DAEMONS=0 @@ -9437,7 +7692,7 @@ daemons_running() { # shellcheck disable=SC2009 if [ "${DISTRO_NAME}" = "SmartOS" ]; then - if [ "$(svcs -Ho STA salt-$fname)" != "ON" ]; then + if [ "$(svcs -Ho STA "salt-$fname")" != "ON" ]; then echoerror "salt-$fname was not found running" FAILED_DAEMONS=$((FAILED_DAEMONS + 1)) fi @@ -9447,7 +7702,7 @@ daemons_running() { fi done - return $FAILED_DAEMONS + return ${FAILED_DAEMONS} } # # Ended daemons running check function @@ -9470,9 +7725,10 @@ if [ ${_NO_DEPS} -eq $BS_FALSE ]; then fi DEPS_INSTALL_FUNC="null" -for FUNC_NAME in $(__strip_duplicates "$DEP_FUNC_NAMES"); do - if __function_defined "$FUNC_NAME"; then - DEPS_INSTALL_FUNC="$FUNC_NAME" +# shellcheck disable=SC2086 +for FUNC_NAME in $(__strip_duplicates ${DEP_FUNC_NAMES}); do + if __function_defined ${FUNC_NAME}; then + DEPS_INSTALL_FUNC=${FUNC_NAME} break fi done @@ -9582,7 +7838,7 @@ for FUNC_NAME in $(__strip_duplicates "$DAEMONS_RUNNING_FUNC_NAMES"); do done echodebug "DAEMONS_RUNNING_FUNC=${DAEMONS_RUNNING_FUNC}" -# Let's get the check services function +# Lets get the check services function if [ ${_DISABLE_SALT_CHECKS} -eq $BS_FALSE ]; then CHECK_SERVICES_FUNC_NAMES="install_${DISTRO_NAME_L}${PREFIXED_DISTRO_MAJOR_VERSION}_${ITYPE}_check_services" CHECK_SERVICES_FUNC_NAMES="$CHECK_SERVICES_FUNC_NAMES install_${DISTRO_NAME_L}${PREFIXED_DISTRO_MAJOR_VERSION}${PREFIXED_DISTRO_MINOR_VERSION}_${ITYPE}_check_services" @@ -9615,7 +7871,7 @@ fi # Install dependencies -if [ ${_NO_DEPS} -eq $BS_FALSE ] && [ $_CONFIG_ONLY -eq $BS_FALSE ]; then +if [ "${_NO_DEPS}" -eq $BS_FALSE ] && [ "$_CONFIG_ONLY" -eq $BS_FALSE ]; then # Only execute function is not in config mode only echoinfo "Running ${DEPS_INSTALL_FUNC}()" if ! ${DEPS_INSTALL_FUNC}; then @@ -9639,7 +7895,7 @@ if [ "$_CUSTOM_MASTER_CONFIG" != "null" ] || [ "$_CUSTOM_MINION_CONFIG" != "null _TEMP_CONFIG_DIR="$_SALT_ETC_DIR" fi - if [ ${_NO_DEPS} -eq $BS_FALSE ] && [ $_CONFIG_ONLY -eq $BS_TRUE ]; then + if [ "${_NO_DEPS}" -eq $BS_FALSE ] && [ "$_CONFIG_ONLY" -eq $BS_TRUE ]; then # Execute function to satisfy dependencies for configuration step echoinfo "Running ${DEPS_INSTALL_FUNC}()" if ! ${DEPS_INSTALL_FUNC}; then @@ -9713,6 +7969,7 @@ fi if [ "$STARTDAEMONS_INSTALL_FUNC" != "null" ] && [ ${_START_DAEMONS} -eq $BS_TRUE ]; then echoinfo "Running ${STARTDAEMONS_INSTALL_FUNC}()" echodebug "Waiting ${_SLEEP} seconds for processes to settle before checking for them" + # shellcheck disable=SC2086 sleep ${_SLEEP} if ! ${STARTDAEMONS_INSTALL_FUNC}; then echoerror "Failed to run ${STARTDAEMONS_INSTALL_FUNC}()!!!" @@ -9724,6 +7981,7 @@ fi if [ "$DAEMONS_RUNNING_FUNC" != "null" ] && [ ${_START_DAEMONS} -eq $BS_TRUE ]; then echoinfo "Running ${DAEMONS_RUNNING_FUNC}()" echodebug "Waiting ${_SLEEP} seconds for processes to settle before checking for them" + # shellcheck disable=SC2086 sleep ${_SLEEP} # Sleep a little bit to let daemons start if ! ${DAEMONS_RUNNING_FUNC}; then echoerror "Failed to run ${DAEMONS_RUNNING_FUNC}()!!!" @@ -9746,7 +8004,7 @@ if [ "$DAEMONS_RUNNING_FUNC" != "null" ] && [ ${_START_DAEMONS} -eq $BS_TRUE ]; echodebug "Running salt-$fname by hand outputs: $(nohup salt-$fname -l debug)" - [ ! -f /var/log/salt/$fname ] && echodebug "/var/log/salt/$fname does not exist. Can't cat its contents!" && continue + [ ! -f "/var/log/salt/$fname" ] && echodebug "/var/log/salt/$fname does not exist. Can't cat its contents!" && continue echodebug "DAEMON LOGS for $fname:" echodebug "$(cat /var/log/salt/$fname)" From 61a1fbde6e4b1b143a2e167e6bd90d76b8466f88 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 9 Dec 2024 15:30:48 -0500 Subject: [PATCH 048/303] create hypervisor pillars in setup --- setup/so-functions | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup/so-functions b/setup/so-functions index 59408a69c..b2cdd56ee 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -1439,7 +1439,7 @@ make_some_dirs() { mkdir -p $local_salt_dir/salt/firewall/portgroups mkdir -p $local_salt_dir/salt/firewall/ports - for THEDIR in bpf pcap elasticsearch ntp firewall redis backup influxdb strelka sensoroni soc docker zeek suricata nginx telegraf logstash soc manager kratos idstools idh elastalert stig global kafka versionlock; do + for THEDIR in bpf pcap elasticsearch ntp firewall redis backup influxdb strelka sensoroni soc docker zeek suricata nginx telegraf logstash soc manager kratos idstools idh elastalert stig global kafka versionlock hypervisor; do mkdir -p $local_salt_dir/pillar/$THEDIR touch $local_salt_dir/pillar/$THEDIR/adv_$THEDIR.sls touch $local_salt_dir/pillar/$THEDIR/soc_$THEDIR.sls From 7eaa8d54dc75d22a271dcdd9a42c4f71e78a8ae0 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 9 Dec 2024 15:35:07 -0500 Subject: [PATCH 049/303] git ignore dirs --- .gitignore | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/.gitignore b/.gitignore index 7f446a041..1830698b0 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,3 @@ - # Created by https://www.gitignore.io/api/macos,windows # Edit at https://www.gitignore.io/?templates=macos,windows @@ -67,4 +66,10 @@ __pycache__ # Analyzer dev/test config files *_dev.yaml -site-packages \ No newline at end of file +site-packages + +# Project Scope Directory +.projectScope/ + +# vscode settings +.vscode/ From a84a32c075059ffaace45a6c407cf67e492ce804 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 10 Dec 2024 16:24:18 -0500 Subject: [PATCH 050/303] increase whiptail by 1 --- setup/so-whiptail | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup/so-whiptail b/setup/so-whiptail index b25682acd..2ea5dd38b 100755 --- a/setup/so-whiptail +++ b/setup/so-whiptail @@ -674,7 +674,7 @@ whiptail_install_type_dist_existing() { Note: Heavy nodes (HEAVYNODE) are NOT recommended for most users. EOM - install_type=$(whiptail --title "$whiptail_title" --menu "$node_msg" 19 75 6 \ + install_type=$(whiptail --title "$whiptail_title" --menu "$node_msg" 19 75 7 \ "SENSOR" "Create a forward only sensor " \ "SEARCHNODE" "Add a search node with parsing " \ "FLEET" "Dedicated Elastic Fleet Node " \ From e779d180f932033a4a4d42d18fb43a6c03be618e Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 13 Dec 2024 16:03:17 -0500 Subject: [PATCH 051/303] work around libvirt issue. add raid scripts --- salt/hypervisor/raid.sh | 19 ++ salt/hypervisor/raid2.sh | 187 ++++++++++++++++++++ salt/libvirt/64962/init.sls | 9 + salt/libvirt/64962/scripts/fix-salt-ldap.py | 75 ++++++++ salt/libvirt/init.sls | 1 + 5 files changed, 291 insertions(+) create mode 100644 salt/hypervisor/raid.sh create mode 100644 salt/hypervisor/raid2.sh create mode 100644 salt/libvirt/64962/init.sls create mode 100644 salt/libvirt/64962/scripts/fix-salt-ldap.py diff --git a/salt/hypervisor/raid.sh b/salt/hypervisor/raid.sh new file mode 100644 index 000000000..031e4c522 --- /dev/null +++ b/salt/hypervisor/raid.sh @@ -0,0 +1,19 @@ +# quick script to create raid +parted -s /dev/nvme0n1 rm 1 +parted -s /dev/nvme0n1 mklabel gpt +parted -s /dev/nvme0n1 mkpart primary xfs 0% 100% +parted -s /dev/nvme0n1 set 1 raid on +parted -s /dev/nvme1n1 rm 1 +parted -s /dev/nvme1n1 mklabel gpt +parted -s /dev/nvme1n1 mkpart primary xfs 0% 100% +parted -s /dev/nvme1n1 set 1 raid on +yes | mdadm --create /dev/md0 --level=1 --raid-devices=2 /dev/nvme0n1p1 /dev/nvme1n1p1 + +mkfs -t xfs -f /dev/md0 +echo "Create NSM mount point" +mkdir -p /nsm +echo "Add mount to fstab" +echo "/dev/md0 /nsm xfs defaults,nofail 0 0" >> /etc/fstab +echo "Mounting /nsm" +mount -a +mdadm --detail --scan --verbose >> /etc/mdadm.conf diff --git a/salt/hypervisor/raid2.sh b/salt/hypervisor/raid2.sh new file mode 100644 index 000000000..83e1970df --- /dev/null +++ b/salt/hypervisor/raid2.sh @@ -0,0 +1,187 @@ +#!/bin/bash + +# Exit on any error +set -e + +# Function to log messages +log() { + echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" +} + +# Function to check if running as root +check_root() { + if [ "$EUID" -ne 0 ]; then + log "Error: Please run as root" + exit 1 + fi +} + +# Function to check if RAID is already set up +check_existing_raid() { + if [ -e "/dev/md0" ]; then + if mdadm --detail /dev/md0 &>/dev/null; then + local raid_state=$(mdadm --detail /dev/md0 | grep "State" | awk '{print $3}') + local mount_point="/nsm" + + log "Found existing RAID array /dev/md0 (State: $raid_state)" + + if mountpoint -q "$mount_point"; then + log "RAID is already mounted at $mount_point" + log "Current RAID details:" + mdadm --detail /dev/md0 + + # Check if resyncing + if grep -q "resync" /proc/mdstat; then + log "RAID is currently resyncing:" + grep resync /proc/mdstat + log "You can monitor progress with: watch -n 60 cat /proc/mdstat" + else + log "RAID is fully synced and operational" + fi + + # Show disk usage + log "Current disk usage:" + df -h "$mount_point" + + exit 0 + fi + fi + fi + + # Check if any of the target devices are in use + for device in "/dev/nvme0n1" "/dev/nvme1n1"; do + if lsblk -o NAME,MOUNTPOINT "$device" | grep -q "nsm"; then + log "Error: $device is already mounted at /nsm" + exit 1 + fi + + if mdadm --examine "$device" &>/dev/null || mdadm --examine "${device}p1" &>/dev/null; then + log "Error: $device appears to be part of an existing RAID array" + log "To reuse this device, you must first:" + log "1. Unmount any filesystems" + log "2. Stop the RAID array: mdadm --stop /dev/md0" + log "3. Zero the superblock: mdadm --zero-superblock ${device}p1" + exit 1 + fi + done +} + +# Function to ensure devices are not in use +ensure_devices_free() { + local device=$1 + + log "Cleaning up device $device" + + # Kill any processes using the device + fuser -k "${device}"* 2>/dev/null || true + + # Force unmount any partitions + for part in "${device}"*; do + if mount | grep -q "$part"; then + umount -f "$part" 2>/dev/null || true + fi + done + + # Stop any MD arrays using this device + for md in $(ls /dev/md* 2>/dev/null || true); do + if mdadm --detail "$md" 2>/dev/null | grep -q "$device"; then + mdadm --stop "$md" 2>/dev/null || true + fi + done + + # Clear MD superblock + mdadm --zero-superblock "${device}"* 2>/dev/null || true + + # Remove LVM PV if exists + pvremove -ff -y "$device" 2>/dev/null || true + + # Clear all signatures + wipefs -af "$device" 2>/dev/null || true + + # Delete partition table + dd if=/dev/zero of="$device" bs=512 count=2048 2>/dev/null || true + dd if=/dev/zero of="$device" bs=512 seek=$(( $(blockdev --getsz "$device") - 2048 )) count=2048 2>/dev/null || true + + # Force kernel to reread + blockdev --rereadpt "$device" 2>/dev/null || true + partprobe -s "$device" 2>/dev/null || true + sleep 2 +} + +# Main script +main() { + log "Starting RAID setup script" + + # Check if running as root + check_root + + # Check for existing RAID setup + check_existing_raid + + # Clean up any existing MD arrays + log "Cleaning up existing MD arrays" + mdadm --stop --scan 2>/dev/null || true + + # Clear mdadm configuration + log "Clearing mdadm configuration" + echo "DEVICE partitions" > /etc/mdadm.conf + + # Clean and prepare devices + for device in "/dev/nvme0n1" "/dev/nvme1n1"; do + ensure_devices_free "$device" + + log "Creating new partition table on $device" + sgdisk -Z "$device" + sgdisk -o "$device" + + log "Creating RAID partition" + sgdisk -n 1:0:0 -t 1:fd00 "$device" + + partprobe "$device" + udevadm settle + sleep 5 + done + + log "Final verification of partition availability" + if ! [ -b "/dev/nvme0n1p1" ] || ! [ -b "/dev/nvme1n1p1" ]; then + log "Error: Partitions not available after creation" + exit 1 + fi + + log "Creating RAID array" + mdadm --create /dev/md0 --level=1 --raid-devices=2 \ + --metadata=1.2 \ + /dev/nvme0n1p1 /dev/nvme1n1p1 \ + --force --run + + log "Creating XFS filesystem" + mkfs.xfs -f /dev/md0 + + log "Creating mount point" + mkdir -p /nsm + + log "Updating fstab" + sed -i '/\/dev\/md0/d' /etc/fstab + echo "/dev/md0 /nsm xfs defaults,nofail 0 0" >> /etc/fstab + + log "Reloading systemd daemon" + systemctl daemon-reload + + log "Mounting filesystem" + mount -a + + log "Saving RAID configuration" + mdadm --detail --scan > /etc/mdadm.conf + + log "RAID setup complete" + log "RAID array details:" + mdadm --detail /dev/md0 + + if grep -q "resync" /proc/mdstat; then + log "RAID is currently resyncing. You can monitor progress with:" + log "watch -n 60 cat /proc/mdstat" + fi +} + +# Run main function +main "$@" diff --git a/salt/libvirt/64962/init.sls b/salt/libvirt/64962/init.sls new file mode 100644 index 000000000..81eedb09b --- /dev/null +++ b/salt/libvirt/64962/init.sls @@ -0,0 +1,9 @@ +python3_lief: + pkg.installed: + - name: securityonion-python3-lief + +fix-salt-ldap: + cmd.script: + - source: salt://libvirt/64962/scripts/fix-salt-ldap.py + - require: + - pkg: python3_lief diff --git a/salt/libvirt/64962/scripts/fix-salt-ldap.py b/salt/libvirt/64962/scripts/fix-salt-ldap.py new file mode 100644 index 000000000..56fcce8aa --- /dev/null +++ b/salt/libvirt/64962/scripts/fix-salt-ldap.py @@ -0,0 +1,75 @@ +#!/usr/bin/env python3 + +import datetime +import grp +import os +import pathlib +import pwd +import shutil +## +import dbus # dnf -y install python3-dbus +## +import lief # https://pypi.org/project/lief/ + +# https://github.com/saltstack/salt/issues/64962 + +salt_root = pathlib.Path('/opt/saltstack') +src_lib = pathlib.Path('/lib64/libldap.so.2') +dst_lib = salt_root.joinpath('salt', 'lib', 'libldap.so.2') + +uname = 'salt' +gname = 'salt' + +lib = lief.parse(str(src_lib)) +sym = next(i for i in lib.imported_symbols if i.name == 'EVP_md2') +if sym: + # Get the Salt services from DBus. + sysbus = dbus.SystemBus() + sysd = sysbus.get_object('org.freedesktop.systemd1', '/org/freedesktop/systemd1') + mgr = dbus.Interface(sysd, 'org.freedesktop.systemd1.Manager') + svcs = [] + for i in mgr.ListUnits(): + # first element is unit name. + if not str(i[0]).startswith('salt-'): + continue + svc = sysbus.get_object('org.freedesktop.systemd1', object_path = mgr.GetUnit(str(i[0]))) + props = dbus.Interface(svc, dbus_interface = 'org.freedesktop.DBus.Properties') + state = props.Get('org.freedesktop.systemd1.Unit', 'ActiveState') + if str(state) == 'active': + svcs.append(i[0]) + # Get the user/group + u = pwd.getpwnam(uname) + g = grp.getgrnam(gname) + # Modify + print('Modifications necessary.') + if svcs: + # Stop the services first. + for sn in svcs: + mgr.StopUnit(sn, 'replace') + if dst_lib.exists(): + # 3.10 deprecated .utcnow(). + #dst_lib_bak = pathlib.Path(str(dst_lib) + '.bak_{0}'.format(datetime.datetime.now(datetime.UTC).timestamp())) + dst_lib_bak = pathlib.Path(str(dst_lib) + '.bak_{0}'.format(datetime.datetime.utcnow().timestamp())) + os.rename(dst_lib, dst_lib_bak) + print('Destination file {0} exists; backed up to {1}.'.format(dst_lib, dst_lib_bak)) + lib.remove_dynamic_symbol(sym) + lib.write(str(dst_lib)) + os.chown(dst_lib, u.pw_uid, g.gr_gid) + os.chmod(dst_lib, src_lib.stat().st_mode) + # Before we restart services, we also want to remove any python caches. + for root, dirs, files in os.walk(salt_root): + for f in files: + if f.lower().endswith('.pyc'): + fpath = os.path.join(root, f) + os.remove(fpath) + print('Removed file {0}'.format(fpath)) + if '__pycache__' in dirs: + dpath = os.path.join(root, '__pycache__') + shutil.rmtree(dpath) + print('Removed directory {0}'.format(dpath)) + # And then start the units that were started before. + if svcs: + for sn in svcs: + mgr.RestartUnit(sn, 'replace') + +print('Done.') diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 689ee278e..75e44dd86 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -6,6 +6,7 @@ {% from 'libvirt/map.jinja' import LIBVIRTMERGED %} include: + - libvirt.64962 - libvirt.packages - libvirt.ssh.users From 5e4f1fc27917ba279005240a9b0a9e90d1eef1a8 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 16 Dec 2024 10:23:14 -0500 Subject: [PATCH 052/303] only run fix ldap when lief installed --- salt/libvirt/64962/init.sls | 2 ++ 1 file changed, 2 insertions(+) diff --git a/salt/libvirt/64962/init.sls b/salt/libvirt/64962/init.sls index 81eedb09b..a6b13c3e5 100644 --- a/salt/libvirt/64962/init.sls +++ b/salt/libvirt/64962/init.sls @@ -7,3 +7,5 @@ fix-salt-ldap: - source: salt://libvirt/64962/scripts/fix-salt-ldap.py - require: - pkg: python3_lief + - onchanges: + - pkg: python3_lief From b24aa2f797a6c519728ff3b612cde704ce06d12f Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 19 Dec 2024 10:11:54 -0500 Subject: [PATCH 053/303] fix destroying virbr0 --- salt/libvirt/init.sls | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 75e44dd86..dae0ed2bd 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -84,7 +84,7 @@ disable_default_bridge: - require: - pkg: install_libvirt-client - onlyif: - - virsh net-info | grep default + - virsh net-list | grep default # this should only run during the first highstate after setup. it will transfer connection from mgmt to br0 down_original_mgmt_interface: From 7a8fd8c3e58e5f05ac56c103818162f7eff3b558 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 19 Dec 2024 10:12:29 -0500 Subject: [PATCH 054/303] handle salt-cloud package --- salt/salt/master.sls | 3 +++ salt/salt/minion.sls | 8 +++++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/salt/salt/master.sls b/salt/salt/master.sls index bfd458dc8..17e818503 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -8,6 +8,9 @@ include: - salt.minion +{% if salt['pillar.get']('hypervisor:nodes', {} ) %} + - salt.cloud +{% endif %} hold_salt_master_package: module.run: diff --git a/salt/salt/minion.sls b/salt/salt/minion.sls index 0d995e96c..9c8e2993b 100644 --- a/salt/salt/minion.sls +++ b/salt/salt/minion.sls @@ -37,13 +37,15 @@ install_salt_minion: {% endif %} {% if INSTALLEDSALTVERSION|string == SALTVERSION|string %} - +# only hold the package if it is already installed hold_salt_packages: pkg.held: - pkgs: -{% for package in SALTPACKAGES %} +{% for package in SALTPACKAGES %} +{% if salt['pkg.version'](package) %} - {{ package }}: {{SALTVERSION}}-0.* -{% endfor %} +{% endif %} +{% endfor %} remove_error_log_level_logfile: file.line: From f2bd735f516fe2f5fefe2bf6477087c12625e778 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 19 Dec 2024 10:13:05 -0500 Subject: [PATCH 055/303] another script to create raid --- salt/hypervisor/raid3.sh | 192 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 192 insertions(+) create mode 100644 salt/hypervisor/raid3.sh diff --git a/salt/hypervisor/raid3.sh b/salt/hypervisor/raid3.sh new file mode 100644 index 000000000..8e7d6c7ae --- /dev/null +++ b/salt/hypervisor/raid3.sh @@ -0,0 +1,192 @@ +#!/bin/bash + +# Exit on any error +set -e + +# Function to log messages +log() { + echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" +} + +# Function to check if running as root +check_root() { + if [ "$EUID" -ne 0 ]; then + log "Error: Please run as root" + exit 1 + fi +} + +# Function to perform thorough device cleanup +ensure_devices_free() { + local device=$1 + + log "Performing thorough cleanup of device $device" + + # Kill any processes using the device + fuser -k "${device}"* 2>/dev/null || true + + # Force unmount any partitions + for part in "${device}"*; do + if mount | grep -q "$part"; then + umount -f "$part" 2>/dev/null || true + fi + done + + # Stop any MD arrays using this device + for md in $(ls /dev/md* 2>/dev/null || true); do + if mdadm --detail "$md" 2>/dev/null | grep -q "$device"; then + log "Stopping MD array $md" + mdadm --stop "$md" 2>/dev/null || true + fi + done + + # Thorough RAID cleanup + log "Cleaning RAID metadata from $device" + mdadm --zero-superblock "$device" 2>/dev/null || true + if [ -e "${device}p1" ]; then + mdadm --zero-superblock "${device}p1" 2>/dev/null || true + fi + + # Remove LVM PV if exists + pvremove -ff -y "$device" 2>/dev/null || true + + # Clear all signatures + log "Wiping all signatures from $device" + wipefs -a "$device" 2>/dev/null || true + + # Clear partition table + log "Clearing partition table on $device" + sgdisk -Z "$device" 2>/dev/null || true + + # Force kernel to reread + log "Forcing kernel to reread partition table" + partprobe "$device" 2>/dev/null || true + sleep 2 +} + +# Function to check if RAID is already set up +check_existing_raid() { + # Clear existing mdadm configuration first + log "Initializing clean mdadm configuration" + echo "DEVICE partitions" > /etc/mdadm.conf + + if [ -e "/dev/md0" ]; then + if mdadm --detail /dev/md0 &>/dev/null; then + local raid_state=$(mdadm --detail /dev/md0 | grep "State" | awk '{print $3}') + local mount_point="/nsm" + + log "Found existing RAID array /dev/md0 (State: $raid_state)" + + if mountpoint -q "$mount_point"; then + log "RAID is already mounted at $mount_point" + log "Current RAID details:" + mdadm --detail /dev/md0 + + # Check if resyncing + if grep -q "resync" /proc/mdstat; then + log "RAID is currently resyncing:" + grep resync /proc/mdstat + log "You can monitor progress with: watch -n 60 cat /proc/mdstat" + else + log "RAID is fully synced and operational" + fi + + # Show disk usage + log "Current disk usage:" + df -h "$mount_point" + + exit 0 + fi + fi + fi + + # Check if any MD arrays exist and try to clean them up + if [ -f /proc/mdstat ]; then + log "Checking for existing MD arrays" + if grep -q "md" /proc/mdstat; then + log "Found existing MD arrays, attempting cleanup" + for md in $(awk '/md/{print $1}' /proc/mdstat); do + log "Stopping array $md" + mdadm --stop "/dev/$md" 2>/dev/null || true + done + fi + fi + + # Check if any of the target devices are in use + for device in "/dev/nvme0n1" "/dev/nvme1n1"; do + if lsblk -o NAME,MOUNTPOINT "$device" | grep -q "nsm"; then + log "Error: $device is already mounted at /nsm" + exit 1 + fi + done +} + +# Main script +main() { + log "Starting RAID setup script" + + # Check if running as root + check_root + + # Check for existing RAID setup + check_existing_raid + + # Clean and prepare devices + for device in "/dev/nvme0n1" "/dev/nvme1n1"; do + ensure_devices_free "$device" + + log "Creating new partition table on $device" + sgdisk -Z "$device" + sgdisk -o "$device" + + log "Creating RAID partition" + sgdisk -n 1:0:0 -t 1:fd00 "$device" + + partprobe "$device" + udevadm settle + sleep 5 + done + + log "Final verification of partition availability" + if ! [ -b "/dev/nvme0n1p1" ] || ! [ -b "/dev/nvme1n1p1" ]; then + log "Error: Partitions not available after creation" + exit 1 + fi + + log "Creating RAID array" + mdadm --create /dev/md0 --level=1 --raid-devices=2 \ + --metadata=1.2 \ + /dev/nvme0n1p1 /dev/nvme1n1p1 \ + --force --run + + log "Creating XFS filesystem" + mkfs.xfs -f /dev/md0 + + log "Creating mount point" + mkdir -p /nsm + + log "Updating fstab" + sed -i '/\/dev\/md0/d' /etc/fstab + echo "/dev/md0 /nsm xfs defaults,nofail 0 0" >> /etc/fstab + + log "Reloading systemd daemon" + systemctl daemon-reload + + log "Mounting filesystem" + mount -a + + log "Saving RAID configuration" + mdadm --detail --scan > /etc/mdadm.conf + + log "RAID setup complete" + log "RAID array details:" + mdadm --detail /dev/md0 + + if grep -q "resync" /proc/mdstat; then + log "RAID is currently resyncing. You can monitor progress with:" + log "watch -n 60 cat /proc/mdstat" + fi +} + +# Run main function +main "$@" From 6f0161e9dae56c1dd8315ff31a17a3bb7ce30e9b Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 19 Dec 2024 17:36:48 -0500 Subject: [PATCH 056/303] script to create base domain --- salt/libvirt/scripts/createvm.sh | 153 +++++++++++++++++++++++++++++++ 1 file changed, 153 insertions(+) create mode 100644 salt/libvirt/scripts/createvm.sh diff --git a/salt/libvirt/scripts/createvm.sh b/salt/libvirt/scripts/createvm.sh new file mode 100644 index 000000000..e0b9c216d --- /dev/null +++ b/salt/libvirt/scripts/createvm.sh @@ -0,0 +1,153 @@ +#!/bin/bash + +# Exit on any error +set -e + +# Set variables and defaults +VM=${1:-"small-vm"} # VM name +IP=${2:-"192.168.1.10"} # IP address +GATEWAY=${3:-"192.168.1.1"} # Gateway +DNS=${4:-"192.168.1.1"} # Comma-separated list of DNS servers +MAC_ADDRESS="52:54:00:f2:c3:df" # Default MAC - will be overridden if found + +# Show usage if help is requested +if [[ "$1" == "-h" || "$1" == "--help" ]]; then + echo "Usage: $0 " + echo "Example: $0 myvm 192.168.1.50 192.168.1.1 8.8.8.8,8.8.4.4" + echo "All parameters are optional and will use defaults if not specified" + exit 0 +fi + +# Convert comma-separated DNS servers to yaml format +format_dns() { + local IFS=',' + local dns_list=($1) + local yaml="" + for dns in "${dns_list[@]}"; do + yaml="$yaml - $dns"$'\n' + done + echo "$yaml" +} + +DNS_YAML=$(format_dns "$DNS") + +# Set up directory structure +D=/root/create_vm/var/lib/libvirt/images +mkdir -vp $D/$VM +cd $D/$VM + +# Create cloud-init metadata +cat > meta-data << EOF +instance-id: ${VM} +local-hostname: ${VM} +EOF + +# Create network configuration +cat > network-config << EOF +version: 2 +ethernets: + eth0: + match: + macaddress: ${MAC_ADDRESS} + dhcp4: false + dhcp6: false + addresses: + - ${IP}/24 + routes: + - to: 0.0.0.0/0 + via: ${GATEWAY} + nameservers: + addresses: +$(format_dns "$DNS") +EOF + +# Generate password hash using: +# Create passwd hash +### python3 -c 'import crypt; print(crypt.crypt("YOUR_PASSWD_HERE", crypt.mksalt(crypt.METHOD_SHA512)))' +# Create ssh keypair +### ssh-keygen -t ed25519 -C "soqemussh" -f ~/.ssh/soqemussh + +# Create user-data with network configuration +cat > user-data << EOF +#cloud-config +preserve_hostname: False +hostname: ${VM} +fqdn: ${VM}.local + +users: + - default + - name: soqemussh + groups: ['wheel'] + shell: /bin/bash + sudo: ALL=(ALL) NOPASSWD:ALL + lock_passwd: false + passwd: $(echo '___YOUR_HASH_HERE___') + ssh-authorized-keys: + - ssh-ed25519 ___YOUR_PUB_KEY_HERE___ + +# Configure where output will go +output: + all: ">> /var/log/cloud-init.log" + +# configure interaction with ssh server +ssh_genkeytypes: ['ed25519', 'rsa'] + +# set timezone for VM +timezone: UTC + +# Don't preallocate the entire disk space +#resize_rootfs: true +#growpart: +# mode: auto +# devices: ['/'] + +# Install QEMU guest agent. Enable and start the service +packages: + - qemu-guest-agent + +runcmd: + - systemctl enable --now qemu-guest-agent + - systemctl enable --now serial-getty@ttyS0.service + - systemctl enable --now NetworkManager + - growpart /dev/vda 2 + - pvresize /dev/vda2 + - lvextend -l +100%FREE /dev/vg_main/lv_root + - xfs_growfs /dev/vg_main/lv_root +EOF + +# First, copy the base image +echo "Creating base VM image..." +cp -v /root/create_vm/OL9U5_x86_64-kvm-b253.qcow2 $VM.qcow2 + +# First resize the image to our desired size +echo "Resizing image..." +qemu-img resize $VM.qcow2 205G + +# Now compress it +echo "Compressing image..." +qemu-img convert -p -O qcow2 -c $VM.qcow2 $VM-compressed.qcow2 +mv -v $VM-compressed.qcow2 $VM.qcow2 + +# Create a cloud-init ISO with network config +echo "Creating cloud-init ISO..." +mkisofs -output $VM-cidata.iso -volid CIDATA -rock user-data meta-data network-config + +# Echo the configuration for verification +echo "Creating VM with the following network configuration:" +echo "VM Name: $VM" +echo "IP Address: $IP" +echo "Gateway: $GATEWAY" +echo "DNS Servers: $DNS" +echo "MAC Address: $MAC_ADDRESS" + +echo "Files have been created in $D/$VM" +echo +echo "To complete VM creation on the hypervisor, run:" +echo "virsh pool-create-as --name $VM --type dir --target $D/$VM" +echo "virt-install --import --name ${VM} \\" +echo " --memory 4096 --vcpus 4 --cpu host \\" +echo " --disk ${VM}.qcow2,format=qcow2,bus=virtio \\" +echo " --disk ${VM}-cidata.iso,device=cdrom \\" +echo " --network bridge=br0,model=virtio,mac=${MAC_ADDRESS} \\" +echo " --os-variant=ol9.5 \\" +echo " --noautoconsole" From 3c59858f70de8e953a3cdb4dcda07548c2ec4f57 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 20 Dec 2024 11:42:53 -0500 Subject: [PATCH 057/303] improvements to createvm --- salt/libvirt/scripts/createvm.sh | 91 ++++++++++++++++++++++---------- 1 file changed, 64 insertions(+), 27 deletions(-) diff --git a/salt/libvirt/scripts/createvm.sh b/salt/libvirt/scripts/createvm.sh index e0b9c216d..4a88ecb1f 100644 --- a/salt/libvirt/scripts/createvm.sh +++ b/salt/libvirt/scripts/createvm.sh @@ -1,23 +1,69 @@ #!/bin/bash +# Ensure /root/create_vm/var/lib/libvirt/images exists +# Place this script in /root/create_vm +# Download OL9U5_x86_64-kvm-b253.qcow2 from https://yum.oracle.com/oracle-linux-templates.html, place in /root/create_vm/ + +# These steps will be removed from the process to create the final image and is being used for development +# This is used for the user-data auth portion of cloud-init +# Create passwd hash: +# python3 -c 'import crypt; print(crypt.crypt("YOUR_PASSWD_HERE", crypt.mksalt(crypt.METHOD_SHA512)))' +# Create ssh keypair: +# ssh-keygen -t ed25519 -C "soqemussh" -f ~/.ssh/soqemussh + +# Run the script: createvm.sh coreol9Small 205G +# IP options may be removed for final version + +# After running the script, the following will be output: +#[root@jppvirtman create_vm]# ll var/lib/libvirt/images/coreol9Small/ +#total 610376 +#-rw-r--r--. 1 root root 380928 Dec 20 14:33 coreol9Small-cidata.iso +#-rw-r--r--. 1 root root 624623616 Dec 20 14:33 coreol9Small.qcow2 +#-rw-r--r--. 1 root root 55 Dec 20 14:32 meta-data +#-rw-r--r--. 1 root root 333 Dec 20 14:32 network-config +#-rw-r--r--. 1 root root 1047 Dec 20 14:32 user-data + +# These files are now scp to a hypervisor node +# Place the files in /var/lib/libvirt/images/coreol9Small (or whatever is the same as the vm name) +# Create your storage pool as instructed by the script. this is only needed if one doesn't already exist +# Run the virt-install command as instructed by the script + +# Could add the following to the final runcmd in the user-data to fill the disk to avoid the cons of thin provisioning the disk +# - dd if=/dev/zero of=/tmp/fill bs=1M || true +# - rm -f /tmp/fill + # Exit on any error set -e # Set variables and defaults VM=${1:-"small-vm"} # VM name -IP=${2:-"192.168.1.10"} # IP address -GATEWAY=${3:-"192.168.1.1"} # Gateway -DNS=${4:-"192.168.1.1"} # Comma-separated list of DNS servers +DISK_SIZE=${2:-"205G"} # Disk size with unit (default 205G) +IP=${3:-"192.168.1.10"} # IP address +GATEWAY=${4:-"192.168.1.1"} # Gateway +DNS=${5:-"192.168.1.1"} # Comma-separated list of DNS servers MAC_ADDRESS="52:54:00:f2:c3:df" # Default MAC - will be overridden if found # Show usage if help is requested if [[ "$1" == "-h" || "$1" == "--help" ]]; then - echo "Usage: $0 " - echo "Example: $0 myvm 192.168.1.50 192.168.1.1 8.8.8.8,8.8.4.4" + echo "Usage: $0 " + echo "Example: $0 myvm 100G 192.168.1.50 192.168.1.1 8.8.8.8,8.8.4.4" + echo "Parameters:" + echo " vm_name : Name of the VM (default: small-vm)" + echo " disk_size : Size of the disk with unit G/M (default: 205G)" + echo " ip : IP address (default: 192.168.1.10)" + echo " gateway : Gateway address (default: 192.168.1.1)" + echo " dns_servers: Comma-separated DNS servers (default: 192.168.1.1)" echo "All parameters are optional and will use defaults if not specified" exit 0 fi +# Validate disk size format +if ! [[ $DISK_SIZE =~ ^[0-9]+[GM]$ ]]; then + echo "Error: Disk size must be a number followed by G (gigabytes) or M (megabytes)" + echo "Example: 100G or 51200M" + exit 1 +fi + # Convert comma-separated DNS servers to yaml format format_dns() { local IFS=',' @@ -61,12 +107,6 @@ ethernets: $(format_dns "$DNS") EOF -# Generate password hash using: -# Create passwd hash -### python3 -c 'import crypt; print(crypt.crypt("YOUR_PASSWD_HERE", crypt.mksalt(crypt.METHOD_SHA512)))' -# Create ssh keypair -### ssh-keygen -t ed25519 -C "soqemussh" -f ~/.ssh/soqemussh - # Create user-data with network configuration cat > user-data << EOF #cloud-config @@ -83,7 +123,7 @@ users: lock_passwd: false passwd: $(echo '___YOUR_HASH_HERE___') ssh-authorized-keys: - - ssh-ed25519 ___YOUR_PUB_KEY_HERE___ + - ssh-ed25519 ___YOUR_PUB_KEY_HERE___ soqemussh # Configure where output will go output: @@ -95,12 +135,6 @@ ssh_genkeytypes: ['ed25519', 'rsa'] # set timezone for VM timezone: UTC -# Don't preallocate the entire disk space -#resize_rootfs: true -#growpart: -# mode: auto -# devices: ['/'] - # Install QEMU guest agent. Enable and start the service packages: - qemu-guest-agent @@ -115,26 +149,29 @@ runcmd: - xfs_growfs /dev/vg_main/lv_root EOF -# First, copy the base image +# First, copy the base image with progress echo "Creating base VM image..." -cp -v /root/create_vm/OL9U5_x86_64-kvm-b253.qcow2 $VM.qcow2 +rsync --progress /root/create_vm/OL9U5_x86_64-kvm-b253.qcow2 $VM.qcow2 -# First resize the image to our desired size -echo "Resizing image..." -qemu-img resize $VM.qcow2 205G +# Resize the image to specified size +echo "Resizing image to $DISK_SIZE..." +echo "Current image size: $(qemu-img info $VM.qcow2 | grep 'virtual size' | cut -d':' -f2 | cut -d'(' -f1 | tr -d ' ')" +qemu-img resize -f qcow2 $VM.qcow2 $DISK_SIZE +echo "New image size: $(qemu-img info $VM.qcow2 | grep 'virtual size' | cut -d':' -f2 | cut -d'(' -f1 | tr -d ' ')" -# Now compress it +# Now compress it with progress echo "Compressing image..." qemu-img convert -p -O qcow2 -c $VM.qcow2 $VM-compressed.qcow2 mv -v $VM-compressed.qcow2 $VM.qcow2 -# Create a cloud-init ISO with network config +# Create a cloud-init ISO with network config and progress indication echo "Creating cloud-init ISO..." -mkisofs -output $VM-cidata.iso -volid CIDATA -rock user-data meta-data network-config +mkisofs -output $VM-cidata.iso -volid CIDATA -rock -verbose user-data meta-data network-config # Echo the configuration for verification -echo "Creating VM with the following network configuration:" +echo "Creating VM with the following configuration:" echo "VM Name: $VM" +echo "Disk Size: $DISK_SIZE" echo "IP Address: $IP" echo "Gateway: $GATEWAY" echo "DNS Servers: $DNS" From 0197cdb33d7aa9b11f99e5aa940c31faa322205d Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 9 Jan 2025 16:12:33 -0500 Subject: [PATCH 058/303] fix bridge forwarding on hypervisors bridge --- salt/firewall/iptables.jinja | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/salt/firewall/iptables.jinja b/salt/firewall/iptables.jinja index 074663e15..48a0808e7 100644 --- a/salt/firewall/iptables.jinja +++ b/salt/firewall/iptables.jinja @@ -91,6 +91,10 @@ COMMIT -A INPUT -m conntrack --ctstate INVALID -j DROP -A INPUT -p icmp -j ACCEPT -A INPUT -j LOGGING +{% if GLOBALS.role in ['so-hypervisor', 'so-managerhyper'] -%} +-A FORWARD -m state --state RELATED,ESTABLISHED -j ACCEPT +-A FORWARD -i br0 -o br0 -j ACCEPT +{%- endif %} -A FORWARD -j DOCKER-USER -A FORWARD -j DOCKER-ISOLATION-STAGE-1 -A FORWARD -o sobridge -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT From 6888682f92c328a31c6566faa7cfeabc56b1ce6b Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 9 Jan 2025 16:14:01 -0500 Subject: [PATCH 059/303] add comments for raid scripts --- salt/hypervisor/raid.sh | 1 + salt/hypervisor/raid3.sh | 8 ++++++++ 2 files changed, 9 insertions(+) diff --git a/salt/hypervisor/raid.sh b/salt/hypervisor/raid.sh index 031e4c522..b4539ba05 100644 --- a/salt/hypervisor/raid.sh +++ b/salt/hypervisor/raid.sh @@ -1,4 +1,5 @@ # quick script to create raid +# this is an example of the base functions parted -s /dev/nvme0n1 rm 1 parted -s /dev/nvme0n1 mklabel gpt parted -s /dev/nvme0n1 mkpart primary xfs 0% 100% diff --git a/salt/hypervisor/raid3.sh b/salt/hypervisor/raid3.sh index 8e7d6c7ae..4e5bd6c7f 100644 --- a/salt/hypervisor/raid3.sh +++ b/salt/hypervisor/raid3.sh @@ -1,5 +1,13 @@ #!/bin/bash +#raid3.sh is a refinement of raid2.sh. raid2.sh was used to create the raid in testing +#More detailed logging +#More thorough RAID array cleanup +#Better organized cleanup procedures +#Simplified device wiping using more modern tools (sgdisk instead of dd) +#More robust handling of existing MD arrays +#The core RAID creation and mounting functionality remains the same between both scripts, but the second version has improved error handling and cleanup procedures. + # Exit on any error set -e From ecc5d64584e5f895adf36428c30be04e8564aedf Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 9 Jan 2025 16:14:57 -0500 Subject: [PATCH 060/303] move logge def to global --- salt/hypervisor/tools/sbin/so-qcow2-modify-network | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin/so-qcow2-modify-network index 8829d3223..7920985b4 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -28,6 +28,13 @@ import configparser from io import StringIO from so_logging_utils import setup_logging +# Set up logging using the so_logging_utils library +logger = setup_logging( + logger_name='so-qcow2-modify-network', + log_file_path='/opt/so/log/hypervisor/so-qcow2-modify-network.log', + log_level=logging.INFO, + format_str='%(asctime)s - %(levelname)s - %(message)s' +) NETWORK_CONFIG_DIR = "/etc/NetworkManager/system-connections" @@ -161,13 +168,6 @@ def parse_arguments(): return args def main(): - # Set up logging using the so_logging_utils library - logger = setup_logging( - logger_name='so-qcow2-modify-network', - log_file_path='/opt/so/log/hypervisor/so-qcow2-modify-network.log', - log_level=logging.INFO, - format_str='%(asctime)s - %(levelname)s - %(message)s' - ) try: args = parse_arguments() From 574d2994d1524a5420eebbaece1bf028d30a2b29 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 9 Jan 2025 16:16:59 -0500 Subject: [PATCH 061/303] use cmd.run instead of cmd.script to resolve issue 64962 --- salt/libvirt/64962/init.sls | 13 ++++++++++--- .../{fix-salt-ldap.py => so-fix-salt-ldap.py} | 4 ++-- 2 files changed, 12 insertions(+), 5 deletions(-) rename salt/libvirt/64962/scripts/{fix-salt-ldap.py => so-fix-salt-ldap.py} (96%) diff --git a/salt/libvirt/64962/init.sls b/salt/libvirt/64962/init.sls index a6b13c3e5..e20f24f2d 100644 --- a/salt/libvirt/64962/init.sls +++ b/salt/libvirt/64962/init.sls @@ -2,10 +2,17 @@ python3_lief: pkg.installed: - name: securityonion-python3-lief +so-fix-salt-ldap_script: + file.managed: + - name: /usr/sbin/so-fix-salt-ldap.py + - source: salt://libvirt/64962/scripts/so-fix-salt-ldap.py + - mode: 744 + fix-salt-ldap: - cmd.script: - - source: salt://libvirt/64962/scripts/fix-salt-ldap.py + cmd.run: + - name: /usr/sbin/so-fix-salt-ldap.py - require: - pkg: python3_lief + - file: so-fix-salt-ldap_script - onchanges: - - pkg: python3_lief + - file: so-fix-salt-ldap_script diff --git a/salt/libvirt/64962/scripts/fix-salt-ldap.py b/salt/libvirt/64962/scripts/so-fix-salt-ldap.py similarity index 96% rename from salt/libvirt/64962/scripts/fix-salt-ldap.py rename to salt/libvirt/64962/scripts/so-fix-salt-ldap.py index 56fcce8aa..919b50261 100644 --- a/salt/libvirt/64962/scripts/fix-salt-ldap.py +++ b/salt/libvirt/64962/scripts/so-fix-salt-ldap.py @@ -1,5 +1,7 @@ #!/usr/bin/env python3 +# this script comes from the user nf-brentsaner located here https://github.com/saltstack/salt/issues/64962 + import datetime import grp import os @@ -11,8 +13,6 @@ import dbus # dnf -y install python3-dbus ## import lief # https://pypi.org/project/lief/ -# https://github.com/saltstack/salt/issues/64962 - salt_root = pathlib.Path('/opt/saltstack') src_lib = pathlib.Path('/lib64/libldap.so.2') dst_lib = salt_root.joinpath('salt', 'lib', 'libldap.so.2') From ebbfcd169c17faad440931a1eaef68369a83d7a5 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 9 Jan 2025 16:17:50 -0500 Subject: [PATCH 062/303] add pkg required for so-qcow2-modify-network --- salt/libvirt/packages.sls | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index c79f42dd8..4de30568a 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -28,6 +28,11 @@ install_xorriso: install_virt-install: pkg.installed: - name: virt-install + +# needed for for so-qcow2-modify-network - import guestfs +install_python3-libguestfs: + pkg.installed: + - name: python3-libguestfs ### libvirt_python_wheel: From d677dc51de4d39f6ba75fd795d0a13ef3aeb21b5 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 9 Jan 2025 16:19:23 -0500 Subject: [PATCH 063/303] add comment about reactors required by salt-master --- salt/salt/master.sls | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/salt/salt/master.sls b/salt/salt/master.sls index 17e818503..7e823f4e8 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -52,23 +52,21 @@ salt_master_service: - file: engines_config - order: last +{# # we need to managed adding the following to salt-master config if there are hypervisors -#reactor: +reactor: + - 'salt/auth/accept/*': + - salt://reactor/check_hypervisor.sls #- salt/cloud/*/creating': #- salt/cloud/*/requesting -# - 'salt/cloud/*/deploying': -# - /opt/so/saltstack/default/salt/reactor/createEmptyPillar.sls -## - 'salt/cloud/*/created': -## - /opt/so/saltstack/default/salt/reactor/setSalt.sls -## - /opt/so/saltstack/default/salt/reactor/setHostname.sls -## - /opt/so/saltstack/default/salt/reactor/sominion.sls -# - 'setup/so-minion': -# - /opt/so/saltstack/default/salt/reactor/sominion_setup.sls -# - /opt/so/saltstack/default/salt/reactor/virtUpdate.sls -# - 'salt/cloud/*/destroyed': -# - /opt/so/saltstack/default/salt/reactor/virtReleaseHardware.sls -# - /opt/so/saltstack/default/salt/reactor/deleteKey.sls - + - 'salt/cloud/*/deploying': + - /opt/so/saltstack/default/salt/reactor/createEmptyPillar.sls + - 'setup/so-minion': + - /opt/so/saltstack/default/salt/reactor/sominion_setup.sls + - 'salt/cloud/*/destroyed': + - /opt/so/saltstack/default/salt/reactor/virtReleaseHardware.sls + - /opt/so/saltstack/default/salt/reactor/deleteKey.sls +#} {% else %} From 2ba8a87c9db952459b337958df8a9d44e91b0f5a Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 9 Jan 2025 16:20:56 -0500 Subject: [PATCH 064/303] add directory where qcow2 images will be distributed from --- salt/libvirt/images/coreol9Small/README | 1 + salt/libvirt/images/init.sls | 6 ++++++ 2 files changed, 7 insertions(+) create mode 100644 salt/libvirt/images/coreol9Small/README create mode 100644 salt/libvirt/images/init.sls diff --git a/salt/libvirt/images/coreol9Small/README b/salt/libvirt/images/coreol9Small/README new file mode 100644 index 000000000..28d066458 --- /dev/null +++ b/salt/libvirt/images/coreol9Small/README @@ -0,0 +1 @@ +# The files in this directory (/opt/so/saltstack/local/salt/libvirt/images/coreol9Small) are generated by createvm.sh. They are then distributed to the hypervisors where a storage pool will be created then the image can be installed. diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls new file mode 100644 index 000000000..605af2368 --- /dev/null +++ b/salt/libvirt/images/init.sls @@ -0,0 +1,6 @@ +# the source location will be /opt/so/saltstack/local/salt/libvirt/imaages/coreol9Small +# this will need to change to save the images to /nsm +baseimagefiles: + file.recurse: + - name: /var/lib/libvirt/images/coreol9Small/ + - source: salt://libvirt/images/coreol9Small/ From 3cac19d4987256de2458256b77b55c32e3ce61e3 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 9 Jan 2025 16:31:51 -0500 Subject: [PATCH 065/303] createvm script without setting network in base domain --- salt/libvirt/scripts/createvm2.sh | 144 ++++++++++++++++++++++++++++++ 1 file changed, 144 insertions(+) create mode 100644 salt/libvirt/scripts/createvm2.sh diff --git a/salt/libvirt/scripts/createvm2.sh b/salt/libvirt/scripts/createvm2.sh new file mode 100644 index 000000000..b2be0d5b4 --- /dev/null +++ b/salt/libvirt/scripts/createvm2.sh @@ -0,0 +1,144 @@ +#!/bin/bash + +# Ensure /root/create_vm/var/lib/libvirt/images exists +# Place this script in /root/create_vm +# Download OL9U5_x86_64-kvm-b253.qcow2 from https://yum.oracle.com/oracle-linux-templates.html, place in /root/create_vm/ + +# These steps will be removed from the process to create the final image and is being used for development +# This is used for the user-data auth portion of cloud-init +# Create passwd hash: +# python3 -c 'import crypt; print(crypt.crypt("YOUR_PASSWD_HERE", crypt.mksalt(crypt.METHOD_SHA512)))' +# Create ssh keypair: +# ssh-keygen -t ed25519 -C "soqemussh" -f ~/.ssh/soqemussh + +# Run the script: createbase.sh coreol9Small 20G +# After running the script, the following will be output: +#[root@jppvirtman create_vm]# ll var/lib/libvirt/images/coreol9Small/ +#total 610376 +#-rw-r--r--. 1 root root 380928 Dec 20 14:33 coreol9Small-cidata.iso +#-rw-r--r--. 1 root root 624623616 Dec 20 14:33 coreol9Small.qcow2 +#-rw-r--r--. 1 root root 55 Dec 20 14:32 meta-data +#-rw-r--r--. 1 root root 1047 Dec 20 14:32 user-data + +# These files are now scp to a hypervisor node +# Place the files in /var/lib/libvirt/images/coreol9Small (or whatever is the same as the vm name) +# Create your storage pool as instructed by the script if one doesn't already exist +# Run the virt-install command as instructed by the script + +# Exit on any error +set -e + +# Set variables and defaults +VM=${1:-"base-vm"} # VM name +DISK_SIZE=${2:-"220G"} # Disk size with unit (default 20G) + +# Show usage if help is requested +if [[ "$1" == "-h" || "$1" == "--help" ]]; then + echo "Usage: $0 " + echo "Example: $0 myvm 20G" + echo "Parameters:" + echo " vm_name : Name of the VM (default: base-vm)" + echo " disk_size : Size of the disk with unit G/M (default: 20G)" + echo "All parameters are optional and will use defaults if not specified" + exit 0 +fi + +# Validate disk size format +if ! [[ $DISK_SIZE =~ ^[0-9]+[GM]$ ]]; then + echo "Error: Disk size must be a number followed by G (gigabytes) or M (megabytes)" + echo "Example: 20G or 20480M" + exit 1 +fi + +# Set up directory structure +#D=/root/create_vm/var/lib/libvirt/images +D=/opt/so/saltstack/local/salt/libvirt/images +mkdir -vp $D/$VM +cd $D/$VM + +# Create cloud-init metadata +cat > meta-data << EOF +instance-id: ${VM} +local-hostname: ${VM} +EOF + +# Create user-data configuration +cat > user-data << EOF +#cloud-config +preserve_hostname: False +hostname: ${VM} +fqdn: ${VM}.local + +users: + - default + - name: soqemussh + groups: ['wheel'] + shell: /bin/bash + sudo: ALL=(ALL) NOPASSWD:ALL + lock_passwd: false + passwd: $(echo '___YOUR_HASH_HERE___') + ssh-authorized-keys: + - ssh-ed25519 ___YOUR_PUB_KEY_HERE___ soqemussh + +# Configure where output will go +output: + all: ">> /var/log/cloud-init.log" + +# configure interaction with ssh server +ssh_genkeytypes: ['ed25519', 'rsa'] + +# set timezone for VM +timezone: UTC + +# Install QEMU guest agent. Enable and start the service +packages: + - qemu-guest-agent + +runcmd: + - systemctl enable --now qemu-guest-agent + - systemctl enable --now serial-getty@ttyS0.service + - systemctl enable --now NetworkManager + - growpart /dev/vda 2 + - pvresize /dev/vda2 + - lvextend -l +100%FREE /dev/vg_main/lv_root + - xfs_growfs /dev/vg_main/lv_root + - touch /etc/cloud/cloud-init.disabled + - shutdown -P now +EOF + +# First, copy the base image with progress +echo "Creating base VM image..." +rsync --progress /root/create_vm/OL9U5_x86_64-kvm-b253.qcow2 $VM.qcow2 + +# Resize the image to specified size +echo "Resizing image to $DISK_SIZE..." +echo "Current image size: $(qemu-img info $VM.qcow2 | grep 'virtual size' | cut -d':' -f2 | cut -d'(' -f1 | tr -d ' ')" +qemu-img resize -f qcow2 $VM.qcow2 $DISK_SIZE +echo "New image size: $(qemu-img info $VM.qcow2 | grep 'virtual size' | cut -d':' -f2 | cut -d'(' -f1 | tr -d ' ')" + +# Now compress it with progress +echo "Compressing image..." +qemu-img convert -p -O qcow2 -c $VM.qcow2 $VM-compressed.qcow2 +mv -v $VM-compressed.qcow2 $VM.qcow2 + +# Create a cloud-init ISO with progress indication +echo "Creating cloud-init ISO..." +mkisofs -output $VM-cidata.iso -volid CIDATA -rock -verbose user-data meta-data + +# Echo the configuration for verification +echo "Creating VM with the following configuration:" +echo "VM Name: $VM" +echo "Disk Size: $DISK_SIZE" + +echo "Files have been created in $D/$VM" +echo +echo "To complete VM creation on the hypervisor, run:" +echo "virsh pool-create-as --name $VM --type dir --target $D/$VM" +echo "virt-install --name ${VM} \\" +echo " --memory 4096 --vcpus 4 --cpu host \\" +echo " --disk ${VM}.qcow2,format=qcow2,bus=virtio \\" +echo " --disk ${VM}-cidata.iso,device=cdrom \\" +echo " --network bridge=br0,model=virtio \\" +echo " --os-variant=ol9.5 \\" +echo " --import \\" +echo " --noautoconsole" From 776afa4a3638d8dfeb3ea6d8fa1bc2f8965c63c4 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 9 Jan 2025 16:32:41 -0500 Subject: [PATCH 066/303] setup items on manager when hypervisor joins the grid --- salt/manager/hypervisor/directories.sls | 11 +++++ salt/orch/setup_hypervisor.sls | 66 +++++++++++++++++++++++++ salt/reactor/check_hypervisor.sls | 6 +++ 3 files changed, 83 insertions(+) create mode 100644 salt/manager/hypervisor/directories.sls create mode 100644 salt/orch/setup_hypervisor.sls create mode 100644 salt/reactor/check_hypervisor.sls diff --git a/salt/manager/hypervisor/directories.sls b/salt/manager/hypervisor/directories.sls new file mode 100644 index 000000000..3f60492f6 --- /dev/null +++ b/salt/manager/hypervisor/directories.sls @@ -0,0 +1,11 @@ +{% set dirs = [ + '/nsm/libvirt/createvm' +] %} + +create_libvirt_dirs: + file.directory: + - names: {{ dirs }} + - makedirs: True + - mode: 755 + - user: root + - group: root diff --git a/salt/orch/setup_hypervisor.sls b/salt/orch/setup_hypervisor.sls new file mode 100644 index 000000000..a79e07ee5 --- /dev/null +++ b/salt/orch/setup_hypervisor.sls @@ -0,0 +1,66 @@ +{% set qcow2_url = 'https://yum.oracle.com/templates/OracleLinux/OL9/u5/x86_64/OL9U5_x86_64-kvm-b253.qcow2' %} +{% set expected_sha256 = '3b00bbbefc8e78dd28d9f538834fb9e2a03d5ccdc2cadf2ffd0036c0a8f02021' %} +{% set target_path = '/nsm/libvirt/createvm/OL9U5_x86_64-kvm-b253.qcow2' %} +{% set master_id = salt.local.opts.get('id') %} + +createvm_directories: + salt.state: + - tgt: {{ master_id }} + - sls: + - manager.hypervisor.directories + +check_qcow2_exists: + salt.function: + - name: file.file_exists + - tgt: {{ master_id }} + - arg: + - {{ target_path }} + - require: + - salt: createvm_directories + +download_qcow2: + salt.function: + - name: cmd.run + - tgt: {{ master_id }} + - arg: + - curl -L {{ qcow2_url }} -o {{ target_path }} + - onlyif: + - fun: file.file_exists + tgt: {{ master_id }} + arg: + - {{ target_path }} + expected: False + +verify_checksum: + salt.function: + - name: cmd.run_all + - tgt: {{ master_id }} + - arg: + - echo "{{ expected_sha256 }} {{ target_path }}" | sha256sum -c + - require: + - salt: download_qcow2 + - onlyif: + - fun: file.file_exists + tgt: {{ master_id }} + arg: + - {{ target_path }} + +handle_failed_verification: + salt.function: + - name: log.error + - tgt: {{ master_id }} + - arg: + - "Checksum verification failed for {{ target_path }}" + - onfail: + - salt: verify_checksum + +cleanup_failed_download: + salt.function: + - name: file.remove + - tgt: {{ master_id }} + - arg: + - {{ target_path }} + - onfail: + - salt: verify_checksum + - require: + - salt: verify_checksum diff --git a/salt/reactor/check_hypervisor.sls b/salt/reactor/check_hypervisor.sls new file mode 100644 index 000000000..b26b6d0dd --- /dev/null +++ b/salt/reactor/check_hypervisor.sls @@ -0,0 +1,6 @@ +{% if data['id'].endswith(('_hypervisor', '_managerhyper')) %} +check_and_trigger: + runner.state.orchestrate: + - args: + - mods: orch.setup_hypervisor +{% endif %} From 2e3c1adc63096db99e8cc8ec23ed241ab4bd721d Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 14 Jan 2025 16:20:21 -0500 Subject: [PATCH 067/303] runner to setup manager for first hypervisor --- salt/_runners/setup_hypervisor.py | 585 ++++++++++++++++++++++++ salt/manager/hypervisor/directories.sls | 11 - salt/orch/setup_hypervisor.sls | 66 --- salt/reactor/check_hypervisor.sls | 4 +- 4 files changed, 586 insertions(+), 80 deletions(-) create mode 100644 salt/_runners/setup_hypervisor.py delete mode 100644 salt/manager/hypervisor/directories.sls delete mode 100644 salt/orch/setup_hypervisor.sls diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py new file mode 100644 index 000000000..e444b739a --- /dev/null +++ b/salt/_runners/setup_hypervisor.py @@ -0,0 +1,585 @@ +""" +This runner performs the initial setup required for hypervisor hosts in the environment. +It handles downloading the Oracle Linux KVM image, setting up SSH keys for secure +communication, and creating the initial VM. + +Functions: + setup_environment: Downloads image, sets up SSH keys, and creates initial VM + regenerate_ssh_keys: Regenerates SSH keys for remote access + create_vm: Creates a new VM with cloud-init configuration + +The runner is typically triggered automatically when a new hypervisor minion connects, +but can also be run manually if needed. + +CLI Examples: + + # Perform complete environment setup (creates VM named 'so-ol9' with 220G disk by default) + salt-run setup_hypervisor.setup_environment + + # Setup with custom VM name (uses default 220G disk) + salt-run setup_hypervisor.setup_environment myvm + + # Setup with custom VM name and disk size + salt-run setup_hypervisor.setup_environment myvm 300G + + # Regenerate SSH keys only + salt-run setup_hypervisor.regenerate_ssh_keys + + # Create additional VM with default disk size (220G) + salt-run setup_hypervisor.create_vm myvm2 + + # Create additional VM with custom disk size + salt-run setup_hypervisor.create_vm myvm3 300G +""" + +import hashlib +import logging +import os +import pwd +import requests +import salt.utils.files +import sys +import time +from cryptography.hazmat.primitives import serialization +from cryptography.hazmat.primitives.asymmetric import ed25519 + +# Configure logging +log = logging.getLogger(__name__) +log.setLevel(logging.DEBUG) + +# Ensure we have a stream handler +stream_handler = logging.StreamHandler(sys.stdout) +stream_handler.setLevel(logging.DEBUG) +formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') +stream_handler.setFormatter(formatter) +log.addHandler(stream_handler) + +def _check_file_exists(path): + """Check if a file exists and create its directory if needed.""" + if os.path.exists(path): + return True + os.makedirs(os.path.dirname(path), exist_ok=True) + return False + +def _validate_image_checksum(path, expected_sha256): + """ + Validate the checksum of an existing image file. + Returns: + bool: True if checksum matches, False otherwise + """ + sha256_hash = hashlib.sha256() + with salt.utils.files.fopen(path, 'rb') as f: + for chunk in iter(lambda: f.read(4096), b''): + sha256_hash.update(chunk) + + downloaded_sha256 = sha256_hash.hexdigest() + if downloaded_sha256 != expected_sha256: + log.error("VALIDATE: Checksum validation failed for %s - expected: %s, got: %s", + path, expected_sha256, downloaded_sha256) + return False + + log.info("VALIDATE: Checksum validation successful for %s", path) + return True + +# Constants +IMAGE_URL = "https://yum.oracle.com/templates/OracleLinux/OL9/u5/x86_64/OL9U5_x86_64-kvm-b253.qcow2" +IMAGE_SHA256 = "3b00bbbefc8e78dd28d9f538834fb9e2a03d5ccdc2cadf2ffd0036c0a8f02021" +IMAGE_PATH = "/nsm/libvirt/boot/OL9U5_x86_64-kvm-b253.qcow2" + +def _download_image(): + """ + Download and validate the Oracle Linux KVM image. + Returns: + bool: True if successful or file exists with valid checksum, False on error + """ + # Check if file already exists and validate checksum + if _check_file_exists(IMAGE_PATH): + if _validate_image_checksum(IMAGE_PATH, IMAGE_SHA256): + return True + else: + log.warning("DOWNLOAD: Existing image has invalid checksum, will re-download") + os.unlink(IMAGE_PATH) + + log.info("DOWNLOAD: Starting image download process") + + try: + # Download file + log.info("DOWNLOAD: Downloading Oracle Linux KVM image from %s to %s", IMAGE_URL, IMAGE_PATH) + response = requests.get(IMAGE_URL, stream=True) + response.raise_for_status() + + # Get total file size for progress tracking + total_size = int(response.headers.get('content-length', 0)) + downloaded_size = 0 + last_log_time = 0 + + # Save file with progress logging + with salt.utils.files.fopen(IMAGE_PATH, 'wb') as f: + for chunk in response.iter_content(chunk_size=8192): + f.write(chunk) + downloaded_size += len(chunk) + + # Log progress every second + current_time = time.time() + if current_time - last_log_time >= 1: + progress = (downloaded_size / total_size) * 100 if total_size > 0 else 0 + log.info("DOWNLOAD: Progress - %.1f%% (%d/%d bytes)", + progress, downloaded_size, total_size) + last_log_time = current_time + + # Validate downloaded file + if not _validate_image_checksum(IMAGE_PATH, IMAGE_SHA256): + os.unlink(IMAGE_PATH) + return False + + log.info("DOWNLOAD: Successfully downloaded and validated Oracle Linux KVM image") + return True + + except Exception as e: + log.error("DOWNLOAD: Error downloading hypervisor image: %s", str(e)) + if os.path.exists(IMAGE_PATH): + os.unlink(IMAGE_PATH) + return False + +def _check_ssh_keys_exist(): + """ + Check if SSH keys already exist. + Returns: + bool: True if both private and public keys exist, False otherwise + """ + key_dir = '/etc/ssh/auth_keys/soqemussh' + key_path = f'{key_dir}/id_ed25519' + pub_key_path = f'{key_path}.pub' + dest_dir = '/opt/so/saltstack/local/salt/libvirt/ssh/keys' + dest_path = os.path.join(dest_dir, os.path.basename(pub_key_path)) + + if os.path.exists(key_path) and os.path.exists(pub_key_path) and os.path.exists(dest_path): + log.info("SETUP_KEYS: SSH keys already exist") + return True + return False + +def _setup_ssh_keys(): + """ + Generate and set up SSH keys. + Returns: + bool: True if successful, False on error + """ + try: + key_dir = '/etc/ssh/auth_keys/soqemussh' + key_path = f'{key_dir}/id_ed25519' + pub_key_path = f'{key_path}.pub' + + # Check if keys already exist + if _check_ssh_keys_exist(): + return True + + # Create key directories if they don't exist and set permissions + log.info("SETUP_KEYS: Setting up SSH directory and keys") + parent_dir = os.path.dirname(key_dir) # /etc/ssh/auth_keys + os.makedirs(parent_dir, exist_ok=True) + os.chmod(parent_dir, 0o700) + + os.makedirs(key_dir, exist_ok=True) + os.chmod(key_dir, 0o700) + + # Generate new ed25519 key pair + log.info("SETUP_KEYS: Generating new SSH keys") + private_key = ed25519.Ed25519PrivateKey.generate() + public_key = private_key.public_key() + + # Serialize private key + private_bytes = private_key.private_bytes( + encoding=serialization.Encoding.PEM, + format=serialization.PrivateFormat.OpenSSH, + encryption_algorithm=serialization.NoEncryption() + ) + + # Serialize public key and format it as an OpenSSH public key + public_bytes = public_key.public_bytes( + encoding=serialization.Encoding.OpenSSH, + format=serialization.PublicFormat.OpenSSH + ) + public_bytes = public_bytes + b' soqemussh@salt-master\n' + + # Write the keys to files + with salt.utils.files.fopen(key_path, 'wb') as f: + f.write(private_bytes) + + with salt.utils.files.fopen(pub_key_path, 'wb') as f: + f.write(public_bytes) + + # Set proper permissions + os.chmod(key_path, 0o600) + os.chmod(pub_key_path, 0o644) + + log.info("SETUP_KEYS: SSH keys generated successfully") + + # Copy public key to saltstack directory + dest_dir = '/opt/so/saltstack/local/salt/libvirt/ssh/keys' + os.makedirs(dest_dir, exist_ok=True) + dest_path = os.path.join(dest_dir, os.path.basename(pub_key_path)) + + with salt.utils.files.fopen(pub_key_path, 'rb') as src: + with salt.utils.files.fopen(dest_path, 'wb') as dst: + dst.write(src.read()) + + log.info("SETUP_KEYS: Public key copied to %s", dest_dir) + return True + + except Exception as e: + log.error("SETUP_KEYS: Error setting up SSH keys: %s", str(e)) + return False + +def _check_vm_exists(vm_name: str) -> bool: + """ + Check if VM files already exist. + Returns: + bool: True if VM files exist, False otherwise + """ + base_dir = '/opt/so/saltstack/local/salt/libvirt/images' + vm_dir = f'{base_dir}/{vm_name}' + vm_image = os.path.join(vm_dir, f'{vm_name}.qcow2') + cidata_iso = os.path.join(vm_dir, f'{vm_name}-cidata.iso') + + required_files = [ + vm_image, + cidata_iso, + os.path.join(vm_dir, 'meta-data'), + os.path.join(vm_dir, 'user-data') + ] + + exists = all(os.path.exists(f) for f in required_files) + if exists: + log.info("MAIN: VM %s already exists", vm_name) + return exists + +def setup_environment(vm_name: str = 'so-ol9', disk_size: str = '220G'): + """ + Main entry point to set up the hypervisor environment. + This includes downloading the base image, generating SSH keys for remote access, + and creating the initial VM. + + Args: + vm_name (str, optional): Name of the VM to create as part of environment setup. + Defaults to 'so-ol9'. + disk_size (str, optional): Size of the VM disk with unit. + Defaults to '220G'. + + Returns: + dict: Dictionary containing setup status and VM creation results + """ + log.info("MAIN: Starting setup_environment in setup_hypervisor runner") + + # Check if environment is already set up + image_exists = _check_file_exists(IMAGE_PATH) + image_valid = image_exists and _validate_image_checksum(IMAGE_PATH, IMAGE_SHA256) + keys_exist = _check_ssh_keys_exist() + vm_exists = _check_vm_exists(vm_name) + + # Track if we need to create/recreate VM + create_vm_needed = False + + # Handle image setup if needed + if not image_valid: + log.info("MAIN: Starting image download/validation process") + if not _download_image(): + log.error("MAIN: Image download failed") + return { + 'success': False, + 'error': 'Image download failed', + 'vm_result': None + } + create_vm_needed = True + + # Handle SSH key setup if needed + if not keys_exist: + log.info("MAIN: Setting up SSH keys") + if not _setup_ssh_keys(): + log.error("MAIN: SSH key setup failed") + return { + 'success': False, + 'error': 'SSH key setup failed', + 'vm_result': None + } + create_vm_needed = True + + # Create/recreate VM if needed + if create_vm_needed or not vm_exists: + if vm_exists: + log.info("MAIN: Environment changes detected, recreating VM %s", vm_name) + else: + log.info("MAIN: Creating new VM %s", vm_name) + vm_result = create_vm(vm_name, disk_size) + else: + log.info("MAIN: No changes detected, using existing VM %s", vm_name) + vm_result = { + 'success': True, + 'vm_dir': f'/opt/so/saltstack/local/salt/libvirt/images/{vm_name}', + 'commands': [ + f"virsh pool-create-as --name {vm_name} --type dir --target /opt/so/saltstack/local/salt/libvirt/images/{vm_name}", + f"""virt-install --name {vm_name} \\ + --memory 4096 --vcpus 4 --cpu host \\ + --disk /opt/so/saltstack/local/salt/libvirt/images/{vm_name}/{vm_name}.qcow2,format=qcow2,bus=virtio \\ + --disk /opt/so/saltstack/local/salt/libvirt/images/{vm_name}/{vm_name}-cidata.iso,device=cdrom \\ + --network bridge=br0,model=virtio \\ + --os-variant=ol9.5 \\ + --import \\ + --noautoconsole""" + ] + } + + success = vm_result.get('success', False) + log.info("MAIN: Setup environment completed with status: %s", "SUCCESS" if success else "FAILED") + + return { + 'success': success, + 'error': vm_result.get('error') if not success else None, + 'vm_result': vm_result + } + +def create_vm(vm_name: str, disk_size: str = '220G'): + """ + Create a new VM with cloud-init configuration. + + Args: + vm_name (str): Name of the VM + disk_size (str): Size of the disk with unit (default: '220G') + + Returns: + dict: Dictionary containing success status and commands to run on hypervisor + """ + try: + # Input validation + if not isinstance(vm_name, str) or not vm_name: + log.error("CREATEVM: Invalid VM name") + return {'success': False, 'error': 'Invalid VM name'} + + if not vm_name.isalnum() and not all(c in '-_' for c in vm_name if not c.isalnum()): + log.error("CREATEVM: VM name must contain only alphanumeric characters, hyphens, or underscores") + return {'success': False, 'error': 'Invalid VM name format'} + + # Validate disk size format + if not isinstance(disk_size, str) or not disk_size.endswith(('G', 'M')): + log.error("CREATEVM: Invalid disk size format. Must end with G or M") + return {'success': False, 'error': 'Invalid disk size format'} + + try: + size_num = int(disk_size[:-1]) + if size_num <= 0: + raise ValueError + except ValueError: + log.error("CREATEVM: Invalid disk size number") + return {'success': False, 'error': 'Invalid disk size number'} + + # Ensure base image exists + if not os.path.exists(IMAGE_PATH): + log.error("CREATEVM: Base image not found at %s", IMAGE_PATH) + return {'success': False, 'error': 'Base image not found'} + + # Set up directory structure + base_dir = '/opt/so/saltstack/local/salt/libvirt/images' + vm_dir = f'{base_dir}/{vm_name}' + os.makedirs(vm_dir, exist_ok=True) + + # Read the SSH public key + pub_key_path = '/opt/so/saltstack/local/salt/libvirt/ssh/keys/id_ed25519.pub' + try: + with salt.utils.files.fopen(pub_key_path, 'r') as f: + ssh_pub_key = f.read().strip() + except Exception as e: + log.error("CREATEVM: Failed to read SSH public key: %s", str(e)) + return {'success': False, 'error': 'Failed to read SSH public key'} + + # Create meta-data + meta_data = f"""instance-id: {vm_name} +local-hostname: {vm_name} +""" + meta_data_path = os.path.join(vm_dir, 'meta-data') + with salt.utils.files.fopen(meta_data_path, 'w') as f: + f.write(meta_data) + + # Create user-data + user_data = f"""#cloud-config +preserve_hostname: False +hostname: {vm_name} +fqdn: {vm_name}.local + +users: + - default + - name: soqemussh + groups: ['wheel'] + shell: /bin/bash + sudo: ALL=(ALL) NOPASSWD:ALL + lock_passwd: false + passwd: $6$THWuTZMZhIVMGaaw$w9kozn7z7i0Y9LRVGZwN6mcZag4vMpE3hW6eCtKNHlFpL1XLcOdiIr29JyDxx3MLBXNedIqnqcj4psqCjv58d. + ssh-authorized-keys: + - {ssh_pub_key} + +# Configure where output will go +output: + all: ">> /var/log/cloud-init.log" + +# configure interaction with ssh server +ssh_genkeytypes: ['ed25519', 'rsa'] + +# set timezone for VM +timezone: UTC + +# Install QEMU guest agent. Enable and start the service +packages: + - qemu-guest-agent + +runcmd: + - systemctl enable --now qemu-guest-agent + - systemctl enable --now serial-getty@ttyS0.service + - systemctl enable --now NetworkManager + - growpart /dev/vda 2 + - pvresize /dev/vda2 + - lvextend -l +100%FREE /dev/vg_main/lv_root + - xfs_growfs /dev/vg_main/lv_root + - touch /etc/cloud/cloud-init.disabled + - shutdown -P now +""" + user_data_path = os.path.join(vm_dir, 'user-data') + with salt.utils.files.fopen(user_data_path, 'w') as f: + f.write(user_data) + + # Copy and resize base image + base_image = IMAGE_PATH + vm_image = os.path.join(vm_dir, f'{vm_name}.qcow2') + + # Copy base image with progress logging + import shutil + log.info("CREATEVM: Copying base image to %s", vm_image) + shutil.copy2(base_image, vm_image) + log.info("CREATEVM: Base image copy complete") + + # Get current image size + import subprocess + try: + result = subprocess.run(['qemu-img', 'info', '--output=json', vm_image], + check=True, capture_output=True, text=True) + import json + info = json.loads(result.stdout) + current_size = info.get('virtual-size', 0) + requested_size = int(disk_size[:-1]) * (1024**3 if disk_size.endswith('G') else 1024**2) + + # Only resize if requested size is larger + if requested_size > current_size: + log.info("CREATEVM: Resizing image to %s", disk_size) + try: + result = subprocess.run(['qemu-img', 'resize', '-f', 'qcow2', vm_image, disk_size], + check=True, capture_output=True, text=True) + log.info("CREATEVM: Image resize complete") + except subprocess.CalledProcessError as e: + log.error("CREATEVM: Failed to resize image: %s", e.stderr) + raise + else: + log.info("CREATEVM: Image already at or larger than requested size") + except subprocess.CalledProcessError as e: + log.error("CREATEVM: Failed to get image info: %s", e.stderr) + raise + except json.JSONDecodeError as e: + log.error("CREATEVM: Failed to parse image info: %s", str(e)) + raise + + # Compress image + temp_image = f"{vm_image}.temp" + log.info("CREATEVM: Compressing image") + + # Start compression in a subprocess + process = subprocess.Popen(['qemu-img', 'convert', '-O', 'qcow2', '-c', vm_image, temp_image], + stdout=subprocess.PIPE, stderr=subprocess.PIPE) + + # Monitor progress by checking output file size + source_size = os.path.getsize(vm_image) + last_log_time = 0 + + while process.poll() is None: # While compression is running + current_time = time.time() + if current_time - last_log_time >= 1: # Log every second + if os.path.exists(temp_image): + compressed_size = os.path.getsize(temp_image) + progress = (compressed_size / source_size) * 100 + log.info("CREATEVM: Compression progress - %.1f%% (%d/%d bytes)", + progress, compressed_size, source_size) + last_log_time = current_time + + # Check if compression completed successfully + if process.returncode == 0: + os.replace(temp_image, vm_image) + log.info("CREATEVM: Image compression complete") + else: + error = process.stderr.read().decode('utf-8') + log.error("CREATEVM: Failed to compress image: %s", error) + if os.path.exists(temp_image): + os.unlink(temp_image) + raise subprocess.CalledProcessError(process.returncode, 'qemu-img convert', stderr=error) + + # Create cloud-init ISO + cidata_iso = os.path.join(vm_dir, f'{vm_name}-cidata.iso') + subprocess.run(['mkisofs', '-output', cidata_iso, '-volid', 'CIDATA', '-rock', + user_data_path, meta_data_path], + check=True, capture_output=True) + + # Generate commands for hypervisor + commands = [ + f"virsh pool-create-as --name {vm_name} --type dir --target {vm_dir}", + f"""virt-install --name {vm_name} \\ + --memory 4096 --vcpus 4 --cpu host \\ + --disk {vm_image},format=qcow2,bus=virtio \\ + --disk {cidata_iso},device=cdrom \\ + --network bridge=br0,model=virtio \\ + --os-variant=ol9.5 \\ + --import \\ + --noautoconsole""" + ] + + return { + 'success': True, + 'vm_dir': vm_dir, + 'commands': commands + } + + except Exception as e: + log.error("CREATEVM: Error creating VM: %s", str(e)) + return {'success': False, 'error': str(e)} + +def regenerate_ssh_keys(): + """ + Regenerate SSH keys. + Returns: + bool: True if successful, False on error + """ + log.info("MAIN: Starting SSH key regeneration") + try: + # Verify current state + if not _check_ssh_keys_exist(): + log.warning("MAIN: No existing SSH keys found to regenerate") + return _setup_ssh_keys() + + # Remove existing keys + key_dir = '/etc/ssh/auth_keys/soqemussh' + key_path = f'{key_dir}/id_ed25519' + pub_key_path = f'{key_path}.pub' + dest_dir = '/opt/so/saltstack/local/salt/libvirt/ssh/keys' + dest_path = os.path.join(dest_dir, os.path.basename(pub_key_path)) + + for path in [key_path, pub_key_path, dest_path]: + try: + os.unlink(path) + log.info("MAIN: Removed existing key: %s", path) + except FileNotFoundError: + log.warning("MAIN: Key file not found: %s", path) + + # Generate new keys + if _setup_ssh_keys(): + log.info("MAIN: SSH keys regenerated successfully") + return True + + log.error("MAIN: Failed to regenerate SSH keys") + return False + + except Exception as e: + log.error("MAIN: Error regenerating SSH keys: %s", str(e)) + return False diff --git a/salt/manager/hypervisor/directories.sls b/salt/manager/hypervisor/directories.sls deleted file mode 100644 index 3f60492f6..000000000 --- a/salt/manager/hypervisor/directories.sls +++ /dev/null @@ -1,11 +0,0 @@ -{% set dirs = [ - '/nsm/libvirt/createvm' -] %} - -create_libvirt_dirs: - file.directory: - - names: {{ dirs }} - - makedirs: True - - mode: 755 - - user: root - - group: root diff --git a/salt/orch/setup_hypervisor.sls b/salt/orch/setup_hypervisor.sls deleted file mode 100644 index a79e07ee5..000000000 --- a/salt/orch/setup_hypervisor.sls +++ /dev/null @@ -1,66 +0,0 @@ -{% set qcow2_url = 'https://yum.oracle.com/templates/OracleLinux/OL9/u5/x86_64/OL9U5_x86_64-kvm-b253.qcow2' %} -{% set expected_sha256 = '3b00bbbefc8e78dd28d9f538834fb9e2a03d5ccdc2cadf2ffd0036c0a8f02021' %} -{% set target_path = '/nsm/libvirt/createvm/OL9U5_x86_64-kvm-b253.qcow2' %} -{% set master_id = salt.local.opts.get('id') %} - -createvm_directories: - salt.state: - - tgt: {{ master_id }} - - sls: - - manager.hypervisor.directories - -check_qcow2_exists: - salt.function: - - name: file.file_exists - - tgt: {{ master_id }} - - arg: - - {{ target_path }} - - require: - - salt: createvm_directories - -download_qcow2: - salt.function: - - name: cmd.run - - tgt: {{ master_id }} - - arg: - - curl -L {{ qcow2_url }} -o {{ target_path }} - - onlyif: - - fun: file.file_exists - tgt: {{ master_id }} - arg: - - {{ target_path }} - expected: False - -verify_checksum: - salt.function: - - name: cmd.run_all - - tgt: {{ master_id }} - - arg: - - echo "{{ expected_sha256 }} {{ target_path }}" | sha256sum -c - - require: - - salt: download_qcow2 - - onlyif: - - fun: file.file_exists - tgt: {{ master_id }} - arg: - - {{ target_path }} - -handle_failed_verification: - salt.function: - - name: log.error - - tgt: {{ master_id }} - - arg: - - "Checksum verification failed for {{ target_path }}" - - onfail: - - salt: verify_checksum - -cleanup_failed_download: - salt.function: - - name: file.remove - - tgt: {{ master_id }} - - arg: - - {{ target_path }} - - onfail: - - salt: verify_checksum - - require: - - salt: verify_checksum diff --git a/salt/reactor/check_hypervisor.sls b/salt/reactor/check_hypervisor.sls index b26b6d0dd..fdf75453d 100644 --- a/salt/reactor/check_hypervisor.sls +++ b/salt/reactor/check_hypervisor.sls @@ -1,6 +1,4 @@ {% if data['id'].endswith(('_hypervisor', '_managerhyper')) %} check_and_trigger: - runner.state.orchestrate: - - args: - - mods: orch.setup_hypervisor + runner.setup_hypervisor.setup_environment: [] {% endif %} From 161e8a6c2199e082018ffd4809e63dc2152ca189 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 14 Jan 2025 16:21:17 -0500 Subject: [PATCH 068/303] ssh config for manager. dont need to create soqemussh user on manager --- salt/libvirt/ssh/files/config | 2 +- salt/libvirt/ssh/users.sls | 47 +++++++++-------------------------- 2 files changed, 13 insertions(+), 36 deletions(-) diff --git a/salt/libvirt/ssh/files/config b/salt/libvirt/ssh/files/config index 25af86b73..360d5c182 100644 --- a/salt/libvirt/ssh/files/config +++ b/salt/libvirt/ssh/files/config @@ -1,2 +1,2 @@ Host * - IdentityFile /home/soqemussh/.ssh/id_ed25519 + IdentityFile /etc/ssh/auth_keys/soqemussh/id_ed25519 diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls index a893b9a7d..f0e30caec 100644 --- a/salt/libvirt/ssh/users.sls +++ b/salt/libvirt/ssh/users.sls @@ -5,44 +5,10 @@ {% from 'vars/globals.map.jinja' import GLOBALS %} -# used for qemu+ssh connection between manager and hypervisors -create_soqemussh_user: - user.present: - - name: soqemussh - - shell: /bin/bash - - home: /home/soqemussh -{% if not GLOBALS.is_manager %} - - groups: - - wheel - - qemu - - libvirt -{% endif %} + {% if GLOBALS.is_manager %} -create_local_libvirt_ssh_key_dir: - file.directory: - - name: /opt/so/saltstack/local/salt/libvirt/ssh/keys - - user: socore - - group: socore - - mode: 755 - - makedirs: True - -# generate the key pair and put the pub key in salt local files roots -generate_ssh_key_soqemussh: - cmd.run: - - name: ssh-keygen -q -N '' -t ed25519 -f /home/soqemussh/.ssh/id_ed25519 - - runas: soqemussh - - unless: test -f /home/soqemussh/.ssh/id_ed25519 - - require: - - user: create_soqemussh_user - -soqemussh_ssh_key_to_local: - cmd.run: - - name: cp /home/soqemussh/.ssh/id_ed25519.pub /opt/so/saltstack/local/salt/libvirt/ssh/keys - - onchanges: - - cmd: generate_ssh_key_soqemussh - qemu_ssh_client_config: file.managed: - name: /root/.ssh/config @@ -50,6 +16,17 @@ qemu_ssh_client_config: {% else %} +# used for qemu+ssh connection between manager and hypervisors +create_soqemussh_user: + user.present: + - name: soqemussh + - shell: /bin/bash + - home: /home/soqemussh + - groups: + - wheel + - qemu + - libvirt + soqemussh_pub_key: ssh_auth.present: - user: soqemussh From 01ac1cdccacd7d43cb2a2afaf7ec8ff6a6e96231 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 15 Jan 2025 14:13:12 -0500 Subject: [PATCH 069/303] check features and allowed/states --- salt/allowed_states.map.jinja | 4 +- salt/hypervisor/init.sls | 33 ++++++++++++ salt/libvirt/init.sls | 32 +++++++++-- salt/libvirt/packages.sls | 51 ++++++++++++++---- salt/libvirt/ssh/users.sls | 37 ++++++++++--- salt/reactor/check_hypervisor.sls | 2 +- salt/salt/cloud/init.sls | 31 ++++++++--- salt/salt/cloud/reactor_config_hypervisor.sls | 53 +++++++++++++++++++ salt/salt/master.sls | 13 +++-- 9 files changed, 226 insertions(+), 30 deletions(-) create mode 100644 salt/salt/cloud/reactor_config_hypervisor.sls diff --git a/salt/allowed_states.map.jinja b/salt/allowed_states.map.jinja index 07c677ba6..25cae50a7 100644 --- a/salt/allowed_states.map.jinja +++ b/salt/allowed_states.map.jinja @@ -86,6 +86,7 @@ 'so-manager': [ 'salt.master', 'salt.cloud', + 'libvirt', 'ca', 'ssl', 'registry', @@ -206,7 +207,8 @@ 'firewall', 'schedule', 'docker_clean', - 'stig' + 'stig', + 'hypervisor' ], 'so-desktop': [ 'ssl', diff --git a/salt/hypervisor/init.sls b/salt/hypervisor/init.sls index 3fa63bbcb..7bec6f25c 100644 --- a/salt/hypervisor/init.sls +++ b/salt/hypervisor/init.sls @@ -1,3 +1,18 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% from 'allowed_states.map.jinja' import allowed_states %} +{% if sls in allowed_states %} +{% if 'hvn' in salt['pillar.get']('features', []) %} + hypervisor_log_dir: file.directory: - name: /opt/so/log/hypervisor @@ -7,3 +22,21 @@ hypervisor_sbin: - name: /usr/sbin - source: salt://hypervisor/tools/sbin - file_mode: 744 + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} + +{% else %} + +{{sls}}_state_not_allowed: + test.fail_without_changes: + - name: {{sls}}_state_not_allowed + +{% endif %} diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index dae0ed2bd..b0c131330 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -1,9 +1,18 @@ # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." -{% from 'libvirt/map.jinja' import LIBVIRTMERGED %} +{% from 'allowed_states.map.jinja' import allowed_states %} +{% if sls in allowed_states %} +{% if 'hvn' in salt['pillar.get']('features', []) %} +{% from 'libvirt/map.jinja' import LIBVIRTMERGED %} include: - libvirt.64962 @@ -94,6 +103,23 @@ down_original_mgmt_interface: - nmcli -f GENERAL.CONNECTION dev show {{ pillar.host.mainint }} | grep bridge-slave-{{ pillar.host.mainint }} - order: last - # virtlogd service may not restart following reboot without this #semanage permissive -a virtlogd_t + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} + +{% else %} + +{{sls}}_state_not_allowed: + test.fail_without_changes: + - name: {{sls}}_state_not_allowed + +{% endif %} diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index 4de30568a..5f4b343a7 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -1,6 +1,25 @@ -#libvirt_source-packages_dir: - # file.directory: - # - name: /opt/so/conf/libvirt/source-packages +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% from 'allowed_states.map.jinja' import allowed_states %} +{% if sls.split('.')[0] in allowed_states %} +{% if 'hvn' in salt['pillar.get']('features', []) %} + +# allows for creating vm images +# any node manipulating images needs this +install_qemu-img: + pkg.installed: + - name: qemu-img + +{% if 'hyper' in grains.id.split('_') | last %} install_libvirt-libs: pkg.installed: @@ -11,12 +30,6 @@ install_libvirt-client: pkg.installed: - name: libvirt-client -# allows for creating vm images -# any node manipulating images needs this -install_qemu-img: - pkg.installed: - - name: qemu-img - install_guestfs-tools: pkg.installed: - name: guestfs-tools @@ -47,3 +60,23 @@ libvirt_python_module: - name: /opt/saltstack/salt/bin/python3 -m pip install --no-index --find-links=/opt/so/conf/libvirt/source-packages/libvirt-python libvirt-python - onchanges: - file: libvirt_python_wheel + +{% endif %} + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} + +{% else %} + +{{sls}}_state_not_allowed: + test.fail_without_changes: + - name: {{sls}}_state_not_allowed + +{% endif %} diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls index f0e30caec..0829075d2 100644 --- a/salt/libvirt/ssh/users.sls +++ b/salt/libvirt/ssh/users.sls @@ -1,20 +1,27 @@ # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." -{% from 'vars/globals.map.jinja' import GLOBALS %} +{% from 'allowed_states.map.jinja' import allowed_states %} +{% if sls in allowed_states %} +{% if 'hvn' in salt['pillar.get']('features', []) %} +{% from 'vars/globals.map.jinja' import GLOBALS %} - - -{% if GLOBALS.is_manager %} +{% if GLOBALS.is_manager %} qemu_ssh_client_config: file.managed: - name: /root/.ssh/config - source: salt://libvirt/ssh/files/config -{% else %} +{% else %} # used for qemu+ssh connection between manager and hypervisors create_soqemussh_user: @@ -32,4 +39,22 @@ soqemussh_pub_key: - user: soqemussh - source: salt://libvirt/ssh/keys/id_ed25519.pub +{% endif %} + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} + +{% else %} + +{{sls}}_state_not_allowed: + test.fail_without_changes: + - name: {{sls}}_state_not_allowed + {% endif %} diff --git a/salt/reactor/check_hypervisor.sls b/salt/reactor/check_hypervisor.sls index fdf75453d..9afc42354 100644 --- a/salt/reactor/check_hypervisor.sls +++ b/salt/reactor/check_hypervisor.sls @@ -1,4 +1,4 @@ -{% if data['id'].endswith(('_hypervisor', '_managerhyper')) %} +{% if data['act'] == 'accept' and data['id'].endswith(('_hypervisor', '_managerhyper')) and data['result'] == True %} check_and_trigger: runner.setup_hypervisor.setup_environment: [] {% endif %} diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index 5e160581b..7d987a5da 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -2,11 +2,18 @@ # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls in allowed_states %} -{% from 'salt/map.jinja' import SALTVERSION %} -{% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {} ) %} +{% if 'hvn' in salt['pillar.get']('features', []) %} +{% from 'salt/map.jinja' import SALTVERSION %} +{% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {} ) %} include: - libvirt.packages @@ -16,6 +23,7 @@ install_salt_cloud: - name: salt-cloud - version: {{SALTVERSION}} +{% if HYPERVISORS %} cloud_providers: file.managed: - name: /etc/salt/cloud.providers.d/libvirt.conf @@ -32,15 +40,26 @@ cloud_profiles: HYPERVISORS: {{HYPERVISORS}} - template: jinja -{% for role, hosts in HYPERVISORS.items() %} -{% for host in hosts.keys() %} +{% for role, hosts in HYPERVISORS.items() %} +{% for host in hosts.keys() %} hypervisor_{{host}}_{{role}}_pillar_dir: file.directory: - name: /opt/so/saltstack/local/pillar/hypervisor/{{host}}_{{role}} -{% endfor %} -{% endfor %} +{% endfor %} +{% endfor %} +{% endif %} + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} {% else %} diff --git a/salt/salt/cloud/reactor_config_hypervisor.sls b/salt/salt/cloud/reactor_config_hypervisor.sls new file mode 100644 index 000000000..433e01f31 --- /dev/null +++ b/salt/salt/cloud/reactor_config_hypervisor.sls @@ -0,0 +1,53 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% from 'allowed_states.map.jinja' import allowed_states %} +{% if sls.split('.')[:2]|join('.') in allowed_states %} +{% if 'hvn' in salt['pillar.get']('features', []) %} +reactor_config_hypervisor: + file.managed: + - name: /etc/salt/master.d/reactor_hypervisor.conf + - contents: | + reactor: + - 'salt/key': + - salt://reactor/check_hypervisor.sls + - 'salt/cloud/*/deploying': + - /opt/so/saltstack/default/salt/reactor/createEmptyPillar.sls + - 'setup/so-minion': + - /opt/so/saltstack/default/salt/reactor/sominion_setup.sls + - 'salt/cloud/*/destroyed': + - /opt/so/saltstack/default/salt/reactor/virtReleaseHardware.sls + - /opt/so/saltstack/default/salt/reactor/deleteKey.sls + - user: root + - group: root + - mode: 644 + - makedirs: True + - watch_in: + - service: salt_master_service + - order: last + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} + +{% else %} + +{{sls}}_state_not_allowed: + test.fail_without_changes: + - name: {{sls}}_state_not_allowed + +{% endif %} diff --git a/salt/salt/master.sls b/salt/salt/master.sls index 7e823f4e8..b997ced4e 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -2,14 +2,21 @@ # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls in allowed_states %} include: - salt.minion -{% if salt['pillar.get']('hypervisor:nodes', {} ) %} +{% if 'hvn' in salt['pillar.get']('features', []) %} - salt.cloud + - salt.cloud.reactor_config_hypervisor {% endif %} hold_salt_master_package: @@ -55,10 +62,8 @@ salt_master_service: {# # we need to managed adding the following to salt-master config if there are hypervisors reactor: - - 'salt/auth/accept/*': + - 'salt/key': - salt://reactor/check_hypervisor.sls - #- salt/cloud/*/creating': - #- salt/cloud/*/requesting - 'salt/cloud/*/deploying': - /opt/so/saltstack/default/salt/reactor/createEmptyPillar.sls - 'setup/so-minion': From cbd2d8800008e62e2bbff3ec5bb4ea9da8631d22 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 15 Jan 2025 16:59:39 -0500 Subject: [PATCH 070/303] sync the runners --- salt/salt/master.sls | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/salt/salt/master.sls b/salt/salt/master.sls index b997ced4e..3f847583f 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -17,6 +17,10 @@ include: {% if 'hvn' in salt['pillar.get']('features', []) %} - salt.cloud - salt.cloud.reactor_config_hypervisor + +sync_runners: + salt.runner: + - name: saltutil.sync_runners {% endif %} hold_salt_master_package: From 837fbab96d947074122687f33e9de29d9749f6bf Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 15 Jan 2025 17:00:06 -0500 Subject: [PATCH 071/303] minimize packages installed on manager for hyper --- salt/libvirt/packages.sls | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index 5f4b343a7..b1688b483 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -15,10 +15,16 @@ # allows for creating vm images # any node manipulating images needs this +# used on manager for setup_hypervisor runner install_qemu-img: pkg.installed: - name: qemu-img +# used on manager for setup_hypervisor runner +install_xorriso: + pkg.installed: + - name: xorriso + {% if 'hyper' in grains.id.split('_') | last %} install_libvirt-libs: @@ -34,10 +40,6 @@ install_guestfs-tools: pkg.installed: - name: guestfs-tools -install_xorriso: - pkg.installed: - - name: xorriso - install_virt-install: pkg.installed: - name: virt-install From e8546b82f8cdb13fc62efa472063728470df3a37 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 08:43:46 -0500 Subject: [PATCH 072/303] default image: sool9. cloud-init add local repo --- salt/_runners/setup_hypervisor.py | 21 ++++++++++++++++--- .../cloud/cloud.profiles.d/socloud.conf.jinja | 4 ++-- 2 files changed, 20 insertions(+), 5 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index e444b739a..9db9e2445 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -13,7 +13,7 @@ but can also be run manually if needed. CLI Examples: - # Perform complete environment setup (creates VM named 'so-ol9' with 220G disk by default) + # Perform complete environment setup (creates VM named 'sool9' with 220G disk by default) salt-run setup_hypervisor.setup_environment # Setup with custom VM name (uses default 220G disk) @@ -38,6 +38,7 @@ import os import pwd import requests import salt.utils.files +import socket import sys import time from cryptography.hazmat.primitives import serialization @@ -253,7 +254,7 @@ def _check_vm_exists(vm_name: str) -> bool: log.info("MAIN: VM %s already exists", vm_name) return exists -def setup_environment(vm_name: str = 'so-ol9', disk_size: str = '220G'): +def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G'): """ Main entry point to set up the hypervisor environment. This includes downloading the base image, generating SSH keys for remote access, @@ -261,7 +262,7 @@ def setup_environment(vm_name: str = 'so-ol9', disk_size: str = '220G'): Args: vm_name (str, optional): Name of the VM to create as part of environment setup. - Defaults to 'so-ol9'. + Defaults to 'sool9'. disk_size (str, optional): Size of the VM disk with unit. Defaults to '220G'. @@ -390,6 +391,9 @@ def create_vm(vm_name: str, disk_size: str = '220G'): log.error("CREATEVM: Failed to read SSH public key: %s", str(e)) return {'success': False, 'error': 'Failed to read SSH public key'} + # Get hostname for repo configuration + manager_hostname = socket.gethostname() + # Create meta-data meta_data = f"""instance-id: {vm_name} local-hostname: {vm_name} @@ -404,6 +408,7 @@ preserve_hostname: False hostname: {vm_name} fqdn: {vm_name}.local +# The passwd hash will be removed at release and is being used for debugging during development users: - default - name: soqemussh @@ -429,6 +434,16 @@ timezone: UTC packages: - qemu-guest-agent +write_files: + - path: /etc/yum.repos.d/securityonion.repo + content: | + [securityonion] + name=Security Onion Repo + baseurl=https://{manager_hostname}/repo + enabled=1 + gpgcheck=1 + sslverify=0 + runcmd: - systemctl enable --now qemu-guest-agent - systemctl enable --now serial-getty@ttyS0.service diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 4d3d33ac2..70a14225c 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -6,9 +6,9 @@ {%- for role, hosts in HYPERVISORS.items() %} {%- for host in hosts.keys() -%} -core-{{host}}: +sool9-{{host}}: provider: kvm-ssh-{{host}} - base_domain: coreol9 + base_domain: sool9 ip_source: qemu-agent ssh_username: soqemussh private_key: /home/soqemussh/.ssh/id_ed25519 From 0e0fb885d257a378e330e61d28399e8ef1f5cc5e Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 11:13:36 -0500 Subject: [PATCH 073/303] hypervisor highstate after image creation, not when key accepted --- salt/_runners/setup_hypervisor.py | 84 ++++++++++++++++++++++++++++++- salt/manager/tools/sbin/so-minion | 8 ++- salt/reactor/check_hypervisor.sls | 4 +- salt/reactor/sominion_setup.sls | 2 +- 4 files changed, 94 insertions(+), 4 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 9db9e2445..0a2845813 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -1,3 +1,14 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + """ This runner performs the initial setup required for hypervisor hosts in the environment. It handles downloading the Oracle Linux KVM image, setting up SSH keys for secure @@ -37,10 +48,12 @@ import logging import os import pwd import requests +import salt.client import salt.utils.files import socket import sys import time +import yaml from cryptography.hazmat.primitives import serialization from cryptography.hazmat.primitives.asymmetric import ed25519 @@ -55,6 +68,40 @@ formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(messag stream_handler.setFormatter(formatter) log.addHandler(stream_handler) +def _check_license(): + """Check if the license file exists and contains required values.""" + license_path = '/opt/so/saltstack/local/pillar/soc/license.sls' + + if not os.path.exists(license_path): + log.error("LICENSE: License file not found at %s", license_path) + return False + + try: + with salt.utils.files.fopen(license_path, 'r') as f: + license_data = yaml.safe_load(f) + + if not license_data: + log.error("LICENSE: Empty or invalid license file") + return False + + license_id = license_data.get('license_id') + features = license_data.get('features', []) + + if not license_id: + log.error("LICENSE: No license_id found in license file") + return False + + if 'hvn' not in features: + log.error("LICENSE: 'hvn' feature not found in license") + return False + + log.info("LICENSE: License validation successful") + return True + + except Exception as e: + log.error("LICENSE: Error reading license file: %s", str(e)) + return False + def _check_file_exists(path): """Check if a file exists and create its directory if needed.""" if os.path.exists(path): @@ -254,7 +301,7 @@ def _check_vm_exists(vm_name: str) -> bool: log.info("MAIN: VM %s already exists", vm_name) return exists -def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G'): +def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id: str = None): """ Main entry point to set up the hypervisor environment. This includes downloading the base image, generating SSH keys for remote access, @@ -269,6 +316,14 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G'): Returns: dict: Dictionary containing setup status and VM creation results """ + # Check license before proceeding + if not _check_license(): + return { + 'success': False, + 'error': 'Invalid license or missing hvn feature', + 'vm_result': None + } + log.info("MAIN: Starting setup_environment in setup_hypervisor runner") # Check if environment is already set up @@ -332,6 +387,21 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G'): success = vm_result.get('success', False) log.info("MAIN: Setup environment completed with status: %s", "SUCCESS" if success else "FAILED") + # If setup was successful and we have a minion_id, run highstate + if success and minion_id: + log.info("MAIN: Running highstate on hypervisor %s", minion_id) + try: + # Initialize the LocalClient + local = salt.client.LocalClient() + # Run highstate on the hypervisor + highstate_result = local.cmd(minion_id, 'state.highstate', [], timeout=1800) + if highstate_result and minion_id in highstate_result: + log.info("MAIN: Highstate completed on %s", minion_id) + else: + log.error("MAIN: Highstate failed or timed out on %s", minion_id) + except Exception as e: + log.error("MAIN: Error running highstate on %s: %s", minion_id, str(e)) + return { 'success': success, 'error': vm_result.get('error') if not success else None, @@ -349,6 +419,13 @@ def create_vm(vm_name: str, disk_size: str = '220G'): Returns: dict: Dictionary containing success status and commands to run on hypervisor """ + # Check license before proceeding + if not _check_license(): + return { + 'success': False, + 'error': 'Invalid license or missing hvn feature', + } + try: # Input validation if not isinstance(vm_name, str) or not vm_name: @@ -566,6 +643,11 @@ def regenerate_ssh_keys(): Returns: bool: True if successful, False on error """ + # Check license before proceeding + if not _check_license(): + log.error("MAIN: Invalid license or missing hvn feature") + return False + log.info("MAIN: Starting SSH key regeneration") try: # Verify current state diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index 141129b6d..daa4d3bc4 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -623,6 +623,12 @@ function updateMineAndApplyStates() { #checkMine "network.ip_addrs" # calls so-common and set_minionid sets MINIONID to local minion id set_minionid + + # We don't want a hypervisor node to highstate until the image is downloaded and built. This will be triggered from the setup_hypervisor runner + if [[ "$NODETYPE" == "HYPERVISOR" ]]; then + return 0 + fi + # if this is a searchnode or heavynode, start downloading logstash and elasticsearch containers while the manager prepares for the new node if [[ "$NODETYPE" == "SEARCHNODE" || "$NODETYPE" == "HEAVYNODE" ]]; then salt-run state.orch orch.container_download pillar="{'setup': {'newnode': $MINION_ID }}" > /dev/null 2>&1 & @@ -661,7 +667,7 @@ case "$OPERATION" in updateMineAndApplyStates ;; - "addVirt") + "addVM") setupMinionFiles ;; diff --git a/salt/reactor/check_hypervisor.sls b/salt/reactor/check_hypervisor.sls index 9afc42354..79ec06988 100644 --- a/salt/reactor/check_hypervisor.sls +++ b/salt/reactor/check_hypervisor.sls @@ -1,4 +1,6 @@ {% if data['act'] == 'accept' and data['id'].endswith(('_hypervisor', '_managerhyper')) and data['result'] == True %} check_and_trigger: - runner.setup_hypervisor.setup_environment: [] + runner.setup_hypervisor.setup_environment: + - kwargs: + minion_id: {{ data['id'] }} {% endif %} diff --git a/salt/reactor/sominion_setup.sls b/salt/reactor/sominion_setup.sls index a78475e6c..21c7824fe 100644 --- a/salt/reactor/sominion_setup.sls +++ b/salt/reactor/sominion_setup.sls @@ -28,7 +28,7 @@ def run(): with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + minionid + ".sls", 'w') as f: yaml.dump(vm_out_data, f, default_flow_style=False) - rc = call("NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVirt -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -a=" + DATA['INTERFACE'] + " -c=" + str(DATA['CPU']) + " -d='" + DATA['NODE_DESCRIPTION'] + "'" + " -e=" + DATA['ES_HEAP_SIZE'] + " -l=" + DATA['LS_HEAP_SIZE'], shell=True) + rc = call("NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVM -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -a=" + DATA['INTERFACE'] + " -c=" + str(DATA['CPU']) + " -d='" + DATA['NODE_DESCRIPTION'] + "'" + " -e=" + DATA['ES_HEAP_SIZE'] + " -l=" + DATA['LS_HEAP_SIZE'], shell=True) logging.error('sominion_setup reactor: rc: %s' % rc) From 58be7ae5db4c7637ea9c7a3b070cf35ecbaa49e9 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 11:16:20 -0500 Subject: [PATCH 074/303] rename from coreol9 or coreol9Small to sool9 --- salt/hypervisor/tools/sbin/so-qcow2-modify-network | 4 ++-- salt/libvirt/images/coreol9Small/README | 1 - salt/libvirt/images/init.sls | 6 +++--- salt/libvirt/images/sool9/README | 1 + salt/libvirt/init.sls | 2 +- salt/manager/tools/sbin/so-salt-cloud | 2 +- 6 files changed, 8 insertions(+), 8 deletions(-) delete mode 100644 salt/libvirt/images/coreol9Small/README create mode 100644 salt/libvirt/images/sool9/README diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin/so-qcow2-modify-network index 7920985b4..4e96bca22 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -12,9 +12,9 @@ Usage: python so-qcow2-modify-network.py -I -i (--dhcp4 | --static4 --ip4 --gw4 ) [--dns4 ] [--search4 ] Examples: - python so-qcow2-modify-network.py -I /var/lib/libvirt/images/coreol9/coreol9.qcow2 -i eth0 --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --search4 example.local + python so-qcow2-modify-network.py -I /var/lib/libvirt/images/sool9/sool9.qcow2 -i eth0 --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --search4 example.local - python so-qcow2-modify-network.py -I /var/lib/libvirt/images/coreol9/coreol9.qcow2 -i eth0 --dhcp4 + python so-qcow2-modify-network.py -I /var/lib/libvirt/images/sool9/sool9.qcow2 -i eth0 --dhcp4 """ import argparse diff --git a/salt/libvirt/images/coreol9Small/README b/salt/libvirt/images/coreol9Small/README deleted file mode 100644 index 28d066458..000000000 --- a/salt/libvirt/images/coreol9Small/README +++ /dev/null @@ -1 +0,0 @@ -# The files in this directory (/opt/so/saltstack/local/salt/libvirt/images/coreol9Small) are generated by createvm.sh. They are then distributed to the hypervisors where a storage pool will be created then the image can be installed. diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 605af2368..864a2e2eb 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -1,6 +1,6 @@ -# the source location will be /opt/so/saltstack/local/salt/libvirt/imaages/coreol9Small +# the source location will be /opt/so/saltstack/local/salt/libvirt/images/sool9 # this will need to change to save the images to /nsm baseimagefiles: file.recurse: - - name: /var/lib/libvirt/images/coreol9Small/ - - source: salt://libvirt/images/coreol9Small/ + - name: /var/lib/libvirt/images/sool9/ + - source: salt://libvirt/images/sool9/ diff --git a/salt/libvirt/images/sool9/README b/salt/libvirt/images/sool9/README new file mode 100644 index 000000000..286dd8a44 --- /dev/null +++ b/salt/libvirt/images/sool9/README @@ -0,0 +1 @@ +# The files in this directory (/opt/so/saltstack/local/salt/libvirt/images/sool9) are generated by createvm.sh. They are then distributed to the hypervisors where a storage pool will be created then the image can be installed. diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index b0c131330..de67f2971 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -79,7 +79,7 @@ set_default_pool: virt.pool_running: - name: default - ptype: dir - - target: /var/lib/libvirt/images/coreol9 + - target: /var/lib/libvirt/images/sool9 - permissions: - mode: 0711 - owner: qemu diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index 2691ea382..9bf4e2227 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -236,7 +236,7 @@ def run_qcow2_modify_hardware_config(profile, vm_name, cpu=None, memory=None, pc def run_qcow2_modify_network_config(profile, mode, ip=None, gateway=None, dns=None, search_domain=None): hv_name = profile.split('-')[1] target = hv_name + "_*" - image = '/var/lib/libvirt/images/coreol9/coreol9.qcow2.MODIFIED' + image = '/var/lib/libvirt/images/sool9/sool9.qcow2' interface = 'eth0' try: From 116c2b73c193dcf38bb0395aa9e8b4bc1f3b67f0 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 11:16:34 -0500 Subject: [PATCH 075/303] update gitignore --- .gitignore | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.gitignore b/.gitignore index 1830698b0..fc9d41531 100644 --- a/.gitignore +++ b/.gitignore @@ -70,6 +70,8 @@ site-packages # Project Scope Directory .projectScope/ +.clinerules +cline_docs/ # vscode settings .vscode/ From 739f59206107a3cdd8b29b8079cdd3b588808337 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 14:06:01 -0500 Subject: [PATCH 076/303] remove old line of code --- salt/manager/tools/sbin/so-minion | 1 - 1 file changed, 1 deletion(-) diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index daa4d3bc4..ff786772c 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -620,7 +620,6 @@ function addMinion() { function updateMineAndApplyStates() { - #checkMine "network.ip_addrs" # calls so-common and set_minionid sets MINIONID to local minion id set_minionid From 6367aed62aadaccdab3418055749a7eb734bf376 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 14:59:11 -0500 Subject: [PATCH 077/303] reactor needs to match runner function parameter structure --- salt/reactor/check_hypervisor.sls | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/salt/reactor/check_hypervisor.sls b/salt/reactor/check_hypervisor.sls index 79ec06988..889656b36 100644 --- a/salt/reactor/check_hypervisor.sls +++ b/salt/reactor/check_hypervisor.sls @@ -1,6 +1,5 @@ {% if data['act'] == 'accept' and data['id'].endswith(('_hypervisor', '_managerhyper')) and data['result'] == True %} check_and_trigger: runner.setup_hypervisor.setup_environment: - - kwargs: - minion_id: {{ data['id'] }} + - minion_id: {{ data['id'] }} {% endif %} From 61f5614ac9977e2a3321881a87cd378a30089c58 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 16:57:36 -0500 Subject: [PATCH 078/303] added logging and error handling so-minion --- salt/manager/tools/sbin/so-minion | 723 ++++++++++++++++++++++-------- 1 file changed, 542 insertions(+), 181 deletions(-) diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index ff786772c..f97acc2c5 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -5,6 +5,24 @@ # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# Setup logging +LOG_FILE="/opt/so/log/so-minion.log" +LOG_DIR=$(dirname "$LOG_FILE") + +# Create log directory if it doesn't exist +if [ ! -d "$LOG_DIR" ]; then + mkdir -p "$LOG_DIR" +fi + +# Logging function +log() { + local level=$1 + shift + local message="$*" + local timestamp=$(date '+%Y-%m-%d %H:%M:%S') + echo "[$timestamp] [$level] $message" >> "$LOG_FILE" +} + if [ -f /usr/sbin/so-common ]; then . /usr/sbin/so-common fi @@ -14,22 +32,25 @@ if [ -f /usr/sbin/so-elastic-fleet-common ]; then fi function usage() { - echo "Usage: $0 -o= -m=[id]" - echo "" - echo " where is one of the following:" - echo "" - echo " add: Accepts a new key and adds the minion files" - echo " delete: Removes the key and deletes the minion files" - echo " list: Lists all keys with hashes" - echo " reject: Rejects a key" - echo " restart: Restart a minion (reboot)" - echo " test: Perform minion test" - echo "" - exit 1 + local usage_text="Usage: $0 -o= -m=[id] + + where is one of the following: + + add: Accepts a new key and adds the minion files + delete: Removes the key and deletes the minion files + list: Lists all keys with hashes + reject: Rejects a key + restart: Restart a minion (reboot) + test: Perform minion test +" + echo "$usage_text" + log "ERROR" "Invalid usage" + return 1 } if [[ $# -lt 1 ]]; then usage + exit 1 fi for i in "$@"; do @@ -74,10 +95,12 @@ for i in "$@"; do ;; -*|--*) echo "Unknown option $i" + log "ERROR" "Unknown option $i" exit 1 ;; *) usage + exit 1 ;; esac done @@ -86,25 +109,50 @@ PILLARFILE=/opt/so/saltstack/local/pillar/minions/$MINION_ID.sls ADVPILLARFILE=/opt/so/saltstack/local/pillar/minions/adv_$MINION_ID.sls function getinstallinfo() { + log "INFO" "Getting install info for minion $MINION_ID" # Pull from file INSTALLVARS=$(sudo salt "$MINION_ID" cp.get_file_str /opt/so/install.txt --out=newline_values_only) + if [ $? -ne 0 ]; then + log "ERROR" "Failed to get install info from $MINION_ID" + return 1 + fi + source <(echo $INSTALLVARS) + if [ $? -ne 0 ]; then + log "ERROR" "Failed to source install variables" + return 1 + fi } function pcapspace() { + log "INFO" "Calculating PCAP space for minion $MINION_ID" + if [[ "$OPERATION" == "setup" ]]; then # Use 25% for PCAP PCAP_PERCENTAGE=1 DFREEPERCENT=21 local SPACESIZE=$(df -k /nsm | tail -1 | awk '{print $2}' | tr -d \n) + if [ $? -ne 0 ]; then + log "ERROR" "Failed to get NSM partition size" + return 1 + fi else - local NSMSIZE=$(salt "$MINION_ID" disk.usage --out=json | jq -r '.[]."/nsm"."1K-blocks" ') + if [ $? -ne 0 ]; then + log "ERROR" "Failed to get NSM disk usage from minion" + return 1 + fi + local ROOTSIZE=$(salt "$MINION_ID" disk.usage --out=json | jq -r '.[]."/"."1K-blocks" ') + if [ $? -ne 0 ]; then + log "ERROR" "Failed to get root disk usage from minion" + return 1 + fi if [[ "$NSMSIZE" == "null" ]]; then # Looks like there is no dedicated nsm partition. Using root local SPACESIZE=$ROOTSIZE + log "INFO" "No dedicated NSM partition found, using root partition" else local SPACESIZE=$NSMSIZE fi @@ -114,61 +162,129 @@ function pcapspace() { local s1=$(( $s / 4 * $PCAP_PERCENTAGE )) MAX_PCAP_SPACE=$s1 - } function testMinion() { - # Always run on the host, since this is going to be the manager of a distributed grid, or an eval/standalone. - # Distributed managers must run this in order for the sensor nodes to have access to the so-tcpreplay image. + log "INFO" "Testing minion $MINION_ID" + so-test result=$? + + if [ $result -ne 0 ]; then + log "ERROR" "Local so-test failed with exit code $result" + return 1 + fi - # If this so-minion script is not running on the given minion ID, run so-test remotely on the sensor as well local_id=$(lookup_grain id) if [[ ! "$local_id" =~ "${MINION_ID}_" && "$local_id" != "${MINION_ID}" ]]; then salt "$MINION_ID" cmd.run 'so-test' result=$? + if [ $result -ne 0 ]; then + log "ERROR" "Remote so-test failed on $MINION_ID with exit code $result" + return 1 + fi fi - - exit $result } function restartMinion() { + log "INFO" "Restarting minion $MINION_ID" salt "$MINION_ID" system.reboot result=$? - - exit $result + + if [ $result -ne 0 ]; then + log "ERROR" "Failed to restart minion $MINION_ID (exit code: $result)" + return 1 + fi } function listMinions() { salt-key list -F --out=json - exit $? + result=$? + + if [ $result -ne 0 ]; then + log "ERROR" "Failed to list minion keys (exit code: $result)" + return 1 + fi } function rejectMinion() { + log "INFO" "Rejecting minion $MINION_ID" salt-key -y -r $MINION_ID - exit $? + result=$? + + if [ $result -ne 0 ]; then + log "ERROR" "Failed to reject minion $MINION_ID (exit code: $result)" + return 1 + fi } function acceptminion() { + log "INFO" "Accepting minion $MINION_ID" + + if [[ "$MINION_ID" == *"_hypervisor" ]]; then + FEATURES=$(/usr/sbin/so-yaml.py get /opt/so/saltstack/local/pillar/soc/license.sls features) + if [[ $? -ne 0 || ! "$FEATURES" =~ "hvn" ]]; then + error_msg="Cannot accept hypervisor minion - hvn feature not enabled in license" + log "ERROR" "$error_msg" + echo "Error: $error_msg" + return 1 + fi + fi + salt-key -y -a $MINION_ID + result=$? + + if [ $result -ne 0 ]; then + log "ERROR" "Failed to accept minion $MINION_ID (exit code: $result)" + return 1 + fi } function deleteMinion() { + log "INFO" "Deleting minion $MINION_ID" salt-key -y -d $MINION_ID + result=$? + + if [ $result -ne 0 ]; then + log "ERROR" "Failed to delete minion $MINION_ID (exit code: $result)" + return 1 + fi } function deleteMinionFiles () { rm -f $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to delete $PILLARFILE" + return 1 + fi + rm -f $ADVPILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to delete $ADVPILLARFILE" + return 1 + fi } # Create the minion file function create_minion_files() { mkdir -p /opt/so/saltstack/local/pillar/minions + if [ $? -ne 0 ]; then + log "ERROR" "Failed to create minions directory" + return 1 + fi + touch $ADVPILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to create advanced pillar file" + return 1 + fi + if [ -f "$PILLARFILE" ]; then rm $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to remove existing pillar file" + return 1 + fi fi } @@ -179,6 +295,10 @@ function add_elasticsearch_to_minion() { " enabled: True"\ " esheap: '$ES_HEAP_SIZE'"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add elasticsearch configuration to $PILLARFILE" + return 1 + fi } @@ -188,14 +308,20 @@ function add_elastic_agent_to_minion() { "elasticagent:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add elastic agent configuration to $PILLARFILE" + return 1 + fi } # Add Elastic Fleet Server settings to the minion file function add_fleet_to_minion() { - # Create ES Token for Fleet server (Curl to Kibana API) - # TODO: Add error handling ESTOKEN=$(curl -K /opt/so/conf/elasticsearch/curl.config -L -X POST "localhost:5601/api/fleet/service_tokens" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' | jq -r .value) + if [ $? -ne 0 ]; then + log "ERROR" "Failed to obtain ES token for fleet server" + return 1 + fi # Write out settings to minion file printf '%s\n'\ @@ -205,6 +331,10 @@ function add_fleet_to_minion() { " server:"\ " es_token: '$ESTOKEN'"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add fleet configuration to $PILLARFILE" + return 1 + fi } # Add IDH Services info to the minion file @@ -214,6 +344,10 @@ function add_idh_to_minion() { " enabled: True"\ " restrict_management_ip: $IDH_MGTRESTRICT"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add IDH configuration to $PILLARFILE" + return 1 + fi } function add_logstash_to_minion() { @@ -226,6 +360,10 @@ function add_logstash_to_minion() { " settings:"\ " lsheap: $LSHEAP"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add logstash configuration to $PILLARFILE" + return 1 + fi } # Security Onion Desktop @@ -234,6 +372,10 @@ function add_desktop_to_minion() { "desktop:"\ " gui:"\ " enabled: true"\ >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add desktop configuration to $PILLARFILE" + return 1 + fi } # Add basic host info to the minion file @@ -242,6 +384,10 @@ function add_host_to_minion() { "host:"\ " mainip: '$MAINIP'"\ " mainint: '$MNIC'" >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add host configuration to $PILLARFILE" + return 1 + fi } # Add sensoroni specific information - Can we pull node_adrees from the host pillar? @@ -252,6 +398,10 @@ function add_sensoroni_to_minion() { " config:"\ " node_description: '${NODE_DESCRIPTION//\'/''}'"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add sensoroni configuration to $PILLARFILE" + return 1 + fi } # Add sensoroni specific information - Can we pull node_adrees from the host pillar? @@ -264,42 +414,55 @@ function add_sensoroni_with_analyze_to_minion() { " enabled: True"\ " node_description: '${NODE_DESCRIPTION//\'/''}'"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add sensoroni analyze configuration to $PILLARFILE" + return 1 + fi } # Sensor settings for the minion pillar function add_sensor_to_minion() { - echo "sensor:" >> $PILLARFILE - echo " interface: '$INTERFACE'" >> $PILLARFILE - echo " mtu: 9000" >> $PILLARFILE - echo "zeek:" >> $PILLARFILE - echo " enabled: True" >> $PILLARFILE - echo " config:" >> $PILLARFILE - echo " node:" >> $PILLARFILE - echo " lb_procs: '$CORECOUNT'" >> $PILLARFILE - echo "suricata:" >> $PILLARFILE - echo " enabled: True " >> $PILLARFILE - if [[ $is_pcaplimit ]]; then - echo " pcap:" >> $PILLARFILE - echo " maxsize: $MAX_PCAP_SPACE" >> $PILLARFILE - fi - echo " config:" >> $PILLARFILE - echo " af-packet:" >> $PILLARFILE - echo " threads: '$CORECOUNT'" >> $PILLARFILE - echo "pcap:" >> $PILLARFILE - echo " enabled: True" >> $PILLARFILE - if [[ $is_pcaplimit ]]; then - echo " config:" >> $PILLARFILE - echo " diskfreepercentage: $DFREEPERCENT" >> $PILLARFILE - fi - echo " " >> $PILLARFILE + { + echo "sensor:" + echo " interface: '$INTERFACE'" + echo " mtu: 9000" + echo "zeek:" + echo " enabled: True" + echo " config:" + echo " node:" + echo " lb_procs: '$CORECOUNT'" + echo "suricata:" + echo " enabled: True " + if [[ $is_pcaplimit ]]; then + echo " pcap:" + echo " maxsize: $MAX_PCAP_SPACE" + fi + echo " config:" + echo " af-packet:" + echo " threads: '$CORECOUNT'" + echo "pcap:" + echo " enabled: True" + if [[ $is_pcaplimit ]]; then + echo " config:" + echo " diskfreepercentage: $DFREEPERCENT" + fi + echo " " + } >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add sensor configuration to $PILLARFILE" + return 1 + fi } - function add_elastalert_to_minion() { printf '%s\n'\ "elastalert:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add elastalert configuration to $PILLARFILE" + return 1 + fi } function add_kibana_to_minion() { @@ -307,6 +470,10 @@ function add_kibana_to_minion() { "kibana:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add kibana configuration to $PILLARFILE" + return 1 + fi } function add_redis_to_minion() { @@ -314,6 +481,10 @@ function add_redis_to_minion() { "redis:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add redis configuration to $PILLARFILE" + return 1 + fi } function add_strelka_to_minion() { @@ -332,6 +503,10 @@ function add_strelka_to_minion() { " gatekeeper:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add strelka configuration to $PILLARFILE" + return 1 + fi } function add_telegraf_to_minion() { @@ -339,6 +514,10 @@ function add_telegraf_to_minion() { "telegraf:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add telegraf configuration to $PILLARFILE" + return 1 + fi } function add_influxdb_to_minion() { @@ -346,6 +525,10 @@ function add_influxdb_to_minion() { "influxdb:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add influxdb configuration to $PILLARFILE" + return 1 + fi } function add_nginx_to_minion() { @@ -353,6 +536,10 @@ function add_nginx_to_minion() { "nginx:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add nginx configuration to $PILLARFILE" + return 1 + fi } function add_soc_to_minion() { @@ -360,6 +547,10 @@ function add_soc_to_minion() { "soc:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add soc configuration to $PILLARFILE" + return 1 + fi } function add_registry_to_minion() { @@ -367,6 +558,10 @@ function add_registry_to_minion() { "registry:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add registry configuration to $PILLARFILE" + return 1 + fi } function add_kratos_to_minion() { @@ -374,6 +569,10 @@ function add_kratos_to_minion() { "kratos:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add kratos configuration to $PILLARFILE" + return 1 + fi } function add_idstools_to_minion() { @@ -381,6 +580,10 @@ function add_idstools_to_minion() { "idstools:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add idstools configuration to $PILLARFILE" + return 1 + fi } function add_elastic_fleet_package_registry_to_minion() { @@ -388,9 +591,14 @@ function add_elastic_fleet_package_registry_to_minion() { "elastic_fleet_package_registry:"\ " enabled: True"\ " " >> $PILLARFILE + if [ $? -ne 0 ]; then + log "ERROR" "Failed to add elastic fleet package registry configuration to $PILLARFILE" + return 1 + fi } function create_fleet_policy() { + log "INFO" "Creating fleet policy for $MINION_ID" # First, set the default output to Elasticsearch # This is required because of the license output bug @@ -401,301 +609,454 @@ function create_fleet_policy() { "is_default": true, "is_default_monitoring": false }') + if [ $? -ne 0 ]; then + log "ERROR" "Failed to create elasticsearch output JSON" + return 1 + fi curl -K /opt/so/conf/elasticsearch/curl.config -L -X PUT "localhost:5601/api/fleet/outputs/so-manager_elasticsearch" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d "$JSON_STRING" + if [ $? -ne 0 ]; then + log "ERROR" "Failed to set elasticsearch as default output" + return 1 + fi # Create the Fleet Server Policy elastic_fleet_policy_create "FleetServer_$LSHOSTNAME" "Fleet Server - $LSHOSTNAME" "false" "120" + if [ $? -ne 0 ]; then + log "ERROR" "Failed to create fleet server policy" + return 1 + fi # Modify the default integration policy to update the policy_id with the correct naming UPDATED_INTEGRATION_POLICY=$(jq --arg policy_id "FleetServer_$LSHOSTNAME" --arg name "fleet_server-$LSHOSTNAME" ' .policy_id = $policy_id | .name = $name' /opt/so/conf/elastic-fleet/integrations/fleet-server/fleet-server.json) + if [ $? -ne 0 ]; then + log "ERROR" "Failed to update integration policy" + return 1 + fi # Add the Fleet Server Integration to the new Fleet Policy elastic_fleet_integration_create "$UPDATED_INTEGRATION_POLICY" + if [ $? -ne 0 ]; then + log "ERROR" "Failed to create fleet server integration" + return 1 + fi # Set the default output back to the default /sbin/so-elastic-fleet-outputs-update + if [ $? -ne 0 ]; then + log "ERROR" "Failed to update fleet outputs" + return 1 + fi } function update_fleet_host_urls() { + log "INFO" "Updating fleet host URLs for $MINION_ID" + # Query for current Fleet Host URLs & append New Fleet Node Hostname & IP JSON_STRING=$(curl -K /opt/so/conf/elasticsearch/curl.config 'http://localhost:5601/api/fleet/fleet_server_hosts/grid-default' | jq --arg HOSTNAME "https://$LSHOSTNAME:8220" --arg IP "https://$MAINIP:8220" '.item.host_urls += [ $HOSTNAME, $IP ] | {"name":"grid-default","is_default":true,"host_urls": .item.host_urls}') + if [ $? -ne 0 ]; then + log "ERROR" "Failed to get current fleet host URLs" + return 1 + fi # Update Fleet Host URLs curl -K /opt/so/conf/elasticsearch/curl.config -L -X PUT "localhost:5601/api/fleet/fleet_server_hosts/grid-default" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d "$JSON_STRING" + if [ $? -ne 0 ]; then + log "ERROR" "Failed to update fleet host URLs" + return 1 + fi } function update_logstash_outputs() { + log "INFO" "Updating logstash outputs for $MINION_ID" + # Query for current Logstash outputs & append New Fleet Node Hostname & IP JSON_STRING=$(curl -K /opt/so/conf/elasticsearch/curl.config 'http://localhost:5601/api/fleet/outputs/so-manager_logstash' | jq --arg HOSTNAME "$LSHOSTNAME:5055" --arg IP "$MAINIP:5055" -r '.item.hosts += [ $HOSTNAME, $IP ] | {"name":"grid-logstash","type":"logstash","hosts": .item.hosts,"is_default":true,"is_default_monitoring":true,"config_yaml":""}') + if [ $? -ne 0 ]; then + log "ERROR" "Failed to get current logstash outputs" + return 1 + fi # Update Logstash Outputs curl -K /opt/so/conf/elasticsearch/curl.config -L -X PUT "localhost:5601/api/fleet/outputs/so-manager_logstash" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d "$JSON_STRING" + if [ $? -ne 0 ]; then + log "ERROR" "Failed to update logstash outputs" + return 1 + fi } function checkMine() { local func=$1 + log "INFO" "Checking mine for function $func on minion $MINION_ID" # make sure the minion sees itself in the mine since it needs to see itself for states as opposed to using salt-run - retry 20 1 "salt '$MINION_ID' mine.get '\*' '$func'" "$MINION_ID" - + retry 20 1 "salt '$MINION_ID' mine.get '\*' '$func'" "$MINION_ID" || { + log "ERROR" "Failed to verify mine function $func for $MINION_ID" + return 1 + } } function createEVAL() { + log "INFO" "Creating EVAL configuration for minion $MINION_ID" is_pcaplimit=true - pcapspace - add_elasticsearch_to_minion - add_sensor_to_minion - add_strelka_to_minion - add_elastalert_to_minion - add_kibana_to_minion - add_telegraf_to_minion - add_influxdb_to_minion - add_nginx_to_minion - add_soc_to_minion - add_registry_to_minion - add_kratos_to_minion - add_idstools_to_minion - add_elastic_fleet_package_registry_to_minion + pcapspace || return 1 + add_elasticsearch_to_minion || return 1 + add_sensor_to_minion || return 1 + add_strelka_to_minion || return 1 + add_elastalert_to_minion || return 1 + add_kibana_to_minion || return 1 + add_telegraf_to_minion || return 1 + add_influxdb_to_minion || return 1 + add_nginx_to_minion || return 1 + add_soc_to_minion || return 1 + add_registry_to_minion || return 1 + add_kratos_to_minion || return 1 + add_idstools_to_minion || return 1 + add_elastic_fleet_package_registry_to_minion || return 1 } function createSTANDALONE() { + log "INFO" "Creating STANDALONE configuration for minion $MINION_ID" is_pcaplimit=true - pcapspace - add_elasticsearch_to_minion - add_logstash_to_minion - add_sensor_to_minion - add_strelka_to_minion - add_elastalert_to_minion - add_kibana_to_minion - add_redis_to_minion - add_telegraf_to_minion - add_influxdb_to_minion - add_nginx_to_minion - add_soc_to_minion - add_registry_to_minion - add_kratos_to_minion - add_idstools_to_minion - add_elastic_fleet_package_registry_to_minion + pcapspace || return 1 + add_elasticsearch_to_minion || return 1 + add_logstash_to_minion || return 1 + add_sensor_to_minion || return 1 + add_strelka_to_minion || return 1 + add_elastalert_to_minion || return 1 + add_kibana_to_minion || return 1 + add_redis_to_minion || return 1 + add_telegraf_to_minion || return 1 + add_influxdb_to_minion || return 1 + add_nginx_to_minion || return 1 + add_soc_to_minion || return 1 + add_registry_to_minion || return 1 + add_kratos_to_minion || return 1 + add_idstools_to_minion || return 1 + add_elastic_fleet_package_registry_to_minion || return 1 } function createMANAGER() { - add_elasticsearch_to_minion - add_logstash_to_minion - add_elastalert_to_minion - add_kibana_to_minion - add_redis_to_minion - add_telegraf_to_minion - add_influxdb_to_minion - add_nginx_to_minion - add_soc_to_minion - add_registry_to_minion - add_kratos_to_minion - add_idstools_to_minion - add_elastic_fleet_package_registry_to_minion + log "INFO" "Creating MANAGER configuration for minion $MINION_ID" + add_elasticsearch_to_minion || return 1 + add_logstash_to_minion || return 1 + add_elastalert_to_minion || return 1 + add_kibana_to_minion || return 1 + add_redis_to_minion || return 1 + add_telegraf_to_minion || return 1 + add_influxdb_to_minion || return 1 + add_nginx_to_minion || return 1 + add_soc_to_minion || return 1 + add_registry_to_minion || return 1 + add_kratos_to_minion || return 1 + add_idstools_to_minion || return 1 + add_elastic_fleet_package_registry_to_minion || return 1 } function createMANAGERSEARCH() { - add_elasticsearch_to_minion - add_logstash_to_minion - add_elastalert_to_minion - add_kibana_to_minion - add_redis_to_minion - add_telegraf_to_minion - add_influxdb_to_minion - add_nginx_to_minion - add_soc_to_minion - add_registry_to_minion - add_kratos_to_minion - add_idstools_to_minion - add_elastic_fleet_package_registry_to_minion + log "INFO" "Creating MANAGERSEARCH configuration for minion $MINION_ID" + add_elasticsearch_to_minion || return 1 + add_logstash_to_minion || return 1 + add_elastalert_to_minion || return 1 + add_kibana_to_minion || return 1 + add_redis_to_minion || return 1 + add_telegraf_to_minion || return 1 + add_influxdb_to_minion || return 1 + add_nginx_to_minion || return 1 + add_soc_to_minion || return 1 + add_registry_to_minion || return 1 + add_kratos_to_minion || return 1 + add_idstools_to_minion || return 1 + add_elastic_fleet_package_registry_to_minion || return 1 } function createIMPORT() { - add_elasticsearch_to_minion - add_sensor_to_minion - add_kibana_to_minion - add_telegraf_to_minion - add_influxdb_to_minion - add_nginx_to_minion - add_soc_to_minion - add_registry_to_minion - add_kratos_to_minion - add_idstools_to_minion - add_elastic_fleet_package_registry_to_minion + log "INFO" "Creating IMPORT configuration for minion $MINION_ID" + add_elasticsearch_to_minion || return 1 + add_sensor_to_minion || return 1 + add_kibana_to_minion || return 1 + add_telegraf_to_minion || return 1 + add_influxdb_to_minion || return 1 + add_nginx_to_minion || return 1 + add_soc_to_minion || return 1 + add_registry_to_minion || return 1 + add_kratos_to_minion || return 1 + add_idstools_to_minion || return 1 + add_elastic_fleet_package_registry_to_minion || return 1 } function createFLEET() { - add_fleet_to_minion - add_logstash_to_minion - create_fleet_policy - update_fleet_host_urls + log "INFO" "Creating FLEET configuration for minion $MINION_ID" + add_fleet_to_minion || return 1 + add_logstash_to_minion || return 1 + create_fleet_policy || return 1 + update_fleet_host_urls || return 1 #update_logstash_outputs - add_telegraf_to_minion - add_nginx_to_minion + add_telegraf_to_minion || return 1 + add_nginx_to_minion || return 1 } function createIDH() { - add_idh_to_minion - add_telegraf_to_minion + log "INFO" "Creating IDH configuration for minion $MINION_ID" + add_idh_to_minion || return 1 + add_telegraf_to_minion || return 1 } function createHEAVYNODE() { + log "INFO" "Creating HEAVYNODE configuration for minion $MINION_ID" is_pcaplimit=true PCAP_PERCENTAGE=1 DFREEPERCENT=21 - pcapspace - add_elasticsearch_to_minion - add_elastic_agent_to_minion - add_sensor_to_minion - add_strelka_to_minion - add_redis_to_minion - add_telegraf_to_minion + pcapspace || return 1 + add_elasticsearch_to_minion || return 1 + add_elastic_agent_to_minion || return 1 + add_sensor_to_minion || return 1 + add_strelka_to_minion || return 1 + add_redis_to_minion || return 1 + add_telegraf_to_minion || return 1 } function createSENSOR() { + log "INFO" "Creating SENSOR configuration for minion $MINION_ID" is_pcaplimit=true DFREEPERCENT=10 PCAP_PERCENTAGE=3 - pcapspace - add_sensor_to_minion - add_strelka_to_minion - add_telegraf_to_minion + pcapspace || return 1 + add_sensor_to_minion || return 1 + add_strelka_to_minion || return 1 + add_telegraf_to_minion || return 1 } function createSEARCHNODE() { - add_elasticsearch_to_minion - add_logstash_to_minion - add_telegraf_to_minion + log "INFO" "Creating SEARCHNODE configuration for minion $MINION_ID" + add_elasticsearch_to_minion || return 1 + add_logstash_to_minion || return 1 + add_telegraf_to_minion || return 1 } function createRECEIVER() { - add_logstash_to_minion - add_redis_to_minion - add_telegraf_to_minion + log "INFO" "Creating RECEIVER configuration for minion $MINION_ID" + add_logstash_to_minion || return 1 + add_redis_to_minion || return 1 + add_telegraf_to_minion || return 1 } function createHYPERVISOR() { - add_telegraf_to_minion + log "INFO" "Creating HYPERVISOR configuration for minion $MINION_ID" + add_telegraf_to_minion || return 1 } function createDESKTOP() { - add_desktop_to_minion - add_telegraf_to_minion + log "INFO" "Creating DESKTOP configuration for minion $MINION_ID" + add_desktop_to_minion || return 1 + add_telegraf_to_minion || return 1 } function testConnection() { - # the minion should be trying to auth every 10 seconds so 15 seconds should be more than enough time to see this in the log - # this retry was put in because it is possible that a minion is attempted to be pinged before it has authenticated and connected to the Salt master - # causing the first ping to fail and typically wouldn't be successful until the second ping - # this check may pass without the minion being authenticated if it was previously connected and the line exists in the log + log "INFO" "Testing connection to minion $MINION_ID" + retry 15 1 "grep 'Authentication accepted from $MINION_ID' /opt/so/log/salt/master" local retauth=$? if [[ $retauth != 0 ]]; then - echo "The Minion did not authenticate with the Salt master in the allotted time" + error_msg="The Minion did not authenticate with the Salt master in the allotted time" + log "ERROR" "$error_msg" + echo "$error_msg" echo "Deleting the key" deleteminion - exit 1 + return 1 fi retry 15 3 "salt '$MINION_ID' test.ping" True local ret=$? if [[ $ret != 0 ]]; then - echo "The Minion has been accepted but is not online. Try again later" + error_msg="The Minion has been accepted but is not online" + log "ERROR" "$error_msg" + echo "$error_msg" echo "Deleting the key" deleteminion - exit 1 + return 1 fi } function addMinion() { + log "INFO" "Starting minion addition process for $MINION_ID" + # Accept the salt key - acceptminion + acceptminion || { + log "ERROR" "Failed to accept minion key" + return 1 + } + # Test to see if the minion was accepted - testConnection + testConnection || { + log "ERROR" "Failed to establish connection with minion" + return 1 + } + # Pull the info from the file to build what is needed - getinstallinfo + getinstallinfo || { + log "ERROR" "Failed to get installation information" + return 1 + } + + log "INFO" "Successfully added minion $MINION_ID" } function updateMineAndApplyStates() { + log "INFO" "Updating mine and applying states for minion $MINION_ID" # calls so-common and set_minionid sets MINIONID to local minion id set_minionid + if [ $? -ne 0 ]; then + log "ERROR" "Failed to set minion ID" + return 1 + fi # We don't want a hypervisor node to highstate until the image is downloaded and built. This will be triggered from the setup_hypervisor runner if [[ "$NODETYPE" == "HYPERVISOR" ]]; then + log "INFO" "Skipping state application for hypervisor node" return 0 fi # if this is a searchnode or heavynode, start downloading logstash and elasticsearch containers while the manager prepares for the new node if [[ "$NODETYPE" == "SEARCHNODE" || "$NODETYPE" == "HEAVYNODE" ]]; then + log "INFO" "Starting container download for $NODETYPE" salt-run state.orch orch.container_download pillar="{'setup': {'newnode': $MINION_ID }}" > /dev/null 2>&1 & + if [ $? -ne 0 ]; then + log "ERROR" "Failed to start container download" + return 1 + fi fi + if [[ "$NODETYPE" == "RECEIVER" ]]; then # Setup nodeid for Kafka + log "INFO" "Setting up Kafka node ID" salt-call state.apply kafka.nodes queue=True + if [ $? -ne 0 ]; then + log "ERROR" "Failed to setup Kafka node ID" + return 1 + fi fi + # $MINIONID is the minion id of the manager and $MINION_ID is the target node or the node being configured + log "INFO" "Deploying new node configuration" salt-run state.orch orch.deploy_newnode pillar="{'setup': {'manager': $MINIONID, 'newnode': $MINION_ID }}" > /dev/null 2>&1 & + if [ $? -ne 0 ]; then + log "ERROR" "Failed to start node deployment" + return 1 + fi } function setupMinionFiles() { + log "INFO" "Setting up minion files for $MINION_ID" + # Check to see if nodetype is set if [ -z $NODETYPE ]; then - echo "No node type specified" - exit 1 - fi - create_minion_files - add_host_to_minion - managers=("EVAL" "STANDALONE" "IMPORT" "MANAGER" "MANAGERSEARCH") - if echo "${managers[@]}" | grep -qw "$NODETYPE"; then - add_sensoroni_with_analyze_to_minion - else - add_sensoroni_to_minion + error_msg="No node type specified" + log "ERROR" "$error_msg" + echo "$error_msg" + return 1 fi - create$NODETYPE - echo "Minion file created for $MINION_ID" + # Create the base minion files + create_minion_files || return 1 + + # Add host configuration + add_host_to_minion || return 1 + + # Add sensoroni configuration based on node type + managers=("EVAL" "STANDALONE" "IMPORT" "MANAGER" "MANAGERSEARCH") + if echo "${managers[@]}" | grep -qw "$NODETYPE"; then + add_sensoroni_with_analyze_to_minion || return 1 + else + add_sensoroni_to_minion || return 1 + fi + + # Create node-specific configuration + create$NODETYPE || return 1 + + log "INFO" "Successfully created minion files for $MINION_ID" } case "$OPERATION" in "add") - addMinion - setupMinionFiles - updateMineAndApplyStates + log "INFO" "Adding minion $MINION_ID" + addMinion || { + log "ERROR" "Failed to add minion $MINION_ID" + exit 1 + } + setupMinionFiles || { + log "ERROR" "Failed to setup minion files for $MINION_ID" + exit 1 + } + updateMineAndApplyStates || { + log "ERROR" "Failed to update mine and apply states for $MINION_ID" + exit 1 + } + log "INFO" "Successfully completed all operations for minion $MINION_ID" ;; "addVM") - setupMinionFiles + log "INFO" "Adding VM minion $MINION_ID" + setupMinionFiles || { + log "ERROR" "Failed to setup VM minion files for $MINION_ID" + exit 1 + } + log "INFO" "Successfully added VM minion $MINION_ID" ;; "delete") - deleteMinionFiles - deleteMinion + log "INFO" "Removing minion $MINION_ID" + deleteMinionFiles || { + log "ERROR" "Failed to delete minion files for $MINION_ID" + exit 1 + } + deleteMinion || { + log "ERROR" "Failed to delete minion key for $MINION_ID" + exit 1 + } + log "INFO" "Successfully removed minion $MINION_ID" ;; "list") - listMinions + listMinions || { + log "ERROR" "Failed to list minion keys" + exit 1 + } ;; "reject") - rejectMinion + rejectMinion || { + log "ERROR" "Failed to reject minion $MINION_ID" + exit 1 + } ;; "restart") - restartMinion + restartMinion || { + log "ERROR" "Failed to restart minion $MINION_ID" + exit 1 + } ;; "setup") # only should be invoked directly during setup, never manually - setupMinionFiles + setupMinionFiles || { + log "ERROR" "Failed to setup minion files during setup for $MINION_ID" + exit 1 + } + log "INFO" "Successfully completed setup for minion $MINION_ID" ;; "test") - testMinion + testMinion || { + log "ERROR" "Failed to test minion $MINION_ID" + exit 1 + } ;; *) + log "ERROR" "Invalid operation: $OPERATION" usage ;; esac From 2277c792b9c04ff6b2dd42e17947d613ccf3f3f5 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 17:13:36 -0500 Subject: [PATCH 079/303] update feature error logging in so-minion --- salt/manager/tools/sbin/so-minion | 25 +++++++++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index f97acc2c5..fc6f0e416 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -224,9 +224,9 @@ function acceptminion() { if [[ "$MINION_ID" == *"_hypervisor" ]]; then FEATURES=$(/usr/sbin/so-yaml.py get /opt/so/saltstack/local/pillar/soc/license.sls features) if [[ $? -ne 0 || ! "$FEATURES" =~ "hvn" ]]; then - error_msg="Cannot accept hypervisor minion - hvn feature not enabled in license" + error_msg="Hypervisor nodes are a feature supported only for customers with a valid license.\n Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n for more information about purchasing a license to enable this feature." log "ERROR" "$error_msg" - echo "Error: $error_msg" + echo -e "Error: $error_msg" return 1 fi fi @@ -844,6 +844,13 @@ function createRECEIVER() { function createHYPERVISOR() { log "INFO" "Creating HYPERVISOR configuration for minion $MINION_ID" + FEATURES=$(/usr/sbin/so-yaml.py get /opt/so/saltstack/local/pillar/soc/license.sls features) + if [[ $? -ne 0 || ! "$FEATURES" =~ "hvn" ]]; then + error_msg="Hypervisor nodes are a feature supported only for customers with a valid license.\n Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n for more information about purchasing a license to enable this feature." + log "ERROR" "$error_msg" + echo -e "Error: $error_msg" + return 1 + fi add_telegraf_to_minion || return 1 } @@ -915,6 +922,13 @@ function updateMineAndApplyStates() { # We don't want a hypervisor node to highstate until the image is downloaded and built. This will be triggered from the setup_hypervisor runner if [[ "$NODETYPE" == "HYPERVISOR" ]]; then + FEATURES=$(/usr/sbin/so-yaml.py get /opt/so/saltstack/local/pillar/soc/license.sls features) + if [[ $? -ne 0 || ! "$FEATURES" =~ "hvn" ]]; then + error_msg="Hypervisor nodes are a feature supported only for customers with a valid license.\n Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n for more information about purchasing a license to enable this feature." + log "ERROR" "$error_msg" + echo -e "Error: $error_msg" + return 1 + fi log "INFO" "Skipping state application for hypervisor node" return 0 fi @@ -999,6 +1013,13 @@ case "$OPERATION" in "addVM") log "INFO" "Adding VM minion $MINION_ID" + FEATURES=$(/usr/sbin/so-yaml.py get /opt/so/saltstack/local/pillar/soc/license.sls features) + if [[ $? -ne 0 || ! "$FEATURES" =~ "hvn" ]]; then + error_msg="Hypervisor nodes are a feature supported only for customers with a valid license.\n Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n for more information about purchasing a license to enable this feature." + log "ERROR" "$error_msg" + echo -e "Error: $error_msg" + exit 1 + fi setupMinionFiles || { log "ERROR" "Failed to setup VM minion files for $MINION_ID" exit 1 From a274bfb744fb54cb5e2dfedf1e456301594b104c Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 17:45:07 -0500 Subject: [PATCH 080/303] license note --- salt/manager/tools/sbin/so-minion | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index fc6f0e416..fad765756 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -1,9 +1,15 @@ #!/bin/bash # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." # Setup logging LOG_FILE="/opt/so/log/so-minion.log" From 24eadf250768320433c158318c3e4253b83d52e8 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 17:46:20 -0500 Subject: [PATCH 081/303] add libvirt state to highstate for hypervisor. update allowed_states for libvirt --- salt/allowed_states.map.jinja | 6 ++++-- salt/libvirt/packages.sls | 2 +- salt/libvirt/ssh/users.sls | 2 +- salt/top.sls | 1 + 4 files changed, 7 insertions(+), 4 deletions(-) diff --git a/salt/allowed_states.map.jinja b/salt/allowed_states.map.jinja index 25cae50a7..694c81bae 100644 --- a/salt/allowed_states.map.jinja +++ b/salt/allowed_states.map.jinja @@ -86,7 +86,8 @@ 'so-manager': [ 'salt.master', 'salt.cloud', - 'libvirt', + 'libvirt.packages', + 'libvirt.ssh.users', 'ca', 'ssl', 'registry', @@ -208,7 +209,8 @@ 'schedule', 'docker_clean', 'stig', - 'hypervisor' + 'hypervisor', + 'libvirt' ], 'so-desktop': [ 'ssl', diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index b1688b483..73a96811f 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -10,7 +10,7 @@ # software that is protected by the license key." {% from 'allowed_states.map.jinja' import allowed_states %} -{% if sls.split('.')[0] in allowed_states %} +{% if sls.split('.')[0] in allowed_states or sls in allowed_states %} {% if 'hvn' in salt['pillar.get']('features', []) %} # allows for creating vm images diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls index 0829075d2..9b6a3beb7 100644 --- a/salt/libvirt/ssh/users.sls +++ b/salt/libvirt/ssh/users.sls @@ -10,7 +10,7 @@ # software that is protected by the license key." {% from 'allowed_states.map.jinja' import allowed_states %} -{% if sls in allowed_states %} +{% if sls.split('.')[0] in allowed_states or sls in allowed_states %} {% if 'hvn' in salt['pillar.get']('features', []) %} {% from 'vars/globals.map.jinja' import GLOBALS %} diff --git a/salt/top.sls b/salt/top.sls index 4f85b999e..d16e34d55 100644 --- a/salt/top.sls +++ b/salt/top.sls @@ -275,6 +275,7 @@ base: - firewall - elasticfleet.install_agent_grid - libvirt + - libvirt.images - stig '*_desktop and G@saltversion:{{saltversion}}': From 4cc36914891abb4591efc96ebbc405b7d228a30a Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 16 Jan 2025 17:51:39 -0500 Subject: [PATCH 082/303] give all nodes access to soc license pillar file --- pillar/top.sls | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) diff --git a/pillar/top.sls b/pillar/top.sls index 0f449a67c..3ff4672ae 100644 --- a/pillar/top.sls +++ b/pillar/top.sls @@ -18,6 +18,7 @@ base: - telegraf.adv_telegraf - versionlock.soc_versionlock - versionlock.adv_versionlock + - soc.license '* and not *_desktop': - firewall.soc_firewall @@ -44,7 +45,6 @@ base: - logstash.adv_logstash - soc.soc_soc - soc.adv_soc - - soc.license - kibana.soc_kibana - kibana.adv_kibana - kratos.soc_kratos @@ -88,7 +88,6 @@ base: - minions.{{ grains.id }} - minions.adv_{{ grains.id }} - stig.soc_stig - - soc.license '*_eval': - secrets @@ -113,7 +112,6 @@ base: - idstools.adv_idstools - soc.soc_soc - soc.adv_soc - - soc.license - kibana.soc_kibana - kibana.adv_kibana - strelka.soc_strelka @@ -170,7 +168,6 @@ base: - manager.adv_manager - soc.soc_soc - soc.adv_soc - - soc.license - kibana.soc_kibana - kibana.adv_kibana - strelka.soc_strelka @@ -236,7 +233,6 @@ base: - minions.{{ grains.id }} - minions.adv_{{ grains.id }} - stig.soc_stig - - soc.license - kafka.nodes - kafka.soc_kafka - kafka.adv_kafka @@ -254,8 +250,6 @@ base: - minions.adv_{{ grains.id }} - kafka.nodes - kafka.soc_kafka - - kafka.adv_kafka - - soc.license '*_import': - secrets @@ -277,7 +271,6 @@ base: - manager.adv_manager - soc.soc_soc - soc.adv_soc - - soc.license - kibana.soc_kibana - kibana.adv_kibana - backup.soc_backup @@ -320,4 +313,4 @@ base: - minions.{{ grains.id }} - minions.adv_{{ grains.id }} - stig.soc_stig - - soc.license + From 1f13554bd98aaf1928c7b869877c8ca212d818ff Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 17 Jan 2025 09:43:39 -0500 Subject: [PATCH 083/303] move add virt install and pool creation to images/init. start moving to /nsm/libvirt/ --- salt/_runners/setup_hypervisor.py | 29 +---------- salt/libvirt/images/init.sls | 81 +++++++++++++++++++++++++++++-- salt/libvirt/init.sls | 21 ++++---- 3 files changed, 88 insertions(+), 43 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 0a2845813..c5588689f 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -370,18 +370,7 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id log.info("MAIN: No changes detected, using existing VM %s", vm_name) vm_result = { 'success': True, - 'vm_dir': f'/opt/so/saltstack/local/salt/libvirt/images/{vm_name}', - 'commands': [ - f"virsh pool-create-as --name {vm_name} --type dir --target /opt/so/saltstack/local/salt/libvirt/images/{vm_name}", - f"""virt-install --name {vm_name} \\ - --memory 4096 --vcpus 4 --cpu host \\ - --disk /opt/so/saltstack/local/salt/libvirt/images/{vm_name}/{vm_name}.qcow2,format=qcow2,bus=virtio \\ - --disk /opt/so/saltstack/local/salt/libvirt/images/{vm_name}/{vm_name}-cidata.iso,device=cdrom \\ - --network bridge=br0,model=virtio \\ - --os-variant=ol9.5 \\ - --import \\ - --noautoconsole""" - ] + 'vm_dir': f'/opt/so/saltstack/local/salt/libvirt/images/{vm_name}' } success = vm_result.get('success', False) @@ -614,23 +603,9 @@ runcmd: user_data_path, meta_data_path], check=True, capture_output=True) - # Generate commands for hypervisor - commands = [ - f"virsh pool-create-as --name {vm_name} --type dir --target {vm_dir}", - f"""virt-install --name {vm_name} \\ - --memory 4096 --vcpus 4 --cpu host \\ - --disk {vm_image},format=qcow2,bus=virtio \\ - --disk {cidata_iso},device=cdrom \\ - --network bridge=br0,model=virtio \\ - --os-variant=ol9.5 \\ - --import \\ - --noautoconsole""" - ] - return { 'success': True, - 'vm_dir': vm_dir, - 'commands': commands + 'vm_dir': vm_dir } except Exception as e: diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 864a2e2eb..e36fd628c 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -1,6 +1,79 @@ -# the source location will be /opt/so/saltstack/local/salt/libvirt/images/sool9 -# this will need to change to save the images to /nsm -baseimagefiles: +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% from 'allowed_states.map.jinja' import allowed_states %} +{% if sls.split('.')[0] in allowed_states or sls in allowed_states %} +{% if 'hvn' in salt['pillar.get']('features', []) %} + +include: + - libvirt.packages + +# Copy base image files +baseimagefiles_sool9: file.recurse: - - name: /var/lib/libvirt/images/sool9/ + - name: /nsm/libvirt/images/sool9/ - source: salt://libvirt/images/sool9/ + - makedirs: True + +# Define the storage pool +define_storage_pool_sool9: + virt.pool_defined: + - name: sool9 + - ptype: dir + - target: /nsm/libvirt/images/sool9 + - require: + - file: baseimagefiles_sool9 + - cmd: libvirt_python_module + +# Start the storage pool +start_storage_pool_sool9: + virt.pool_running: + - name: sool9 + - ptype: dir + - target: /nsm/libvirt/images/sool9 + - require: + - virt: define_storage_pool_sool9 + - cmd: libvirt_python_module + +# Create and start the VM using virt-install +create_vm_sool9: + cmd.run: + - name: | + virt-install --name sool9 \ + --memory 4096 --vcpus 4 --cpu host \ + --disk /nsm/libvirt/images/sool9/sool9.qcow2,format=qcow2,bus=virtio \ + --disk /nsm/libvirt/images/sool9/sool9-cidata.iso,device=cdrom \ + --network bridge=br0,model=virtio \ + --os-variant=ol9.5 \ + --import \ + --noautoconsole + - unless: virsh list --all | grep -q sool9 + - require: + - virt: start_storage_pool_sool9 + - pkg: install_virt-install + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} + +{% else %} + +{{sls}}_state_not_allowed: + test.fail_without_changes: + - name: {{sls}}_state_not_allowed + +{% endif %} diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index de67f2971..4321fdfb1 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -74,24 +74,21 @@ create_host_bridge: - forward: bridge - autostart: True -# set the default storage pool to point to the location we want -set_default_pool: - virt.pool_running: - - name: default - - ptype: dir - - target: /var/lib/libvirt/images/sool9 - - permissions: - - mode: 0711 - - owner: qemu - - group: qemu - - label: "system_u:object_r:virt_image_t:s0" # this doesnt seem to set the selinux context - - autostart: True +# Disable the default storage pool to avoid conflicts +disable_default_pool: + cmd.run: + - name: virsh pool-destroy default && virsh pool-autostart default --disable + - onlyif: virsh pool-list | grep default + - require: + - pkg: install_libvirt-client + - service: libvirt_service disable_default_bridge: cmd.run: - name: virsh net-destroy default && virsh net-autostart default --disable - require: - pkg: install_libvirt-client + - service: libvirt_service - onlyif: - virsh net-list | grep default From 54eeb0e327c672b84477f4bfb0d7500a7d3c5748 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 17 Jan 2025 19:27:04 -0500 Subject: [PATCH 084/303] handle refreshing base image and reinstalling the vm if the source qcow2 image changes --- salt/_runners/setup_hypervisor.py | 45 ++++++++++----- salt/libvirt/images/init.sls | 93 +++++++++++++++++++++++++++---- 2 files changed, 113 insertions(+), 25 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index c5588689f..b7d842a52 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -10,6 +10,9 @@ # software that is protected by the license key." """ +TODO: Change default disk_size from 60G to 220G. this was set to speed up vm start during development + Remove passwd hash prior to release. used for development + This runner performs the initial setup required for hypervisor hosts in the environment. It handles downloading the Oracle Linux KVM image, setting up SSH keys for secure communication, and creating the initial VM. @@ -24,10 +27,10 @@ but can also be run manually if needed. CLI Examples: - # Perform complete environment setup (creates VM named 'sool9' with 220G disk by default) + # Perform complete environment setup (creates VM named 'sool9' with 60G disk by default) salt-run setup_hypervisor.setup_environment - # Setup with custom VM name (uses default 220G disk) + # Setup with custom VM name (uses default 60G disk) salt-run setup_hypervisor.setup_environment myvm # Setup with custom VM name and disk size @@ -36,7 +39,7 @@ CLI Examples: # Regenerate SSH keys only salt-run setup_hypervisor.regenerate_ssh_keys - # Create additional VM with default disk size (220G) + # Create additional VM with default disk size (60G) salt-run setup_hypervisor.create_vm myvm2 # Create additional VM with custom disk size @@ -301,7 +304,7 @@ def _check_vm_exists(vm_name: str) -> bool: log.info("MAIN: VM %s already exists", vm_name) return exists -def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id: str = None): +def setup_environment(vm_name: str = 'sool9', disk_size: str = '60G', minion_id: str = None): """ Main entry point to set up the hypervisor environment. This includes downloading the base image, generating SSH keys for remote access, @@ -311,7 +314,7 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id vm_name (str, optional): Name of the VM to create as part of environment setup. Defaults to 'sool9'. disk_size (str, optional): Size of the VM disk with unit. - Defaults to '220G'. + Defaults to '60G'. Returns: dict: Dictionary containing setup status and VM creation results @@ -397,13 +400,13 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id 'vm_result': vm_result } -def create_vm(vm_name: str, disk_size: str = '220G'): +def create_vm(vm_name: str, disk_size: str = '60G'): """ Create a new VM with cloud-init configuration. Args: vm_name (str): Name of the VM - disk_size (str): Size of the disk with unit (default: '220G') + disk_size (str): Size of the disk with unit (default: '60G') Returns: dict: Dictionary containing success status and commands to run on hypervisor @@ -496,10 +499,6 @@ ssh_genkeytypes: ['ed25519', 'rsa'] # set timezone for VM timezone: UTC -# Install QEMU guest agent. Enable and start the service -packages: - - qemu-guest-agent - write_files: - path: /etc/yum.repos.d/securityonion.repo content: | @@ -510,15 +509,22 @@ write_files: gpgcheck=1 sslverify=0 +packages: + - qemu-guest-agent + runcmd: - - systemctl enable --now qemu-guest-agent + # Remove all repo files except securityonion.repo + - for f in /etc/yum.repos.d/*.repo; do if [ "$(basename $f)" != "securityonion.repo" ]; then rm -f "$f"; fi; done - systemctl enable --now serial-getty@ttyS0.service - systemctl enable --now NetworkManager + - systemctl enable --now qemu-guest-agent - growpart /dev/vda 2 - pvresize /dev/vda2 - lvextend -l +100%FREE /dev/vg_main/lv_root - xfs_growfs /dev/vg_main/lv_root - - touch /etc/cloud/cloud-init.disabled + - systemctl stop cloud-init + - systemctl disable cloud-init + - dnf remove cloud-init - shutdown -P now """ user_data_path = os.path.join(vm_dir, 'user-data') @@ -603,6 +609,19 @@ runcmd: user_data_path, meta_data_path], check=True, capture_output=True) + # Generate SHA256 hash of the qcow2 image + sha256_hash = hashlib.sha256() + with salt.utils.files.fopen(vm_image, 'rb') as f: + for chunk in iter(lambda: f.read(4096), b''): + sha256_hash.update(chunk) + + # Write hash to file + hash_file = os.path.join(vm_dir, f'{vm_name}.sha256') + with salt.utils.files.fopen(hash_file, 'w') as f: + f.write(sha256_hash.hexdigest()) + + log.info("CREATEVM: Generated SHA256 hash for %s", vm_image) + return { 'success': True, 'vm_dir': vm_dir diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index e36fd628c..667835d3a 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -16,13 +16,43 @@ include: - libvirt.packages -# Copy base image files -baseimagefiles_sool9: - file.recurse: - - name: /nsm/libvirt/images/sool9/ - - source: salt://libvirt/images/sool9/ +# Manage SHA256 hash file +manage_sha256_sool9: + file.managed: + - name: /nsm/libvirt/images/sool9/sool9.sha256 + - source: salt://libvirt/images/sool9/sool9.sha256 - makedirs: True +# Manage qcow2 image +manage_qcow2_sool9: + file.managed: + - name: /nsm/libvirt/images/sool9/sool9.qcow2 + - source: salt://libvirt/images/sool9/sool9.qcow2 + - onchanges: + - file: manage_sha256_sool9 + +# Manage cloud-init files +manage_metadata_sool9: + file.managed: + - name: /nsm/libvirt/images/sool9/meta-data + - source: salt://libvirt/images/sool9/meta-data + - require: + - file: manage_qcow2_sool9 + +manage_userdata_sool9: + file.managed: + - name: /nsm/libvirt/images/sool9/user-data + - source: salt://libvirt/images/sool9/user-data + - require: + - file: manage_qcow2_sool9 + +manage_cidata_sool9: + file.managed: + - name: /nsm/libvirt/images/sool9/sool9-cidata.iso + - source: salt://libvirt/images/sool9/sool9-cidata.iso + - require: + - file: manage_qcow2_sool9 + # Define the storage pool define_storage_pool_sool9: virt.pool_defined: @@ -30,18 +60,56 @@ define_storage_pool_sool9: - ptype: dir - target: /nsm/libvirt/images/sool9 - require: - - file: baseimagefiles_sool9 + - file: manage_metadata_sool9 + - file: manage_userdata_sool9 + - file: manage_cidata_sool9 - cmd: libvirt_python_module + - unless: + - virsh pool-list --all | grep -q sool9 + +# Set pool autostart +set_pool_autostart_sool9: + cmd.run: + - name: virsh pool-autostart sool9 + - require: + - virt: define_storage_pool_sool9 + - unless: + - virsh pool-info sool9 | grep -q "Autostart.*yes" # Start the storage pool start_storage_pool_sool9: - virt.pool_running: - - name: sool9 - - ptype: dir - - target: /nsm/libvirt/images/sool9 + cmd.run: + - name: virsh pool-start sool9 - require: - virt: define_storage_pool_sool9 - cmd: libvirt_python_module + - unless: + - virsh pool-info sool9 | grep -q "State.*running" + +# Stop the VM if running and base image files change +stop_vm_sool9: + module.run: + - virt.stop: + - name: sool9 + - onchanges: + - file: manage_qcow2_sool9 + - require_in: + - module: undefine_vm_sool9 + - onlyif: + # Only try to stop if VM is actually running + - virsh list --state-running --name | grep -q sool9 + +undefine_vm_sool9: + module.run: + - virt.undefine: + - vm_: sool9 + - onchanges: + - file: manage_qcow2_sool9 + # Note: When VM doesn't exist, you'll see "error: failed to get domain 'sool9'" - this is expected + # [ERROR ] Command 'virsh' failed with return code: 1 + # [ERROR ] stdout: error: failed to get domain 'sool9' + - onlyif: + - virsh dominfo sool9 # Create and start the VM using virt-install create_vm_sool9: @@ -55,10 +123,11 @@ create_vm_sool9: --os-variant=ol9.5 \ --import \ --noautoconsole - - unless: virsh list --all | grep -q sool9 - require: - - virt: start_storage_pool_sool9 + - cmd: start_storage_pool_sool9 - pkg: install_virt-install + - onchanges: + - file: manage_qcow2_sool9 {% else %} {{sls}}_no_license_detected: From a896332db321f3487fb2214a73d93319edd27d04 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 17 Jan 2025 19:49:41 -0500 Subject: [PATCH 085/303] fix deprecation --- salt/_runners/setup_hypervisor.py | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index b7d842a52..ac0811591 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -486,7 +486,7 @@ users: sudo: ALL=(ALL) NOPASSWD:ALL lock_passwd: false passwd: $6$THWuTZMZhIVMGaaw$w9kozn7z7i0Y9LRVGZwN6mcZag4vMpE3hW6eCtKNHlFpL1XLcOdiIr29JyDxx3MLBXNedIqnqcj4psqCjv58d. - ssh-authorized-keys: + ssh_authorized_keys: - {ssh_pub_key} # Configure where output will go @@ -509,9 +509,6 @@ write_files: gpgcheck=1 sslverify=0 -packages: - - qemu-guest-agent - runcmd: # Remove all repo files except securityonion.repo - for f in /etc/yum.repos.d/*.repo; do if [ "$(basename $f)" != "securityonion.repo" ]; then rm -f "$f"; fi; done From 3a78be68d6cdde2b505fe257ff970c26bf249955 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 17 Jan 2025 20:05:35 -0500 Subject: [PATCH 086/303] ensure cloud-init is removed --- salt/_runners/setup_hypervisor.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index ac0811591..ee1e0d91d 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -521,7 +521,7 @@ runcmd: - xfs_growfs /dev/vg_main/lv_root - systemctl stop cloud-init - systemctl disable cloud-init - - dnf remove cloud-init + - dnf -y remove cloud-init - shutdown -P now """ user_data_path = os.path.join(vm_dir, 'user-data') From 60387651d20078931e18ac69a6f2430d54fb2af5 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 17 Jan 2025 20:13:42 -0500 Subject: [PATCH 087/303] recreate the base vm if any of the cloud init files change --- salt/libvirt/images/init.sls | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 667835d3a..aba2744a8 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -93,6 +93,9 @@ stop_vm_sool9: - name: sool9 - onchanges: - file: manage_qcow2_sool9 + - file: manage_metadata_sool9 + - file: manage_userdata_sool9 + - file: manage_cidata_sool9 - require_in: - module: undefine_vm_sool9 - onlyif: @@ -105,6 +108,9 @@ undefine_vm_sool9: - vm_: sool9 - onchanges: - file: manage_qcow2_sool9 + - file: manage_metadata_sool9 + - file: manage_userdata_sool9 + - file: manage_cidata_sool9 # Note: When VM doesn't exist, you'll see "error: failed to get domain 'sool9'" - this is expected # [ERROR ] Command 'virsh' failed with return code: 1 # [ERROR ] stdout: error: failed to get domain 'sool9' @@ -128,6 +134,9 @@ create_vm_sool9: - pkg: install_virt-install - onchanges: - file: manage_qcow2_sool9 + - file: manage_metadata_sool9 + - file: manage_userdata_sool9 + - file: manage_cidata_sool9 {% else %} {{sls}}_no_license_detected: From a74ed0daf0f11bbeac2bf1a838c08572897c2240 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 17 Jan 2025 21:25:40 -0500 Subject: [PATCH 088/303] fix disabling cloud-init and system shutdown. increase ram/cpu of base vm. shrink disk_size to 6G for testing --- salt/_runners/setup_hypervisor.py | 27 +++++++++++++++------------ salt/libvirt/images/init.sls | 2 +- 2 files changed, 16 insertions(+), 13 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index ee1e0d91d..145eddf7f 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -10,7 +10,7 @@ # software that is protected by the license key." """ -TODO: Change default disk_size from 60G to 220G. this was set to speed up vm start during development +TODO: Change default disk_size from 6G to 220G. this was set to speed up vm start during development Remove passwd hash prior to release. used for development This runner performs the initial setup required for hypervisor hosts in the environment. @@ -27,10 +27,10 @@ but can also be run manually if needed. CLI Examples: - # Perform complete environment setup (creates VM named 'sool9' with 60G disk by default) + # Perform complete environment setup (creates VM named 'sool9' with 6G disk by default) salt-run setup_hypervisor.setup_environment - # Setup with custom VM name (uses default 60G disk) + # Setup with custom VM name (uses default 6G disk) salt-run setup_hypervisor.setup_environment myvm # Setup with custom VM name and disk size @@ -39,7 +39,7 @@ CLI Examples: # Regenerate SSH keys only salt-run setup_hypervisor.regenerate_ssh_keys - # Create additional VM with default disk size (60G) + # Create additional VM with default disk size (6G) salt-run setup_hypervisor.create_vm myvm2 # Create additional VM with custom disk size @@ -304,7 +304,7 @@ def _check_vm_exists(vm_name: str) -> bool: log.info("MAIN: VM %s already exists", vm_name) return exists -def setup_environment(vm_name: str = 'sool9', disk_size: str = '60G', minion_id: str = None): +def setup_environment(vm_name: str = 'sool9', disk_size: str = '6G', minion_id: str = None): """ Main entry point to set up the hypervisor environment. This includes downloading the base image, generating SSH keys for remote access, @@ -314,7 +314,7 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '60G', minion_id: vm_name (str, optional): Name of the VM to create as part of environment setup. Defaults to 'sool9'. disk_size (str, optional): Size of the VM disk with unit. - Defaults to '60G'. + Defaults to '6G'. Returns: dict: Dictionary containing setup status and VM creation results @@ -400,13 +400,13 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '60G', minion_id: 'vm_result': vm_result } -def create_vm(vm_name: str, disk_size: str = '60G'): +def create_vm(vm_name: str, disk_size: str = '6G'): """ Create a new VM with cloud-init configuration. Args: vm_name (str): Name of the VM - disk_size (str): Size of the disk with unit (default: '60G') + disk_size (str): Size of the disk with unit (default: '6G') Returns: dict: Dictionary containing success status and commands to run on hypervisor @@ -519,10 +519,13 @@ runcmd: - pvresize /dev/vda2 - lvextend -l +100%FREE /dev/vg_main/lv_root - xfs_growfs /dev/vg_main/lv_root - - systemctl stop cloud-init - - systemctl disable cloud-init - - dnf -y remove cloud-init - - shutdown -P now + - touch /etc/cloud/cloud-init.disabled + +power_state: + delay: "now" + mode: poweroff + timeout: 30 + condition: True """ user_data_path = os.path.join(vm_dir, 'user-data') with salt.utils.files.fopen(user_data_path, 'w') as f: diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index aba2744a8..8532760a7 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -122,7 +122,7 @@ create_vm_sool9: cmd.run: - name: | virt-install --name sool9 \ - --memory 4096 --vcpus 4 --cpu host \ + --memory 12288 --vcpus 8 --cpu host \ --disk /nsm/libvirt/images/sool9/sool9.qcow2,format=qcow2,bus=virtio \ --disk /nsm/libvirt/images/sool9/sool9-cidata.iso,device=cdrom \ --network bridge=br0,model=virtio \ From ae01dc963943eea54b24fa02926107e4bedca1f4 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 17 Jan 2025 22:26:39 -0500 Subject: [PATCH 089/303] manager needs more packages for salt-cloud. change location of priv key for salt-cloud config --- salt/libvirt/packages.sls | 30 +++++++++---------- .../cloud/cloud.profiles.d/socloud.conf.jinja | 2 +- 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index 73a96811f..195232329 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -25,12 +25,25 @@ install_xorriso: pkg.installed: - name: xorriso -{% if 'hyper' in grains.id.split('_') | last %} - install_libvirt-libs: pkg.installed: - name: libvirt-libs +libvirt_python_wheel: + file.recurse: + - name: /opt/so/conf/libvirt/source-packages/libvirt-python + - source: salt://libvirt/source-packages/libvirt-python + - makedirs: True + - clean: True + +libvirt_python_module: + cmd.run: + - name: /opt/saltstack/salt/bin/python3 -m pip install --no-index --find-links=/opt/so/conf/libvirt/source-packages/libvirt-python libvirt-python + - onchanges: + - file: libvirt_python_wheel + +{% if 'hyper' in grains.id.split('_') | last %} + # provides virsh install_libvirt-client: pkg.installed: @@ -50,19 +63,6 @@ install_python3-libguestfs: - name: python3-libguestfs ### -libvirt_python_wheel: - file.recurse: - - name: /opt/so/conf/libvirt/source-packages/libvirt-python - - source: salt://libvirt/source-packages/libvirt-python - - makedirs: True - - clean: True - -libvirt_python_module: - cmd.run: - - name: /opt/saltstack/salt/bin/python3 -m pip install --no-index --find-links=/opt/so/conf/libvirt/source-packages/libvirt-python libvirt-python - - onchanges: - - file: libvirt_python_wheel - {% endif %} {% else %} diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 70a14225c..0e65c60e0 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -11,7 +11,7 @@ sool9-{{host}}: base_domain: sool9 ip_source: qemu-agent ssh_username: soqemussh - private_key: /home/soqemussh/.ssh/id_ed25519 + private_key: /etc/ssh/auth_keys/soqemussh/id_ed25519 sudo: True deploy_command: sh /tmp/.saltcloud-*/deploy.sh script_args: -F -x python3 stable 3006.9 From c13c85bd2d2e7899b2520e1d8532cd2e0e0286e6 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 17 Jan 2025 22:54:46 -0500 Subject: [PATCH 090/303] manager needs ssh config. need -r to ignore bootstrap provided repos --- salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja | 2 +- salt/salt/cloud/init.sls | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 0e65c60e0..eb2f5b75e 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -14,7 +14,7 @@ sool9-{{host}}: private_key: /etc/ssh/auth_keys/soqemussh/id_ed25519 sudo: True deploy_command: sh /tmp/.saltcloud-*/deploy.sh - script_args: -F -x python3 stable 3006.9 + script_args: -r -F -x python3 stable 3006.9 minion: master: {{ grains.host }} master_port: 4506 diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index 7d987a5da..b0f9ca7fa 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -17,6 +17,7 @@ include: - libvirt.packages + - libvirt.ssh.users install_salt_cloud: pkg.installed: From 7c50a5e17b51447a61d4ead2dbe7de930d7d69cf Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 17 Jan 2025 23:16:18 -0500 Subject: [PATCH 091/303] cloud-init needs to import repo gpg keys so packags can install --- salt/_runners/setup_hypervisor.py | 46 ++++++++++++++++++++++++++++++- 1 file changed, 45 insertions(+), 1 deletion(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 145eddf7f..a366eacad 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -46,6 +46,7 @@ CLI Examples: salt-run setup_hypervisor.create_vm myvm3 300G """ +import base64 import hashlib import logging import os @@ -71,6 +72,16 @@ formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(messag stream_handler.setFormatter(formatter) log.addHandler(stream_handler) +def _read_and_encode_key(key_path: str) -> str: + """Read a key file and return its base64 encoded content.""" + try: + with salt.utils.files.fopen(key_path, 'rb') as f: + content = f.read() + return base64.b64encode(content).decode('utf-8') + except Exception as e: + log.error("Error reading key file %s: %s", key_path, str(e)) + raise + def _check_license(): """Check if the license file exists and contains required values.""" license_path = '/opt/so/saltstack/local/pillar/soc/license.sls' @@ -463,6 +474,14 @@ def create_vm(vm_name: str, disk_size: str = '6G'): # Get hostname for repo configuration manager_hostname = socket.gethostname() + # Read and encode GPG keys + keys_dir = '/opt/so/saltstack/default/salt/repo/client/files/oracle/keys' + oracle_key = _read_and_encode_key(os.path.join(keys_dir, 'RPM-GPG-KEY-oracle')) + epel_key = _read_and_encode_key(os.path.join(keys_dir, 'RPM-GPG-KEY-EPEL-9')) + salt_key = _read_and_encode_key(os.path.join(keys_dir, 'SALT-PROJECT-GPG-PUBKEY-2023.pub')) + docker_key = _read_and_encode_key(os.path.join(keys_dir, 'docker.pub')) + securityonion_key = _read_and_encode_key(os.path.join(keys_dir, 'securityonion.pub')) + # Create meta-data meta_data = f"""instance-id: {vm_name} local-hostname: {vm_name} @@ -508,9 +527,34 @@ write_files: enabled=1 gpgcheck=1 sslverify=0 + - path: /etc/pki/rpm-gpg/RPM-GPG-KEY-oracle + encoding: b64 + content: | + {oracle_key} + - path: /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-9 + encoding: b64 + content: | + {epel_key} + - path: /etc/pki/rpm-gpg/SALT-PROJECT-GPG-PUBKEY-2023.pub + encoding: b64 + content: | + {salt_key} + - path: /etc/pki/rpm-gpg/docker.pub + encoding: b64 + content: | + {docker_key} + - path: /etc/pki/rpm-gpg/securityonion.pub + encoding: b64 + content: | + {securityonion_key} runcmd: - # Remove all repo files except securityonion.repo + # Import GPG keys and remove repo files except securityonion.repo + - rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-oracle + - rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-9 + - rpm --import /etc/pki/rpm-gpg/SALT-PROJECT-GPG-PUBKEY-2023.pub + - rpm --import /etc/pki/rpm-gpg/docker.pub + - rpm --import /etc/pki/rpm-gpg/securityonion.pub - for f in /etc/yum.repos.d/*.repo; do if [ "$(basename $f)" != "securityonion.repo" ]; then rm -f "$f"; fi; done - systemctl enable --now serial-getty@ttyS0.service - systemctl enable --now NetworkManager From 8ed3f0b1cc0ce2ad55d42035e3280c4e1c84368a Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Sat, 18 Jan 2025 07:30:36 -0500 Subject: [PATCH 092/303] change base image path for so-salt-cloud --- salt/hypervisor/tools/sbin/so-qcow2-modify-network | 4 ++-- salt/manager/tools/sbin/so-salt-cloud | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin/so-qcow2-modify-network index 4e96bca22..c5aa1aa22 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -12,9 +12,9 @@ Usage: python so-qcow2-modify-network.py -I -i (--dhcp4 | --static4 --ip4 --gw4 ) [--dns4 ] [--search4 ] Examples: - python so-qcow2-modify-network.py -I /var/lib/libvirt/images/sool9/sool9.qcow2 -i eth0 --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --search4 example.local + python so-qcow2-modify-network.py -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --search4 example.local - python so-qcow2-modify-network.py -I /var/lib/libvirt/images/sool9/sool9.qcow2 -i eth0 --dhcp4 + python so-qcow2-modify-network.py -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --dhcp4 """ import argparse diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index 9bf4e2227..816f74a46 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -236,7 +236,7 @@ def run_qcow2_modify_hardware_config(profile, vm_name, cpu=None, memory=None, pc def run_qcow2_modify_network_config(profile, mode, ip=None, gateway=None, dns=None, search_domain=None): hv_name = profile.split('-')[1] target = hv_name + "_*" - image = '/var/lib/libvirt/images/sool9/sool9.qcow2' + image = '/nsm/libvirt/images/sool9/sool9.qcow2' interface = 'eth0' try: From 17943ef0dbbb197186ab0ed32ce3748b58bffe6f Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Sat, 18 Jan 2025 08:24:50 -0500 Subject: [PATCH 093/303] add hypervisor state to hypervisor node --- salt/_modules/qcow2.py | 2 +- salt/top.sls | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/salt/_modules/qcow2.py b/salt/_modules/qcow2.py index 0cbcd8707..0339849fa 100644 --- a/salt/_modules/qcow2.py +++ b/salt/_modules/qcow2.py @@ -29,7 +29,7 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, .. code-block:: bash - salt '*' qcow2.modify_network_config image='/path/to/image.qcow2' interface='eth0' mode='static4' ip4='192.168.1.10/24' gw4='192.168.1.1' dns4='192.168.1.1,8.8.8.8' search4='example.local' + salt '*' qcow2.modify_network_config image='/nsm/libvirt/images/sool9/sool9.qcow2' interface='eth0' mode='static4' ip4='192.168.1.10/24' gw4='192.168.1.1' dns4='192.168.1.1,8.8.8.8' search4='example.local' ''' diff --git a/salt/top.sls b/salt/top.sls index d16e34d55..edabfe97e 100644 --- a/salt/top.sls +++ b/salt/top.sls @@ -276,6 +276,7 @@ base: - elasticfleet.install_agent_grid - libvirt - libvirt.images + - hypervisor - stig '*_desktop and G@saltversion:{{saltversion}}': From 64c923042387a88f507c9287657030fb09133a19 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Sat, 18 Jan 2025 10:44:44 -0500 Subject: [PATCH 094/303] prevent conflicts with network manager in base vm --- salt/_runners/setup_hypervisor.py | 171 ++++++++++++++++++++++++------ 1 file changed, 136 insertions(+), 35 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index a366eacad..81dfd08f4 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -13,37 +13,55 @@ TODO: Change default disk_size from 6G to 220G. this was set to speed up vm start during development Remove passwd hash prior to release. used for development -This runner performs the initial setup required for hypervisor hosts in the environment. -It handles downloading the Oracle Linux KVM image, setting up SSH keys for secure -communication, and creating the initial VM. +This runner performs the initial setup required for hypervisor hosts in the Security Onion environment. +It handles downloading the Oracle Linux KVM image, setting up SSH keys for secure communication, +and creating virtual machines with cloud-init configuration. -Functions: - setup_environment: Downloads image, sets up SSH keys, and creates initial VM - regenerate_ssh_keys: Regenerates SSH keys for remote access - create_vm: Creates a new VM with cloud-init configuration +Usage: + salt-run setup_hypervisor. [arguments] -The runner is typically triggered automatically when a new hypervisor minion connects, -but can also be run manually if needed. +Options: + vm_name: Name for the virtual machine (alphanumeric, hyphens, underscores) + disk_size: Size of the VM disk with unit (e.g., '6G', '300G') + minion_id: Salt minion ID of the hypervisor (optional) -CLI Examples: - - # Perform complete environment setup (creates VM named 'sool9' with 6G disk by default) +Examples: + # Complete environment setup (default VM 'sool9' with 6G disk) salt-run setup_hypervisor.setup_environment - # Setup with custom VM name (uses default 6G disk) - salt-run setup_hypervisor.setup_environment myvm - # Setup with custom VM name and disk size salt-run setup_hypervisor.setup_environment myvm 300G - # Regenerate SSH keys only + # Regenerate SSH keys salt-run setup_hypervisor.regenerate_ssh_keys - # Create additional VM with default disk size (6G) - salt-run setup_hypervisor.create_vm myvm2 + # Create additional VM + salt-run setup_hypervisor.create_vm myvm2 300G - # Create additional VM with custom disk size - salt-run setup_hypervisor.create_vm myvm3 300G + Notes: + - Verifies Security Onion license + - Downloads and validates Oracle Linux KVM image if needed + - Generates Ed25519 SSH keys if not present + - Creates/recreates VM based on environment changes + - Forces hypervisor configuration via highstate after successful setup (when minion_id provided) + + Description: + The setup process includes: + 1. License validation + 2. Oracle Linux KVM image download and checksum verification + 3. SSH key generation for secure VM access + 4. Cloud-init configuration for VM provisioning + 5. VM creation with specified disk size + 6. Hypervisor configuration via highstate (when minion_id provided and setup successful) + +Exit Codes: + Success: Returns dictionary with 'success': True and VM details + Failure: Returns dictionary with 'success': False and error message + +Logging: + All operations are logged to: + - Standard output (INFO level and above) + - System log with 'setup_hypervisor' tag """ import base64 @@ -318,17 +336,42 @@ def _check_vm_exists(vm_name: str) -> bool: def setup_environment(vm_name: str = 'sool9', disk_size: str = '6G', minion_id: str = None): """ Main entry point to set up the hypervisor environment. - This includes downloading the base image, generating SSH keys for remote access, - and creating the initial VM. + + This function orchestrates the complete setup process for a Security Onion hypervisor, + including image management, SSH key setup, and VM creation. It ensures all components + are properly configured and validates the environment at each step. Args: - vm_name (str, optional): Name of the VM to create as part of environment setup. - Defaults to 'sool9'. - disk_size (str, optional): Size of the VM disk with unit. - Defaults to '6G'. + vm_name (str, optional): Name for the VM to create. Must contain only + alphanumeric characters, hyphens, or underscores. + Defaults to 'sool9'. + disk_size (str, optional): Size of the VM disk with unit (e.g., '6G', '300G'). + Must end with 'G' or 'M'. Defaults to '6G'. + minion_id (str, optional): Salt minion ID of the hypervisor. When provided, + forces the hypervisor to apply its configuration via + highstate after successful environment setup (image + download, SSH keys, VM creation). Returns: - dict: Dictionary containing setup status and VM creation results + dict: A dictionary containing: + - success (bool): True if setup completed successfully + - error (str): Error message if setup failed, None otherwise + - vm_result (dict): Details about VM creation if successful + + Notes: + - Verifies Security Onion license + - Downloads and validates Oracle Linux KVM image if needed + - Generates Ed25519 SSH keys if not present + - Creates/recreates VM based on environment changes + - Forces hypervisor configuration via highstate after successful setup + (when minion_id is provided) + + Example: + result = setup_environment('myvm', '300G', 'hypervisor1') + if result['success']: + print(f"VM created at {result['vm_result']['vm_dir']}") + else: + print(f"Setup failed: {result['error']}") """ # Check license before proceeding if not _check_license(): @@ -413,14 +456,39 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '6G', minion_id: def create_vm(vm_name: str, disk_size: str = '6G'): """ - Create a new VM with cloud-init configuration. - + Creates a new virtual machine with cloud-init configuration. + + This function handles the complete VM creation process, including directory setup, + image management, and cloud-init configuration. It ensures proper setup of the VM + environment with all necessary components. + Args: - vm_name (str): Name of the VM - disk_size (str): Size of the disk with unit (default: '6G') - + vm_name (str): Name for the VM. Must contain only alphanumeric characters, + hyphens, or underscores. + disk_size (str): Size of the VM disk with unit (e.g., '6G', '300G'). + Must end with 'G' or 'M'. Defaults to '6G'. + Returns: - dict: Dictionary containing success status and commands to run on hypervisor + dict: A dictionary containing: + - success (bool): True if VM creation completed successfully + - error (str): Error message if creation failed + - vm_dir (str): Path to VM directory if successful + + Notes: + - Validates Security Onion license + - Creates cloud-init ISO for VM configuration + - Copies and resizes base Oracle Linux image + - Compresses final image for efficiency + - Generates SHA256 hash for verification + - Configures repositories and GPG keys + - Sets up system services and storage + + Example: + result = create_vm('myvm', '300G') + if result['success']: + print(f"VM created at {result['vm_dir']}") + else: + print(f"Creation failed: {result['error']}") """ # Check license before proceeding if not _check_license(): @@ -518,6 +586,10 @@ ssh_genkeytypes: ['ed25519', 'rsa'] # set timezone for VM timezone: UTC +# Disable cloud-init network configuration to prevent conflicts with NetworkManager +network: + config: disabled + write_files: - path: /etc/yum.repos.d/securityonion.repo content: | @@ -564,6 +636,7 @@ runcmd: - lvextend -l +100%FREE /dev/vg_main/lv_root - xfs_growfs /dev/vg_main/lv_root - touch /etc/cloud/cloud-init.disabled + - rm -f /etc/sysconfig/network-scripts/ifcfg-eth0 power_state: delay: "now" @@ -677,9 +750,37 @@ power_state: def regenerate_ssh_keys(): """ - Regenerate SSH keys. + Regenerates SSH keys used for hypervisor VM access. + + This function handles the complete process of SSH key regeneration, including + validation, cleanup of existing keys, and generation of new keys with proper + permissions and distribution. + Returns: - bool: True if successful, False on error + bool: True if keys were successfully regenerated, False otherwise + + Notes: + - Validates Security Onion license + - Removes existing keys if present + - Generates new Ed25519 key pair + - Sets secure permissions (600 for private, 644 for public) + - Distributes public key to required locations + + Description: + The function performs these steps: + 1. Validates Security Onion license + 2. Checks for existing SSH keys + 3. Removes old keys if present + 4. Creates required directories with secure permissions + 5. Generates new Ed25519 key pair + 6. Sets appropriate file permissions + 7. Distributes public key to required locations + + Example: + if regenerate_ssh_keys(): + print("SSH keys successfully regenerated") + else: + print("Failed to regenerate SSH keys") """ # Check license before proceeding if not _check_license(): From 9db3cd901cfe865b23c6ff86bae286732a7fee6c Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Sat, 18 Jan 2025 10:45:10 -0500 Subject: [PATCH 095/303] update documentation of core functionality --- salt/_modules/qcow2.py | 154 ++++++++++++--- .../tools/sbin/so-kvm-modify-hardware | 102 ++++++++-- .../tools/sbin/so-qcow2-modify-network | 110 ++++++++++- salt/manager/tools/sbin/so-salt-cloud | 183 ++++++++++++------ 4 files changed, 444 insertions(+), 105 deletions(-) diff --git a/salt/_modules/qcow2.py b/salt/_modules/qcow2.py index 0339849fa..37858484e 100644 --- a/salt/_modules/qcow2.py +++ b/salt/_modules/qcow2.py @@ -1,5 +1,23 @@ #!py +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +""" +Salt module for managing QCOW2 image configurations and VM hardware settings. This module provides functions +for modifying network configurations within QCOW2 images and adjusting virtual machine hardware settings. +It serves as a Salt interface to the so-qcow2-modify-network and so-kvm-modify-hardware scripts. + +The module offers two main capabilities: +1. Network Configuration: Modify network settings (DHCP/static IP) within QCOW2 images +2. Hardware Configuration: Adjust VM hardware settings (CPU, memory, PCI passthrough) + +This module is intended to work with Security Onion's virtualization infrastructure and is typically +used in conjunction with salt-cloud for VM provisioning and management. +""" + import logging import subprocess import shlex @@ -13,24 +31,67 @@ def __virtual__(): def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, search4=None): ''' - Wrapper function to call so-qcow2-modify-network + Usage: + salt '*' qcow2.modify_network_config image= interface= mode= [ip4=] [gw4=] [dns4=] [search4=] - :param image: Path to the QCOW2 image. - :param interface: Network interface to modify (e.g., 'eth0'). - :param mode: 'dhcp4' or 'static4'. - :param ip4: IPv4 address with CIDR notation (e.g., '192.168.1.10/24'). Required for static configuration. - :param gw4: IPv4 gateway (e.g., '192.168.1.1'). Required for static configuration. - :param dns4: Comma-separated list of IPv4 DNS servers (e.g., '8.8.8.8,8.8.4.4'). - :param search4: DNS search domain for IPv4. + Options: + image + Path to the QCOW2 image file that will be modified + interface + Network interface name to configure (e.g., 'eth0') + mode + Network configuration mode, either 'dhcp4' or 'static4' + ip4 + IPv4 address with CIDR notation (e.g., '192.168.1.10/24') + Required when mode='static4' + gw4 + IPv4 gateway address (e.g., '192.168.1.1') + Required when mode='static4' + dns4 + Comma-separated list of IPv4 DNS servers (e.g., '8.8.8.8,8.8.4.4') + Optional for both DHCP and static configurations + search4 + DNS search domain for IPv4 (e.g., 'example.local') + Optional for both DHCP and static configurations - :return: A dictionary with the result of the script execution. + Examples: + 1. **Configure DHCP:** + ```bash + salt '*' qcow2.modify_network_config image='/nsm/libvirt/images/sool9/sool9.qcow2' interface='eth0' mode='dhcp4' + ``` + This configures eth0 to use DHCP for IP assignment - CLI Example: + 2. **Configure Static IP:** + ```bash + salt '*' qcow2.modify_network_config image='/nsm/libvirt/images/sool9/sool9.qcow2' interface='eth0' mode='static4' ip4='192.168.1.10/24' gw4='192.168.1.1' dns4='192.168.1.1,8.8.8.8' search4='example.local' + ``` + This sets a static IP configuration with DNS servers and search domain - .. code-block:: bash + Notes: + - The QCOW2 image must be accessible and writable by the salt minion + - The image should not be in use by a running VM when modified + - Network changes take effect on next VM boot + - Requires so-qcow2-modify-network script to be installed - salt '*' qcow2.modify_network_config image='/nsm/libvirt/images/sool9/sool9.qcow2' interface='eth0' mode='static4' ip4='192.168.1.10/24' gw4='192.168.1.1' dns4='192.168.1.1,8.8.8.8' search4='example.local' + Description: + This function modifies network configuration within a QCOW2 image file by executing + the so-qcow2-modify-network script. It supports both DHCP and static IPv4 configuration. + The script mounts the image, modifies the network configuration files, and unmounts + safely. All operations are logged for troubleshooting purposes. + Exit Codes: + 0: Success + 1: Invalid parameters or configuration + 2: Image access or mounting error + 3: Network configuration error + 4: System command error + 255: Unexpected error + + Logging: + - All operations are logged to the salt minion log + - Log entries are prefixed with 'qcow2 module:' + - Error conditions include detailed error messages and stack traces + - Success/failure status is logged for verification ''' cmd = ['/usr/sbin/so-qcow2-modify-network', '-I', image, '-i', interface] @@ -69,22 +130,71 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, def modify_hardware_config(vm_name, cpu=None, memory=None, pci=None, start=False): ''' - Wrapper function to call so-kvm-modify-hardware + Usage: + salt '*' qcow2.modify_hardware_config vm_name= [cpu=] [memory=] [pci=] [start=] - :param vm_name: Name of the virtual machine to modify. - :param cpu: Number of virtual CPUs to assign. - :param memory: Amount of memory to assign in MiB. - :param pci: PCI hardware ID to passthrough to the VM (e.g., '0000:00:1f.2'). - :param start: Boolean flag to start the VM after modification. + Options: + vm_name + Name of the virtual machine to modify + cpu + Number of virtual CPUs to assign (positive integer) + Optional - VM's current CPU count retained if not specified + memory + Amount of memory to assign in MiB (positive integer) + Optional - VM's current memory size retained if not specified + pci + PCI hardware ID to passthrough to the VM (e.g., '0000:00:1f.2') + Optional - no PCI passthrough if not specified + start + Boolean flag to start the VM after modification + Optional - defaults to False - :return: A dictionary with the result of the script execution. + Examples: + 1. **Modify CPU and Memory:** + ```bash + salt '*' qcow2.modify_hardware_config vm_name='sensor1' cpu=4 memory=8192 + ``` + This assigns 4 CPUs and 8GB memory to the VM - CLI Example: + 2. **Enable PCI Passthrough:** + ```bash + salt '*' qcow2.modify_hardware_config vm_name='sensor1' pci='0000:00:1f.2' start=True + ``` + This configures PCI passthrough and starts the VM - .. code-block:: bash + 3. **Complete Hardware Configuration:** + ```bash + salt '*' qcow2.modify_hardware_config vm_name='sensor1' cpu=8 memory=16384 pci='0000:00:1f.2' start=True + ``` + This sets CPU, memory, PCI passthrough, and starts the VM - salt '*' qcow2.modify_hardware_config vm_name='my_vm' cpu=4 memory=8192 pci='0000:00:1f.2' start=True + Notes: + - VM must be stopped before modification unless only the start flag is set + - Memory is specified in MiB (1024 = 1GB) + - PCI devices must be available and not in use by the host + - CPU count should align with host capabilities + - Requires so-kvm-modify-hardware script to be installed + Description: + This function modifies the hardware configuration of a KVM virtual machine using + the so-kvm-modify-hardware script. It can adjust CPU count, memory allocation, + and PCI device passthrough. Changes are applied to the VM's libvirt configuration. + The VM can optionally be started after modifications are complete. + + Exit Codes: + 0: Success + 1: Invalid parameters + 2: VM state error (running when should be stopped) + 3: Hardware configuration error + 4: System command error + 255: Unexpected error + + Logging: + - All operations are logged to the salt minion log + - Log entries are prefixed with 'qcow2 module:' + - Hardware configuration changes are logged + - Errors include detailed messages and stack traces + - Final status of modification is logged ''' cmd = ['/usr/sbin/so-kvm-modify-hardware', '-v', vm_name] diff --git a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware index b6e2ea281..e2d64919a 100644 --- a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware +++ b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware @@ -6,10 +6,20 @@ # Elastic License 2.0. """ -Script to modify hardware parameters of a KVM virtual machine. +Script for managing hardware configurations of KVM virtual machines. This script provides +functionality to modify CPU, memory, and PCI device settings without manual XML editing +or direct libvirt interaction. + +The script offers three main configuration capabilities: +1. CPU Management: Adjust virtual CPU count +2. Memory Management: Modify memory allocation +3. PCI Passthrough: Configure PCI device passthrough for direct hardware access + +This script is designed to work with Security Onion's virtualization infrastructure and is typically +used during VM provisioning and hardware reconfiguration tasks. **Usage:** - python so-kvm-modify-hardware.py -v [-c ] [-m ] [-p ] [-p ...] [-s] + so-kvm-modify-hardware -v [-c ] [-m ] [-p ] [-p ...] [-s] **Options:** -v, --vm Name of the virtual machine to modify. @@ -20,35 +30,99 @@ Script to modify hardware parameters of a KVM virtual machine. **Examples:** -1. **Modify VM with Multiple PCI Devices:** +1. **Modify CPU and Memory with Multiple PCI Devices:** ```bash - python so-kvm-modify-hardware.py -v my_vm -c 4 -m 8192 -p 0000:00:1f.2 -p 0000:00:1f.3 -s + so-kvm-modify-hardware -v vm1_sensor -c 4 -m 8192 -p 0000:00:1f.2 -p 0000:00:1f.3 -s ``` - This command modifies the VM named `my_vm`, setting the CPU count to 4, memory to 8192 MiB, and adds two PCI devices for passthrough (`0000:00:1f.2` and `0000:00:1f.3`). The VM is then started after modification due to the `-s` flag. + This command modifies a VM with the following settings: + - VM Name: `vm1_sensor` + - Hardware Configuration: + - CPUs: `4` + - Memory: `8192` MiB + - PCI Device Passthrough: `0000:00:1f.2`, `0000:00:1f.3` + - The VM is started after modification due to the `-s` flag -2. **Modify VM with Single PCI Device:** +2. **Add PCI Device Without Other Changes:** ```bash - python so-kvm-modify-hardware.py -v my_vm -p 0000:00:1f.2 + so-kvm-modify-hardware -v vm2_master -p 0000:00:1f.4 ``` - This command adds a single PCI device passthrough to the VM named `my_vm`. + This command adds a single PCI device passthrough to the VM: + - VM Name: `vm2_master` + - PCI Device: `0000:00:1f.4` + - Existing CPU and memory settings are preserved -3. **Modify VM Without Starting It:** +3. **Update Resource Allocation:** ```bash - python so-kvm-modify-hardware.py -v my_vm -c 2 -m 4096 + so-kvm-modify-hardware -v vm3_search -c 2 -m 4096 ``` - This command sets the CPU count and memory for `my_vm` but does not start it afterward. + This command updates only compute resources: + - VM Name: `vm3_search` + - CPUs: `2` + - Memory: `4096` MiB + - VM remains stopped after modification + +4. **Add Multiple PCI Devices:** + + ```bash + so-kvm-modify-hardware -v vm4_node -p 0000:00:1f.2 -p 0000:00:1f.3 -p 0000:00:1f.4 -s + ``` + + This command adds multiple PCI devices and starts the VM: + - VM Name: `vm4_node` + - PCI Devices: `0000:00:1f.2`, `0000:00:1f.3`, `0000:00:1f.4` + - VM is started after modification **Notes:** -- The `-p` or `--pci` option can be specified multiple times to pass through multiple PCI devices to the VM. -- The PCI hardware IDs should be in the format `0000:00:1f.2`. -- If the `-s` or `--start` flag is not provided, the VM will remain stopped after modification. +- The script automatically stops the VM if it's running before making modifications. +- At least one modification option (-c, -m, or -p) should be provided. +- The PCI hardware IDs must be in the format `domain:bus:slot.function` (e.g., `0000:00:1f.2`). +- Multiple PCI devices can be added by using the `-p` option multiple times. +- Without the `-s` flag, the VM remains stopped after modification. +- Existing hardware configurations are preserved if not explicitly modified. + +**Description:** + +The `so-kvm-modify-hardware` script modifies hardware parameters of KVM virtual machines using the following process: + +1. **VM State Management:** + - Connects to the local libvirt daemon + - Stops the VM if it's currently running + - Retrieves current VM configuration + +2. **Hardware Configuration:** + - Modifies CPU count if specified + - Updates memory allocation if specified + - Adds PCI device passthrough configurations if specified + - All changes are made through libvirt XML configuration + +3. **VM Redefinition:** + - Applies the new configuration by redefining the VM + - Optionally starts the VM if requested + - Ensures clean shutdown and startup during modifications + +4. **Error Handling:** + - Validates all input parameters + - Ensures proper XML structure + - Provides detailed error messages for troubleshooting + +**Exit Codes:** + +- `0`: Success +- `1`: An error occurred during execution + +**Logging:** + +- Logs are written to `/opt/so/log/hypervisor/so-kvm-modify-hardware.log` +- Both file and console logging are enabled for real-time monitoring +- Log entries include timestamps and severity levels +- Detailed error messages are logged for troubleshooting """ diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin/so-qcow2-modify-network index c5aa1aa22..5c0a9e9b7 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -6,15 +6,112 @@ # Elastic License 2.0. """ -Script to modify the NetworkManager config within a QCOW2 image. +Script for modifying network configurations within QCOW2 virtual machine images. This script provides +functionality to update NetworkManager settings, supporting both DHCP and static IP configurations +without requiring the VM to be running. -Usage: - python so-qcow2-modify-network.py -I -i (--dhcp4 | --static4 --ip4 --gw4 ) [--dns4 ] [--search4 ] +The script offers two main configuration modes: +1. DHCP Configuration: Enable automatic IP address assignment +2. Static IP Configuration: Set specific IP address, gateway, DNS servers, and search domains -Examples: - python so-qcow2-modify-network.py -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,8.8.8.8 --search4 example.local +This script is designed to work with Security Onion's virtualization infrastructure and is typically +used during VM provisioning and network reconfiguration tasks. + +**Usage:** + so-qcow2-modify-network -I -i (--dhcp4 | --static4 --ip4 --gw4 ) + [--dns4 ] [--search4 ] + +**Options:** + -I, --image Path to the QCOW2 image. + -i, --interface Network interface to modify (e.g., eth0). + --dhcp4 Configure interface for DHCP (IPv4). + --static4 Configure interface for static IPv4 settings. + --ip4 IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration. + --gw4 IPv4 gateway (e.g., 192.168.1.1). Required for static IPv4 configuration. + --dns4 Comma-separated list of IPv4 DNS servers (e.g., 8.8.8.8,8.8.4.4). + --search4 DNS search domain for IPv4. + +**Examples:** + +1. **Static IP Configuration with DNS and Search Domain:** + + ```bash + so-qcow2-modify-network -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --static4 \ + --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,192.168.1.2 --search4 example.local + ``` + + This command configures the network settings in the QCOW2 image with: + - Static IPv4 configuration: + - IP Address: `192.168.1.10/24` + - Gateway: `192.168.1.1` + - DNS Servers: `192.168.1.1`, `192.168.1.2` + - DNS Search Domain: `example.local` + +2. **DHCP Configuration:** + + ```bash + so-qcow2-modify-network -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --dhcp4 + ``` + + This command configures the network interface to use DHCP for automatic IP address assignment. + +3. **Static IP Configuration without DNS Settings:** + + ```bash + so-qcow2-modify-network -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --static4 \ + --ip4 192.168.1.20/24 --gw4 192.168.1.1 + ``` + + This command sets only the basic static IP configuration: + - IP Address: `192.168.1.20/24` + - Gateway: `192.168.1.1` + +**Notes:** + +- When using `--static4`, both `--ip4` and `--gw4` options are required. +- The script validates IP addresses, DNS servers, and interface names before making any changes. +- DNS servers can be specified as a comma-separated list for multiple servers. +- The script requires write permissions for the QCOW2 image file. +- Interface names must contain only alphanumeric characters, underscores, and hyphens. + +**Description:** + +The `so-qcow2-modify-network` script modifies network configuration within a QCOW2 image using the following process: + +1. **Image Access:** + - Mounts the QCOW2 image using libguestfs + - Locates and accesses the NetworkManager configuration directory + +2. **Configuration Update:** + - Reads the existing network configuration for the specified interface + - Updates IPv4 settings based on provided parameters + - Supports both DHCP and static IP configurations + - Validates all input parameters before making changes + +3. **File Management:** + - Creates or updates the NetworkManager connection file + - Maintains proper file permissions and format + - Safely unmounts the image after changes + +**Exit Codes:** + +- `0`: Success +- Non-zero: An error occurred during execution + +**Logging:** + +- Logs are written to `/opt/so/log/hypervisor/so-qcow2-modify-network.log` +- Both file and console logging are enabled for real-time monitoring +- Log entries include: + - Timestamps in ISO 8601 format + - Severity levels (INFO, WARNING, ERROR) + - Detailed error messages for troubleshooting +- Critical operations logged: + - Network configuration changes + - Image mount/unmount operations + - Validation failures + - File access errors - python so-qcow2-modify-network.py -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --dhcp4 """ import argparse @@ -95,7 +192,6 @@ def update_ipv4_section(content, mode, ip=None, gateway=None, dns=None, search_d return updated_content -# modify the network config file for the interface inside the qcow2 image def modify_network_config(image_path, interface, mode, ip=None, gateway=None, dns=None, search_domain=None): if not os.access(image_path, os.W_OK): raise PermissionError(f"Write permission denied for image file: {image_path}") diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index 816f74a46..3edc1c385 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -6,13 +6,39 @@ # Elastic License 2.0. """ -Script to assist with salt-cloud VM provisioning. This is intended to work with a libvirt salt-cloud provider. +Script for automated virtual machine provisioning and configuration in Security Onion's virtualization infrastructure. +This script integrates multiple components to provide a streamlined VM deployment process: -**Usage:** - python so-salt-cloud -p (--dhcp4 | --static4 --ip4 --gw4 ) +1. Salt Cloud Integration: + - Works with libvirt salt-cloud provider for VM creation + - Manages VM lifecycle from provisioning through configuration + - Handles profile-based deployment for consistent VM setups + +2. Network Configuration Management: + - Supports both DHCP and static IPv4 networking + - Pre-configures network settings before VM deployment + - Integrates with qcow2.modify_network_config for image modification + - Ensures VMs boot with correct network configuration + +3. Hardware Resource Management: + - Flexible CPU and memory allocation + - Advanced PCI device passthrough capabilities + - Controlled VM startup sequence + - Uses qcow2.modify_hardware_config for hardware settings + +4. Security Integration: + - Automatic firewall rule configuration + - Integrates with so-firewall-minion for firewall setup on the manager + +This script serves as the primary interface for VM deployment in Security Onion, coordinating +between salt-cloud, network configuration, hardware management, and security components to +ensure proper VM provisioning and configuration. + +Usage: + so-salt-cloud -p (--dhcp4 | --static4 --ip4 --gw4 ) [-c ] [-m ] [-P ] [-P ...] [--dns4 ] [--search4 ] -**Options:** +Options: -p, --profile The cloud profile to build the VM from. The name of the VM. --dhcp4 Configure interface for DHCP (IPv4). @@ -25,98 +51,131 @@ Script to assist with salt-cloud VM provisioning. This is intended to work with -m, --memory Amount of memory to assign in MiB. -P, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:00:1f.2). Can be specified multiple times. -**Examples:** +Examples: -1. **Static IP Configuration with Multiple PCI Devices:** +1. Static IP Configuration with Multiple PCI Devices: - ```bash - python so-salt-cloud -p core-hype1 vm1_sensor --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 \ + Command: + so-salt-cloud -p sool9-hyper1 vm1_sensor --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 \ --dns4 192.168.1.1,192.168.1.2 --search4 example.local -c 4 -m 8192 -P 0000:00:1f.2 -P 0000:00:1f.3 - ``` - This command provisions a VM named `vm1_sensor` using the `core-hype1` profile with the following settings: + This command provisions a VM named vm1_sensor using the sool9-hyper1 profile with the following settings: - Static IPv4 configuration: - - IP Address: `192.168.1.10/24` - - Gateway: `192.168.1.1` - - DNS Servers: `192.168.1.1`, `192.168.1.2` - - DNS Search Domain: `example.local` + - IP Address: 192.168.1.10/24 + - Gateway: 192.168.1.1 + - DNS Servers: 192.168.1.1, 192.168.1.2 + - DNS Search Domain: example.local - Hardware Configuration: - - CPUs: `4` - - Memory: `8192` MiB - - PCI Device Passthrough: `0000:00:1f.2`, `0000:00:1f.3` + - CPUs: 4 + - Memory: 8192 MiB + - PCI Device Passthrough: 0000:00:1f.2, 0000:00:1f.3 -2. **DHCP Configuration with Default Hardware Settings:** +2. DHCP Configuration with Default Hardware Settings: - ```bash - python so-salt-cloud -p core-hype1 vm2_master --dhcp4 - ``` + Command: + so-salt-cloud -p sool9-hyper1 vm2_master --dhcp4 - This command provisions a VM named `vm2_master` using the `core-hype1` profile with DHCP for network configuration and default hardware settings. + This command provisions a VM named vm2_master using the sool9-hyper1 profile with DHCP for network configuration and default hardware settings. -3. **Static IP Configuration without Hardware Specifications:** +3. Static IP Configuration without Hardware Specifications: - ```bash - python so-salt-cloud -p core-hype1 vm3_search --static4 --ip4 192.168.1.20/24 --gw4 192.168.1.1 - ``` + Command: + so-salt-cloud -p sool9-hyper1 vm3_search --static4 --ip4 192.168.1.20/24 --gw4 192.168.1.1 - This command provisions a VM named `vm3_search` with a static IP configuration and default hardware settings. + This command provisions a VM named vm3_search with a static IP configuration and default hardware settings. -4. **DHCP Configuration with Custom Hardware Specifications and Multiple PCI Devices:** +4. DHCP Configuration with Custom Hardware Specifications and Multiple PCI Devices: - ```bash - python so-salt-cloud -p core-hype1 vm4_node --dhcp4 -c 8 -m 16384 -P 0000:00:1f.4 -P 0000:00:1f.5 - ``` + Command: + so-salt-cloud -p sool9-hyper1 vm4_node --dhcp4 -c 8 -m 16384 -P 0000:00:1f.4 -P 0000:00:1f.5 - This command provisions a VM named `vm4_node` using DHCP for network configuration and custom hardware settings: + This command provisions a VM named vm4_node using DHCP for network configuration and custom hardware settings: - - CPUs: `8` - - Memory: `16384` MiB - - PCI Device Passthrough: `0000:00:1f.4`, `0000:00:1f.5` + - CPUs: 8 + - Memory: 16384 MiB + - PCI Device Passthrough: 0000:00:1f.4, 0000:00:1f.5 -**Notes:** +5. Static IP Configuration with DNS and Search Domain: -- When using `--static4`, both `--ip4` and `--gw4` options are required. -- The script assumes the cloud profile name follows the format `basedomain-hypervisorname`. -- Hardware parameters (`-c`, `-m`, `-P`) are optional. If not provided, default values from the profile will be used. -- The `-P` or `--pci` option can be specified multiple times to pass through multiple PCI devices to the VM. -- The `vm_name` should include the role of the VM after an underscore (e.g., `hostname_role`), as the script uses this to determine the VM's role for firewall configuration. + Command: + so-salt-cloud -p sool9-hyper1 vm1_sensor --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1 --search4 example.local -**Description:** + This command provisions a VM named vm1_sensor using the sool9-hyper1 profile with static IPv4 configuration: -The `so-salt-cloud` script automates the provisioning of virtual machines using SaltStack's `salt-cloud` utility. It performs the following steps: + - Static IPv4 configuration: + - IP Address: 192.168.1.10/24 + - Gateway: 192.168.1.1 + - DNS Server: 192.168.1.1 + - DNS Search Domain: example.local -1. **Network Configuration:** +Notes: - - Modifies the network settings of the base QCOW2 image before provisioning. - - Supports both DHCP and static IPv4 configurations. - - Uses the `qcow2.modify_network_config` module via SaltStack to apply these settings on the target hypervisor. +- When using --static4, both --ip4 and --gw4 options are required. +- The script assumes the cloud profile name follows the format basedomain-hypervisorname. +- Hardware parameters (-c, -m, -P) are optional. If not provided, default values from the profile will be used. +- The -P or --pci option can be specified multiple times to pass through multiple PCI devices to the VM. +- The vm_name should include the role of the VM after an underscore (e.g., hostname_role), as the script uses this to determine the VM's role for firewall configuration. -2. **VM Provisioning:** +Description: - - Calls `salt-cloud` to provision the VM using the specified profile and VM name. - - The VM is provisioned but not started immediately to allow for hardware configuration. +The so-salt-cloud script automates the provisioning and configuration of virtual machines in Security Onion's infrastructure. It orchestrates multiple components to ensure proper VM setup and security configuration. The script executes in the following phases: -3. **Hardware Configuration:** +1. Network Configuration Phase: + - Pre-deployment network setup using qcow2.modify_network_config + - Supports both DHCP and static IPv4 configurations + - Modifies the base QCOW2 image directly to ensure network settings persist + - Handles DNS and search domain configuration for proper name resolution + - Validates network parameters before modification + - Ensures network settings are in place before VM creation - - Modifies the hardware settings of the newly defined VM. - - Supports specifying multiple PCI devices for passthrough. - - Uses the `qcow2.modify_hardware_config` module via SaltStack to adjust CPU count, memory allocation, and PCI device passthrough. - - Starts the VM after hardware modifications. +2. VM Provisioning Phase: + - Leverages salt-cloud for consistent VM deployment + - Uses predefined profiles for standardized configurations + - Manages the VM lifecycle through libvirt + - Prevents automatic VM start to allow hardware configuration + - Validates profile and VM name format + - Extracts role information from VM name for security configuration -4. **Firewall Configuration:** +3. Hardware Configuration Phase: + - Configures VM hardware through qcow2.modify_hardware_config + - Manages CPU allocation based on host capabilities + - Handles memory assignment in MiB units + - Supports multiple PCI device passthrough for advanced networking + - Validates hardware parameters against host resources + - Controls VM startup sequence after configuration - - Monitors the output of `salt-cloud` to extract the VM's IP address. - - Calls the `so-firewall-minion` script to apply firewall rules based on the VM's role. +4. Security Integration Phase: + - Monitors salt-cloud output for VM IP address assignment + - Extracts role information from VM name + - Launches so-firewall-minion in a separate thread for non-blocking operation + - Configures role-based firewall rules automatically + - Ensures security policies are in place before VM is accessible + - Logs all security-related operations for audit purposes -**Exit Codes:** +The script implements extensive error handling and logging throughout each phase: +- Validates all input parameters before execution +- Provides detailed error messages for troubleshooting +- Logs operations to both file and console +- Handles process interruption gracefully +- Ensures atomic operations where possible +- Maintains audit trail of all configuration changes -- `0`: Success +Integration points: +- Works with Security Onion's salt-cloud provider +- Interfaces with qcow2 module for image and hardware management +- Coordinates with so-firewall-minion for security configuration +- Uses libvirt for VM management +- Leverages SaltStack for distributed execution + +Exit Codes: + +- 0: Success - Non-zero: An error occurred during execution. -**Logging:** +Logging: -- Logs are written to `/opt/so/log/salt/so-salt-cloud.log`. +- Logs are written to /opt/so/log/salt/so-salt-cloud.log. - Both file and console logging are enabled for real-time monitoring. """ From ab97d3b8b7c91f9c13cfd2fa265741f840c3b76b Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 24 Jan 2025 11:26:34 -0500 Subject: [PATCH 096/303] ensure 64962 patch applies to manager for salt-cloud --- salt/salt/cloud/init.sls | 1 + 1 file changed, 1 insertion(+) diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index b0f9ca7fa..5ba8b96da 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -17,6 +17,7 @@ include: - libvirt.packages + - libvirt.64962 - libvirt.ssh.users install_salt_cloud: From b3969a6ce091e52512a40b30bad0f1c2a2d72dbe Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 24 Jan 2025 17:19:41 -0500 Subject: [PATCH 097/303] fix hardware passthrough for pci devices --- salt/_modules/qcow2.py | 21 +++++++++--- salt/hypervisor/defaults.brainstorm.yaml | 0 .../tools/sbin/so-kvm-modify-hardware | 33 ++++++++++++------- salt/manager/tools/sbin/so-salt-cloud | 19 ++++++----- 4 files changed, 48 insertions(+), 25 deletions(-) delete mode 100644 salt/hypervisor/defaults.brainstorm.yaml diff --git a/salt/_modules/qcow2.py b/salt/_modules/qcow2.py index 37858484e..d1de6756a 100644 --- a/salt/_modules/qcow2.py +++ b/salt/_modules/qcow2.py @@ -131,7 +131,7 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, def modify_hardware_config(vm_name, cpu=None, memory=None, pci=None, start=False): ''' Usage: - salt '*' qcow2.modify_hardware_config vm_name= [cpu=] [memory=] [pci=] [start=] + salt '*' qcow2.modify_hardware_config vm_name= [cpu=] [memory=] [pci=] [pci=] [start=] Options: vm_name @@ -143,7 +143,8 @@ def modify_hardware_config(vm_name, cpu=None, memory=None, pci=None, start=False Amount of memory to assign in MiB (positive integer) Optional - VM's current memory size retained if not specified pci - PCI hardware ID to passthrough to the VM (e.g., '0000:00:1f.2') + PCI hardware ID(s) to passthrough to the VM (e.g., '0000:c7:00.0') + Can be specified multiple times for multiple devices Optional - no PCI passthrough if not specified start Boolean flag to start the VM after modification @@ -158,13 +159,13 @@ def modify_hardware_config(vm_name, cpu=None, memory=None, pci=None, start=False 2. **Enable PCI Passthrough:** ```bash - salt '*' qcow2.modify_hardware_config vm_name='sensor1' pci='0000:00:1f.2' start=True + salt '*' qcow2.modify_hardware_config vm_name='sensor1' pci='0000:c7:00.0' pci='0000:c4:00.0' start=True ``` This configures PCI passthrough and starts the VM 3. **Complete Hardware Configuration:** ```bash - salt '*' qcow2.modify_hardware_config vm_name='sensor1' cpu=8 memory=16384 pci='0000:00:1f.2' start=True + salt '*' qcow2.modify_hardware_config vm_name='sensor1' cpu=8 memory=16384 pci='0000:c7:00.0' start=True ``` This sets CPU, memory, PCI passthrough, and starts the VM @@ -210,7 +211,17 @@ def modify_hardware_config(vm_name, cpu=None, memory=None, pci=None, start=False else: raise ValueError('memory must be a positive integer.') if pci: - cmd.extend(['-p', pci]) + # Handle PCI IDs (can be a single device or comma-separated list) + if isinstance(pci, str): + devices = [dev.strip() for dev in pci.split(',') if dev.strip()] + elif isinstance(pci, list): + devices = pci + else: + devices = [pci] + + # Add each device with its own -p flag + for device in devices: + cmd.extend(['-p', str(device)]) if start: cmd.append('-s') diff --git a/salt/hypervisor/defaults.brainstorm.yaml b/salt/hypervisor/defaults.brainstorm.yaml deleted file mode 100644 index e69de29bb..000000000 diff --git a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware index e2d64919a..a6becfb95 100644 --- a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware +++ b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware @@ -25,7 +25,8 @@ used during VM provisioning and hardware reconfiguration tasks. -v, --vm Name of the virtual machine to modify. -c, --cpu Number of virtual CPUs to assign. -m, --memory Amount of memory to assign in MiB. - -p, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:00:1f.2). Can be specified multiple times. + -p, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:c7:00.0). Can be specified multiple times. + Format: domain:bus:device.function -s, --start Start the VM after modification. **Examples:** @@ -33,7 +34,7 @@ used during VM provisioning and hardware reconfiguration tasks. 1. **Modify CPU and Memory with Multiple PCI Devices:** ```bash - so-kvm-modify-hardware -v vm1_sensor -c 4 -m 8192 -p 0000:00:1f.2 -p 0000:00:1f.3 -s + so-kvm-modify-hardware -v vm1_sensor -c 4 -m 8192 -p 0000:c7:00.0 -p 0000:c8:00.0 -s ``` This command modifies a VM with the following settings: @@ -41,18 +42,18 @@ used during VM provisioning and hardware reconfiguration tasks. - Hardware Configuration: - CPUs: `4` - Memory: `8192` MiB - - PCI Device Passthrough: `0000:00:1f.2`, `0000:00:1f.3` + - PCI Device Passthrough: `0000:c7:00.0`, `0000:c8:00.0` - The VM is started after modification due to the `-s` flag 2. **Add PCI Device Without Other Changes:** ```bash - so-kvm-modify-hardware -v vm2_master -p 0000:00:1f.4 + so-kvm-modify-hardware -v vm2_master -p 0000:c7:00.0 ``` This command adds a single PCI device passthrough to the VM: - VM Name: `vm2_master` - - PCI Device: `0000:00:1f.4` + - PCI Device: `0000:c7:00.0` - Existing CPU and memory settings are preserved 3. **Update Resource Allocation:** @@ -70,19 +71,19 @@ used during VM provisioning and hardware reconfiguration tasks. 4. **Add Multiple PCI Devices:** ```bash - so-kvm-modify-hardware -v vm4_node -p 0000:00:1f.2 -p 0000:00:1f.3 -p 0000:00:1f.4 -s + so-kvm-modify-hardware -v vm4_node -p 0000:c7:00.0 -p 0000:c4:00.0 -p 0000:c4:00.1 -s ``` This command adds multiple PCI devices and starts the VM: - VM Name: `vm4_node` - - PCI Devices: `0000:00:1f.2`, `0000:00:1f.3`, `0000:00:1f.4` + - PCI Devices: `0000:c7:00.0`, `0000:c4:00.0`, `0000:c4:00.1` - VM is started after modification **Notes:** - The script automatically stops the VM if it's running before making modifications. - At least one modification option (-c, -m, or -p) should be provided. -- The PCI hardware IDs must be in the format `domain:bus:slot.function` (e.g., `0000:00:1f.2`). +- The PCI hardware IDs must be in the format `domain:bus:device.function` (e.g., `0000:c7:00.0`). - Multiple PCI devices can be added by using the `-p` option multiple times. - Without the `-s` flag, the VM remains stopped after modification. - Existing hardware configurations are preserved if not explicitly modified. @@ -183,9 +184,19 @@ def modify_vm(dom, cpu_count, memory_amount, pci_ids, logger): 'managed': 'yes' }) source_elem = ET.SubElement(hostdev_elem, 'source') - domain_id, bus_slot_func = pci_id.split(':', 1) - bus_slot, function = bus_slot_func.split('.') - bus, slot = bus_slot[:2], bus_slot[2:] + # Split PCI ID into components (domain:bus:slot.function) + parts = pci_id.split(':') + if len(parts) != 3: + logger.error(f"Invalid PCI ID format: {pci_id}. Expected format: domain:bus:slot.function") + sys.exit(1) + domain_id = parts[0] + bus = parts[1] + slot_func = parts[2].split('.') + if len(slot_func) != 2: + logger.error(f"Invalid PCI ID format: {pci_id}. Expected format: domain:bus:slot.function") + sys.exit(1) + slot = slot_func[0] + function = slot_func[1] address_attrs = { 'domain': f'0x{domain_id}', 'bus': f'0x{bus}', diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index 3edc1c385..78473d96a 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -49,7 +49,8 @@ Options: --search4 DNS search domain for IPv4. -c, --cpu Number of virtual CPUs to assign. -m, --memory Amount of memory to assign in MiB. - -P, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:00:1f.2). Can be specified multiple times. + -P, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:c7:00.0). Can be specified multiple times. + Format: domain:bus:device.function Examples: @@ -57,7 +58,7 @@ Examples: Command: so-salt-cloud -p sool9-hyper1 vm1_sensor --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 \ - --dns4 192.168.1.1,192.168.1.2 --search4 example.local -c 4 -m 8192 -P 0000:00:1f.2 -P 0000:00:1f.3 + --dns4 192.168.1.1,192.168.1.2 --search4 example.local -c 4 -m 8192 -P 0000:c7:00.0 -P 0000:c4:00.0 This command provisions a VM named vm1_sensor using the sool9-hyper1 profile with the following settings: @@ -69,7 +70,7 @@ Examples: - Hardware Configuration: - CPUs: 4 - Memory: 8192 MiB - - PCI Device Passthrough: 0000:00:1f.2, 0000:00:1f.3 + - PCI Device Passthrough: 0000:c7:00.0, 0000:c4:00.0 2. DHCP Configuration with Default Hardware Settings: @@ -88,13 +89,13 @@ Examples: 4. DHCP Configuration with Custom Hardware Specifications and Multiple PCI Devices: Command: - so-salt-cloud -p sool9-hyper1 vm4_node --dhcp4 -c 8 -m 16384 -P 0000:00:1f.4 -P 0000:00:1f.5 + so-salt-cloud -p sool9-hyper1 vm4_node --dhcp4 -c 8 -m 16384 -P 0000:c7:00.0 -P 0000:c4:00.0 -P 0000:c4:00.1 This command provisions a VM named vm4_node using DHCP for network configuration and custom hardware settings: - CPUs: 8 - Memory: 16384 MiB - - PCI Device Passthrough: 0000:00:1f.4, 0000:00:1f.5 + - PCI Device Passthrough: 0000:c7:00.0, 0000:c4:00.0, 0000:c4:00.1 5. Static IP Configuration with DNS and Search Domain: @@ -116,6 +117,7 @@ Notes: - Hardware parameters (-c, -m, -P) are optional. If not provided, default values from the profile will be used. - The -P or --pci option can be specified multiple times to pass through multiple PCI devices to the VM. - The vm_name should include the role of the VM after an underscore (e.g., hostname_role), as the script uses this to determine the VM's role for firewall configuration. +- PCI hardware IDs must be in the format domain:bus:device.function (e.g., 0000:c7:00.0). Description: @@ -283,9 +285,8 @@ def run_qcow2_modify_hardware_config(profile, vm_name, cpu=None, memory=None, pc # Add PCI devices if provided if pci_list: - # Join the list of PCI IDs into a comma-separated string - pci_devices = ','.join(pci_list) - args_list.append('pci=' + pci_devices) + # Pass all PCI devices as a comma-separated list + args_list.append('pci=' + ','.join(pci_list)) r = local.cmd(target, 'qcow2.modify_hardware_config', args_list) logger.info(f'qcow2.modify_hardware_config: {r}') @@ -327,7 +328,7 @@ def parse_arguments(): parser.add_argument("--search4", help="DNS search domain for IPv4.") parser.add_argument('-c', '--cpu', type=int, help='Number of virtual CPUs to assign.') parser.add_argument('-m', '--memory', type=int, help='Amount of memory to assign in MiB.') - parser.add_argument('-P', '--pci', action='append', help='PCI hardware ID(s) to passthrough to the VM (e.g., 0000:00:1f.2). Can be specified multiple times.') + parser.add_argument('-P', '--pci', action='append', help='PCI hardware ID(s) to passthrough to the VM (e.g., 0000:c7:00.0). Can be specified multiple times.') args = parser.parse_args() From 0177f641c8d3222bafdfd0af0c2ae2c665d9786c Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 27 Jan 2025 15:09:42 -0500 Subject: [PATCH 098/303] watch for files and create a vm --- .../engines/master/virtual_node_manager.py | 507 ++++++++++++++++++ 1 file changed, 507 insertions(+) create mode 100644 salt/salt/engines/master/virtual_node_manager.py diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py new file mode 100644 index 000000000..a47c68f32 --- /dev/null +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -0,0 +1,507 @@ +#!/opt/saltstack/salt/bin/python3 + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +""" +Salt Engine for Virtual Node Management + +This engine manages the automated provisioning of virtual machines in Security Onion's +virtualization infrastructure. It monitors directories for VM creation requests and +handles the entire provisioning process including hardware allocation. + +Usage: + engines: + - virtual_node_manager: + interval: 30 + base_path: /opt/so/saltstack/local/salt/hypervisor/hosts + +Options: + interval: Time in seconds between directory scans (default: 30) + base_path: Base directory to monitor for VM requests (default: /opt/so/saltstack/local/salt/hypervisor/hosts) + + Memory values in VM configuration YAML files should be specified in GB. These values + will automatically be converted to MiB when passed to so-salt-cloud. + +Examples: + 1. Basic Configuration: + engines: + - virtual_node_manager: {} + + Uses default settings to monitor for VM requests. + + 2. Custom Scan Interval: + engines: + - virtual_node_manager: + interval: 60 + + Scans for new requests every 60 seconds. + +Notes: + - Requires 'hvn' feature license + - Monitors for files named: add_sensor, add_searchnode, add_idh, add_receiver, add_heavynode, add_fleet + - Hardware allocation is tracked in hypervisor YAML files + - Creates VM-specific hardware tracking files + +Description: + The engine operates in the following phases: + + 1. License Validation + - Verifies 'hvn' feature is licensed + - Prevents operation if license is invalid + + 2. File Monitoring + - Scans configured directory for add_* files + - Parses VM configuration from YAML + - Validates configuration parameters + + 3. Hardware Allocation + - Reads hypervisor hardware inventory + - Claims requested PCI devices + - Updates hardware tracking + - Creates VM hardware record + + 4. VM Provisioning + - Executes so-salt-cloud with configuration + - Handles network setup + - Configures hardware passthrough + - Manages VM startup + +Exit Codes: + 0: Success + 1: Invalid license + 2: Configuration error + 3: Hardware allocation failure + 4: VM provisioning failure + +Logging: + Log files are written to /opt/so/log/salt/engines/virtual_node_manager.log + Critical operations, errors, and hardware allocation events are logged +""" + +import os +import glob +import yaml +import time +import logging +import subprocess +from typing import Dict, List, Optional, Tuple + +# Configure logging +log = logging.getLogger(__name__) +log.setLevel(logging.DEBUG) + +# Constants +DEFAULT_INTERVAL = 30 +DEFAULT_BASE_PATH = '/opt/so/saltstack/local/salt/hypervisor/hosts' +VALID_ROLES = ['sensor', 'searchnode', 'idh', 'receiver', 'heavynode', 'fleet'] +MAX_RETRIES = 3 +RETRY_DELAY = 5 +LICENSE_PATH = '/opt/so/saltstack/local/pillar/soc/license.sls' + +def ensure_claimed_section(hw_config: dict) -> dict: + """ + Ensure the claimed section exists and is a dict. + + Args: + hw_config: Hardware configuration section containing 'claimed' key + + Returns: + The claimed section as a dict + """ + if hw_config['claimed'] is None or not isinstance(hw_config['claimed'], dict): + hw_config['claimed'] = {} + return hw_config['claimed'] + +def convert_pci_id(pci_id: str) -> str: + """ + Convert PCI ID from pci_0000_c7_00_0 format to 0000:c7:00.0 format. + + Args: + pci_id: PCI ID in underscore format (e.g., pci_0000_c7_00_0) + + Returns: + PCI ID in domain:bus:slot.function format (e.g., 0000:c7:00.0) + + Example: + >>> convert_pci_id('pci_0000_c7_00_0') + '0000:c7:00.0' + """ + # Remove 'pci_' prefix + pci_id = pci_id.replace('pci_', '') + + # Split into components + parts = pci_id.split('_') + if len(parts) != 4: + raise ValueError(f"Invalid PCI ID format: {pci_id}. Expected format: pci_domain_bus_slot_function") + + # Reconstruct with proper format (using period for function) + domain, bus, slot, function = parts + return f"{domain}:{bus}:{slot}.{function}" + +class HardwareManager: + """ + Manages hardware allocation and tracking for virtual machines. + Handles reading hypervisor configuration, claiming PCI devices, + and maintaining hardware tracking files. + """ + + def __init__(self, hypervisor: str, base_path: str): + """Initialize the hardware manager for a specific hypervisor.""" + self.hypervisor = hypervisor + self.base_path = base_path + self.hypervisor_file = os.path.join(base_path, hypervisor, f"{hypervisor}.yaml") + + def read_hypervisor_config(self) -> dict: + """ + Read and initialize the hypervisor's hardware configuration file. + Ensures all hardware sections have a valid claimed section. + """ + try: + with open(self.hypervisor_file, 'r') as f: + config = yaml.safe_load(f) + + # Initialize any null claimed sections + modified = False + for hw_type in ['disk', 'copper', 'sfp']: + hw_config = config['hypervisor']['hardware'][hw_type] + if hw_config['claimed'] is None: + log.debug("Initializing null claimed section for %s", hw_type) + hw_config['claimed'] = {} + modified = True + + # Save if we made any changes + if modified: + log.info("Updating hypervisor config with initialized claimed sections") + self.write_hypervisor_config(config) + + return config + except Exception as e: + log.error("Failed to read hypervisor configuration: %s", str(e)) + raise + + def write_hypervisor_config(self, config: dict) -> None: + """Write updated configuration back to the hypervisor file.""" + try: + with open(self.hypervisor_file, 'w') as f: + yaml.dump(config, f, default_flow_style=False) + except Exception as e: + log.error("Failed to write hypervisor configuration: %s", str(e)) + raise + + def get_pci_ids(self, hw_type: str, indices: List[int]) -> List[str]: + """ + Look up PCI IDs for requested hardware indices. + + Args: + hw_type: Type of hardware (disk, copper, sfp) + indices: List of hardware indices to look up + + Returns: + List of PCI IDs + """ + config = self.read_hypervisor_config() + log.debug("Full config structure: %s", config) + log.debug("Looking up indices %s for hardware type %s", indices, hw_type) + pci_ids = [] + + try: + hardware_section = config['hypervisor']['hardware'] + log.debug("Hardware section: %s", hardware_section) + if hw_type not in hardware_section: + raise ValueError(f"Hardware type {hw_type} not found in configuration") + + hw_config = hardware_section[hw_type] + free_hw = hw_config['free'] + claimed_hw = ensure_claimed_section(hw_config) + + log.debug("Free hardware section for %s: %s", hw_type, free_hw) + log.debug("Claimed hardware section for %s: %s", hw_type, claimed_hw) + + for idx in indices: + if idx in free_hw: + pci_id = convert_pci_id(free_hw[idx]) + log.debug("Converting PCI ID from %s to %s", free_hw[idx], pci_id) + pci_ids.append(pci_id) + elif idx in claimed_hw: + raise ValueError(f"Hardware index {idx} for {hw_type} is already claimed") + else: + raise ValueError(f"Hardware index {idx} for {hw_type} does not exist") + except KeyError as e: + log.error("Invalid hardware configuration structure: %s", str(e)) + raise + + return pci_ids + + def claim_hardware(self, hw_type: str, indices: List[int]) -> None: + """ + Move hardware from free to claimed in the hypervisor configuration. + + Args: + hw_type: Type of hardware (disk, copper, sfp) + indices: List of hardware indices to claim + """ + config = self.read_hypervisor_config() + + try: + hw_config = config['hypervisor']['hardware'][hw_type] + ensure_claimed_section(hw_config) + + for idx in indices: + if idx in hw_config['free']: + pci_id = hw_config['free'][idx] + hw_config['claimed'][idx] = pci_id + del hw_config['free'][idx] + else: + raise ValueError(f"{hw_type} hardware index {idx} not available") + + self.write_hypervisor_config(config) + log.info("Successfully claimed %s hardware indices: %s", hw_type, indices) + except Exception as e: + log.error("Failed to claim hardware: %s", str(e)) + raise + + def create_vm_hardware_file(self, hostname: str, role: str, hardware: dict) -> None: + """ + Create a YAML file tracking hardware allocated to a VM. + + Args: + hostname: Name of the VM + role: VM role (sensor, searchnode, etc.) + hardware: Dictionary of allocated hardware + """ + vm_file = os.path.join(self.base_path, self.hypervisor, f"{hostname}_{role}.yaml") + try: + with open(vm_file, 'w') as f: + yaml.dump({'hardware': hardware}, f, default_flow_style=False) + log.info("Created hardware tracking file for %s_%s", hostname, role) + except Exception as e: + log.error("Failed to create VM hardware file: %s", str(e)) + raise + +def validate_hvn_license() -> bool: + """Check if the license file exists and contains required values.""" + if not os.path.exists(LICENSE_PATH): + log.error("LICENSE: License file not found at %s", LICENSE_PATH) + return False + + try: + with open(LICENSE_PATH, 'r') as f: + license_data = yaml.safe_load(f) + + if not license_data: + log.error("LICENSE: Empty or invalid license file") + return False + + license_id = license_data.get('license_id') + features = license_data.get('features', []) + + if not license_id: + log.error("LICENSE: No license_id found in license file") + return False + + if 'hvn' not in features: + log.error("Hypervisor nodes are a feature supported only for customers with a valid license.\n" + "Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n" + "for more information about purchasing a license to enable this feature.") + return False + + log.info("LICENSE: License validation successful") + return True + + except Exception as e: + log.error("LICENSE: Error reading license file: %s", str(e)) + return False + +def parse_add_file(file_path: str) -> Tuple[str, str, dict]: + """ + Parse an add_* file to extract VM configuration. + + Returns: + Tuple of (hypervisor, role, config) + """ + try: + # Extract hypervisor and role from path + path_parts = file_path.split(os.path.sep) + hypervisor = path_parts[-2] + role = path_parts[-1].replace('add_', '') + + if role not in VALID_ROLES: + raise ValueError(f"Invalid role: {role}") + + # Read and parse YAML configuration + with open(file_path, 'r') as f: + config = yaml.safe_load(f) + + required_fields = ['hostname', 'network_mode'] + if config.get('network_mode') == 'static4': + required_fields.extend(['ip4', 'gw4']) + + for field in required_fields: + if field not in config: + raise ValueError(f"Missing required field: {field}") + + return hypervisor, role, config + except Exception as e: + log.error("Failed to parse add file %s: %s", file_path, str(e)) + raise + +def convert_gb_to_mib(gb: int) -> int: + """ + Convert memory value from GB to MiB. + + Args: + gb: Memory value in gigabytes + + Returns: + Memory value in mebibytes (1 GB = 1024 MiB) + """ + return gb * 1024 + +def execute_salt_cloud(profile: str, hostname: str, role: str, config: dict, pci_ids: List[str]) -> None: + """ + Execute so-salt-cloud to create the VM. + + Args: + profile: Salt cloud profile name + hostname: VM hostname + role: VM role + config: VM configuration + pci_ids: List of PCI IDs for hardware passthrough + """ + try: + cmd = ['so-salt-cloud', '-p', f'sool9-{profile}', f'{hostname}_{role}'] + + # Add network configuration + if config['network_mode'] == 'static4': + cmd.extend(['--static4', '--ip4', config['ip4'], '--gw4', config['gw4']]) + if 'dns4' in config: + cmd.extend(['--dns4', ','.join(config['dns4'])]) + if 'search4' in config: + cmd.extend(['--search4', config['search4']]) + else: + cmd.append('--dhcp4') + + # Add hardware configuration + if 'cpu' in config: + cmd.extend(['-c', str(config['cpu'])]) + if 'memory' in config: + # Convert memory from GB to MiB for so-salt-cloud + memory_mib = convert_gb_to_mib(config['memory']) + cmd.extend(['-m', str(memory_mib)]) + + # Add PCI devices + for pci_id in pci_ids: + cmd.extend(['-P', pci_id]) + + log.info("Executing: %s", ' '.join(cmd)) + subprocess.run(cmd, check=True) + except subprocess.CalledProcessError as e: + log.error("so-salt-cloud execution failed: %s", str(e)) + raise + except Exception as e: + log.error("Failed to execute so-salt-cloud: %s", str(e)) + raise + +def process_add_file(file_path: str, base_path: str) -> None: + """ + Process a single add_* file for VM creation. + + Args: + file_path: Path to the add_* file + base_path: Base path for hypervisor configuration + """ + try: + hypervisor, role, config = parse_add_file(file_path) + log.debug("Parsed config from add file: %s", config) + hw_manager = HardwareManager(hypervisor, base_path) + + # Collect all PCI IDs + pci_ids = [] + hardware_tracking = { + 'cpu': config.get('cpu'), + 'memory': config.get('memory') + } + + # Process each hardware type + for hw_type in ['disk', 'copper', 'sfp']: + if hw_type in config: + indices = config[hw_type] + hw_pci_ids = hw_manager.get_pci_ids(hw_type, indices) + pci_ids.extend(hw_pci_ids) + + # Track hardware allocation + hardware_tracking[hw_type] = [ + {'id': idx, 'pci': pci_id} + for idx, pci_id in zip(indices, hw_pci_ids) + ] + + # Claim the hardware + hw_manager.claim_hardware(hw_type, indices) + + # Create VM + execute_salt_cloud(hypervisor, config['hostname'], role, config, pci_ids) + + # Create hardware tracking file + hw_manager.create_vm_hardware_file(config['hostname'], role, hardware_tracking) + + # Clean up the add_* file + os.remove(file_path) + log.info("Successfully processed VM creation request: %s_%s", config['hostname'], role) + + except Exception as e: + log.error("Failed to process add file %s: %s", file_path, str(e)) + raise + +def monitor_add_files(base_path: str) -> None: + """ + Monitor directories for add_* files and process them. + + Args: + base_path: Base path to monitor for add_* files + """ + pattern = os.path.join(base_path, '*', 'add_*') + + try: + for file_path in glob.glob(pattern): + log.info("Found new VM request file: %s", file_path) + + for attempt in range(MAX_RETRIES): + try: + process_add_file(file_path, base_path) + break + except Exception as e: + if attempt < MAX_RETRIES - 1: + log.warning("Attempt %d failed, retrying in %d seconds: %s", + attempt + 1, RETRY_DELAY, str(e)) + time.sleep(RETRY_DELAY) + else: + log.error("All attempts failed for file %s", file_path) + raise + except Exception as e: + log.error("Error monitoring add files: %s", str(e)) + raise + +def start(interval: int = DEFAULT_INTERVAL, + base_path: str = DEFAULT_BASE_PATH) -> None: + """ + Main engine loop. + + Args: + interval: Time in seconds between directory scans + base_path: Base path to monitor for VM requests + """ + log.info("Starting virtual node manager engine") + + if not validate_hvn_license(): + return + + while True: + try: + monitor_add_files(base_path) + except Exception as e: + log.error("Error in main engine loop: %s", str(e)) + + time.sleep(interval) From 2cd0f6906904acdec429c57451765964bbcde851 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 27 Jan 2025 16:40:10 -0500 Subject: [PATCH 099/303] watch and build --- .../engines/master/virtual_node_manager.py | 136 ++++++++++++------ 1 file changed, 94 insertions(+), 42 deletions(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index a47c68f32..ed3d10d5a 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -97,8 +97,6 @@ log.setLevel(logging.DEBUG) DEFAULT_INTERVAL = 30 DEFAULT_BASE_PATH = '/opt/so/saltstack/local/salt/hypervisor/hosts' VALID_ROLES = ['sensor', 'searchnode', 'idh', 'receiver', 'heavynode', 'fleet'] -MAX_RETRIES = 3 -RETRY_DELAY = 5 LICENSE_PATH = '/opt/so/saltstack/local/pillar/soc/license.sls' def ensure_claimed_section(hw_config: dict) -> dict: @@ -191,17 +189,21 @@ class HardwareManager: log.error("Failed to write hypervisor configuration: %s", str(e)) raise - def get_pci_ids(self, hw_type: str, indices: List[int]) -> List[str]: + def get_pci_ids(self, hw_type: str, indices: Optional[List[int]]) -> List[str]: """ Look up PCI IDs for requested hardware indices. Args: hw_type: Type of hardware (disk, copper, sfp) - indices: List of hardware indices to look up + indices: List of hardware indices to look up, or None if no hardware requested Returns: List of PCI IDs """ + # Skip if no indices provided + if indices is None: + return [] + config = self.read_hypervisor_config() log.debug("Full config structure: %s", config) log.debug("Looking up indices %s for hardware type %s", indices, hw_type) @@ -342,6 +344,12 @@ def parse_add_file(file_path: str) -> Tuple[str, str, dict]: for field in required_fields: if field not in config: raise ValueError(f"Missing required field: {field}") + + # Validate hardware sections + for hw_type in ['disk', 'copper', 'sfp']: + if hw_type in config and config[hw_type] is not None: + if not isinstance(config[hw_type], list): + raise ValueError(f"{hw_type} must be a list when present") return hypervisor, role, config except Exception as e: @@ -405,6 +413,27 @@ def execute_salt_cloud(profile: str, hostname: str, role: str, config: dict, pci log.error("Failed to execute so-salt-cloud: %s", str(e)) raise +def release_hardware(hw_manager: HardwareManager, hw_type: str, indices: List[int]) -> None: + """ + Release claimed hardware back to free pool. + + Args: + hw_manager: HardwareManager instance + hw_type: Type of hardware (disk, copper, sfp) + indices: List of hardware indices to release + """ + config = hw_manager.read_hypervisor_config() + hw_config = config['hypervisor']['hardware'][hw_type] + + for idx in indices: + if idx in hw_config['claimed']: + pci_id = hw_config['claimed'][idx] + hw_config['free'][idx] = pci_id + del hw_config['claimed'][idx] + + hw_manager.write_hypervisor_config(config) + log.info("Released %s hardware indices: %s", hw_type, indices) + def process_add_file(file_path: str, base_path: str) -> None: """ Process a single add_* file for VM creation. @@ -418,39 +447,62 @@ def process_add_file(file_path: str, base_path: str) -> None: log.debug("Parsed config from add file: %s", config) hw_manager = HardwareManager(hypervisor, base_path) - # Collect all PCI IDs + # Phase 1: Collect all hardware information without claiming pci_ids = [] + hardware_to_claim = {} # Store hardware to claim for each type hardware_tracking = { 'cpu': config.get('cpu'), 'memory': config.get('memory') } - # Process each hardware type + # Validate all hardware first for hw_type in ['disk', 'copper', 'sfp']: - if hw_type in config: - indices = config[hw_type] + indices = config.get(hw_type) + if indices is not None: + # Validate indices are available before claiming hw_pci_ids = hw_manager.get_pci_ids(hw_type, indices) - pci_ids.extend(hw_pci_ids) - - # Track hardware allocation - hardware_tracking[hw_type] = [ - {'id': idx, 'pci': pci_id} - for idx, pci_id in zip(indices, hw_pci_ids) - ] - - # Claim the hardware + if hw_pci_ids: + hardware_to_claim[hw_type] = indices + pci_ids.extend(hw_pci_ids) + hardware_tracking[hw_type] = [ + {'id': idx, 'pci': pci_id} + for idx, pci_id in zip(indices, hw_pci_ids) + ] + + # Phase 2: Claim hardware only after all validation passes + try: + # Claim all hardware + for hw_type, indices in hardware_to_claim.items(): hw_manager.claim_hardware(hw_type, indices) - - # Create VM - execute_salt_cloud(hypervisor, config['hostname'], role, config, pci_ids) - - # Create hardware tracking file - hw_manager.create_vm_hardware_file(config['hostname'], role, hardware_tracking) - - # Clean up the add_* file - os.remove(file_path) - log.info("Successfully processed VM creation request: %s_%s", config['hostname'], role) - + + # Create VM + execute_salt_cloud(hypervisor, config['hostname'], role, config, pci_ids) + + # Create hardware tracking file + hw_manager.create_vm_hardware_file(config['hostname'], role, hardware_tracking) + + log.info("Successfully processed VM creation request: %s_%s", + config['hostname'], role) + + except Exception as e: + # If anything fails after claiming, release claimed hardware + log.error("Failed after hardware claim, attempting to release hardware: %s", str(e)) + for hw_type, indices in hardware_to_claim.items(): + try: + release_hardware(hw_manager, hw_type, indices) + except Exception as release_error: + log.error("Failed to release %s hardware %s: %s", + hw_type, indices, str(release_error)) + raise + + finally: + # Always clean up the add file + try: + os.remove(file_path) + log.info("Cleaned up add file: %s", file_path) + except Exception as e: + log.error("Failed to clean up add file: %s", str(e)) + except Exception as e: log.error("Failed to process add file %s: %s", file_path, str(e)) raise @@ -467,19 +519,10 @@ def monitor_add_files(base_path: str) -> None: try: for file_path in glob.glob(pattern): log.info("Found new VM request file: %s", file_path) - - for attempt in range(MAX_RETRIES): - try: - process_add_file(file_path, base_path) - break - except Exception as e: - if attempt < MAX_RETRIES - 1: - log.warning("Attempt %d failed, retrying in %d seconds: %s", - attempt + 1, RETRY_DELAY, str(e)) - time.sleep(RETRY_DELAY) - else: - log.error("All attempts failed for file %s", file_path) - raise + try: + process_add_file(file_path, base_path) + except Exception as e: + log.error("Failed to process file %s: %s", file_path, str(e)) except Exception as e: log.error("Error monitoring add files: %s", str(e)) raise @@ -498,9 +541,18 @@ def start(interval: int = DEFAULT_INTERVAL, if not validate_hvn_license(): return + processed_files = set() while True: try: - monitor_add_files(base_path) + for file_path in glob.glob(os.path.join(base_path, '*', 'add_*')): + if file_path not in processed_files: + try: + process_add_file(file_path, base_path) + processed_files.add(file_path) + except Exception as e: + log.error("Failed to process file %s: %s", file_path, str(e)) + # Still mark as processed to avoid retrying + processed_files.add(file_path) except Exception as e: log.error("Error in main engine loop: %s", str(e)) From b66aafd168fd1cbbb02997b6c928051d874c3ea5 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 27 Jan 2025 17:24:04 -0500 Subject: [PATCH 100/303] fix claiming for cpu/mem --- .../engines/master/virtual_node_manager.py | 79 ++++++++++++++++++- 1 file changed, 76 insertions(+), 3 deletions(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index ed3d10d5a..00753abc3 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -237,6 +237,63 @@ class HardwareManager: return pci_ids + def claim_cpu_memory(self, cpu_count: Optional[int], memory_gb: Optional[int]) -> None: + """ + Claim CPU cores and memory from the free pool. + + Args: + cpu_count: Number of CPU cores to claim, or None if no CPU requested + memory_gb: Amount of memory in GB to claim, or None if no memory requested + + Raises: + ValueError: If requested resources exceed available resources + """ + if cpu_count is None and memory_gb is None: + return + + config = self.read_hypervisor_config() + hw_config = config['hypervisor']['hardware'] + + # Validate and claim CPU cores + if cpu_count is not None: + if cpu_count > hw_config['cpu']['free']: + raise ValueError(f"Not enough CPU cores available. Requested: {cpu_count}, Free: {hw_config['cpu']['free']}") + hw_config['cpu']['free'] -= cpu_count + + # Validate and claim memory + if memory_gb is not None: + if memory_gb > hw_config['memory']['free']: + raise ValueError(f"Not enough memory available. Requested: {memory_gb}GB, Free: {hw_config['memory']['free']}GB") + hw_config['memory']['free'] -= memory_gb + + self.write_hypervisor_config(config) + log.info("Successfully claimed CPU cores: %s, Memory: %sGB", cpu_count, memory_gb) + + def release_cpu_memory(self, cpu_count: Optional[int], memory_gb: Optional[int]) -> None: + """ + Release CPU cores and memory back to the free pool. + + Args: + cpu_count: Number of CPU cores to release, or None if no CPU to release + memory_gb: Amount of memory in GB to release, or None if no memory to release + """ + if cpu_count is None and memory_gb is None: + return + + config = self.read_hypervisor_config() + hw_config = config['hypervisor']['hardware'] + + # Return CPU cores to free pool + if cpu_count is not None: + hw_config['cpu']['free'] += cpu_count + + # Return memory to free pool + if memory_gb is not None: + hw_config['memory']['free'] += memory_gb + + self.write_hypervisor_config(config) + log.info("Successfully released CPU cores: %s, Memory: %sGB", cpu_count, memory_gb) + def claim_hardware(self, hw_type: str, indices: List[int]) -> None: """ Move hardware from free to claimed in the hypervisor configuration. @@ -413,7 +470,8 @@ def execute_salt_cloud(profile: str, hostname: str, role: str, config: dict, pci log.error("Failed to execute so-salt-cloud: %s", str(e)) raise -def release_hardware(hw_manager: HardwareManager, hw_type: str, indices: List[int]) -> None: +def release_hardware(hw_manager: HardwareManager, hw_type: str, indices: List[int], + cpu_count: Optional[int] = None, memory_gb: Optional[int] = None) -> None: """ Release claimed hardware back to free pool. @@ -421,6 +479,8 @@ def release_hardware(hw_manager: HardwareManager, hw_type: str, indices: List[in hw_manager: HardwareManager instance hw_type: Type of hardware (disk, copper, sfp) indices: List of hardware indices to release + cpu_count: Number of CPU cores to release, or None if no CPU to release + memory_gb: Amount of memory in GB to release, or None if no memory to release """ config = hw_manager.read_hypervisor_config() hw_config = config['hypervisor']['hardware'][hw_type] @@ -471,7 +531,12 @@ def process_add_file(file_path: str, base_path: str) -> None: # Phase 2: Claim hardware only after all validation passes try: - # Claim all hardware + # Claim CPU and memory first + cpu_count = config.get('cpu') + memory_gb = config.get('memory') + hw_manager.claim_cpu_memory(cpu_count, memory_gb) + + # Then claim PCI hardware for hw_type, indices in hardware_to_claim.items(): hw_manager.claim_hardware(hw_type, indices) @@ -485,8 +550,16 @@ def process_add_file(file_path: str, base_path: str) -> None: config['hostname'], role) except Exception as e: - # If anything fails after claiming, release claimed hardware + # If anything fails after claiming, release all hardware log.error("Failed after hardware claim, attempting to release hardware: %s", str(e)) + + # Release CPU and memory + try: + hw_manager.release_cpu_memory(cpu_count, memory_gb) + except Exception as release_error: + log.error("Failed to release CPU/memory: %s", str(release_error)) + + # Release PCI hardware for hw_type, indices in hardware_to_claim.items(): try: release_hardware(hw_manager, hw_type, indices) From e32dbad0d0ac982c9d5e326ab5a38f45b26cbeba Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 28 Jan 2025 11:22:26 -0500 Subject: [PATCH 101/303] fix monitoring for add_ files --- .../engines/master/virtual_node_manager.py | 41 +++++++------------ 1 file changed, 14 insertions(+), 27 deletions(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index 00753abc3..f935b2075 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -580,26 +580,6 @@ def process_add_file(file_path: str, base_path: str) -> None: log.error("Failed to process add file %s: %s", file_path, str(e)) raise -def monitor_add_files(base_path: str) -> None: - """ - Monitor directories for add_* files and process them. - - Args: - base_path: Base path to monitor for add_* files - """ - pattern = os.path.join(base_path, '*', 'add_*') - - try: - for file_path in glob.glob(pattern): - log.info("Found new VM request file: %s", file_path) - try: - process_add_file(file_path, base_path) - except Exception as e: - log.error("Failed to process file %s: %s", file_path, str(e)) - except Exception as e: - log.error("Error monitoring add files: %s", str(e)) - raise - def start(interval: int = DEFAULT_INTERVAL, base_path: str = DEFAULT_BASE_PATH) -> None: """ @@ -614,19 +594,26 @@ def start(interval: int = DEFAULT_INTERVAL, if not validate_hvn_license(): return - processed_files = set() while True: try: - for file_path in glob.glob(os.path.join(base_path, '*', 'add_*')): - if file_path not in processed_files: + pattern = os.path.join(base_path, '*', 'add_*') + log.debug("Scanning for VM request files with pattern: %s", pattern) + + try: + files = glob.glob(pattern) + if files: + log.debug("Found %d VM request file(s): %s", len(files), files) + + for file_path in files: + log.info("Processing VM request file: %s", file_path) try: process_add_file(file_path, base_path) - processed_files.add(file_path) except Exception as e: log.error("Failed to process file %s: %s", file_path, str(e)) - # Still mark as processed to avoid retrying - processed_files.add(file_path) + except Exception as e: + log.error("Error scanning for VM request files: %s", str(e)) + except Exception as e: log.error("Error in main engine loop: %s", str(e)) - + time.sleep(interval) From 91fc59cffca64a4362b9db51ccd50b1bc1206fe1 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 28 Jan 2025 14:04:02 -0500 Subject: [PATCH 102/303] add removehost option to so-firewall. add logging to console and so-firewall.log --- salt/manager/tools/sbin/so-firewall | 98 ++++++++++++++++++++++------- 1 file changed, 76 insertions(+), 22 deletions(-) diff --git a/salt/manager/tools/sbin/so-firewall b/salt/manager/tools/sbin/so-firewall index 742427518..f1746ba8d 100755 --- a/salt/manager/tools/sbin/so-firewall +++ b/salt/manager/tools/sbin/so-firewall @@ -10,27 +10,44 @@ import subprocess import sys import time import yaml +import logging + +# Configure logging to both file and console +logger = logging.getLogger('so-firewall') +logger.setLevel(logging.INFO) + +# File handler +file_handler = logging.FileHandler('/opt/so/log/so-firewall.log') +file_handler.setFormatter(logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')) +logger.addHandler(file_handler) + +# Console handler +console_handler = logging.StreamHandler() +console_handler.setFormatter(logging.Formatter('%(levelname)s - %(message)s')) +logger.addHandler(console_handler) lockFile = "/tmp/so-firewall.lock" hostgroupsFilename = "/opt/so/saltstack/local/pillar/firewall/soc_firewall.sls" defaultsFilename = "/opt/so/saltstack/default/salt/firewall/defaults.yaml" def showUsage(options, args): - print('Usage: {} [OPTIONS] [ARGS...]'.format(sys.argv[0])) - print(' Options:') - print(' --apply - After updating the firewall configuration files, apply the new firewall state') - print('') - print(' General commands:') - print(' help - Prints this usage information.') - print(' apply - Apply the firewall state.') - print('') - print(' Host commands:') - print(' includehost - Includes the given IP in the given group. Args: ') - print(' addhostgroup - Adds a new, custom host group. Args: ') - print('') - print(' Where:') - print(' GROUP_NAME - The name of an alias group (Ex: analyst)') - print(' IP - Either a single IP address (Ex: 8.8.8.8) or a CIDR block (Ex: 10.23.0.0/16).') + usage = f'''Usage: {sys.argv[0]} [OPTIONS] [ARGS...] + Options: + --apply - After updating the firewall configuration files, apply the new firewall state + + General commands: + help - Prints this usage information. + apply - Apply the firewall state. + + Host commands: + includehost - Includes the given IP in the given group. Args: + removehost - Removes the given IP from all hostgroups. Args: + addhostgroup - Adds a new, custom host group. Args: + + Where: + GROUP_NAME - The name of an alias group (Ex: analyst) + IP - Either a single IP address (Ex: 8.8.8.8) or a CIDR block (Ex: 10.23.0.0/16).''' + logger.error(usage) sys.exit(1) def checkApplyOption(options): @@ -61,7 +78,7 @@ def addIp(name, ip): else: hostgroup = content['firewall']['hostgroups'][name] else: - print('Host group not defined in salt/firewall/defaults.yaml or hostgroup name is unallowed.', file=sys.stderr) + logger.error(f"Host group {name} not defined in defaults or is unallowed") return 4 ips = hostgroup if ips is None: @@ -69,15 +86,16 @@ def addIp(name, ip): hostgroup = ips if ip not in ips: ips.append(ip) + writeYaml(hostgroupsFilename, content) + logger.info(f"Successfully added IP {ip} to hostgroup {name}") else: - print('Already exists', file=sys.stderr) + logger.error(f"IP {ip} already exists in hostgroup {name}") return 3 - writeYaml(hostgroupsFilename, content) return 0 def includehost(options, args): if len(args) != 2: - print('Missing host group name or ip argument', file=sys.stderr) + logger.error('Missing host group name or ip argument') showUsage(options, args) result = addIp(args[0], args[1]) code = result @@ -86,9 +104,44 @@ def includehost(options, args): return code def apply(options, args): + logger.info("Applying firewall configuration changes") proc = subprocess.run(['salt-call', 'state.apply', 'firewall', 'queue=True']) + if proc.returncode != 0: + logger.error("Failed to apply firewall changes") + else: + logger.info("Successfully applied firewall changes") return proc.returncode +def removehost(options, args): + """Remove an IP from all hostgroups and apply changes if requested""" + if len(args) != 1: + logger.error('Missing IP argument') + showUsage(options, args) + + ip = args[0] + content = loadYaml(hostgroupsFilename) + if not content or 'firewall' not in content or 'hostgroups' not in content['firewall']: + logger.error("Invalid firewall configuration structure") + return 4 + + modified = False + removed_from = [] + for group_name, ips in content['firewall']['hostgroups'].items(): + if ips and ip in ips: + ips.remove(ip) + modified = True + removed_from.append(group_name) + + if modified: + writeYaml(hostgroupsFilename, content) + logger.info(f"Successfully removed IP {ip} from hostgroups: {', '.join(removed_from)}") + if "--apply" in options: + return apply(None, None) + else: + logger.error(f"IP {ip} not found in any hostgroups") + + return 0 + def main(): options = [] args = sys.argv[1:] @@ -103,6 +156,7 @@ def main(): commands = { "help": showUsage, "includehost": includehost, + "removehost": removehost, "apply": apply } @@ -121,7 +175,7 @@ def main(): time.sleep(2) if lockAttempts == maxAttempts: - print("Lock file (" + lockFile + ") could not be created; proceeding without lock.") + logger.error(f"Lock file ({lockFile}) could not be created - proceeding without lock") cmd = commands.get(args[0], showUsage) code = cmd(options, args[1:]) @@ -129,9 +183,9 @@ def main(): try: os.remove(lockFile) except: - print("Lock file (" + lockFile + ") already removed") + logger.error(f"Lock file ({lockFile}) already removed") sys.exit(code) if __name__ == "__main__": - main() \ No newline at end of file + main() From d3b3a0eb8a6d48098f1d36e108a931766a0210fb Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 28 Jan 2025 14:04:58 -0500 Subject: [PATCH 103/303] wrap salt-cloud -yd. start implementing vm/minion cleanup with ip removal --- salt/manager/tools/sbin/so-salt-cloud | 176 ++++++++++++++++++++++---- 1 file changed, 151 insertions(+), 25 deletions(-) diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index 78473d96a..5ce8d9789 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -35,18 +35,28 @@ between salt-cloud, network configuration, hardware management, and security com ensure proper VM provisioning and configuration. Usage: + # Create a VM: so-salt-cloud -p (--dhcp4 | --static4 --ip4 --gw4 ) [-c ] [-m ] [-P ] [-P ...] [--dns4 ] [--search4 ] + # Delete a VM: + so-salt-cloud -p -d [-y] + Options: -p, --profile The cloud profile to build the VM from. The name of the VM. + -d, --destroy Delete the specified VM. + -y, --assume-yes Default yes in answer to all confirmation questions. + + Network Configuration (required for VM creation): --dhcp4 Configure interface for DHCP (IPv4). --static4 Configure interface for static IPv4 settings. --ip4 IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration. --gw4 IPv4 gateway (e.g., 192.168.1.1). Required for static IPv4 configuration. --dns4 Comma-separated list of IPv4 DNS servers (e.g., 8.8.8.8,8.8.4.4). --search4 DNS search domain for IPv4. + + Hardware Configuration (optional): -c, --cpu Number of virtual CPUs to assign. -m, --memory Amount of memory to assign in MiB. -P, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:c7:00.0). Can be specified multiple times. @@ -110,6 +120,20 @@ Examples: - DNS Server: 192.168.1.1 - DNS Search Domain: example.local +6. Delete a VM with Confirmation: + + Command: + so-salt-cloud -p sool9-hyper1 vm1_sensor -d + + This command deletes the VM named vm1_sensor and will prompt for confirmation before proceeding. + +7. Delete a VM without Confirmation: + + Command: + so-salt-cloud -p sool9-hyper1 vm1_sensor -yd + + This command deletes the VM named vm1_sensor without prompting for confirmation. + Notes: - When using --static4, both --ip4 and --gw4 options are required. @@ -189,6 +213,7 @@ import sys import threading import salt.client import logging +import yaml # Initialize Salt local client local = salt.client.LocalClient() @@ -228,8 +253,94 @@ def call_so_firewall_minion(ip, role): except Exception as e: logger.error(f"An error occurred while calling so-firewall-minion: {e}") -def call_salt_cloud(profile, vm_name): +def get_vm_ip(vm_name): + """Get IP address of VM before deletion""" try: + # Get IP from minion's pillar file + pillar_file = f"/opt/so/saltstack/local/pillar/minions/{vm_name}.sls" + with open(pillar_file, 'r') as f: + pillar_data = yaml.safe_load(f) + + if pillar_data and 'host' in pillar_data and 'mainip' in pillar_data['host']: + return pillar_data['host']['mainip'] + raise Exception(f"Could not find mainip in pillar file {pillar_file}") + except FileNotFoundError: + raise Exception(f"Pillar file not found: {pillar_file}") + except Exception as e: + logger.error(f"Failed to get IP for VM {vm_name}: {e}") + raise + +def cleanup_deleted_vm(ip, role): + """Handle cleanup tasks when a VM is deleted""" + try: + # Remove IP from firewall + process = subprocess.Popen( + ['/usr/sbin/so-firewall', '--apply', 'removehost', ip], + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, + text=True + ) + + for line in iter(process.stdout.readline, ''): + if line: + logger.info(line.rstrip('\n')) + + process.stdout.close() + process.wait() + + if process.returncode == 0: + logger.info(f"Successfully removed IP {ip} from firewall configuration") + else: + logger.error(f"Failed to remove IP {ip} from firewall configuration") + + except Exception as e: + logger.error(f"Error during VM cleanup: {e}") + +def delete_vm(profile, vm_name, assume_yes=False): + """Delete a VM and perform cleanup tasks""" + try: + # Get VM's IP before deletion for cleanup + ip = get_vm_ip(vm_name) + role = vm_name.split("_")[1] + + # Run salt-cloud destroy command + cmd = ['salt-cloud', '-p', profile, vm_name, '-d'] + if assume_yes: + cmd.append('-y') + + process = subprocess.Popen( + cmd, + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, + text=True + ) + + # Monitor output + for line in iter(process.stdout.readline, ''): + if line: + logger.info(line.rstrip('\n')) + + process.stdout.close() + process.wait() + + if process.returncode == 0: + # Start cleanup tasks + cleanup_deleted_vm(ip, role) + logger.info(f"Successfully deleted VM {vm_name}") + else: + logger.error(f"Failed to delete VM {vm_name}") + + except Exception as e: + logger.error(f"Failed to delete VM {vm_name}: {e}") + raise + +def call_salt_cloud(profile, vm_name, destroy=False, assume_yes=False): + """Call salt-cloud to create or destroy a VM""" + try: + if destroy: + delete_vm(profile, vm_name, assume_yes) + return + # Start the salt-cloud command as a subprocess process = subprocess.Popen( ['salt-cloud', '-p', profile, vm_name, '-l', 'info'], @@ -317,45 +428,60 @@ def parse_arguments(): parser = argparse.ArgumentParser(description="Call salt-cloud and pass the profile and VM name to it.") parser.add_argument('-p', '--profile', type=str, required=True, help="The cloud profile to build the VM from.") parser.add_argument('vm_name', type=str, help="The name of the VM.") + parser.add_argument('-d', '--destroy', action='store_true', help='Delete the specified VM') + parser.add_argument('-y', '--assume-yes', action='store_true', help='Default yes in answer to all confirmation questions') - group = parser.add_mutually_exclusive_group(required=True) - group.add_argument("--dhcp4", action="store_true", help="Configure interface for DHCP (IPv4).") - group.add_argument("--static4", action="store_true", help="Configure interface for static IPv4 settings.") + # Create a group for network config arguments + network_group = parser.add_argument_group('Network Configuration') + # Make the group mutually exclusive but not required by default + mode_group = network_group.add_mutually_exclusive_group() + mode_group.add_argument("--dhcp4", action="store_true", help="Configure interface for DHCP (IPv4).") + mode_group.add_argument("--static4", action="store_true", help="Configure interface for static IPv4 settings.") - parser.add_argument("--ip4", help="IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration.") - parser.add_argument("--gw4", help="IPv4 gateway (e.g., 192.168.1.1). Required for static IPv4 configuration.") - parser.add_argument("--dns4", help="Comma-separated list of IPv4 DNS servers (e.g., 8.8.8.8,8.8.4.4).") - parser.add_argument("--search4", help="DNS search domain for IPv4.") - parser.add_argument('-c', '--cpu', type=int, help='Number of virtual CPUs to assign.') - parser.add_argument('-m', '--memory', type=int, help='Amount of memory to assign in MiB.') - parser.add_argument('-P', '--pci', action='append', help='PCI hardware ID(s) to passthrough to the VM (e.g., 0000:c7:00.0). Can be specified multiple times.') + # Add other network and hardware arguments + network_group.add_argument("--ip4", help="IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration.") + network_group.add_argument("--gw4", help="IPv4 gateway (e.g., 192.168.1.1). Required for static IPv4 configuration.") + network_group.add_argument("--dns4", help="Comma-separated list of IPv4 DNS servers (e.g., 8.8.8.8,8.8.4.4).") + network_group.add_argument("--search4", help="DNS search domain for IPv4.") + network_group.add_argument('-c', '--cpu', type=int, help='Number of virtual CPUs to assign.') + network_group.add_argument('-m', '--memory', type=int, help='Amount of memory to assign in MiB.') + network_group.add_argument('-P', '--pci', action='append', help='PCI hardware ID(s) to passthrough to the VM (e.g., 0000:c7:00.0). Can be specified multiple times.') args = parser.parse_args() - if args.static4: - if not args.ip4 or not args.gw4: - parser.error("Both --ip4 and --gw4 are required for static IPv4 configuration.") + # Only validate network config if not destroying + if not args.destroy: + if not args.dhcp4 and not args.static4: + parser.error("One of --dhcp4 or --static4 is required for VM creation") + if args.static4 and (not args.ip4 or not args.gw4): + parser.error("Both --ip4 and --gw4 are required for static IPv4 configuration") + return args def main(): try: args = parse_arguments() - if args.dhcp4: - mode = "dhcp4" - elif args.static4: - mode = "static4" + if args.destroy: + # Handle VM deletion + call_salt_cloud(args.profile, args.vm_name, destroy=True, assume_yes=args.assume_yes) else: - mode = "dhcp4" # Default to DHCP if not specified + # Handle VM creation + if args.dhcp4: + mode = "dhcp4" + elif args.static4: + mode = "static4" + else: + mode = "dhcp4" # Default to DHCP if not specified - # Step 1: Modify network configuration - run_qcow2_modify_network_config(args.profile, mode, args.ip4, args.gw4, args.dns4, args.search4) + # Step 1: Modify network configuration + run_qcow2_modify_network_config(args.profile, mode, args.ip4, args.gw4, args.dns4, args.search4) - # Step 2: Provision the VM (without starting it) - call_salt_cloud(args.profile, args.vm_name) + # Step 2: Provision the VM (without starting it) + call_salt_cloud(args.profile, args.vm_name) - # Step 3: Modify hardware configuration - run_qcow2_modify_hardware_config(args.profile, args.vm_name, cpu=args.cpu, memory=args.memory, pci_list=args.pci, start=True) + # Step 3: Modify hardware configuration + run_qcow2_modify_hardware_config(args.profile, args.vm_name, cpu=args.cpu, memory=args.memory, pci_list=args.pci, start=True) except KeyboardInterrupt: logger.error("so-salt-cloud: Operation cancelled by user.") From 5a6a9d6ec2a3993e5ab706dd59b48c9458c25a41 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 28 Jan 2025 16:01:49 -0500 Subject: [PATCH 104/303] round ES_HEAP_SIZE --- salt/setup/virt/soinstall.map.jinja | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/setup/virt/soinstall.map.jinja b/salt/setup/virt/soinstall.map.jinja index c16f6cd78..33da9ff0c 100644 --- a/salt/setup/virt/soinstall.map.jinja +++ b/salt/setup/virt/soinstall.map.jinja @@ -35,7 +35,7 @@ {% elif total_mem >= 100000 %} {% set ES_HEAP_SIZE = "25000m" %} {% else %} -{% set ES_HEAP_SIZE = total_mem / 3 %} +{% set ES_HEAP_SIZE = (total_mem / 3) | int %} {% if ES_HEAP_SIZE > 25000 %} {% set ES_HEAP_SIZE = "25000m" %} {% else %} From 87136e9e2bb8419138c0ba6f3857a75306c7e9ab Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Tue, 28 Jan 2025 16:38:20 -0500 Subject: [PATCH 105/303] restart salt-minion to trigger highstate --- salt/setup/virt/init.sls | 2 +- salt/setup/virt/setSalt.sls | 7 +++++++ 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/salt/setup/virt/init.sls b/salt/setup/virt/init.sls index be89c8588..384ae706f 100644 --- a/salt/setup/virt/init.sls +++ b/salt/setup/virt/init.sls @@ -1,4 +1,4 @@ include: - - setup.virt.setSalt - setup.virt.setHostname - setup.virt.sominion + - setup.virt.setSalt diff --git a/salt/setup/virt/setSalt.sls b/salt/setup/virt/setSalt.sls index c48282747..eb189b4b2 100644 --- a/salt/setup/virt/setSalt.sls +++ b/salt/setup/virt/setSalt.sls @@ -19,3 +19,10 @@ set_highstate: file.append: - name: /etc/salt/minion - text: 'startup_states: highstate' + +restart_salt_minion: + service.running: + - name: salt-minion + - enable: True + - watch: + - file: set_highstate From 8b3f310212c7a1a2500e0d96a1092d817a456be2 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 29 Jan 2025 04:08:30 -0500 Subject: [PATCH 106/303] install python3-dnf-plugin-versionlock on vm before first highstate --- salt/common/packages.sls | 8 ++++---- salt/setup/virt/init.sls | 1 + 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/salt/common/packages.sls b/salt/common/packages.sls index c5d2729fd..5e72c50ee 100644 --- a/salt/common/packages.sls +++ b/salt/common/packages.sls @@ -1,6 +1,6 @@ -{% from 'vars/globals.map.jinja' import GLOBALS %} - -{% if GLOBALS.os_family == 'Debian' %} +# we cannot import GLOBALS from vars/globals.map.jinja in this state since it is called in setup.virt.init +# since it is early in setup of a new VM, the pillars imported in GLOBALS are not yet defined +{% if grains.os_family == 'Debian' %} commonpkgs: pkg.installed: - skip_suggestions: True @@ -45,7 +45,7 @@ python-rich: {% endif %} {% endif %} -{% if GLOBALS.os_family == 'RedHat' %} +{% if grains.os_family == 'RedHat' %} remove_mariadb: pkg.removed: diff --git a/salt/setup/virt/init.sls b/salt/setup/virt/init.sls index 384ae706f..9c173a78e 100644 --- a/salt/setup/virt/init.sls +++ b/salt/setup/virt/init.sls @@ -1,4 +1,5 @@ include: - setup.virt.setHostname - setup.virt.sominion + - common.packages # python3-dnf-plugin-versionlock - setup.virt.setSalt From ea2e026c564f429b6cef1679937e82eedc88b9e5 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 29 Jan 2025 08:10:05 -0500 Subject: [PATCH 107/303] only manager nodes or heavynodes should ever be single-node --- salt/elasticsearch/enabled.sls | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/elasticsearch/enabled.sls b/salt/elasticsearch/enabled.sls index 48280c506..4699dfb1f 100644 --- a/salt/elasticsearch/enabled.sls +++ b/salt/elasticsearch/enabled.sls @@ -38,7 +38,7 @@ so-elasticsearch: {% endfor %} {% endif %} - environment: - {% if ELASTICSEARCH_SEED_HOSTS | length == 1 or GLOBALS.role == 'so-heavynode' %} + {% if (GLOBALS.role in GLOBALS.manager_roles and ELASTICSEARCH_SEED_HOSTS | length == 1) or GLOBALS.role == 'so-heavynode' %} - discovery.type=single-node {% endif %} - ES_JAVA_OPTS=-Xms{{ GLOBALS.elasticsearch.es_heap }} -Xmx{{ GLOBALS.elasticsearch.es_heap }} -Des.transport.cname_in_publish_address=true -Dlog4j2.formatMsgNoLookups=true From 3c85b482912dbcc208bbac6f1be45afc3b013d9c Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 29 Jan 2025 08:12:50 -0500 Subject: [PATCH 108/303] manage with contents to simplify salt cloud profile file_map --- .../cloud/cloud.profiles.d/socloud.conf.jinja | 10 ++++++++-- .../etc/minion.d/mine_functions.conf.jinja | 14 -------------- salt/salt/mine_functions.sls | 19 +++++++++++++++++-- 3 files changed, 25 insertions(+), 18 deletions(-) delete mode 100644 salt/salt/etc/minion.d/mine_functions.conf.jinja diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index eb2f5b75e..35b9d8bba 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -35,9 +35,15 @@ sool9-{{host}}: # - echo "preflight_cmds" # the destination directory will be created if it doesn't exist file_map: - /opt/so/saltstack/default/salt/setup/virt/initial_schedule.sls: /opt/so/conf/salt/cloud_file_map/salt/initial_schedule.sls + /opt/so/saltstack/default/salt/setup/virt/initial_schedule.sls: /opt/so/conf/salt/cloud_file_map/salt/setup/virt/initial_schedule.sls + /opt/so/saltstack/default/salt/salt/mine_functions.sls: /opt/so/conf/salt/cloud_file_map/salt/salt/mine_functions.sls inline_script: - - "sudo salt-call state.apply initial_schedule --local --file-root=/opt/so/conf/salt/cloud_file_map/salt/" + - | + sudo salt-call state.apply salt.mine_functions \ + --local \ + --file-root=/opt/so/conf/salt/cloud_file_map/salt/ \ + pillar='{"host": {"mainint": "eth0"}}' + - "sudo salt-call state.apply setup.virt.initial_schedule --local --file-root=/opt/so/conf/salt/cloud_file_map/salt/" # - "rpm --import /tmp/securityonion.pub" # grains to add to the minion diff --git a/salt/salt/etc/minion.d/mine_functions.conf.jinja b/salt/salt/etc/minion.d/mine_functions.conf.jinja deleted file mode 100644 index fb721512f..000000000 --- a/salt/salt/etc/minion.d/mine_functions.conf.jinja +++ /dev/null @@ -1,14 +0,0 @@ -{% if grains.role == 'so-hypervisor' %} -{% set interface = 'br0' %} -{% else %} -{% set interface = pillar.host.mainint %} -{% endif %} - -mine_interval: 25 -mine_functions: - network.ip_addrs: - - interface: {{ interface }} -{%- if grains.role in ['so-eval','so-import','so-manager','so-managersearch','so-standalone'] %} - x509.get_pem_entries: - - glob_path: '/etc/pki/ca.crt' -{% endif -%} diff --git a/salt/salt/mine_functions.sls b/salt/salt/mine_functions.sls index 49a47e524..a828add9b 100644 --- a/salt/salt/mine_functions.sls +++ b/salt/salt/mine_functions.sls @@ -6,8 +6,23 @@ # this state was seperated from salt.minion state since it is called during setup # GLOBALS are imported in the salt.minion state and that is not available at that point in setup # this state is included in the salt.minion state + +{% set role = salt['grains.get']('role', '') %} +{% if role == 'so-hypervisor' -%} +{% set interface = 'br0' %} +{% else %} +{% set interface = pillar.host.mainint %} +{% endif %} + mine_functions: file.managed: - name: /etc/salt/minion.d/mine_functions.conf - - source: salt://salt/etc/minion.d/mine_functions.conf.jinja - - template: jinja + - contents: | + mine_interval: 25 + mine_functions: + network.ip_addrs: + - interface: {{ interface }} + {%- if role in ['so-eval','so-import','so-manager','so-managersearch','so-standalone'] %} + x509.get_pem_entries: + - glob_path: '/etc/pki/ca.crt' + {% endif -%} From 8d1ce0460f3ae025a9e9e8766116802fac317cbf Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 29 Jan 2025 14:23:10 -0500 Subject: [PATCH 109/303] remove possible race condition caused by vm init cron for setup.virt.init. setup.virt and mine updated during salt-cloud call with init_script --- .../salt/cloud/cloud.profiles.d/socloud.conf.jinja | 14 +++++++------- salt/setup/virt/initial_schedule.sls | 13 ------------- salt/setup/virt/setSalt.sls | 14 ++------------ 3 files changed, 9 insertions(+), 32 deletions(-) delete mode 100644 salt/setup/virt/initial_schedule.sls diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 35b9d8bba..1de995f74 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -3,6 +3,8 @@ https://securityonion.net/license; you may not use this file except in compliance with the Elastic License 2.0. #} +{#- https://docs.saltproject.io/en/latest/topics/cloud/misc.html #} + {%- for role, hosts in HYPERVISORS.items() %} {%- for host in hosts.keys() -%} @@ -34,17 +36,15 @@ sool9-{{host}}: #preflight_cmds: # - echo "preflight_cmds" # the destination directory will be created if it doesn't exist - file_map: - /opt/so/saltstack/default/salt/setup/virt/initial_schedule.sls: /opt/so/conf/salt/cloud_file_map/salt/setup/virt/initial_schedule.sls - /opt/so/saltstack/default/salt/salt/mine_functions.sls: /opt/so/conf/salt/cloud_file_map/salt/salt/mine_functions.sls + #file_map: + # /opt/so/saltstack/default/salt/salt/mine_functions.sls: /opt/so/conf/salt/cloud_file_map/salt/salt/mine_functions.sls + # if calling states with pillar values, need to pass them in since minion pillars are not set until setup.virt.sominion state runs inline_script: - | sudo salt-call state.apply salt.mine_functions \ - --local \ - --file-root=/opt/so/conf/salt/cloud_file_map/salt/ \ pillar='{"host": {"mainint": "eth0"}}' - - "sudo salt-call state.apply setup.virt.initial_schedule --local --file-root=/opt/so/conf/salt/cloud_file_map/salt/" - # - "rpm --import /tmp/securityonion.pub" + - 'sudo salt-call mine.update' + - 'sudo salt-call state.apply setup.virt' # grains to add to the minion {%- endfor %} diff --git a/salt/setup/virt/initial_schedule.sls b/salt/setup/virt/initial_schedule.sls deleted file mode 100644 index 6388e7c31..000000000 --- a/salt/setup/virt/initial_schedule.sls +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at -# https://securityonion.net/license; you may not use this file except in compliance with the -# Elastic License 2.0. - -# initially tried to use schedule.present here, but that state trys to return data to the master even if run with --local -# that causes it to fail since th firewall may not yet be open on the manager -init_node_cron: - cron.present: - - name: salt-call state.apply setup.virt.init - - identifier: init_node_cron - - user: root - - minute: '*/1' diff --git a/salt/setup/virt/setSalt.sls b/salt/setup/virt/setSalt.sls index eb189b4b2..69c8795de 100644 --- a/salt/setup/virt/setSalt.sls +++ b/salt/setup/virt/setSalt.sls @@ -8,21 +8,11 @@ set_role_grain: - name: role - value: so-{{ grains.id.split("_") | last }} -# remove the initial cron -remove_init_node_cron: - cron.absent: - - name: salt-call state.apply setup.virt.init - - identifier: init_node_cron - - user: root - set_highstate: file.append: - name: /etc/salt/minion - text: 'startup_states: highstate' -restart_salt_minion: - service.running: +enable_salt_minion: + service.enabled: - name: salt-minion - - enable: True - - watch: - - file: set_highstate From a5f2db8c803a3890019fc4d904ba3eeb3c601585 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Wed, 29 Jan 2025 18:17:29 -0500 Subject: [PATCH 110/303] add preflight check to ensure repo connectivity prior to installing salt-minion with salt-cloud --- salt/manager/tools/sbin/so-firewall | 5 +-- salt/manager/tools/sbin/so-salt-cloud | 32 +++++++++++++------ .../cloud/cloud.profiles.d/socloud.conf.jinja | 7 ++-- 3 files changed, 30 insertions(+), 14 deletions(-) diff --git a/salt/manager/tools/sbin/so-firewall b/salt/manager/tools/sbin/so-firewall index f1746ba8d..44f812cec 100755 --- a/salt/manager/tools/sbin/so-firewall +++ b/salt/manager/tools/sbin/so-firewall @@ -33,7 +33,7 @@ defaultsFilename = "/opt/so/saltstack/default/salt/firewall/defaults.yaml" def showUsage(options, args): usage = f'''Usage: {sys.argv[0]} [OPTIONS] [ARGS...] Options: - --apply - After updating the firewall configuration files, apply the new firewall state + --apply - After updating the firewall configuration files, apply the new firewall state with queue=True General commands: help - Prints this usage information. @@ -105,7 +105,8 @@ def includehost(options, args): def apply(options, args): logger.info("Applying firewall configuration changes") - proc = subprocess.run(['salt-call', 'state.apply', 'firewall', 'queue=True']) + salt_args = ['salt-call', 'state.apply', 'firewall', 'queue=True'] + proc = subprocess.run(salt_args) if proc.returncode != 0: logger.error("Failed to apply firewall changes") else: diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index 5ce8d9789..d4c728143 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -28,7 +28,9 @@ This script integrates multiple components to provide a streamlined VM deploymen 4. Security Integration: - Automatic firewall rule configuration - - Integrates with so-firewall-minion for firewall setup on the manager + - Directly integrates with so-firewall for consistent VM management + - Configures role-based firewall rules for new VMs + - Uses same firewall integration approach for both adding and removing VMs This script serves as the primary interface for VM deployment in Security Onion, coordinating between salt-cloud, network configuration, hardware management, and security components to @@ -174,9 +176,9 @@ The so-salt-cloud script automates the provisioning and configuration of virtual 4. Security Integration Phase: - Monitors salt-cloud output for VM IP address assignment - Extracts role information from VM name - - Launches so-firewall-minion in a separate thread for non-blocking operation + - Calls so-firewall directly to configure firewall rules - Configures role-based firewall rules automatically - - Ensures security policies are in place before VM is accessible + - Ensures security policies are in place for VM access - Logs all security-related operations for audit purposes The script implements extensive error handling and logging throughout each phase: @@ -190,7 +192,7 @@ The script implements extensive error handling and logging throughout each phase Integration points: - Works with Security Onion's salt-cloud provider - Interfaces with qcow2 module for image and hardware management -- Coordinates with so-firewall-minion for security configuration +- Directly integrates with so-firewall for security configuration - Uses libvirt for VM management - Leverages SaltStack for distributed execution @@ -232,11 +234,21 @@ console_handler.setFormatter(formatter) logger.addHandler(file_handler) logger.addHandler(console_handler) -def call_so_firewall_minion(ip, role): +def add_host_to_firewall(ip, role): + """Configure firewall rules for a new VM. + + Args: + ip (str): The IP address of the VM to add to the firewall + role (str): The role of the VM (e.g., 'sensor', 'manager', etc.) + + This function calls so-firewall directly to configure firewall rules, + maintaining consistency with how firewall rules are managed during + VM deletion. + """ try: - # Start so-firewall-minion as a subprocess + # Call so-firewall directly with --apply process = subprocess.Popen( - ['/usr/sbin/so-firewall-minion', f'--ip={ip}', f'--role={role}'], + ['/usr/sbin/so-firewall', 'includehost', role.lower(), ip, '--apply'], stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True @@ -251,7 +263,7 @@ def call_so_firewall_minion(ip, role): process.wait() except Exception as e: - logger.error(f"An error occurred while calling so-firewall-minion: {e}") + logger.error(f"An error occurred while adding host to firewall: {e}") def get_vm_ip(vm_name): """Get IP address of VM before deletion""" @@ -366,8 +378,8 @@ def call_salt_cloud(profile, vm_name, destroy=False, assume_yes=False): if len(parts) > 1: ip_address = parts[1].strip() logger.info(f"Extracted IP address: {ip_address}") - # Create and start a thread to run so-firewall-minion - thread = threading.Thread(target=call_so_firewall_minion, args=(ip_address, role.upper())) + # Create and start a thread to add host to firewall + thread = threading.Thread(target=add_host_to_firewall, args=(ip_address, role)) thread.start() else: logger.error("No IP address found.") diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 1de995f74..2f0323482 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -33,8 +33,11 @@ sool9-{{host}}: log_file: /opt/so/log/salt/minion grains: hypervisor_host: {{host ~ "_" ~ role}} - #preflight_cmds: - # - echo "preflight_cmds" + preflight_cmds: + - | + timeout 600 bash -c 'trap "echo \"Preflight Check: Failed to establish repo connectivity\"; exit 1" TERM; \ + while ! dnf makecache --repoid=securityonion >/dev/null 2>&1; do echo "Preflight Check: Waiting for repo connectivity..."; \ + sleep 5; done && echo "Preflight Check: Successfully connected to repo" || exit 1; [ $? -eq 0 ]' # the destination directory will be created if it doesn't exist #file_map: # /opt/so/saltstack/default/salt/salt/mine_functions.sls: /opt/so/conf/salt/cloud_file_map/salt/salt/mine_functions.sls From 08bbeedbd79f38491a86b3e493f751360485c5ca Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 30 Jan 2025 09:55:26 -0500 Subject: [PATCH 111/303] add automatic NVMe device mounting for VMs with LVM support --- salt/storage/files/so-nsm-mount | 304 ++++++++++++++++++++++++++++++++ salt/storage/init.sls | 7 + salt/storage/nsm_mount.sls | 40 +++++ salt/top.sls | 3 + 4 files changed, 354 insertions(+) create mode 100644 salt/storage/files/so-nsm-mount create mode 100644 salt/storage/init.sls create mode 100644 salt/storage/nsm_mount.sls diff --git a/salt/storage/files/so-nsm-mount b/salt/storage/files/so-nsm-mount new file mode 100644 index 000000000..b06bccc2a --- /dev/null +++ b/salt/storage/files/so-nsm-mount @@ -0,0 +1,304 @@ +#!/bin/bash + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +# Usage: +# so-nsm-mount +# +# Options: +# None - script automatically detects and configures NVMe devices +# +# Examples: +# 1. Configure and mount NVMe devices: +# ```bash +# sudo so-nsm-mount +# ``` +# +# Notes: +# - Requires root privileges +# - Automatically detects unmounted NVMe devices +# - Handles multiple NVMe devices: +# * Creates PV from each device +# * Combines all devices into single volume group +# * Creates single logical volume using total space +# - Safely handles existing LVM configurations: +# * Preserves proper existing configurations +# * Provides cleanup instructions if conflicts found +# - Creates or extends LVM configuration if no conflicts +# - Uses XFS filesystem +# - Configures persistent mount via /etc/fstab +# - Safe to run multiple times +# +# Description: +# This script automates the configuration and mounting of NVMe devices +# as /nsm in Security Onion virtual machines. It performs these steps: +# +# 1. Safety Checks: +# - Verifies root privileges +# - Checks if /nsm is already mounted +# - Detects available unmounted NVMe devices +# +# 2. LVM Configuration Check: +# - If device is part of "system" VG with "nsm" LV: +# * Uses existing configuration +# * Exits successfully +# - If device is part of different LVM configuration: +# * Logs current configuration details +# * Provides specific cleanup instructions +# * Exits with error to prevent data loss +# +# 3. New Configuration (if no conflicts): +# - Creates physical volume on each NVMe device +# - Combines all devices into single "system" volume group +# - Creates single "nsm" logical volume using total space +# - Creates XFS filesystem +# - Updates /etc/fstab for persistence +# - Mounts the filesystem as /nsm +# +# Exit Codes: +# 0: Success conditions: +# - Devices configured and mounted +# - Already properly mounted +# 1: Error conditions: +# - Must be run as root +# - No available NVMe devices found +# - Device has conflicting LVM configuration +# - Device preparation failed +# - LVM operation failed +# - Filesystem/mount operation failed +# +# Logging: +# - All operations logged to both console and /opt/so/log/so-nsm-mount.log + +set -e + +LOG_FILE="/opt/so/log/so-nsm-mount.log" +VG_NAME="system" +LV_NAME="nsm" +MOUNT_POINT="/nsm" + +# Function to log messages +log() { + local msg="$(date '+%Y-%m-%d %H:%M:%S') $1" + echo "$msg" | tee -a "$LOG_FILE" +} + +# Function to check if running as root +check_root() { + if [ "$EUID" -ne 0 ]; then + log "Error: Failed to execute - script must be run as root" + exit 1 + fi +} + +# Function to check LVM configuration of a device +check_lvm_config() { + local device=$1 + local vg_name + local lv_name + + # Check if device is a PV + if ! pvs "$device" &>/dev/null; then + return 0 + fi + + # Get VG name if any + vg_name=$(pvs --noheadings -o vg_name "$device" | tr -d ' ') + if [ -z "$vg_name" ]; then + return 0 + fi + + # If it's our expected configuration + if [ "$vg_name" = "$VG_NAME" ]; then + if lvs "$VG_NAME/$LV_NAME" &>/dev/null; then + # Our expected configuration exists + if ! mountpoint -q "$MOUNT_POINT"; then + log "Found existing LVM configuration. Remounting $MOUNT_POINT" + mount "$MOUNT_POINT" + fi + exit 0 + fi + fi + + # Get all LVs in the VG + local lvs_in_vg=$(lvs --noheadings -o lv_name "$vg_name" 2>/dev/null | tr '\n' ',' | sed 's/,$//') + + log "Error: Device $device is part of existing LVM configuration:" + log " Volume Group: $vg_name" + log " Logical Volumes: ${lvs_in_vg:-none}" + log "" + log "To preserve data safety, no changes will be made." + log "" + log "If you want to repurpose this device for /nsm, verify it's safe to proceed:" + log "1. Check current usage: lsblk $device" + log "2. Then run this command to clean up (CAUTION: THIS WILL DESTROY ALL DATA):" + log " umount $MOUNT_POINT 2>/dev/null; " + for lv in $(echo "$lvs_in_vg" | tr ',' ' '); do + log " lvremove -f /dev/$vg_name/$lv; " + done + log " vgreduce $vg_name $device && pvremove -ff -y $device && wipefs -a $device" + + exit 1 +} + +# Function to detect NVMe devices +detect_nvme_devices() { + local devices=() + for dev in /dev/nvme*n1; do + if [ -b "$dev" ]; then + # Skip if device is already part of a mounted filesystem + if ! lsblk -no MOUNTPOINT "$dev" | grep -q .; then + devices+=("$dev") + fi + fi + done + + if [ ${#devices[@]} -eq 0 ]; then + log "Error: No available NVMe devices found" + exit 1 + fi + + echo "${devices[@]}" +} + +# Function to prepare devices for LVM +prepare_devices() { + local devices=("$@") + + for device in "${devices[@]}"; do + # Check existing LVM configuration first + check_lvm_config "$device" + + # Clean existing signatures + if ! wipefs -a "$device" 2>wipefs.err; then + log "Error: Failed to clean signatures on $device: $(cat wipefs.err)" + rm -f wipefs.err + exit 1 + fi + rm -f wipefs.err + + # Create physical volume + if ! pvcreate -ff -y "$device" 2>pv.err; then + log "Error: Failed to create physical volume on $device: $(cat pv.err)" + rm -f pv.err + exit 1 + fi + rm -f pv.err + size=$(lsblk -dbn -o SIZE "$device" | numfmt --to=iec) + log "Created physical volume: $device ($size)" + done +} + +# Function to setup LVM +setup_lvm() { + local devices=("$@") + + # Create or extend volume group + if vgs "$VG_NAME" &>/dev/null; then + # Extend existing VG + if ! vgextend "$VG_NAME" "${devices[@]}" 2>vg.err; then + log "Error: Failed to extend volume group $VG_NAME: $(cat vg.err)" + rm -f vg.err + exit 1 + fi + rm -f vg.err + size=$(vgs --noheadings -o vg_size --units h "$VG_NAME" | tr -d ' ') + log "Extended volume group: $VG_NAME (total size: $size)" + else + # Create new VG + if ! vgcreate "$VG_NAME" "${devices[@]}" 2>vg.err; then + log "Error: Failed to create volume group $VG_NAME: $(cat vg.err)" + rm -f vg.err + exit 1 + fi + rm -f vg.err + size=$(vgs --noheadings -o vg_size --units h "$VG_NAME" | tr -d ' ') + log "Created volume group: $VG_NAME (size: $size)" + fi + + # Create logical volume using all available space + if ! lvs "$VG_NAME/$LV_NAME" &>/dev/null; then + if ! lvcreate -l 100%FREE -n "$LV_NAME" "$VG_NAME" 2>lv.err; then + log "Error: Failed to create logical volume $LV_NAME: $(cat lv.err)" + rm -f lv.err + exit 1 + fi + rm -f lv.err + size=$(lvs --noheadings -o lv_size --units h "$VG_NAME/$LV_NAME" | tr -d ' ') + log "Created logical volume: $LV_NAME (size: $size)" + fi +} + +# Function to create and mount filesystem +setup_filesystem() { + local device="/dev/$VG_NAME/$LV_NAME" + + # Create XFS filesystem if needed + if ! blkid "$device" | grep -q "TYPE=\"xfs\""; then + if ! mkfs.xfs -f "$device" 2>mkfs.err; then + log "Error: Failed to create XFS filesystem: $(cat mkfs.err)" + rm -f mkfs.err + exit 1 + fi + rm -f mkfs.err + size=$(lvs --noheadings -o lv_size --units h "$VG_NAME/$LV_NAME" | tr -d ' ') + log "Created XFS filesystem: $device (size: $size)" + fi + + # Create mount point + mkdir -p "$MOUNT_POINT" + + # Update fstab if needed + if ! grep -q "^$device.*$MOUNT_POINT" /etc/fstab; then + echo "$device $MOUNT_POINT xfs rw,relatime,seclabel,attr2,inode64,logbufs=8,logbsize=32k,noquota 0 0" >> /etc/fstab + log "Updated fstab configuration for $device" + fi + + # Mount the filesystem + if ! mountpoint -q "$MOUNT_POINT"; then + if ! mount "$MOUNT_POINT" 2>mount.err; then + log "Error: Failed to mount $MOUNT_POINT: $(cat mount.err)" + rm -f mount.err + exit 1 + fi + rm -f mount.err + size=$(df -h "$MOUNT_POINT" | awk 'NR==2 {print $2}') + log "Mounted filesystem: $device on $MOUNT_POINT (size: $size)" + fi +} + +# Main function +main() { + check_root + + # Check if already mounted + if mountpoint -q "$MOUNT_POINT"; then + size=$(df -h "$MOUNT_POINT" | awk 'NR==2 {print $2}') + log "$MOUNT_POINT already mounted (size: $size)" + exit 0 + fi + + # Detect NVMe devices + local devices + devices=($(detect_nvme_devices)) + log "Detected NVMe devices:" + for dev in "${devices[@]}"; do + size=$(lsblk -dbn -o SIZE "$dev" | numfmt --to=iec) + log " - $dev ($size)" + done + + # Prepare devices + prepare_devices "${devices[@]}" + + # Setup LVM + setup_lvm "${devices[@]}" + + # Create and mount filesystem + setup_filesystem +} + +# Run main function +main "$@" diff --git a/salt/storage/init.sls b/salt/storage/init.sls new file mode 100644 index 000000000..5bce7e71a --- /dev/null +++ b/salt/storage/init.sls @@ -0,0 +1,7 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +include: + - storage.nsm_mount diff --git a/salt/storage/nsm_mount.sls b/salt/storage/nsm_mount.sls new file mode 100644 index 000000000..b0476e054 --- /dev/null +++ b/salt/storage/nsm_mount.sls @@ -0,0 +1,40 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +# Install required packages +storage_nsm_mount_packages: + pkg.installed: + - pkgs: + - lvm2 + - xfsprogs + +# Ensure log directory exists +storage_nsm_mount_logdir: + file.directory: + - name: /opt/so/log + - makedirs: True + - user: root + - group: root + - mode: 755 + +# Install the NSM mount script +storage_nsm_mount_script: + file.managed: + - name: /usr/sbin/so-nsm-mount + - source: salt://storage/files/so-nsm-mount + - mode: 755 + - user: root + - group: root + - require: + - pkg: storage_nsm_mount_packages + - file: storage_nsm_mount_logdir + +# Execute the mount script if not already mounted +storage_nsm_mount_execute: + cmd.run: + - name: /usr/sbin/so-nsm-mount + - unless: mountpoint -q /nsm + - require: + - file: storage_nsm_mount_script diff --git a/salt/top.sls b/salt/top.sls index 09f7a2c28..82f074626 100644 --- a/salt/top.sls +++ b/salt/top.sls @@ -8,6 +8,9 @@ {% set INSTALLEDSALTVERSION = grains.saltversion %} base: + 'salt-cloud:driver:libvirt': + - match: grain + - storage '*': - cron.running From 61992ae78703829c7e907eaed590d01c8cb2d8fb Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 30 Jan 2025 13:28:08 -0500 Subject: [PATCH 112/303] verify script work with 1 or more nvme --- salt/storage/files/so-nsm-mount | 543 ++++++++++++++++++++++++++++---- 1 file changed, 480 insertions(+), 63 deletions(-) diff --git a/salt/storage/files/so-nsm-mount b/salt/storage/files/so-nsm-mount index b06bccc2a..9a2d00d88 100644 --- a/salt/storage/files/so-nsm-mount +++ b/salt/storage/files/so-nsm-mount @@ -83,13 +83,43 @@ MOUNT_POINT="/nsm" # Function to log messages log() { local msg="$(date '+%Y-%m-%d %H:%M:%S') $1" - echo "$msg" | tee -a "$LOG_FILE" + echo "$msg" | tee -a "$LOG_FILE" >&2 +} + +# Function to log errors +log_error() { + local msg="$(date '+%Y-%m-%d %H:%M:%S') ERROR: $1" + echo "$msg" | tee -a "$LOG_FILE" >&2 +} + +# Function to log command output +log_cmd() { + local cmd="$1" + local desc="$2" + local output + + # Use eval to properly handle shell operators + output=$(eval "$cmd" 2>&1) || { + local ret=$? + log_error "Command failed with exit code $ret: $cmd" + echo "$output" | while IFS= read -r line; do + log " $line" + done + return $ret + } + + if [ -n "$output" ]; then + log "$desc:" + echo "$output" | while IFS= read -r line; do + log " $line" + done + fi } # Function to check if running as root check_root() { if [ "$EUID" -ne 0 ]; then - log "Error: Failed to execute - script must be run as root" + log_error "Failed to execute - script must be run as root" exit 1 fi } @@ -100,23 +130,42 @@ check_lvm_config() { local vg_name local lv_name + log "Checking LVM configuration for $device" + + # Log device details + log_cmd "lsblk -o NAME,SIZE,TYPE,MOUNTPOINT $device" "Device details" + # Check if device is a PV if ! pvs "$device" &>/dev/null; then + log "Device is not a physical volume" return 0 fi + # Log PV details + log_cmd "pvs --noheadings -o pv_name,vg_name,pv_size,pv_used $device" "Physical volume details" + # Get VG name if any vg_name=$(pvs --noheadings -o vg_name "$device" | tr -d ' ') if [ -z "$vg_name" ]; then + log "Device is not part of any volume group" return 0 fi + # Log VG details + log_cmd "vgs --noheadings -o vg_name,vg_size,vg_free,pv_count $vg_name" "Volume group details" + # If it's our expected configuration if [ "$vg_name" = "$VG_NAME" ]; then if lvs "$VG_NAME/$LV_NAME" &>/dev/null; then - # Our expected configuration exists - if ! mountpoint -q "$MOUNT_POINT"; then + # Log LV details + log_cmd "lvs --noheadings -o lv_name,lv_size,lv_path $VG_NAME/$LV_NAME" "Logical volume details" + + # Check mount status + if mountpoint -q "$MOUNT_POINT"; then + log_cmd "df -h $MOUNT_POINT" "Current mount details" + else log "Found existing LVM configuration. Remounting $MOUNT_POINT" + log_cmd "grep -P \"^/dev/$VG_NAME/$LV_NAME\\s\" /etc/fstab" "Existing fstab entry" mount "$MOUNT_POINT" fi exit 0 @@ -126,7 +175,7 @@ check_lvm_config() { # Get all LVs in the VG local lvs_in_vg=$(lvs --noheadings -o lv_name "$vg_name" 2>/dev/null | tr '\n' ',' | sed 's/,$//') - log "Error: Device $device is part of existing LVM configuration:" + log_error "Device $device is part of existing LVM configuration:" log " Volume Group: $vg_name" log " Logical Volumes: ${lvs_in_vg:-none}" log "" @@ -144,130 +193,476 @@ check_lvm_config() { exit 1 } -# Function to detect NVMe devices -detect_nvme_devices() { - local devices=() - for dev in /dev/nvme*n1; do - if [ -b "$dev" ]; then - # Skip if device is already part of a mounted filesystem - if ! lsblk -no MOUNTPOINT "$dev" | grep -q .; then - devices+=("$dev") +# Function to cleanup device +cleanup_device() { + local device=$1 + + log "Cleaning up device $device" + + # Check if device is mounted + if mountpoint -q "$device"; then + log " Device is mounted, attempting unmount" + if ! umount "$device" 2>/dev/null; then + log_error "Failed to unmount device" + return 1 + fi + fi + + # Remove LVM configs if they exist + if pvs "$device" &>/dev/null; then + local vg=$(pvs --noheadings -o vg_name "$device" | tr -d ' ') + if [[ -n "$vg" && "$vg" != "$VG_NAME" ]]; then + log " Removing device from volume group $vg" + if ! vgreduce "$vg" "$device" 2>/dev/null; then + log_error "Failed to remove from volume group" + return 1 fi fi - done - - if [ ${#devices[@]} -eq 0 ]; then - log "Error: No available NVMe devices found" - exit 1 + log " Removing physical volume" + if ! pvremove -ff -y "$device" 2>/dev/null; then + log_error "Failed to remove physical volume" + return 1 + fi fi + + # Remove partitions and signatures + log " Removing partitions and signatures" + if ! wipefs -a "$device" 2>/dev/null; then + log_error "Failed to remove signatures" + return 1 + fi + + log " Device cleanup successful" + return 0 +} - echo "${devices[@]}" +# Function to validate device state +validate_device_state() { + local device=$1 + + if [[ ! -b "$device" ]]; then + log_error "$device is not a valid block device" + return 1 + fi + + # Check if device is already properly configured + if pvs "$device" &>/dev/null; then + local vg=$(pvs --noheadings -o vg_name "$device" | tr -d ' ') + if [[ "$vg" == "$VG_NAME" ]]; then + if lvs "$VG_NAME/$LV_NAME" &>/dev/null; then + log "Device $device is already properly configured in VG $VG_NAME" + log "Skipping device" + return 1 + fi + fi + fi + + # Check for existing partitions or LVM + if pvs "$device" &>/dev/null || lsblk -no TYPE "$device" | grep -q "part"; then + log "Device $device has existing configuration" + if ! cleanup_device "$device"; then + log "Failed to cleanup device $device" + return 1 + fi + fi + + return 0 +} + +# Function to log device details +log_device_details() { + local device=$1 + local size mount fs_type vg_name + + size=$(lsblk -dbn -o SIZE "$device" 2>/dev/null | numfmt --to=iec) + mount=$(lsblk -no MOUNTPOINT "$device" 2>/dev/null) + fs_type=$(lsblk -no FSTYPE "$device" 2>/dev/null) + + log "Device details for $device:" + log " Size: $size" + log " Filesystem: ${fs_type:-none}" + log " Mountpoint: ${mount:-none}" + + if pvs "$device" &>/dev/null; then + vg_name=$(pvs --noheadings -o vg_name "$device" | tr -d ' ') + log " LVM status: Physical volume in VG ${vg_name:-none}" + else + log " LVM status: Not a physical volume" + fi +} + +# Function to detect NVMe devices +detect_nvme_devices() { + local -a devices=() + local -a available_devices=() + + { + log "----------------------------------------" + log "Starting NVMe device detection" + log "----------------------------------------" + + # First get a clean list of devices + while read -r dev; do + if [[ -b "$dev" ]]; then + devices+=("$dev") + fi + done < <(find /dev -name 'nvme*n1' 2>/dev/null) + + if [ ${#devices[@]} -eq 0 ]; then + log_error "No NVMe devices found" + log "----------------------------------------" + exit 1 + fi + + log "Found ${#devices[@]} NVMe device(s)" + + # Process and validate each device + for dev in "${devices[@]}"; do + log_device_details "$dev" + + if validate_device_state "$dev"; then + available_devices+=("$dev") + log "Status: Available for use" + else + log "Status: Not available (see previous messages)" + fi + log "----------------------------------------" + done + + if [ ${#available_devices[@]} -eq 0 ]; then + log_error "No available NVMe devices found" + log "----------------------------------------" + exit 1 + fi + + log "Summary: ${#available_devices[@]} device(s) available for use" + for dev in "${available_devices[@]}"; do + local size=$(lsblk -dbn -o SIZE "$dev" 2>/dev/null | numfmt --to=iec) + log " - $dev ($size)" + done + log "----------------------------------------" + } >&2 + + # Return array elements one per line + printf '%s\n' "${available_devices[@]}" } # Function to prepare devices for LVM prepare_devices() { - local devices=("$@") + local -a devices=("$@") + local -a prepared_devices=() - for device in "${devices[@]}"; do - # Check existing LVM configuration first - check_lvm_config "$device" + { + log "----------------------------------------" + log "Starting device preparation" + log "----------------------------------------" - # Clean existing signatures - if ! wipefs -a "$device" 2>wipefs.err; then - log "Error: Failed to clean signatures on $device: $(cat wipefs.err)" + for device in "${devices[@]}"; do + if [[ ! -b "$device" ]]; then + log_error "Invalid device path: $device" + continue + fi + + log "Processing device: $device" + log_device_details "$device" + + # Check if device needs preparation + if ! validate_device_state "$device"; then + log "Skipping device $device - invalid state" + continue + fi + + log "Preparing device for LVM use:" + + # Clean existing signatures + log " Step 1: Cleaning existing signatures" + if ! wipefs -a "$device" 2>wipefs.err; then + log_error "Failed to clean signatures" + log " Details: $(cat wipefs.err)" + rm -f wipefs.err + continue + fi rm -f wipefs.err - exit 1 - fi - rm -f wipefs.err + log " Success: Signatures cleaned" - # Create physical volume - if ! pvcreate -ff -y "$device" 2>pv.err; then - log "Error: Failed to create physical volume on $device: $(cat pv.err)" + # Create physical volume + log " Step 2: Creating physical volume" + if ! pvcreate -ff -y "$device" 2>pv.err; then + log_error "Physical volume creation failed" + log " Details: $(cat pv.err)" + rm -f pv.err + continue + fi rm -f pv.err + + # Log success and add to prepared devices + size=$(lsblk -dbn -o SIZE "$device" | numfmt --to=iec) + log " Success: Created physical volume" + log " Device: $device" + log " Size: $size" + log_cmd "pvs --noheadings -o pv_name,vg_name,pv_size,pv_used $device" "Physical volume details" + + prepared_devices+=("$device") + log "----------------------------------------" + done + + if [ ${#prepared_devices[@]} -eq 0 ]; then + log_error "No devices were successfully prepared" exit 1 fi - rm -f pv.err - size=$(lsblk -dbn -o SIZE "$device" | numfmt --to=iec) - log "Created physical volume: $device ($size)" + } >&2 + + printf '%s\n' "${prepared_devices[@]}" +} + +# Function to wait for device +wait_for_device() { + local device="$1" + local timeout=10 + local count=0 + + log "Waiting for device $device to be available" + while [ ! -e "$device" ] && [ $count -lt $timeout ]; do + sleep 1 + count=$((count + 1)) + log " Attempt $count/$timeout" done + + if [ ! -e "$device" ]; then + log_error "Device $device did not appear after $timeout seconds" + return 1 + fi + + # Run udevadm trigger to ensure device nodes are created + log " Running udevadm trigger" + if ! udevadm trigger "$device" 2>/dev/null; then + log " WARNING: udevadm trigger failed, continuing anyway" + fi + + # Give udev a moment to create device nodes + sleep 1 + + # Run udevadm settle to wait for udev to finish processing + log " Waiting for udev to settle" + if ! udevadm settle 2>/dev/null; then + log " WARNING: udevadm settle failed, continuing anyway" + fi + + # Run vgscan to ensure LVM sees the device + log " Running vgscan" + if ! vgscan --mknodes 2>/dev/null; then + log " WARNING: vgscan failed, continuing anyway" + fi + + log " Device $device is now available" + return 0 } # Function to setup LVM setup_lvm() { - local devices=("$@") + local -a devices=("$@") + + log "----------------------------------------" + log "Starting LVM configuration" + log "----------------------------------------" + + # Log initial LVM state + log "Initial LVM state:" + log_cmd "pvs" "Physical volumes" + log_cmd "vgs" "Volume groups" + log_cmd "lvs" "Logical volumes" # Create or extend volume group if vgs "$VG_NAME" &>/dev/null; then + log "Step 1: Extending existing volume group" + log " Target VG: $VG_NAME" + log " Devices to add: ${devices[*]}" + # Extend existing VG if ! vgextend "$VG_NAME" "${devices[@]}" 2>vg.err; then - log "Error: Failed to extend volume group $VG_NAME: $(cat vg.err)" + log_error "Volume group extension failed" + log " Details: $(cat vg.err)" rm -f vg.err exit 1 fi rm -f vg.err + size=$(vgs --noheadings -o vg_size --units h "$VG_NAME" | tr -d ' ') - log "Extended volume group: $VG_NAME (total size: $size)" + log " Success: Extended volume group" + log " Name: $VG_NAME" + log " Total size: $size" else + log "Step 1: Creating new volume group" + log " Name: $VG_NAME" + log " Devices: ${devices[*]}" + # Create new VG if ! vgcreate "$VG_NAME" "${devices[@]}" 2>vg.err; then - log "Error: Failed to create volume group $VG_NAME: $(cat vg.err)" + log_error "Volume group creation failed" + log " Details: $(cat vg.err)" rm -f vg.err exit 1 fi rm -f vg.err + size=$(vgs --noheadings -o vg_size --units h "$VG_NAME" | tr -d ' ') - log "Created volume group: $VG_NAME (size: $size)" + log " Success: Created volume group" + log " Name: $VG_NAME" + log " Size: $size" fi + log_cmd "vgs $VG_NAME" "Volume group details" + # Create logical volume using all available space if ! lvs "$VG_NAME/$LV_NAME" &>/dev/null; then + log "Step 2: Creating logical volume" + log " Name: $LV_NAME" + log " Size: 100% of free space" + if ! lvcreate -l 100%FREE -n "$LV_NAME" "$VG_NAME" 2>lv.err; then - log "Error: Failed to create logical volume $LV_NAME: $(cat lv.err)" + log_error "Logical volume creation failed" + log " Details: $(cat lv.err)" rm -f lv.err exit 1 fi rm -f lv.err + size=$(lvs --noheadings -o lv_size --units h "$VG_NAME/$LV_NAME" | tr -d ' ') - log "Created logical volume: $LV_NAME (size: $size)" + log " Success: Created logical volume" + log " Name: $LV_NAME" + log " Size: $size" + log_cmd "lvs $VG_NAME/$LV_NAME" "Logical volume details" + else + log "Step 2: Logical volume already exists" + log_cmd "lvs $VG_NAME/$LV_NAME" "Existing logical volume details" fi + + log "----------------------------------------" } # Function to create and mount filesystem setup_filesystem() { local device="/dev/$VG_NAME/$LV_NAME" + log "----------------------------------------" + log "Starting filesystem setup" + log "----------------------------------------" + + log "Step 1: Checking device status" + log " Device path: $device" + + # Wait for device to be available + if ! wait_for_device "$device"; then + exit 1 + fi + + # Check filesystem type - don't fail if blkid fails + local fs_type + fs_type=$(blkid -o value -s TYPE "$device" 2>/dev/null || echo "none") + log " Current filesystem type: ${fs_type:-none}" + # Create XFS filesystem if needed - if ! blkid "$device" | grep -q "TYPE=\"xfs\""; then + log "Step 2: Filesystem preparation" + if [[ "$fs_type" != "xfs" ]]; then + log " Creating new XFS filesystem:" + log " Device: $device" + log " Options: -f (force)" + if ! mkfs.xfs -f "$device" 2>mkfs.err; then - log "Error: Failed to create XFS filesystem: $(cat mkfs.err)" + log_error "XFS filesystem creation failed" + log " Details: $(cat mkfs.err)" rm -f mkfs.err exit 1 fi rm -f mkfs.err + size=$(lvs --noheadings -o lv_size --units h "$VG_NAME/$LV_NAME" | tr -d ' ') - log "Created XFS filesystem: $device (size: $size)" + log " Success: Created XFS filesystem" + log " Device: $device" + log " Size: $size" + + # Verify filesystem was created + fs_type=$(blkid -o value -s TYPE "$device") + if [[ "$fs_type" != "xfs" ]]; then + log_error "Failed to verify XFS filesystem creation" + exit 1 + fi + log " Verified XFS filesystem" + else + log " XFS filesystem already exists" fi # Create mount point - mkdir -p "$MOUNT_POINT" + log "Step 3: Mount point preparation" + if [[ ! -d "$MOUNT_POINT" ]]; then + log " Creating mount point directory: $MOUNT_POINT" + mkdir -p "$MOUNT_POINT" + log " Success: Directory created" + else + log " Mount point already exists: $MOUNT_POINT" + fi # Update fstab if needed - if ! grep -q "^$device.*$MOUNT_POINT" /etc/fstab; then - echo "$device $MOUNT_POINT xfs rw,relatime,seclabel,attr2,inode64,logbufs=8,logbsize=32k,noquota 0 0" >> /etc/fstab - log "Updated fstab configuration for $device" + log "Step 4: Configuring persistent mount" + log " Checking current fstab entries:" + # Temporarily disable exit on error for fstab operations + set +e + + # Check fstab entries without failing on no match + if ! grep -P "^/dev/$VG_NAME/$LV_NAME\\s" /etc/fstab >/dev/null 2>&1; then + log " No existing fstab entry found" + else + log_cmd "grep -P '^/dev/$VG_NAME/$LV_NAME\\s' /etc/fstab" "Current configuration" + fi + + # Check if we need to add fstab entry + if ! grep -q "^$device.*$MOUNT_POINT" /etc/fstab >/dev/null 2>&1; then + # Re-enable exit on error for critical operations + set -e + log " Adding new fstab entry" + local mount_options="rw,relatime,seclabel,attr2,inode64,logbufs=8,logbsize=32k,noquota" + echo "$device $MOUNT_POINT xfs $mount_options 0 0" >> /etc/fstab + log " Success: Added entry" + log " Device: $device" + log " Mount point: $MOUNT_POINT" + log " Options: $mount_options" + log_cmd "grep -P \"^/dev/$VG_NAME/$LV_NAME\\s\" /etc/fstab" "New configuration" + + # Reload systemd to recognize new fstab entry + log " Reloading systemd to recognize new fstab entry" + if ! systemctl daemon-reload; then + log " WARNING: Failed to reload systemd, continuing anyway" + fi + else + log " Existing fstab entry found" + # Re-enable exit on error + set -e fi # Mount the filesystem + log "Step 5: Mounting filesystem" if ! mountpoint -q "$MOUNT_POINT"; then + log " Mounting $device to $MOUNT_POINT" if ! mount "$MOUNT_POINT" 2>mount.err; then - log "Error: Failed to mount $MOUNT_POINT: $(cat mount.err)" + log_error "Mount operation failed" + log " Details: $(cat mount.err)" rm -f mount.err exit 1 fi rm -f mount.err + size=$(df -h "$MOUNT_POINT" | awk 'NR==2 {print $2}') - log "Mounted filesystem: $device on $MOUNT_POINT (size: $size)" + log " Success: Filesystem mounted" + log " Device: $device" + log " Mount point: $MOUNT_POINT" + log " Size: $size" + log_cmd "df -h $MOUNT_POINT" "Mount details" + else + log " Filesystem already mounted" + log_cmd "df -h $MOUNT_POINT" "Current mount details" fi + + log "----------------------------------------" } # Main function @@ -278,26 +673,48 @@ main() { if mountpoint -q "$MOUNT_POINT"; then size=$(df -h "$MOUNT_POINT" | awk 'NR==2 {print $2}') log "$MOUNT_POINT already mounted (size: $size)" + log_cmd "df -h $MOUNT_POINT" "Current mount details" exit 0 fi - # Detect NVMe devices - local devices - devices=($(detect_nvme_devices)) - log "Detected NVMe devices:" - for dev in "${devices[@]}"; do - size=$(lsblk -dbn -o SIZE "$dev" | numfmt --to=iec) - log " - $dev ($size)" - done + # Log initial system state + log "Initial system state:" + log_cmd "lsblk" "Block devices" + log_cmd "pvs" "Physical volumes" + log_cmd "vgs" "Volume groups" + log_cmd "lvs" "Logical volumes" - # Prepare devices - prepare_devices "${devices[@]}" + # Detect NVMe devices + local -a devices=() + mapfile -t devices < <(detect_nvme_devices) - # Setup LVM - setup_lvm "${devices[@]}" + if [ ${#devices[@]} -eq 0 ]; then + log_error "No NVMe devices available for use" + exit 1 + fi + + # Prepare devices and get list of successfully prepared ones + local -a prepared_devices=() + mapfile -t prepared_devices < <(prepare_devices "${devices[@]}") + + if [ ${#prepared_devices[@]} -eq 0 ]; then + log_error "No devices were successfully prepared" + exit 1 + fi + + # Setup LVM with prepared devices + setup_lvm "${prepared_devices[@]}" # Create and mount filesystem setup_filesystem + + # Log final system state + log "Final system state:" + log_cmd "lsblk" "Block devices" + log_cmd "pvs" "Physical volumes" + log_cmd "vgs" "Volume groups" + log_cmd "lvs" "Logical volumes" + log_cmd "df -h $MOUNT_POINT" "Mount details" } # Run main function From 5c56e0f498ea9c5f5c1b3587c35866582c50c4f2 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 31 Jan 2025 11:18:11 -0500 Subject: [PATCH 113/303] already configured not failure state --- salt/storage/files/so-nsm-cleanup | 256 ++++++++++++++++++++++++++++++ salt/storage/files/so-nsm-mount | 95 +++++++---- 2 files changed, 319 insertions(+), 32 deletions(-) create mode 100644 salt/storage/files/so-nsm-cleanup diff --git a/salt/storage/files/so-nsm-cleanup b/salt/storage/files/so-nsm-cleanup new file mode 100644 index 000000000..f9af3aee8 --- /dev/null +++ b/salt/storage/files/so-nsm-cleanup @@ -0,0 +1,256 @@ +#!/bin/bash + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +# Usage: +# so-nsm-cleanup +# +# Options: +# None - script automatically detects and cleans NVMe devices +# +# Examples: +# 1. Clean NVMe devices and LVM configuration: +# ```bash +# sudo so-nsm-cleanup +# ``` +# +# Notes: +# - Requires root privileges +# - CAUTION: This script will destroy all data on NVMe devices +# - Removes: +# * /nsm mount point +# * LVM configuration +# * Partitions and signatures +# - Safe to run multiple times +# +# Description: +# This script cleans up NVMe devices and LVM configuration to prepare +# for testing so-nsm-mount. It performs these steps: +# +# 1. Safety Checks: +# - Verifies root privileges +# - Detects NVMe devices +# - Warns about data loss +# +# 2. Cleanup Operations: +# - Unmounts and removes /nsm +# - Removes LVM configuration +# - Cleans partitions and signatures +# - Zeros out partition tables +# +# Exit Codes: +# 0: Success - cleanup completed +# 1: Error conditions: +# - Must be run as root +# - No NVMe devices found +# - Cleanup operation failed +# +# Logging: +# - All operations logged to both console and /opt/so/log/so-nsm-cleanup.log + +set -e + +LOG_FILE="/opt/so/log/so-nsm-cleanup.log" +MOUNT_POINT="/nsm" +VG_NAME="system" +LV_NAME="nsm" + +# Function to log messages +log() { + local msg="$(date '+%Y-%m-%d %H:%M:%S') $1" + echo "$msg" | tee -a "$LOG_FILE" +} + +# Function to log command output +log_cmd() { + local cmd="$1" + local output + output=$($cmd 2>&1) + if [ -n "$output" ]; then + log "$2:" + echo "$output" | while IFS= read -r line; do + log " $line" + done + fi +} + +# Function to check if running as root +check_root() { + if [ "$EUID" -ne 0 ]; then + log "Error: Failed to execute - script must be run as root" + exit 1 + fi +} + +# Function to detect NVMe devices +detect_nvme_devices() { + local -a devices=() + + { + log "----------------------------------------" + log "Starting NVMe device detection" + log "----------------------------------------" + + # Get list of NVMe devices + while read -r dev; do + if [[ -b "$dev" ]]; then + devices+=("$dev") + fi + done < <(find /dev -name 'nvme*n1' 2>/dev/null) + + if [ ${#devices[@]} -eq 0 ]; then + log "Error: No NVMe devices found" + log "----------------------------------------" + exit 1 + fi + + log "Found ${#devices[@]} NVMe device(s):" + for dev in "${devices[@]}"; do + local size=$(lsblk -dbn -o SIZE "$dev" 2>/dev/null | numfmt --to=iec) + log " - $dev ($size)" + done + log "----------------------------------------" + } >&2 + + # Only output device paths to stdout + printf '%s\n' "${devices[@]}" +} + +# Function to cleanup mount point +cleanup_mount() { + log "Cleaning up mount point $MOUNT_POINT" + + if mountpoint -q "$MOUNT_POINT" 2>/dev/null; then + log " Unmounting $MOUNT_POINT" + if ! umount "$MOUNT_POINT" 2>/dev/null; then + log " WARNING: Failed to unmount $MOUNT_POINT" + return 1 + fi + log " Successfully unmounted" + else + log " Not mounted - skipping unmount" + fi + + if [[ -d "$MOUNT_POINT" ]]; then + log " Removing directory" + rm -rf "$MOUNT_POINT" + log " Directory removed" + fi + + return 0 +} + +# Function to cleanup LVM +cleanup_lvm() { + log "Cleaning up LVM configuration" + + # Remove logical volume if it exists + if lvs "$VG_NAME/$LV_NAME" &>/dev/null; then + log " Removing logical volume $VG_NAME/$LV_NAME" + if ! lvremove -f "$VG_NAME/$LV_NAME" 2>/dev/null; then + log " WARNING: Failed to remove logical volume" + else + log " Logical volume removed" + fi + fi + + # Remove volume group if it exists + if vgs "$VG_NAME" &>/dev/null; then + log " Removing volume group $VG_NAME" + if ! vgremove -f "$VG_NAME" 2>/dev/null; then + log " WARNING: Failed to remove volume group" + else + log " Volume group removed" + fi + fi +} + +# Function to cleanup a device +cleanup_device() { + local device=$1 + + if [[ ! -b "$device" ]]; then + log "ERROR: Invalid device path: $device" + return 1 + fi + + local size=$(lsblk -dbn -o SIZE "$device" 2>/dev/null | numfmt --to=iec) + log "Processing device: $device ($size)" + + # Remove physical volume if it exists + if pvs "$device" &>/dev/null; then + log " Removing physical volume" + if ! pvremove -ff -y "$device" 2>/dev/null; then + log " WARNING: Failed to remove physical volume" + else + log " Physical volume removed" + fi + fi + + # Clean all signatures and partitions + log " Cleaning signatures and partitions" + if ! wipefs -a "$device" 2>/dev/null; then + log " WARNING: Failed to clean signatures" + else + log " Signatures cleaned" + fi + + # Zero out partition table + log " Zeroing partition table" + if ! dd if=/dev/zero of="$device" bs=1M count=10 status=none; then + log " WARNING: Failed to zero partition table" + else + log " Partition table zeroed" + fi + + log " Device cleanup completed" +} + +# Main function +main() { + check_root + + log "Starting NVMe device cleanup" + log "WARNING: This will destroy all data on NVMe devices!" + log "" + + # Log initial system state + log "Initial system state:" + log_cmd "lsblk" "Block devices" + log_cmd "pvs" "Physical volumes" + log_cmd "vgs" "Volume groups" + log_cmd "lvs" "Logical volumes" + log "" + + # Clean up mount point + cleanup_mount + + # Clean up LVM configuration + cleanup_lvm + + # Detect and clean up devices + local -a devices=() + mapfile -t devices < <(detect_nvme_devices) + + log "Starting device cleanup" + for device in "${devices[@]}"; do + cleanup_device "$device" + done + + # Log final system state + log "" + log "Final system state:" + log_cmd "lsblk" "Block devices" + log_cmd "pvs" "Physical volumes" + log_cmd "vgs" "Volume groups" + log_cmd "lvs" "Logical volumes" + + log "" + log "Cleanup completed successfully" +} + +# Run main function +main "$@" diff --git a/salt/storage/files/so-nsm-mount b/salt/storage/files/so-nsm-mount index 9a2d00d88..ab8e0a0f0 100644 --- a/salt/storage/files/so-nsm-mount +++ b/salt/storage/files/so-nsm-mount @@ -159,16 +159,7 @@ check_lvm_config() { if lvs "$VG_NAME/$LV_NAME" &>/dev/null; then # Log LV details log_cmd "lvs --noheadings -o lv_name,lv_size,lv_path $VG_NAME/$LV_NAME" "Logical volume details" - - # Check mount status - if mountpoint -q "$MOUNT_POINT"; then - log_cmd "df -h $MOUNT_POINT" "Current mount details" - else - log "Found existing LVM configuration. Remounting $MOUNT_POINT" - log_cmd "grep -P \"^/dev/$VG_NAME/$LV_NAME\\s\" /etc/fstab" "Existing fstab entry" - mount "$MOUNT_POINT" - fi - exit 0 + return 0 fi fi @@ -251,8 +242,7 @@ validate_device_state() { if [[ "$vg" == "$VG_NAME" ]]; then if lvs "$VG_NAME/$LV_NAME" &>/dev/null; then log "Device $device is already properly configured in VG $VG_NAME" - log "Skipping device" - return 1 + return 0 fi fi fi @@ -295,6 +285,7 @@ log_device_details() { detect_nvme_devices() { local -a devices=() local -a available_devices=() + local -a configured_devices=() { log "----------------------------------------" @@ -321,14 +312,35 @@ detect_nvme_devices() { log_device_details "$dev" if validate_device_state "$dev"; then - available_devices+=("$dev") - log "Status: Available for use" + if pvs "$dev" &>/dev/null; then + local vg=$(pvs --noheadings -o vg_name "$dev" | tr -d ' ') + if [[ "$vg" == "$VG_NAME" ]]; then + configured_devices+=("$dev") + log "Status: Already configured in VG $VG_NAME" + else + available_devices+=("$dev") + log "Status: Available for use" + fi + else + available_devices+=("$dev") + log "Status: Available for use" + fi else log "Status: Not available (see previous messages)" fi log "----------------------------------------" done + if [ ${#configured_devices[@]} -gt 0 ]; then + log "Found ${#configured_devices[@]} device(s) already configured:" + for dev in "${configured_devices[@]}"; do + local size=$(lsblk -dbn -o SIZE "$dev" 2>/dev/null | numfmt --to=iec) + log " - $dev ($size)" + done + log "Proceeding with mount setup" + return 0 + fi + if [ ${#available_devices[@]} -eq 0 ]; then log_error "No available NVMe devices found" log "----------------------------------------" @@ -556,6 +568,15 @@ setup_filesystem() { exit 1 fi + # Check for existing /nsm directory + if [[ -d "$MOUNT_POINT" ]]; then + log "WARNING: $MOUNT_POINT directory already exists" + if [[ -n "$(ls -A "$MOUNT_POINT")" ]]; then + log "WARNING: $MOUNT_POINT is not empty" + log "Contents will be hidden when mounted" + fi + fi + # Check filesystem type - don't fail if blkid fails local fs_type fs_type=$(blkid -o value -s TYPE "$device" 2>/dev/null || echo "none") @@ -684,27 +705,37 @@ main() { log_cmd "vgs" "Volume groups" log_cmd "lvs" "Logical volumes" - # Detect NVMe devices - local -a devices=() - mapfile -t devices < <(detect_nvme_devices) - - if [ ${#devices[@]} -eq 0 ]; then - log_error "No NVMe devices available for use" - exit 1 - fi + # Check if LVM is already configured + if vgs "$VG_NAME" &>/dev/null && lvs "$VG_NAME/$LV_NAME" &>/dev/null; then + log "Found existing LVM configuration" + log "Proceeding with filesystem setup" + else + # Detect NVMe devices + local -a devices=() + mapfile -t devices < <(detect_nvme_devices) + + if [ ${#devices[@]} -eq 0 ]; then + log_error "No NVMe devices found" + exit 1 + fi - # Prepare devices and get list of successfully prepared ones - local -a prepared_devices=() - mapfile -t prepared_devices < <(prepare_devices "${devices[@]}") - - if [ ${#prepared_devices[@]} -eq 0 ]; then - log_error "No devices were successfully prepared" - exit 1 + # Prepare devices and get list of successfully prepared ones + local -a prepared_devices=() + mapfile -t prepared_devices < <(prepare_devices "${devices[@]}") + + if [ ${#prepared_devices[@]} -eq 0 ]; then + if vgs "$VG_NAME" &>/dev/null && lvs "$VG_NAME/$LV_NAME" &>/dev/null; then + log "Devices already configured, proceeding with filesystem setup" + else + log_error "No devices were successfully prepared and no existing configuration found" + exit 1 + fi + else + # Setup LVM with prepared devices + setup_lvm "${prepared_devices[@]}" + fi fi - # Setup LVM with prepared devices - setup_lvm "${prepared_devices[@]}" - # Create and mount filesystem setup_filesystem From 0114e36cfa229ecbb59d1a676220bf3be1968e1d Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 31 Jan 2025 15:17:54 -0500 Subject: [PATCH 114/303] set lvm = system uuid and only sanitize new nvme if doesnt belong to current vm --- salt/storage/files/so-nsm-mount | 360 ++++++++++++++++++++++++++------ 1 file changed, 300 insertions(+), 60 deletions(-) diff --git a/salt/storage/files/so-nsm-mount b/salt/storage/files/so-nsm-mount index ab8e0a0f0..63cb810ec 100644 --- a/salt/storage/files/so-nsm-mount +++ b/salt/storage/files/so-nsm-mount @@ -36,6 +36,12 @@ # This script automates the configuration and mounting of NVMe devices # as /nsm in Security Onion virtual machines. It performs these steps: # +# Dependencies: +# - dmidecode: Required for getting system UUID +# - nvme-cli: Required for NVMe secure erase operations +# - lvm2: Required for LVM operations +# - xfsprogs: Required for XFS filesystem operations +# # 1. Safety Checks: # - Verifies root privileges # - Checks if /nsm is already mounted @@ -76,20 +82,18 @@ set -e LOG_FILE="/opt/so/log/so-nsm-mount.log" -VG_NAME="system" +VG_NAME="" LV_NAME="nsm" MOUNT_POINT="/nsm" # Function to log messages log() { - local msg="$(date '+%Y-%m-%d %H:%M:%S') $1" - echo "$msg" | tee -a "$LOG_FILE" >&2 + echo "$(date '+%Y-%m-%d %H:%M:%S') $1" | tee -a "$LOG_FILE" >&2 } # Function to log errors log_error() { - local msg="$(date '+%Y-%m-%d %H:%M:%S') ERROR: $1" - echo "$msg" | tee -a "$LOG_FILE" >&2 + echo "$(date '+%Y-%m-%d %H:%M:%S') ERROR: $1" | tee -a "$LOG_FILE" >&2 } # Function to log command output @@ -97,23 +101,85 @@ log_cmd() { local cmd="$1" local desc="$2" local output + local ret=0 - # Use eval to properly handle shell operators - output=$(eval "$cmd" 2>&1) || { - local ret=$? - log_error "Command failed with exit code $ret: $cmd" - echo "$output" | while IFS= read -r line; do - log " $line" - done - return $ret - } + output=$(eval "$cmd" 2>&1) || ret=$? if [ -n "$output" ]; then log "$desc:" - echo "$output" | while IFS= read -r line; do - log " $line" + printf '%s\n' "$output" | sed 's/^/ /' | while IFS= read -r line; do + log "$line" done fi + + [ $ret -eq 0 ] || log_error "Command failed with exit code $ret: $cmd" + return $ret +} + +# Get system UUID for unique VG naming +get_system_uuid() { + local uuid + + if ! uuid=$(dmidecode -s system-uuid 2>/dev/null); then + log_error "Failed to get system UUID" + exit 1 + fi + + # Just convert hyphens to underscores + echo "${uuid//-/_}" +} + +# Convert VG name back to UUID format +vg_name_to_uuid() { + local vg=$1 + # Just convert underscores back to hyphens + echo "$vg" | tr '_' '-' +} + +# Function to perform secure erase of NVMe device +secure_erase_nvme() { + local device=$1 + local ret=0 + local retry=3 + + log "Performing secure erase of NVMe device $device" + + if [[ ! "$device" =~ ^/dev/nvme[0-9]+n[0-9]+$ ]]; then + log_error "Device $device is not an NVMe device" + return 1 + fi + + # Check if device is mounted + if mountpoint -q "$device" || findmnt -n | grep -q "$device"; then + log_error "Device $device is mounted, cannot secure erase" + return 1 + fi + + # Attempt secure erase with retries + while [ $retry -gt 0 ]; do + log " Executing secure erase command (attempt $((4-retry))/3)" + if nvme format "$device" --namespace-id 1 --ses 1 --lbaf 0 --force 2>nvme.err; then + log " Success: Secure erase completed" + rm -f nvme.err + return 0 + fi + + # Check error type + if grep -q "Device or resource busy" nvme.err; then + log " Device busy, waiting before retry" + sleep 3 + else + log_error "Secure erase failed" + log " Details: $(cat nvme.err)" + rm -f nvme.err + return 1 + fi + + retry=$((retry - 1)) + done + + log_error "Failed to secure erase device after 3 attempts" + return 1 } # Function to check if running as root @@ -151,6 +217,13 @@ check_lvm_config() { return 0 fi + # Safety check - never touch system VGs + if is_system_vg "$vg_name"; then + log_error "Device $device is part of system VG: $vg_name" + log "Cannot modify system volume groups. Aborting." + exit 1 + fi + # Log VG details log_cmd "vgs --noheadings -o vg_name,vg_size,vg_free,pv_count $vg_name" "Volume group details" @@ -184,47 +257,185 @@ check_lvm_config() { exit 1 } -# Function to cleanup device -cleanup_device() { +# Function to check if VG is system critical +is_system_vg() { + local vg=$1 + local root_dev + local root_vg + local mp + local dev + + # First check if it's the current root VG + root_dev=$(findmnt -n -o SOURCE /) + if [ -n "$root_dev" ]; then + # Get VG name from root device + if lvs --noheadings -o vg_name "$root_dev" 2>/dev/null | grep -q "^$vg$"; then + return 0 # true + fi + fi + + # Check all mounted LVM devices + while read -r mp; do + # Skip our NSM mount + [ "$mp" = "$MOUNT_POINT" ] && continue + + # Check if mount uses this VG + if lvs --noheadings -o vg_name "$mp" 2>/dev/null | grep -q "^$vg$"; then + return 0 # true + fi + done < <(findmnt -n -o SOURCE -t ext4,xfs,btrfs,swap | grep "/dev/mapper/") + + # Check if VG contains any mounted devices + while read -r dev; do + if [ -n "$dev" ] && findmnt -n | grep -q "$dev"; then + return 0 # true + fi + done < <(lvs "/dev/$vg" --noheadings -o lv_path 2>/dev/null) + + # Check if VG contains critical LV names + if lvs "/dev/$vg" &>/dev/null; then + if lvs --noheadings -o lv_name "/dev/$vg" 2>/dev/null | grep -qE '^(root|swap|home|var|usr|tmp|opt|srv|boot)$'; then + return 0 # true + fi + fi + + # Check if VG has common system names + if [[ "$vg" =~ ^(vg_main|system|root|os|rhel|centos|ubuntu|debian|fedora)$ ]]; then + return 0 # true + fi + + return 1 # false +} + +# Function to deactivate LVM on device +deactivate_lvm() { local device=$1 + local vg=$2 + local ret=0 + local retry=3 - log "Cleaning up device $device" - - # Check if device is mounted - if mountpoint -q "$device"; then - log " Device is mounted, attempting unmount" - if ! umount "$device" 2>/dev/null; then - log_error "Failed to unmount device" - return 1 - fi - fi - - # Remove LVM configs if they exist - if pvs "$device" &>/dev/null; then - local vg=$(pvs --noheadings -o vg_name "$device" | tr -d ' ') - if [[ -n "$vg" && "$vg" != "$VG_NAME" ]]; then - log " Removing device from volume group $vg" - if ! vgreduce "$vg" "$device" 2>/dev/null; then - log_error "Failed to remove from volume group" - return 1 - fi - fi - log " Removing physical volume" - if ! pvremove -ff -y "$device" 2>/dev/null; then - log_error "Failed to remove physical volume" - return 1 - fi - fi - - # Remove partitions and signatures - log " Removing partitions and signatures" - if ! wipefs -a "$device" 2>/dev/null; then - log_error "Failed to remove signatures" + # Safety check - never touch system VGs + if is_system_vg "$vg"; then + log_error "Refusing to deactivate system VG: $vg" return 1 fi - log " Device cleanup successful" - return 0 + log " Deactivating LVM on device $device (VG: $vg)" + + # Get list of LVs that specifically use this device + local lvs_to_deactivate + lvs_to_deactivate=$(pvs --noheadings -o vg_name,lv_name "$device" 2>/dev/null | awk '{print $1"/"$2}') + + # Deactivate only LVs that use this device + if [ -n "$lvs_to_deactivate" ]; then + log " Deactivating logical volumes on device" + while read -r lv; do + if [ -n "$lv" ]; then + log " Deactivating: $lv" + if ! lvchange -an "/dev/$lv" 2>/dev/null; then + log " WARNING: Failed to deactivate $lv" + fi + fi + done <<< "$lvs_to_deactivate" + fi + + # Give it a moment to settle + sleep 2 + + # Try to reduce VG with retries + log " Removing device from volume group $vg" + while [ $retry -gt 0 ]; do + if vgreduce -f "$vg" "$device" 2>/dev/null; then + break + fi + log " WARNING: Failed to remove from VG, retrying... ($retry attempts left)" + retry=$((retry - 1)) + sleep 2 + done + + # If retries failed, try force removal + if [ $retry -eq 0 ]; then + log " WARNING: Failed normal removal, attempting forced cleanup" + if ! vgreduce --removemissing --force "$vg" 2>/dev/null; then + log_error "Failed to remove device from VG even with force" + ret=1 + fi + fi + + # Only remove PV if device is fully removed from VG + if ! pvs --noheadings -o vg_name "$device" | grep -q "[A-Za-z0-9]"; then + log " Removing physical volume" + if ! pvremove -ff -y "$device" 2>/dev/null; then + log_error "Failed to remove physical volume" + ret=1 + fi + else + log " WARNING: Device still part of VG, skipping PV removal" + fi + + return $ret +} + +# Function to cleanup device +cleanup_device() { + local device=$1 + local ret=0 + + log "Cleaning up device $device" + + # Check if device belongs to current system + if pvs "$device" &>/dev/null; then + local vg=$(pvs --noheadings -o vg_name "$device" | tr -d ' ') + local current_vg=$(get_system_uuid) + local vg_uuid="" + local current_uuid="" + + if [[ -n "$vg" ]]; then + # Convert VG names to UUIDs for comparison + vg_uuid=$(vg_name_to_uuid "$vg") + current_uuid=$(vg_name_to_uuid "$current_vg") + + if [[ "$vg_uuid" == "$current_uuid" ]]; then + log " Device belongs to current system, skipping secure erase" + else + log " Device belongs to different system (VG: $vg)" + + # First deactivate LVM + if ! deactivate_lvm "$device" "$vg"; then + log_error "Failed to fully deactivate LVM" + ret=1 + fi + + # Attempt secure erase even if LVM cleanup had issues + log " Performing secure erase" + if ! secure_erase_nvme "$device"; then + log_error "Failed to secure erase device" + ret=1 + fi + fi + fi + else + # No LVM configuration found, perform secure erase + log " No LVM configuration found, performing secure erase" + if ! secure_erase_nvme "$device"; then + log_error "Failed to secure erase device" + ret=1 + fi + fi + + # Always attempt to remove partitions and signatures + log " Removing partitions and signatures" + if ! wipefs -a "$device" 2>/dev/null; then + log_error "Failed to remove signatures" + ret=1 + fi + + if [ $ret -eq 0 ]; then + log " Device cleanup successful" + else + log_error "Device cleanup had some issues" + fi + return $ret } # Function to validate device state @@ -239,9 +450,21 @@ validate_device_state() { # Check if device is already properly configured if pvs "$device" &>/dev/null; then local vg=$(pvs --noheadings -o vg_name "$device" | tr -d ' ') - if [[ "$vg" == "$VG_NAME" ]]; then - if lvs "$VG_NAME/$LV_NAME" &>/dev/null; then - log "Device $device is already properly configured in VG $VG_NAME" + + # Safety check - never touch system VGs + if is_system_vg "$vg"; then + log_error "Device $device is part of system VG: $vg" + log "Cannot modify system volume groups. Aborting." + return 1 + fi + + # Convert VG names to UUIDs for comparison + local vg_uuid=$(vg_name_to_uuid "$vg") + local current_uuid=$(vg_name_to_uuid "$VG_NAME") + + if [[ "$vg_uuid" == "$current_uuid" ]]; then + if lvs "$vg/$LV_NAME" &>/dev/null; then + log "Device $device is already properly configured in VG $vg" return 0 fi fi @@ -249,6 +472,12 @@ validate_device_state() { # Check for existing partitions or LVM if pvs "$device" &>/dev/null || lsblk -no TYPE "$device" | grep -q "part"; then + # Check if device is mounted as root filesystem + if mountpoint -q / && findmnt -n -o SOURCE / | grep -q "$device"; then + log_error "Device $device contains root filesystem. Aborting." + return 1 + fi + log "Device $device has existing configuration" if ! cleanup_device "$device"; then log "Failed to cleanup device $device" @@ -314,9 +543,12 @@ detect_nvme_devices() { if validate_device_state "$dev"; then if pvs "$dev" &>/dev/null; then local vg=$(pvs --noheadings -o vg_name "$dev" | tr -d ' ') - if [[ "$vg" == "$VG_NAME" ]]; then + local vg_uuid=$(vg_name_to_uuid "$vg") + local current_uuid=$(vg_name_to_uuid "$VG_NAME") + + if [[ "$vg_uuid" == "$current_uuid" ]]; then configured_devices+=("$dev") - log "Status: Already configured in VG $VG_NAME" + log "Status: Already configured in VG $vg" else available_devices+=("$dev") log "Status: Available for use" @@ -531,7 +763,8 @@ setup_lvm() { log " Name: $LV_NAME" log " Size: 100% of free space" - if ! lvcreate -l 100%FREE -n "$LV_NAME" "$VG_NAME" 2>lv.err; then + # Create LV with yes flag + if ! lvcreate -l 100%FREE -n "$LV_NAME" "$VG_NAME" -y 2>lv.err; then log_error "Logical volume creation failed" log " Details: $(cat lv.err)" rm -f lv.err @@ -582,14 +815,18 @@ setup_filesystem() { fs_type=$(blkid -o value -s TYPE "$device" 2>/dev/null || echo "none") log " Current filesystem type: ${fs_type:-none}" - # Create XFS filesystem if needed + # Create XFS filesystem if needed log "Step 2: Filesystem preparation" if [[ "$fs_type" != "xfs" ]]; then log " Creating new XFS filesystem:" log " Device: $device" log " Options: -f (force)" - if ! mkfs.xfs -f "$device" 2>mkfs.err; then + # Clean any existing signatures first + wipefs -a "$device" 2>/dev/null || true + + # Create filesystem with force flag + if ! mkfs.xfs -f "$device" -K -q 2>mkfs.err; then log_error "XFS filesystem creation failed" log " Details: $(cat mkfs.err)" rm -f mkfs.err @@ -689,6 +926,9 @@ setup_filesystem() { # Main function main() { check_root + + # Set VG_NAME based on system UUID + VG_NAME=$(get_system_uuid) # Check if already mounted if mountpoint -q "$MOUNT_POINT"; then From 65c5abfa88f403b7a0e699b5f328ae4179aab4fa Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 31 Jan 2025 16:15:46 -0500 Subject: [PATCH 115/303] add note regarding possible missing devices --- salt/storage/files/so-nsm-mount | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/salt/storage/files/so-nsm-mount b/salt/storage/files/so-nsm-mount index 63cb810ec..c4b9e2360 100644 --- a/salt/storage/files/so-nsm-mount +++ b/salt/storage/files/so-nsm-mount @@ -938,12 +938,24 @@ main() { exit 0 fi - # Log initial system state - log "Initial system state:" + # Log initial system state with context + log "----------------------------------------" + log "Checking initial system state" + log "NOTE: If any drives were previously used in another system, you may see" + log " warnings about missing devices or volume groups below. These warnings" + log " are normal and expected when reusing drives. They indicate the drive" + log " was part of a previous system's configuration and will be automatically" + log " cleaned up in the following steps." + log "----------------------------------------" + log_cmd "lsblk" "Block devices" log_cmd "pvs" "Physical volumes" log_cmd "vgs" "Volume groups" log_cmd "lvs" "Logical volumes" + + log "----------------------------------------" + log "Proceeding with cleanup of any previous configurations and setup for /nsm" + log "----------------------------------------" # Check if LVM is already configured if vgs "$VG_NAME" &>/dev/null && lvs "$VG_NAME/$LV_NAME" &>/dev/null; then From a3013ff85b8f4417898fa08f0ae21f2169b91940 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 31 Jan 2025 16:36:51 -0500 Subject: [PATCH 116/303] simplify the LVM deactivation process by removing unnecessary VG removal attempts --- salt/storage/files/so-nsm-mount | 39 ++------------------------------- 1 file changed, 2 insertions(+), 37 deletions(-) diff --git a/salt/storage/files/so-nsm-mount b/salt/storage/files/so-nsm-mount index c4b9e2360..24125fc40 100644 --- a/salt/storage/files/so-nsm-mount +++ b/salt/storage/files/so-nsm-mount @@ -311,8 +311,6 @@ is_system_vg() { deactivate_lvm() { local device=$1 local vg=$2 - local ret=0 - local retry=3 # Safety check - never touch system VGs if is_system_vg "$vg"; then @@ -339,41 +337,8 @@ deactivate_lvm() { done <<< "$lvs_to_deactivate" fi - # Give it a moment to settle - sleep 2 - - # Try to reduce VG with retries - log " Removing device from volume group $vg" - while [ $retry -gt 0 ]; do - if vgreduce -f "$vg" "$device" 2>/dev/null; then - break - fi - log " WARNING: Failed to remove from VG, retrying... ($retry attempts left)" - retry=$((retry - 1)) - sleep 2 - done - - # If retries failed, try force removal - if [ $retry -eq 0 ]; then - log " WARNING: Failed normal removal, attempting forced cleanup" - if ! vgreduce --removemissing --force "$vg" 2>/dev/null; then - log_error "Failed to remove device from VG even with force" - ret=1 - fi - fi - - # Only remove PV if device is fully removed from VG - if ! pvs --noheadings -o vg_name "$device" | grep -q "[A-Za-z0-9]"; then - log " Removing physical volume" - if ! pvremove -ff -y "$device" 2>/dev/null; then - log_error "Failed to remove physical volume" - ret=1 - fi - else - log " WARNING: Device still part of VG, skipping PV removal" - fi - - return $ret + # No need to attempt VG removal - secure erase will handle it + return 0 } # Function to cleanup device From c8e232c59862461aabc55ebc8e8175b73c6a179c Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Mon, 3 Feb 2025 12:20:34 -0500 Subject: [PATCH 117/303] cloudinit network config out of user-data. default 220G disk --- salt/_runners/setup_hypervisor.py | 35 +++++++++++++++++-------------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 81dfd08f4..c51166133 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -10,8 +10,7 @@ # software that is protected by the license key." """ -TODO: Change default disk_size from 6G to 220G. this was set to speed up vm start during development - Remove passwd hash prior to release. used for development +TODO: Remove passwd hash prior to release. used for development This runner performs the initial setup required for hypervisor hosts in the Security Onion environment. It handles downloading the Oracle Linux KVM image, setting up SSH keys for secure communication, @@ -22,11 +21,11 @@ Usage: Options: vm_name: Name for the virtual machine (alphanumeric, hyphens, underscores) - disk_size: Size of the VM disk with unit (e.g., '6G', '300G') + disk_size: Size of the VM disk with unit (e.g., '220G', '300G') minion_id: Salt minion ID of the hypervisor (optional) Examples: - # Complete environment setup (default VM 'sool9' with 6G disk) + # Complete environment setup (default VM 'sool9' with 220G disk) salt-run setup_hypervisor.setup_environment # Setup with custom VM name and disk size @@ -325,7 +324,8 @@ def _check_vm_exists(vm_name: str) -> bool: vm_image, cidata_iso, os.path.join(vm_dir, 'meta-data'), - os.path.join(vm_dir, 'user-data') + os.path.join(vm_dir, 'user-data'), + os.path.join(vm_dir, 'network-data') ] exists = all(os.path.exists(f) for f in required_files) @@ -333,7 +333,7 @@ def _check_vm_exists(vm_name: str) -> bool: log.info("MAIN: VM %s already exists", vm_name) return exists -def setup_environment(vm_name: str = 'sool9', disk_size: str = '6G', minion_id: str = None): +def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id: str = None): """ Main entry point to set up the hypervisor environment. @@ -345,8 +345,8 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '6G', minion_id: vm_name (str, optional): Name for the VM to create. Must contain only alphanumeric characters, hyphens, or underscores. Defaults to 'sool9'. - disk_size (str, optional): Size of the VM disk with unit (e.g., '6G', '300G'). - Must end with 'G' or 'M'. Defaults to '6G'. + disk_size (str, optional): Size of the VM disk with unit (e.g., '220G', '300G'). + Must end with 'G' or 'M'. Defaults to '220G'. minion_id (str, optional): Salt minion ID of the hypervisor. When provided, forces the hypervisor to apply its configuration via highstate after successful environment setup (image @@ -454,7 +454,7 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '6G', minion_id: 'vm_result': vm_result } -def create_vm(vm_name: str, disk_size: str = '6G'): +def create_vm(vm_name: str, disk_size: str = '220G'): """ Creates a new virtual machine with cloud-init configuration. @@ -465,8 +465,8 @@ def create_vm(vm_name: str, disk_size: str = '6G'): Args: vm_name (str): Name for the VM. Must contain only alphanumeric characters, hyphens, or underscores. - disk_size (str): Size of the VM disk with unit (e.g., '6G', '300G'). - Must end with 'G' or 'M'. Defaults to '6G'. + disk_size (str): Size of the VM disk with unit (e.g., '220G', '300G'). + Must end with 'G' or 'M'. Defaults to '220G'. Returns: dict: A dictionary containing: @@ -558,6 +558,13 @@ local-hostname: {vm_name} with salt.utils.files.fopen(meta_data_path, 'w') as f: f.write(meta_data) + # Create network-data + network_data = """network: + config: disabled""" + network_data_path = os.path.join(vm_dir, 'network-data') + with salt.utils.files.fopen(network_data_path, 'w') as f: + f.write(network_data) + # Create user-data user_data = f"""#cloud-config preserve_hostname: False @@ -586,10 +593,6 @@ ssh_genkeytypes: ['ed25519', 'rsa'] # set timezone for VM timezone: UTC -# Disable cloud-init network configuration to prevent conflicts with NetworkManager -network: - config: disabled - write_files: - path: /etc/yum.repos.d/securityonion.repo content: | @@ -723,7 +726,7 @@ power_state: # Create cloud-init ISO cidata_iso = os.path.join(vm_dir, f'{vm_name}-cidata.iso') subprocess.run(['mkisofs', '-output', cidata_iso, '-volid', 'CIDATA', '-rock', - user_data_path, meta_data_path], + user_data_path, meta_data_path, network_data_path], check=True, capture_output=True) # Generate SHA256 hash of the qcow2 image From 71596783854915e5d9dad95e106f9b75f87cfa35 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 6 Feb 2025 15:30:46 -0500 Subject: [PATCH 118/303] create predicatble interfaces --- salt/_modules/qcow2.py | 8 +- .../tools/sbin/so-qcow2-modify-network | 193 ++++++++- .../tools/sbin/so-qcow2-network-predictable | 378 ++++++++++++++++++ salt/hypervisor/tools/sbin/so-wait-cloud-init | 206 ++++++++++ salt/libvirt/images/init.sls | 17 +- salt/manager/tools/sbin/so-salt-cloud | 2 +- .../cloud/cloud.profiles.d/socloud.conf.jinja | 2 +- salt/setup/virt/fleet.yaml | 2 +- salt/setup/virt/heavynode.yaml | 2 +- salt/setup/virt/idh.yaml | 2 +- salt/setup/virt/receiver.yaml | 2 +- salt/setup/virt/searchnode.yaml | 2 +- salt/setup/virt/sensor.yaml | 2 +- 13 files changed, 792 insertions(+), 26 deletions(-) create mode 100644 salt/hypervisor/tools/sbin/so-qcow2-network-predictable create mode 100644 salt/hypervisor/tools/sbin/so-wait-cloud-init diff --git a/salt/_modules/qcow2.py b/salt/_modules/qcow2.py index d1de6756a..81a00ca66 100644 --- a/salt/_modules/qcow2.py +++ b/salt/_modules/qcow2.py @@ -38,7 +38,7 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, image Path to the QCOW2 image file that will be modified interface - Network interface name to configure (e.g., 'eth0') + Network interface name to configure (e.g., 'enp1s0') mode Network configuration mode, either 'dhcp4' or 'static4' ip4 @@ -57,13 +57,13 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, Examples: 1. **Configure DHCP:** ```bash - salt '*' qcow2.modify_network_config image='/nsm/libvirt/images/sool9/sool9.qcow2' interface='eth0' mode='dhcp4' + salt '*' qcow2.modify_network_config image='/nsm/libvirt/images/sool9/sool9.qcow2' interface='enp1s0' mode='dhcp4' ``` - This configures eth0 to use DHCP for IP assignment + This configures enp1s0 to use DHCP for IP assignment 2. **Configure Static IP:** ```bash - salt '*' qcow2.modify_network_config image='/nsm/libvirt/images/sool9/sool9.qcow2' interface='eth0' mode='static4' ip4='192.168.1.10/24' gw4='192.168.1.1' dns4='192.168.1.1,8.8.8.8' search4='example.local' + salt '*' qcow2.modify_network_config image='/nsm/libvirt/images/sool9/sool9.qcow2' interface='enp1s0' mode='static4' ip4='192.168.1.10/24' gw4='192.168.1.1' dns4='192.168.1.1,8.8.8.8' search4='example.local' ``` This sets a static IP configuration with DNS servers and search domain diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin/so-qcow2-modify-network index 5c0a9e9b7..5f0690542 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -14,6 +14,13 @@ The script offers two main configuration modes: 1. DHCP Configuration: Enable automatic IP address assignment 2. Static IP Configuration: Set specific IP address, gateway, DNS servers, and search domains +For both configuration modes, the script automatically sets the following NetworkManager connection properties: +- connection.autoconnect: yes (ensures interface connects automatically) +- connection.autoconnect-priority: 999 (sets connection priority) +- connection.autoconnect-retries: -1 (unlimited connection retries) +- connection.multi-connect: 0 (single connection mode) +- connection.wait-device-timeout: -1 (wait indefinitely for device) + This script is designed to work with Security Onion's virtualization infrastructure and is typically used during VM provisioning and network reconfiguration tasks. @@ -23,7 +30,7 @@ used during VM provisioning and network reconfiguration tasks. **Options:** -I, --image Path to the QCOW2 image. - -i, --interface Network interface to modify (e.g., eth0). + -i, --interface Network interface to modify (e.g., enp1s0). --dhcp4 Configure interface for DHCP (IPv4). --static4 Configure interface for static IPv4 settings. --ip4 IPv4 address (e.g., 192.168.1.10/24). Required for static IPv4 configuration. @@ -36,7 +43,7 @@ used during VM provisioning and network reconfiguration tasks. 1. **Static IP Configuration with DNS and Search Domain:** ```bash - so-qcow2-modify-network -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --static4 \ + so-qcow2-modify-network -I /nsm/libvirt/images/sool9/sool9.qcow2 -i enp1s0 --static4 \ --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1,192.168.1.2 --search4 example.local ``` @@ -50,7 +57,7 @@ used during VM provisioning and network reconfiguration tasks. 2. **DHCP Configuration:** ```bash - so-qcow2-modify-network -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --dhcp4 + so-qcow2-modify-network -I /nsm/libvirt/images/sool9/sool9.qcow2 -i enp1s0 --dhcp4 ``` This command configures the network interface to use DHCP for automatic IP address assignment. @@ -58,7 +65,7 @@ used during VM provisioning and network reconfiguration tasks. 3. **Static IP Configuration without DNS Settings:** ```bash - so-qcow2-modify-network -I /nsm/libvirt/images/sool9/sool9.qcow2 -i eth0 --static4 \ + so-qcow2-modify-network -I /nsm/libvirt/images/sool9/sool9.qcow2 -i enp1s0 --static4 \ --ip4 192.168.1.20/24 --gw4 192.168.1.1 ``` @@ -122,7 +129,9 @@ import logging import os import ipaddress import configparser +import uuid from io import StringIO +import libvirt from so_logging_utils import setup_logging # Set up logging using the so_logging_utils library @@ -154,33 +163,91 @@ def validate_interface_name(interface_name): if not re.match(r'^[a-zA-Z0-9_\-]+$', interface_name): raise ValueError(f"Invalid interface name: {interface_name}") -def update_ipv4_section(content, mode, ip=None, gateway=None, dns=None, search_domain=None): +def check_base_domain_status(image_path): + """ + Check if the base domain corresponding to the image path is currently running. + Base domains should not be running when modifying their configuration. + + Parameters: + image_path (str): Path to the QCOW2 image. + + Returns: + bool: True if the base domain is running, False otherwise. + """ + base_domain = os.path.basename(os.path.dirname(image_path)) + logger.info(f"Verifying base domain status for image: {image_path}") + logger.info(f"Checking if base domain '{base_domain}' is running...") + + try: + conn = libvirt.open('qemu:///system') + try: + dom = conn.lookupByName(base_domain) + is_running = dom.isActive() + if is_running: + logger.error(f"Base domain '{base_domain}' is running - cannot modify configuration") + return is_running + except libvirt.libvirtError: + logger.info(f"Base domain '{base_domain}' not found or not running") + return False + finally: + conn.close() + except libvirt.libvirtError as e: + logger.error(f"Failed to connect to libvirt: {e}") + return False + +def update_network_config(content, mode, ip=None, gateway=None, dns=None, search_domain=None): config = configparser.ConfigParser(strict=False) config.optionxform = str config.read_string(content) + # Ensure connection section exists and set required properties + if 'connection' not in config.sections(): + logger.info("Creating new connection section in network configuration") + config.add_section('connection') + + # Set mandatory connection properties + config.set('connection', 'autoconnect', 'yes') + config.set('connection', 'autoconnect-priority', '999') + config.set('connection', 'autoconnect-retries', '-1') + config.set('connection', 'multi-connect', '0') + config.set('connection', 'wait-device-timeout', '-1') + + # Ensure ipv4 section exists if 'ipv4' not in config.sections(): + logger.info("Creating new IPv4 section in network configuration") config.add_section('ipv4') if mode == "dhcp4": + logger.info("Configuring DHCP settings:") + logger.info(" method: auto (DHCP enabled)") + logger.info(" Removing any existing static configuration") config.set('ipv4', 'method', 'auto') config.remove_option('ipv4', 'address1') config.remove_option('ipv4', 'addresses') config.remove_option('ipv4', 'dns') config.remove_option('ipv4', 'dns-search') elif mode == "static4": + logger.info("Configuring static IP settings:") + logger.info(" method: manual (static configuration)") config.set('ipv4', 'method', 'manual') if ip and gateway: + logger.info(f" Setting address: {ip}") + logger.info(f" Setting gateway: {gateway}") config.set('ipv4', 'address1', f"{ip},{gateway}") else: + logger.error("Missing required IP address or gateway for static configuration") raise ValueError("Both IP address and gateway are required for static configuration.") if dns: + logger.info(f" Setting DNS servers: {dns}") config.set('ipv4', 'dns', f"{dns};") else: + logger.info(" No DNS servers specified") config.remove_option('ipv4', 'dns') if search_domain: + logger.info(f" Setting search domain: {search_domain}") config.set('ipv4', 'dns-search', f"{search_domain};") else: + logger.info(" No search domain specified") config.remove_option('ipv4', 'dns-search') else: raise ValueError(f"Invalid mode '{mode}'. Expected 'dhcp4' or 'static4'.") @@ -193,50 +260,138 @@ def update_ipv4_section(content, mode, ip=None, gateway=None, dns=None, search_d return updated_content def modify_network_config(image_path, interface, mode, ip=None, gateway=None, dns=None, search_domain=None): + """ + Modifies network configuration in a QCOW2 image, ensuring specific connection settings are set. + + Handles both eth0 and predictable network interface names (e.g., enp1s0). + If the requested interface configuration is not found but eth0.nmconnection exists, + it will be renamed and updated with the proper interface configuration. + """ + # Check if base domain is running + if check_base_domain_status(image_path): + raise RuntimeError("Cannot modify network configuration while base domain is running") + if not os.access(image_path, os.W_OK): + logger.error(f"Permission denied: Cannot write to image file {image_path}") raise PermissionError(f"Write permission denied for image file: {image_path}") + logger.info(f"Configuring network for VM image: {image_path}") + logger.info(f"Network configuration details for interface {interface}:") + logger.info(f" Mode: {mode.upper()}") + if mode == "static4": + logger.info(f" IP Address: {ip}") + logger.info(f" Gateway: {gateway}") + logger.info(f" DNS Servers: {dns if dns else 'Not configured'}") + logger.info(f" Search Domain: {search_domain if search_domain else 'Not configured'}") + g = guestfs.GuestFS(python_return_dict=True) try: + logger.info("Initializing GuestFS and mounting image...") g.set_network(False) g.selinux = False g.add_drive_opts(image_path, format="qcow2") g.launch() except RuntimeError as e: + logger.error(f"Failed to initialize GuestFS: {e}") raise RuntimeError(f"Failed to initialize GuestFS or launch appliance: {e}") try: os_list = g.inspect_os() if not os_list: + logger.error(f"No operating system found in image: {image_path}") raise RuntimeError(f"Unable to find any OS in {image_path}.") root_fs = os_list[0] try: g.mount(root_fs, "/") + logger.info("Successfully mounted VM image filesystem") except RuntimeError as e: + logger.error(f"Failed to mount filesystem: {e}") raise RuntimeError(f"Failed to mount the filesystem: {e}") if not g.is_dir(NETWORK_CONFIG_DIR): + logger.error(f"NetworkManager configuration directory not found: {NETWORK_CONFIG_DIR}") raise FileNotFoundError(f"NetworkManager configuration directory not found in the image at {NETWORK_CONFIG_DIR}.") - config_file_path = f"{NETWORK_CONFIG_DIR}/{interface}.nmconnection" + requested_config_path = f"{NETWORK_CONFIG_DIR}/{interface}.nmconnection" + eth0_config_path = f"{NETWORK_CONFIG_DIR}/eth0.nmconnection" + config_file_path = None + current_content = None + # Try to read the requested interface config first try: - file_content = g.read_file(config_file_path) + file_content = g.read_file(requested_config_path) current_content = file_content.decode('utf-8') + config_file_path = requested_config_path + logger.info(f"Found existing network configuration for interface {interface}") except RuntimeError: - raise FileNotFoundError(f"Configuration file for {interface} not found at {config_file_path}.") + # If not found, try eth0 config + try: + file_content = g.read_file(eth0_config_path) + current_content = file_content.decode('utf-8') + config_file_path = eth0_config_path + logger.info("Found eth0 network configuration, will update for new interface") + except RuntimeError: + logger.error(f"No network configuration found for either {interface} or eth0") + raise FileNotFoundError(f"No network configuration found at {requested_config_path} or {eth0_config_path}") except UnicodeDecodeError: - raise ValueError(f"Failed to decode the configuration file for {interface}.") + logger.error(f"Failed to decode network configuration file") + raise ValueError(f"Failed to decode the configuration file") - updated_content = update_ipv4_section(current_content, mode, ip, gateway, dns, search_domain) + # If using eth0 config, update interface-specific fields + if config_file_path == eth0_config_path: + config = configparser.ConfigParser(strict=False) + config.optionxform = str + config.read_string(current_content) + + if 'connection' not in config.sections(): + config.add_section('connection') + + # Update interface-specific fields + config.set('connection', 'id', interface) + config.set('connection', 'interface-name', interface) + config.set('connection', 'uuid', str(uuid.uuid4())) + + # Write updated content back to string + output = StringIO() + config.write(output, space_around_delimiters=False) + current_content = output.getvalue() + output.close() + + # Update config file path to new interface name + config_file_path = requested_config_path + + logger.info("Applying network configuration changes...") + updated_content = update_network_config(current_content, mode, ip, gateway, dns, search_domain) try: g.write(config_file_path, updated_content.encode('utf-8')) + # Set proper permissions (600) on the network configuration file + g.chmod(0o600, config_file_path) + logger.info("Successfully wrote updated network configuration with proper permissions (600)") + + # If we renamed eth0 to the new interface, remove the old eth0 config + if config_file_path == requested_config_path and eth0_config_path != requested_config_path: + try: + g.rm(eth0_config_path) + logger.info("Removed old eth0 configuration file") + except RuntimeError: + logger.warning("Could not remove old eth0 configuration file - it may have already been removed") + except RuntimeError as e: + logger.error(f"Failed to write network configuration: {e}") raise IOError(f"Failed to write updated configuration to {config_file_path}: {e}") - logger.info(f"Updated {interface} network configuration in {image_path} using {mode.upper()} mode.") + logger.info(f"Successfully updated network configuration:") + logger.info(f" Image: {image_path}") + logger.info(f" Interface: {interface}") + logger.info(f" Mode: {mode.upper()}") + if mode == "static4": + logger.info(f" Settings applied:") + logger.info(f" IP Address: {ip}") + logger.info(f" Gateway: {gateway}") + logger.info(f" DNS Servers: {dns if dns else 'Not configured'}") + logger.info(f" Search Domain: {search_domain if search_domain else 'Not configured'}") except Exception as e: raise e @@ -247,7 +402,7 @@ def modify_network_config(image_path, interface, mode, ip=None, gateway=None, dn def parse_arguments(): parser = argparse.ArgumentParser(description="Modify IPv4 settings in a QCOW2 image for a specified network interface.") parser.add_argument("-I", "--image", required=True, help="Path to the QCOW2 image.") - parser.add_argument("-i", "--interface", required=True, help="Network interface to modify (e.g., eth0).") + parser.add_argument("-i", "--interface", required=True, help="Network interface to modify (e.g., enp1s0).") group = parser.add_mutually_exclusive_group(required=True) group.add_argument("--dhcp4", action="store_true", help="Configure interface for DHCP (IPv4).") group.add_argument("--static4", action="store_true", help="Configure interface for static IPv4 settings.") @@ -265,30 +420,42 @@ def parse_arguments(): def main(): try: + logger.info("Starting network configuration update...") args = parse_arguments() + logger.info("Validating interface name...") validate_interface_name(args.interface) if args.dhcp4: mode = "dhcp4" + logger.info("Using DHCP configuration mode") elif args.static4: mode = "static4" + logger.info("Using static IP configuration mode") if not args.ip4 or not args.gw4: + logger.error("Missing required parameters for static configuration") raise ValueError("Both --ip4 and --gw4 are required for static IPv4 configuration.") + + logger.info("Validating IP addresses...") validate_ip_address(args.ip4, description="IPv4 address") validate_ip_address(args.gw4, description="IPv4 gateway") if args.dns4: validate_dns_addresses(args.dns4) else: + logger.error("No configuration mode specified") raise ValueError("Either --dhcp4 or --static4 must be specified.") modify_network_config(args.image, args.interface, mode, args.ip4, args.gw4, args.dns4, args.search4) + logger.info("Network configuration update completed successfully") except KeyboardInterrupt: logger.error("Operation cancelled by user.") sys.exit(1) except Exception as e: - logger.error(f"An error occurred: {e}") + if "base domain is running" in str(e): + logger.error("Cannot proceed: Base domain must not be running when modifying network configuration") + else: + logger.error(f"An error occurred: {e}") sys.exit(1) if __name__ == "__main__": diff --git a/salt/hypervisor/tools/sbin/so-qcow2-network-predictable b/salt/hypervisor/tools/sbin/so-qcow2-network-predictable new file mode 100644 index 000000000..9b09465b9 --- /dev/null +++ b/salt/hypervisor/tools/sbin/so-qcow2-network-predictable @@ -0,0 +1,378 @@ +#!/usr/bin/python3 + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +""" +Script for configuring network interface predictability in Security Onion VMs. +This script modifies the necessary files to ensure consistent network interface naming. + +The script performs the following operations: +1. Modifies the BLS entry to set net.ifnames=1 +2. Removes any existing persistent network rules +3. Updates GRUB configuration + +**Usage:** + so-qcow2-network-predictable -n [-I ] + +**Options:** + -n, --name Domain name of the VM to configure + -I, --image (Optional) Path to the QCOW2 image. If not provided, + defaults to /nsm/libvirt/images//.qcow2 + +**Examples:** + +1. **Configure using domain name:** + ```bash + so-qcow2-network-predictable -n sool9 + ``` + This command will: + - Use default image path: /nsm/libvirt/images/sool9/sool9.qcow2 + - Configure network interface predictability + +2. **Configure using custom image path:** + ```bash + so-qcow2-network-predictable -n sool9 -I /path/to/custom/image.qcow2 + ``` + This command will: + - Use the specified image path + - Configure network interface predictability + +**Notes:** +- The VM must not be running when executing this script +- Requires root privileges +- Will automatically find and modify the appropriate BLS entry +- Removes /etc/udev/rules.d/70-persistent-net.rules if it exists +- Updates GRUB configuration after changes + +**Exit Codes:** +- 0: Success +- 1: General error (invalid arguments, file operations, etc.) +- 2: VM is running +- 3: Required files not found +- 4: Permission denied + +**Logging:** +- Logs are written to /opt/so/log/hypervisor/so-qcow2-network-predictable.log +- Both file and console logging are enabled +- Log entries include: + - Timestamps + - Operation details + - Error messages + - Configuration changes +""" + +import argparse +import guestfs +import glob +import libvirt +import logging +import os +import re +import sys +from so_logging_utils import setup_logging + +# Set up logging +logger = setup_logging( + logger_name='so-qcow2-network-predictable', + log_file_path='/opt/so/log/hypervisor/so-qcow2-network-predictable.log', + log_level=logging.INFO, + format_str='%(asctime)s - %(levelname)s - %(message)s' +) + +def check_domain_status(domain_name): + """ + Check if the specified domain exists and is not running. + + Args: + domain_name (str): Name of the libvirt domain to check + + Returns: + bool: True if domain exists and is not running, False otherwise + + Raises: + RuntimeError: If domain is running or connection to libvirt fails + """ + try: + conn = libvirt.open('qemu:///system') + try: + dom = conn.lookupByName(domain_name) + is_running = dom.isActive() + if is_running: + logger.error(f"Domain '{domain_name}' is running - cannot modify configuration") + raise RuntimeError(f"Domain '{domain_name}' must not be running") + logger.info(f"Domain '{domain_name}' exists and is not running") + return True + except libvirt.libvirtError as e: + if "no domain with matching name" in str(e): + logger.error(f"Domain '{domain_name}' not found") + raise RuntimeError(f"Domain '{domain_name}' not found") + raise + finally: + conn.close() + except libvirt.libvirtError as e: + logger.error(f"Failed to connect to libvirt: {e}") + raise RuntimeError(f"Failed to connect to libvirt: {e}") + +def modify_bls_entry(g): + """ + Find and modify the BLS entry to set net.ifnames=1. + + Args: + g: Mounted guestfs handle + + Returns: + bool: True if successful, False if no changes needed + + Raises: + RuntimeError: If BLS entry cannot be found or modified + """ + bls_dir = "/boot/loader/entries" + logger.info(f"Checking BLS directory: {bls_dir}") + if g.is_dir(bls_dir): + logger.info("BLS directory exists") + else: + logger.info("Listing /boot contents:") + try: + boot_contents = g.ls("/boot") + logger.info(f"/boot contains: {boot_contents}") + if g.is_dir("/boot/loader"): + logger.info("Listing /boot/loader contents:") + loader_contents = g.ls("/boot/loader") + logger.info(f"/boot/loader contains: {loader_contents}") + except Exception as e: + logger.error(f"Error listing /boot contents: {e}") + raise RuntimeError(f"BLS directory not found: {bls_dir}") + + # Find BLS entry file + entries = g.glob_expand(f"{bls_dir}/*.conf") + logger.info(f"Found BLS entries: {entries}") + if not entries: + logger.error("No BLS entry files found") + raise RuntimeError("No BLS entry files found") + + # Use the first entry found + bls_file = entries[0] + logger.info(f"Found BLS entry file: {bls_file}") + + try: + logger.info(f"Reading BLS file contents from: {bls_file}") + content = g.read_file(bls_file).decode('utf-8') + logger.info("Current BLS file content:") + logger.info("---BEGIN BLS CONTENT---") + logger.info(content) + logger.info("---END BLS CONTENT---") + + lines = content.splitlines() + modified = False + + for i, line in enumerate(lines): + if line.startswith('options '): + logger.info(f"Found options line: {line}") + # Check if net.ifnames parameter exists + if 'net.ifnames=' in line: + # Replace existing parameter + new_line = re.sub(r'net\.ifnames=[01]', 'net.ifnames=1', line) + if new_line != line: + lines[i] = new_line + modified = True + logger.info(f"Updated existing net.ifnames parameter to 1. New line: {new_line}") + else: + # Add parameter + lines[i] = f"{line} net.ifnames=1" + modified = True + logger.info(f"Added net.ifnames=1 parameter. New line: {lines[i]}") + break + + if modified: + new_content = '\n'.join(lines) + '\n' + logger.info("New BLS file content:") + logger.info("---BEGIN NEW BLS CONTENT---") + logger.info(new_content) + logger.info("---END NEW BLS CONTENT---") + g.write(bls_file, new_content.encode('utf-8')) + logger.info("Successfully updated BLS entry") + return True + + logger.info("No changes needed for BLS entry") + return False + + except Exception as e: + logger.error(f"Failed to modify BLS entry: {e}") + raise RuntimeError(f"Failed to modify BLS entry: {e}") + +def remove_persistent_net_rules(g): + """ + Remove the persistent network rules file if it exists. + + Args: + g: Mounted guestfs handle + + Returns: + bool: True if file was removed, False if it didn't exist + """ + rules_file = "/etc/udev/rules.d/70-persistent-net.rules" + logger.info(f"Checking for persistent network rules file: {rules_file}") + try: + if g.is_file(rules_file): + logger.info("Found persistent network rules file, removing...") + g.rm(rules_file) + logger.info(f"Successfully removed persistent network rules file: {rules_file}") + return True + logger.info("No persistent network rules file found") + return False + except Exception as e: + logger.error(f"Failed to remove persistent network rules: {e}") + raise RuntimeError(f"Failed to remove persistent network rules: {e}") + +def update_grub_config(g): + """ + Update GRUB configuration. + + Args: + g: Mounted guestfs handle + + Raises: + RuntimeError: If GRUB update fails + """ + try: + logger.info("Updating GRUB configuration...") + output = g.command(['grub2-mkconfig', '-o', '/boot/grub2/grub.cfg']) + logger.info("GRUB update output:") + logger.info(output) + logger.info("Successfully updated GRUB configuration") + except Exception as e: + logger.error(f"Failed to update GRUB configuration: {e}") + raise RuntimeError(f"Failed to update GRUB configuration: {e}") + +def configure_network_predictability(domain_name, image_path=None): + """ + Configure network interface predictability for a VM. + + Args: + domain_name (str): Name of the domain to configure + image_path (str, optional): Path to the QCOW2 image + + Raises: + RuntimeError: If configuration fails + """ + # Check domain status + check_domain_status(domain_name) + + # Use default image path if none provided + if not image_path: + image_path = f"/nsm/libvirt/images/{domain_name}/{domain_name}.qcow2" + + if not os.path.exists(image_path): + logger.error(f"Image file not found: {image_path}") + raise RuntimeError(f"Image file not found: {image_path}") + + if not os.access(image_path, os.R_OK | os.W_OK): + logger.error(f"Permission denied: Cannot access image file {image_path}") + raise RuntimeError(f"Permission denied: Cannot access image file {image_path}") + + logger.info(f"Configuring network predictability for domain: {domain_name}") + logger.info(f"Using image: {image_path}") + + g = guestfs.GuestFS(python_return_dict=True) + try: + logger.info("Initializing guestfs...") + g.set_network(False) + g.selinux = False + g.add_drive_opts(image_path, format="qcow2") + g.launch() + + logger.info("Inspecting operating system...") + roots = g.inspect_os() + if not roots: + raise RuntimeError("No operating system found in image") + + root = roots[0] + logger.info(f"Found root filesystem: {root}") + logger.info(f"Operating system type: {g.inspect_get_type(root)}") + logger.info(f"Operating system distro: {g.inspect_get_distro(root)}") + logger.info(f"Operating system major version: {g.inspect_get_major_version(root)}") + logger.info(f"Operating system minor version: {g.inspect_get_minor_version(root)}") + + logger.info("Getting mount points...") + mountpoints = g.inspect_get_mountpoints(root) + logger.info(f"Found mount points: {mountpoints}") + logger.info("Converting mount points to sortable list...") + # Convert dictionary to list of tuples + mountpoints = list(mountpoints.items()) + logger.info(f"Converted mount points: {mountpoints}") + logger.info("Sorting mount points by path length for proper mount order...") + mountpoints.sort(key=lambda m: len(m[0])) + logger.info(f"Mount order will be: {[mp[0] for mp in mountpoints]}") + + for mp_path, mp_device in mountpoints: + try: + logger.info(f"Attempting to mount {mp_device} at {mp_path}") + g.mount(mp_device, mp_path) + logger.info(f"Successfully mounted {mp_device} at {mp_path}") + except Exception as e: + logger.warning(f"Could not mount {mp_device} at {mp_path}: {str(e)}") + # Continue with other mounts + + # Perform configuration steps + bls_modified = modify_bls_entry(g) + rules_removed = remove_persistent_net_rules(g) + + if bls_modified or rules_removed: + update_grub_config(g) + logger.info("Network predictability configuration completed successfully") + else: + logger.info("No changes were necessary") + + except Exception as e: + raise RuntimeError(f"Failed to configure network predictability: {e}") + finally: + try: + logger.info("Unmounting all filesystems...") + g.umount_all() + logger.info("Successfully unmounted all filesystems") + except Exception as e: + logger.warning(f"Error unmounting filesystems: {e}") + g.close() + +def parse_arguments(): + """Parse command line arguments.""" + parser = argparse.ArgumentParser( + description="Configure network interface predictability for Security Onion VMs" + ) + parser.add_argument("-n", "--name", required=True, + help="Domain name of the VM to configure") + parser.add_argument("-I", "--image", + help="Path to the QCOW2 image (optional)") + return parser.parse_args() + +def main(): + """Main entry point for the script.""" + try: + args = parse_arguments() + configure_network_predictability(args.name, args.image) + sys.exit(0) + except RuntimeError as e: + if "must not be running" in str(e): + logger.error(str(e)) + sys.exit(2) + elif "not found" in str(e): + logger.error(str(e)) + sys.exit(3) + elif "Permission denied" in str(e): + logger.error(str(e)) + sys.exit(4) + else: + logger.error(str(e)) + sys.exit(1) + except KeyboardInterrupt: + logger.error("Operation cancelled by user") + sys.exit(1) + except Exception as e: + logger.error(f"Unexpected error: {e}") + sys.exit(1) + +if __name__ == "__main__": + main() diff --git a/salt/hypervisor/tools/sbin/so-wait-cloud-init b/salt/hypervisor/tools/sbin/so-wait-cloud-init new file mode 100644 index 000000000..322b89208 --- /dev/null +++ b/salt/hypervisor/tools/sbin/so-wait-cloud-init @@ -0,0 +1,206 @@ +#!/usr/bin/python3 + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +""" +Script for waiting for cloud-init to complete on a Security Onion VM. +Monitors VM state to ensure proper cloud-init initialization and shutdown. + +**Usage:** + so-wait-cloud-init -n + +**Options:** + -n, --name Domain name of the VM to monitor + +**Exit Codes:** +- 0: Success (cloud-init completed and VM shutdown) +- 1: General error +- 2: VM never started +- 3: VM stopped too quickly +- 4: VM failed to shutdown + +**Description:** +This script monitors a VM's state to ensure proper cloud-init initialization and completion: +1. Waits for VM to start running +2. Verifies VM remains running (not an immediate crash) +3. Waits for VM to shutdown (indicating cloud-init completion) +4. Verifies VM remains shutdown + +The script is typically used in the libvirt.images state after creating a new VM +to ensure cloud-init completes its initialization before proceeding with further +configuration. + +**Logging:** +- Logs are written to /opt/so/log/hypervisor/so-wait-cloud-init.log +- Both file and console logging are enabled +- Log entries include: + - Timestamps + - State changes + - Error conditions + - Verification steps +""" + +import argparse +import logging +import subprocess +import sys +import time +from so_logging_utils import setup_logging + +# Set up logging +logger = setup_logging( + logger_name='so-wait-cloud-init', + log_file_path='/opt/so/log/hypervisor/so-wait-cloud-init.log', + log_level=logging.INFO, + format_str='%(asctime)s - %(levelname)s - %(message)s' +) + +def check_vm_running(domain_name): + """ + Check if VM is in running state. + + Args: + domain_name (str): Name of the domain to check + + Returns: + bool: True if VM is running, False otherwise + """ + try: + result = subprocess.run(['virsh', 'list', '--state-running', '--name'], + capture_output=True, text=True, check=True) + return domain_name in result.stdout.splitlines() + except subprocess.CalledProcessError as e: + logger.error(f"Failed to check VM state: {e}") + return False + +def wait_for_vm_start(domain_name, timeout=300): + """ + Wait for VM to start running. + + Args: + domain_name (str): Name of the domain to monitor + timeout (int): Maximum time to wait in seconds + + Returns: + bool: True if VM started, False if timeout occurred + """ + logger.info(f"Waiting for VM {domain_name} to start...") + start_time = time.time() + + while time.time() - start_time < timeout: + if check_vm_running(domain_name): + logger.info("VM is running") + return True + time.sleep(1) + + logger.error(f"Timeout waiting for VM {domain_name} to start") + return False + +def verify_vm_running(domain_name): + """ + Verify VM remains running after initial start. + + Args: + domain_name (str): Name of the domain to verify + + Returns: + bool: True if VM is still running after verification period + """ + logger.info("Verifying VM remains running...") + time.sleep(5) # Wait to ensure VM is stable + + if not check_vm_running(domain_name): + logger.error("VM stopped too quickly after starting") + return False + + logger.info("VM verified running") + return True + +def wait_for_vm_shutdown(domain_name, timeout=600): + """ + Wait for VM to shutdown. + + Args: + domain_name (str): Name of the domain to monitor + timeout (int): Maximum time to wait in seconds + + Returns: + bool: True if VM shutdown, False if timeout occurred + """ + logger.info("Waiting for cloud-init to complete and VM to shutdown...") + start_time = time.time() + check_count = 0 + + while time.time() - start_time < timeout: + if not check_vm_running(domain_name): + logger.info("VM has shutdown") + return True + + # Log status every minute (after 12 checks at 5 second intervals) + check_count += 1 + if check_count % 12 == 0: + elapsed = int(time.time() - start_time) + logger.info(f"Still waiting for cloud-init... ({elapsed} seconds elapsed)") + + time.sleep(5) + + logger.error(f"Timeout waiting for VM {domain_name} to shutdown") + return False + +def verify_vm_shutdown(domain_name): + """ + Verify VM remains shutdown. + + Args: + domain_name (str): Name of the domain to verify + + Returns: + bool: True if VM remains shutdown after verification period + """ + logger.info("Verifying VM remains shutdown...") + time.sleep(5) # Wait to ensure VM state is stable + + if check_vm_running(domain_name): + logger.error("VM is still running after shutdown check") + return False + + logger.info("VM verified shutdown") + return True + +def main(): + parser = argparse.ArgumentParser( + description="Wait for cloud-init to complete on a Security Onion VM" + ) + parser.add_argument("-n", "--name", required=True, + help="Domain name of the VM to monitor") + args = parser.parse_args() + + try: + # Wait for VM to start + if not wait_for_vm_start(args.name): + sys.exit(2) # VM never started + + # Verify VM remains running + if not verify_vm_running(args.name): + sys.exit(3) # VM stopped too quickly + + # Wait for VM to shutdown + if not wait_for_vm_shutdown(args.name): + sys.exit(4) # VM failed to shutdown + + # Verify VM remains shutdown + if not verify_vm_shutdown(args.name): + sys.exit(4) # VM failed to stay shutdown + + logger.info("Cloud-init completed successfully") + sys.exit(0) + + except Exception as e: + logger.error(f"Unexpected error: {e}") + sys.exit(1) + +if __name__ == "__main__": + main() diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 8532760a7..7118400db 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -117,7 +117,7 @@ undefine_vm_sool9: - onlyif: - virsh dominfo sool9 -# Create and start the VM using virt-install +# Create and start the VM, letting cloud-init run create_vm_sool9: cmd.run: - name: | @@ -138,6 +138,21 @@ create_vm_sool9: - file: manage_userdata_sool9 - file: manage_cidata_sool9 +# Wait for cloud-init to complete and VM to shutdown +wait_for_cloud_init_sool9: + cmd.run: + - name: /usr/sbin/so-wait-cloud-init -n sool9 + - require: + - cmd: create_vm_sool9 + - timeout: 600 + +# Configure network predictability after cloud-init +configure_network_predictable_sool9: + cmd.run: + - name: /usr/sbin/so-qcow2-network-predictable -n sool9 + - require: + - cmd: wait_for_cloud_init_sool9 + {% else %} {{sls}}_no_license_detected: test.fail_without_changes: diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index d4c728143..b2cb0cdc2 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -420,7 +420,7 @@ def run_qcow2_modify_network_config(profile, mode, ip=None, gateway=None, dns=No hv_name = profile.split('-')[1] target = hv_name + "_*" image = '/nsm/libvirt/images/sool9/sool9.qcow2' - interface = 'eth0' + interface = 'enp1s0' try: r = local.cmd(target, 'qcow2.modify_network_config', [ diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 2f0323482..20c12d28f 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -45,7 +45,7 @@ sool9-{{host}}: inline_script: - | sudo salt-call state.apply salt.mine_functions \ - pillar='{"host": {"mainint": "eth0"}}' + pillar='{"host": {"mainint": "enp1s0"}}' - 'sudo salt-call mine.update' - 'sudo salt-call state.apply setup.virt' # grains to add to the minion diff --git a/salt/setup/virt/fleet.yaml b/salt/setup/virt/fleet.yaml index 8a6aa06de..d6c90e11d 100644 --- a/salt/setup/virt/fleet.yaml +++ b/salt/setup/virt/fleet.yaml @@ -1,5 +1,5 @@ MAINIP: -MNIC: eth0 +MNIC: enp1s0 NODE_DESCRIPTION: 'vm' ES_HEAP_SIZE: PATCHSCHEDULENAME: diff --git a/salt/setup/virt/heavynode.yaml b/salt/setup/virt/heavynode.yaml index 8cf2e0392..a3550021f 100644 --- a/salt/setup/virt/heavynode.yaml +++ b/salt/setup/virt/heavynode.yaml @@ -1,5 +1,5 @@ MAINIP: -MNIC: eth0 +MNIC: enp1s0 NODE_DESCRIPTION: 'vm' ES_HEAP_SIZE: PATCHSCHEDULENAME: diff --git a/salt/setup/virt/idh.yaml b/salt/setup/virt/idh.yaml index 0e1ef8be0..201262db8 100644 --- a/salt/setup/virt/idh.yaml +++ b/salt/setup/virt/idh.yaml @@ -1,5 +1,5 @@ MAINIP: -MNIC: eth0 +MNIC: enp1s0 NODE_DESCRIPTION: 'vm' ES_HEAP_SIZE: PATCHSCHEDULENAME: diff --git a/salt/setup/virt/receiver.yaml b/salt/setup/virt/receiver.yaml index 5a5c714aa..e5dc0b0e7 100644 --- a/salt/setup/virt/receiver.yaml +++ b/salt/setup/virt/receiver.yaml @@ -1,5 +1,5 @@ MAINIP: -MNIC: eth0 +MNIC: enp1s0 NODE_DESCRIPTION: 'vm' ES_HEAP_SIZE: PATCHSCHEDULENAME: diff --git a/salt/setup/virt/searchnode.yaml b/salt/setup/virt/searchnode.yaml index 2e1568f29..032e0e855 100644 --- a/salt/setup/virt/searchnode.yaml +++ b/salt/setup/virt/searchnode.yaml @@ -1,5 +1,5 @@ MAINIP: -MNIC: eth0 +MNIC: enp1s0 NODE_DESCRIPTION: 'vm' ES_HEAP_SIZE: PATCHSCHEDULENAME: diff --git a/salt/setup/virt/sensor.yaml b/salt/setup/virt/sensor.yaml index e7064bdfe..9136f0b78 100644 --- a/salt/setup/virt/sensor.yaml +++ b/salt/setup/virt/sensor.yaml @@ -1,5 +1,5 @@ MAINIP: -MNIC: eth0 +MNIC: enp1s0 NODE_DESCRIPTION: 'vm' ES_HEAP_SIZE: PATCHSCHEDULENAME: From 9b8dce0c77574498e5c0a6c3bdaff3d086e702b0 Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 6 Feb 2025 15:44:28 -0500 Subject: [PATCH 119/303] only wait and make predicable when virt-install runs --- salt/libvirt/images/init.sls | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 7118400db..70e668ffb 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -144,6 +144,8 @@ wait_for_cloud_init_sool9: - name: /usr/sbin/so-wait-cloud-init -n sool9 - require: - cmd: create_vm_sool9 + - onchanges: + - cmd: create_vm_sool9 - timeout: 600 # Configure network predictability after cloud-init @@ -152,6 +154,8 @@ configure_network_predictable_sool9: - name: /usr/sbin/so-qcow2-network-predictable -n sool9 - require: - cmd: wait_for_cloud_init_sool9 + - onchanges: + - cmd: create_vm_sool9 {% else %} {{sls}}_no_license_detected: From 924c0b63bd82a238bce4c02f34bbca5f245e4f5a Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Thu, 6 Feb 2025 16:05:56 -0500 Subject: [PATCH 120/303] put vnm engine in place --- salt/salt/files/virtual_node_manager_engine.conf | 4 ++++ salt/salt/master.sls | 15 +++++++++++++++ 2 files changed, 19 insertions(+) create mode 100644 salt/salt/files/virtual_node_manager_engine.conf diff --git a/salt/salt/files/virtual_node_manager_engine.conf b/salt/salt/files/virtual_node_manager_engine.conf new file mode 100644 index 000000000..8374f551a --- /dev/null +++ b/salt/salt/files/virtual_node_manager_engine.conf @@ -0,0 +1,4 @@ +engines: + - virtual_node_manager: + interval: 30 + base_path: /opt/so/saltstack/local/salt/hypervisor/hosts diff --git a/salt/salt/master.sls b/salt/salt/master.sls index 3f847583f..ed8da3f73 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -48,6 +48,21 @@ pillarWatch_engine: - name: /etc/salt/engines/pillarWatch.py - source: salt://salt/engines/master/pillarWatch.py +{% if 'hvn' in salt['pillar.get']('features', []) %} +virtual_node_manager_engine: + file.managed: + - name: /etc/salt/engines/virtual_node_manager.py + - source: salt://salt/engines/master/virtual_node_manager.py + - watch_in: + - service: salt_master_service + +virtual_node_manager_engine_config: + file.managed: + - name: /etc/salt/master.d/virtual_node_manager_engine.conf + - source: salt://salt/files/virtual_node_manager_engine.conf + +{% endif %} + engines_config: file.managed: - name: /etc/salt/master.d/engines.conf From 010c205eecafcdfbf3a2c0448dee57b3e3d047eb Mon Sep 17 00:00:00 2001 From: m0duspwnens Date: Fri, 7 Feb 2025 14:45:06 -0500 Subject: [PATCH 121/303] configure bond and monitor nics --- .../cloud/cloud.profiles.d/socloud.conf.jinja | 8 ++- salt/sensor/init.sls | 18 +++++ salt/sensor/vm/network.sls | 70 +++++++++++++++++++ salt/setup/virt/init.sls | 4 ++ 4 files changed, 97 insertions(+), 3 deletions(-) create mode 100644 salt/sensor/vm/network.sls diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 20c12d28f..00b1a76c1 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -44,10 +44,12 @@ sool9-{{host}}: # if calling states with pillar values, need to pass them in since minion pillars are not set until setup.virt.sominion state runs inline_script: - | - sudo salt-call state.apply salt.mine_functions \ + salt-call state.apply salt.mine_functions \ + pillar='{"host": {"mainint": "enp1s0"}}' + - salt-call mine.update + - | + salt-call state.apply setup.virt \ pillar='{"host": {"mainint": "enp1s0"}}' - - 'sudo salt-call mine.update' - - 'sudo salt-call state.apply setup.virt' # grains to add to the minion {%- endfor %} diff --git a/salt/sensor/init.sls b/salt/sensor/init.sls index 730a7c7ad..4008879e9 100644 --- a/salt/sensor/init.sls +++ b/salt/sensor/init.sls @@ -1,3 +1,21 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features') and salt['grains.get']('salt-cloud', {}) %} + +include: + - sensor.vm.network + +{% endif %} + offload_script: file.managed: - name: /etc/NetworkManager/dispatcher.d/pre-up.d/99-so-checksum-offload-disable diff --git a/salt/sensor/vm/network.sls b/salt/sensor/vm/network.sls new file mode 100644 index 000000000..f056e307a --- /dev/null +++ b/salt/sensor/vm/network.sls @@ -0,0 +1,70 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) %} + +{% set mainint = salt['pillar.get']('host:mainint', 'enp1s0') %} +{% set interfaces = salt['network.interfaces']() %} +{% set non_enp1s0_interfaces = [] %} +{% for iface, data in interfaces.items() %} + {% if iface != mainint and not iface.startswith(('veth', 'docker', 'lo', 'br', 'sobridge', 'bond')) %} + {% do non_enp1s0_interfaces.append(iface) %} + {% endif %} +{% endfor %} + +# Create bond0 interface with NetworkManager +bond0_interface: + cmd.run: + - name: | + nmcli con add type bond \ + con-name bond0 \ + ifname bond0 \ + mode 0 \ + miimon 100 \ + ipv4.method disabled \ + ipv6.method ignore \ + ipv6.addr-gen-mode default \ + connection.autoconnect yes + nmcli con mod bond0 ethernet.mtu 9000 + nmcli con up bond0 +{% if non_enp1s0_interfaces|length > 0 %} + - require_in: +{% for iface in non_enp1s0_interfaces %} + - cmd: {{ iface }}_slave +{% endfor %} +{% endif %} + +# Configure non-enp1s0 interfaces as bond slaves first +{% if non_enp1s0_interfaces|length > 0 %} +{% for iface in non_enp1s0_interfaces %} +{{ iface }}_slave: + cmd.run: + - name: | + nmcli con add type ethernet \ + con-name bond0-slave-{{ iface }} \ + ifname {{ iface }} \ + master bond0 \ + slave-type bond \ + ethernet.mtu 9000 + nmcli con up bond0-slave-{{ iface }} + +{% endfor %} +{% endif %} + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} diff --git a/salt/setup/virt/init.sls b/salt/setup/virt/init.sls index 9c173a78e..65a514ae8 100644 --- a/salt/setup/virt/init.sls +++ b/salt/setup/virt/init.sls @@ -1,5 +1,9 @@ +{% set role = grains.id.split("_") | last %} include: - setup.virt.setHostname - setup.virt.sominion - common.packages # python3-dnf-plugin-versionlock +{% if role in ['sensor', 'heavynode'] %} + - sensor.vm.network +{% endif %} - setup.virt.setSalt From 5123a860620e3538c630d7f63905da467b4968b3 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 12 Feb 2025 13:21:39 -0500 Subject: [PATCH 122/303] start of dynamic annotations for hypervisor --- salt/hypervisor/defaults.yaml | 153 +++++++++++------- salt/hypervisor/pillar.map.jinja | 29 ---- salt/hypervisor/pillarExample.sls | 48 ------ .../soc/dyanno/hypervisor/hardwareMap.example | 32 ++++ salt/soc/dyanno/hypervisor/hypervisor.yaml | 50 ++++++ .../hypervisor/init.sls | 8 +- .../hypervisor/map.jinja | 0 .../hypervisor/soc_hypervisor.yaml.example | 67 ++++++++ .../hypervisor/soc_hypervisor.yaml.jinja | 36 +++++ salt/soc/dyanno/hypervisor/vmMap.example | 14 ++ .../dynamic_annotations/hypervisor/add_node | 11 -- .../hypervisor/hypervisor.yaml | 40 ----- .../hypervisor/soc_hypervisor.yaml.jinja | 13 -- 13 files changed, 295 insertions(+), 206 deletions(-) delete mode 100644 salt/hypervisor/pillar.map.jinja delete mode 100644 salt/hypervisor/pillarExample.sls create mode 100644 salt/soc/dyanno/hypervisor/hardwareMap.example create mode 100644 salt/soc/dyanno/hypervisor/hypervisor.yaml rename salt/soc/{dynamic_annotations => dyanno}/hypervisor/init.sls (71%) rename salt/soc/{dynamic_annotations => dyanno}/hypervisor/map.jinja (100%) create mode 100644 salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example create mode 100644 salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja create mode 100644 salt/soc/dyanno/hypervisor/vmMap.example delete mode 100644 salt/soc/dynamic_annotations/hypervisor/add_node delete mode 100644 salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml delete mode 100644 salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja diff --git a/salt/hypervisor/defaults.yaml b/salt/hypervisor/defaults.yaml index 4a762e677..38a4f4597 100644 --- a/salt/hypervisor/defaults.yaml +++ b/salt/hypervisor/defaults.yaml @@ -1,62 +1,93 @@ hypervisor: - nodes: [] - model1: - hardware: - cpu: - total: 128 - free: 128 - memory: - total: 128 - free: 128 - disks: - free: - 3: pci_0000_c7_00_0 - 4: pci_0000_c8_00_0 - claimed: - 1: pci_0000_c5_00_0 - 2: pci_0000_c6_00_0 - copper: - free: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - claimed: {} - sfp: - free: - 5: pci_0000_41_00_0 - 6: pci_0000_41_00_1 - claimed: {} - model2: - hardware: - cpu: - total: 128 - free: 128 - memory: - total: 512 - free: 512 - disks: - free: - 3: pci_0000_c8_00_0 - 4: pci_0000_c9_00_0 - 5: pci_0000_c10_00_0 - 6: pci_0000_c11_00_0 - claimed: - 1: pci_0000_c6_00_0 - 2: pci_0000_c7_00_0 - copper: - free: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - 5: pci_0000_c5_00_0 - 6: pci_0000_c5_00_1 - 7: pci_0000_c5_00_2 - 8: pci_0000_c5_00_3 - claimed: {} - sfp: - free: - 9: pci_0000_41_00_0 - 10: pci_0000_41_00_1 - claimed: {} + model: + testModel: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 128 + free: 128 + disks: + free: + 3: pci_0000_c7_00_0 + 4: pci_0000_c8_00_0 + claimed: + 1: pci_0000_c5_00_0 # hypervisor + 2: pci_0000_c6_00_0 # hypervisor + copper: + free: + 3: pci_0000_c4_00_0 + 4: pci_0000_c4_00_1 + 5: pci_0000_c4_00_2 + 6: pci_0000_c4_00_3 + claimed: + 1: pci_0000_c1_00_0 # hypervisor + 2: pci_0000_c1_00_1 # hypervisor + sfp: + free: + 5: pci_0000_02_00_0 + 6: pci_0000_02_00_1 + 7: pci_0000_41_00_0 + 8: pci_0000_41_00_1 + claimed: {} + model1: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 128 + free: 128 + disks: + free: + 3: pci_0000_c7_00_0 + 4: pci_0000_c8_00_0 + claimed: + 1: pci_0000_c5_00_0 + 2: pci_0000_c6_00_0 + copper: + free: + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + claimed: {} + sfp: + free: + 5: pci_0000_41_00_0 + 6: pci_0000_41_00_1 + claimed: {} + model2: + hardware: + cpu: + total: 128 + free: 128 + memory: + total: 512 + free: 512 + disks: + free: + 3: pci_0000_c8_00_0 + 4: pci_0000_c9_00_0 + 5: pci_0000_c10_00_0 + 6: pci_0000_c11_00_0 + claimed: + 1: pci_0000_c6_00_0 + 2: pci_0000_c7_00_0 + copper: + free: + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + 5: pci_0000_c5_00_0 + 6: pci_0000_c5_00_1 + 7: pci_0000_c5_00_2 + 8: pci_0000_c5_00_3 + claimed: {} + sfp: + free: + 9: pci_0000_41_00_0 + 10: pci_0000_41_00_1 + claimed: {} diff --git a/salt/hypervisor/pillar.map.jinja b/salt/hypervisor/pillar.map.jinja deleted file mode 100644 index 3b6c275a3..000000000 --- a/salt/hypervisor/pillar.map.jinja +++ /dev/null @@ -1,29 +0,0 @@ -{% set HYPERVISORHOSTS = salt['pillar.get']('hypervisor:hosts', {}) %} - -{% import_yaml 'setup/virt/sensor.yaml' as SENSOR %} -{% import_yaml 'setup/virt/searchnode.yaml' as SEARCHNODE %} - -{% set vars = { - 'sensor': SENSOR, - 'searchnode': SEARCHNODE -} %} - -{% for host, guestDetails in HYPERVISORHOSTS.items() %} -{% if guestDetails['add_guest'] | length > 0 %} -{% for newGuest in guestDetails['add_guest'] %} -{% set indx = guestDetails['add_guest'].index(newGuest) %} -{% do guestDetails['add_guest'].pop(indx) %} -{% set NODETYPE = newGuest.split('_') | last %} -{% do guestDetails['guests'].update({ - newGuest: { - 'cpu': vars[NODETYPE].CPU, - 'memory': vars[NODETYPE].MEMORY, - 'disk': vars[NODETYPE].DISKS, - 'copper': vars[NODETYPE].COPPER, - 'sfp': vars[NODETYPE].SFP - } -}) %} - -{% endfor %} -{% endif %} -{% endfor %} diff --git a/salt/hypervisor/pillarExample.sls b/salt/hypervisor/pillarExample.sls deleted file mode 100644 index 4bc11434b..000000000 --- a/salt/hypervisor/pillarExample.sls +++ /dev/null @@ -1,48 +0,0 @@ -hypervisor: - hardware: - cpu: - total: 128 - free: 128 - memory: - total: 128 - free: 128 - disks: - free: - 3: pci_0000_c7_00_0 - 4: pci_0000_c8_00_0 - claimed: - 1: pci_0000_c5_00_0 - 2: pci_0000_c6_00_0 - copper: - free: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - claimed: {} - sfp: - free: - 5: pci_0000_41_00_0 - 6: pci_0000_41_00_1 - claimed: {} - - -hypervisor: - hardware: - cpu: - total: 16 - free: 16 - memory: - total: 16 - free: 16 - disks: - free: {} - claimed: {} - copper: - free: - 2: pci_0000_00_13_0 - claimed: - 1: pci_0000_00_12_0 - sfp: - free: {} - claimed: {} diff --git a/salt/soc/dyanno/hypervisor/hardwareMap.example b/salt/soc/dyanno/hypervisor/hardwareMap.example new file mode 100644 index 000000000..ea3bec51b --- /dev/null +++ b/salt/soc/dyanno/hypervisor/hardwareMap.example @@ -0,0 +1,32 @@ +# this file will exist in /opt/so/saltstack/local/salt/hypervisor/hosts/HOSTNAME/hardwareMap +hypervisor: + hardware: + copper: + claimed: + 1: pci_0000_c1_00_0 + 2: pci_0000_c1_00_1 + free: + 3: pci_0000_c4_00_0 + 4: pci_0000_c4_00_1 + 5: pci_0000_c4_00_2 + 6: pci_0000_c4_00_3 + cpu: + free: 120 + total: 120 + disk: + claimed: + 1: pci_0000_c5_00_0 + 2: pci_0000_c6_00_0 + free: + 3: pci_0000_c7_00_0 + 4: pci_0000_c8_00_0 + memory: + free: 120 + total: 120 + sfp: + claimed: {} + free: + 8: pci_0000_02_00_1 + 7: pci_0000_02_00_0 + 9: pci_0000_41_00_0 + 10: pci_0000_41_00_1 diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml new file mode 100644 index 000000000..3a5d000a9 --- /dev/null +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -0,0 +1,50 @@ +hypervisor: + hosts: + defaultHost: + hardwareMap: + title: 'All Hardware' + description: This shows hardware available to the hypervisor and PCIe -> INT mapping. + file: true + readonly: true + global: true # set to true to remove host drop down + multiline: true + vmMap: + title: 'VM Map' + description: This shows the VMs and the hardware they have claimed. + file: true + readonly: true + global: true + multiline: true + nodes: + description: 'Available CPU: CPUFREE | Available Memory: MEMFREE | Available Disk: DISKFREE | Available Copper NIC: COPPERFREE | Available SFP NIC: SFPFREE' + syntax: json + uiElements: + - field: hostname + label: Enter the hostname + forcedType: string + - field: nodetype + label: sensor or searchnode + - field: network_mode + label: Choose static4 or dhcp4. If static4, populate IP details below. + - field: ip4 + label: IP Address with netmask. ex. 192.168.1.10/24 + - field: gw4 + label: Gateway + - field: dns4 + label: DNS. Comma seperated list. ex. 192.168.1.1,8.8.8.8 + - field: search4 + label: Search domain + - field: cpu + label: Number of CPU cores to assign. ex. 8 + - field: memory + label: Memory, in GB to assign. ex. 16 + - field: disk + label: Choose a disk or disks to assign for passthrough. Comma seperated list. + - field: copper + label: Choose a copper port or ports to assign for passthrough. Comma seperated list. + - filed: sfp + label: Choose a sfp port or ports to assign for passthrough. Comma seperated list. + file: true + global: true + + vms: {} diff --git a/salt/soc/dynamic_annotations/hypervisor/init.sls b/salt/soc/dyanno/hypervisor/init.sls similarity index 71% rename from salt/soc/dynamic_annotations/hypervisor/init.sls rename to salt/soc/dyanno/hypervisor/init.sls index 8c857e72f..c3bfb97ef 100644 --- a/salt/soc/dynamic_annotations/hypervisor/init.sls +++ b/salt/soc/dyanno/hypervisor/init.sls @@ -1,9 +1,9 @@ -{% from 'soc/dynamic_annotations/hypervisor/map.jinja' import HYPERVISORS %} +{% from 'soc/dyanno/hypervisor/map.jinja' import HYPERVISORS %} hypervisor_annotation: file.managed: - name: /opt/so/saltstack/default/salt/hypervisor/soc_hypervisor.yaml - - source: salt://soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja + - source: salt://soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja - template: jinja - defaults: HYPERVISORS: {{ HYPERVISORS }} @@ -18,11 +18,11 @@ hypervisor_host_directory_{{hypervisor}}: add_searchnode_file_{{hypervisor}}: file.managed: - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}}/add_searchnode - - source: salt://soc/dynamic_annotations/hypervisor/add_node + - source: salt://soc/dyanno/hypervisor/add_node add_sensor_file_{{hypervisor}}: file.managed: - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}}/add_sensor - - source: salt://soc/dynamic_annotations/hypervisor/add_node + - source: salt://soc/dyanno/hypervisor/add_node {% endfor %} {% endfor %} diff --git a/salt/soc/dynamic_annotations/hypervisor/map.jinja b/salt/soc/dyanno/hypervisor/map.jinja similarity index 100% rename from salt/soc/dynamic_annotations/hypervisor/map.jinja rename to salt/soc/dyanno/hypervisor/map.jinja diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example new file mode 100644 index 000000000..bd5161598 --- /dev/null +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example @@ -0,0 +1,67 @@ +# This is the start of an example of what this file will look like. It will be generated by Salt, so this yaml file is not used by Salt. +hypervisor: + hosts: + jpphype1: + hardwareMap: + title: 'All Hardware' + description: This shows hardware available to the hypervisor and PCIe -> INT mapping. + file: true + readonly: true + global: true # set to true to remove host drop down + multiline: true + cpufree: + title: 'Available CPU: 120' + description: Available CPU for this hypervisor. + readonly: true + global: true # set to true to remove host drop down + memfree: + title: 'Available Memory: 120' + description: Available memory for this hypervisor. + readonly: true + global: true # set to true to remove host drop down + diskfree: + title: 'Available Disk: 3,4' + description: Available disk for this hypervisor. + readonly: true + global: true # set to true to remove host drop down + copperfree: + title: 'Available Copper NIC: 3,4,5,6' + description: Available copper NIC for this hypervisor. + readonly: true + global: true # set to true to remove host drop down + sfpfree: + title: 'Available SFP NIC: 7,8,9,10' + description: Available SFP NIC for this hypervisor. + readonly: true + global: true # set to true to remove host drop down + nodes: + description: List of VMs. + syntax: json + uiElements: + - field: hostname + label: Enter the hostname + forcedType: string + - field: nodetype + label: sensor or searchnode + - field: network_mode + label: Choose static4 or dhcp4. If static4, populate IP details below. + - field: ip4 + label: IP Address with netmask. ex. 192.168.1.10/24 + - field: gw4 + label: Gateway + - field: dns4 + label: DNS. Comma seperated list. ex. 192.168.1.1,8.8.8.8 + - field: search4 + label: Search domain + - field: cpu + label: Number of CPU cores to assign. ex. 8 + - field: memory + label: Memory, in GB to assign. ex. 16 + - field: disk + label: Choose a disk or disks to assign for passthrough. Comma seperated list. + - field: copper + label: Choose a copper port or ports to assign for passthrough. Comma seperated list. + - filed: sfp + label: Choose a sfp port or ports to assign for passthrough. Comma seperated list. + file: true + global: true # set to true to remove host drop down diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja new file mode 100644 index 000000000..74996605e --- /dev/null +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -0,0 +1,36 @@ +{%- import_yaml 'soc/dyanno/hypervisor/hypervisor.yaml' as ANNOTATION -%} + +{%- set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') -%} + +{%- macro update_description(description, cpu_free, mem_free, disk_free, copper_free, sfp_free) -%} +{{- description | replace('CPUFREE', cpu_free | string) + | replace('MEMFREE', mem_free | string) + | replace('DISKFREE', disk_free | string) + | replace('COPPERFREE', copper_free | string) + | replace('SFPFREE', sfp_free | string) -}} +{%- endmacro -%} + +{%- for role in HYPERVISORS -%} +{%- for hypervisor in HYPERVISORS[role].keys() -%} +{%- set cpu_free = HYPERVISORS[role][hypervisor].available_cpu -%} +{%- set mem_free = HYPERVISORS[role][hypervisor].available_memory -%} +{%- set disk_free = HYPERVISORS[role][hypervisor].available_disk -%} +{%- set copper_free = HYPERVISORS[role][hypervisor].available_copper -%} +{%- set sfp_free = HYPERVISORS[role][hypervisor].available_sfp -%} + +{%- set updated_template = TEMPLATE.copy() -%} +{%- do updated_template.nodes.update({ + 'description': update_description( + TEMPLATE.nodes.description, + cpu_free, + mem_free, + disk_free, + copper_free, + sfp_free + ) + }) -%} +{%- do ANNOTATION.hypervisor.hosts.update({hypervisor: updated_template}) -%} +{%- endfor -%} +{%- endfor -%} + +{{- ANNOTATION | yaml(False) -}} diff --git a/salt/soc/dyanno/hypervisor/vmMap.example b/salt/soc/dyanno/hypervisor/vmMap.example new file mode 100644 index 000000000..7a67c7349 --- /dev/null +++ b/salt/soc/dyanno/hypervisor/vmMap.example @@ -0,0 +1,14 @@ +hypervisor: + vm: + sen41_sensor: + cpu: 16 + memory: 24 + disk: 3 + copper: 3,4 + sfp: 7,8 + sea42_searchnode: + cpu: 16 + memory: 24 + disk: 4 + copper: + sfp: diff --git a/salt/soc/dynamic_annotations/hypervisor/add_node b/salt/soc/dynamic_annotations/hypervisor/add_node deleted file mode 100644 index ecbde7b41..000000000 --- a/salt/soc/dynamic_annotations/hypervisor/add_node +++ /dev/null @@ -1,11 +0,0 @@ -hostname: -network_mode: -ip4: -gw4: -dns4: -search4: -cpu: -memory: -disk: -copper: -sfp: diff --git a/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml b/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml deleted file mode 100644 index 0ec53ff30..000000000 --- a/salt/soc/dynamic_annotations/hypervisor/hypervisor.yaml +++ /dev/null @@ -1,40 +0,0 @@ -hypervisor: - hosts: - defaultHost: - add_searchnode: - description: Add a new searchnode to the hypervisor. - file: True - global: True - multiline: True - add_sensor: - description: Add a new sensor to the hypervisor. - file: True - global: True - multiline: True - guests: - defaultGuest: - copper: - description: Copper nics - forcedType: "[]int" - global: True - multiline: True - sfp: - description: sfp nics - forcedType: string - global: True - multiline: True - disks: - description: disk - forcedType: "[]int" - global: True - multiline: True - cpu: - description: cpu - forcedType: int - global: True - multiline: True - memory: - description: mem - forcedType: int - global: True - multiline: True diff --git a/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja deleted file mode 100644 index c9dd8200d..000000000 --- a/salt/soc/dynamic_annotations/hypervisor/soc_hypervisor.yaml.jinja +++ /dev/null @@ -1,13 +0,0 @@ -{% import_yaml 'soc/dynamic_annotations/hypervisor/hypervisor.yaml' as ANNOTATION %} - -{% set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') %} -{# remove defaultGuest so that it is not shown in Grid Configuration UI #} -{% do TEMPLATE['guests'].pop('defaultGuest') %} - -{% for role in HYPERVISORS %} -{% for hypervisor in HYPERVISORS[role].keys() %} -{% do ANNOTATION.hypervisor.hosts.update({hypervisor: TEMPLATE}) %} -{% endfor %} -{% endfor %} - -{{ ANNOTATION | yaml(False) }} From ad27c8674b44dfe677a558aa789cea1d75f1ac14 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sat, 15 Feb 2025 10:50:09 -0500 Subject: [PATCH 123/303] no longer need add_* nodes --- salt/hypervisor/pillar.sls | 5 ----- salt/soc/dyanno/hypervisor/init.sls | 10 ---------- 2 files changed, 15 deletions(-) delete mode 100644 salt/hypervisor/pillar.sls diff --git a/salt/hypervisor/pillar.sls b/salt/hypervisor/pillar.sls deleted file mode 100644 index 92c1cbfec..000000000 --- a/salt/hypervisor/pillar.sls +++ /dev/null @@ -1,5 +0,0 @@ -soc_hypervisor_pillar: - file.managed: - - name: /opt/so/saltstack/local/pillar/hypervisor/soc_hypervisor.sls - - source: salt://hypervisor/pillar.map.jinja - - template: jinja diff --git a/salt/soc/dyanno/hypervisor/init.sls b/salt/soc/dyanno/hypervisor/init.sls index c3bfb97ef..31fe5ec93 100644 --- a/salt/soc/dyanno/hypervisor/init.sls +++ b/salt/soc/dyanno/hypervisor/init.sls @@ -14,15 +14,5 @@ hypervisor_host_directory_{{hypervisor}}: file.directory: - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}} - makedirs: True - -add_searchnode_file_{{hypervisor}}: - file.managed: - - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}}/add_searchnode - - source: salt://soc/dyanno/hypervisor/add_node - -add_sensor_file_{{hypervisor}}: - file.managed: - - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}}/add_sensor - - source: salt://soc/dyanno/hypervisor/add_node {% endfor %} {% endfor %} From e193347fb47c5527ff6acf0008c6220a3c2d0e51 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sat, 15 Feb 2025 10:54:49 -0500 Subject: [PATCH 124/303] add hypervisor to host keys first connection. cleaner qcow2 logging. --- salt/manager/tools/sbin/so-salt-cloud | 104 +++++++++++++++++++++++++- 1 file changed, 100 insertions(+), 4 deletions(-) diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index b2cb0cdc2..1145c1b65 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -209,6 +209,7 @@ Logging: """ import argparse +import os import subprocess import re import sys @@ -346,6 +347,47 @@ def delete_vm(profile, vm_name, assume_yes=False): logger.error(f"Failed to delete VM {vm_name}: {e}") raise +def _add_hypervisor_host_key(hostname): + """Add hypervisor host key to root's known_hosts file. + + Args: + hostname (str): The hostname or IP of the hypervisor + + Returns: + bool: True if key was added or already exists, False on error + """ + try: + known_hosts = '/root/.ssh/known_hosts' + os.makedirs(os.path.dirname(known_hosts), exist_ok=True) + + # Check if key already exists using ssh-keygen + if os.path.exists(known_hosts): + check_result = subprocess.run(['ssh-keygen', '-F', hostname], + capture_output=True, text=True) + if check_result.returncode == 0 and check_result.stdout.strip(): + logger.info("Host key for %s already in known_hosts", hostname) + return True + + # Get host key using ssh-keyscan + logger.info("Scanning host key for %s", hostname) + process = subprocess.run(['ssh-keyscan', '-H', hostname], + capture_output=True, text=True) + + if process.returncode == 0 and process.stdout: + # Append new key + with open(known_hosts, 'a') as f: + f.write(process.stdout) + logger.info("Added host key for %s to known_hosts", hostname) + return True + else: + logger.error("Failed to get host key for %s: %s", + hostname, process.stderr) + return False + + except Exception as e: + logger.error("Error adding host key for %s: %s", hostname, str(e)) + return False + def call_salt_cloud(profile, vm_name, destroy=False, assume_yes=False): """Call salt-cloud to create or destroy a VM""" try: @@ -353,6 +395,14 @@ def call_salt_cloud(profile, vm_name, destroy=False, assume_yes=False): delete_vm(profile, vm_name, assume_yes) return + # Extract hypervisor hostname from profile (e.g., sool9-jpphype1 -> jpphype1) + hypervisor = profile.split('-', 1)[1] if '-' in profile else None + if hypervisor: + logger.info("Ensuring host key exists for hypervisor %s", hypervisor) + if not _add_hypervisor_host_key(hypervisor): + logger.error("Failed to add host key for %s, cannot proceed with VM creation", hypervisor) + sys.exit(1) + # Start the salt-cloud command as a subprocess process = subprocess.Popen( ['salt-cloud', '-p', profile, vm_name, '-l', 'info'], @@ -394,6 +444,29 @@ def call_salt_cloud(profile, vm_name, destroy=False, assume_yes=False): except Exception as e: logger.error(f"An error occurred while calling salt-cloud: {e}") +def format_qcow2_output(operation, result): + """Format the output from qcow2 module operations for better readability. + + Args: + operation (str): The name of the operation (e.g., 'Network configuration', 'Hardware configuration') + result (dict): The result dictionary from the qcow2 module + + Returns: + None - logs the formatted output directly + """ + for host, host_result in result.items(): + if isinstance(host_result, dict): + # Extract and format stderr which contains the detailed log + if 'stderr' in host_result: + logger.info(f"{operation} on {host}:") + for line in host_result['stderr'].split('\n'): + if line.strip(): + logger.info(f" {line.strip()}") + if host_result.get('retcode', 0) != 0: + logger.error(f"{operation} failed on {host} with return code {host_result.get('retcode')}") + else: + logger.info(f"{operation} result from {host}: {host_result}") + def run_qcow2_modify_hardware_config(profile, vm_name, cpu=None, memory=None, pci_list=None, start=False): hv_name = profile.split('-')[1] target = hv_name + "_*" @@ -411,8 +484,8 @@ def run_qcow2_modify_hardware_config(profile, vm_name, cpu=None, memory=None, pc # Pass all PCI devices as a comma-separated list args_list.append('pci=' + ','.join(pci_list)) - r = local.cmd(target, 'qcow2.modify_hardware_config', args_list) - logger.info(f'qcow2.modify_hardware_config: {r}') + result = local.cmd(target, 'qcow2.modify_hardware_config', args_list) + format_qcow2_output('Hardware configuration', result) except Exception as e: logger.error(f"An error occurred while running qcow2.modify_hardware_config: {e}") @@ -423,7 +496,7 @@ def run_qcow2_modify_network_config(profile, mode, ip=None, gateway=None, dns=No interface = 'enp1s0' try: - r = local.cmd(target, 'qcow2.modify_network_config', [ + result = local.cmd(target, 'qcow2.modify_network_config', [ 'image=' + image, 'interface=' + interface, 'mode=' + mode, @@ -432,7 +505,7 @@ def run_qcow2_modify_network_config(profile, mode, ip=None, gateway=None, dns=No 'dns4=' + dns if dns else '', 'search4=' + search_domain if search_domain else '' ]) - logger.info(f'qcow2.modify_network_config: {r}') + format_qcow2_output('Network configuration', result) except Exception as e: logger.error(f"An error occurred while running qcow2.modify_network_config: {e}") @@ -473,6 +546,29 @@ def parse_arguments(): def main(): try: args = parse_arguments() + + # Log the initial request + if args.destroy: + logger.info(f"Received request to destroy VM '{args.vm_name}' using profile '{args.profile}'{' with --assume-yes' if args.assume_yes else ''}") + else: + # Build network config string + network_config = "using DHCP" if args.dhcp4 else f"with static IP {args.ip4}, gateway {args.gw4}" + if args.dns4: + network_config += f", DNS {args.dns4}" + if args.search4: + network_config += f", search domain {args.search4}" + + # Build hardware config string + hw_config = [] + if args.cpu: + hw_config.append(f"{args.cpu} CPUs") + if args.memory: + hw_config.append(f"{args.memory}MB RAM") + if args.pci: + hw_config.append(f"PCI devices: {', '.join(args.pci)}") + hw_string = f" and hardware config: {', '.join(hw_config)}" if hw_config else "" + + logger.info(f"Received request to create VM '{args.vm_name}' using profile '{args.profile}' {network_config}{hw_string}") if args.destroy: # Handle VM deletion From a84f5a1e3210383e0b7519ea708c551a08bf3241 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sat, 15 Feb 2025 11:14:39 -0500 Subject: [PATCH 125/303] updated logging added returns --- salt/_runners/setup_hypervisor.py | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index c51166133..c06439eab 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -77,7 +77,6 @@ import time import yaml from cryptography.hazmat.primitives import serialization from cryptography.hazmat.primitives.asymmetric import ed25519 - # Configure logging log = logging.getLogger(__name__) log.setLevel(logging.DEBUG) @@ -442,11 +441,21 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id # Run highstate on the hypervisor highstate_result = local.cmd(minion_id, 'state.highstate', [], timeout=1800) if highstate_result and minion_id in highstate_result: - log.info("MAIN: Highstate completed on %s", minion_id) + log.info("MAIN: Highstate triggered on %s", minion_id) else: log.error("MAIN: Highstate failed or timed out on %s", minion_id) + return { + 'success': False, + 'error': 'Highstate failed or timed out', + 'vm_result': None + } except Exception as e: log.error("MAIN: Error running highstate on %s: %s", minion_id, str(e)) + return { + 'success': False, + 'error': f'Error running highstate: {str(e)}', + 'vm_result': None + } return { 'success': success, From eb4cd752186cc6535c852a5a5f070d7a07c84947 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sat, 15 Feb 2025 11:29:47 -0500 Subject: [PATCH 126/303] virtual_node_manager lookup hardware from defaults. allocate hw in vm file --- salt/hypervisor/defaults.yaml | 125 +-- .../engines/master/virtual_node_manager.py | 983 ++++++++++-------- salt/soc/dyanno/hypervisor/hypervisor.yaml | 13 +- salt/soc/dyanno/hypervisor/init.sls | 5 + 4 files changed, 598 insertions(+), 528 deletions(-) diff --git a/salt/hypervisor/defaults.yaml b/salt/hypervisor/defaults.yaml index 38a4f4597..06509828c 100644 --- a/salt/hypervisor/defaults.yaml +++ b/salt/hypervisor/defaults.yaml @@ -2,92 +2,57 @@ hypervisor: model: testModel: hardware: - cpu: - total: 128 - free: 128 - memory: - total: 128 - free: 128 - disks: - free: - 3: pci_0000_c7_00_0 - 4: pci_0000_c8_00_0 - claimed: - 1: pci_0000_c5_00_0 # hypervisor - 2: pci_0000_c6_00_0 # hypervisor + cpu: 128 + memory: 128 + disk: + 1: pci_0000_c7_00_0 + 2: pci_0000_c8_00_0 copper: - free: - 3: pci_0000_c4_00_0 - 4: pci_0000_c4_00_1 - 5: pci_0000_c4_00_2 - 6: pci_0000_c4_00_3 - claimed: - 1: pci_0000_c1_00_0 # hypervisor - 2: pci_0000_c1_00_1 # hypervisor + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 sfp: - free: - 5: pci_0000_02_00_0 - 6: pci_0000_02_00_1 - 7: pci_0000_41_00_0 - 8: pci_0000_41_00_1 - claimed: {} + 5: pci_0000_02_00_0 + 6: pci_0000_02_00_1 + 7: pci_0000_41_00_0 + 8: pci_0000_41_00_1 model1: hardware: - cpu: - total: 128 - free: 128 - memory: - total: 128 - free: 128 - disks: - free: - 3: pci_0000_c7_00_0 - 4: pci_0000_c8_00_0 - claimed: - 1: pci_0000_c5_00_0 - 2: pci_0000_c6_00_0 + cpu: 128 + memory: 128 + disk: + 1: pci_0000_c7_00_0 + 2: pci_0000_c8_00_0 copper: - free: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - claimed: {} + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 sfp: - free: - 5: pci_0000_41_00_0 - 6: pci_0000_41_00_1 - claimed: {} + 5: pci_0000_02_00_0 + 6: pci_0000_02_00_1 + 7: pci_0000_41_00_0 + 8: pci_0000_41_00_1 model2: - hardware: - cpu: - total: 128 - free: 128 - memory: - total: 512 - free: 512 - disks: - free: - 3: pci_0000_c8_00_0 - 4: pci_0000_c9_00_0 - 5: pci_0000_c10_00_0 - 6: pci_0000_c11_00_0 - claimed: - 1: pci_0000_c6_00_0 - 2: pci_0000_c7_00_0 + cpu: 256 + memory: 256 + disk: + 1: pci_0000_c7_00_0 + 2: pci_0000_c8_00_0 + 3: pci_0000_c9_00_0 + 4: pci_0000_c10_00_0 copper: - free: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - 5: pci_0000_c5_00_0 - 6: pci_0000_c5_00_1 - 7: pci_0000_c5_00_2 - 8: pci_0000_c5_00_3 - claimed: {} + 1: pci_0000_c4_00_0 + 2: pci_0000_c4_00_1 + 3: pci_0000_c4_00_2 + 4: pci_0000_c4_00_3 + 5: pci_0000_c5_00_0 + 6: pci_0000_c5_00_1 + 7: pci_0000_c5_00_2 + 8: pci_0000_c5_00_3 sfp: - free: - 9: pci_0000_41_00_0 - 10: pci_0000_41_00_1 - claimed: {} + 9: pci_0000_02_00_0 + 10: pci_0000_02_00_1 + 11: pci_0000_41_00_0 + 12: pci_0000_41_00_1 \ No newline at end of file diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index f935b2075..80e49813a 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -8,9 +8,9 @@ """ Salt Engine for Virtual Node Management -This engine manages the automated provisioning of virtual machines in Security Onion's -virtualization infrastructure. It monitors directories for VM creation requests and -handles the entire provisioning process including hardware allocation. +This engine manages the automated provisioning of virtual machines in Security Onion's +virtualization infrastructure. It processes VM configurations from a nodes file and handles +the entire provisioning process including hardware allocation, state tracking, and file ownership. Usage: engines: @@ -19,31 +19,55 @@ Usage: base_path: /opt/so/saltstack/local/salt/hypervisor/hosts Options: - interval: Time in seconds between directory scans (default: 30) - base_path: Base directory to monitor for VM requests (default: /opt/so/saltstack/local/salt/hypervisor/hosts) + interval: Time in seconds between processing cycles (default: 30) + base_path: Base directory containing hypervisor configurations (default: /opt/so/saltstack/local/salt/hypervisor/hosts) - Memory values in VM configuration YAML files should be specified in GB. These values + Memory values in VM configuration should be specified in GB. These values will automatically be converted to MiB when passed to so-salt-cloud. +Configuration Files: + nodes: JSON file containing VM configurations + - Located at //nodes + - Contains array of VM configurations + - Each VM config specifies hardware and network settings + + defaults.yaml: Hardware capabilities configuration + - Located at /opt/so/saltstack/default/salt/hypervisor/defaults.yaml + - Defines available hardware per model + - Maps hardware indices to PCI IDs + Examples: 1. Basic Configuration: engines: - virtual_node_manager: {} - Uses default settings to monitor for VM requests. + Uses default settings to process VM configurations. - 2. Custom Scan Interval: + 2. Custom Interval: engines: - virtual_node_manager: interval: 60 - Scans for new requests every 60 seconds. + Processes configurations every 60 seconds. + +State Files: + VM Tracking Files: + - : Active VM configuration and status + - _failed: Failed VM creation details + - _invalidHW: Invalid hardware request details + + Lock Files: + - .lock: Prevents concurrent processing of VMs + - Contains VM name and timestamp + - Automatically removed after processing Notes: - Requires 'hvn' feature license - - Monitors for files named: add_sensor, add_searchnode, add_idh, add_receiver, add_heavynode, add_fleet - - Hardware allocation is tracked in hypervisor YAML files - - Creates VM-specific hardware tracking files + - Uses hypervisor's sosmodel grain for hardware capabilities + - Hardware allocation based on model-specific configurations + - All created files maintain socore ownership + - Comprehensive logging for troubleshooting + - Lock files prevent concurrent processing Description: The engine operates in the following phases: @@ -52,22 +76,26 @@ Description: - Verifies 'hvn' feature is licensed - Prevents operation if license is invalid - 2. File Monitoring - - Scans configured directory for add_* files - - Parses VM configuration from YAML + 2. Configuration Processing + - Reads nodes file from each hypervisor directory - Validates configuration parameters + - Compares against existing VM tracking files 3. Hardware Allocation - - Reads hypervisor hardware inventory - - Claims requested PCI devices - - Updates hardware tracking - - Creates VM hardware record + - Retrieves hypervisor model from grains cache + - Loads model-specific hardware capabilities + - Validates hardware requests against model limits + - Converts hardware indices to PCI IDs + - Ensures proper type handling for hardware indices + - Creates state tracking files with socore ownership 4. VM Provisioning - - Executes so-salt-cloud with configuration - - Handles network setup - - Configures hardware passthrough - - Manages VM startup + - Creates lock file to prevent concurrent operations + - Executes so-salt-cloud with validated configuration + - Handles network setup (static/DHCP) + - Configures hardware passthrough with converted PCI IDs + - Updates VM state tracking + - Removes lock file after completion Exit Codes: 0: Success @@ -75,19 +103,41 @@ Exit Codes: 2: Configuration error 3: Hardware allocation failure 4: VM provisioning failure + 5: Invalid hardware request Logging: Log files are written to /opt/so/log/salt/engines/virtual_node_manager.log - Critical operations, errors, and hardware allocation events are logged + Comprehensive logging includes: + - Hardware validation details + - PCI ID conversion process + - Command execution details + - Error conditions with full context + - File ownership operations + - Lock file management """ import os import glob import yaml +import json import time import logging import subprocess -from typing import Dict, List, Optional, Tuple +import pwd +import grp +import salt.config +import salt.runner +from typing import Dict, List, Optional, Tuple, Any +from datetime import datetime + +# Get socore uid/gid +SOCORE_UID = pwd.getpwnam('socore').pw_uid +SOCORE_GID = grp.getgrnam('socore').gr_gid + +# Initialize Salt runner once +opts = salt.config.master_config('/etc/salt/master') +opts['output'] = 'json' +runner = salt.runner.RunnerClient(opts) # Configure logging log = logging.getLogger(__name__) @@ -98,20 +148,52 @@ DEFAULT_INTERVAL = 30 DEFAULT_BASE_PATH = '/opt/so/saltstack/local/salt/hypervisor/hosts' VALID_ROLES = ['sensor', 'searchnode', 'idh', 'receiver', 'heavynode', 'fleet'] LICENSE_PATH = '/opt/so/saltstack/local/pillar/soc/license.sls' +DEFAULTS_PATH = '/opt/so/saltstack/default/salt/hypervisor/defaults.yaml' -def ensure_claimed_section(hw_config: dict) -> dict: +def read_json_file(file_path: str) -> Any: """ - Ensure the claimed section exists and is a dict. - - Args: - hw_config: Hardware configuration section containing 'claimed' key - - Returns: - The claimed section as a dict + Read and parse a JSON file. + Returns an empty array if the file is empty. """ - if hw_config['claimed'] is None or not isinstance(hw_config['claimed'], dict): - hw_config['claimed'] = {} - return hw_config['claimed'] + try: + with open(file_path, 'r') as f: + content = f.read().strip() + if not content: + return [] + return json.loads(content) + except Exception as e: + log.error("Failed to read JSON file %s: %s", file_path, str(e)) + raise + +def set_socore_ownership(path: str) -> None: + """Set socore ownership on file or directory.""" + try: + os.chown(path, SOCORE_UID, SOCORE_GID) + log.debug("Set socore ownership on %s", path) + except Exception as e: + log.error("Failed to set socore ownership on %s: %s", path, str(e)) + raise + +def write_json_file(file_path: str, data: Any) -> None: + """Write data to a JSON file with socore ownership.""" + try: + # Create parent directory if it doesn't exist + os.makedirs(os.path.dirname(file_path), exist_ok=True) + with open(file_path, 'w') as f: + json.dump(data, f, indent=2) + set_socore_ownership(file_path) + except Exception as e: + log.error("Failed to write JSON file %s: %s", file_path, str(e)) + raise + +def read_yaml_file(file_path: str) -> dict: + """Read and parse a YAML file.""" + try: + with open(file_path, 'r') as f: + return yaml.safe_load(f) + except Exception as e: + log.error("Failed to read YAML file %s: %s", file_path, str(e)) + raise def convert_pci_id(pci_id: str) -> str: """ @@ -127,218 +209,245 @@ def convert_pci_id(pci_id: str) -> str: >>> convert_pci_id('pci_0000_c7_00_0') '0000:c7:00.0' """ - # Remove 'pci_' prefix - pci_id = pci_id.replace('pci_', '') - - # Split into components - parts = pci_id.split('_') - if len(parts) != 4: - raise ValueError(f"Invalid PCI ID format: {pci_id}. Expected format: pci_domain_bus_slot_function") + try: + # Remove 'pci_' prefix + pci_id = pci_id.replace('pci_', '') - # Reconstruct with proper format (using period for function) - domain, bus, slot, function = parts - return f"{domain}:{bus}:{slot}.{function}" + # Split into components + parts = pci_id.split('_') + if len(parts) != 4: + raise ValueError(f"Invalid PCI ID format: {pci_id}. Expected format: pci_domain_bus_slot_function") + + # Reconstruct with proper format (using period for function) + domain, bus, slot, function = parts + return f"{domain}:{bus}:{slot}.{function}" + except Exception as e: + log.error("Failed to convert PCI ID %s: %s", pci_id, str(e)) + raise -class HardwareManager: - """ - Manages hardware allocation and tracking for virtual machines. - Handles reading hypervisor configuration, claiming PCI devices, - and maintaining hardware tracking files. +def create_lock_file(hypervisor_path: str, vm_name: str) -> bool: + """Create .lock file for VM processing.""" + lock_file = os.path.join(hypervisor_path, '.lock') + try: + if os.path.exists(lock_file): + log.warning("Lock file already exists at %s", lock_file) + return False + write_json_file(lock_file, { + 'vm': vm_name, + 'timestamp': datetime.now().isoformat() + }) + return True + except Exception as e: + log.error("Failed to create lock file: %s", str(e)) + return False + +def remove_lock_file(hypervisor_path: str) -> None: + """Remove .lock file after processing.""" + lock_file = os.path.join(hypervisor_path, '.lock') + try: + if os.path.exists(lock_file): + os.remove(lock_file) + except Exception as e: + log.error("Failed to remove lock file: %s", str(e)) + +def is_locked(hypervisor_path: str) -> bool: + """Check if hypervisor directory is locked.""" + return os.path.exists(os.path.join(hypervisor_path, '.lock')) + +def get_hypervisor_model(hypervisor: str) -> str: + """Get sosmodel from hypervisor grains.""" + log.info(hypervisor) #MOD + try: + # Get cached grains using Salt runner + grains = runner.cmd( + 'cache.grains', + [f'{hypervisor}_*', 'glob'] + ) + log.info(grains) #MOD + if not grains: + raise ValueError(f"No grains found for hypervisor {hypervisor}") + + # Get the first minion ID that matches our hypervisor + minion_id = next(iter(grains.keys())) + log.info(minion_id) #MOD + model = grains[minion_id].get('sosmodel') + log.info(model) #MOD + if not model: + raise ValueError(f"No sosmodel grain found for hypervisor {hypervisor}") + + log.debug("Found model %s for hypervisor %s", model, hypervisor) + return model + + except Exception as e: + log.error("Failed to get hypervisor model: %s", str(e)) + raise + +def load_hardware_defaults(model: str) -> dict: + """Load hardware configuration from defaults.yaml.""" + try: + defaults = read_yaml_file(DEFAULTS_PATH) + if not defaults or 'hypervisor' not in defaults: + raise ValueError("Invalid defaults.yaml structure") + if 'model' not in defaults['hypervisor']: + raise ValueError("No model configurations found in defaults.yaml") + if model not in defaults['hypervisor']['model']: + raise ValueError(f"Model {model} not found in defaults.yaml") + return defaults['hypervisor']['model'][model] + except Exception as e: + log.error("Failed to load hardware defaults: %s", str(e)) + raise + +def validate_hardware_request(model_config: dict, requested_hw: dict) -> Tuple[bool, Optional[dict]]: """ + Validate hardware request against model capabilities. - def __init__(self, hypervisor: str, base_path: str): - """Initialize the hardware manager for a specific hypervisor.""" - self.hypervisor = hypervisor - self.base_path = base_path - self.hypervisor_file = os.path.join(base_path, hypervisor, f"{hypervisor}.yaml") - - def read_hypervisor_config(self) -> dict: - """ - Read and initialize the hypervisor's hardware configuration file. - Ensures all hardware sections have a valid claimed section. - """ + Returns: + Tuple of (is_valid, error_details) + """ + errors = {} + log.debug("Validating hardware request: %s", requested_hw) + log.debug("Against model config: %s", model_config['hardware']) + + # Validate CPU + if 'cpu' in requested_hw: try: - with open(self.hypervisor_file, 'r') as f: - config = yaml.safe_load(f) - - # Initialize any null claimed sections - modified = False - for hw_type in ['disk', 'copper', 'sfp']: - hw_config = config['hypervisor']['hardware'][hw_type] - if hw_config['claimed'] is None: - log.debug("Initializing null claimed section for %s", hw_type) - hw_config['claimed'] = {} - modified = True - - # Save if we made any changes - if modified: - log.info("Updating hypervisor config with initialized claimed sections") - self.write_hypervisor_config(config) - - return config - except Exception as e: - log.error("Failed to read hypervisor configuration: %s", str(e)) - raise + cpu_count = int(requested_hw['cpu']) + log.debug("Validating CPU request: %d against maximum: %d", + cpu_count, model_config['hardware']['cpu']) + if cpu_count > model_config['hardware']['cpu']: + errors['cpu'] = f"Requested {cpu_count} CPU cores exceeds maximum {model_config['hardware']['cpu']}" + except ValueError: + errors['cpu'] = "Invalid CPU value" - def write_hypervisor_config(self, config: dict) -> None: - """Write updated configuration back to the hypervisor file.""" + # Validate Memory + if 'memory' in requested_hw: try: - with open(self.hypervisor_file, 'w') as f: - yaml.dump(config, f, default_flow_style=False) - except Exception as e: - log.error("Failed to write hypervisor configuration: %s", str(e)) - raise + memory = int(requested_hw['memory']) + log.debug("Validating memory request: %dGB against maximum: %dGB", + memory, model_config['hardware']['memory']) + if memory > model_config['hardware']['memory']: + errors['memory'] = f"Requested {memory}GB memory exceeds maximum {model_config['hardware']['memory']}GB" + except ValueError: + errors['memory'] = "Invalid memory value" - def get_pci_ids(self, hw_type: str, indices: Optional[List[int]]) -> List[str]: - """ - Look up PCI IDs for requested hardware indices. - - Args: - hw_type: Type of hardware (disk, copper, sfp) - indices: List of hardware indices to look up, or None if no hardware requested - - Returns: - List of PCI IDs - """ - # Skip if no indices provided - if indices is None: - return [] - - config = self.read_hypervisor_config() - log.debug("Full config structure: %s", config) - log.debug("Looking up indices %s for hardware type %s", indices, hw_type) - pci_ids = [] - - try: - hardware_section = config['hypervisor']['hardware'] - log.debug("Hardware section: %s", hardware_section) - if hw_type not in hardware_section: - raise ValueError(f"Hardware type {hw_type} not found in configuration") - - hw_config = hardware_section[hw_type] - free_hw = hw_config['free'] - claimed_hw = ensure_claimed_section(hw_config) - - log.debug("Free hardware section for %s: %s", hw_type, free_hw) - log.debug("Claimed hardware section for %s: %s", hw_type, claimed_hw) - - for idx in indices: - if idx in free_hw: - pci_id = convert_pci_id(free_hw[idx]) - log.debug("Converting PCI ID from %s to %s", free_hw[idx], pci_id) - pci_ids.append(pci_id) - elif idx in claimed_hw: - raise ValueError(f"Hardware index {idx} for {hw_type} is already claimed") - else: - raise ValueError(f"Hardware index {idx} for {hw_type} does not exist") - except KeyError as e: - log.error("Invalid hardware configuration structure: %s", str(e)) - raise - - return pci_ids + # Validate PCI devices + for hw_type in ['disk', 'copper', 'sfp']: + if hw_type in requested_hw and requested_hw[hw_type]: + try: + indices = [int(x) for x in str(requested_hw[hw_type]).split(',')] + log.debug("Validating %s indices: %s", hw_type, indices) + + if hw_type not in model_config['hardware']: + log.error("Hardware type %s not found in model config", hw_type) + errors[hw_type] = f"No {hw_type} configuration found in model" + continue + + available_indices = set(int(k) for k in model_config['hardware'][hw_type].keys()) + log.debug("Available %s indices: %s", hw_type, available_indices) + + invalid_indices = [idx for idx in indices if idx not in available_indices] + if invalid_indices: + log.error("Invalid %s indices found: %s", hw_type, invalid_indices) + errors[hw_type] = f"Invalid {hw_type} indices: {invalid_indices}" + except ValueError: + log.error("Invalid %s indices format: %s", hw_type, requested_hw[hw_type]) + errors[hw_type] = f"Invalid {hw_type} indices format" + except KeyError: + log.error("No %s configuration found in model", hw_type) + errors[hw_type] = f"No {hw_type} configuration found in model" - def claim_cpu_memory(self, cpu_count: Optional[int], memory_gb: Optional[int]) -> None: - """ - Claim CPU cores and memory from the free pool. + if errors: + log.error("Hardware validation failed with errors: %s", errors) + else: + log.debug("Hardware validation successful") - Args: - cpu_count: Number of CPU cores to claim, or None if no CPU requested - memory_gb: Amount of memory in GB to claim, or None if no memory requested - - Raises: - ValueError: If requested resources exceed available resources - """ - if cpu_count is None and memory_gb is None: - return - - config = self.read_hypervisor_config() - hw_config = config['hypervisor']['hardware'] - - # Validate and claim CPU cores - if cpu_count is not None: - if cpu_count > hw_config['cpu']['free']: - raise ValueError(f"Not enough CPU cores available. Requested: {cpu_count}, Free: {hw_config['cpu']['free']}") - hw_config['cpu']['free'] -= cpu_count - - # Validate and claim memory - if memory_gb is not None: - if memory_gb > hw_config['memory']['free']: - raise ValueError(f"Not enough memory available. Requested: {memory_gb}GB, Free: {hw_config['memory']['free']}GB") - hw_config['memory']['free'] -= memory_gb - - self.write_hypervisor_config(config) - log.info("Successfully claimed CPU cores: %s, Memory: %sGB", cpu_count, memory_gb) + return (len(errors) == 0, errors if errors else None) - def release_cpu_memory(self, cpu_count: Optional[int], memory_gb: Optional[int]) -> None: - """ - Release CPU cores and memory back to the free pool. - - Args: - cpu_count: Number of CPU cores to release, or None if no CPU to release - memory_gb: Amount of memory in GB to release, or None if no memory to release - """ - if cpu_count is None and memory_gb is None: - return +def check_hardware_availability(hypervisor_path: str, vm_name: str) -> bool: + """Check if requested hardware is already claimed by another VM.""" + try: + # List all VM tracking files + files = glob.glob(os.path.join(hypervisor_path, '*_*')) + for file_path in files: + # Skip the VM we're checking and any failed/invalid VMs + basename = os.path.basename(file_path) + if basename.startswith(vm_name) or '_failed' in basename or '_invalidHW' in basename: + continue - config = self.read_hypervisor_config() - hw_config = config['hypervisor']['hardware'] - - # Return CPU cores to free pool - if cpu_count is not None: - hw_config['cpu']['free'] += cpu_count - - # Return memory to free pool - if memory_gb is not None: - hw_config['memory']['free'] += memory_gb - - self.write_hypervisor_config(config) - log.info("Successfully released CPU cores: %s, Memory: %sGB", cpu_count, memory_gb) + # Check if any hardware overlaps + vm_config = read_json_file(file_path) + if 'hardware' in vm_config and 'allocated' in vm_config['hardware']: + # TODO: Implement hardware conflict checking + pass + return True + except Exception as e: + log.error("Failed to check hardware availability: %s", str(e)) + return False - def claim_hardware(self, hw_type: str, indices: List[int]) -> None: - """ - Move hardware from free to claimed in the hypervisor configuration. +def create_vm_tracking_file(hypervisor_path: str, vm_name: str, config: dict) -> None: + """Create VM tracking file with initial state.""" + file_path = os.path.join(hypervisor_path, vm_name) + log.debug("Creating VM tracking file at %s", file_path) + try: + # Create parent directory if it doesn't exist + os.makedirs(os.path.dirname(file_path), exist_ok=True) + set_socore_ownership(os.path.dirname(file_path)) - Args: - hw_type: Type of hardware (disk, copper, sfp) - indices: List of hardware indices to claim - """ - config = self.read_hypervisor_config() - - try: - hw_config = config['hypervisor']['hardware'][hw_type] - ensure_claimed_section(hw_config) - - for idx in indices: - if idx in hw_config['free']: - pci_id = hw_config['free'][idx] - hw_config['claimed'][idx] = pci_id - del hw_config['free'][idx] - else: - raise ValueError(f"{hw_type} hardware index {idx} not available") - - self.write_hypervisor_config(config) - log.info("Successfully claimed %s hardware indices: %s", hw_type, indices) - except Exception as e: - log.error("Failed to claim hardware: %s", str(e)) - raise + data = { + 'config': config, + 'status': 'creating', + 'hardware': { + 'allocated': {} + } + } + # Write file and set ownership + with open(file_path, 'w') as f: + json.dump(data, f, indent=2) + set_socore_ownership(file_path) + log.debug("Successfully created VM tracking file with socore ownership") + except Exception as e: + log.error("Failed to create VM tracking file: %s", str(e)) + raise - def create_vm_hardware_file(self, hostname: str, role: str, hardware: dict) -> None: - """ - Create a YAML file tracking hardware allocated to a VM. - - Args: - hostname: Name of the VM - role: VM role (sensor, searchnode, etc.) - hardware: Dictionary of allocated hardware - """ - vm_file = os.path.join(self.base_path, self.hypervisor, f"{hostname}_{role}.yaml") - try: - with open(vm_file, 'w') as f: - yaml.dump({'hardware': hardware}, f, default_flow_style=False) - log.info("Created hardware tracking file for %s_%s", hostname, role) - except Exception as e: - log.error("Failed to create VM hardware file: %s", str(e)) - raise +def mark_vm_failed(vm_file: str, error_code: int, message: str) -> None: + """Mark VM as failed with error details.""" + try: + # Rename file to add _failed suffix if not already present + if not vm_file.endswith('_failed'): + new_file = f"{vm_file}_failed" + os.rename(vm_file, new_file) + vm_file = new_file + + # Update file contents + data = read_json_file(vm_file) + data['status'] = 'failed' + data['error'] = { + 'code': error_code, + 'message': message, + 'timestamp': datetime.now().isoformat() + } + write_json_file(vm_file, data) + except Exception as e: + log.error("Failed to mark VM as failed: %s", str(e)) + raise + +def mark_invalid_hardware(hypervisor_path: str, vm_name: str, config: dict, error_details: dict) -> None: + """Create invalid hardware tracking file with error details.""" + file_path = os.path.join(hypervisor_path, f"{vm_name}_invalidHW") + try: + data = { + 'config': config, + 'error': { + 'code': 5, + 'message': "Invalid hardware configuration", + 'invalid_hardware': error_details, + 'timestamp': datetime.now().isoformat() + } + } + write_json_file(file_path, data) + except Exception as e: + log.error("Failed to create invalid hardware file: %s", str(e)) + raise def validate_hvn_license() -> bool: """Check if the license file exists and contains required values.""" @@ -374,211 +483,215 @@ def validate_hvn_license() -> bool: log.error("LICENSE: Error reading license file: %s", str(e)) return False -def parse_add_file(file_path: str) -> Tuple[str, str, dict]: - """ - Parse an add_* file to extract VM configuration. +def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: + """Process a single VM creation request.""" + # Get the actual hypervisor name (last directory in path) + hypervisor = os.path.basename(hypervisor_path) + vm_name = f"{vm_config['hostname']}_{vm_config['role']}" - Returns: - Tuple of (hypervisor, role, config) - """ try: - # Extract hypervisor and role from path - path_parts = file_path.split(os.path.sep) - hypervisor = path_parts[-2] - role = path_parts[-1].replace('add_', '') - - if role not in VALID_ROLES: - raise ValueError(f"Invalid role: {role}") - - # Read and parse YAML configuration - with open(file_path, 'r') as f: - config = yaml.safe_load(f) - - required_fields = ['hostname', 'network_mode'] - if config.get('network_mode') == 'static4': - required_fields.extend(['ip4', 'gw4']) - - for field in required_fields: - if field not in config: - raise ValueError(f"Missing required field: {field}") - - # Validate hardware sections - for hw_type in ['disk', 'copper', 'sfp']: - if hw_type in config and config[hw_type] is not None: - if not isinstance(config[hw_type], list): - raise ValueError(f"{hw_type} must be a list when present") - - return hypervisor, role, config - except Exception as e: - log.error("Failed to parse add file %s: %s", file_path, str(e)) - raise + # Create lock file + if not create_lock_file(hypervisor_path, vm_name): + return -def convert_gb_to_mib(gb: int) -> int: - """ - Convert memory value from GB to MiB. - - Args: - gb: Memory value in gigabytes - - Returns: - Memory value in mebibytes (1 GB = 1024 MiB) - """ - return gb * 1024 + # Get hypervisor model and capabilities + model = get_hypervisor_model(hypervisor) + model_config = load_hardware_defaults(model) -def execute_salt_cloud(profile: str, hostname: str, role: str, config: dict, pci_ids: List[str]) -> None: - """ - Execute so-salt-cloud to create the VM. - - Args: - profile: Salt cloud profile name - hostname: VM hostname - role: VM role - config: VM configuration - pci_ids: List of PCI IDs for hardware passthrough - """ - try: - cmd = ['so-salt-cloud', '-p', f'sool9-{profile}', f'{hostname}_{role}'] + # Validate hardware request + is_valid, errors = validate_hardware_request(model_config, vm_config) + if not is_valid: + mark_invalid_hardware(hypervisor_path, vm_name, vm_config, errors) + return + + # Check hardware availability + if not check_hardware_availability(hypervisor_path, vm_name): + mark_vm_failed(os.path.join(hypervisor_path, vm_name), 3, + "Requested hardware is already in use") + return + + # Create tracking file + create_vm_tracking_file(hypervisor_path, vm_name, vm_config) + + # Build so-salt-cloud command + log.debug("Building so-salt-cloud command for VM %s", vm_name) + cmd = ['so-salt-cloud', '-p', f'sool9-{hypervisor}', vm_name] + log.debug("Base command: %s", ' '.join(cmd)) # Add network configuration - if config['network_mode'] == 'static4': - cmd.extend(['--static4', '--ip4', config['ip4'], '--gw4', config['gw4']]) - if 'dns4' in config: - cmd.extend(['--dns4', ','.join(config['dns4'])]) - if 'search4' in config: - cmd.extend(['--search4', config['search4']]) + if vm_config['network_mode'] == 'static4': + log.debug("Adding static network configuration") + cmd.extend(['--static4', '--ip4', vm_config['ip4'], '--gw4', vm_config['gw4']]) + if 'dns4' in vm_config: + cmd.extend(['--dns4', vm_config['dns4']]) + if 'search4' in vm_config: + cmd.extend(['--search4', vm_config['search4']]) else: + log.debug("Using DHCP network configuration") cmd.append('--dhcp4') # Add hardware configuration - if 'cpu' in config: - cmd.extend(['-c', str(config['cpu'])]) - if 'memory' in config: - # Convert memory from GB to MiB for so-salt-cloud - memory_mib = convert_gb_to_mib(config['memory']) + if 'cpu' in vm_config: + log.debug("Adding CPU configuration: %s cores", vm_config['cpu']) + cmd.extend(['-c', str(vm_config['cpu'])]) + if 'memory' in vm_config: + memory_mib = int(vm_config['memory']) * 1024 + log.debug("Adding memory configuration: %sGB (%sMiB)", vm_config['memory'], memory_mib) cmd.extend(['-m', str(memory_mib)]) - # Add PCI devices - for pci_id in pci_ids: - cmd.extend(['-P', pci_id]) - - log.info("Executing: %s", ' '.join(cmd)) - subprocess.run(cmd, check=True) - except subprocess.CalledProcessError as e: - log.error("so-salt-cloud execution failed: %s", str(e)) - raise - except Exception as e: - log.error("Failed to execute so-salt-cloud: %s", str(e)) - raise - -def release_hardware(hw_manager: HardwareManager, hw_type: str, indices: List[int], - cpu_count: Optional[int] = None, memory_gb: Optional[int] = None) -> None: - """ - Release claimed hardware back to free pool. - - Args: - hw_manager: HardwareManager instance - hw_type: Type of hardware (disk, copper, sfp) - indices: List of hardware indices to release - cpu_count: Number of CPU cores to release, or None if no CPU to release - memory_gb: Amount of memory in GB to release, or None if no memory to release - """ - config = hw_manager.read_hypervisor_config() - hw_config = config['hypervisor']['hardware'][hw_type] - - for idx in indices: - if idx in hw_config['claimed']: - pci_id = hw_config['claimed'][idx] - hw_config['free'][idx] = pci_id - del hw_config['claimed'][idx] - - hw_manager.write_hypervisor_config(config) - log.info("Released %s hardware indices: %s", hw_type, indices) - -def process_add_file(file_path: str, base_path: str) -> None: - """ - Process a single add_* file for VM creation. - - Args: - file_path: Path to the add_* file - base_path: Base path for hypervisor configuration - """ - try: - hypervisor, role, config = parse_add_file(file_path) - log.debug("Parsed config from add file: %s", config) - hw_manager = HardwareManager(hypervisor, base_path) - - # Phase 1: Collect all hardware information without claiming - pci_ids = [] - hardware_to_claim = {} # Store hardware to claim for each type - hardware_tracking = { - 'cpu': config.get('cpu'), - 'memory': config.get('memory') - } - - # Validate all hardware first + # Add PCI devices with proper conversion for hw_type in ['disk', 'copper', 'sfp']: - indices = config.get(hw_type) - if indices is not None: - # Validate indices are available before claiming - hw_pci_ids = hw_manager.get_pci_ids(hw_type, indices) - if hw_pci_ids: - hardware_to_claim[hw_type] = indices - pci_ids.extend(hw_pci_ids) - hardware_tracking[hw_type] = [ - {'id': idx, 'pci': pci_id} - for idx, pci_id in zip(indices, hw_pci_ids) - ] - - # Phase 2: Claim hardware only after all validation passes + if hw_type in vm_config and vm_config[hw_type]: + log.debug("Processing %s hardware configuration", hw_type) + indices = [int(x) for x in str(vm_config[hw_type]).split(',')] + log.debug("Requested %s indices: %s", hw_type, indices) + for idx in indices: + try: + log.debug("Looking up PCI ID for %s index %d in model config", hw_type, idx) + log.debug("Model config for %s: %s", hw_type, model_config['hardware'][hw_type]) + + # Convert all keys to integers for comparison + hw_config = {int(k): v for k, v in model_config['hardware'][hw_type].items()} + log.debug("Converted hardware config: %s", hw_config) + + pci_id = hw_config[idx] + log.debug("Found PCI ID for %s index %d: %s", hw_type, idx, pci_id) + converted_pci_id = convert_pci_id(pci_id) + log.debug("Converted PCI ID from %s to %s", pci_id, converted_pci_id) + cmd.extend(['-P', converted_pci_id]) + except Exception as e: + log.error("Failed to process PCI ID for %s index %d: %s", hw_type, idx, str(e)) + log.error("Hardware config keys: %s, looking for index: %s", + list(model_config['hardware'][hw_type].keys()), idx) + raise + + # Execute so-salt-cloud + log.info("Executing command: %s", ' '.join(cmd)) try: - # Claim CPU and memory first - cpu_count = config.get('cpu') - memory_gb = config.get('memory') - hw_manager.claim_cpu_memory(cpu_count, memory_gb) - - # Then claim PCI hardware - for hw_type, indices in hardware_to_claim.items(): - hw_manager.claim_hardware(hw_type, indices) - - # Create VM - execute_salt_cloud(hypervisor, config['hostname'], role, config, pci_ids) - - # Create hardware tracking file - hw_manager.create_vm_hardware_file(config['hostname'], role, hardware_tracking) - - log.info("Successfully processed VM creation request: %s_%s", - config['hostname'], role) - - except Exception as e: - # If anything fails after claiming, release all hardware - log.error("Failed after hardware claim, attempting to release hardware: %s", str(e)) - - # Release CPU and memory - try: - hw_manager.release_cpu_memory(cpu_count, memory_gb) - except Exception as release_error: - log.error("Failed to release CPU/memory: %s", str(release_error)) - - # Release PCI hardware - for hw_type, indices in hardware_to_claim.items(): - try: - release_hardware(hw_manager, hw_type, indices) - except Exception as release_error: - log.error("Failed to release %s hardware %s: %s", - hw_type, indices, str(release_error)) + result = subprocess.run(cmd, capture_output=True, text=True, check=True) + log.debug("Command completed successfully") + log.debug("Command stdout: %s", result.stdout) + if result.stderr: + log.warning("Command stderr (non-fatal): %s", result.stderr) + except subprocess.CalledProcessError as e: + error_msg = f"so-salt-cloud execution failed (code {e.returncode})" + if e.stdout: + log.error("Command stdout: %s", e.stdout) + if e.stderr: + log.error("Command stderr: %s", e.stderr) + error_msg = f"{error_msg}: {e.stderr}" + log.error(error_msg) + mark_vm_failed(os.path.join(hypervisor_path, vm_name), 4, error_msg) raise - - finally: - # Always clean up the add file - try: - os.remove(file_path) - log.info("Cleaned up add file: %s", file_path) - except Exception as e: - log.error("Failed to clean up add file: %s", str(e)) - - except Exception as e: - log.error("Failed to process add file %s: %s", file_path, str(e)) + + # Update tracking file status + tracking_file = os.path.join(hypervisor_path, vm_name) + data = read_json_file(tracking_file) + data['status'] = 'running' + write_json_file(tracking_file, data) + log.info("Successfully updated VM status to running") + + except subprocess.CalledProcessError as e: + error_msg = f"so-salt-cloud execution failed (code {e.returncode})" + if e.stdout: + log.error("Command stdout: %s", e.stdout) + if e.stderr: + log.error("Command stderr: %s", e.stderr) + error_msg = f"{error_msg}: {e.stderr}" + log.error(error_msg) + mark_vm_failed(os.path.join(hypervisor_path, vm_name), 4, error_msg) raise + except Exception as e: + error_msg = f"VM creation failed: {str(e)}" + log.error(error_msg) + # If we haven't created the tracking file yet, create a failed one + if not os.path.exists(os.path.join(hypervisor_path, vm_name)): + mark_vm_failed(os.path.join(hypervisor_path, f"{vm_name}_failed"), 4, error_msg) + finally: + remove_lock_file(hypervisor_path) + +def process_vm_deletion(hypervisor_path: str, vm_name: str) -> None: + """Process a single VM deletion request.""" + try: + if not create_lock_file(hypervisor_path, vm_name): + return + + # Get the actual hypervisor name (last directory in path) + hypervisor = os.path.basename(hypervisor_path) + cmd = ['so-salt-cloud', '-p', f'sool9-{hypervisor}', vm_name, '-yd'] + + log.info("Executing: %s", ' '.join(cmd)) + result = subprocess.run(cmd, capture_output=True, text=True) + + # Log command output + if result.stdout: + log.debug("Command stdout: %s", result.stdout) + if result.stderr: + log.warning("Command stderr: %s", result.stderr) + + # Check return code + if result.returncode != 0: + error_msg = f"so-salt-cloud deletion failed (code {result.returncode}): {result.stderr}" + log.error(error_msg) + raise subprocess.CalledProcessError( + result.returncode, cmd, + output=result.stdout, + stderr=result.stderr + ) + + # Remove VM tracking file + vm_file = os.path.join(hypervisor_path, vm_name) + if os.path.exists(vm_file): + os.remove(vm_file) + log.info("Successfully removed VM tracking file") + + except Exception as e: + log.error("Error processing VM deletion: %s", str(e)) + raise + finally: + remove_lock_file(hypervisor_path) + +def process_hypervisor(hypervisor_path: str) -> None: + """Process VM configurations for a single hypervisor.""" + try: + if is_locked(hypervisor_path): + return + + # Read nodes file + nodes_file = os.path.join(hypervisor_path, 'nodes') + if not os.path.exists(nodes_file): + return + + nodes_config = read_json_file(nodes_file) + if not nodes_config: + return + + # Get existing VMs + existing_vms = set() + for file_path in glob.glob(os.path.join(hypervisor_path, '*_*')): + basename = os.path.basename(file_path) + if not any(x in basename for x in ['_failed', '_invalidHW']): + existing_vms.add(basename) + + # Process new VMs + configured_vms = set() + for vm_config in nodes_config: + if 'hostname' not in vm_config or 'role' not in vm_config: + log.error("Invalid VM configuration: missing hostname or role") + continue + + vm_name = f"{vm_config['hostname']}_{vm_config['role']}" + configured_vms.add(vm_name) + + if vm_name not in existing_vms: + process_vm_creation(hypervisor_path, vm_config) + + # Process VM deletions + for vm_name in existing_vms - configured_vms: + process_vm_deletion(hypervisor_path, vm_name) + + except Exception as e: + log.error("Failed to process hypervisor %s: %s", hypervisor_path, str(e)) def start(interval: int = DEFAULT_INTERVAL, base_path: str = DEFAULT_BASE_PATH) -> None: @@ -586,8 +699,8 @@ def start(interval: int = DEFAULT_INTERVAL, Main engine loop. Args: - interval: Time in seconds between directory scans - base_path: Base path to monitor for VM requests + interval: Time in seconds between processing cycles + base_path: Base path containing hypervisor configurations """ log.info("Starting virtual node manager engine") @@ -596,23 +709,11 @@ def start(interval: int = DEFAULT_INTERVAL, while True: try: - pattern = os.path.join(base_path, '*', 'add_*') - log.debug("Scanning for VM request files with pattern: %s", pattern) - - try: - files = glob.glob(pattern) - if files: - log.debug("Found %d VM request file(s): %s", len(files), files) - - for file_path in files: - log.info("Processing VM request file: %s", file_path) - try: - process_add_file(file_path, base_path) - except Exception as e: - log.error("Failed to process file %s: %s", file_path, str(e)) - except Exception as e: - log.error("Error scanning for VM request files: %s", str(e)) - + # Process each hypervisor directory + for hypervisor_path in glob.glob(os.path.join(base_path, '*')): + if os.path.isdir(hypervisor_path): + process_hypervisor(hypervisor_path) + except Exception as e: log.error("Error in main engine loop: %s", str(e)) diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index 3a5d000a9..2b9a0d70e 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -21,8 +21,7 @@ hypervisor: uiElements: - field: hostname label: Enter the hostname - forcedType: string - - field: nodetype + - field: role label: sensor or searchnode - field: network_mode label: Choose static4 or dhcp4. If static4, populate IP details below. @@ -31,7 +30,7 @@ hypervisor: - field: gw4 label: Gateway - field: dns4 - label: DNS. Comma seperated list. ex. 192.168.1.1,8.8.8.8 + label: DNS. Comma separated list. ex. 192.168.1.1,8.8.8.8 - field: search4 label: Search domain - field: cpu @@ -39,11 +38,11 @@ hypervisor: - field: memory label: Memory, in GB to assign. ex. 16 - field: disk - label: Choose a disk or disks to assign for passthrough. Comma seperated list. + label: Choose a disk or disks to assign for passthrough. Comma separated list. - field: copper - label: Choose a copper port or ports to assign for passthrough. Comma seperated list. - - filed: sfp - label: Choose a sfp port or ports to assign for passthrough. Comma seperated list. + label: Choose a copper port or ports to assign for passthrough. Comma separated list. + - field: sfp + label: Choose a sfp port or ports to assign for passthrough. Comma separated list. file: true global: true diff --git a/salt/soc/dyanno/hypervisor/init.sls b/salt/soc/dyanno/hypervisor/init.sls index 31fe5ec93..a0b83fd5d 100644 --- a/salt/soc/dyanno/hypervisor/init.sls +++ b/salt/soc/dyanno/hypervisor/init.sls @@ -14,5 +14,10 @@ hypervisor_host_directory_{{hypervisor}}: file.directory: - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}} - makedirs: True + - user: socore + - group: socore + - recurse: + - user + - group {% endfor %} {% endfor %} From ad54afe39a7c529f68ff69b85acab7d8ecc935b0 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sat, 15 Feb 2025 12:11:23 -0500 Subject: [PATCH 127/303] ensure socore:socore ownership --- salt/manager/tools/sbin/so-minion | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index fad765756..cc78e69e1 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -272,6 +272,15 @@ function deleteMinionFiles () { } # Create the minion file +function ensure_socore_ownership() { + log "INFO" "Setting socore ownership on minion files" + chown -R socore:socore /opt/so/saltstack/local/pillar/minions/ + if [ $? -ne 0 ]; then + log "ERROR" "Failed to set socore ownership on minion files" + return 1 + fi +} + function create_minion_files() { mkdir -p /opt/so/saltstack/local/pillar/minions if [ $? -ne 0 ]; then @@ -292,6 +301,9 @@ function create_minion_files() { return 1 fi fi + + # Set proper ownership after file creation + ensure_socore_ownership || return 1 } # Add Elastic settings to the minion file @@ -996,6 +1008,9 @@ function setupMinionFiles() { # Create node-specific configuration create$NODETYPE || return 1 + # Ensure proper ownership after all content is written + ensure_socore_ownership || return 1 + log "INFO" "Successfully created minion files for $MINION_ID" } From ec2fc0a5f2740aee9d2a67b47aef9518dda09ed5 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sat, 15 Feb 2025 18:56:04 -0500 Subject: [PATCH 128/303] change locking method --- .../engines/master/virtual_node_manager.py | 302 ++++++++---------- 1 file changed, 137 insertions(+), 165 deletions(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index 80e49813a..5cce857b4 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -19,7 +19,7 @@ Usage: base_path: /opt/so/saltstack/local/salt/hypervisor/hosts Options: - interval: Time in seconds between processing cycles (default: 30) + interval: Time in seconds between engine runs (managed by salt-master, default: 30) base_path: Base directory containing hypervisor configurations (default: /opt/so/saltstack/local/salt/hypervisor/hosts) Memory values in VM configuration should be specified in GB. These values @@ -55,47 +55,52 @@ State Files: - : Active VM configuration and status - _failed: Failed VM creation details - _invalidHW: Invalid hardware request details - - Lock Files: - - .lock: Prevents concurrent processing of VMs - - Contains VM name and timestamp - - Automatically removed after processing - Notes: - Requires 'hvn' feature license - Uses hypervisor's sosmodel grain for hardware capabilities - Hardware allocation based on model-specific configurations - All created files maintain socore ownership - Comprehensive logging for troubleshooting - - Lock files prevent concurrent processing + - Single engine-wide lock prevents concurrent instances + - Lock remains if error occurs (requires admin intervention) Description: - The engine operates in the following phases: + The engine operates in the following phases: - 1. License Validation - - Verifies 'hvn' feature is licensed - - Prevents operation if license is invalid + 1. Engine Lock Acquisition + - Acquires single engine-wide lock + - Prevents multiple instances from running + - Lock remains until clean shutdown or error - 2. Configuration Processing - - Reads nodes file from each hypervisor directory - - Validates configuration parameters - - Compares against existing VM tracking files + 2. License Validation + - Verifies 'hvn' feature is licensed + - Prevents operation if license is invalid - 3. Hardware Allocation - - Retrieves hypervisor model from grains cache - - Loads model-specific hardware capabilities - - Validates hardware requests against model limits - - Converts hardware indices to PCI IDs - - Ensures proper type handling for hardware indices - - Creates state tracking files with socore ownership + 3. Configuration Processing + - Reads nodes file from each hypervisor directory + - Validates configuration parameters + - Compares against existing VM tracking files - 4. VM Provisioning - - Creates lock file to prevent concurrent operations - - Executes so-salt-cloud with validated configuration - - Handles network setup (static/DHCP) - - Configures hardware passthrough with converted PCI IDs - - Updates VM state tracking - - Removes lock file after completion + 4. Hardware Allocation + - Retrieves hypervisor model from grains cache + - Loads model-specific hardware capabilities + - Validates hardware requests against model limits + - Converts hardware indices to PCI IDs + - Ensures proper type handling for hardware indices + - Creates state tracking files with socore ownership + + 5. VM Provisioning + - Executes so-salt-cloud with validated configuration + - Handles network setup (static/DHCP) + - Configures hardware passthrough with converted PCI IDs + - Updates VM state tracking + + Lock Management: + - Lock acquired at engine start + - Released only on clean shutdown + - Remains if error occurs + - Admin must restart service to clear lock + - Error-level logging for lock issues Exit Codes: 0: Success @@ -129,6 +134,7 @@ import salt.config import salt.runner from typing import Dict, List, Optional, Tuple, Any from datetime import datetime +from threading import Lock # Get socore uid/gid SOCORE_UID = pwd.getpwnam('socore').pw_uid @@ -150,6 +156,9 @@ VALID_ROLES = ['sensor', 'searchnode', 'idh', 'receiver', 'heavynode', 'fleet'] LICENSE_PATH = '/opt/so/saltstack/local/pillar/soc/license.sls' DEFAULTS_PATH = '/opt/so/saltstack/default/salt/hypervisor/defaults.yaml' +# Single engine-wide lock for virtual node manager +engine_lock = Lock() + def read_json_file(file_path: str) -> Any: """ Read and parse a JSON file. @@ -225,53 +234,20 @@ def convert_pci_id(pci_id: str) -> str: log.error("Failed to convert PCI ID %s: %s", pci_id, str(e)) raise -def create_lock_file(hypervisor_path: str, vm_name: str) -> bool: - """Create .lock file for VM processing.""" - lock_file = os.path.join(hypervisor_path, '.lock') - try: - if os.path.exists(lock_file): - log.warning("Lock file already exists at %s", lock_file) - return False - write_json_file(lock_file, { - 'vm': vm_name, - 'timestamp': datetime.now().isoformat() - }) - return True - except Exception as e: - log.error("Failed to create lock file: %s", str(e)) - return False - -def remove_lock_file(hypervisor_path: str) -> None: - """Remove .lock file after processing.""" - lock_file = os.path.join(hypervisor_path, '.lock') - try: - if os.path.exists(lock_file): - os.remove(lock_file) - except Exception as e: - log.error("Failed to remove lock file: %s", str(e)) - -def is_locked(hypervisor_path: str) -> bool: - """Check if hypervisor directory is locked.""" - return os.path.exists(os.path.join(hypervisor_path, '.lock')) - def get_hypervisor_model(hypervisor: str) -> str: """Get sosmodel from hypervisor grains.""" - log.info(hypervisor) #MOD try: # Get cached grains using Salt runner grains = runner.cmd( 'cache.grains', [f'{hypervisor}_*', 'glob'] ) - log.info(grains) #MOD if not grains: raise ValueError(f"No grains found for hypervisor {hypervisor}") # Get the first minion ID that matches our hypervisor minion_id = next(iter(grains.keys())) - log.info(minion_id) #MOD model = grains[minion_id].get('sosmodel') - log.info(model) #MOD if not model: raise ValueError(f"No sosmodel grain found for hypervisor {hypervisor}") @@ -452,7 +428,7 @@ def mark_invalid_hardware(hypervisor_path: str, vm_name: str, config: dict, erro def validate_hvn_license() -> bool: """Check if the license file exists and contains required values.""" if not os.path.exists(LICENSE_PATH): - log.error("LICENSE: License file not found at %s", LICENSE_PATH) + log.error("License file not found at %s", LICENSE_PATH) return False try: @@ -460,14 +436,14 @@ def validate_hvn_license() -> bool: license_data = yaml.safe_load(f) if not license_data: - log.error("LICENSE: Empty or invalid license file") + log.error("Empty or invalid license file") return False license_id = license_data.get('license_id') features = license_data.get('features', []) if not license_id: - log.error("LICENSE: No license_id found in license file") + log.error("No license_id found in license file") return False if 'hvn' not in features: @@ -476,29 +452,35 @@ def validate_hvn_license() -> bool: "for more information about purchasing a license to enable this feature.") return False - log.info("LICENSE: License validation successful") + log.info("License validation successful") return True except Exception as e: - log.error("LICENSE: Error reading license file: %s", str(e)) + log.error("Error reading license file: %s", str(e)) return False def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: - """Process a single VM creation request.""" + """ + Process a single VM creation request. + + This function handles the creation of a new VM, including hardware validation, + resource allocation, and provisioning. All operations are protected by the + engine-wide lock that is acquired at engine start. + + Args: + hypervisor_path: Path to the hypervisor directory + vm_config: Dictionary containing VM configuration + """ # Get the actual hypervisor name (last directory in path) hypervisor = os.path.basename(hypervisor_path) vm_name = f"{vm_config['hostname']}_{vm_config['role']}" try: - # Create lock file - if not create_lock_file(hypervisor_path, vm_name): - return - # Get hypervisor model and capabilities model = get_hypervisor_model(hypervisor) model_config = load_hardware_defaults(model) - # Validate hardware request + # Initial hardware validation is_valid, errors = validate_hardware_request(model_config, vm_config) if not is_valid: mark_invalid_hardware(hypervisor_path, vm_name, vm_config, errors) @@ -506,97 +488,55 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: # Check hardware availability if not check_hardware_availability(hypervisor_path, vm_name): - mark_vm_failed(os.path.join(hypervisor_path, vm_name), 3, - "Requested hardware is already in use") + mark_vm_failed(os.path.join(hypervisor_path, vm_name), 3, + "Requested hardware is already in use") return # Create tracking file create_vm_tracking_file(hypervisor_path, vm_name, vm_config) - # Build so-salt-cloud command - log.debug("Building so-salt-cloud command for VM %s", vm_name) + # Build and execute so-salt-cloud command cmd = ['so-salt-cloud', '-p', f'sool9-{hypervisor}', vm_name] - log.debug("Base command: %s", ' '.join(cmd)) # Add network configuration if vm_config['network_mode'] == 'static4': - log.debug("Adding static network configuration") cmd.extend(['--static4', '--ip4', vm_config['ip4'], '--gw4', vm_config['gw4']]) if 'dns4' in vm_config: cmd.extend(['--dns4', vm_config['dns4']]) if 'search4' in vm_config: cmd.extend(['--search4', vm_config['search4']]) else: - log.debug("Using DHCP network configuration") cmd.append('--dhcp4') # Add hardware configuration if 'cpu' in vm_config: - log.debug("Adding CPU configuration: %s cores", vm_config['cpu']) cmd.extend(['-c', str(vm_config['cpu'])]) if 'memory' in vm_config: memory_mib = int(vm_config['memory']) * 1024 - log.debug("Adding memory configuration: %sGB (%sMiB)", vm_config['memory'], memory_mib) cmd.extend(['-m', str(memory_mib)]) - # Add PCI devices with proper conversion + # Add PCI devices for hw_type in ['disk', 'copper', 'sfp']: if hw_type in vm_config and vm_config[hw_type]: - log.debug("Processing %s hardware configuration", hw_type) indices = [int(x) for x in str(vm_config[hw_type]).split(',')] - log.debug("Requested %s indices: %s", hw_type, indices) for idx in indices: - try: - log.debug("Looking up PCI ID for %s index %d in model config", hw_type, idx) - log.debug("Model config for %s: %s", hw_type, model_config['hardware'][hw_type]) - - # Convert all keys to integers for comparison - hw_config = {int(k): v for k, v in model_config['hardware'][hw_type].items()} - log.debug("Converted hardware config: %s", hw_config) - - pci_id = hw_config[idx] - log.debug("Found PCI ID for %s index %d: %s", hw_type, idx, pci_id) - converted_pci_id = convert_pci_id(pci_id) - log.debug("Converted PCI ID from %s to %s", pci_id, converted_pci_id) - cmd.extend(['-P', converted_pci_id]) - except Exception as e: - log.error("Failed to process PCI ID for %s index %d: %s", hw_type, idx, str(e)) - log.error("Hardware config keys: %s, looking for index: %s", - list(model_config['hardware'][hw_type].keys()), idx) - raise + hw_config = {int(k): v for k, v in model_config['hardware'][hw_type].items()} + pci_id = hw_config[idx] + converted_pci_id = convert_pci_id(pci_id) + cmd.extend(['-P', converted_pci_id]) - # Execute so-salt-cloud - log.info("Executing command: %s", ' '.join(cmd)) - try: - result = subprocess.run(cmd, capture_output=True, text=True, check=True) - log.debug("Command completed successfully") - log.debug("Command stdout: %s", result.stdout) - if result.stderr: - log.warning("Command stderr (non-fatal): %s", result.stderr) - except subprocess.CalledProcessError as e: - error_msg = f"so-salt-cloud execution failed (code {e.returncode})" - if e.stdout: - log.error("Command stdout: %s", e.stdout) - if e.stderr: - log.error("Command stderr: %s", e.stderr) - error_msg = f"{error_msg}: {e.stderr}" - log.error(error_msg) - mark_vm_failed(os.path.join(hypervisor_path, vm_name), 4, error_msg) - raise + # Execute command + result = subprocess.run(cmd, capture_output=True, text=True, check=True) # Update tracking file status tracking_file = os.path.join(hypervisor_path, vm_name) data = read_json_file(tracking_file) data['status'] = 'running' write_json_file(tracking_file, data) - log.info("Successfully updated VM status to running") except subprocess.CalledProcessError as e: error_msg = f"so-salt-cloud execution failed (code {e.returncode})" - if e.stdout: - log.error("Command stdout: %s", e.stdout) if e.stderr: - log.error("Command stderr: %s", e.stderr) error_msg = f"{error_msg}: {e.stderr}" log.error(error_msg) mark_vm_failed(os.path.join(hypervisor_path, vm_name), 4, error_msg) @@ -604,24 +544,28 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: except Exception as e: error_msg = f"VM creation failed: {str(e)}" log.error(error_msg) - # If we haven't created the tracking file yet, create a failed one if not os.path.exists(os.path.join(hypervisor_path, vm_name)): mark_vm_failed(os.path.join(hypervisor_path, f"{vm_name}_failed"), 4, error_msg) - finally: - remove_lock_file(hypervisor_path) + raise def process_vm_deletion(hypervisor_path: str, vm_name: str) -> None: - """Process a single VM deletion request.""" + """ + Process a single VM deletion request. + + This function handles the deletion of an existing VM. All operations are protected + by the engine-wide lock that is acquired at engine start. + + Args: + hypervisor_path: Path to the hypervisor directory + vm_name: Name of the VM to delete + """ try: - if not create_lock_file(hypervisor_path, vm_name): - return - # Get the actual hypervisor name (last directory in path) hypervisor = os.path.basename(hypervisor_path) cmd = ['so-salt-cloud', '-p', f'sool9-{hypervisor}', vm_name, '-yd'] log.info("Executing: %s", ' '.join(cmd)) - result = subprocess.run(cmd, capture_output=True, text=True) + result = subprocess.run(cmd, capture_output=True, text=True, check=True) # Log command output if result.stdout: @@ -629,35 +573,39 @@ def process_vm_deletion(hypervisor_path: str, vm_name: str) -> None: if result.stderr: log.warning("Command stderr: %s", result.stderr) - # Check return code - if result.returncode != 0: - error_msg = f"so-salt-cloud deletion failed (code {result.returncode}): {result.stderr}" - log.error(error_msg) - raise subprocess.CalledProcessError( - result.returncode, cmd, - output=result.stdout, - stderr=result.stderr - ) - # Remove VM tracking file vm_file = os.path.join(hypervisor_path, vm_name) if os.path.exists(vm_file): os.remove(vm_file) log.info("Successfully removed VM tracking file") + except subprocess.CalledProcessError as e: + error_msg = f"so-salt-cloud deletion failed (code {e.returncode}): {e.stderr}" + log.error(error_msg) + raise except Exception as e: log.error("Error processing VM deletion: %s", str(e)) raise - finally: - remove_lock_file(hypervisor_path) def process_hypervisor(hypervisor_path: str) -> None: - """Process VM configurations for a single hypervisor.""" + """ + Process VM configurations for a single hypervisor. + + This function handles the processing of VM configurations for a hypervisor, + including creation of new VMs and deletion of removed VMs. All operations + are protected by the engine-wide lock that is acquired at engine start. + + The function performs the following steps: + 1. Reads and validates nodes configuration + 2. Identifies existing VMs + 3. Processes new VM creation requests + 4. Handles VM deletions for removed configurations + + Args: + hypervisor_path: Path to the hypervisor directory + """ try: - if is_locked(hypervisor_path): - return - - # Read nodes file + # Detection phase - no lock needed nodes_file = os.path.join(hypervisor_path, 'nodes') if not os.path.exists(nodes_file): return @@ -666,7 +614,7 @@ def process_hypervisor(hypervisor_path: str) -> None: if not nodes_config: return - # Get existing VMs + # Get existing VMs - no lock needed existing_vms = set() for file_path in glob.glob(os.path.join(hypervisor_path, '*_*')): basename = os.path.basename(file_path) @@ -684,6 +632,7 @@ def process_hypervisor(hypervisor_path: str) -> None: configured_vms.add(vm_name) if vm_name not in existing_vms: + # process_vm_creation handles its own locking process_vm_creation(hypervisor_path, vm_config) # Process VM deletions @@ -692,29 +641,52 @@ def process_hypervisor(hypervisor_path: str) -> None: except Exception as e: log.error("Failed to process hypervisor %s: %s", hypervisor_path, str(e)) + raise def start(interval: int = DEFAULT_INTERVAL, base_path: str = DEFAULT_BASE_PATH) -> None: """ - Main engine loop. + Process virtual node configurations. + + This function implements a single engine-wide lock to ensure only one + instance of the virtual node manager runs at a time. The lock is: + - Acquired at start + - Released after processing completes + - Maintained if error occurs Args: - interval: Time in seconds between processing cycles + interval: Time in seconds between engine runs (managed by salt-master) base_path: Base path containing hypervisor configurations + + Notes: + - Lock remains if engine encounters an error + - Admin must restart service to clear lock + - Error-level logging used for lock issues """ log.info("Starting virtual node manager engine") if not validate_hvn_license(): return + + # Attempt to acquire engine lock + if not engine_lock.acquire(blocking=False): + log.error("Another virtual node manager is already running") + return - while True: - try: - # Process each hypervisor directory - for hypervisor_path in glob.glob(os.path.join(base_path, '*')): - if os.path.isdir(hypervisor_path): - process_hypervisor(hypervisor_path) - - except Exception as e: - log.error("Error in main engine loop: %s", str(e)) - - time.sleep(interval) + log.debug("Virtual node manager acquired engine lock") + + try: + # Process each hypervisor directory + for hypervisor_path in glob.glob(os.path.join(base_path, '*')): + if os.path.isdir(hypervisor_path): + process_hypervisor(hypervisor_path) + + # Clean shutdown - release lock + log.debug("Virtual node manager releasing engine lock") + engine_lock.release() + log.info("Virtual node manager completed successfully") + + except Exception as e: + log.error("Error in virtual node manager - lock will remain until cleared: %s", str(e)) + # Don't release lock on error - requires admin intervention + return From c34be5313dcdd292136c6b336e1f42dc8b2171c4 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sat, 15 Feb 2025 21:41:01 -0500 Subject: [PATCH 129/303] hardware logging. vm state file logging --- .../engines/master/virtual_node_manager.py | 231 +++++++++++++----- 1 file changed, 164 insertions(+), 67 deletions(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index 5cce857b4..da8c8dab4 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -52,9 +52,8 @@ Examples: State Files: VM Tracking Files: - - : Active VM configuration and status - - _failed: Failed VM creation details - - _invalidHW: Invalid hardware request details + - : Active VM with status 'creating' or 'running' + - .error: Error state with detailed message Notes: - Requires 'hvn' feature license - Uses hypervisor's sosmodel grain for hardware capabilities @@ -106,9 +105,8 @@ Exit Codes: 0: Success 1: Invalid license 2: Configuration error - 3: Hardware allocation failure - 4: VM provisioning failure - 5: Invalid hardware request + 3: Hardware validation failure (hardware doesn't exist in model or is already in use by another VM) + 4: VM provisioning failure (so-salt-cloud execution failed) Logging: Log files are written to /opt/so/log/salt/engines/virtual_node_manager.log @@ -281,14 +279,15 @@ def validate_hardware_request(model_config: dict, requested_hw: dict) -> Tuple[b Tuple of (is_valid, error_details) """ errors = {} - log.debug("Validating hardware request: %s", requested_hw) - log.debug("Against model config: %s", model_config['hardware']) + log.debug("Validating if requested hardware exists in model configuration") + log.debug("Requested hardware: %s", requested_hw) + log.debug("Model hardware configuration: %s", model_config['hardware']) # Validate CPU if 'cpu' in requested_hw: try: cpu_count = int(requested_hw['cpu']) - log.debug("Validating CPU request: %d against maximum: %d", + log.debug("Checking if %d CPU cores exist in model (maximum: %d)", cpu_count, model_config['hardware']['cpu']) if cpu_count > model_config['hardware']['cpu']: errors['cpu'] = f"Requested {cpu_count} CPU cores exceeds maximum {model_config['hardware']['cpu']}" @@ -299,7 +298,7 @@ def validate_hardware_request(model_config: dict, requested_hw: dict) -> Tuple[b if 'memory' in requested_hw: try: memory = int(requested_hw['memory']) - log.debug("Validating memory request: %dGB against maximum: %dGB", + log.debug("Checking if %dGB memory exists in model (maximum: %dGB)", memory, model_config['hardware']['memory']) if memory > model_config['hardware']['memory']: errors['memory'] = f"Requested {memory}GB memory exceeds maximum {model_config['hardware']['memory']}GB" @@ -311,19 +310,19 @@ def validate_hardware_request(model_config: dict, requested_hw: dict) -> Tuple[b if hw_type in requested_hw and requested_hw[hw_type]: try: indices = [int(x) for x in str(requested_hw[hw_type]).split(',')] - log.debug("Validating %s indices: %s", hw_type, indices) + log.debug("Checking if %s indices %s exist in model", hw_type, indices) if hw_type not in model_config['hardware']: log.error("Hardware type %s not found in model config", hw_type) errors[hw_type] = f"No {hw_type} configuration found in model" continue - available_indices = set(int(k) for k in model_config['hardware'][hw_type].keys()) - log.debug("Available %s indices: %s", hw_type, available_indices) + model_indices = set(int(k) for k in model_config['hardware'][hw_type].keys()) + log.debug("Model has %s indices: %s", hw_type, model_indices) - invalid_indices = [idx for idx in indices if idx not in available_indices] + invalid_indices = [idx for idx in indices if idx not in model_indices] if invalid_indices: - log.error("Invalid %s indices found: %s", hw_type, invalid_indices) + log.error("%s indices %s do not exist in model", hw_type, invalid_indices) errors[hw_type] = f"Invalid {hw_type} indices: {invalid_indices}" except ValueError: log.error("Invalid %s indices format: %s", hw_type, requested_hw[hw_type]) @@ -339,26 +338,117 @@ def validate_hardware_request(model_config: dict, requested_hw: dict) -> Tuple[b return (len(errors) == 0, errors if errors else None) -def check_hardware_availability(hypervisor_path: str, vm_name: str) -> bool: - """Check if requested hardware is already claimed by another VM.""" - try: - # List all VM tracking files - files = glob.glob(os.path.join(hypervisor_path, '*_*')) - for file_path in files: - # Skip the VM we're checking and any failed/invalid VMs - basename = os.path.basename(file_path) - if basename.startswith(vm_name) or '_failed' in basename or '_invalidHW' in basename: - continue +def check_hardware_availability(hypervisor_path: str, vm_name: str, requested_hw: dict, model_config: dict) -> Tuple[bool, Optional[dict]]: + """ + Check if requested hardware is available. + + Args: + hypervisor_path: Path to hypervisor directory + vm_name: Name of requesting VM + requested_hw: Hardware being requested + model_config: Model hardware configuration + + Returns: + Tuple of (is_available, error_details) + """ + log.debug("Checking if requested hardware is currently in use by other VMs") + log.debug("VM requesting hardware: %s", vm_name) + log.debug("Hardware being requested: %s", requested_hw) + + errors = {} + + # Track total CPU/memory usage + total_cpu = 0 + total_memory = 0 + + # Track used unique resources and which VM is using them + used_resources = { + 'disk': {}, # {index: vm_name} + 'copper': {}, # {index: vm_name} + 'sfp': {} # {index: vm_name} + } + + # Calculate current usage from existing VMs + log.debug("Scanning existing VMs to check hardware usage") + for vm_file in glob.glob(os.path.join(hypervisor_path, '*_*')): + basename = os.path.basename(vm_file) + # Skip if it's the same VM requesting hardware or in error state + if basename.startswith(vm_name): + log.debug("Skipping file %s (same VM requesting hardware)", basename) + continue + if basename.endswith('.error'): + log.debug("Skipping file %s (error state)", basename) + continue - # Check if any hardware overlaps - vm_config = read_json_file(file_path) - if 'hardware' in vm_config and 'allocated' in vm_config['hardware']: - # TODO: Implement hardware conflict checking - pass - return True - except Exception as e: - log.error("Failed to check hardware availability: %s", str(e)) - return False + vm_config = read_json_file(vm_file) + if 'config' not in vm_config or vm_config.get('status') != 'running': + log.debug("Skipping VM %s (not running)", basename) + continue + + config = vm_config['config'] + log.debug("Processing running VM %s", basename) + + # Add to CPU/memory totals + vm_cpu = int(config.get('cpu', 0)) + vm_memory = int(config.get('memory', 0)) + total_cpu += vm_cpu + total_memory += vm_memory + log.debug("Found running VM %s using CPU: %d, Memory: %dGB", basename, vm_cpu, vm_memory) + + # Track unique resources + for hw_type in ['disk', 'copper', 'sfp']: + if hw_type in config and config[hw_type]: + indices = [int(x) for x in str(config[hw_type]).split(',')] + for idx in indices: + used_resources[hw_type][idx] = basename.replace('_sensor', '') # Store VM name without role + log.debug("VM %s is using %s indices: %s", basename, hw_type, indices) + + log.debug("Total hardware currently in use - CPU: %d, Memory: %dGB", total_cpu, total_memory) + log.debug("Hardware indices currently in use: %s", used_resources) + + # Check CPU capacity + requested_cpu = int(requested_hw.get('cpu', 0)) + total_cpu_needed = total_cpu + requested_cpu + log.debug("Checking CPU capacity - Currently in use: %d + Requested: %d = %d (Max: %d)", + total_cpu, requested_cpu, total_cpu_needed, model_config['hardware']['cpu']) + if total_cpu_needed > model_config['hardware']['cpu']: + errors['cpu'] = f"Total CPU usage ({total_cpu_needed}) would exceed capacity ({model_config['hardware']['cpu']})" + + # Check memory capacity + requested_memory = int(requested_hw.get('memory', 0)) + total_memory_needed = total_memory + requested_memory + log.debug("Checking memory capacity - Currently in use: %d + Requested: %d = %d (Max: %d)", + total_memory, requested_memory, total_memory_needed, model_config['hardware']['memory']) + if total_memory_needed > model_config['hardware']['memory']: + errors['memory'] = f"Total memory usage ({total_memory_needed}GB) would exceed capacity ({model_config['hardware']['memory']}GB)" + + # Check for hardware conflicts + for hw_type in ['disk', 'copper', 'sfp']: + if hw_type in requested_hw and requested_hw[hw_type]: + requested_indices = [int(x) for x in str(requested_hw[hw_type]).split(',')] + log.debug("Checking for %s conflicts - Requesting indices: %s, Currently in use: %s", + hw_type, requested_indices, used_resources[hw_type]) + conflicts = {} # {index: vm_name} + for idx in requested_indices: + if idx in used_resources[hw_type]: + conflicts[idx] = used_resources[hw_type][idx] + + if conflicts: + # Create one sentence per conflict + conflict_details = [] + hw_name = hw_type.upper() if hw_type == 'sfp' else hw_type.capitalize() + for idx, vm in conflicts.items(): + conflict_details.append(f"{hw_name} index {idx} in use by {vm}") + + log.debug("Found conflicting %s indices: %s", hw_type, conflict_details) + errors[hw_type] = ". ".join(conflict_details) + "." + + if errors: + log.debug("Hardware validation failed with errors: %s", errors) + else: + log.debug("Hardware validation successful") + + return (len(errors) == 0, errors if errors else None) def create_vm_tracking_file(hypervisor_path: str, vm_name: str, config: dict) -> None: """Create VM tracking file with initial state.""" @@ -371,52 +461,58 @@ def create_vm_tracking_file(hypervisor_path: str, vm_name: str, config: dict) -> data = { 'config': config, - 'status': 'creating', - 'hardware': { - 'allocated': {} - } + 'status': 'creating' } # Write file and set ownership - with open(file_path, 'w') as f: - json.dump(data, f, indent=2) - set_socore_ownership(file_path) + write_json_file(file_path, data) log.debug("Successfully created VM tracking file with socore ownership") except Exception as e: log.error("Failed to create VM tracking file: %s", str(e)) raise def mark_vm_failed(vm_file: str, error_code: int, message: str) -> None: - """Mark VM as failed with error details.""" + """Create error file with VM failure details.""" try: - # Rename file to add _failed suffix if not already present - if not vm_file.endswith('_failed'): - new_file = f"{vm_file}_failed" - os.rename(vm_file, new_file) - vm_file = new_file + # Get original config if it exists + config = {} + if os.path.exists(vm_file): + data = read_json_file(vm_file) + config = data.get('config', {}) + # Remove the original file since we'll create an error file + os.remove(vm_file) - # Update file contents - data = read_json_file(vm_file) - data['status'] = 'failed' - data['error'] = { - 'code': error_code, - 'message': message, - 'timestamp': datetime.now().isoformat() + # Create error file + error_file = f"{vm_file}.error" + data = { + 'config': config, + 'status': 'error', + 'error_details': { + 'message': message, + 'timestamp': datetime.now().isoformat() + } } - write_json_file(vm_file, data) + write_json_file(error_file, data) except Exception as e: - log.error("Failed to mark VM as failed: %s", str(e)) + log.error("Failed to create error file: %s", str(e)) raise def mark_invalid_hardware(hypervisor_path: str, vm_name: str, config: dict, error_details: dict) -> None: - """Create invalid hardware tracking file with error details.""" - file_path = os.path.join(hypervisor_path, f"{vm_name}_invalidHW") + """Create error file with hardware validation failure details.""" + file_path = os.path.join(hypervisor_path, f"{vm_name}.error") try: + # Build error message from error details + error_messages = [] + for hw_type, message in error_details.items(): + error_messages.append(message) + + # Join all messages with proper sentence structure + full_message = "Hardware validation failure: " + " ".join(error_messages) + data = { 'config': config, - 'error': { - 'code': 5, - 'message': "Invalid hardware configuration", - 'invalid_hardware': error_details, + 'status': 'error', + 'error_details': { + 'message': full_message, 'timestamp': datetime.now().isoformat() } } @@ -480,16 +576,17 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: model = get_hypervisor_model(hypervisor) model_config = load_hardware_defaults(model) - # Initial hardware validation + # Initial hardware validation against model is_valid, errors = validate_hardware_request(model_config, vm_config) if not is_valid: mark_invalid_hardware(hypervisor_path, vm_name, vm_config, errors) return # Check hardware availability - if not check_hardware_availability(hypervisor_path, vm_name): - mark_vm_failed(os.path.join(hypervisor_path, vm_name), 3, - "Requested hardware is already in use") + is_available, availability_errors = check_hardware_availability( + hypervisor_path, vm_name, vm_config, model_config) + if not is_available: + mark_invalid_hardware(hypervisor_path, vm_name, vm_config, availability_errors) return # Create tracking file @@ -618,7 +715,7 @@ def process_hypervisor(hypervisor_path: str) -> None: existing_vms = set() for file_path in glob.glob(os.path.join(hypervisor_path, '*_*')): basename = os.path.basename(file_path) - if not any(x in basename for x in ['_failed', '_invalidHW']): + if not basename.endswith('.error'): existing_vms.add(basename) # Process new VMs From 6ff701bd5cf6b03117bd2403e14cf15d3d497645 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sun, 16 Feb 2025 01:33:50 -0500 Subject: [PATCH 130/303] soc ui improvements for hypervisor layout. show free hardware for a hypervisor in the description --- salt/hypervisor/map.jinja | 45 +++++++++++ .../engines/master/virtual_node_manager.py | 24 +++--- salt/soc/dyanno/hypervisor/hypervisor.yaml | 76 ++++++++----------- salt/soc/dyanno/hypervisor/init.sls | 2 +- .../hypervisor/soc_hypervisor.yaml.jinja | 59 +++++++++++--- 5 files changed, 140 insertions(+), 66 deletions(-) create mode 100644 salt/hypervisor/map.jinja diff --git a/salt/hypervisor/map.jinja b/salt/hypervisor/map.jinja new file mode 100644 index 000000000..b187bdfb1 --- /dev/null +++ b/salt/hypervisor/map.jinja @@ -0,0 +1,45 @@ +{# Import defaults.yaml for model hardware capabilities #} +{% import_yaml 'hypervisor/defaults.yaml' as DEFAULTS %} + +{# Get hypervisor nodes from pillar #} +{% set NODES = salt['pillar.get']('hypervisor:nodes', {}) %} + +{# Build enhanced HYPERVISORS structure #} +{% set HYPERVISORS = {} %} +{% for role, hypervisors in NODES.items() %} + {% do HYPERVISORS.update({role: {}}) %} + {% for hypervisor, config in hypervisors.items() %} + {# Get model from cached grains using Salt runner #} + {% set grains = salt.saltutil.runner('cache.grains', tgt=hypervisor ~ '_*', tgt_type='glob') %} + {% set model = '' %} + {% if grains %} + {% set minion_id = grains.keys() | first %} + {% set model = grains[minion_id].get('sosmodel', '') %} + {% endif %} + {% set model_config = DEFAULTS.hypervisor.model.get(model, {}) %} + + {# Get VM list and states #} + {% set vms = {} %} + {% import_json 'hypervisor/hosts/' ~ hypervisor ~ 'VMs' as vm_list %} + + {# Load state for each VM #} + {% for vm in vm_list %} + {% set hostname = vm.get('hostname', '') %} + {% set role = vm.get('role', '') %} + {% if hostname and role %} + {% import_json 'hypervisor/hosts/' ~ hypervisor ~ '/' ~ hostname ~ '_' ~ role as vm_state %} + {% do vms.update({hostname: vm_state}) %} + {% endif %} + {% endfor %} + + {# Merge node config with model capabilities and VM states #} + {% do HYPERVISORS[role].update({ + hypervisor: { + 'config': config, + 'model': model, + 'hardware': model_config.get('hardware', {}), + 'vms': vms + } + }) %} + {% endfor %} +{% endfor %} \ No newline at end of file diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index da8c8dab4..ef04032ce 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -9,7 +9,7 @@ Salt Engine for Virtual Node Management This engine manages the automated provisioning of virtual machines in Security Onion's -virtualization infrastructure. It processes VM configurations from a nodes file and handles +virtualization infrastructure. It processes VM configurations from a VMs file and handles the entire provisioning process including hardware allocation, state tracking, and file ownership. Usage: @@ -26,8 +26,8 @@ Options: will automatically be converted to MiB when passed to so-salt-cloud. Configuration Files: - nodes: JSON file containing VM configurations - - Located at //nodes + VMs: JSON file containing VM configurations + - Located at /VMs - Contains array of VM configurations - Each VM config specifies hardware and network settings @@ -54,6 +54,7 @@ State Files: VM Tracking Files: - : Active VM with status 'creating' or 'running' - .error: Error state with detailed message + Notes: - Requires 'hvn' feature license - Uses hypervisor's sosmodel grain for hardware capabilities @@ -76,7 +77,7 @@ Description: - Prevents operation if license is invalid 3. Configuration Processing - - Reads nodes file from each hypervisor directory + - Reads VMs file for each hypervisor - Validates configuration parameters - Compares against existing VM tracking files @@ -693,7 +694,7 @@ def process_hypervisor(hypervisor_path: str) -> None: are protected by the engine-wide lock that is acquired at engine start. The function performs the following steps: - 1. Reads and validates nodes configuration + 1. Reads VMs configuration from VMs file 2. Identifies existing VMs 3. Processes new VM creation requests 4. Handles VM deletions for removed configurations @@ -702,13 +703,18 @@ def process_hypervisor(hypervisor_path: str) -> None: hypervisor_path: Path to the hypervisor directory """ try: - # Detection phase - no lock needed - nodes_file = os.path.join(hypervisor_path, 'nodes') - if not os.path.exists(nodes_file): + # Get hypervisor name from path + hypervisor = os.path.basename(hypervisor_path) + + # Read VMs file instead of nodes + vms_file = os.path.join(os.path.dirname(hypervisor_path), f"{hypervisor}VMs") + if not os.path.exists(vms_file): + log.debug("No VMs file found at %s", vms_file) return - nodes_config = read_json_file(nodes_file) + nodes_config = read_json_file(vms_file) if not nodes_config: + log.debug("Empty VMs configuration in %s", vms_file) return # Get existing VMs - no lock needed diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index 2b9a0d70e..477525259 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -1,49 +1,33 @@ hypervisor: hosts: defaultHost: - hardwareMap: - title: 'All Hardware' - description: This shows hardware available to the hypervisor and PCIe -> INT mapping. - file: true - readonly: true - global: true # set to true to remove host drop down - multiline: true - vmMap: - title: 'VM Map' - description: This shows the VMs and the hardware they have claimed. - file: true - readonly: true - global: true - multiline: true - nodes: - description: 'Available CPU: CPUFREE | Available Memory: MEMFREE | Available Disk: DISKFREE | Available Copper NIC: COPPERFREE | Available SFP NIC: SFPFREE' - syntax: json - uiElements: - - field: hostname - label: Enter the hostname - - field: role - label: sensor or searchnode - - field: network_mode - label: Choose static4 or dhcp4. If static4, populate IP details below. - - field: ip4 - label: IP Address with netmask. ex. 192.168.1.10/24 - - field: gw4 - label: Gateway - - field: dns4 - label: DNS. Comma separated list. ex. 192.168.1.1,8.8.8.8 - - field: search4 - label: Search domain - - field: cpu - label: Number of CPU cores to assign. ex. 8 - - field: memory - label: Memory, in GB to assign. ex. 16 - - field: disk - label: Choose a disk or disks to assign for passthrough. Comma separated list. - - field: copper - label: Choose a copper port or ports to assign for passthrough. Comma separated list. - - field: sfp - label: Choose a sfp port or ports to assign for passthrough. Comma separated list. - file: true - global: true - - vms: {} + title: defaultHost + description: 'Available CPU: CPUFREE | Available Memory: MEMFREE | Available Disk: DISKFREE | Available Copper NIC: COPPERFREE | Available SFP NIC: SFPFREE' + syntax: json + uiElements: + - field: hostname + label: Enter the hostname + - field: role + label: sensor or searchnode + - field: network_mode + label: Choose static4 or dhcp4. If static4, populate IP details below. + - field: ip4 + label: IP Address with netmask. ex. 192.168.1.10/24 + - field: gw4 + label: Gateway + - field: dns4 + label: DNS. Comma separated list. ex. 192.168.1.1,8.8.8.8 + - field: search4 + label: Search domain + - field: cpu + label: Number of CPU cores to assign. ex. 8 + - field: memory + label: Memory, in GB to assign. ex. 16 + - field: disk + label: Choose a disk or disks to assign for passthrough. Comma separated list. + - field: copper + label: Choose a copper port or ports to assign for passthrough. Comma separated list. + - field: sfp + label: Choose a sfp port or ports to assign for passthrough. Comma separated list. + file: true + global: true diff --git a/salt/soc/dyanno/hypervisor/init.sls b/salt/soc/dyanno/hypervisor/init.sls index a0b83fd5d..5645a8f63 100644 --- a/salt/soc/dyanno/hypervisor/init.sls +++ b/salt/soc/dyanno/hypervisor/init.sls @@ -1,4 +1,4 @@ -{% from 'soc/dyanno/hypervisor/map.jinja' import HYPERVISORS %} +{% from 'hypervisor/map.jinja' import HYPERVISORS %} hypervisor_annotation: file.managed: diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 74996605e..2e274157b 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -1,27 +1,66 @@ {%- import_yaml 'soc/dyanno/hypervisor/hypervisor.yaml' as ANNOTATION -%} +{%- from 'hypervisor/map.jinja' import HYPERVISORS -%} {%- set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') -%} {%- macro update_description(description, cpu_free, mem_free, disk_free, copper_free, sfp_free) -%} -{{- description | replace('CPUFREE', cpu_free | string) - | replace('MEMFREE', mem_free | string) +{{- description | replace('CPUFREE', cpu_free | string) + | replace('MEMFREE', mem_free | string) | replace('DISKFREE', disk_free | string) | replace('COPPERFREE', copper_free | string) | replace('SFPFREE', sfp_free | string) -}} {%- endmacro -%} +{%- macro get_available_pci(hw_config, device_type, used_indices) -%} +{%- set available = [] -%} +{%- for idx in hw_config.get(device_type, {}).keys() -%} + {%- if idx | string not in used_indices -%} + {%- do available.append(idx) -%} + {%- endif -%} +{%- endfor -%} +{{- available | join(',') -}} +{%- endmacro -%} + {%- for role in HYPERVISORS -%} {%- for hypervisor in HYPERVISORS[role].keys() -%} -{%- set cpu_free = HYPERVISORS[role][hypervisor].available_cpu -%} -{%- set mem_free = HYPERVISORS[role][hypervisor].available_memory -%} -{%- set disk_free = HYPERVISORS[role][hypervisor].available_disk -%} -{%- set copper_free = HYPERVISORS[role][hypervisor].available_copper -%} -{%- set sfp_free = HYPERVISORS[role][hypervisor].available_sfp -%} +{%- set hw_config = HYPERVISORS[role][hypervisor].hardware -%} +{%- set vms = HYPERVISORS[role][hypervisor].vms -%} + +{# Calculate used CPU and memory #} +{%- set used_cpu = 0 -%} +{%- set used_memory = 0 -%} +{%- set ns = namespace(used_cpu=0, used_memory=0) -%} #MOD +{%- for hostname, vm_data in vms.items() -%} +{%- set vm_config = vm_data.config -%} +{%- set ns.used_cpu = ns.used_cpu + vm_config.cpu | int -%} +{%- set ns.used_memory = ns.used_memory + vm_config.memory | int -%} +{%- endfor -%} + +{# Calculate available resources #} +{%- set cpu_free = hw_config.cpu - ns.used_cpu -%} +{%- set mem_free = hw_config.memory - ns.used_memory -%} + +{# Get used PCI indices #} +{%- set used_disk = [] -%} +{%- set used_copper = [] -%} +{%- set used_sfp = [] -%} +{%- for hostname, vm in vms.items() -%} +{%- set config = vm.get('config', {}) -%} +{%- do used_disk.extend((config.get('disk', '') | string).split(',') | map('trim') | list) -%} +{%- do used_copper.extend((config.get('copper', '') | string).split(',') | map('trim') | list) -%} +{%- do used_sfp.extend((config.get('sfp', '') | string).split(',') | map('trim') | list) -%} +{%- endfor -%} + +{# Get available PCI indices #} +{%- set disk_free = get_available_pci(hw_config, 'disk', used_disk) -%} +{%- set copper_free = get_available_pci(hw_config, 'copper', used_copper) -%} +{%- set sfp_free = get_available_pci(hw_config, 'sfp', used_sfp) -%} {%- set updated_template = TEMPLATE.copy() -%} -{%- do updated_template.nodes.update({ +{%- do updated_template.update({ + 'title': hypervisor, 'description': update_description( - TEMPLATE.nodes.description, + TEMPLATE.description, cpu_free, mem_free, disk_free, @@ -29,7 +68,7 @@ sfp_free ) }) -%} -{%- do ANNOTATION.hypervisor.hosts.update({hypervisor: updated_template}) -%} +{%- do ANNOTATION.hypervisor.hosts.update({hypervisor ~ 'VMs': updated_template}) -%} {%- endfor -%} {%- endfor -%} From 0d335e30567ef8f63d193b5e6dc4d43e61794d82 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sun, 16 Feb 2025 02:23:11 -0500 Subject: [PATCH 131/303] free and totals in labels --- salt/soc/dyanno/hypervisor/hypervisor.yaml | 26 +++++++------- .../hypervisor/soc_hypervisor.yaml.jinja | 34 +++++++++++++++++-- 2 files changed, 45 insertions(+), 15 deletions(-) diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index 477525259..f6c955970 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -2,32 +2,32 @@ hypervisor: hosts: defaultHost: title: defaultHost - description: 'Available CPU: CPUFREE | Available Memory: MEMFREE | Available Disk: DISKFREE | Available Copper NIC: COPPERFREE | Available SFP NIC: SFPFREE' + description: "Available CPU: CPUFREE | Available Memory: MEMFREE | Available Disk: DISKFREE | Available Copper NIC: COPPERFREE | Available SFP NIC: SFPFREE" syntax: json uiElements: - field: hostname - label: Enter the hostname + label: "Enter the hostname" - field: role - label: sensor or searchnode + label: "sensor or searchnode" - field: network_mode - label: Choose static4 or dhcp4. If static4, populate IP details below. + label: "Choose static4 or dhcp4. If static4, populate IP details below." - field: ip4 - label: IP Address with netmask. ex. 192.168.1.10/24 + label: "IP Address with netmask. ex. 192.168.1.10/24" - field: gw4 - label: Gateway + label: "Gateway" - field: dns4 - label: DNS. Comma separated list. ex. 192.168.1.1,8.8.8.8 + label: "DNS. Comma separated list. ex. 192.168.1.1,8.8.8.8" - field: search4 - label: Search domain + label: "Search domain" - field: cpu - label: Number of CPU cores to assign. ex. 8 + label: "CPU cores to assign. Free: FREE | Total: TOTAL" - field: memory - label: Memory, in GB to assign. ex. 16 + label: "Memory to assign, in GB. Free: FREE | Total: TOTAL" - field: disk - label: Choose a disk or disks to assign for passthrough. Comma separated list. + label: "Disk(s) for passthrough. Comma separated list. Free: FREE | Total: TOTAL" - field: copper - label: Choose a copper port or ports to assign for passthrough. Comma separated list. + label: "Copper port(s) for passthrough. Comma separated list. Free: FREE | Total: TOTAL" - field: sfp - label: Choose a sfp port or ports to assign for passthrough. Comma separated list. + label: "SFP port(s) for passthrough. Comma separated list. Free: FREE | Total: TOTAL" file: true global: true diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 2e274157b..6541da318 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -11,6 +11,11 @@ | replace('SFPFREE', sfp_free | string) -}} {%- endmacro -%} +{%- macro update_label(label, total, free) -%} +{{- label | replace('TOTAL', total | string) + | replace('FREE', free | string) -}} +{%- endmacro -%} + {%- macro get_available_pci(hw_config, device_type, used_indices) -%} {%- set available = [] -%} {%- for idx in hw_config.get(device_type, {}).keys() -%} @@ -29,7 +34,7 @@ {# Calculate used CPU and memory #} {%- set used_cpu = 0 -%} {%- set used_memory = 0 -%} -{%- set ns = namespace(used_cpu=0, used_memory=0) -%} #MOD +{%- set ns = namespace(used_cpu=0, used_memory=0) -%} {%- for hostname, vm_data in vms.items() -%} {%- set vm_config = vm_data.config -%} {%- set ns.used_cpu = ns.used_cpu + vm_config.cpu | int -%} @@ -55,8 +60,33 @@ {%- set disk_free = get_available_pci(hw_config, 'disk', used_disk) -%} {%- set copper_free = get_available_pci(hw_config, 'copper', used_copper) -%} {%- set sfp_free = get_available_pci(hw_config, 'sfp', used_sfp) -%} - + +{# Get total resources #} +{%- set cpu_total = hw_config.cpu -%} +{%- set mem_total = hw_config.memory -%} +{%- set disk_total = hw_config.disk.keys() | join(',') -%} +{%- set copper_total = hw_config.copper.keys() | join(',') -%} +{%- set sfp_total = hw_config.sfp.keys() | join(',') -%} + +{# Update field labels with total and free values #} {%- set updated_template = TEMPLATE.copy() -%} +{%- set updated_elements = [] -%} +{%- for field in updated_template.uiElements -%} +{%- set updated_field = field.copy() -%} +{%- if field.field == 'cpu' -%} +{%- do updated_field.update({'label': field.label | replace('FREE', cpu_free | string) | replace('TOTAL', cpu_total | string)}) -%} +{%- elif field.field == 'memory' -%} +{%- do updated_field.update({'label': field.label | replace('FREE', mem_free | string) | replace('TOTAL', mem_total | string)}) -%} +{%- elif field.field == 'disk' -%} +{%- do updated_field.update({'label': field.label | replace('FREE', disk_free) | replace('TOTAL', disk_total)}) -%} +{%- elif field.field == 'copper' -%} +{%- do updated_field.update({'label': field.label | replace('FREE', copper_free) | replace('TOTAL', copper_total)}) -%} +{%- elif field.field == 'sfp' -%} +{%- do updated_field.update({'label': field.label | replace('FREE', sfp_free) | replace('TOTAL', sfp_total)}) -%} +{%- endif -%} +{%- do updated_elements.append(updated_field) -%} +{%- endfor -%} +{%- do updated_template.update({'uiElements': updated_elements}) -%} {%- do updated_template.update({ 'title': hypervisor, 'description': update_description( From f46548ed884810c7b140d452663c26e800021774 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sun, 16 Feb 2025 02:25:18 -0500 Subject: [PATCH 132/303] remove free hw from description --- salt/soc/dyanno/hypervisor/hypervisor.yaml | 2 +- salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja | 6 +----- 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index f6c955970..e2a0028a8 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -2,7 +2,7 @@ hypervisor: hosts: defaultHost: title: defaultHost - description: "Available CPU: CPUFREE | Available Memory: MEMFREE | Available Disk: DISKFREE | Available Copper NIC: COPPERFREE | Available SFP NIC: SFPFREE" + description: "Hypervisor Configuration" syntax: json uiElements: - field: hostname diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 6541da318..f5ce34563 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -4,11 +4,7 @@ {%- set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') -%} {%- macro update_description(description, cpu_free, mem_free, disk_free, copper_free, sfp_free) -%} -{{- description | replace('CPUFREE', cpu_free | string) - | replace('MEMFREE', mem_free | string) - | replace('DISKFREE', disk_free | string) - | replace('COPPERFREE', copper_free | string) - | replace('SFPFREE', sfp_free | string) -}} +{{- description -}} {%- endmacro -%} {%- macro update_label(label, total, free) -%} From 8ffd4fc664355c839455a74cef27569eb93e42f0 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sun, 16 Feb 2025 02:31:52 -0500 Subject: [PATCH 133/303] new examples --- .../soc/dyanno/hypervisor/hardwareMap.example | 32 ------ .../hypervisor/soc_hypervisor.yaml.example | 97 +++++++------------ 2 files changed, 33 insertions(+), 96 deletions(-) delete mode 100644 salt/soc/dyanno/hypervisor/hardwareMap.example diff --git a/salt/soc/dyanno/hypervisor/hardwareMap.example b/salt/soc/dyanno/hypervisor/hardwareMap.example deleted file mode 100644 index ea3bec51b..000000000 --- a/salt/soc/dyanno/hypervisor/hardwareMap.example +++ /dev/null @@ -1,32 +0,0 @@ -# this file will exist in /opt/so/saltstack/local/salt/hypervisor/hosts/HOSTNAME/hardwareMap -hypervisor: - hardware: - copper: - claimed: - 1: pci_0000_c1_00_0 - 2: pci_0000_c1_00_1 - free: - 3: pci_0000_c4_00_0 - 4: pci_0000_c4_00_1 - 5: pci_0000_c4_00_2 - 6: pci_0000_c4_00_3 - cpu: - free: 120 - total: 120 - disk: - claimed: - 1: pci_0000_c5_00_0 - 2: pci_0000_c6_00_0 - free: - 3: pci_0000_c7_00_0 - 4: pci_0000_c8_00_0 - memory: - free: 120 - total: 120 - sfp: - claimed: {} - free: - 8: pci_0000_02_00_1 - 7: pci_0000_02_00_0 - 9: pci_0000_41_00_0 - 10: pci_0000_41_00_1 diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example index bd5161598..902d9b1b1 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example @@ -1,67 +1,36 @@ # This is the start of an example of what this file will look like. It will be generated by Salt, so this yaml file is not used by Salt. hypervisor: hosts: - jpphype1: - hardwareMap: - title: 'All Hardware' - description: This shows hardware available to the hypervisor and PCIe -> INT mapping. - file: true - readonly: true - global: true # set to true to remove host drop down - multiline: true - cpufree: - title: 'Available CPU: 120' - description: Available CPU for this hypervisor. - readonly: true - global: true # set to true to remove host drop down - memfree: - title: 'Available Memory: 120' - description: Available memory for this hypervisor. - readonly: true - global: true # set to true to remove host drop down - diskfree: - title: 'Available Disk: 3,4' - description: Available disk for this hypervisor. - readonly: true - global: true # set to true to remove host drop down - copperfree: - title: 'Available Copper NIC: 3,4,5,6' - description: Available copper NIC for this hypervisor. - readonly: true - global: true # set to true to remove host drop down - sfpfree: - title: 'Available SFP NIC: 7,8,9,10' - description: Available SFP NIC for this hypervisor. - readonly: true - global: true # set to true to remove host drop down - nodes: - description: List of VMs. - syntax: json - uiElements: - - field: hostname - label: Enter the hostname - forcedType: string - - field: nodetype - label: sensor or searchnode - - field: network_mode - label: Choose static4 or dhcp4. If static4, populate IP details below. - - field: ip4 - label: IP Address with netmask. ex. 192.168.1.10/24 - - field: gw4 - label: Gateway - - field: dns4 - label: DNS. Comma seperated list. ex. 192.168.1.1,8.8.8.8 - - field: search4 - label: Search domain - - field: cpu - label: Number of CPU cores to assign. ex. 8 - - field: memory - label: Memory, in GB to assign. ex. 16 - - field: disk - label: Choose a disk or disks to assign for passthrough. Comma seperated list. - - field: copper - label: Choose a copper port or ports to assign for passthrough. Comma seperated list. - - filed: sfp - label: Choose a sfp port or ports to assign for passthrough. Comma seperated list. - file: true - global: true # set to true to remove host drop down + jpphype1VMs: + description: Hypervisor Configuration + file: true + global: true + syntax: json + title: jpphype1 + uiElements: + - field: hostname + label: Enter the hostname + - field: role + label: sensor or searchnode + - field: network_mode + label: Choose static4 or dhcp4. If static4, populate IP details below. + - field: ip4 + label: IP Address with netmask. ex. 192.168.1.10/24 + - field: gw4 + label: Gateway + - field: dns4 + label: DNS. Comma separated list. ex. 192.168.1.1,8.8.8.8 + - field: search4 + label: Search domain + - field: cpu + label: 'CPU cores to assign. Free: 120 | Total: 128' + - field: memory + label: 'Memory to assign, in GB. Free: 112 | Total: 128' + - field: disk + label: 'Disk(s) for passthrough. Comma separated list. Free: 2 | Total: 1,2' + - field: copper + label: 'Copper port(s) for passthrough. Comma separated list. Free: 3,4 | + Total: 1,2,3,4' + - field: sfp + label: 'SFP port(s) for passthrough. Comma separated list. Free: 5,6,7,8 | + Total: 5,6,7,8' From b68f561e6fa462ad4c88e1594306c3ea338c7982 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 21 Feb 2025 09:50:01 -0500 Subject: [PATCH 134/303] progress and hw tracking for soc hypervisor dynamic annotations --- salt/_modules/qcow2.py | 8 +- .../so-salt-emit-vm-deployment-status-event | 116 +++++++++++++++++ salt/hypervisor/map.jinja | 52 +++++++- .../tools/sbin/so-kvm-modify-hardware | 79 +++++++++++- .../tools/sbin/so-qcow2-modify-network | 61 ++++++++- salt/manager/tools/sbin/so-salt-cloud | 5 +- salt/orch/dyanno_hypervisor.sls | 97 +++++++++++++++ salt/reactor/createEmptyPillar.sls | 24 +++- salt/reactor/vm_status.sls | 117 ++++++++++++++++++ salt/salt/cloud/reactor_config_hypervisor.sls | 10 +- .../engines/master/virtual_node_manager.py | 30 +++-- salt/soc/dyanno/hypervisor/init.sls | 2 + .../hypervisor/soc_hypervisor.yaml.jinja | 26 +++- salt/soc/dyanno/hypervisor/write_status.sls | 69 +++++++++++ salt/top.sls | 1 + salt/vm_status/init.sls | 10 ++ 16 files changed, 674 insertions(+), 33 deletions(-) create mode 100644 salt/common/tools/sbin/so-salt-emit-vm-deployment-status-event create mode 100644 salt/orch/dyanno_hypervisor.sls create mode 100644 salt/reactor/vm_status.sls create mode 100644 salt/soc/dyanno/hypervisor/write_status.sls create mode 100644 salt/vm_status/init.sls diff --git a/salt/_modules/qcow2.py b/salt/_modules/qcow2.py index 81a00ca66..6e71dc459 100644 --- a/salt/_modules/qcow2.py +++ b/salt/_modules/qcow2.py @@ -29,10 +29,10 @@ __virtualname__ = 'qcow2' def __virtual__(): return __virtualname__ -def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, search4=None): +def modify_network_config(image, interface, mode, vm_name, ip4=None, gw4=None, dns4=None, search4=None): ''' Usage: - salt '*' qcow2.modify_network_config image= interface= mode= [ip4=] [gw4=] [dns4=] [search4=] + salt '*' qcow2.modify_network_config image= interface= mode= vm_name= [ip4=] [gw4=] [dns4=] [search4=] Options: image @@ -41,6 +41,8 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, Network interface name to configure (e.g., 'enp1s0') mode Network configuration mode, either 'dhcp4' or 'static4' + vm_name + Full name of the VM (hostname_role) ip4 IPv4 address with CIDR notation (e.g., '192.168.1.10/24') Required when mode='static4' @@ -94,7 +96,7 @@ def modify_network_config(image, interface, mode, ip4=None, gw4=None, dns4=None, - Success/failure status is logged for verification ''' - cmd = ['/usr/sbin/so-qcow2-modify-network', '-I', image, '-i', interface] + cmd = ['/usr/sbin/so-qcow2-modify-network', '-I', image, '-i', interface, '-n', vm_name] if mode.lower() == 'dhcp4': cmd.append('--dhcp4') diff --git a/salt/common/tools/sbin/so-salt-emit-vm-deployment-status-event b/salt/common/tools/sbin/so-salt-emit-vm-deployment-status-event new file mode 100644 index 000000000..454e1ba9b --- /dev/null +++ b/salt/common/tools/sbin/so-salt-emit-vm-deployment-status-event @@ -0,0 +1,116 @@ +#!/opt/saltstack/salt/bin/python3 + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +""" +Script for emitting VM deployment status events to the Salt event bus. + +This script provides functionality to emit status events for VM deployment operations, +used by various Security Onion VM management tools. + +Usage: + so-salt-emit-vm-deployment-status-event -v -H -s + +Arguments: + -v, --vm-name Name of the VM (hostname_role) + -H, --hypervisor Name of the hypervisor + -s, --status Current deployment status of the VM + +Example: + so-salt-emit-vm-deployment-status-event -v sensor1_sensor -H hypervisor1 -s "Creating" +""" + +import sys +import argparse +import logging +import salt.client +from typing import Dict, Any + +# Configure logging +logging.basicConfig( + level=logging.INFO, + format='%(asctime)s - %(levelname)s - %(message)s' +) +log = logging.getLogger(__name__) + +def emit_event(vm_name: str, hypervisor: str, status: str) -> bool: + """ + Emit a VM deployment status event to the salt event bus. + + Args: + vm_name: Name of the VM (hostname_role) + hypervisor: Name of the hypervisor + status: Current deployment status of the VM + + Returns: + bool: True if event was sent successfully, False otherwise + + Raises: + ValueError: If status is not a valid deployment status + """ + log.info("Attempting to emit deployment event...") + + try: + caller = salt.client.Caller() + event_data = { + 'vm_name': vm_name, + 'hypervisor': hypervisor, + 'status': status + } + + # Use consistent event tag structure + event_tag = f'soc/dyanno/hypervisor/{status.lower()}' + + ret = caller.cmd( + 'event.send', + event_tag, + event_data + ) + + if not ret: + log.error("Failed to emit VM deployment status event: %s", event_data) + return False + + log.info("Successfully emitted VM deployment status event: %s", event_data) + return True + + except Exception as e: + log.error("Error emitting VM deployment status event: %s", str(e)) + return False + +def parse_args(): + """Parse command line arguments.""" + parser = argparse.ArgumentParser( + description='Emit VM deployment status events to the Salt event bus.' + ) + parser.add_argument('-v', '--vm-name', required=True, + help='Name of the VM (hostname_role)') + parser.add_argument('-H', '--hypervisor', required=True, + help='Name of the hypervisor') + parser.add_argument('-s', '--status', required=True, + help='Current deployment status of the VM') + return parser.parse_args() + +def main(): + """Main entry point for the script.""" + try: + args = parse_args() + + success = emit_event( + vm_name=args.vm_name, + hypervisor=args.hypervisor, + status=args.status + ) + + if not success: + sys.exit(1) + + except Exception as e: + log.error("Failed to emit status event: %s", str(e)) + sys.exit(1) + +if __name__ == '__main__': + main() \ No newline at end of file diff --git a/salt/hypervisor/map.jinja b/salt/hypervisor/map.jinja index b187bdfb1..cf323f51d 100644 --- a/salt/hypervisor/map.jinja +++ b/salt/hypervisor/map.jinja @@ -6,9 +6,12 @@ {# Build enhanced HYPERVISORS structure #} {% set HYPERVISORS = {} %} +{% do salt.log.info('salt/hypervisor/map.jinja: NODES content: ' ~ NODES | tojson) %} {% for role, hypervisors in NODES.items() %} + {% do salt.log.info('salt/hypervisor/map.jinja: Processing role: ' ~ role) %} {% do HYPERVISORS.update({role: {}}) %} {% for hypervisor, config in hypervisors.items() %} + {% do salt.log.info('salt/hypervisor/map.jinja: Processing hypervisor: ' ~ hypervisor ~ ' with config: ' ~ config | tojson) %} {# Get model from cached grains using Salt runner #} {% set grains = salt.saltutil.runner('cache.grains', tgt=hypervisor ~ '_*', tgt_type='glob') %} {% set model = '' %} @@ -18,17 +21,54 @@ {% endif %} {% set model_config = DEFAULTS.hypervisor.model.get(model, {}) %} - {# Get VM list and states #} + {# Get VM list from VMs file #} {% set vms = {} %} - {% import_json 'hypervisor/hosts/' ~ hypervisor ~ 'VMs' as vm_list %} + {% set vm_list = [] %} + {% set vm_list_file = 'hypervisor/hosts/' ~ hypervisor ~ 'VMs' %} + {% do salt.log.info('salt/hypervisor/map.jinja: VM list file: ' ~ vm_list_file) %} + {% import_json vm_list_file as vm_list %} + {% if vm_list %} + {% do salt.log.info('salt/hypervisor/map.jinja: VM list content: ' ~ vm_list | tojson) %} + {% else %} + {# we won't get here if the vm_list_file doesn't exist because we will get TemplateNotFound on the import_json #} + {% do salt.log.info('salt/hypervisor/map.jinja: VM list empty: ' ~ vm_list_file) %} + {% endif %} - {# Load state for each VM #} + {# Load status and configuration for each VM #} {% for vm in vm_list %} + {# Get VM details from list entry #} {% set hostname = vm.get('hostname', '') %} {% set role = vm.get('role', '') %} - {% if hostname and role %} - {% import_json 'hypervisor/hosts/' ~ hypervisor ~ '/' ~ hostname ~ '_' ~ role as vm_state %} - {% do vms.update({hostname: vm_state}) %} + {% do salt.log.info('salt/hypervisor/map.jinja: Processing VM - hostname: ' ~ hostname ~ ', role: ' ~ role) %} + + {# Load VM configuration from config file #} + {% set vm_file = 'hypervisor/hosts/' ~ hypervisor ~ '/' ~ hostname ~ '_' ~ role %} + {% do salt.log.info('salt/hypervisor/map.jinja: VM config file: ' ~ vm_file) %} + {% import_json vm_file as vm_state %} + {% if vm_state %} + {% do salt.log.info('salt/hypervisor/map.jinja: VM config content: ' ~ vm_state | tojson) %} + {% set vm_data = {'config': vm_state.config} %} + + {# Load VM status from status file #} + {% set status_file = vm_file ~ '.status' %} + {% do salt.log.info('salt/hypervisor/map.jinja: VM status file: ' ~ status_file) %} + {% import_json status_file as status_data %} + {% if status_data %} + {% do salt.log.info('salt/hypervisor/map.jinja: VM status content: ' ~ status_data | tojson) %} + {% do vm_data.update({'status': status_data}) %} + {% else %} + {% do salt.log.info('salt/hypervisor/map.jinja: Status file empty: ' ~ status_file) %} + {% do vm_data.update({ + 'status': { + 'status': '', + 'details': null, + 'timestamp': '' + } + }) %} + {% endif %} + {% do vms.update({hostname: vm_data}) %} + {% else %} + {% do salt.log.info('salt/hypervisor/map.jinja: Config file empty: ' ~ vm_file) %} {% endif %} {% endfor %} diff --git a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware index a6becfb95..3d80ebaeb 100644 --- a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware +++ b/salt/hypervisor/tools/sbin/so-kvm-modify-hardware @@ -25,7 +25,7 @@ used during VM provisioning and hardware reconfiguration tasks. -v, --vm Name of the virtual machine to modify. -c, --cpu Number of virtual CPUs to assign. -m, --memory Amount of memory to assign in MiB. - -p, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:c7:00.0). Can be specified multiple times. + -p, --pci PCI hardware ID(s) to passthrough to the VM (e.g., 0000:00:1f.2). Can be specified multiple times. Format: domain:bus:device.function -s, --start Start the VM after modification. @@ -124,16 +124,34 @@ The `so-kvm-modify-hardware` script modifies hardware parameters of KVM virtual - Both file and console logging are enabled for real-time monitoring - Log entries include timestamps and severity levels - Detailed error messages are logged for troubleshooting - """ import argparse import sys import libvirt import logging +import socket import xml.etree.ElementTree as ET +from io import StringIO from so_vm_utils import start_vm, stop_vm from so_logging_utils import setup_logging +import subprocess + +# Get hypervisor name from local hostname +HYPERVISOR = socket.gethostname() + +# Custom log handler to capture output +class StringIOHandler(logging.Handler): + def __init__(self): + super().__init__() + self.strio = StringIO() + + def emit(self, record): + msg = self.format(record) + self.strio.write(msg + '\n') + + def get_value(self): + return self.strio.getvalue() def parse_arguments(): parser = argparse.ArgumentParser(description='Modify hardware parameters of a KVM virtual machine.') @@ -226,12 +244,15 @@ def redefine_vm(conn, new_xml_desc, logger): def main(): # Set up logging using the so_logging_utils library + string_handler = StringIOHandler() + string_handler.setFormatter(logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')) logger = setup_logging( logger_name='so-kvm-modify-hardware', log_file_path='/opt/so/log/hypervisor/so-kvm-modify-hardware.log', log_level=logging.INFO, format_str='%(asctime)s - %(levelname)s - %(message)s' ) + logger.addHandler(string_handler) try: args = parse_arguments() @@ -247,6 +268,15 @@ def main(): conn = libvirt.open(None) except libvirt.libvirtError as e: logger.error(f"Failed to open connection to libvirt: {e}") + try: + subprocess.run([ + 'so-salt-emit-vm-deployment-status-event', + '-v', vm_name, + '-H', HYPERVISOR, + '-s', 'Hardware Configuration Failed' + ], check=True) + except subprocess.CalledProcessError as e: + logger.error(f"Failed to emit failure status event: {e}") sys.exit(1) # Stop VM if running @@ -262,16 +292,57 @@ def main(): if start_vm_flag: dom = conn.lookupByName(vm_name) start_vm(dom, logger) + logger.info(f"VM '{vm_name}' started successfully.") else: logger.info("VM start flag not provided; VM will remain stopped.") # Close connection conn.close() + + # Send success status event + try: + subprocess.run([ + 'so-salt-emit-vm-deployment-status-event', + '-v', vm_name, + '-H', HYPERVISOR, + '-s', 'Hardware Configuration' + ], check=True) + except subprocess.CalledProcessError as e: + logger.error(f"Failed to emit success status event: {e}") + except KeyboardInterrupt: - logger.error("Operation cancelled by user.") + error_msg = "Operation cancelled by user" + logger.error(error_msg) + try: + subprocess.run([ + 'so-salt-emit-vm-deployment-status-event', + '-v', vm_name, + '-H', HYPERVISOR, + '-s', 'Hardware Configuration Failed' + ], check=True) + except subprocess.CalledProcessError as e: + logger.error(f"Failed to emit failure status event: {e}") sys.exit(1) except Exception as e: - logger.error(f"An error occurred: {e}") + error_msg = str(e) + if "Failed to open connection to libvirt" in error_msg: + error_msg = f"Failed to connect to libvirt: {error_msg}" + elif "Failed to redefine VM" in error_msg: + error_msg = f"Failed to apply hardware changes: {error_msg}" + elif "Failed to modify VM XML" in error_msg: + error_msg = f"Failed to update hardware configuration: {error_msg}" + else: + error_msg = f"An error occurred: {error_msg}" + logger.error(error_msg) + try: + subprocess.run([ + 'so-salt-emit-vm-deployment-status-event', + '-v', vm_name, + '-h', HYPERVISOR, + '-s', 'Hardware Configuration Failed' + ], check=True) + except subprocess.CalledProcessError as e: + logger.error(f"Failed to emit failure status event: {e}") sys.exit(1) if __name__ == '__main__': diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin/so-qcow2-modify-network index 5f0690542..b2651a9c7 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin/so-qcow2-modify-network @@ -118,7 +118,6 @@ The `so-qcow2-modify-network` script modifies network configuration within a QCO - Image mount/unmount operations - Validation failures - File access errors - """ import argparse @@ -127,20 +126,41 @@ import re import sys import logging import os +import socket import ipaddress import configparser import uuid from io import StringIO import libvirt from so_logging_utils import setup_logging +import subprocess + +# Get hypervisor name from local hostname +HYPERVISOR = socket.gethostname() + +# Custom log handler to capture output +class StringIOHandler(logging.Handler): + def __init__(self): + super().__init__() + self.strio = StringIO() + + def emit(self, record): + msg = self.format(record) + self.strio.write(msg + '\n') + + def get_value(self): + return self.strio.getvalue() # Set up logging using the so_logging_utils library +string_handler = StringIOHandler() +string_handler.setFormatter(logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')) logger = setup_logging( logger_name='so-qcow2-modify-network', log_file_path='/opt/so/log/hypervisor/so-qcow2-modify-network.log', log_level=logging.INFO, format_str='%(asctime)s - %(levelname)s - %(message)s' ) +logger.addHandler(string_handler) NETWORK_CONFIG_DIR = "/etc/NetworkManager/system-connections" @@ -403,6 +423,7 @@ def parse_arguments(): parser = argparse.ArgumentParser(description="Modify IPv4 settings in a QCOW2 image for a specified network interface.") parser.add_argument("-I", "--image", required=True, help="Path to the QCOW2 image.") parser.add_argument("-i", "--interface", required=True, help="Network interface to modify (e.g., enp1s0).") + parser.add_argument("-n", "--vm-name", required=True, help="Full name of the VM (hostname_role).") group = parser.add_mutually_exclusive_group(required=True) group.add_argument("--dhcp4", action="store_true", help="Configure interface for DHCP (IPv4).") group.add_argument("--static4", action="store_true", help="Configure interface for static IPv4 settings.") @@ -448,15 +469,47 @@ def main(): modify_network_config(args.image, args.interface, mode, args.ip4, args.gw4, args.dns4, args.search4) logger.info("Network configuration update completed successfully") + # Send success status event + try: + subprocess.run([ + 'so-salt-emit-vm-deployment-status-event', + '-v', args.vm_name, + '-H', HYPERVISOR, + '-s', 'IP Configuration' + ], check=True) + except subprocess.CalledProcessError as e: + logger.error(f"Failed to emit success status event: {e}") + except KeyboardInterrupt: - logger.error("Operation cancelled by user.") + error_msg = "Operation cancelled by user" + logger.error(error_msg) + try: + subprocess.run([ + 'so-salt-emit-vm-deployment-status-event', + '-v', args.vm_name, + '-H', HYPERVISOR, + '-s', 'IP Configuration Failed' + ], check=True) + except subprocess.CalledProcessError as e: + logger.error(f"Failed to emit failure status event: {e}") sys.exit(1) except Exception as e: - if "base domain is running" in str(e): + error_msg = str(e) + if "base domain is running" in error_msg: logger.error("Cannot proceed: Base domain must not be running when modifying network configuration") + error_msg = "Base domain must not be running when modifying network configuration" else: logger.error(f"An error occurred: {e}") + try: + subprocess.run([ + 'so-salt-emit-vm-deployment-status-event', + '-v', args.vm_name, + '-H', HYPERVISOR, + '-s', 'IP Configuration Failed' + ], check=True) + except subprocess.CalledProcessError as e: + logger.error(f"Failed to emit failure status event: {e}") sys.exit(1) -if __name__ == "__main__": +if __name__ == '__main__': main() diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin/so-salt-cloud index 1145c1b65..0d5f5c81c 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin/so-salt-cloud @@ -489,7 +489,7 @@ def run_qcow2_modify_hardware_config(profile, vm_name, cpu=None, memory=None, pc except Exception as e: logger.error(f"An error occurred while running qcow2.modify_hardware_config: {e}") -def run_qcow2_modify_network_config(profile, mode, ip=None, gateway=None, dns=None, search_domain=None): +def run_qcow2_modify_network_config(profile, vm_name, mode, ip=None, gateway=None, dns=None, search_domain=None): hv_name = profile.split('-')[1] target = hv_name + "_*" image = '/nsm/libvirt/images/sool9/sool9.qcow2' @@ -500,6 +500,7 @@ def run_qcow2_modify_network_config(profile, mode, ip=None, gateway=None, dns=No 'image=' + image, 'interface=' + interface, 'mode=' + mode, + 'vm_name=' + vm_name, 'ip4=' + ip if ip else '', 'gw4=' + gateway if gateway else '', 'dns4=' + dns if dns else '', @@ -583,7 +584,7 @@ def main(): mode = "dhcp4" # Default to DHCP if not specified # Step 1: Modify network configuration - run_qcow2_modify_network_config(args.profile, mode, args.ip4, args.gw4, args.dns4, args.search4) + run_qcow2_modify_network_config(args.profile, args.vm_name, mode, args.ip4, args.gw4, args.dns4, args.search4) # Step 2: Provision the VM (without starting it) call_salt_cloud(args.profile, args.vm_name) diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls new file mode 100644 index 000000000..0e2d91e7c --- /dev/null +++ b/salt/orch/dyanno_hypervisor.sls @@ -0,0 +1,97 @@ +{% do salt.log.info('dyanno_hypervisor_orch: Running') %} +{% set event_data = pillar.get('event_data', {}) %} +{% set event_tag = pillar.get('event_tag', '') %} +{% set timestamp = event_data.get('_stamp') %} +{% do salt.log.debug('dyanno_hypervisor_orch: tag: ' ~ event_tag) %} + + +{# Our custom tag #} +{% if event_tag.startswith('soc/dyanno/hypervisor') %} +{% set status_data = event_data.get('data')%} +{% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ status_data|json|string) %} +{% do salt.log.debug('dyanno_hypervisor_orch: Setting vm_name, hypervisor and status') %} +{% set vm_name = status_data.get('vm_name') %} +{% set hypervisor = status_data.get('hypervisor') %} +{% set status = status_data.get('status') %} +{% set details = status_data.get('details', '') %} +{% do salt.log.info('dyanno_hypervisor_orch: vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} +{% endif %} + +{# salt-cloud tag #} +{% if 'salt/cloud/' in event_tag and event_tag.endswith('/destroyed') %} +{% set status_data = event_data %} +{% do salt.log.debug('dyanno_hypervisor_orch: Setting vm_name, hypervisor and status') %} +{% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ status_data|json|string) %} +{% set vm_name = status_data.get('name') %} +{% set hypervisor = None %} +{% set status = status_data.get('event') %} +{% do salt.log.info('dyanno_hypervisor_orch: vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} +{% endif %} + +{# +{% if event_tag.startswith('soc/dyanno/hypervisor') %} +{% if vm_name and status and hypervisor %} +{% do salt.log.info('dyanno_hypervisor_orch: soc.dyanno.hypervisor.write_status state running - vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} +# Write status file + +write_vm_status: + salt.runner: + - name: state.orchestrate + - mods: soc.dyanno.hypervisor.write_status + - pillar: + vm_name: {{ vm_name }} + hypervisor: {{ hypervisor }} + status_data: + timestamp: {{ timestamp }} + status: {{ status }} + details: {{ details }} + event_tag: {{ event_tag }} + +write_vm_status: + salt.state: + - tgt: 'G@role:so-manager or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' + - tgt_type: compound + - sls: + - soc.dyanno.hypervisor.write_status + - concurrent: True + - pillar: + vm_name: {{ vm_name }} + hypervisor: {{ hypervisor }} + status_data: + timestamp: {{ timestamp }} + status: {{ status }} + details: {{ details }} + event_tag: {{ event_tag }} + + +{% else %} +{% do salt.log.error('dyanno_hypervisor_orch: Missing required fields - vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} +{% endif %} +{% endif %} +#} + +{# +update_hypervisor_status: + salt.runner: + - name: state.orchestrate + - mods: soc.dyanno.hypervisor +{% if event_tag.startswith('soc/dyanno/hypervisor') %} + - require: + - salt: write_vm_status +{% endif %} +#} + +# Update hypervisor status +update_hypervisor_annotation: + salt.state: + - tgt: 'G@role:so-manager or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' + - tgt_type: compound + - sls: + - soc.dyanno.hypervisor + - concurrent: True +{#% if event_tag.startswith('soc/dyanno/hypervisor') %} + - require: + - salt: write_vm_status +{% endif %#} + +{% do salt.log.info('dyanno_hypervisor_orch: Completed') %} \ No newline at end of file diff --git a/salt/reactor/createEmptyPillar.sls b/salt/reactor/createEmptyPillar.sls index a182e1338..dccf25f89 100644 --- a/salt/reactor/createEmptyPillar.sls +++ b/salt/reactor/createEmptyPillar.sls @@ -7,14 +7,32 @@ import logging import os +import pwd +import grp def run(): vm_name = data['kwargs']['name'] logging.error("createEmptyPillar reactor: vm_name: %s" % vm_name) pillar_root = '/opt/so/saltstack/local/pillar/minions/' pillar_files = ['adv_' + vm_name + '.sls', vm_name + '.sls'] - for f in pillar_files: - if not os.path.exists(pillar_root + f): - os.mknod(pillar_root + f) + + try: + # Get socore user and group IDs + socore_uid = pwd.getpwnam('socore').pw_uid + socore_gid = grp.getgrnam('socore').gr_gid + + for f in pillar_files: + full_path = pillar_root + f + if not os.path.exists(full_path): + # Create empty file + os.mknod(full_path) + # Set ownership to socore:socore + os.chown(full_path, socore_uid, socore_gid) + # Set mode to 644 (rw-r--r--) + os.chmod(full_path, 0o644) + logging.error("createEmptyPillar reactor: created %s with socore:socore ownership and mode 644" % f) + + except (KeyError, OSError) as e: + logging.error("createEmptyPillar reactor: Error setting ownership/permissions: %s" % str(e)) return {} diff --git a/salt/reactor/vm_status.sls b/salt/reactor/vm_status.sls new file mode 100644 index 000000000..5dc0c0f6d --- /dev/null +++ b/salt/reactor/vm_status.sls @@ -0,0 +1,117 @@ +{% do salt.log.debug('vm_status_reactor: Running') %} +{% do salt.log.debug('vm_status_reactor: tag: ' ~ tag | string) %} + +{# Remove all the nasty characters that exist in this data #} +{% if tag.startswith('salt/cloud/') and tag.endswith('/deploying') %} +{% set data = { + "_stamp": data._stamp, + "event": data.event, + "kwargs": { + "cloud_grains": data.kwargs.cloud_grains + } +} %} +{% endif %} + +{% do salt.log.debug('vm_status_reactor: Received data: ' ~ data|json|string) %} + +{# +update_hypervisor: + runner.state.orchestrate: + - args: + - mods: orch.dyanno_hypervisor + - pillar: + event_tag: {{ tag }} + event_data: {{ data }} +#} + +{# Our custom tag #} +{% if tag.startswith('soc/dyanno/hypervisor') %} +{% set status_data = data.get('data')%} +{% do salt.log.debug('vm_status_reactor: Received data: ' ~ status_data|json|string) %} +{% do salt.log.debug('vm_status_reactor: Setting vm_name, hypervisor and status') %} +{% set vm_name = status_data.get('vm_name') %} +{% set hypervisor = status_data.get('hypervisor') %} +{% set status = status_data.get('status') %} +{% set details = status_data.get('details', '') %} +{% endif %} + +{# setup/so-minion tag #} +{% if tag == ('setup/so-minion') %} +{% set status_data = data.get('data')%} +{% do salt.log.debug('vm_status_reactor: Received data: ' ~ status_data|json|string) %} +{% do salt.log.debug('vm_status_reactor: Setting vm_name, hypervisor and status') %} +{% set vm_name = data.get('id') %} + +{% set grains = salt.saltutil.runner('cache.grains', tgt=vm_name).get(vm_name) %} +{% if grains %} +{% do salt.log.debug('vm_status_reactor: Got cache.grains ' ~ grains|string) %} +{% if grains.get('salt-cloud').get('profile') %} +{% do salt.log.debug('vm_status_reactor: Found salt-cloud:profile grain: ' ~ grains.get('salt-cloud').get('profile')|string) %} +{% set hypervisor = grains.get('salt-cloud').get('profile').split('-')[1] %} +{% do salt.log.debug('vm_status_reactor: Got hypervisor: ' ~ hypervisor) %} +{% endif %} +{% else %} +{% do salt.log.debug('vm_status_reactor: Did not get cache.grains.') %} +{% endif %} + +{% set hypervisor = hypervisor %} +{% set status = 'Initialize Minion Pillars' %} +{% set details = status_data.get('details', '') %} +{% endif %} + +{# salt-cloud tag #} +{% if tag.startswith('salt/cloud/') and (tag.endswith('/creating') or tag.endswith('/deploying') or tag.endswith('/created') or tag.endswith('/destroyed')) %} +{% do salt.log.debug('vm_status_reactor: Received data: ' ~ data|json|string) %} +{% do salt.log.debug('vm_status_reactor: Setting vm_name, hypervisor and status') %} +{% set vm_name = tag.split('/')[2] %} +{% do salt.log.debug('vm_status_reactor: Got vm_name from tag: ' ~ vm_name) %} + +{% if tag.endswith('/deploying') %} +{% set hypervisor = data.get('kwargs').get('cloud_grains').get('profile').split('-')[1] %} +{% endif %} + +{% if data.get('profile', False) %} +{% do salt.log.debug('vm_status_reactor: Did not get cache.grains.') %} +{% set hypervisor = data.profile.split('-')[1] %} +{% do salt.log.debug('vm_status_reactor: Got hypervisor from data: ' ~ hypervisor) %} +{% else %} +{% set grains = salt.saltutil.runner('cache.grains', tgt=vm_name).get(vm_name) %} +{% if grains %} +{% do salt.log.debug('vm_status_reactor: Got cache.grains: ' ~ grains|string) %} +{% if grains.get('salt-cloud').get('profile') %} +{% do salt.log.debug('vm_status_reactor: Found salt-cloud:profile grain: ' ~ grains.get('salt-cloud').get('profile')|string) %} +{% set hypervisor = grains.get('salt-cloud').get('profile').split('-')[1] %} +{% do salt.log.debug('vm_status_reactor: Got hypervisor: ' ~ hypervisor) %} +{% endif %} +{% endif %} +{% endif %} + +{% set status = data.get('event').title() %} +{% set details = data.get('details', '') %} +{% endif %} + +{% do salt.log.info('vm_status_reactor: vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} + +{% set timestamp = data.get('_stamp') %} +write_vm_status: + runner.state.orchestrate: + - args: + - mods: soc.dyanno.hypervisor.write_status + - pillar: + vm_name: {{ vm_name }} + hypervisor: {{ hypervisor }} + status_data: + timestamp: {{ timestamp }} + status: {{ status }} + details: {{ details }} + event_tag: {{ tag }} + +update_hypervisor: + runner.state.orchestrate: + - args: + - mods: orch.dyanno_hypervisor + - pillar: + event_tag: {{ tag }} + event_data: {{ data }} + +{% do salt.log.debug('vm_status_reactor: Completed') %} \ No newline at end of file diff --git a/salt/salt/cloud/reactor_config_hypervisor.sls b/salt/salt/cloud/reactor_config_hypervisor.sls index 433e01f31..fcf1a5dfe 100644 --- a/salt/salt/cloud/reactor_config_hypervisor.sls +++ b/salt/salt/cloud/reactor_config_hypervisor.sls @@ -19,13 +19,21 @@ reactor_config_hypervisor: reactor: - 'salt/key': - salt://reactor/check_hypervisor.sls + - 'salt/cloud/*/creating': + - /opt/so/saltstack/default/salt/reactor/vm_status.sls - 'salt/cloud/*/deploying': - /opt/so/saltstack/default/salt/reactor/createEmptyPillar.sls + - /opt/so/saltstack/default/salt/reactor/vm_status.sls - 'setup/so-minion': - /opt/so/saltstack/default/salt/reactor/sominion_setup.sls + - /opt/so/saltstack/default/salt/reactor/vm_status.sls + - 'salt/cloud/*/created': + - /opt/so/saltstack/default/salt/reactor/vm_status.sls + - 'soc/dyanno/hypervisor/*': + - /opt/so/saltstack/default/salt/reactor/vm_status.sls - 'salt/cloud/*/destroyed': - - /opt/so/saltstack/default/salt/reactor/virtReleaseHardware.sls - /opt/so/saltstack/default/salt/reactor/deleteKey.sls + - /opt/so/saltstack/default/salt/reactor/vm_status.sls - user: root - group: root - mode: 644 diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index ef04032ce..9e59b3d9a 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -462,7 +462,8 @@ def create_vm_tracking_file(hypervisor_path: str, vm_name: str, config: dict) -> data = { 'config': config, - 'status': 'creating' + 'status': 'creating', + 'timestamp': datetime.now().isoformat() } # Write file and set ownership write_json_file(file_path, data) @@ -487,9 +488,10 @@ def mark_vm_failed(vm_file: str, error_code: int, message: str) -> None: data = { 'config': config, 'status': 'error', + 'timestamp': datetime.now().isoformat(), 'error_details': { - 'message': message, - 'timestamp': datetime.now().isoformat() + 'code': error_code, + 'message': message } } write_json_file(error_file, data) @@ -512,9 +514,10 @@ def mark_invalid_hardware(hypervisor_path: str, vm_name: str, config: dict, erro data = { 'config': config, 'status': 'error', + 'timestamp': datetime.now().isoformat(), 'error_details': { - 'message': full_message, - 'timestamp': datetime.now().isoformat() + 'code': 3, # Hardware validation failure code + 'message': full_message } } write_json_file(file_path, data) @@ -577,6 +580,17 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: model = get_hypervisor_model(hypervisor) model_config = load_hardware_defaults(model) + # Send Processing status event + try: + subprocess.run([ + 'so-salt-emit-vm-deployment-status-event', + '-v', vm_name, + '-H', hypervisor, + '-s', 'Processing' + ], check=True) + except subprocess.CalledProcessError as e: + logger.error(f"Failed to emit success status event: {e}") + # Initial hardware validation against model is_valid, errors = validate_hardware_request(model_config, vm_config) if not is_valid: @@ -626,10 +640,11 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: # Execute command result = subprocess.run(cmd, capture_output=True, text=True, check=True) - # Update tracking file status + # Update tracking file status with timestamp tracking_file = os.path.join(hypervisor_path, vm_name) data = read_json_file(tracking_file) data['status'] = 'running' + data['timestamp'] = datetime.now().isoformat() write_json_file(tracking_file, data) except subprocess.CalledProcessError as e: @@ -721,7 +736,8 @@ def process_hypervisor(hypervisor_path: str) -> None: existing_vms = set() for file_path in glob.glob(os.path.join(hypervisor_path, '*_*')): basename = os.path.basename(file_path) - if not basename.endswith('.error'): + # Skip error and status files + if not basename.endswith('.error') and not basename.endswith('.status'): existing_vms.add(basename) # Process new VMs diff --git a/salt/soc/dyanno/hypervisor/init.sls b/salt/soc/dyanno/hypervisor/init.sls index 5645a8f63..5914cdf5b 100644 --- a/salt/soc/dyanno/hypervisor/init.sls +++ b/salt/soc/dyanno/hypervisor/init.sls @@ -5,6 +5,8 @@ hypervisor_annotation: - name: /opt/so/saltstack/default/salt/hypervisor/soc_hypervisor.yaml - source: salt://soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja - template: jinja + - user: socore + - group: socore - defaults: HYPERVISORS: {{ HYPERVISORS }} diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index f5ce34563..f24ca69da 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -3,8 +3,27 @@ {%- set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') -%} -{%- macro update_description(description, cpu_free, mem_free, disk_free, copper_free, sfp_free) -%} -{{- description -}} +{%- macro update_description(description, cpu_free, mem_free, disk_free, copper_free, sfp_free, vm_list) -%} +{{- description }} + +Resource Summary: +- CPU: {{ cpu_free }} cores available +- Memory: {{ mem_free }}GB available +- Disk Slots: {{ disk_free if disk_free else 'None' }} available +- Copper Ports: {{ copper_free if copper_free else 'None' }} available +- SFP Ports: {{ sfp_free if sfp_free else 'None' }} available + +{%- if vm_list %} +Virtual Machines: +{%- for hostname, vm_data in vm_list.items() %} +- {{ hostname }}: + Status: {{ vm_data.get('status', {}).get('status', 'Unknown') }} + Details: {{ vm_data.get('status', {}).get('details', 'No details available') }} + Last Updated: {{ vm_data.get('status', {}).get('timestamp', 'Never') }} +{%- endfor %} +{%- else %} +No Virtual Machines Found +{%- endif %} {%- endmacro -%} {%- macro update_label(label, total, free) -%} @@ -91,7 +110,8 @@ mem_free, disk_free, copper_free, - sfp_free + sfp_free, + vms ) }) -%} {%- do ANNOTATION.hypervisor.hosts.update({hypervisor ~ 'VMs': updated_template}) -%} diff --git a/salt/soc/dyanno/hypervisor/write_status.sls b/salt/soc/dyanno/hypervisor/write_status.sls new file mode 100644 index 000000000..96dcf7e9f --- /dev/null +++ b/salt/soc/dyanno/hypervisor/write_status.sls @@ -0,0 +1,69 @@ +{% do salt.log.info('soc/dyanno/hypervisor/write_status: Running') %} +{% set vm_name = pillar.get('vm_name') %} +{% set hypervisor = pillar.get('hypervisor') %} +{% set status_data = pillar.get('status_data', {}) %} +{% set event_tag = pillar.get('event_tag') %} +{% do salt.log.debug('soc/dyanno/hypervisor/write_status: tag: ' ~ event_tag) %} +{% set base_path = '/opt/so/saltstack/local/salt/hypervisor/hosts' %} +{% set status_dir = base_path ~ '/' ~ hypervisor %} +{% set status_file = status_dir ~ '/' ~ vm_name ~ '.status' %} + +# Define the list of process steps in order (case-sensitive) +{% set process_steps = ['Processing', 'IP Configuration', 'Starting Create', 'Executing Deploy Script', 'Initialize Minion Pillars', 'Created Instance', 'Hardware Configuration', 'Highstate Triggered', 'Destroyed Instance'] %} +{% set new_index = process_steps.index(status_data.get('status')) %} +{% do salt.log.debug('soc/dyanno/hypervisor/write_status: new_index: ' ~ new_index|string) %} + +# Function to read and parse current JSON status file +{% macro get_current_status(status_file) %} +{% do salt.log.debug('soc/dyanno/hypervisor/write_status: getting current status from file: ' ~ status_file) %} + +{% set rel_path_status_file = 'hypervisor/hosts' ~ '/' ~ hypervisor ~ '/' ~ vm_name ~ '.status' %} +{# If the status file doesn't exist, then we are just now Processing, so return -1 #} +{% if salt['file.file_exists'](status_file)%} +{% import_json rel_path_status_file as current_status %} +{% do salt.log.debug('soc/dyanno/hypervisor/write_status: current status: ' ~ current_status) %} +{% do salt.log.debug('soc/dyanno/hypervisor/write_status: current status: ' ~ current_status.get('status')) %} +{% if current_status.get('status') in process_steps %} +{% set current_index = process_steps.index(current_status.get('status')) %} +{% do salt.log.debug('soc/dyanno/hypervisor/write_status: current_index: ' ~ current_index|string) %} +{%- set return_value = current_index -%} +{% else %} +{%- set return_value = -1 -%} +{% endif %} +{% else %} +{% set return_value = -1 %} +{% endif %} +{{- return_value -}} +{% endmacro %} + +{% set current_index = get_current_status(status_file)|int %} +{% do salt.log.debug('soc/dyanno/hypervisor/write_status: ' ~ status_file ~ ' current status index: ' ~ current_index|string) %} + +ensure_status_dir: + file.directory: + - name: {{ status_dir }} + - user: 939 + - group: 939 + - mode: 755 + - makedirs: True + + +{# Some of the status updates trigger within a second of each other can can cause, for example, IP Configuration orchestration to process before the Processing #} +{# This check has been put in place to ensure a status sooner in the process can't overwrite this file if a status later in the process wrote to it first. #} +{# The final step is Destroyed, so we allow Processing to overwrite that incase someone creates a new VM with same name that was previously destroyed. #} +{% if new_index > current_index or current_index == process_steps | length - 1 %} +write_status_file: + file.serialize: + - name: {{ status_file }} + - dataset: {{ status_data|json }} + - formatter: json + - user: 939 + - group: 939 + - mode: 600 + - indent: 2 + - require: + - file: ensure_status_dir +{% else %} +{% do salt.log.debug('soc/dyanno/hypervisor/write_status: File not written. ' ~ process_steps[new_index] ~ ' cannot overwrite ' ~ process_steps[current_index] ~ '.' ) %} +{% endif %} +{% do salt.log.info('soc/dyanno/hypervisor/write_status: Completed') %} diff --git a/salt/top.sls b/salt/top.sls index 82f074626..0d22bd782 100644 --- a/salt/top.sls +++ b/salt/top.sls @@ -11,6 +11,7 @@ base: 'salt-cloud:driver:libvirt': - match: grain - storage + - vm_status '*': - cron.running diff --git a/salt/vm_status/init.sls b/salt/vm_status/init.sls new file mode 100644 index 000000000..ba2b21968 --- /dev/null +++ b/salt/vm_status/init.sls @@ -0,0 +1,10 @@ +# Send highstate trigger event for VM deployment status tracking +# so-salt-emit-vm-deployment-status sets event_tag = f'soc/dyanno/hypervisor/{status.lower()}' +vm_highstate_trigger: + event.send: + - name: soc/dyanno/hypervisor/highstate triggered + - data: + status: Highstate Triggered + vm_name: {{ grains.id }} + hypervisor: {{ salt['grains.get']('salt-cloud:profile', '').split('-')[1] }} + - order: 1 # Ensure this runs early in the highstate process \ No newline at end of file From 3246176c0a8c5c076be29c6b6f7ffabea2ddc1be Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 21 Feb 2025 14:34:08 -0500 Subject: [PATCH 135/303] comments --- .../so-salt-emit-vm-deployment-status-event | 18 +++++++++- salt/hypervisor/init.sls | 7 ++++ salt/hypervisor/map.jinja | 25 +++++++++++++- .../so-kvm-modify-hardware | 16 +++++++++ .../so-qcow2-modify-network | 16 +++++++++ .../tools/{sbin => sbin_jinja}/so-salt-cloud | 16 +++++++++ salt/orch/dyanno_hypervisor.sls | 27 +++++++++++++-- salt/reactor/vm_status.sls | 7 +++- .../engines/master/virtual_node_manager.py | 6 ++++ salt/soc/dyanno/hypervisor/init.sls | 33 ++++++++++++++++--- .../hypervisor/soc_hypervisor.yaml.jinja | 23 +++++++++++++ salt/soc/dyanno/hypervisor/write_status.sls | 26 +++++++++++++++ salt/vm_status/init.sls | 27 ++++++++++++++- 13 files changed, 237 insertions(+), 10 deletions(-) rename salt/common/tools/{sbin => sbin_jinja}/so-salt-emit-vm-deployment-status-event (84%) rename salt/hypervisor/tools/{sbin => sbin_jinja}/so-kvm-modify-hardware (95%) rename salt/hypervisor/tools/{sbin => sbin_jinja}/so-qcow2-modify-network (97%) rename salt/manager/tools/{sbin => sbin_jinja}/so-salt-cloud (97%) diff --git a/salt/common/tools/sbin/so-salt-emit-vm-deployment-status-event b/salt/common/tools/sbin_jinja/so-salt-emit-vm-deployment-status-event similarity index 84% rename from salt/common/tools/sbin/so-salt-emit-vm-deployment-status-event rename to salt/common/tools/sbin_jinja/so-salt-emit-vm-deployment-status-event index 454e1ba9b..61f071130 100644 --- a/salt/common/tools/sbin/so-salt-emit-vm-deployment-status-event +++ b/salt/common/tools/sbin_jinja/so-salt-emit-vm-deployment-status-event @@ -4,6 +4,14 @@ # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) -%} """ Script for emitting VM deployment status events to the Salt event bus. @@ -113,4 +121,12 @@ def main(): sys.exit(1) if __name__ == '__main__': - main() \ No newline at end of file + main() + +{%- else -%} + +echo "Hypervisor nodes are a feature supported only for customers with a valid license. \ + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com \ + for more information about purchasing a license to enable this feature." + +{% endif -%} diff --git a/salt/hypervisor/init.sls b/salt/hypervisor/init.sls index 7bec6f25c..677ab8642 100644 --- a/salt/hypervisor/init.sls +++ b/salt/hypervisor/init.sls @@ -23,6 +23,13 @@ hypervisor_sbin: - source: salt://hypervisor/tools/sbin - file_mode: 744 +hypervisor_sbin_jinja: + file.recurse: + - name: /usr/sbin + - source: salt://hypervisor/tools/sbin_jinja + - template: jinja + - file_mode: 744 + {% else %} {{sls}}_no_license_detected: test.fail_without_changes: diff --git a/salt/hypervisor/map.jinja b/salt/hypervisor/map.jinja index cf323f51d..a9a76e557 100644 --- a/salt/hypervisor/map.jinja +++ b/salt/hypervisor/map.jinja @@ -1,3 +1,16 @@ +{# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. + + Note: Per the Elastic License 2.0, the second limitation states: + + "You may not move, change, disable, or circumvent the license key functionality + in the software, and you may not remove or obscure any functionality in the + software that is protected by the license key." #} + +{% if 'hvn' in salt['pillar.get']('features', []) %} + {# Import defaults.yaml for model hardware capabilities #} {% import_yaml 'hypervisor/defaults.yaml' as DEFAULTS %} @@ -82,4 +95,14 @@ } }) %} {% endfor %} -{% endfor %} \ No newline at end of file +{% endfor %} + +{% else %} + +{% do salt.log.error( + 'Hypervisor nodes are a feature supported only for customers with a valid license.' + 'Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com' + 'for more information about purchasing a license to enable this feature.' +) %} + +{% endif %} diff --git a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin_jinja/so-kvm-modify-hardware similarity index 95% rename from salt/hypervisor/tools/sbin/so-kvm-modify-hardware rename to salt/hypervisor/tools/sbin_jinja/so-kvm-modify-hardware index 3d80ebaeb..25506a0ae 100644 --- a/salt/hypervisor/tools/sbin/so-kvm-modify-hardware +++ b/salt/hypervisor/tools/sbin_jinja/so-kvm-modify-hardware @@ -4,6 +4,14 @@ # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) %} """ Script for managing hardware configurations of KVM virtual machines. This script provides @@ -347,3 +355,11 @@ def main(): if __name__ == '__main__': main() + +{%- else -%} + +echo "Hypervisor nodes are a feature supported only for customers with a valid license. \ + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com \ + for more information about purchasing a license to enable this feature." + +{% endif -%} diff --git a/salt/hypervisor/tools/sbin/so-qcow2-modify-network b/salt/hypervisor/tools/sbin_jinja/so-qcow2-modify-network similarity index 97% rename from salt/hypervisor/tools/sbin/so-qcow2-modify-network rename to salt/hypervisor/tools/sbin_jinja/so-qcow2-modify-network index b2651a9c7..cd7869fd8 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin_jinja/so-qcow2-modify-network @@ -4,6 +4,14 @@ # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) -%} """ Script for modifying network configurations within QCOW2 virtual machine images. This script provides @@ -513,3 +521,11 @@ def main(): if __name__ == '__main__': main() + +{%- else -%} + +echo "Hypervisor nodes are a feature supported only for customers with a valid license. \ + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com \ + for more information about purchasing a license to enable this feature." + +{% endif -%} diff --git a/salt/manager/tools/sbin/so-salt-cloud b/salt/manager/tools/sbin_jinja/so-salt-cloud similarity index 97% rename from salt/manager/tools/sbin/so-salt-cloud rename to salt/manager/tools/sbin_jinja/so-salt-cloud index 0d5f5c81c..cddcbb474 100644 --- a/salt/manager/tools/sbin/so-salt-cloud +++ b/salt/manager/tools/sbin_jinja/so-salt-cloud @@ -4,6 +4,14 @@ # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) -%} """ Script for automated virtual machine provisioning and configuration in Security Onion's virtualization infrastructure. @@ -601,3 +609,11 @@ def main(): if __name__ == "__main__": main() + +{%- else -%} + +echo "Hypervisor nodes are a feature supported only for customers with a valid license. \ + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com \ + for more information about purchasing a license to enable this feature." + +{% endif -%} diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index 0e2d91e7c..9bac12a6b 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -1,3 +1,16 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) %} + {% do salt.log.info('dyanno_hypervisor_orch: Running') %} {% set event_data = pillar.get('event_data', {}) %} {% set event_tag = pillar.get('event_tag', '') %} @@ -70,7 +83,7 @@ write_vm_status: {% endif %} #} -{# +{# We will need to populate hypervisor:hosts in this orch and pass to state to run as runner update_hypervisor_status: salt.runner: - name: state.orchestrate @@ -94,4 +107,14 @@ update_hypervisor_annotation: - salt: write_vm_status {% endif %#} -{% do salt.log.info('dyanno_hypervisor_orch: Completed') %} \ No newline at end of file +{% do salt.log.info('dyanno_hypervisor_orch: Completed') %} + +{% else %} + +{% do salt.log.error( + 'Hypervisor nodes are a feature supported only for customers with a valid license.' + 'Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com' + 'for more information about purchasing a license to enable this feature.' +) %} + +{% endif %} diff --git a/salt/reactor/vm_status.sls b/salt/reactor/vm_status.sls index 5dc0c0f6d..5e32ac18f 100644 --- a/salt/reactor/vm_status.sls +++ b/salt/reactor/vm_status.sls @@ -1,3 +1,8 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + {% do salt.log.debug('vm_status_reactor: Running') %} {% do salt.log.debug('vm_status_reactor: tag: ' ~ tag | string) %} @@ -114,4 +119,4 @@ update_hypervisor: event_tag: {{ tag }} event_data: {{ data }} -{% do salt.log.debug('vm_status_reactor: Completed') %} \ No newline at end of file +{% do salt.log.debug('vm_status_reactor: Completed') %} diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index 9e59b3d9a..98a4eb572 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -4,6 +4,12 @@ # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." """ Salt Engine for Virtual Node Management diff --git a/salt/soc/dyanno/hypervisor/init.sls b/salt/soc/dyanno/hypervisor/init.sls index 5914cdf5b..f29ef0367 100644 --- a/salt/soc/dyanno/hypervisor/init.sls +++ b/salt/soc/dyanno/hypervisor/init.sls @@ -1,4 +1,17 @@ -{% from 'hypervisor/map.jinja' import HYPERVISORS %} +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) %} + +{% from 'hypervisor/map.jinja' import HYPERVISORS %} hypervisor_annotation: file.managed: @@ -10,8 +23,8 @@ hypervisor_annotation: - defaults: HYPERVISORS: {{ HYPERVISORS }} -{% for role in HYPERVISORS %} -{% for hypervisor in HYPERVISORS[role].keys() %} +{% for role in HYPERVISORS %} +{% for hypervisor in HYPERVISORS[role].keys() %} hypervisor_host_directory_{{hypervisor}}: file.directory: - name: /opt/so/saltstack/local/salt/hypervisor/hosts/{{hypervisor}} @@ -21,5 +34,17 @@ hypervisor_host_directory_{{hypervisor}}: - recurse: - user - group +{% endfor %} {% endfor %} -{% endfor %} + +{% else %} + +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." + +{% endif %} diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index f24ca69da..453aa436c 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -1,3 +1,16 @@ +{# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. + + Note: Per the Elastic License 2.0, the second limitation states: + + "You may not move, change, disable, or circumvent the license key functionality + in the software, and you may not remove or obscure any functionality in the + software that is protected by the license key." #} + +{%- if 'hvn' in salt['pillar.get']('features', []) -%} + {%- import_yaml 'soc/dyanno/hypervisor/hypervisor.yaml' as ANNOTATION -%} {%- from 'hypervisor/map.jinja' import HYPERVISORS -%} @@ -119,3 +132,13 @@ No Virtual Machines Found {%- endfor -%} {{- ANNOTATION | yaml(False) -}} + +{%- else -%} + +{%- do salt.log.error( + 'Hypervisor nodes are a feature supported only for customers with a valid license.' + 'Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com' + 'for more information about purchasing a license to enable this feature.' +) -%} + +{%- endif -%} diff --git a/salt/soc/dyanno/hypervisor/write_status.sls b/salt/soc/dyanno/hypervisor/write_status.sls index 96dcf7e9f..4babf7687 100644 --- a/salt/soc/dyanno/hypervisor/write_status.sls +++ b/salt/soc/dyanno/hypervisor/write_status.sls @@ -1,3 +1,16 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) %} + {% do salt.log.info('soc/dyanno/hypervisor/write_status: Running') %} {% set vm_name = pillar.get('vm_name') %} {% set hypervisor = pillar.get('hypervisor') %} @@ -64,6 +77,19 @@ write_status_file: - require: - file: ensure_status_dir {% else %} + {% do salt.log.debug('soc/dyanno/hypervisor/write_status: File not written. ' ~ process_steps[new_index] ~ ' cannot overwrite ' ~ process_steps[current_index] ~ '.' ) %} + {% endif %} + {% do salt.log.info('soc/dyanno/hypervisor/write_status: Completed') %} + +{% else %} + +{% do salt.log.error( + 'Hypervisor nodes are a feature supported only for customers with a valid license.' + 'Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com' + 'for more information about purchasing a license to enable this feature.' +) %} + +{% endif %} diff --git a/salt/vm_status/init.sls b/salt/vm_status/init.sls index ba2b21968..c6b39c12e 100644 --- a/salt/vm_status/init.sls +++ b/salt/vm_status/init.sls @@ -1,3 +1,16 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) %} + # Send highstate trigger event for VM deployment status tracking # so-salt-emit-vm-deployment-status sets event_tag = f'soc/dyanno/hypervisor/{status.lower()}' vm_highstate_trigger: @@ -7,4 +20,16 @@ vm_highstate_trigger: status: Highstate Triggered vm_name: {{ grains.id }} hypervisor: {{ salt['grains.get']('salt-cloud:profile', '').split('-')[1] }} - - order: 1 # Ensure this runs early in the highstate process \ No newline at end of file + - order: 1 # Ensure this runs early in the highstate process + +{% else %} + +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." + +{% endif %} From fd9a4966ec29ffba13cdde365e56a090da30c60e Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Sun, 23 Feb 2025 14:07:51 -0500 Subject: [PATCH 136/303] move logic from reactor to orchestration --- salt/orch/dyanno_hypervisor.sls | 124 +++++++++++++++++--------------- salt/reactor/vm_status.sls | 108 +++------------------------- 2 files changed, 76 insertions(+), 156 deletions(-) diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index 9bac12a6b..959a4a9c4 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -12,76 +12,72 @@ {% if 'hvn' in salt['pillar.get']('features', []) %} {% do salt.log.info('dyanno_hypervisor_orch: Running') %} -{% set event_data = pillar.get('event_data', {}) %} -{% set event_tag = pillar.get('event_tag', '') %} -{% set timestamp = event_data.get('_stamp') %} -{% do salt.log.debug('dyanno_hypervisor_orch: tag: ' ~ event_tag) %} - +{% set data = pillar.get('data', {}) %} +{% set tag = pillar.get('tag', '') %} +{% set timestamp = data.get('_stamp') %} +{% do salt.log.debug('dyanno_hypervisor_orch: tag: ' ~ tag) %} +{% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ data|json|string) %} {# Our custom tag #} -{% if event_tag.startswith('soc/dyanno/hypervisor') %} -{% set status_data = event_data.get('data')%} +{% if tag.startswith('soc/dyanno/hypervisor') %} +{% set status_data = data.get('data')%} {% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ status_data|json|string) %} {% do salt.log.debug('dyanno_hypervisor_orch: Setting vm_name, hypervisor and status') %} {% set vm_name = status_data.get('vm_name') %} {% set hypervisor = status_data.get('hypervisor') %} {% set status = status_data.get('status') %} -{% set details = status_data.get('details', '') %} -{% do salt.log.info('dyanno_hypervisor_orch: vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} +{% endif %} + +{# setup/so-minion tag #} +{% if tag == ('setup/so-minion') %} +{% set status_data = data.get('data')%} +{% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ status_data|json|string) %} +{% do salt.log.debug('dyanno_hypervisor_orch: Setting vm_name, hypervisor and status') %} +{% set vm_name = data.get('id') %} +{% set grains = salt.saltutil.runner('cache.grains', tgt=vm_name).get(vm_name) %} +{% if grains %} +{% do salt.log.debug('dyanno_hypervisor_orch: Got cache.grains ' ~ grains|string) %} +{% if grains.get('salt-cloud').get('profile') %} +{% do salt.log.debug('dyanno_hypervisor_orch: Found salt-cloud:profile grain: ' ~ grains.get('salt-cloud').get('profile')|string) %} +{% set hypervisor = grains.get('salt-cloud').get('profile').split('-')[1] %} +{% do salt.log.debug('dyanno_hypervisor_orch: Got hypervisor: ' ~ hypervisor) %} +{% endif %} +{% else %} +{% do salt.log.debug('dyanno_hypervisor_orch: Did not get cache.grains.') %} +{% endif %} +{% set hypervisor = hypervisor %} +{% set status = 'Initialize Minion Pillars' %} {% endif %} {# salt-cloud tag #} -{% if 'salt/cloud/' in event_tag and event_tag.endswith('/destroyed') %} -{% set status_data = event_data %} +{% if tag.startswith('salt/cloud/') and (tag.endswith('/creating') or tag.endswith('/deploying') or tag.endswith('/created') or tag.endswith('/destroyed')) %} +{% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ data|json|string) %} {% do salt.log.debug('dyanno_hypervisor_orch: Setting vm_name, hypervisor and status') %} -{% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ status_data|json|string) %} -{% set vm_name = status_data.get('name') %} -{% set hypervisor = None %} -{% set status = status_data.get('event') %} -{% do salt.log.info('dyanno_hypervisor_orch: vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} -{% endif %} - -{# -{% if event_tag.startswith('soc/dyanno/hypervisor') %} -{% if vm_name and status and hypervisor %} -{% do salt.log.info('dyanno_hypervisor_orch: soc.dyanno.hypervisor.write_status state running - vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} -# Write status file - -write_vm_status: - salt.runner: - - name: state.orchestrate - - mods: soc.dyanno.hypervisor.write_status - - pillar: - vm_name: {{ vm_name }} - hypervisor: {{ hypervisor }} - status_data: - timestamp: {{ timestamp }} - status: {{ status }} - details: {{ details }} - event_tag: {{ event_tag }} - -write_vm_status: - salt.state: - - tgt: 'G@role:so-manager or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' - - tgt_type: compound - - sls: - - soc.dyanno.hypervisor.write_status - - concurrent: True - - pillar: - vm_name: {{ vm_name }} - hypervisor: {{ hypervisor }} - status_data: - timestamp: {{ timestamp }} - status: {{ status }} - details: {{ details }} - event_tag: {{ event_tag }} - - -{% else %} -{% do salt.log.error('dyanno_hypervisor_orch: Missing required fields - vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} +{% set vm_name = tag.split('/')[2] %} +{% do salt.log.debug('dyanno_hypervisor_orch: Got vm_name from tag: ' ~ vm_name) %} +{% if tag.endswith('/deploying') %} +{% set hypervisor = data.get('kwargs').get('cloud_grains').get('profile').split('-')[1] %} {% endif %} +{% if data.get('profile', False) %} +{% do salt.log.debug('dyanno_hypervisor_orch: Did not get cache.grains.') %} +{% set hypervisor = data.profile.split('-')[1] %} +{% do salt.log.debug('dyanno_hypervisor_orch: Got hypervisor from data: ' ~ hypervisor) %} +{% else %} +{% set grains = salt.saltutil.runner('cache.grains', tgt=vm_name).get(vm_name) %} +{% if grains %} +{% do salt.log.debug('dyanno_hypervisor_orch: Got cache.grains: ' ~ grains|string) %} +{% if grains.get('salt-cloud').get('profile') %} +{% do salt.log.debug('dyanno_hypervisor_orch: Found salt-cloud:profile grain: ' ~ grains.get('salt-cloud').get('profile')|string) %} +{% set hypervisor = grains.get('salt-cloud').get('profile').split('-')[1] %} +{% do salt.log.debug('dyanno_hypervisor_orch: Got hypervisor: ' ~ hypervisor) %} +{% endif %} +{% endif %} +{% endif %} +{% set status = data.get('event').title() %} {% endif %} -#} + +{% do salt.log.info('dyanno_hypervisor_orch: vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} + {# We will need to populate hypervisor:hosts in this orch and pass to state to run as runner update_hypervisor_status: @@ -94,6 +90,18 @@ update_hypervisor_status: {% endif %} #} +write_vm_status: + salt.runner: + - name: state.orchestrate + - mods: soc.dyanno.hypervisor.write_status + - pillar: + vm_name: {{ vm_name }} + hypervisor: {{ hypervisor }} + status_data: + timestamp: {{ timestamp }} + status: {{ status }} + event_tag: {{ tag }} + # Update hypervisor status update_hypervisor_annotation: salt.state: @@ -102,10 +110,8 @@ update_hypervisor_annotation: - sls: - soc.dyanno.hypervisor - concurrent: True -{#% if event_tag.startswith('soc/dyanno/hypervisor') %} - require: - salt: write_vm_status -{% endif %#} {% do salt.log.info('dyanno_hypervisor_orch: Completed') %} diff --git a/salt/reactor/vm_status.sls b/salt/reactor/vm_status.sls index 5e32ac18f..75b4596cb 100644 --- a/salt/reactor/vm_status.sls +++ b/salt/reactor/vm_status.sls @@ -4,119 +4,33 @@ # Elastic License 2.0. {% do salt.log.debug('vm_status_reactor: Running') %} -{% do salt.log.debug('vm_status_reactor: tag: ' ~ tag | string) %} +{% do salt.log.debug('vm_status_reactor: tag: ' ~ tag) %} {# Remove all the nasty characters that exist in this data #} {% if tag.startswith('salt/cloud/') and tag.endswith('/deploying') %} -{% set data = { + +{% set event_data = { "_stamp": data._stamp, "event": data.event, "kwargs": { "cloud_grains": data.kwargs.cloud_grains } } %} + +{% else %} + +{% set event_data = data %} + {% endif %} -{% do salt.log.debug('vm_status_reactor: Received data: ' ~ data|json|string) %} - -{# -update_hypervisor: - runner.state.orchestrate: - - args: - - mods: orch.dyanno_hypervisor - - pillar: - event_tag: {{ tag }} - event_data: {{ data }} -#} - -{# Our custom tag #} -{% if tag.startswith('soc/dyanno/hypervisor') %} -{% set status_data = data.get('data')%} -{% do salt.log.debug('vm_status_reactor: Received data: ' ~ status_data|json|string) %} -{% do salt.log.debug('vm_status_reactor: Setting vm_name, hypervisor and status') %} -{% set vm_name = status_data.get('vm_name') %} -{% set hypervisor = status_data.get('hypervisor') %} -{% set status = status_data.get('status') %} -{% set details = status_data.get('details', '') %} -{% endif %} - -{# setup/so-minion tag #} -{% if tag == ('setup/so-minion') %} -{% set status_data = data.get('data')%} -{% do salt.log.debug('vm_status_reactor: Received data: ' ~ status_data|json|string) %} -{% do salt.log.debug('vm_status_reactor: Setting vm_name, hypervisor and status') %} -{% set vm_name = data.get('id') %} - -{% set grains = salt.saltutil.runner('cache.grains', tgt=vm_name).get(vm_name) %} -{% if grains %} -{% do salt.log.debug('vm_status_reactor: Got cache.grains ' ~ grains|string) %} -{% if grains.get('salt-cloud').get('profile') %} -{% do salt.log.debug('vm_status_reactor: Found salt-cloud:profile grain: ' ~ grains.get('salt-cloud').get('profile')|string) %} -{% set hypervisor = grains.get('salt-cloud').get('profile').split('-')[1] %} -{% do salt.log.debug('vm_status_reactor: Got hypervisor: ' ~ hypervisor) %} -{% endif %} -{% else %} -{% do salt.log.debug('vm_status_reactor: Did not get cache.grains.') %} -{% endif %} - -{% set hypervisor = hypervisor %} -{% set status = 'Initialize Minion Pillars' %} -{% set details = status_data.get('details', '') %} -{% endif %} - -{# salt-cloud tag #} -{% if tag.startswith('salt/cloud/') and (tag.endswith('/creating') or tag.endswith('/deploying') or tag.endswith('/created') or tag.endswith('/destroyed')) %} -{% do salt.log.debug('vm_status_reactor: Received data: ' ~ data|json|string) %} -{% do salt.log.debug('vm_status_reactor: Setting vm_name, hypervisor and status') %} -{% set vm_name = tag.split('/')[2] %} -{% do salt.log.debug('vm_status_reactor: Got vm_name from tag: ' ~ vm_name) %} - -{% if tag.endswith('/deploying') %} -{% set hypervisor = data.get('kwargs').get('cloud_grains').get('profile').split('-')[1] %} -{% endif %} - -{% if data.get('profile', False) %} -{% do salt.log.debug('vm_status_reactor: Did not get cache.grains.') %} -{% set hypervisor = data.profile.split('-')[1] %} -{% do salt.log.debug('vm_status_reactor: Got hypervisor from data: ' ~ hypervisor) %} -{% else %} -{% set grains = salt.saltutil.runner('cache.grains', tgt=vm_name).get(vm_name) %} -{% if grains %} -{% do salt.log.debug('vm_status_reactor: Got cache.grains: ' ~ grains|string) %} -{% if grains.get('salt-cloud').get('profile') %} -{% do salt.log.debug('vm_status_reactor: Found salt-cloud:profile grain: ' ~ grains.get('salt-cloud').get('profile')|string) %} -{% set hypervisor = grains.get('salt-cloud').get('profile').split('-')[1] %} -{% do salt.log.debug('vm_status_reactor: Got hypervisor: ' ~ hypervisor) %} -{% endif %} -{% endif %} -{% endif %} - -{% set status = data.get('event').title() %} -{% set details = data.get('details', '') %} -{% endif %} - -{% do salt.log.info('vm_status_reactor: vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} - -{% set timestamp = data.get('_stamp') %} -write_vm_status: - runner.state.orchestrate: - - args: - - mods: soc.dyanno.hypervisor.write_status - - pillar: - vm_name: {{ vm_name }} - hypervisor: {{ hypervisor }} - status_data: - timestamp: {{ timestamp }} - status: {{ status }} - details: {{ details }} - event_tag: {{ tag }} +{% do salt.log.debug('vm_status_reactor: Received data: ' ~ event_data|json|string) %} update_hypervisor: runner.state.orchestrate: - args: - mods: orch.dyanno_hypervisor - pillar: - event_tag: {{ tag }} - event_data: {{ data }} + tag: {{ tag }} + data: {{ event_data }} {% do salt.log.debug('vm_status_reactor: Completed') %} From 6ac14f832e194faf32d2f3a72ee94a14f0b6d691 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 24 Feb 2025 12:22:52 -0500 Subject: [PATCH 137/303] only allow first process step to overwrite last --- salt/soc/dyanno/hypervisor/write_status.sls | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/soc/dyanno/hypervisor/write_status.sls b/salt/soc/dyanno/hypervisor/write_status.sls index 4babf7687..7859069a1 100644 --- a/salt/soc/dyanno/hypervisor/write_status.sls +++ b/salt/soc/dyanno/hypervisor/write_status.sls @@ -64,7 +64,7 @@ ensure_status_dir: {# Some of the status updates trigger within a second of each other can can cause, for example, IP Configuration orchestration to process before the Processing #} {# This check has been put in place to ensure a status sooner in the process can't overwrite this file if a status later in the process wrote to it first. #} {# The final step is Destroyed, so we allow Processing to overwrite that incase someone creates a new VM with same name that was previously destroyed. #} -{% if new_index > current_index or current_index == process_steps | length - 1 %} +{% if new_index > current_index or (current_index == process_steps | length - 1 and new_index == 0) %} write_status_file: file.serialize: - name: {{ status_file }} From 0006948c293b0cb82c00e7577d86b9866d433d2b Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 24 Feb 2025 12:26:28 -0500 Subject: [PATCH 138/303] get hypervisor from dir name --- salt/orch/dyanno_hypervisor.sls | 44 ++++++++++++++------------------- 1 file changed, 19 insertions(+), 25 deletions(-) diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index 959a4a9c4..b580339ad 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -12,6 +12,7 @@ {% if 'hvn' in salt['pillar.get']('features', []) %} {% do salt.log.info('dyanno_hypervisor_orch: Running') %} + {% set data = pillar.get('data', {}) %} {% set tag = pillar.get('tag', '') %} {% set timestamp = data.get('_stamp') %} @@ -58,19 +59,23 @@ {% if tag.endswith('/deploying') %} {% set hypervisor = data.get('kwargs').get('cloud_grains').get('profile').split('-')[1] %} {% endif %} +{# Set the hypervisor #} +{# First try to get it from the event #} {% if data.get('profile', False) %} {% do salt.log.debug('dyanno_hypervisor_orch: Did not get cache.grains.') %} {% set hypervisor = data.profile.split('-')[1] %} {% do salt.log.debug('dyanno_hypervisor_orch: Got hypervisor from data: ' ~ hypervisor) %} {% else %} -{% set grains = salt.saltutil.runner('cache.grains', tgt=vm_name).get(vm_name) %} -{% if grains %} -{% do salt.log.debug('dyanno_hypervisor_orch: Got cache.grains: ' ~ grains|string) %} -{% if grains.get('salt-cloud').get('profile') %} -{% do salt.log.debug('dyanno_hypervisor_orch: Found salt-cloud:profile grain: ' ~ grains.get('salt-cloud').get('profile')|string) %} -{% set hypervisor = grains.get('salt-cloud').get('profile').split('-')[1] %} -{% do salt.log.debug('dyanno_hypervisor_orch: Got hypervisor: ' ~ hypervisor) %} -{% endif %} +{# If not in the event, find it by the .status file location #} +{% set path = salt['file.find']('/opt/so/saltstack/local/salt/hypervisor/hosts/',type='f', name=vm_name ~ '.status') %} +{% if path | length == 1 %} +{% set parts = path[0].split('/') %} +{% set hypervisor = parts[-2] %} +{% do salt.log.debug('dyanno_hypervisor_orch: Found hypervisor from file.find: ' ~ hypervisor) %} +{% elif path | length == 0 %} +{% do salt.log.error('dyanno_hypervisor_orch: ' ~ vm_name ~ ' not found in any hypervisor directories') %} +{% else %} +{% do salt.log.error('dyanno_hypervisor_orch: Found ' ~ vm_name ~ ' in multiple hypervisor directories: ' ~ path | string) %} {% endif %} {% endif %} {% set status = data.get('event').title() %} @@ -78,22 +83,13 @@ {% do salt.log.info('dyanno_hypervisor_orch: vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} - -{# We will need to populate hypervisor:hosts in this orch and pass to state to run as runner -update_hypervisor_status: - salt.runner: - - name: state.orchestrate - - mods: soc.dyanno.hypervisor -{% if event_tag.startswith('soc/dyanno/hypervisor') %} - - require: - - salt: write_vm_status -{% endif %} -#} - write_vm_status: - salt.runner: - - name: state.orchestrate - - mods: soc.dyanno.hypervisor.write_status + salt.state: + - tgt: 'G@role:so-manager or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' + - tgt_type: compound + - sls: + - soc.dyanno.hypervisor.write_status + - concurrent: True - pillar: vm_name: {{ vm_name }} hypervisor: {{ hypervisor }} @@ -110,8 +106,6 @@ update_hypervisor_annotation: - sls: - soc.dyanno.hypervisor - concurrent: True - - require: - - salt: write_vm_status {% do salt.log.info('dyanno_hypervisor_orch: Completed') %} From c8967854806ce10f4dd38c63f6102490485c0cdc Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 24 Feb 2025 14:20:09 -0500 Subject: [PATCH 139/303] fix vm deletion --- salt/orch/dyanno_hypervisor.sls | 43 +++++++++---------- .../engines/master/virtual_node_manager.py | 10 +++-- salt/soc/dyanno/hypervisor/write_status.sls | 12 +++++- 3 files changed, 38 insertions(+), 27 deletions(-) diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index b580339ad..c298a6101 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -11,6 +11,23 @@ {% if 'hvn' in salt['pillar.get']('features', []) %} +{# Macro to find hypervisor name from VM status file #} +{% macro find_hypervisor_from_status(vm_name) -%} + {%- set path = salt['file.find']('/opt/so/saltstack/local/salt/hypervisor/hosts/',type='f', name=vm_name ~ '.status') -%} + {%- if path | length == 1 -%} + {%- set parts = path[0].split('/') -%} + {%- set hypervisor = parts[-2] -%} + {%- do salt.log.debug('dyanno_hypervisor_orch: Found hypervisor from file.find: ' ~ hypervisor) -%} + {{- hypervisor -}} + {%- elif path | length == 0 -%} + {%- do salt.log.error('dyanno_hypervisor_orch: ' ~ vm_name ~ ' not found in any hypervisor directories') -%} + {{- '' -}} + {%- else -%} + {%- do salt.log.error('dyanno_hypervisor_orch: Found ' ~ vm_name ~ ' in multiple hypervisor directories: ' ~ path | string) -%} + {{- '' -}} + {%- endif -%} +{%- endmacro %} + {% do salt.log.info('dyanno_hypervisor_orch: Running') %} {% set data = pillar.get('data', {}) %} @@ -35,21 +52,11 @@ {% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ status_data|json|string) %} {% do salt.log.debug('dyanno_hypervisor_orch: Setting vm_name, hypervisor and status') %} {% set vm_name = data.get('id') %} -{% set grains = salt.saltutil.runner('cache.grains', tgt=vm_name).get(vm_name) %} -{% if grains %} -{% do salt.log.debug('dyanno_hypervisor_orch: Got cache.grains ' ~ grains|string) %} -{% if grains.get('salt-cloud').get('profile') %} -{% do salt.log.debug('dyanno_hypervisor_orch: Found salt-cloud:profile grain: ' ~ grains.get('salt-cloud').get('profile')|string) %} -{% set hypervisor = grains.get('salt-cloud').get('profile').split('-')[1] %} -{% do salt.log.debug('dyanno_hypervisor_orch: Got hypervisor: ' ~ hypervisor) %} -{% endif %} -{% else %} -{% do salt.log.debug('dyanno_hypervisor_orch: Did not get cache.grains.') %} -{% endif %} -{% set hypervisor = hypervisor %} +{% set hypervisor = find_hypervisor_from_status(vm_name) %} {% set status = 'Initialize Minion Pillars' %} {% endif %} + {# salt-cloud tag #} {% if tag.startswith('salt/cloud/') and (tag.endswith('/creating') or tag.endswith('/deploying') or tag.endswith('/created') or tag.endswith('/destroyed')) %} {% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ data|json|string) %} @@ -66,17 +73,7 @@ {% set hypervisor = data.profile.split('-')[1] %} {% do salt.log.debug('dyanno_hypervisor_orch: Got hypervisor from data: ' ~ hypervisor) %} {% else %} -{# If not in the event, find it by the .status file location #} -{% set path = salt['file.find']('/opt/so/saltstack/local/salt/hypervisor/hosts/',type='f', name=vm_name ~ '.status') %} -{% if path | length == 1 %} -{% set parts = path[0].split('/') %} -{% set hypervisor = parts[-2] %} -{% do salt.log.debug('dyanno_hypervisor_orch: Found hypervisor from file.find: ' ~ hypervisor) %} -{% elif path | length == 0 %} -{% do salt.log.error('dyanno_hypervisor_orch: ' ~ vm_name ~ ' not found in any hypervisor directories') %} -{% else %} -{% do salt.log.error('dyanno_hypervisor_orch: Found ' ~ vm_name ~ ' in multiple hypervisor directories: ' ~ path | string) %} -{% endif %} +{% set hypervisor = find_hypervisor_from_status(vm_name) %} {% endif %} {% set status = data.get('event').title() %} {% endif %} diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index 98a4eb572..6425a0063 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -736,9 +736,8 @@ def process_hypervisor(hypervisor_path: str) -> None: nodes_config = read_json_file(vms_file) if not nodes_config: log.debug("Empty VMs configuration in %s", vms_file) - return - # Get existing VMs - no lock needed + # Get existing VMs existing_vms = set() for file_path in glob.glob(os.path.join(hypervisor_path, '*_*')): basename = os.path.basename(file_path) @@ -761,7 +760,12 @@ def process_hypervisor(hypervisor_path: str) -> None: process_vm_creation(hypervisor_path, vm_config) # Process VM deletions - for vm_name in existing_vms - configured_vms: + vms_to_delete = existing_vms - configured_vms + log.debug(f"Existing VMs: {existing_vms}") + log.debug(f"Configured VMs: {configured_vms}") + log.debug(f"VMs to delete: {vms_to_delete}") + for vm_name in vms_to_delete: + log.info(f"Initiating deletion process for VM: {vm_name}") process_vm_deletion(hypervisor_path, vm_name) except Exception as e: diff --git a/salt/soc/dyanno/hypervisor/write_status.sls b/salt/soc/dyanno/hypervisor/write_status.sls index 7859069a1..be03b26b7 100644 --- a/salt/soc/dyanno/hypervisor/write_status.sls +++ b/salt/soc/dyanno/hypervisor/write_status.sls @@ -22,7 +22,17 @@ {% set status_file = status_dir ~ '/' ~ vm_name ~ '.status' %} # Define the list of process steps in order (case-sensitive) -{% set process_steps = ['Processing', 'IP Configuration', 'Starting Create', 'Executing Deploy Script', 'Initialize Minion Pillars', 'Created Instance', 'Hardware Configuration', 'Highstate Triggered', 'Destroyed Instance'] %} +{% set process_steps = [ + 'Processing', + 'IP Configuration', + 'Starting Create', + 'Executing Deploy Script', + 'Initialize Minion Pillars', + 'Created Instance', + 'Hardware Configuration', + 'Highstate Triggered', + 'Destroyed Instance' +] %} {% set new_index = process_steps.index(status_data.get('status')) %} {% do salt.log.debug('soc/dyanno/hypervisor/write_status: new_index: ' ~ new_index|string) %} From b5276a6a1d4ce57b652c8b45e4a4655b684a5f90 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 25 Feb 2025 04:41:59 -0500 Subject: [PATCH 140/303] add hypervisor to firewall annotation --- salt/firewall/soc_firewall.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/salt/firewall/soc_firewall.yaml b/salt/firewall/soc_firewall.yaml index 222bcc8a2..879b42f21 100644 --- a/salt/firewall/soc_firewall.yaml +++ b/salt/firewall/soc_firewall.yaml @@ -35,6 +35,7 @@ firewall: external_suricata: *hostgroupsettings fleet: *hostgroupsettings heavynode: *hostgroupsettings + hypervisor: *hostgroupsettings idh: *hostgroupsettings import: *hostgroupsettings localhost: *ROhostgroupsettingsadv From e0a3b51ca27643e83794eec16ce6907573bc8e21 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 25 Feb 2025 08:54:04 -0500 Subject: [PATCH 141/303] md in description --- salt/hypervisor/hosts/README | 1 + .../hypervisor/soc_hypervisor.yaml.jinja | 37 +++++++++++-------- 2 files changed, 23 insertions(+), 15 deletions(-) create mode 100644 salt/hypervisor/hosts/README diff --git a/salt/hypervisor/hosts/README b/salt/hypervisor/hosts/README new file mode 100644 index 000000000..406fd0bec --- /dev/null +++ b/salt/hypervisor/hosts/README @@ -0,0 +1 @@ +This directory will contain hypervisor hosts. We need this README in place to ensure /opt/so/saltstack/local/salt/hypervisor/hosts directory gets created during setup. diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 453aa436c..cb8be8b18 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -16,25 +16,27 @@ {%- set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') -%} -{%- macro update_description(description, cpu_free, mem_free, disk_free, copper_free, sfp_free, vm_list) -%} -{{- description }} +{%- macro update_description(description, cpu_free, mem_free, disk_free, copper_free, sfp_free, vm_list, cpu_total, mem_total, disk_total, copper_total, sfp_total) -%} +# Hypervisor Configuration: {{ description }} -Resource Summary: -- CPU: {{ cpu_free }} cores available -- Memory: {{ mem_free }}GB available -- Disk Slots: {{ disk_free if disk_free else 'None' }} available -- Copper Ports: {{ copper_free if copper_free else 'None' }} available -- SFP Ports: {{ sfp_free if sfp_free else 'None' }} available +## Resource Summary +| Resource | Available | Total | +|-------------|-----------|-----------| +| CPU Cores | {{ cpu_free }} | {{ cpu_total }} | +| Memory (GB) | {{ mem_free }} | {{ mem_total }} | +| Disk | {{ disk_free if disk_free else 'None' }} | {{ disk_total }} | +| Copper | {{ copper_free if copper_free else 'None' }} | {{ copper_total }} | +| SFP | {{ sfp_free if sfp_free else 'None' }} | {{ sfp_total }} | {%- if vm_list %} -Virtual Machines: +## Virtual Machines +| Name | Status | CPU | RAM(GB)| Disk | Copper | SFP | Last Updated | +|--------------------|--------------------|-----|--------|------|--------|------|---------------------| {%- for hostname, vm_data in vm_list.items() %} -- {{ hostname }}: - Status: {{ vm_data.get('status', {}).get('status', 'Unknown') }} - Details: {{ vm_data.get('status', {}).get('details', 'No details available') }} - Last Updated: {{ vm_data.get('status', {}).get('timestamp', 'Never') }} +| {{ hostname }}_{{ vm_data.get('config', {}).get('role', 'unknown') }} | {{ vm_data.get('status', {}).get('status', 'Unknown') }} | {{ vm_data.get('config', {}).get('cpu', 'N/A') }} | {{ vm_data.get('config', {}).get('memory', 'N/A') }} | {{ vm_data.get('config', {}).get('disk', '-') if vm_data.get('config', {}).get('disk') else '-' }} | {{ vm_data.get('config', {}).get('copper', '-') if vm_data.get('config', {}).get('copper') else '-' }} | {{ vm_data.get('config', {}).get('sfp', '-') if vm_data.get('config', {}).get('sfp') else '-' }} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | {%- endfor %} {%- else %} +## Virtual Machines No Virtual Machines Found {%- endif %} {%- endmacro -%} @@ -118,13 +120,18 @@ No Virtual Machines Found {%- do updated_template.update({ 'title': hypervisor, 'description': update_description( - TEMPLATE.description, + hypervisor, cpu_free, mem_free, disk_free, copper_free, sfp_free, - vms + vms, + cpu_total, + mem_total, + disk_total, + copper_total, + sfp_total ) }) -%} {%- do ANNOTATION.hypervisor.hosts.update({hypervisor ~ 'VMs': updated_template}) -%} From 5811b184be051fe706195514ed5f145baaa9dc5e Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 25 Feb 2025 11:13:35 -0500 Subject: [PATCH 142/303] enhance annotations. account for line separation instead of comma for hardware --- .../engines/master/virtual_node_manager.py | 8 +-- salt/soc/dyanno/hypervisor/hypervisor.yaml | 59 +++++++++++++++++-- .../hypervisor/soc_hypervisor.yaml.jinja | 30 +++++----- 3 files changed, 73 insertions(+), 24 deletions(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index 6425a0063..bc203fb59 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -316,7 +316,7 @@ def validate_hardware_request(model_config: dict, requested_hw: dict) -> Tuple[b for hw_type in ['disk', 'copper', 'sfp']: if hw_type in requested_hw and requested_hw[hw_type]: try: - indices = [int(x) for x in str(requested_hw[hw_type]).split(',')] + indices = [int(x) for x in str(requested_hw[hw_type]).split('\n')] log.debug("Checking if %s indices %s exist in model", hw_type, indices) if hw_type not in model_config['hardware']: @@ -405,7 +405,7 @@ def check_hardware_availability(hypervisor_path: str, vm_name: str, requested_hw # Track unique resources for hw_type in ['disk', 'copper', 'sfp']: if hw_type in config and config[hw_type]: - indices = [int(x) for x in str(config[hw_type]).split(',')] + indices = [int(x) for x in str(config[hw_type]).split('\n')] for idx in indices: used_resources[hw_type][idx] = basename.replace('_sensor', '') # Store VM name without role log.debug("VM %s is using %s indices: %s", basename, hw_type, indices) @@ -432,7 +432,7 @@ def check_hardware_availability(hypervisor_path: str, vm_name: str, requested_hw # Check for hardware conflicts for hw_type in ['disk', 'copper', 'sfp']: if hw_type in requested_hw and requested_hw[hw_type]: - requested_indices = [int(x) for x in str(requested_hw[hw_type]).split(',')] + requested_indices = [int(x) for x in str(requested_hw[hw_type]).split('\n')] log.debug("Checking for %s conflicts - Requesting indices: %s, Currently in use: %s", hw_type, requested_indices, used_resources[hw_type]) conflicts = {} # {index: vm_name} @@ -636,7 +636,7 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: # Add PCI devices for hw_type in ['disk', 'copper', 'sfp']: if hw_type in vm_config and vm_config[hw_type]: - indices = [int(x) for x in str(vm_config[hw_type]).split(',')] + indices = [int(x) for x in str(vm_config[hw_type]).split('\n')] for idx in indices: hw_config = {int(k): v for k, v in model_config['hardware'][hw_type].items()} pci_id = hw_config[idx] diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index e2a0028a8..c282d4e7b 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -6,28 +6,77 @@ hypervisor: syntax: json uiElements: - field: hostname - label: "Enter the hostname" + label: "Hostname" + forcedType: string + required: true + readonly: true - field: role - label: "sensor or searchnode" + label: "Role" + required: true + readonly: true + options: + - searchnode + - sensor + - receiver + - idh + - heavynode + - fleet - field: network_mode label: "Choose static4 or dhcp4. If static4, populate IP details below." + required: true + readonly: true + options: + - static4 + - dhcp4 - field: ip4 label: "IP Address with netmask. ex. 192.168.1.10/24" + forcedType: string + regex: '^(\d{1,3}\.){3}\d{1,3}/\d{1,2}$' + regexFailureMessage: "Enter a properly formatted CIDR address" + readonly: true - field: gw4 label: "Gateway" + forcedType: string + regex: '^(\d{1,3}\.){3}\d{1,3}$' + regexFailureMessage: "Enter a properly formatted IP address" + readonly: true - field: dns4 label: "DNS. Comma separated list. ex. 192.168.1.1,8.8.8.8" + forcedType: string + regex: '^(\d{1,3}\.){3}\d{1,3}$' + regexFailureMessage: "Enter a properly formatted IP address" + readonly: true - field: search4 label: "Search domain" + forcedType: string + readonly: true - field: cpu label: "CPU cores to assign. Free: FREE | Total: TOTAL" + forcedType: int + required: true + readonly: true - field: memory label: "Memory to assign, in GB. Free: FREE | Total: TOTAL" + required: true + readonly: true + forcedType: int - field: disk - label: "Disk(s) for passthrough. Comma separated list. Free: FREE | Total: TOTAL" + label: "Disk(s) for passthrough. Line-delimited list. Free: FREE | Total: TOTAL" + required: true + readonly: true + forcedType: '[]int' + multiline: true - field: copper - label: "Copper port(s) for passthrough. Comma separated list. Free: FREE | Total: TOTAL" + label: "Copper port(s) for passthrough. Line-delimited list. Free: FREE | Total: TOTAL" + required: true + readonly: true + forcedType: '[]int' + multiline: true - field: sfp - label: "SFP port(s) for passthrough. Comma separated list. Free: FREE | Total: TOTAL" + label: "SFP port(s) for passthrough. Line-delimited list. Free: FREE | Total: TOTAL" + required: true + readonly: true + forcedType: '[]int' + multiline: true file: true global: true diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index cb8be8b18..0f409eada 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -24,16 +24,16 @@ |-------------|-----------|-----------| | CPU Cores | {{ cpu_free }} | {{ cpu_total }} | | Memory (GB) | {{ mem_free }} | {{ mem_total }} | -| Disk | {{ disk_free if disk_free else 'None' }} | {{ disk_total }} | -| Copper | {{ copper_free if copper_free else 'None' }} | {{ copper_total }} | -| SFP | {{ sfp_free if sfp_free else 'None' }} | {{ sfp_total }} | +| Disk | {{ disk_free | replace('\n', ',') if disk_free else 'None' }} | {{ disk_total | replace('\n', ',') }} | +| Copper | {{ copper_free | replace('\n', ',') if copper_free else 'None' }} | {{ copper_total | replace('\n', ',') }} | +| SFP | {{ sfp_free | replace('\n', ',') if sfp_free else 'None' }} | {{ sfp_total | replace('\n', ',') }} | {%- if vm_list %} ## Virtual Machines -| Name | Status | CPU | RAM(GB)| Disk | Copper | SFP | Last Updated | -|--------------------|--------------------|-----|--------|------|--------|------|---------------------| +| Name | Status | CPU Cores | Memory (GB)| Disk | Copper | SFP | Last Updated | +|--------------------|--------------------|-----------|------------|------|--------|------|---------------------| {%- for hostname, vm_data in vm_list.items() %} -| {{ hostname }}_{{ vm_data.get('config', {}).get('role', 'unknown') }} | {{ vm_data.get('status', {}).get('status', 'Unknown') }} | {{ vm_data.get('config', {}).get('cpu', 'N/A') }} | {{ vm_data.get('config', {}).get('memory', 'N/A') }} | {{ vm_data.get('config', {}).get('disk', '-') if vm_data.get('config', {}).get('disk') else '-' }} | {{ vm_data.get('config', {}).get('copper', '-') if vm_data.get('config', {}).get('copper') else '-' }} | {{ vm_data.get('config', {}).get('sfp', '-') if vm_data.get('config', {}).get('sfp') else '-' }} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | +| {{ hostname }}_{{ vm_data.get('config', {}).get('role', 'unknown') }} | {{ vm_data.get('status', {}).get('status', 'Unknown') }} | {{ vm_data.get('config', {}).get('cpu', 'N/A') }} | {{ vm_data.get('config', {}).get('memory', 'N/A') }} | {{ vm_data.get('config', {}).get('disk', '-') | replace('\n', ',') if vm_data.get('config', {}).get('disk') else '-' }} | {{ vm_data.get('config', {}).get('copper', '-') | replace('\n', ',') if vm_data.get('config', {}).get('copper') else '-' }} | {{ vm_data.get('config', {}).get('sfp', '-') | replace('\n', ',') if vm_data.get('config', {}).get('sfp') else '-' }} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | {%- endfor %} {%- else %} ## Virtual Machines @@ -81,9 +81,9 @@ No Virtual Machines Found {%- set used_sfp = [] -%} {%- for hostname, vm in vms.items() -%} {%- set config = vm.get('config', {}) -%} -{%- do used_disk.extend((config.get('disk', '') | string).split(',') | map('trim') | list) -%} -{%- do used_copper.extend((config.get('copper', '') | string).split(',') | map('trim') | list) -%} -{%- do used_sfp.extend((config.get('sfp', '') | string).split(',') | map('trim') | list) -%} +{%- do used_disk.extend((config.get('disk', '') | string).split('\n') | map('trim') | list) -%} +{%- do used_copper.extend((config.get('copper', '') | string).split('\n') | map('trim') | list) -%} +{%- do used_sfp.extend((config.get('sfp', '') | string).split('\n') | map('trim') | list) -%} {%- endfor -%} {# Get available PCI indices #} @@ -94,9 +94,9 @@ No Virtual Machines Found {# Get total resources #} {%- set cpu_total = hw_config.cpu -%} {%- set mem_total = hw_config.memory -%} -{%- set disk_total = hw_config.disk.keys() | join(',') -%} -{%- set copper_total = hw_config.copper.keys() | join(',') -%} -{%- set sfp_total = hw_config.sfp.keys() | join(',') -%} +{%- set disk_total = hw_config.disk.keys() | join('\n') -%} +{%- set copper_total = hw_config.copper.keys() | join('\n') -%} +{%- set sfp_total = hw_config.sfp.keys() | join('\n') -%} {# Update field labels with total and free values #} {%- set updated_template = TEMPLATE.copy() -%} @@ -108,11 +108,11 @@ No Virtual Machines Found {%- elif field.field == 'memory' -%} {%- do updated_field.update({'label': field.label | replace('FREE', mem_free | string) | replace('TOTAL', mem_total | string)}) -%} {%- elif field.field == 'disk' -%} -{%- do updated_field.update({'label': field.label | replace('FREE', disk_free) | replace('TOTAL', disk_total)}) -%} +{%- do updated_field.update({'label': field.label | replace('FREE', disk_free) | replace('TOTAL', disk_total | replace('\n', ','))}) -%} {%- elif field.field == 'copper' -%} -{%- do updated_field.update({'label': field.label | replace('FREE', copper_free) | replace('TOTAL', copper_total)}) -%} +{%- do updated_field.update({'label': field.label | replace('FREE', copper_free) | replace('TOTAL', copper_total | replace('\n', ','))}) -%} {%- elif field.field == 'sfp' -%} -{%- do updated_field.update({'label': field.label | replace('FREE', sfp_free) | replace('TOTAL', sfp_total)}) -%} +{%- do updated_field.update({'label': field.label | replace('FREE', sfp_free) | replace('TOTAL', sfp_total | replace('\n', ','))}) -%} {%- endif -%} {%- do updated_elements.append(updated_field) -%} {%- endfor -%} From d6f527881a59832cc1ce151e31da721938fddc0f Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 26 Feb 2025 09:06:45 -0500 Subject: [PATCH 143/303] allow for destroyed vms to be displayed in ui. VNM cleanup destroyed status files after 48h --- salt/hypervisor/map.jinja | 54 +++++++++++++++ .../engines/master/virtual_node_manager.py | 62 +++++++++++++++-- salt/soc/dyanno/hypervisor/hypervisor.yaml | 7 +- salt/soc/dyanno/hypervisor/map.jinja | 13 ++++ .../hypervisor/soc_hypervisor.yaml.jinja | 67 ++++++++++++++----- salt/soc/dyanno/hypervisor/write_status.sls | 25 +++---- 6 files changed, 186 insertions(+), 42 deletions(-) diff --git a/salt/hypervisor/map.jinja b/salt/hypervisor/map.jinja index a9a76e557..e52d7ae1a 100644 --- a/salt/hypervisor/map.jinja +++ b/salt/hypervisor/map.jinja @@ -85,6 +85,60 @@ {% endif %} {% endfor %} + {# Find and add destroyed VMs from status files #} + {% set processed_vms = [] %} + {% for vm_name, vm_data in vms.items() %} + {% do processed_vms.append(vm_name) %} + {% endfor %} + + {# Find all status files for this hypervisor #} + {% set relative_path = 'hypervisor/hosts/' ~ hypervisor %} + {% set absolute_path = '/opt/so/saltstack/local/salt/' ~ relative_path %} + {% do salt.log.info('salt/hypervisor/map.jinja: Scanning for status files in: ' ~ absolute_path) %} + + {# Try to find status files using file.find with absolute path #} + {% set status_files = salt['file.find'](absolute_path, name='*_*.status', type='f') %} + {% do salt.log.info('salt/hypervisor/map.jinja: Found status files: ' ~ status_files | tojson) %} + + {# Convert absolute paths back to relative paths for processing #} + {% set relative_status_files = [] %} + {% for status_file in status_files %} + {% set relative_file = status_file | replace('/opt/so/saltstack/local/salt/', '') %} + {% do relative_status_files.append(relative_file) %} + {% endfor %} + {% set status_files = relative_status_files %} + + {% do salt.log.info('salt/hypervisor/map.jinja: Converted to relative paths: ' ~ status_files | tojson) %} + + {% for status_file in status_files %} + {# Extract the VM name from the filename #} + {% set basename = status_file.split('/')[-1] %} + {% set vm_name = basename.replace('.status', '') %} + {% set hostname = vm_name.split('_')[0] %} + + {# Skip already processed VMs #} + {% if hostname in processed_vms %} + {% continue %} + {% endif %} + + {# Read the status file #} + {% do salt.log.info('salt/hypervisor/map.jinja: Processing potential destroyed VM status file: ' ~ status_file) %} + {% import_json status_file as status_data %} + + {# Only process files with "Destroyed Instance" status #} + {% if status_data and status_data.status == 'Destroyed Instance' %} + {% do salt.log.info('salt/hypervisor/map.jinja: Found VM with Destroyed Instance status: ' ~ hostname) %} + + {# Add to vms with minimal config #} + {% do vms.update({ + hostname: { + 'status': status_data, + 'config': {} + } + }) %} + {% endif %} + {% endfor %} + {# Merge node config with model capabilities and VM states #} {% do HYPERVISORS[role].update({ hypervisor: { diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index bc203fb59..c64cd7276 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -73,7 +73,7 @@ Notes: Description: The engine operates in the following phases: - 1. Engine Lock Acquisition + 1. Lock Acquisition - Acquires single engine-wide lock - Prevents multiple instances from running - Lock remains until clean shutdown or error @@ -138,7 +138,7 @@ import grp import salt.config import salt.runner from typing import Dict, List, Optional, Tuple, Any -from datetime import datetime +from datetime import datetime, timedelta from threading import Lock # Get socore uid/gid @@ -160,6 +160,8 @@ DEFAULT_BASE_PATH = '/opt/so/saltstack/local/salt/hypervisor/hosts' VALID_ROLES = ['sensor', 'searchnode', 'idh', 'receiver', 'heavynode', 'fleet'] LICENSE_PATH = '/opt/so/saltstack/local/pillar/soc/license.sls' DEFAULTS_PATH = '/opt/so/saltstack/default/salt/hypervisor/defaults.yaml' +# Define the retention period for destroyed VMs (in hours) +DESTROYED_VM_RETENTION_HOURS = 48 # Single engine-wide lock for virtual node manager engine_lock = Lock() @@ -667,6 +669,50 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: mark_vm_failed(os.path.join(hypervisor_path, f"{vm_name}_failed"), 4, error_msg) raise +def cleanup_destroyed_vm_status_files(hypervisor_path: str) -> None: + """ + Clean up status files for destroyed VMs that are older than the retention period. + + Args: + hypervisor_path: Path to the hypervisor directory + """ + try: + log.debug(f"Using destroyed VM retention period of {DESTROYED_VM_RETENTION_HOURS} hours") + + # Calculate the retention cutoff time + cutoff_time = datetime.now() - timedelta(hours=DESTROYED_VM_RETENTION_HOURS) + + # Find all status files for destroyed VMs + status_files = glob.glob(os.path.join(hypervisor_path, '*_*.status')) + log.debug(f"Found {len(status_files)} status files to check for expired destroyed VMs") + + for status_file in status_files: + try: + # Read the status file + status_data = read_json_file(status_file) + + # Check if this is a destroyed VM + if status_data.get('status') == 'Destroyed Instance': + # Parse the timestamp + timestamp_str = status_data.get('timestamp', '') + if timestamp_str: + timestamp = datetime.fromisoformat(timestamp_str) + vm_name = os.path.basename(status_file).replace('.status', '') + age_hours = (datetime.now() - timestamp).total_seconds() / 3600 + + # If older than retention period, delete the file + if timestamp < cutoff_time: + log.info(f"Removing expired status file for VM {vm_name} (age: {age_hours:.1f} hours > retention: {DESTROYED_VM_RETENTION_HOURS} hours)") + os.remove(status_file) + else: + log.debug(f"Status file for VM {vm_name} (age: {age_hours:.1f} hours < retention: {DESTROYED_VM_RETENTION_HOURS} hours)") + except Exception as e: + log.error(f"Error processing status file {status_file}: {e}") + + except Exception as e: + log.error(f"Failed to clean up destroyed VM status files: {e}") + + def process_vm_deletion(hypervisor_path: str, vm_name: str) -> None: """ Process a single VM deletion request. @@ -731,6 +777,9 @@ def process_hypervisor(hypervisor_path: str) -> None: vms_file = os.path.join(os.path.dirname(hypervisor_path), f"{hypervisor}VMs") if not os.path.exists(vms_file): log.debug("No VMs file found at %s", vms_file) + + # Even if no VMs file exists, we should still clean up any expired status files + cleanup_destroyed_vm_status_files(hypervisor_path) return nodes_config = read_json_file(vms_file) @@ -768,6 +817,9 @@ def process_hypervisor(hypervisor_path: str) -> None: log.info(f"Initiating deletion process for VM: {vm_name}") process_vm_deletion(hypervisor_path, vm_name) + # Clean up expired status files for destroyed VMs + cleanup_destroyed_vm_status_files(hypervisor_path) + except Exception as e: log.error("Failed to process hypervisor %s: %s", hypervisor_path, str(e)) raise @@ -797,12 +849,12 @@ def start(interval: int = DEFAULT_INTERVAL, if not validate_hvn_license(): return - # Attempt to acquire engine lock + # Attempt to acquire lock if not engine_lock.acquire(blocking=False): log.error("Another virtual node manager is already running") return - log.debug("Virtual node manager acquired engine lock") + log.debug("Virtual node manager acquired lock") try: # Process each hypervisor directory @@ -811,7 +863,7 @@ def start(interval: int = DEFAULT_INTERVAL, process_hypervisor(hypervisor_path) # Clean shutdown - release lock - log.debug("Virtual node manager releasing engine lock") + log.debug("Virtual node manager releasing lock") engine_lock.release() log.info("Virtual node manager completed successfully") diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index c282d4e7b..0166dbc3c 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -4,6 +4,8 @@ hypervisor: title: defaultHost description: "Hypervisor Configuration" syntax: json + file: true + global: true uiElements: - field: hostname label: "Hostname" @@ -62,21 +64,16 @@ hypervisor: forcedType: int - field: disk label: "Disk(s) for passthrough. Line-delimited list. Free: FREE | Total: TOTAL" - required: true readonly: true forcedType: '[]int' multiline: true - field: copper label: "Copper port(s) for passthrough. Line-delimited list. Free: FREE | Total: TOTAL" - required: true readonly: true forcedType: '[]int' multiline: true - field: sfp label: "SFP port(s) for passthrough. Line-delimited list. Free: FREE | Total: TOTAL" - required: true readonly: true forcedType: '[]int' multiline: true - file: true - global: true diff --git a/salt/soc/dyanno/hypervisor/map.jinja b/salt/soc/dyanno/hypervisor/map.jinja index b14a437b5..88b3f4425 100644 --- a/salt/soc/dyanno/hypervisor/map.jinja +++ b/salt/soc/dyanno/hypervisor/map.jinja @@ -1 +1,14 @@ {% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {}) %} + +{# Define the list of process steps in order (case-sensitive) #} +{% set PROCESS_STEPS = [ + 'Processing', + 'IP Configuration', + 'Starting Create', + 'Executing Deploy Script', + 'Initialize Minion Pillars', + 'Created Instance', + 'Hardware Configuration', + 'Highstate Triggered', + 'Destroyed Instance' +] %} diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 0f409eada..a72717de9 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -13,6 +13,7 @@ {%- import_yaml 'soc/dyanno/hypervisor/hypervisor.yaml' as ANNOTATION -%} {%- from 'hypervisor/map.jinja' import HYPERVISORS -%} +{%- from 'soc/dyanno/hypervisor/map.jinja' import PROCESS_STEPS -%} {%- set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') -%} @@ -20,23 +21,53 @@ # Hypervisor Configuration: {{ description }} ## Resource Summary -| Resource | Available | Total | -|-------------|-----------|-----------| -| CPU Cores | {{ cpu_free }} | {{ cpu_total }} | -| Memory (GB) | {{ mem_free }} | {{ mem_total }} | -| Disk | {{ disk_free | replace('\n', ',') if disk_free else 'None' }} | {{ disk_total | replace('\n', ',') }} | -| Copper | {{ copper_free | replace('\n', ',') if copper_free else 'None' }} | {{ copper_total | replace('\n', ',') }} | -| SFP | {{ sfp_free | replace('\n', ',') if sfp_free else 'None' }} | {{ sfp_total | replace('\n', ',') }} | +| | CPU Cores | Memory (GB) | Disk | Copper | SFP | +|-----------|-----------|-------------|-------------|-------------|-------------| +| Available | {{ cpu_free }} | {{ mem_free }} | {{ disk_free | replace('\n', ',') if disk_free else 'None' }} | {{ copper_free | replace('\n', ',') if copper_free else 'None' }} | {{ sfp_free | replace('\n', ',') if sfp_free else 'None' }} | +| Total | {{ cpu_total }} | {{ mem_total }} | {{ disk_total | replace('\n', ',') }} | {{ copper_total | replace('\n', ',') }} | {{ sfp_total | replace('\n', ',') }} | {%- if vm_list %} ## Virtual Machines +VMs can have the following status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. The "Last Updated" timestamp shows when the VM status was last changed. After reaching "Highstate Triggered" status, additional highstate runs will not update the timestamp. Only changing to "Destroyed Instance" status will update the timestamp again. + | Name | Status | CPU Cores | Memory (GB)| Disk | Copper | SFP | Last Updated | |--------------------|--------------------|-----------|------------|------|--------|------|---------------------| {%- for hostname, vm_data in vm_list.items() %} -| {{ hostname }}_{{ vm_data.get('config', {}).get('role', 'unknown') }} | {{ vm_data.get('status', {}).get('status', 'Unknown') }} | {{ vm_data.get('config', {}).get('cpu', 'N/A') }} | {{ vm_data.get('config', {}).get('memory', 'N/A') }} | {{ vm_data.get('config', {}).get('disk', '-') | replace('\n', ',') if vm_data.get('config', {}).get('disk') else '-' }} | {{ vm_data.get('config', {}).get('copper', '-') | replace('\n', ',') if vm_data.get('config', {}).get('copper') else '-' }} | {{ vm_data.get('config', {}).get('sfp', '-') | replace('\n', ',') if vm_data.get('config', {}).get('sfp') else '-' }} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | +{%- set vm_status = vm_data.get('status', {}).get('status', 'Unknown') %} +{%- set is_destroyed = vm_status == 'Destroyed Instance' %} +{%- set vm_role = vm_data.get('config', {}).get('role', 'unknown') %} +{%- set name = hostname ~ (('_' ~ vm_role) if not is_destroyed and vm_role != 'unknown' else '') %} +| {{ name }} | {{ vm_status }} | +{%- if is_destroyed -%} +- +{%- else -%} +{{ vm_data.get('config', {}).get('cpu', 'N/A') }} +{%- endif %} | +{%- if is_destroyed -%} +- +{%- else -%} +{{ vm_data.get('config', {}).get('memory', 'N/A') }} +{%- endif %} | +{%- if is_destroyed -%} +- +{%- else -%} +{{ vm_data.get('config', {}).get('disk', '-') | replace('\n', ',') if vm_data.get('config', {}).get('disk') else '-' }} +{%- endif %} | +{%- if is_destroyed -%} +- +{%- else -%} +{{ vm_data.get('config', {}).get('copper', '-') | replace('\n', ',') if vm_data.get('config', {}).get('copper') else '-' }} +{%- endif %} | +{%- if is_destroyed -%} +- +{%- else -%} +{{ vm_data.get('config', {}).get('sfp', '-') | replace('\n', ',') if vm_data.get('config', {}).get('sfp') else '-' }} +{%- endif %} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | {%- endfor %} {%- else %} ## Virtual Machines +VMs can have the following status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. The "Last Updated" timestamp shows when the VM status was last changed. After reaching "Highstate Triggered" status, additional highstate runs will not update the timestamp. Only changing to "Destroyed Instance" status will update the timestamp again. + No Virtual Machines Found {%- endif %} {%- endmacro -%} @@ -66,9 +97,12 @@ No Virtual Machines Found {%- set used_memory = 0 -%} {%- set ns = namespace(used_cpu=0, used_memory=0) -%} {%- for hostname, vm_data in vms.items() -%} -{%- set vm_config = vm_data.config -%} -{%- set ns.used_cpu = ns.used_cpu + vm_config.cpu | int -%} -{%- set ns.used_memory = ns.used_memory + vm_config.memory | int -%} +{%- set vm_status = vm_data.get('status', {}).get('status', '') -%} +{%- if vm_status != 'Destroyed Instance' -%} +{%- set vm_config = vm_data.config -%} +{%- set ns.used_cpu = ns.used_cpu + vm_config.get('cpu', 0) | int -%} +{%- set ns.used_memory = ns.used_memory + vm_config.get('memory', 0) | int -%} +{%- endif -%} {%- endfor -%} {# Calculate available resources #} @@ -80,10 +114,13 @@ No Virtual Machines Found {%- set used_copper = [] -%} {%- set used_sfp = [] -%} {%- for hostname, vm in vms.items() -%} -{%- set config = vm.get('config', {}) -%} -{%- do used_disk.extend((config.get('disk', '') | string).split('\n') | map('trim') | list) -%} -{%- do used_copper.extend((config.get('copper', '') | string).split('\n') | map('trim') | list) -%} -{%- do used_sfp.extend((config.get('sfp', '') | string).split('\n') | map('trim') | list) -%} +{%- set vm_status = vm.get('status', {}).get('status', '') -%} +{%- if vm_status != 'Destroyed Instance' -%} +{%- set config = vm.get('config', {}) -%} +{%- do used_disk.extend((config.get('disk', '') | string).split('\n') | map('trim') | list) -%} +{%- do used_copper.extend((config.get('copper', '') | string).split('\n') | map('trim') | list) -%} +{%- do used_sfp.extend((config.get('sfp', '') | string).split('\n') | map('trim') | list) -%} +{%- endif -%} {%- endfor -%} {# Get available PCI indices #} diff --git a/salt/soc/dyanno/hypervisor/write_status.sls b/salt/soc/dyanno/hypervisor/write_status.sls index be03b26b7..d2aa590e6 100644 --- a/salt/soc/dyanno/hypervisor/write_status.sls +++ b/salt/soc/dyanno/hypervisor/write_status.sls @@ -11,6 +11,9 @@ {% if 'hvn' in salt['pillar.get']('features', []) %} +{# Import the process steps from map.jinja #} +{% from 'soc/dyanno/hypervisor/map.jinja' import PROCESS_STEPS %} + {% do salt.log.info('soc/dyanno/hypervisor/write_status: Running') %} {% set vm_name = pillar.get('vm_name') %} {% set hypervisor = pillar.get('hypervisor') %} @@ -21,19 +24,7 @@ {% set status_dir = base_path ~ '/' ~ hypervisor %} {% set status_file = status_dir ~ '/' ~ vm_name ~ '.status' %} -# Define the list of process steps in order (case-sensitive) -{% set process_steps = [ - 'Processing', - 'IP Configuration', - 'Starting Create', - 'Executing Deploy Script', - 'Initialize Minion Pillars', - 'Created Instance', - 'Hardware Configuration', - 'Highstate Triggered', - 'Destroyed Instance' -] %} -{% set new_index = process_steps.index(status_data.get('status')) %} +{% set new_index = PROCESS_STEPS.index(status_data.get('status')) %} {% do salt.log.debug('soc/dyanno/hypervisor/write_status: new_index: ' ~ new_index|string) %} # Function to read and parse current JSON status file @@ -46,8 +37,8 @@ {% import_json rel_path_status_file as current_status %} {% do salt.log.debug('soc/dyanno/hypervisor/write_status: current status: ' ~ current_status) %} {% do salt.log.debug('soc/dyanno/hypervisor/write_status: current status: ' ~ current_status.get('status')) %} -{% if current_status.get('status') in process_steps %} -{% set current_index = process_steps.index(current_status.get('status')) %} +{% if current_status.get('status') in PROCESS_STEPS %} +{% set current_index = PROCESS_STEPS.index(current_status.get('status')) %} {% do salt.log.debug('soc/dyanno/hypervisor/write_status: current_index: ' ~ current_index|string) %} {%- set return_value = current_index -%} {% else %} @@ -74,7 +65,7 @@ ensure_status_dir: {# Some of the status updates trigger within a second of each other can can cause, for example, IP Configuration orchestration to process before the Processing #} {# This check has been put in place to ensure a status sooner in the process can't overwrite this file if a status later in the process wrote to it first. #} {# The final step is Destroyed, so we allow Processing to overwrite that incase someone creates a new VM with same name that was previously destroyed. #} -{% if new_index > current_index or (current_index == process_steps | length - 1 and new_index == 0) %} +{% if new_index > current_index or (current_index == PROCESS_STEPS | length - 1 and new_index == 0) %} write_status_file: file.serialize: - name: {{ status_file }} @@ -88,7 +79,7 @@ write_status_file: - file: ensure_status_dir {% else %} -{% do salt.log.debug('soc/dyanno/hypervisor/write_status: File not written. ' ~ process_steps[new_index] ~ ' cannot overwrite ' ~ process_steps[current_index] ~ '.' ) %} +{% do salt.log.debug('soc/dyanno/hypervisor/write_status: File not written. ' ~ PROCESS_STEPS[new_index] ~ ' cannot overwrite ' ~ PROCESS_STEPS[current_index] ~ '.' ) %} {% endif %} From 1a9d5f151f9c89496facaa95738141f2e4607c1c Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 26 Feb 2025 14:28:31 -0500 Subject: [PATCH 144/303] change description formatting. include full vm name in HYPERVISORS --- salt/hypervisor/map.jinja | 12 ++--- .../engines/master/virtual_node_manager.py | 12 ++--- .../hypervisor/soc_hypervisor.yaml.jinja | 45 +++++-------------- 3 files changed, 20 insertions(+), 49 deletions(-) diff --git a/salt/hypervisor/map.jinja b/salt/hypervisor/map.jinja index e52d7ae1a..3d08b15d5 100644 --- a/salt/hypervisor/map.jinja +++ b/salt/hypervisor/map.jinja @@ -79,7 +79,7 @@ } }) %} {% endif %} - {% do vms.update({hostname: vm_data}) %} + {% do vms.update({hostname ~ '_' ~ role: vm_data}) %} {% else %} {% do salt.log.info('salt/hypervisor/map.jinja: Config file empty: ' ~ vm_file) %} {% endif %} @@ -87,8 +87,8 @@ {# Find and add destroyed VMs from status files #} {% set processed_vms = [] %} - {% for vm_name, vm_data in vms.items() %} - {% do processed_vms.append(vm_name) %} + {% for vm_full_name, vm_data in vms.items() %} + {% do processed_vms.append(vm_full_name) %} {% endfor %} {# Find all status files for this hypervisor #} @@ -117,7 +117,7 @@ {% set hostname = vm_name.split('_')[0] %} {# Skip already processed VMs #} - {% if hostname in processed_vms %} + {% if vm_name in processed_vms %} {% continue %} {% endif %} @@ -127,11 +127,11 @@ {# Only process files with "Destroyed Instance" status #} {% if status_data and status_data.status == 'Destroyed Instance' %} - {% do salt.log.info('salt/hypervisor/map.jinja: Found VM with Destroyed Instance status: ' ~ hostname) %} + {% do salt.log.info('salt/hypervisor/map.jinja: Found VM with Destroyed Instance status: ' ~ vm_name) %} {# Add to vms with minimal config #} {% do vms.update({ - hostname: { + vm_name: { 'status': status_data, 'config': {} } diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index c64cd7276..689f1f3f8 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -390,8 +390,8 @@ def check_hardware_availability(hypervisor_path: str, vm_name: str, requested_hw continue vm_config = read_json_file(vm_file) - if 'config' not in vm_config or vm_config.get('status') != 'running': - log.debug("Skipping VM %s (not running)", basename) + if 'config' not in vm_config: + log.debug("Skipping VM %s (no config found)", basename) continue config = vm_config['config'] @@ -469,9 +469,7 @@ def create_vm_tracking_file(hypervisor_path: str, vm_name: str, config: dict) -> set_socore_ownership(os.path.dirname(file_path)) data = { - 'config': config, - 'status': 'creating', - 'timestamp': datetime.now().isoformat() + 'config': config } # Write file and set ownership write_json_file(file_path, data) @@ -648,11 +646,9 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: # Execute command result = subprocess.run(cmd, capture_output=True, text=True, check=True) - # Update tracking file status with timestamp + # Update tracking file if needed tracking_file = os.path.join(hypervisor_path, vm_name) data = read_json_file(tracking_file) - data['status'] = 'running' - data['timestamp'] = datetime.now().isoformat() write_json_file(tracking_file, data) except subprocess.CalledProcessError as e: diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index a72717de9..ff654b4b8 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -18,55 +18,30 @@ {%- set TEMPLATE = ANNOTATION.hypervisor.hosts.pop('defaultHost') -%} {%- macro update_description(description, cpu_free, mem_free, disk_free, copper_free, sfp_free, vm_list, cpu_total, mem_total, disk_total, copper_total, sfp_total) -%} -# Hypervisor Configuration: {{ description }} - -## Resource Summary +#### Resource Summary | | CPU Cores | Memory (GB) | Disk | Copper | SFP | |-----------|-----------|-------------|-------------|-------------|-------------| | Available | {{ cpu_free }} | {{ mem_free }} | {{ disk_free | replace('\n', ',') if disk_free else 'None' }} | {{ copper_free | replace('\n', ',') if copper_free else 'None' }} | {{ sfp_free | replace('\n', ',') if sfp_free else 'None' }} | | Total | {{ cpu_total }} | {{ mem_total }} | {{ disk_total | replace('\n', ',') }} | {{ copper_total | replace('\n', ',') }} | {{ sfp_total | replace('\n', ',') }} | {%- if vm_list %} -## Virtual Machines -VMs can have the following status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. The "Last Updated" timestamp shows when the VM status was last changed. After reaching "Highstate Triggered" status, additional highstate runs will not update the timestamp. Only changing to "Destroyed Instance" status will update the timestamp again. +#### Virtual Machines +Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. "Last Updated" shows when status changed. After "Highstate Triggered", only "Destroyed Instance" updates the timestamp. | Name | Status | CPU Cores | Memory (GB)| Disk | Copper | SFP | Last Updated | |--------------------|--------------------|-----------|------------|------|--------|------|---------------------| {%- for hostname, vm_data in vm_list.items() %} {%- set vm_status = vm_data.get('status', {}).get('status', 'Unknown') %} {%- set is_destroyed = vm_status == 'Destroyed Instance' %} -{%- set vm_role = vm_data.get('config', {}).get('role', 'unknown') %} -{%- set name = hostname ~ (('_' ~ vm_role) if not is_destroyed and vm_role != 'unknown' else '') %} -| {{ name }} | {{ vm_status }} | -{%- if is_destroyed -%} -- -{%- else -%} -{{ vm_data.get('config', {}).get('cpu', 'N/A') }} -{%- endif %} | -{%- if is_destroyed -%} -- -{%- else -%} -{{ vm_data.get('config', {}).get('memory', 'N/A') }} -{%- endif %} | -{%- if is_destroyed -%} -- -{%- else -%} -{{ vm_data.get('config', {}).get('disk', '-') | replace('\n', ',') if vm_data.get('config', {}).get('disk') else '-' }} -{%- endif %} | -{%- if is_destroyed -%} -- -{%- else -%} -{{ vm_data.get('config', {}).get('copper', '-') | replace('\n', ',') if vm_data.get('config', {}).get('copper') else '-' }} -{%- endif %} | -{%- if is_destroyed -%} -- -{%- else -%} -{{ vm_data.get('config', {}).get('sfp', '-') | replace('\n', ',') if vm_data.get('config', {}).get('sfp') else '-' }} -{%- endif %} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | +{%- if is_destroyed %} +| {{ hostname }} | {{ vm_status }} | - | - | - | - | - | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | +{%- else %} +| {{ hostname }} | {{ vm_status }} | {{ vm_data.get('config', {}).get('cpu', 'N/A') }} | {{ vm_data.get('config', {}).get('memory', 'N/A') }} | {{ vm_data.get('config', {}).get('disk', '-') | replace('\n', ',') if vm_data.get('config', {}).get('disk') else '-' }} | {{ vm_data.get('config', {}).get('copper', '-') | replace('\n', ',') if vm_data.get('config', {}).get('copper') else '-' }} | {{ vm_data.get('config', {}).get('sfp', '-') | replace('\n', ',') if vm_data.get('config', {}).get('sfp') else '-' }} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | +{%- endif %} {%- endfor %} {%- else %} -## Virtual Machines -VMs can have the following status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. The "Last Updated" timestamp shows when the VM status was last changed. After reaching "Highstate Triggered" status, additional highstate runs will not update the timestamp. Only changing to "Destroyed Instance" status will update the timestamp again. +#### Virtual Machines +Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. "Last Updated" shows when status changed. After "Highstate Triggered", only "Destroyed Instance" updates the timestamp. No Virtual Machines Found {%- endif %} From 52839e2a7d9c4f02d3cb50967cc2395dceb718ba Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 26 Feb 2025 15:22:36 -0500 Subject: [PATCH 145/303] implement regex for cpu and mem --- .../hypervisor/soc_hypervisor.yaml.jinja | 38 ++++++++++++++++++- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index ff654b4b8..cf272b221 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -116,9 +116,43 @@ No Virtual Machines Found {%- for field in updated_template.uiElements -%} {%- set updated_field = field.copy() -%} {%- if field.field == 'cpu' -%} -{%- do updated_field.update({'label': field.label | replace('FREE', cpu_free | string) | replace('TOTAL', cpu_total | string)}) -%} +{%- if cpu_free < 10 -%} +{%- set cpu_regex = '^[1-' ~ cpu_free ~ ']$' -%} +{%- elif cpu_free < 100 -%} +{%- set tens_digit = cpu_free // 10 -%} +{%- set ones_digit = cpu_free % 10 -%} +{%- if ones_digit == 0 -%} +{%- set cpu_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '0)$' -%} +{%- else -%} +{%- set cpu_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} +{%- endif -%} +{%- else -%} +{%- set cpu_regex = '^([1-9]|[1-9][0-9]|100)$' -%} +{%- endif -%} +{%- do updated_field.update({ + 'label': field.label | replace('FREE', cpu_free | string) | replace('TOTAL', cpu_total | string), + 'regex': cpu_regex, + 'regexFailureMessage': 'Enter a value not exceeding ' ~ cpu_free | string ~ ' cores' + }) -%} {%- elif field.field == 'memory' -%} -{%- do updated_field.update({'label': field.label | replace('FREE', mem_free | string) | replace('TOTAL', mem_total | string)}) -%} +{%- if mem_free < 10 -%} +{%- set mem_regex = '^[1-' ~ mem_free ~ ']$' -%} +{%- elif mem_free < 100 -%} +{%- set tens_digit = mem_free // 10 -%} +{%- set ones_digit = mem_free % 10 -%} +{%- if ones_digit == 0 -%} +{%- set mem_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '0)$' -%} +{%- else -%} +{%- set mem_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} +{%- endif -%} +{%- else -%} +{%- set mem_regex = '^([1-9]|[1-9][0-9]|[1-9][0-9][0-9])$' -%} +{%- endif -%} +{%- do updated_field.update({ + 'label': field.label | replace('FREE', mem_free | string) | replace('TOTAL', mem_total | string), + 'regex': mem_regex, + 'regexFailureMessage': 'Enter a value not exceeding ' ~ mem_free | string ~ ' GB' + }) -%} {%- elif field.field == 'disk' -%} {%- do updated_field.update({'label': field.label | replace('FREE', disk_free) | replace('TOTAL', disk_total | replace('\n', ','))}) -%} {%- elif field.field == 'copper' -%} From 4e954c24f7dac902836f3fd580f5d3a9cfcb1a4e Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 26 Feb 2025 17:58:09 -0500 Subject: [PATCH 146/303] handle cpu, copper and sfp as options --- .../engines/master/virtual_node_manager.py | 107 +++++++++++++----- salt/soc/dyanno/hypervisor/hypervisor.yaml | 12 +- .../hypervisor/soc_hypervisor.yaml.jinja | 26 +++-- 3 files changed, 102 insertions(+), 43 deletions(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index 689f1f3f8..42d8f6725 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -36,6 +36,7 @@ Configuration Files: - Located at /VMs - Contains array of VM configurations - Each VM config specifies hardware and network settings + - Hardware indices (disk, copper, sfp) must be specified as JSON arrays: "disk":["1","2"] defaults.yaml: Hardware capabilities configuration - Located at /opt/so/saltstack/default/salt/hypervisor/defaults.yaml @@ -210,7 +211,6 @@ def read_yaml_file(file_path: str) -> dict: except Exception as e: log.error("Failed to read YAML file %s: %s", file_path, str(e)) raise - def convert_pci_id(pci_id: str) -> str: """ Convert PCI ID from pci_0000_c7_00_0 format to 0000:c7:00.0 format. @@ -241,6 +241,35 @@ def convert_pci_id(pci_id: str) -> str: log.error("Failed to convert PCI ID %s: %s", pci_id, str(e)) raise +def parse_hardware_indices(hw_value: Any) -> List[int]: + """ + Parse hardware indices from JSON array format. + + Args: + hw_value: Hardware value which should be a list + + Returns: + List of integer indices + """ + indices = [] + + if hw_value is None: + return indices + + # If it's a list (expected format) + if isinstance(hw_value, list): + try: + indices = [int(x) for x in hw_value] + log.debug("Parsed hardware indices from list format: %s", indices) + except (ValueError, TypeError) as e: + log.error("Failed to parse hardware indices from list format: %s", str(e)) + raise ValueError(f"Invalid hardware indices format in list: {hw_value}") + else: + log.warning("Unexpected type for hardware indices: %s", type(hw_value)) + raise ValueError(f"Hardware indices must be in array format, got: {type(hw_value)}") + + return indices + def get_hypervisor_model(hypervisor: str) -> str: """Get sosmodel from hypervisor grains.""" try: @@ -318,7 +347,7 @@ def validate_hardware_request(model_config: dict, requested_hw: dict) -> Tuple[b for hw_type in ['disk', 'copper', 'sfp']: if hw_type in requested_hw and requested_hw[hw_type]: try: - indices = [int(x) for x in str(requested_hw[hw_type]).split('\n')] + indices = parse_hardware_indices(requested_hw[hw_type]) log.debug("Checking if %s indices %s exist in model", hw_type, indices) if hw_type not in model_config['hardware']: @@ -333,8 +362,8 @@ def validate_hardware_request(model_config: dict, requested_hw: dict) -> Tuple[b if invalid_indices: log.error("%s indices %s do not exist in model", hw_type, invalid_indices) errors[hw_type] = f"Invalid {hw_type} indices: {invalid_indices}" - except ValueError: - log.error("Invalid %s indices format: %s", hw_type, requested_hw[hw_type]) + except ValueError as e: + log.error("Invalid %s indices format: %s", hw_type, str(e)) errors[hw_type] = f"Invalid {hw_type} indices format" except KeyError: log.error("No %s configuration found in model", hw_type) @@ -407,10 +436,13 @@ def check_hardware_availability(hypervisor_path: str, vm_name: str, requested_hw # Track unique resources for hw_type in ['disk', 'copper', 'sfp']: if hw_type in config and config[hw_type]: - indices = [int(x) for x in str(config[hw_type]).split('\n')] - for idx in indices: - used_resources[hw_type][idx] = basename.replace('_sensor', '') # Store VM name without role - log.debug("VM %s is using %s indices: %s", basename, hw_type, indices) + try: + indices = parse_hardware_indices(config[hw_type]) + for idx in indices: + used_resources[hw_type][idx] = basename.replace('_sensor', '') # Store VM name without role + log.debug("VM %s is using %s indices: %s", basename, hw_type, indices) + except ValueError as e: + log.error("Error parsing %s indices for VM %s: %s", hw_type, basename, str(e)) log.debug("Total hardware currently in use - CPU: %d, Memory: %dGB", total_cpu, total_memory) log.debug("Hardware indices currently in use: %s", used_resources) @@ -434,23 +466,27 @@ def check_hardware_availability(hypervisor_path: str, vm_name: str, requested_hw # Check for hardware conflicts for hw_type in ['disk', 'copper', 'sfp']: if hw_type in requested_hw and requested_hw[hw_type]: - requested_indices = [int(x) for x in str(requested_hw[hw_type]).split('\n')] - log.debug("Checking for %s conflicts - Requesting indices: %s, Currently in use: %s", - hw_type, requested_indices, used_resources[hw_type]) - conflicts = {} # {index: vm_name} - for idx in requested_indices: - if idx in used_resources[hw_type]: - conflicts[idx] = used_resources[hw_type][idx] - - if conflicts: - # Create one sentence per conflict - conflict_details = [] - hw_name = hw_type.upper() if hw_type == 'sfp' else hw_type.capitalize() - for idx, vm in conflicts.items(): - conflict_details.append(f"{hw_name} index {idx} in use by {vm}") + try: + requested_indices = parse_hardware_indices(requested_hw[hw_type]) + log.debug("Checking for %s conflicts - Requesting indices: %s, Currently in use: %s", + hw_type, requested_indices, used_resources[hw_type]) + conflicts = {} # {index: vm_name} + for idx in requested_indices: + if idx in used_resources[hw_type]: + conflicts[idx] = used_resources[hw_type][idx] - log.debug("Found conflicting %s indices: %s", hw_type, conflict_details) - errors[hw_type] = ". ".join(conflict_details) + "." + if conflicts: + # Create one sentence per conflict + conflict_details = [] + hw_name = hw_type.upper() if hw_type == 'sfp' else hw_type.capitalize() + for idx, vm in conflicts.items(): + conflict_details.append(f"{hw_name} index {idx} in use by {vm}") + + log.debug("Found conflicting %s indices: %s", hw_type, conflict_details) + errors[hw_type] = ". ".join(conflict_details) + "." + except ValueError as e: + log.error("Error parsing %s indices for conflict check: %s", hw_type, str(e)) + errors[hw_type] = f"Invalid {hw_type} indices format" if errors: log.debug("Hardware validation failed with errors: %s", errors) @@ -636,12 +672,23 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: # Add PCI devices for hw_type in ['disk', 'copper', 'sfp']: if hw_type in vm_config and vm_config[hw_type]: - indices = [int(x) for x in str(vm_config[hw_type]).split('\n')] - for idx in indices: - hw_config = {int(k): v for k, v in model_config['hardware'][hw_type].items()} - pci_id = hw_config[idx] - converted_pci_id = convert_pci_id(pci_id) - cmd.extend(['-P', converted_pci_id]) + try: + indices = parse_hardware_indices(vm_config[hw_type]) + for idx in indices: + hw_config = {int(k): v for k, v in model_config['hardware'][hw_type].items()} + pci_id = hw_config[idx] + converted_pci_id = convert_pci_id(pci_id) + cmd.extend(['-P', converted_pci_id]) + except ValueError as e: + error_msg = f"Failed to parse {hw_type} indices: {str(e)}" + log.error(error_msg) + mark_vm_failed(os.path.join(hypervisor_path, vm_name), 3, error_msg) + raise ValueError(error_msg) + except KeyError as e: + error_msg = f"Invalid {hw_type} index: {str(e)}" + log.error(error_msg) + mark_vm_failed(os.path.join(hypervisor_path, vm_name), 3, error_msg) + raise KeyError(error_msg) # Execute command result = subprocess.run(cmd, capture_output=True, text=True, check=True) diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index 0166dbc3c..59e8da940 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -63,17 +63,17 @@ hypervisor: readonly: true forcedType: int - field: disk - label: "Disk(s) for passthrough. Line-delimited list. Free: FREE | Total: TOTAL" + label: "Disk(s) for passthrough. Free: FREE | Total: TOTAL" readonly: true + options: [] forcedType: '[]int' - multiline: true - field: copper - label: "Copper port(s) for passthrough. Line-delimited list. Free: FREE | Total: TOTAL" + label: "Copper port(s) for passthrough. Free: FREE | Total: TOTAL" readonly: true + options: [] forcedType: '[]int' - multiline: true - field: sfp - label: "SFP port(s) for passthrough. Line-delimited list. Free: FREE | Total: TOTAL" + label: "SFP port(s) for passthrough. Free: FREE | Total: TOTAL" readonly: true + options: [] forcedType: '[]int' - multiline: true diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index cf272b221..c3eeee689 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -36,7 +36,7 @@ Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {%- if is_destroyed %} | {{ hostname }} | {{ vm_status }} | - | - | - | - | - | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | {%- else %} -| {{ hostname }} | {{ vm_status }} | {{ vm_data.get('config', {}).get('cpu', 'N/A') }} | {{ vm_data.get('config', {}).get('memory', 'N/A') }} | {{ vm_data.get('config', {}).get('disk', '-') | replace('\n', ',') if vm_data.get('config', {}).get('disk') else '-' }} | {{ vm_data.get('config', {}).get('copper', '-') | replace('\n', ',') if vm_data.get('config', {}).get('copper') else '-' }} | {{ vm_data.get('config', {}).get('sfp', '-') | replace('\n', ',') if vm_data.get('config', {}).get('sfp') else '-' }} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | +| {{ hostname }} | {{ vm_status }} | {{ vm_data.get('config', {}).get('cpu', 'N/A') }} | {{ vm_data.get('config', {}).get('memory', 'N/A') }} | {{ vm_data.get('config', {}).get('disk', []) | join(',') if vm_data.get('config', {}).get('disk') else '-' }} | {{ vm_data.get('config', {}).get('copper', []) | join(',') if vm_data.get('config', {}).get('copper') else '-' }} | {{ vm_data.get('config', {}).get('sfp', []) | join(',') if vm_data.get('config', {}).get('sfp') else '-' }} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | {%- endif %} {%- endfor %} {%- else %} @@ -92,9 +92,9 @@ No Virtual Machines Found {%- set vm_status = vm.get('status', {}).get('status', '') -%} {%- if vm_status != 'Destroyed Instance' -%} {%- set config = vm.get('config', {}) -%} -{%- do used_disk.extend((config.get('disk', '') | string).split('\n') | map('trim') | list) -%} -{%- do used_copper.extend((config.get('copper', '') | string).split('\n') | map('trim') | list) -%} -{%- do used_sfp.extend((config.get('sfp', '') | string).split('\n') | map('trim') | list) -%} +{%- do used_disk.extend(config.get('disk', [])) -%} +{%- do used_copper.extend(config.get('copper', [])) -%} +{%- do used_sfp.extend(config.get('sfp', [])) -%} {%- endif -%} {%- endfor -%} @@ -154,11 +154,23 @@ No Virtual Machines Found 'regexFailureMessage': 'Enter a value not exceeding ' ~ mem_free | string ~ ' GB' }) -%} {%- elif field.field == 'disk' -%} -{%- do updated_field.update({'label': field.label | replace('FREE', disk_free) | replace('TOTAL', disk_total | replace('\n', ','))}) -%} +{%- set disk_free_list = disk_free.split(',') if disk_free else [] -%} +{%- do updated_field.update({ + 'label': field.label | replace('FREE', disk_free) | replace('TOTAL', disk_total | replace('\n', ',')), + 'options': disk_free_list + }) -%} {%- elif field.field == 'copper' -%} -{%- do updated_field.update({'label': field.label | replace('FREE', copper_free) | replace('TOTAL', copper_total | replace('\n', ','))}) -%} +{%- set copper_free_list = copper_free.split(',') if copper_free else [] -%} +{%- do updated_field.update({ + 'label': field.label | replace('FREE', copper_free) | replace('TOTAL', copper_total | replace('\n', ',')), + 'options': copper_free_list + }) -%} {%- elif field.field == 'sfp' -%} -{%- do updated_field.update({'label': field.label | replace('FREE', sfp_free) | replace('TOTAL', sfp_total | replace('\n', ','))}) -%} +{%- set sfp_free_list = sfp_free.split(',') if sfp_free else [] -%} +{%- do updated_field.update({ + 'label': field.label | replace('FREE', sfp_free) | replace('TOTAL', sfp_total | replace('\n', ',')), + 'options': sfp_free_list + }) -%} {%- endif -%} {%- do updated_elements.append(updated_field) -%} {%- endfor -%} From c8a1c8377a0e230c9df6e3fdae24a4e5896fac9b Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 27 Feb 2025 16:04:44 -0500 Subject: [PATCH 147/303] vm power operations --- .../engines/master/virtual_power_manager.py | 330 ++++++++++++++++++ salt/salt/files/hvn_engine.conf | 7 + .../files/virtual_node_manager_engine.conf | 4 - salt/salt/master.sls | 17 +- salt/soc/dyanno/hypervisor/hypervisor.yaml | 8 + 5 files changed, 357 insertions(+), 9 deletions(-) create mode 100644 salt/salt/engines/master/virtual_power_manager.py create mode 100644 salt/salt/files/hvn_engine.conf delete mode 100644 salt/salt/files/virtual_node_manager_engine.conf diff --git a/salt/salt/engines/master/virtual_power_manager.py b/salt/salt/engines/master/virtual_power_manager.py new file mode 100644 index 000000000..8cca82606 --- /dev/null +++ b/salt/salt/engines/master/virtual_power_manager.py @@ -0,0 +1,330 @@ +#!/opt/saltstack/salt/bin/python3 + +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +""" +Salt Engine for Virtual Machine Power Management + +This engine manages power control actions for virtual machines in Security Onion's +virtualization infrastructure. It monitors VM configurations for power control requests +and executes the appropriate virt module actions. + +Usage: + engines: + - virtual_power_manager: + interval: 60 + base_path: /opt/so/saltstack/local/salt/hypervisor/hosts + +Options: + interval: Time in seconds between engine runs (managed by salt-master, default: 60) + base_path: Base directory containing hypervisor configurations (default: /opt/so/saltstack/local/salt/hypervisor/hosts) + +Configuration Files: + VMs: JSON file containing VM configurations + - Located at /VMs + - Contains array of VM configurations + - Power control requests are specified with the "powercontrol" key + - Valid values for "powercontrol": "Reboot", "Reset", "Shutdown", "Start", "Stop" + +Examples: + 1. Basic Configuration: + engines: + - virtual_power_manager: {} + + Uses default settings to process power control requests every 60 seconds. + + 2. Custom Interval: + engines: + - virtual_power_manager: + interval: 120 + + Processes power control requests every 120 seconds. + +Power Control Actions: + - Reboot: Gracefully reboot the VM (virt.reboot) + - Reset: Force reset the VM (virt.reset) + - Shutdown: Gracefully shut down the VM (virt.shutdown) + - Start: Start the VM (virt.start) + - Stop: Force stop the VM (virt.stop) + +Notes: + - File locking is used to prevent race conditions when multiple processes access the VMs file + - The "powercontrol" key is removed from the VM configuration after successful execution + - Comprehensive logging for troubleshooting + - No continuous loop (salt-master handles scheduling) + - File locking is only applied when a powercontrol key is detected, not on every run + +Description: + The engine operates in the following phases: + + 1. Configuration Processing + - Reads VMs file for each hypervisor without locking + - Identifies VMs with "powercontrol" key + - If powercontrol key is found, acquires lock and reads file again + + 2. Power Control Execution + - Maps "powercontrol" value to virt module function + - Executes appropriate virt module command + - Removes "powercontrol" key after successful execution + + 3. File Locking + - Acquires lock only when a powercontrol key is detected + - Releases lock after modifications + - Handles lock acquisition failures + +Logging: + Log files are written to /opt/so/log/salt/master + Comprehensive logging includes: + - Power control action details + - Command execution results + - Error conditions with full context + - File locking operations +""" + +import os +import glob +import json +import logging +import fcntl +import salt.client +from typing import Dict, List, Optional, Any, Tuple + +# Configure logging +log = logging.getLogger(__name__) +log.setLevel(logging.DEBUG) + +# Constants +DEFAULT_INTERVAL = 60 +DEFAULT_BASE_PATH = '/opt/so/saltstack/local/salt/hypervisor/hosts' +VALID_POWER_ACTIONS = {'Reboot', 'Reset', 'Shutdown', 'Start', 'Stop'} + +class FileLock: + """ + Context manager for file locking. + + This class provides a context manager for file locking using fcntl. + It acquires an exclusive lock on the file when entering the context + and releases the lock when exiting. + + Example: + with FileLock(file_path): + # Read and modify file + # Lock is automatically released when exiting the context + """ + + def __init__(self, file_path: str): + self.file_path = file_path + self.lock_path = f"{file_path}.lock" + self.lock_file = None + + def __enter__(self): + try: + # Open the lock file + self.lock_file = open(self.lock_path, 'w') + + # Acquire exclusive lock + fcntl.flock(self.lock_file, fcntl.LOCK_EX) + log.debug("Acquired lock on %s", self.file_path) + + return self + + except Exception as e: + log.error("Failed to acquire lock on %s: %s", self.file_path, str(e)) + if self.lock_file: + self.lock_file.close() + raise + + def __exit__(self, exc_type, exc_val, exc_tb): + try: + # Release lock + if self.lock_file: + fcntl.flock(self.lock_file, fcntl.LOCK_UN) + self.lock_file.close() + log.debug("Released lock on %s", self.file_path) + + # Remove lock file + if os.path.exists(self.lock_path): + os.remove(self.lock_path) + + except Exception as e: + log.error("Error releasing lock on %s: %s", self.file_path, str(e)) + +def read_json_file(file_path: str) -> Any: + """ + Read and parse a JSON file. + Returns an empty array if the file is empty. + """ + try: + with open(file_path, 'r') as f: + content = f.read().strip() + if not content: + return [] + return json.loads(content) + except Exception as e: + log.error("Failed to read JSON file %s: %s", file_path, str(e)) + raise + +def write_json_file(file_path: str, data: Any) -> None: + """Write data to a JSON file.""" + try: + with open(file_path, 'w') as f: + json.dump(data, f, indent=2) + except Exception as e: + log.error("Failed to write JSON file %s: %s", file_path, str(e)) + raise + +def has_power_control_requests(nodes_config: List[Dict]) -> bool: + """ + Check if any VM in the configuration has a powercontrol key. + + Args: + nodes_config: List of VM configurations + + Returns: + True if at least one VM has a powercontrol key, False otherwise + """ + return any('powercontrol' in vm_config for vm_config in nodes_config) + +def process_power_control(hypervisor: str, vm_config: dict) -> bool: + """ + Process a power control request for a VM. + + Args: + hypervisor: Name of the hypervisor + vm_config: VM configuration dictionary + + Returns: + True if the power control action was successful, False otherwise + """ + try: + # Get VM name and power control action + vm_name = f"{vm_config['hostname']}_{vm_config['role']}" + power_action = vm_config['powercontrol'] + + # Validate power action + if power_action not in VALID_POWER_ACTIONS: + log.error("Invalid power control action: %s", power_action) + return False + + # Map power action to virt module function + virt_function = power_action.lower() + + # Execute power control action + log.info("Executing %s on VM %s", power_action, vm_name) + client = salt.client.LocalClient() + result = client.cmd( + f"{hypervisor}_*", + f"virt.{virt_function}", + [vm_name], + expr_form="glob" + ) + + # Check result + if result and any(success for success in result.values()): + log.info("Successfully executed %s on VM %s", power_action, vm_name) + return True + else: + log.error("Failed to execute %s on VM %s: %s", power_action, vm_name, result) + return False + + except Exception as e: + log.error("Error processing power control for VM %s: %s", vm_config.get('hostname', 'unknown'), str(e)) + return False + +def process_hypervisor_power_requests(hypervisor_path: str) -> None: + """ + Process power control requests for a single hypervisor. + + Args: + hypervisor_path: Path to the hypervisor directory + """ + try: + # Get hypervisor name from path + hypervisor = os.path.basename(hypervisor_path) + + # Read VMs file + vms_file = os.path.join(os.path.dirname(hypervisor_path), f"{hypervisor}VMs") + if not os.path.exists(vms_file): + log.debug("No VMs file found at %s", vms_file) + return + + # First, read the file without locking to check if any VM has a powercontrol key + nodes_config = read_json_file(vms_file) + if not nodes_config: + log.debug("Empty VMs configuration in %s", vms_file) + return + + # Check if any VM has a powercontrol key + if not has_power_control_requests(nodes_config): + log.debug("No power control requests found in %s", vms_file) + return + + # If we found powercontrol keys, lock the file and process the requests + with FileLock(vms_file): + # Read the VMs file again with the lock to ensure we have the latest data + nodes_config = read_json_file(vms_file) + if not nodes_config: + log.debug("Empty VMs configuration in %s (after lock)", vms_file) + return + + # Track if any changes were made + changes_made = False + + # Process each VM configuration + for i, vm_config in enumerate(nodes_config): + if 'powercontrol' in vm_config: + # Process power control request + log.info("Found power control request for VM %s_%s: %s", + vm_config.get('hostname', 'unknown'), + vm_config.get('role', 'unknown'), + vm_config['powercontrol']) + + success = process_power_control(hypervisor, vm_config) + if success: + # Remove powercontrol key + log.info("Power control action successful, removing powercontrol key") + del nodes_config[i]['powercontrol'] + changes_made = True + + # Write updated configuration if changes were made + if changes_made: + log.info("Writing updated VM configuration to %s", vms_file) + write_json_file(vms_file, nodes_config) + + except Exception as e: + log.error("Failed to process hypervisor %s: %s", hypervisor_path, str(e)) + raise + +def start(interval: int = DEFAULT_INTERVAL, + base_path: str = DEFAULT_BASE_PATH) -> None: + """ + Process virtual machine power control requests. + + This function processes power control requests for virtual machines + by monitoring the VMs files for the "powercontrol" key. + + Args: + interval: Time in seconds between engine runs (managed by salt-master) + base_path: Base path containing hypervisor configurations + """ + log.info("Starting virtual power manager engine") + + try: + # Process each hypervisor directory + for hypervisor_path in glob.glob(os.path.join(base_path, '*')): + if os.path.isdir(hypervisor_path): + process_hypervisor_power_requests(hypervisor_path) + + log.info("Virtual power manager completed successfully") + + except Exception as e: + log.error("Error in virtual power manager: %s", str(e)) diff --git a/salt/salt/files/hvn_engine.conf b/salt/salt/files/hvn_engine.conf new file mode 100644 index 000000000..9ec2bc998 --- /dev/null +++ b/salt/salt/files/hvn_engine.conf @@ -0,0 +1,7 @@ +engines: + - virtual_node_manager: + interval: 10 + base_path: /opt/so/saltstack/local/salt/hypervisor/hosts + - virtual_power_manager: + interval: 10 + base_path: /opt/so/saltstack/local/salt/hypervisor/hosts diff --git a/salt/salt/files/virtual_node_manager_engine.conf b/salt/salt/files/virtual_node_manager_engine.conf deleted file mode 100644 index 8374f551a..000000000 --- a/salt/salt/files/virtual_node_manager_engine.conf +++ /dev/null @@ -1,4 +0,0 @@ -engines: - - virtual_node_manager: - interval: 30 - base_path: /opt/so/saltstack/local/salt/hypervisor/hosts diff --git a/salt/salt/master.sls b/salt/salt/master.sls index ed8da3f73..56f529e89 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -49,6 +49,13 @@ pillarWatch_engine: - source: salt://salt/engines/master/pillarWatch.py {% if 'hvn' in salt['pillar.get']('features', []) %} +hvn_engine_config: + file.managed: + - name: /etc/salt/master.d/hvn_engine.conf + - source: salt://salt/files/hvn_engine.conf + - watch_in: + - service: salt_master_service + virtual_node_manager_engine: file.managed: - name: /etc/salt/engines/virtual_node_manager.py @@ -56,11 +63,12 @@ virtual_node_manager_engine: - watch_in: - service: salt_master_service -virtual_node_manager_engine_config: +virtual_power_manager_engine: file.managed: - - name: /etc/salt/master.d/virtual_node_manager_engine.conf - - source: salt://salt/files/virtual_node_manager_engine.conf - + - name: /etc/salt/engines/virtual_power_manager.py + - source: salt://salt/engines/master/virtual_power_manager.py + - watch_in: + - service: salt_master_service {% endif %} engines_config: @@ -88,7 +96,6 @@ reactor: - 'setup/so-minion': - /opt/so/saltstack/default/salt/reactor/sominion_setup.sls - 'salt/cloud/*/destroyed': - - /opt/so/saltstack/default/salt/reactor/virtReleaseHardware.sls - /opt/so/saltstack/default/salt/reactor/deleteKey.sls #} diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index 59e8da940..6b0458265 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -77,3 +77,11 @@ hypervisor: readonly: true options: [] forcedType: '[]int' + - field: powercontrol + label: "Execute VM power operations" + options: + - Start + - Reboot + - Shutdown + - Reset + - Stop From c6c979dc190743c7b9e3ded03355fd699841e457 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 28 Feb 2025 16:12:28 -0500 Subject: [PATCH 148/303] properly set memory and CPUCORES for minion pillars during vm setup --- salt/reactor/sominion_setup.sls | 36 +++++++++------- salt/setup/virt/soinstall.map.jinja | 65 ++++++++++++++++++++++++----- salt/setup/virt/sominion.sls | 19 ++++----- 3 files changed, 85 insertions(+), 35 deletions(-) diff --git a/salt/reactor/sominion_setup.sls b/salt/reactor/sominion_setup.sls index 21c7824fe..91889158b 100644 --- a/salt/reactor/sominion_setup.sls +++ b/salt/reactor/sominion_setup.sls @@ -10,26 +10,32 @@ from subprocess import call import yaml def run(): + logging.debug('sominion_setup_reactor: Running') minionid = data['id'] DATA = data['data'] hv_name = DATA['HYPERVISOR_HOST'] - logging.error("sominion_setup reactor: %s " % DATA) + logging.debug('sominion_setup_reactor: DATA: %s' % DATA) - vm_out_data = { - 'cpu': DATA['CPU'], - 'memory': DATA['MEMORY'], - 'disks': DATA['DISKS'], - 'copper': DATA['COPPER'], - 'sfp': DATA['SFP'] - } - logging.error("sominion_setup reactor: vm_out_data: %s " % vm_out_data) + # Build the base command + cmd = "NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVM -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -d='" + DATA['NODE_DESCRIPTION'] + "'" + + # Add optional arguments only if they exist in DATA + if 'CORECOUNT' in DATA: + cmd += " -c=" + str(DATA['CORECOUNT']) + + if 'INTERFACE' in DATA: + cmd += " -a=" + DATA['INTERFACE'] + + if 'ES_HEAP_SIZE' in DATA: + cmd += " -e=" + DATA['ES_HEAP_SIZE'] + + if 'LS_HEAP_SIZE' in DATA: + cmd += " -l=" + DATA['LS_HEAP_SIZE'] + + logging.debug('sominion_setup_reactor: Command: %s' % cmd) + rc = call(cmd, shell=True) - with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + minionid + ".sls", 'w') as f: - yaml.dump(vm_out_data, f, default_flow_style=False) - - rc = call("NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVM -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -a=" + DATA['INTERFACE'] + " -c=" + str(DATA['CPU']) + " -d='" + DATA['NODE_DESCRIPTION'] + "'" + " -e=" + DATA['ES_HEAP_SIZE'] + " -l=" + DATA['LS_HEAP_SIZE'], shell=True) - - logging.error('sominion_setup reactor: rc: %s' % rc) + logging.info('sominion_setup_reactor: rc: %s' % rc) return {} diff --git a/salt/setup/virt/soinstall.map.jinja b/salt/setup/virt/soinstall.map.jinja index 33da9ff0c..1d70ac67e 100644 --- a/salt/setup/virt/soinstall.map.jinja +++ b/salt/setup/virt/soinstall.map.jinja @@ -4,18 +4,67 @@ Elastic License 2.0. #} {% set nodetype = grains.id.split("_") | last %} -{% import_yaml 'setup/virt/' ~ nodetype ~ '.yaml' as DATA %} -{% set total_mem = grains.mem_total %} +{% set hypervisor = salt['grains.get']('salt-cloud:profile').split('-')[1] %} +{# Import hardware details from VM hardware tracking file #} +{% import_json 'hypervisor/hosts/' ~ hypervisor ~ '/' ~ grains.id as vm_hardware %} + +{% set DATA = {} %} +{% do DATA.update({'MNIC': 'enp1s0'}) %} {% do DATA.update({'MAINIP': grains.ip_interfaces.get(DATA.MNIC)[0]}) %} -{% do DATA.update({'CORECOUNT': grains.num_cpus}) %} -{% do DATA.update({'CPUCORES': grains.num_cpus}) %} + +{# Use CPU value from VM hardware file if available, otherwise fallback to grains #} +{% if vm_hardware and vm_hardware.get('config', {}).get('cpu') %} + {% do DATA.update({'CPUCORES': vm_hardware.get('config', {}).get('cpu')|int }) %} + {% do salt.log.info('Using CPU from VM hardware file: ' ~ vm_hardware.get('config', {}).get('cpu')|string) %} +{% else %} + {% do DATA.update({'CPUCORES': grains.num_cpus }) %} + {% do salt.log.error('Using CPU from grains: ' ~ grains.num_cpus|string) %} +{% endif %} + +{# Use memory value from VM hardware file if available, otherwise fallback to grains. If grains is used, it will be from cpu/mem from the base domain. #} +{% if vm_hardware and vm_hardware.get('config', {}).get('memory') %} + {% set total_mem = vm_hardware.get('config', {}).get('memory')|int * 1024 %} + {% do salt.log.info('Using memory from VM hardware file: ' ~ vm_hardware.get('config', {}).get('memory')|string ~ ' (converted to ' ~ total_mem|string ~ ')') %} +{% else %} + {% set total_mem = grains.mem_total %} + {% do salt.log.error('Using memory from grains: ' ~ total_mem|string) %} +{% endif %} + +{% do DATA.update({'NODE_DESCRIPTION': 'VM of ' ~ hypervisor}) %} +{% do DATA.update({'NODETYPE': nodetype | upper}) %} + +{% if nodetype in ['standalone', 'sensor', 'heavynode']%} +{% do DATA.update({'INTERFACE': 'bond0'}) %} +{% endif %} + +{# Calculate reasonable core usage #} +{% set cores_for_zeek = (DATA.CPUCORES / 2) - 1 %} +{% do salt.log.info('cores_for_zeek calculation using CPUCORES: ' ~ DATA.CPUCORES|string) %} +{% do salt.log.info('cores_for_zeek: ' ~ cores_for_zeek|string) %} +{% set lb_procs_round = cores_for_zeek|round|int %} +{% do salt.log.info('lb_procs_round: ' ~ lb_procs_round|string) %} +{% set lb_procs = 1 if lb_procs_round < 1 else lb_procs_round %} +{% do salt.log.info('lb_procs: ' ~ lb_procs|string) %} +{# Check memory conditions #} +{% set low_mem = false %} +{% do salt.log.info('Memory check using total_mem: ' ~ total_mem|string) %} +{% if nodetype in ['standalone', 'heavynode'] %} +{% if total_mem > 15000 and total_mem < 24000 %} +{% set low_mem = true %} +{% endif %} +{% endif %} +{# Set CORECOUNT based on memory conditions #} +{% if low_mem %} +{% do DATA.update({'CORECOUNT': 1}) %} +{% else %} +{% do DATA.update({'CORECOUNT': lb_procs}) %} +{% endif %} + {% if nodetype in ['searchnode', 'receiver', 'fleet', 'heavynode'] %} - {# we can't use the host grain here because the grain may not be updated yet from the hostname change #} {% do DATA.update({'LSHOSTNAME': grains.id.split("_") | first}) %} - {% if total_mem >= 32000 or nodetype in ['managersearch','heavynode','standalone'] %} {% set LSHEAP="1000m" %} {% elif nodetype == 'eval' %} @@ -24,11 +73,8 @@ {% set LSHEAP="500m" %} {% endif %} {% do DATA.update({'LSHEAP': LSHEAP}) %} - {% endif %} - {% if nodetype in ['searchnode', 'heavynode'] %} - {# this replicates the function es_heapsize in so-functions #} {% if total_mem < 8000 %} {% set ES_HEAP_SIZE = "600m" %} @@ -43,5 +89,4 @@ {% endif %} {% endif %} {% do DATA.update({'ES_HEAP_SIZE': ES_HEAP_SIZE}) %} - {% endif %} diff --git a/salt/setup/virt/sominion.sls b/salt/setup/virt/sominion.sls index 55e3a796a..e0598a4d3 100644 --- a/salt/setup/virt/sominion.sls +++ b/salt/setup/virt/sominion.sls @@ -13,18 +13,17 @@ create_pillar: MAINIP: {{ DATA.MAINIP }} MNIC: {{ DATA.MNIC }} NODE_DESCRIPTION: '{{ DATA.NODE_DESCRIPTION }}' - ES_HEAP_SIZE: {{ DATA.ES_HEAP_SIZE }} - PATCHSCHEDULENAME: {{ DATA.PATCHSCHEDULENAME }} INTERFACE: {{ DATA.INTERFACE }} NODETYPE: {{ DATA.NODETYPE }} + {% if 'CORECOUNT' in DATA %} CORECOUNT: {{ DATA.CORECOUNT }} + {% endif %} + {% if 'ES_HEAP_SIZE' in DATA %} + ES_HEAP_SIZE: {{ DATA.ES_HEAP_SIZE }} + {% endif %} + {% if 'LSHOSTNAME' in DATA %} LSHOSTNAME: {{ DATA.LSHOSTNAME }} + {% endif %} + {% if 'LSHEAP' in DATA %} LS_HEAP_SIZE: {{ DATA.LSHEAP }} - CPUCORES: {{ DATA.CPUCORES }} - IDH_MGTRESTRICT: {{ DATA.IDH_MGTRESTRICT }} - IDH_SERVICES: {{ DATA.IDH_SERVICES }} - CPU: {{ DATA.CPU }} - MEMORY: {{ DATA.MEMORY }} - DISKS: {{ DATA.DISKS }} - COPPER: {{ DATA.COPPER }} - SFP: {{ DATA.SFP }} + {% endif %} From 8047e196fe8236afdef4bb245b248d5ea8edd61b Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 28 Feb 2025 17:21:06 -0500 Subject: [PATCH 149/303] fix pipeline workers, zeek/suricata lbprocs, CPUCORES and CORECOUNT --- salt/manager/tools/sbin/so-minion | 10 ++++++++-- salt/reactor/sominion_setup.sls | 5 ++--- salt/setup/virt/fleet.yaml | 18 ------------------ salt/setup/virt/heavynode.yaml | 18 ------------------ salt/setup/virt/idh.yaml | 18 ------------------ salt/setup/virt/receiver.yaml | 18 ------------------ salt/setup/virt/searchnode.yaml | 18 ------------------ salt/setup/virt/sensor.yaml | 18 ------------------ salt/setup/virt/soinstall.map.jinja | 5 +---- salt/setup/virt/sominion.sls | 5 ++++- 10 files changed, 15 insertions(+), 118 deletions(-) delete mode 100644 salt/setup/virt/fleet.yaml delete mode 100644 salt/setup/virt/heavynode.yaml delete mode 100644 salt/setup/virt/idh.yaml delete mode 100644 salt/setup/virt/receiver.yaml delete mode 100644 salt/setup/virt/searchnode.yaml delete mode 100644 salt/setup/virt/sensor.yaml diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index cc78e69e1..6de864e4b 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -95,10 +95,16 @@ for i in "$@"; do MAINIP="${i#*=}" shift ;; - -c=*|--cpu=*) + # Usable / Load Balance Cores for Zeek / Suricata + -C=*|--lbc=*) CORECOUNT="${i#*=}" shift ;; + # Total number of CPU Cores + -c=*|--cpu=*) + CPUCORES="${i#*=}" + shift + ;; -*|--*) echo "Unknown option $i" log "ERROR" "Unknown option $i" @@ -374,7 +380,7 @@ function add_logstash_to_minion() { "logstash:"\ " enabled: True"\ " config:"\ - " pipeline_x_workers: $CORECOUNT"\ + " pipeline_x_workers: $CPUCORES"\ " settings:"\ " lsheap: $LSHEAP"\ " " >> $PILLARFILE diff --git a/salt/reactor/sominion_setup.sls b/salt/reactor/sominion_setup.sls index 91889158b..547b1b686 100644 --- a/salt/reactor/sominion_setup.sls +++ b/salt/reactor/sominion_setup.sls @@ -16,13 +16,12 @@ def run(): hv_name = DATA['HYPERVISOR_HOST'] logging.debug('sominion_setup_reactor: DATA: %s' % DATA) - # Build the base command - cmd = "NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVM -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -d='" + DATA['NODE_DESCRIPTION'] + "'" + cmd = "NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVM -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -c=" + str(DATA['CPUCORES']) + " -d='" + DATA['NODE_DESCRIPTION'] + "'" # Add optional arguments only if they exist in DATA if 'CORECOUNT' in DATA: - cmd += " -c=" + str(DATA['CORECOUNT']) + cmd += " -C=" + str(DATA['CORECOUNT']) if 'INTERFACE' in DATA: cmd += " -a=" + DATA['INTERFACE'] diff --git a/salt/setup/virt/fleet.yaml b/salt/setup/virt/fleet.yaml deleted file mode 100644 index d6c90e11d..000000000 --- a/salt/setup/virt/fleet.yaml +++ /dev/null @@ -1,18 +0,0 @@ -MAINIP: -MNIC: enp1s0 -NODE_DESCRIPTION: 'vm' -ES_HEAP_SIZE: -PATCHSCHEDULENAME: -INTERFACE: -NODETYPE: FLEET -CORECOUNT: 8 -LSHOSTNAME: -LSHEAP: -CPUCORES: 8 -IDH_MGTRESTRICT: -IDH_SERVICES: -CPU: 8 -MEMORY: 8 -DISKS: 0 -COPPER: 0 -SFP: 0 diff --git a/salt/setup/virt/heavynode.yaml b/salt/setup/virt/heavynode.yaml deleted file mode 100644 index a3550021f..000000000 --- a/salt/setup/virt/heavynode.yaml +++ /dev/null @@ -1,18 +0,0 @@ -MAINIP: -MNIC: enp1s0 -NODE_DESCRIPTION: 'vm' -ES_HEAP_SIZE: -PATCHSCHEDULENAME: -INTERFACE: bond0 -NODETYPE: HEAVYNODE -CORECOUNT: 8 -LSHOSTNAME: -LSHEAP: -CPUCORES: 8 -IDH_MGTRESTRICT: -IDH_SERVICES: -CPU: 8 -MEMORY: 16 -DISKS: 0 -COPPER: 0 -SFP: 0 diff --git a/salt/setup/virt/idh.yaml b/salt/setup/virt/idh.yaml deleted file mode 100644 index 201262db8..000000000 --- a/salt/setup/virt/idh.yaml +++ /dev/null @@ -1,18 +0,0 @@ -MAINIP: -MNIC: enp1s0 -NODE_DESCRIPTION: 'vm' -ES_HEAP_SIZE: -PATCHSCHEDULENAME: -INTERFACE: -NODETYPE: IDH -CORECOUNT: 2 -LSHOSTNAME: -LSHEAP: -CPUCORES: 2 -IDH_MGTRESTRICT: -IDH_SERVICES: -CPU: 2 -MEMORY: 1 -DISKS: 0 -COPPER: 0 -SFP: 0 diff --git a/salt/setup/virt/receiver.yaml b/salt/setup/virt/receiver.yaml deleted file mode 100644 index e5dc0b0e7..000000000 --- a/salt/setup/virt/receiver.yaml +++ /dev/null @@ -1,18 +0,0 @@ -MAINIP: -MNIC: enp1s0 -NODE_DESCRIPTION: 'vm' -ES_HEAP_SIZE: -PATCHSCHEDULENAME: -INTERFACE: -NODETYPE: RECEIVER -CORECOUNT: 2 -LSHOSTNAME: -LSHEAP: -CPUCORES: 2 -IDH_MGTRESTRICT: -IDH_SERVICES: -CPU: 2 -MEMORY: 8 -DISKS: 0 -COPPER: 0 -SFP: 0 diff --git a/salt/setup/virt/searchnode.yaml b/salt/setup/virt/searchnode.yaml deleted file mode 100644 index 032e0e855..000000000 --- a/salt/setup/virt/searchnode.yaml +++ /dev/null @@ -1,18 +0,0 @@ -MAINIP: -MNIC: enp1s0 -NODE_DESCRIPTION: 'vm' -ES_HEAP_SIZE: -PATCHSCHEDULENAME: -INTERFACE: -NODETYPE: SEARCHNODE -CORECOUNT: 8 -LSHOSTNAME: -LSHEAP: -CPUCORES: 8 -IDH_MGTRESTRICT: -IDH_SERVICES: -CPU: 8 -MEMORY: 16 -DISKS: 1 -COPPER: 0 -SFP: 0 diff --git a/salt/setup/virt/sensor.yaml b/salt/setup/virt/sensor.yaml deleted file mode 100644 index 9136f0b78..000000000 --- a/salt/setup/virt/sensor.yaml +++ /dev/null @@ -1,18 +0,0 @@ -MAINIP: -MNIC: enp1s0 -NODE_DESCRIPTION: 'vm' -ES_HEAP_SIZE: -PATCHSCHEDULENAME: -INTERFACE: bond0 -NODETYPE: SENSOR -CORECOUNT: 4 -LSHOSTNAME: -LSHEAP: -CPUCORES: 4 -IDH_MGTRESTRICT: -IDH_SERVICES: -CPU: 8 -MEMORY: 12 -DISKS: 0 -COPPER: 0 -SFP: 0 diff --git a/salt/setup/virt/soinstall.map.jinja b/salt/setup/virt/soinstall.map.jinja index 1d70ac67e..d839235b0 100644 --- a/salt/setup/virt/soinstall.map.jinja +++ b/salt/setup/virt/soinstall.map.jinja @@ -40,12 +40,9 @@ {# Calculate reasonable core usage #} {% set cores_for_zeek = (DATA.CPUCORES / 2) - 1 %} -{% do salt.log.info('cores_for_zeek calculation using CPUCORES: ' ~ DATA.CPUCORES|string) %} -{% do salt.log.info('cores_for_zeek: ' ~ cores_for_zeek|string) %} {% set lb_procs_round = cores_for_zeek|round|int %} -{% do salt.log.info('lb_procs_round: ' ~ lb_procs_round|string) %} {% set lb_procs = 1 if lb_procs_round < 1 else lb_procs_round %} -{% do salt.log.info('lb_procs: ' ~ lb_procs|string) %} +{% do salt.log.info('Cores for load balancing: ' ~ lb_procs|string) %} {# Check memory conditions #} {% set low_mem = false %} {% do salt.log.info('Memory check using total_mem: ' ~ total_mem|string) %} diff --git a/salt/setup/virt/sominion.sls b/salt/setup/virt/sominion.sls index e0598a4d3..70acb52db 100644 --- a/salt/setup/virt/sominion.sls +++ b/salt/setup/virt/sominion.sls @@ -13,11 +13,14 @@ create_pillar: MAINIP: {{ DATA.MAINIP }} MNIC: {{ DATA.MNIC }} NODE_DESCRIPTION: '{{ DATA.NODE_DESCRIPTION }}' - INTERFACE: {{ DATA.INTERFACE }} NODETYPE: {{ DATA.NODETYPE }} + CPUCORES: {{ DATA.CPUCORES }} {% if 'CORECOUNT' in DATA %} CORECOUNT: {{ DATA.CORECOUNT }} {% endif %} + {% if 'INTERFACE' in DATA %} + INTERFACE: {{ DATA.INTERFACE }} + {% endif %} {% if 'ES_HEAP_SIZE' in DATA %} ES_HEAP_SIZE: {{ DATA.ES_HEAP_SIZE }} {% endif %} From 2c5861a0c2af8ac2bfecafc722ed83cf1340aaae Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 5 Mar 2025 08:51:10 -0500 Subject: [PATCH 150/303] ensure local hypervisor dir when new hypervisor key accepted. apply soc.dyanno.hypervisor when hypervisor key accepted --- salt/_runners/setup_hypervisor.py | 172 +++++++++++++++++- salt/hypervisor/map.jinja | 4 +- salt/orch/dyanno_hypervisor.sls | 10 + salt/soc/dyanno/hypervisor/init.sls | 1 + .../hypervisor/soc_hypervisor.yaml.jinja | 6 +- 5 files changed, 187 insertions(+), 6 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index c06439eab..782419d27 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -163,6 +163,7 @@ def _validate_image_checksum(path, expected_sha256): IMAGE_URL = "https://yum.oracle.com/templates/OracleLinux/OL9/u5/x86_64/OL9U5_x86_64-kvm-b253.qcow2" IMAGE_SHA256 = "3b00bbbefc8e78dd28d9f538834fb9e2a03d5ccdc2cadf2ffd0036c0a8f02021" IMAGE_PATH = "/nsm/libvirt/boot/OL9U5_x86_64-kvm-b253.qcow2" +MANAGER_HOSTNAME = socket.gethostname() def _download_image(): """ @@ -332,6 +333,135 @@ def _check_vm_exists(vm_name: str) -> bool: log.info("MAIN: VM %s already exists", vm_name) return exists +def _ensure_hypervisor_host_dir(minion_id: str = None): + """ + Ensure the hypervisor host directory exists. + + This function creates the directory structure for a hypervisor host if it doesn't exist. + The path is: /opt/so/saltstack/local/salt/hypervisor/hosts/ + + Args: + minion_id (str, optional): Salt minion ID of the hypervisor. + + Returns: + bool: True if directory exists or was created successfully, False otherwise + """ + if not minion_id: + log.warning("HOSTDIR: No minion_id provided, skipping host directory creation") + return True + + try: + # Extract hostname from minion_id by removing role suffix (anything after first underscore) + hostname = minion_id.split('_', 1)[0] if '_' in minion_id else minion_id + + # Define the directory path + host_dir = f'/opt/so/saltstack/local/salt/hypervisor/hosts/{hostname}' + + # Check if directory exists and create it if it doesn't + if os.path.exists(host_dir): + log.info(f"HOSTDIR: Hypervisor host directory already exists: {host_dir}") + # Create the VMs file if it doesn't exist + vms_file = f'/opt/so/saltstack/local/salt/hypervisor/hosts/{hostname}VMs' + if not os.path.exists(vms_file): + with salt.utils.files.fopen(vms_file, 'w') as f: + f.write('[]') + log.info(f"HOSTDIR: Created empty VMs file: {vms_file}") + + # Set proper ownership for the VMs file + try: + socore_uid = pwd.getpwnam('socore').pw_uid + socore_gid = pwd.getpwnam('socore').pw_gid + os.chown(vms_file, socore_uid, socore_gid) + log.info(f"HOSTDIR: Set ownership to socore:socore for {vms_file}") + except (KeyError, Exception) as e: + log.warning(f"HOSTDIR: Failed to set ownership for VMs file: {str(e)}") + return True + + # Create all necessary parent directories + os.makedirs(host_dir, exist_ok=True) + log.info(f"HOSTDIR: Created hypervisor host directory: {host_dir}") + + # Create the VMs file with an empty JSON array + vms_file = f'/opt/so/saltstack/local/salt/hypervisor/hosts/{hostname}VMs' + with salt.utils.files.fopen(vms_file, 'w') as f: + f.write('[]') + log.info(f"HOSTDIR: Created empty VMs file: {vms_file}") + + # Set proper ownership (socore:socore) + try: + socore_uid = pwd.getpwnam('socore').pw_uid + socore_gid = pwd.getpwnam('socore').pw_gid + os.chown(host_dir, socore_uid, socore_gid) + os.chown(vms_file, socore_uid, socore_gid) + + # Also set ownership for parent directories if they were just created + parent_dir = os.path.dirname(host_dir) # /opt/so/saltstack/local/salt/hypervisor/hosts + if os.path.exists(parent_dir): + os.chown(parent_dir, socore_uid, socore_gid) + + parent_dir = os.path.dirname(parent_dir) # /opt/so/saltstack/local/salt/hypervisor + if os.path.exists(parent_dir): + os.chown(parent_dir, socore_uid, socore_gid) + + log.info(f"HOSTDIR: Set ownership to socore:socore for {host_dir} and {vms_file}") + except KeyError: + log.warning("HOSTDIR: socore user not found, skipping ownership change") + except Exception as e: + log.warning(f"HOSTDIR: Failed to set ownership: {str(e)}") + + return True + except Exception as e: + log.error(f"HOSTDIR: Error creating hypervisor host directory: {str(e)}") + return False + +def _apply_dyanno_hypervisor_state(): + """ + Apply the soc.dyanno.hypervisor state on the salt master. + + This function applies the soc.dyanno.hypervisor state on the salt master + to update the hypervisor annotation and ensure all hypervisor host directories exist. + + Returns: + bool: True if state was applied successfully, False otherwise + """ + try: + log.info("DYANNO: Applying soc.dyanno.hypervisor state on salt master") + + # Initialize the LocalClient + local = salt.client.LocalClient() + + # Target the salt master (localhost) to apply the soc.dyanno.hypervisor state + target = MANAGER_HOSTNAME + '_*' + state_result = local.cmd(target, 'state.apply', ['soc.dyanno.hypervisor'], tgt_type='glob', concurrent=True) + log.debug(f"DYANNO: state_result: {state_result}") + # Check if state was applied successfully + if state_result: + success = True + for minion, states in state_result.items(): + if not isinstance(states, dict): + log.error(f"DYANNO: Unexpected result format from {minion}: {states}") + success = False + continue + + for state_id, state_data in states.items(): + if not state_data.get('result', False): + log.error(f"DYANNO: State {state_id} failed on {minion}: {state_data.get('comment', 'No comment')}") + success = False + + if success: + log.info("DYANNO: Successfully applied soc.dyanno.hypervisor state") + return True + else: + log.error("DYANNO: Failed to apply soc.dyanno.hypervisor state") + return False + else: + log.error("DYANNO: No response from salt master when applying soc.dyanno.hypervisor state") + return False + + except Exception as e: + log.error(f"DYANNO: Error applying soc.dyanno.hypervisor state: {str(e)}") + return False + def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id: str = None): """ Main entry point to set up the hypervisor environment. @@ -380,6 +510,43 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id 'vm_result': None } + # Ensure hypervisor host directory exists + if not _ensure_hypervisor_host_dir(minion_id): + return { + 'success': False, + 'error': 'Failed to create hypervisor host directory', + 'vm_result': None + } + + # Initialize the LocalClient + local = salt.client.LocalClient() + + # Add retry logic for mine.update + max_retries = 10 + retry_delay = 3 + mine_update_success = False + + for attempt in range(1, max_retries + 1): + mine_update_result = local.cmd(minion_id, 'mine.update') + log.debug(f"DYANNO: mine_update_result: {mine_update_result}") + + # Check if mine.update was successful + if mine_update_result and all(mine_update_result.values()): + log.info(f"DYANNO: mine.update successful on attempt {attempt}") + mine_update_success = True + break + else: + log.warning(f"DYANNO: mine.update failed on attempt {attempt}/{max_retries}, retrying in {retry_delay} seconds...") + time.sleep(retry_delay) + + if not mine_update_success: + log.error(f"DYANNO: mine.update failed after {max_retries} attempts") + + # Apply the soc.dyanno.hypervisor state on the salt master + if not _apply_dyanno_hypervisor_state(): + log.warning("MAIN: Failed to apply soc.dyanno.hypervisor state, continuing with setup") + # We don't return an error here as we want to continue with the setup process + log.info("MAIN: Starting setup_environment in setup_hypervisor runner") # Check if environment is already set up @@ -548,9 +715,6 @@ def create_vm(vm_name: str, disk_size: str = '220G'): log.error("CREATEVM: Failed to read SSH public key: %s", str(e)) return {'success': False, 'error': 'Failed to read SSH public key'} - # Get hostname for repo configuration - manager_hostname = socket.gethostname() - # Read and encode GPG keys keys_dir = '/opt/so/saltstack/default/salt/repo/client/files/oracle/keys' oracle_key = _read_and_encode_key(os.path.join(keys_dir, 'RPM-GPG-KEY-oracle')) @@ -607,7 +771,7 @@ write_files: content: | [securityonion] name=Security Onion Repo - baseurl=https://{manager_hostname}/repo + baseurl=https://{MANAGER_HOSTNAME}/repo enabled=1 gpgcheck=1 sslverify=0 diff --git a/salt/hypervisor/map.jinja b/salt/hypervisor/map.jinja index 3d08b15d5..d19aacf48 100644 --- a/salt/hypervisor/map.jinja +++ b/salt/hypervisor/map.jinja @@ -39,7 +39,9 @@ {% set vm_list = [] %} {% set vm_list_file = 'hypervisor/hosts/' ~ hypervisor ~ 'VMs' %} {% do salt.log.info('salt/hypervisor/map.jinja: VM list file: ' ~ vm_list_file) %} - {% import_json vm_list_file as vm_list %} + {% if salt['file.file_exists']('/opt/so/saltstack/local/salt/' ~ vm_list_file) %} + {% import_json vm_list_file as vm_list %} + {% endif %} {% if vm_list %} {% do salt.log.info('salt/hypervisor/map.jinja: VM list content: ' ~ vm_list | tojson) %} {% else %} diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index c298a6101..c9ba20115 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -95,6 +95,16 @@ write_vm_status: status: {{ status }} event_tag: {{ tag }} +{# Check if the base domain exists / is ready for VMs #} +{#% set file_exists = False %} +{% set ret = salt.saltutil.runner('salt.execute', [hypervisor ~ '_*','file.file_exists', ['/nsm/libvirt/images/sool9/sool9.qcow2'], 'glob']) %} +{% do salt.log.debug('dyanno_hypervisor_orch: File /nsm/libvirt/images/sool9/sool9.qcow2 exists: ' ~ ret) %} +{% for minion, file_exists in ret.items() %} +{% if minion.startswith(hypervisor ~ '_') %} +{% do salt.log.info('dyanno_hypervisor_orch: File /nsm/libvirt/images/sool9/sool9.qcow2 exists: ' ~ file_exists) %} +{% endif %} +{% endfor %#} + # Update hypervisor status update_hypervisor_annotation: salt.state: diff --git a/salt/soc/dyanno/hypervisor/init.sls b/salt/soc/dyanno/hypervisor/init.sls index f29ef0367..5d3e3ae45 100644 --- a/salt/soc/dyanno/hypervisor/init.sls +++ b/salt/soc/dyanno/hypervisor/init.sls @@ -22,6 +22,7 @@ hypervisor_annotation: - group: socore - defaults: HYPERVISORS: {{ HYPERVISORS }} + base_domain_ready: {{ salt['pillar.get']('base_domain_ready', False) }} {% for role in HYPERVISORS %} {% for hypervisor in HYPERVISORS[role].keys() %} diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index c3eeee689..f90e3b579 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -174,7 +174,11 @@ No Virtual Machines Found {%- endif -%} {%- do updated_elements.append(updated_field) -%} {%- endfor -%} -{%- do updated_template.update({'uiElements': updated_elements}) -%} +{%- if base_domain_ready -%} +{%- do updated_template.update({'uiElements': updated_elements}) -%} +{%- else -%} +{%- do updated_template.pop('uiElements') -%} +{%- endif -%} {%- do updated_template.update({ 'title': hypervisor, 'description': update_description( From f30938ed59f4f9bdaf2e8d425a1f309260a2efee Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 6 Mar 2025 15:26:08 -0500 Subject: [PATCH 151/303] hypervisor annotation show if base domain is initialized or not --- salt/_runners/setup_hypervisor.py | 4 +-- salt/libvirt/images/init.sls | 11 ++++++ salt/orch/dyanno_hypervisor.sls | 34 ++++++++++++------ salt/salt/minion.sls | 5 --- salt/soc/dyanno/hypervisor/init.sls | 2 +- .../hypervisor/soc_hypervisor.yaml.example | 36 ------------------- .../hypervisor/soc_hypervisor.yaml.jinja | 26 ++++++++------ 7 files changed, 53 insertions(+), 65 deletions(-) delete mode 100644 salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 782419d27..6b3f289e8 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -430,9 +430,9 @@ def _apply_dyanno_hypervisor_state(): # Initialize the LocalClient local = salt.client.LocalClient() - # Target the salt master (localhost) to apply the soc.dyanno.hypervisor state + # Target the salt master to apply the soc.dyanno.hypervisor state target = MANAGER_HOSTNAME + '_*' - state_result = local.cmd(target, 'state.apply', ['soc.dyanno.hypervisor'], tgt_type='glob', concurrent=True) + state_result = local.cmd(target, 'state.apply', ['soc.dyanno.hypervisor', "pillar={'baseDomain': {'status': 'PreInit'}}", 'concurrent=True'], tgt_type='glob') log.debug(f"DYANNO: state_result: {state_result}") # Check if state was applied successfully if state_result: diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 70e668ffb..91350de42 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -157,6 +157,17 @@ configure_network_predictable_sool9: - onchanges: - cmd: create_vm_sool9 +# Fire event here that causes soc.dyanno.hypervisor state to be applied +base_domain_ready: + event.send: + - name: soc/dyanno/hypervisor/baseDomain + - data: + status: 'Initialized' + - require: + - cmd: configure_network_predictable_sool9 + - onchanges: + - cmd: create_vm_sool9 + {% else %} {{sls}}_no_license_detected: test.fail_without_changes: diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index c9ba20115..fa6a2f2ff 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -11,6 +11,16 @@ {% if 'hvn' in salt['pillar.get']('features', []) %} +{% do salt.log.info('dyanno_hypervisor_orch: Running') %} +{% set vm_name = None %} +{% set hypervisor = None %} +{% set status = None %} +{% set data = pillar.get('data', {}) %} +{% set tag = pillar.get('tag', '') %} +{% set timestamp = data.get('_stamp') %} +{% do salt.log.debug('dyanno_hypervisor_orch: tag: ' ~ tag) %} +{% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ data|json|string) %} + {# Macro to find hypervisor name from VM status file #} {% macro find_hypervisor_from_status(vm_name) -%} {%- set path = salt['file.find']('/opt/so/saltstack/local/salt/hypervisor/hosts/',type='f', name=vm_name ~ '.status') -%} @@ -28,22 +38,17 @@ {%- endif -%} {%- endmacro %} -{% do salt.log.info('dyanno_hypervisor_orch: Running') %} - -{% set data = pillar.get('data', {}) %} -{% set tag = pillar.get('tag', '') %} -{% set timestamp = data.get('_stamp') %} -{% do salt.log.debug('dyanno_hypervisor_orch: tag: ' ~ tag) %} -{% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ data|json|string) %} - {# Our custom tag #} {% if tag.startswith('soc/dyanno/hypervisor') %} {% set status_data = data.get('data')%} {% do salt.log.debug('dyanno_hypervisor_orch: Received data: ' ~ status_data|json|string) %} -{% do salt.log.debug('dyanno_hypervisor_orch: Setting vm_name, hypervisor and status') %} -{% set vm_name = status_data.get('vm_name') %} -{% set hypervisor = status_data.get('hypervisor') %} +{% if not tag.endswith('/baseDomain') %} +{% do salt.log.debug('dyanno_hypervisor_orch: Setting vm_name, hypervisor and status') %} +{% set vm_name = status_data.get('vm_name') %} +{% set hypervisor = status_data.get('hypervisor') %} +{% endif %} {% set status = status_data.get('status') %} +{% set hypervisor = data.get('id') %} {% endif %} {# setup/so-minion tag #} @@ -80,6 +85,7 @@ {% do salt.log.info('dyanno_hypervisor_orch: vm_name: ' ~ vm_name ~ ' hypervisor: ' ~ hypervisor ~ ' status: ' ~ status) %} +{% if vm_name and hypervisor and timestamp and status and tag %} write_vm_status: salt.state: - tgt: 'G@role:so-manager or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' @@ -94,6 +100,7 @@ write_vm_status: timestamp: {{ timestamp }} status: {{ status }} event_tag: {{ tag }} +{% endif %} {# Check if the base domain exists / is ready for VMs #} {#% set file_exists = False %} @@ -113,6 +120,11 @@ update_hypervisor_annotation: - sls: - soc.dyanno.hypervisor - concurrent: True +{% if tag == ('soc/dyanno/hypervisor/baseDomain') %} + - pillar: + baseDomain: + status: {{ status }} +{% endif %} {% do salt.log.info('dyanno_hypervisor_orch: Completed') %} diff --git a/salt/salt/minion.sls b/salt/salt/minion.sls index de0f35c50..1402bea5e 100644 --- a/salt/salt/minion.sls +++ b/salt/salt/minion.sls @@ -83,11 +83,6 @@ enable_startup_states: - regex: '^startup_states: highstate$' - unless: pgrep so-setup -# manager with hypervisors with need this beacon added to the minion config -#beacons: -# add_virtual_node_beacon: -# - base_path: /opt/so/saltstack/local/salt/hypervisor/hosts/*/add_* - # prior to 2.4.30 this managed file would restart the salt-minion service when updated # since this file is currently only adding a sleep timer on service start # it is not required to restart the service diff --git a/salt/soc/dyanno/hypervisor/init.sls b/salt/soc/dyanno/hypervisor/init.sls index 5d3e3ae45..e4ce3b47c 100644 --- a/salt/soc/dyanno/hypervisor/init.sls +++ b/salt/soc/dyanno/hypervisor/init.sls @@ -22,7 +22,7 @@ hypervisor_annotation: - group: socore - defaults: HYPERVISORS: {{ HYPERVISORS }} - base_domain_ready: {{ salt['pillar.get']('base_domain_ready', False) }} + baseDomainStatus: {{ salt['pillar.get']('baseDomain:status', 'Initialized') }} {% for role in HYPERVISORS %} {% for hypervisor in HYPERVISORS[role].keys() %} diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example deleted file mode 100644 index 902d9b1b1..000000000 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.example +++ /dev/null @@ -1,36 +0,0 @@ -# This is the start of an example of what this file will look like. It will be generated by Salt, so this yaml file is not used by Salt. -hypervisor: - hosts: - jpphype1VMs: - description: Hypervisor Configuration - file: true - global: true - syntax: json - title: jpphype1 - uiElements: - - field: hostname - label: Enter the hostname - - field: role - label: sensor or searchnode - - field: network_mode - label: Choose static4 or dhcp4. If static4, populate IP details below. - - field: ip4 - label: IP Address with netmask. ex. 192.168.1.10/24 - - field: gw4 - label: Gateway - - field: dns4 - label: DNS. Comma separated list. ex. 192.168.1.1,8.8.8.8 - - field: search4 - label: Search domain - - field: cpu - label: 'CPU cores to assign. Free: 120 | Total: 128' - - field: memory - label: 'Memory to assign, in GB. Free: 112 | Total: 128' - - field: disk - label: 'Disk(s) for passthrough. Comma separated list. Free: 2 | Total: 1,2' - - field: copper - label: 'Copper port(s) for passthrough. Comma separated list. Free: 3,4 | - Total: 1,2,3,4' - - field: sfp - label: 'SFP port(s) for passthrough. Comma separated list. Free: 5,6,7,8 | - Total: 5,6,7,8' diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index f90e3b579..17603ab9d 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -24,26 +24,32 @@ | Available | {{ cpu_free }} | {{ mem_free }} | {{ disk_free | replace('\n', ',') if disk_free else 'None' }} | {{ copper_free | replace('\n', ',') if copper_free else 'None' }} | {{ sfp_free | replace('\n', ',') if sfp_free else 'None' }} | | Total | {{ cpu_total }} | {{ mem_total }} | {{ disk_total | replace('\n', ',') }} | {{ copper_total | replace('\n', ',') }} | {{ sfp_total | replace('\n', ',') }} | -{%- if vm_list %} +{%- if baseDomainStatus == 'Initialized' %} +{%- if vm_list %} #### Virtual Machines Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. "Last Updated" shows when status changed. After "Highstate Triggered", only "Destroyed Instance" updates the timestamp. | Name | Status | CPU Cores | Memory (GB)| Disk | Copper | SFP | Last Updated | |--------------------|--------------------|-----------|------------|------|--------|------|---------------------| -{%- for hostname, vm_data in vm_list.items() %} -{%- set vm_status = vm_data.get('status', {}).get('status', 'Unknown') %} -{%- set is_destroyed = vm_status == 'Destroyed Instance' %} -{%- if is_destroyed %} +{%- for hostname, vm_data in vm_list.items() %} +{%- set vm_status = vm_data.get('status', {}).get('status', 'Unknown') %} +{%- set is_destroyed = vm_status == 'Destroyed Instance' %} +{%- if is_destroyed %} | {{ hostname }} | {{ vm_status }} | - | - | - | - | - | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | -{%- else %} +{%- else %} | {{ hostname }} | {{ vm_status }} | {{ vm_data.get('config', {}).get('cpu', 'N/A') }} | {{ vm_data.get('config', {}).get('memory', 'N/A') }} | {{ vm_data.get('config', {}).get('disk', []) | join(',') if vm_data.get('config', {}).get('disk') else '-' }} | {{ vm_data.get('config', {}).get('copper', []) | join(',') if vm_data.get('config', {}).get('copper') else '-' }} | {{ vm_data.get('config', {}).get('sfp', []) | join(',') if vm_data.get('config', {}).get('sfp') else '-' }} | {{ vm_data.get('status', {}).get('timestamp', 'Never') | replace('T', ' ') | regex_replace('\\.[0-9]+', '') }} | -{%- endif %} -{%- endfor %} -{%- else %} +{%- endif %} +{%- endfor %} +{%- else %} #### Virtual Machines Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. "Last Updated" shows when status changed. After "Highstate Triggered", only "Destroyed Instance" updates the timestamp. No Virtual Machines Found +{%- endif %} +{%- else %} +#### WARNING + +Base domain has not been initialized. {%- endif %} {%- endmacro -%} @@ -174,7 +180,7 @@ No Virtual Machines Found {%- endif -%} {%- do updated_elements.append(updated_field) -%} {%- endfor -%} -{%- if base_domain_ready -%} +{%- if baseDomainStatus == 'Initialized' %} {%- do updated_template.update({'uiElements': updated_elements}) -%} {%- else -%} {%- do updated_template.pop('uiElements') -%} From c66cd3b2f3c25880b8c440c14fa50c20ff7dec64 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 10 Mar 2025 11:23:26 -0400 Subject: [PATCH 152/303] ensure image is readded if removed --- salt/libvirt/images/init.sls | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 91350de42..94cf4959d 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -16,6 +16,12 @@ include: - libvirt.packages +# Remove hash file if image isn't present. This will allow for the image to redownload and initialize. +remove_sha256_sool9: + file.absent: + - name: /nsm/libvirt/images/sool9/sool9.sha256 + - unless: test -f /nsm/libvirt/images/sool9/sool9.qcow2 + # Manage SHA256 hash file manage_sha256_sool9: file.managed: From c784a6e4409883791224aac836e8de0db5e7b414 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 10 Mar 2025 16:55:02 -0400 Subject: [PATCH 153/303] fix setting hypervisor for our custom event tag --- salt/orch/dyanno_hypervisor.sls | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index fa6a2f2ff..8af529a5f 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -46,9 +46,10 @@ {% do salt.log.debug('dyanno_hypervisor_orch: Setting vm_name, hypervisor and status') %} {% set vm_name = status_data.get('vm_name') %} {% set hypervisor = status_data.get('hypervisor') %} +{% else %} +{% set hypervisor = data.get('id') %} {% endif %} {% set status = status_data.get('status') %} -{% set hypervisor = data.get('id') %} {% endif %} {# setup/so-minion tag #} From ae993c47c15195adb01bc316cbbe48ad9f707e23 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 11 Mar 2025 11:12:45 -0400 Subject: [PATCH 154/303] remove minion pillar files when a vm is destroyed --- salt/orch/dyanno_hypervisor.sls | 10 ---------- salt/orch/vm_pillar_clean.sls | 35 +++++++++++++++++++++++++++++++++ salt/reactor/deleteKey.sls | 9 ++++++++- 3 files changed, 43 insertions(+), 11 deletions(-) create mode 100644 salt/orch/vm_pillar_clean.sls diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index 8af529a5f..624bb12f3 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -103,16 +103,6 @@ write_vm_status: event_tag: {{ tag }} {% endif %} -{# Check if the base domain exists / is ready for VMs #} -{#% set file_exists = False %} -{% set ret = salt.saltutil.runner('salt.execute', [hypervisor ~ '_*','file.file_exists', ['/nsm/libvirt/images/sool9/sool9.qcow2'], 'glob']) %} -{% do salt.log.debug('dyanno_hypervisor_orch: File /nsm/libvirt/images/sool9/sool9.qcow2 exists: ' ~ ret) %} -{% for minion, file_exists in ret.items() %} -{% if minion.startswith(hypervisor ~ '_') %} -{% do salt.log.info('dyanno_hypervisor_orch: File /nsm/libvirt/images/sool9/sool9.qcow2 exists: ' ~ file_exists) %} -{% endif %} -{% endfor %#} - # Update hypervisor status update_hypervisor_annotation: salt.state: diff --git a/salt/orch/vm_pillar_clean.sls b/salt/orch/vm_pillar_clean.sls new file mode 100644 index 000000000..5c0011f6f --- /dev/null +++ b/salt/orch/vm_pillar_clean.sls @@ -0,0 +1,35 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'hvn' in salt['pillar.get']('features', []) %} + +{% do salt.log.debug('vm_pillar_clean_orch: Running') %} +{% set vm_name = pillar.get('vm_name') %} + +delete_adv_{{ vm_name }}_pillar: + module.run: + - file.remove: + - path: /opt/so/saltstack/local/pillar/minions/adv_{{ vm_name }}.sls + +delete_{{ vm_name }}_pillar: + module.run: + - file.remove: + - path: /opt/so/saltstack/local/pillar/minions/{{ vm_name }}.sls + +{% else %} + +{% do salt.log.error( + 'Hypervisor nodes are a feature supported only for customers with a valid license.' + 'Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com' + 'for more information about purchasing a license to enable this feature.' +) %} + +{% endif %} diff --git a/salt/reactor/deleteKey.sls b/salt/reactor/deleteKey.sls index 646e17948..4d522a4b5 100644 --- a/salt/reactor/deleteKey.sls +++ b/salt/reactor/deleteKey.sls @@ -1,5 +1,5 @@ # Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. @@ -8,4 +8,11 @@ remove_key: - args: - match: {{ data['name'] }} +{{ data['name'] }}_pillar_clean: + runner.state.orchestrate: + - args: + - mods: orch.vm_pillar_clean + - pillar: + vm_name: {{ data['name'] }} + {% do salt.log.info('deleteKey reactor: deleted minion key: %s' % data['name']) %} From 44a5b3b1e50c737663e20d90c7a78804e744e657 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 12 Mar 2025 21:05:04 -0400 Subject: [PATCH 155/303] MANAGERHYPE setup is now complete! --- pillar/top.sls | 2 +- salt/allowed_states.map.jinja | 423 +++++++++++----------------- salt/common/init.sls | 2 +- salt/elasticfleet/config.sls | 2 +- salt/elasticsearch/config.map.jinja | 2 +- salt/elasticsearch/defaults.yaml | 8 + salt/elasticsearch/enabled.sls | 2 +- salt/firewall/defaults.yaml | 210 ++++++++++++++ salt/logstash/defaults.yaml | 2 + salt/logstash/enabled.sls | 24 +- salt/manager/tools/sbin/so-minion | 17 ++ salt/nginx/enabled.sls | 4 +- salt/nginx/etc/nginx.conf | 4 +- salt/repo/client/oracle.sls | 2 +- salt/ssl/init.sls | 12 +- salt/telegraf/defaults.yaml | 9 + salt/top.sls | 8 +- salt/vars/globals.map.jinja | 1 + salt/vars/hypervisor.map.jinja | 8 +- salt/vars/managerhype.map.jinja | 8 + setup/so-functions | 10 +- setup/so-setup | 23 ++ setup/so-whiptail | 7 +- 23 files changed, 493 insertions(+), 297 deletions(-) create mode 100644 salt/vars/managerhype.map.jinja diff --git a/pillar/top.sls b/pillar/top.sls index bd78b5712..6a2311a64 100644 --- a/pillar/top.sls +++ b/pillar/top.sls @@ -27,7 +27,7 @@ base: - nginx.adv_nginx - node_data.ips - '*_manager or *_managersearch': + '*_manager or *_managersearch or *_managerhype': - match: compound {% if salt['file.file_exists']('/opt/so/saltstack/local/pillar/elasticsearch/auth.sls') %} - elasticsearch.auth diff --git a/salt/allowed_states.map.jinja b/salt/allowed_states.map.jinja index bfa7ebe50..af9bcaa5d 100644 --- a/salt/allowed_states.map.jinja +++ b/salt/allowed_states.map.jinja @@ -7,271 +7,174 @@ {% import_yaml 'salt/minion.defaults.yaml' as saltversion %} {% set saltversion = saltversion.salt.minion.version %} -{# this is the list we are returning from this map file, it gets built below #} -{% set allowed_states= [] %} +{# Define common state groups to reduce redundancy #} +{% set base_states = [ + 'common', + 'patch.os.schedule', + 'motd', + 'salt.minion-check', + 'sensoroni', + 'salt.lasthighstate', + 'salt.minion' +] %} + +{% set ssl_states = [ + 'ssl', + 'telegraf', + 'firewall', + 'schedule', + 'docker_clean' +] %} + +{% set manager_states = [ + 'salt.master', + 'ca', + 'registry', + 'manager', + 'nginx', + 'influxdb', + 'soc', + 'kratos', + 'hydra', + 'elasticfleet', + 'elastic-fleet-package-registry', + 'idstools', + 'suricata.manager', + 'utility' +] %} + +{% set sensor_states = [ + 'pcap', + 'suricata', + 'healthcheck', + 'tcpreplay' +] %} + +{% set kafka_states = [ + 'kafka' +] %} + +{% set stig_states = [ + 'stig' +] %} + +{% set elastic_stack_states = [ + 'elasticsearch', + 'elasticsearch.auth', + 'kibana', + 'kibana.secrets', + 'elastalert', + 'logstash', + 'redis' +] %} + +{# Initialize the allowed_states list #} +{% set allowed_states = [] %} {% if grains.saltversion | string == saltversion | string %} + {# Map role-specific states #} + {% set role_states = { + 'so-eval': ( + ssl_states + + manager_states + + sensor_states + + elastic_stack_states + ), + 'so-heavynode': ( + ssl_states + + sensor_states + + ['elasticagent', 'zeek', 'strelka'] + + ['elasticsearch', 'logstash', 'redis'] + + stig_states + ), + 'so-idh': ( + ssl_states + + ['idh'] + ), + 'so-import': ( + ssl_states + + manager_states + + sensor_states + + ['zeek'] + + ['elasticsearch', 'elasticsearch.auth', 'kibana', 'kibana.secrets'] + ), + 'so-manager': ( + ssl_states + + manager_states + + ['salt.cloud', 'libvirt.packages', 'libvirt.ssh.users', 'strelka.manager'] + + stig_states + + kafka_states + + elastic_stack_states + ), + 'so-managerhype': ( + ssl_states + + manager_states + + ['salt.cloud', 'strelka.manager', 'hypervisor', 'libvirt'] + + stig_states + + kafka_states + + elastic_stack_states + ), + 'so-managersearch': ( + ssl_states + + manager_states + + ['strelka.manager'] + + stig_states + + kafka_states + + elastic_stack_states + ), + 'so-searchnode': ( + ssl_states + + ['kafka.ca', 'kafka.ssl', 'elasticsearch', 'logstash'] + + stig_states + ), + 'so-standalone': ( + ssl_states + + manager_states + + sensor_states + + stig_states + + kafka_states + + elastic_stack_states + + ['zeek', 'strelka'] + ), + 'so-sensor': ( + ssl_states + + sensor_states + + ['nginx', 'zeek', 'strelka'] + + stig_states + ), + 'so-fleet': ( + ssl_states + + ['logstash', 'nginx', 'healthcheck', 'elasticfleet'] + ), + 'so-receiver': ( + ssl_states + + kafka_states + + stig_states + + ['logstash', 'redis'] + ), + 'so-hypervisor': ( + ssl_states + + stig_states + + ['hypervisor', 'libvirt'] + ), + 'so-desktop': ( + ['ssl', 'docker_clean', 'telegraf'] + + stig_states + ) + } %} - {% set allowed_states= salt['grains.filter_by']({ - 'so-eval': [ - 'salt.master', - 'ca', - 'ssl', - 'registry', - 'manager', - 'nginx', - 'telegraf', - 'influxdb', - 'soc', - 'kratos', - 'hydra', - 'elasticfleet', - 'elastic-fleet-package-registry', - 'firewall', - 'idstools', - 'suricata.manager', - 'healthcheck', - 'pcap', - 'suricata', - 'utility', - 'schedule', - 'tcpreplay', - 'docker_clean' - ], - 'so-heavynode': [ - 'ssl', - 'nginx', - 'telegraf', - 'firewall', - 'pcap', - 'suricata', - 'healthcheck', - 'elasticagent', - 'schedule', - 'tcpreplay', - 'docker_clean' - ], - 'so-idh': [ - 'ssl', - 'telegraf', - 'firewall', - 'idh', - 'schedule', - 'docker_clean' - ], - 'so-import': [ - 'salt.master', - 'ca', - 'ssl', - 'registry', - 'manager', - 'nginx', - 'strelka.manager', - 'soc', - 'kratos', - 'hydra', - 'influxdb', - 'telegraf', - 'firewall', - 'idstools', - 'suricata.manager', - 'pcap', - 'utility', - 'suricata', - 'zeek', - 'schedule', - 'tcpreplay', - 'docker_clean', - 'elasticfleet', - 'elastic-fleet-package-registry' - ], - 'so-manager': [ - 'salt.master', - 'salt.cloud', - 'libvirt.packages', - 'libvirt.ssh.users', - 'ca', - 'ssl', - 'registry', - 'manager', - 'nginx', - 'telegraf', - 'influxdb', - 'strelka.manager', - 'soc', - 'kratos', - 'hydra', - 'elasticfleet', - 'elastic-fleet-package-registry', - 'firewall', - 'idstools', - 'suricata.manager', - 'utility', - 'schedule', - 'docker_clean', - 'stig', - 'kafka' - ], - 'so-managersearch': [ - 'salt.master', - 'ca', - 'ssl', - 'registry', - 'nginx', - 'telegraf', - 'influxdb', - 'strelka.manager', - 'soc', - 'kratos', - 'hydra', - 'elastic-fleet-package-registry', - 'elasticfleet', - 'firewall', - 'manager', - 'idstools', - 'suricata.manager', - 'utility', - 'schedule', - 'docker_clean', - 'stig', - 'kafka' - ], - 'so-searchnode': [ - 'ssl', - 'nginx', - 'telegraf', - 'firewall', - 'schedule', - 'docker_clean', - 'stig', - 'kafka.ca', - 'kafka.ssl' - ], - 'so-standalone': [ - 'salt.master', - 'ca', - 'ssl', - 'registry', - 'manager', - 'nginx', - 'telegraf', - 'influxdb', - 'soc', - 'kratos', - 'hydra', - 'elastic-fleet-package-registry', - 'elasticfleet', - 'firewall', - 'idstools', - 'suricata.manager', - 'pcap', - 'suricata', - 'healthcheck', - 'utility', - 'schedule', - 'tcpreplay', - 'docker_clean', - 'stig', - 'kafka' - ], - 'so-sensor': [ - 'ssl', - 'telegraf', - 'firewall', - 'nginx', - 'pcap', - 'suricata', - 'healthcheck', - 'schedule', - 'tcpreplay', - 'docker_clean', - 'stig' - ], - 'so-fleet': [ - 'ssl', - 'telegraf', - 'firewall', - 'logstash', - 'nginx', - 'healthcheck', - 'schedule', - 'elasticfleet', - 'docker_clean' - ], - 'so-receiver': [ - 'ssl', - 'telegraf', - 'firewall', - 'schedule', - 'docker_clean', - 'kafka', - 'stig' - ], - 'so-hypervisor': [ - 'ssl', - 'telegraf', - 'firewall', - 'schedule', - 'docker_clean', - 'stig', - 'hypervisor', - 'libvirt' - ], - 'so-desktop': [ - 'ssl', - 'docker_clean', - 'telegraf', - 'stig' - ], - }, grain='role') %} - - {%- if grains.role in ['so-sensor', 'so-eval', 'so-standalone', 'so-heavynode'] %} - {% do allowed_states.append('zeek') %} - {%- endif %} - - {% if grains.role in ['so-sensor', 'so-eval', 'so-standalone', 'so-heavynode'] %} - {% do allowed_states.append('strelka') %} - {% endif %} - - {% if grains.role in ['so-eval', 'so-manager', 'so-standalone', 'so-searchnode', 'so-managersearch', 'so-heavynode', 'so-import'] %} - {% do allowed_states.append('elasticsearch') %} - {% endif %} - - {% if grains.role in ['so-eval', 'so-manager', 'so-standalone', 'so-managersearch', 'so-import'] %} - {% do allowed_states.append('elasticsearch.auth') %} - {% endif %} - - {% if grains.role in ['so-eval', 'so-manager', 'so-standalone', 'so-managersearch', 'so-import'] %} - {% do allowed_states.append('kibana') %} - {% do allowed_states.append('kibana.secrets') %} - {% endif %} - - {% if grains.role in ['so-eval', 'so-manager', 'so-standalone', 'so-managersearch'] %} - {% do allowed_states.append('elastalert') %} - {% endif %} - - {% if grains.role in ['so-manager', 'so-standalone', 'so-searchnode', 'so-managersearch', 'so-heavynode', 'so-receiver'] %} - {% do allowed_states.append('logstash') %} - {% endif %} - - {% if grains.role in ['so-manager', 'so-standalone', 'so-managersearch', 'so-heavynode', 'so-receiver', 'so-eval'] %} - {% do allowed_states.append('redis') %} - {% endif %} - - {# all nodes on the right salt version can run the following states #} - {% do allowed_states.append('common') %} - {% do allowed_states.append('patch.os.schedule') %} - {% do allowed_states.append('motd') %} - {% do allowed_states.append('salt.minion-check') %} - {% do allowed_states.append('sensoroni') %} - {% do allowed_states.append('salt.lasthighstate') %} + {# Get states for the current role #} + {% if grains.role in role_states %} + {% set allowed_states = role_states[grains.role] %} + {% endif %} + {# Add base states that apply to all roles #} + {% for state in base_states %} + {% do allowed_states.append(state) %} + {% endfor %} {% endif %} - +{# Add airgap state if needed #} {% if ISAIRGAP %} - {% do allowed_states.append('airgap') %} + {% do allowed_states.append('airgap') %} {% endif %} - -{# all nodes can always run salt.minion state #} -{% do allowed_states.append('salt.minion') %} diff --git a/salt/common/init.sls b/salt/common/init.sls index d4d90cbed..bb7d648a4 100644 --- a/salt/common/init.sls +++ b/salt/common/init.sls @@ -106,7 +106,7 @@ Etc/UTC: timezone.system # Sync curl configuration for Elasticsearch authentication -{% if GLOBALS.role in ['so-eval', 'so-heavynode', 'so-import', 'so-manager', 'so-managersearch', 'so-searchnode', 'so-standalone'] %} +{% if GLOBALS.is_manager or GLOBALS.role in ['so-heavynode', 'so-searchnode'] %} elastic_curl_config: file.managed: - name: /opt/so/conf/elasticsearch/curl.config diff --git a/salt/elasticfleet/config.sls b/salt/elasticfleet/config.sls index ef921b404..f347a3c80 100644 --- a/salt/elasticfleet/config.sls +++ b/salt/elasticfleet/config.sls @@ -166,7 +166,7 @@ eaoptionalintegrationsdir: {% for minion in node_data %} {% set role = node_data[minion]["role"] %} -{% if role in [ "eval","fleet","heavynode","import","manager","managersearch","standalone" ] %} +{% if role in [ "eval","fleet","heavynode","import","manager", "managerhype", "managersearch","standalone" ] %} {% set optional_integrations = ELASTICFLEETMERGED.optional_integrations %} {% set integration_keys = optional_integrations.keys() %} fleet_server_integrations_{{ minion }}: diff --git a/salt/elasticsearch/config.map.jinja b/salt/elasticsearch/config.map.jinja index f6062e1f2..cfbab8524 100644 --- a/salt/elasticsearch/config.map.jinja +++ b/salt/elasticsearch/config.map.jinja @@ -28,7 +28,7 @@ {% endfor %} {% endfor %} -{% if grains.id.split('_') | last in ['manager','managersearch','standalone'] %} +{% if grains.id.split('_') | last in ['manager','managerhype','managersearch','standalone'] %} {% if ELASTICSEARCH_SEED_HOSTS | length > 1 %} {% do ELASTICSEARCHDEFAULTS.elasticsearch.config.update({'discovery': {'seed_hosts': []}}) %} {% for NODE in ELASTICSEARCH_SEED_HOSTS %} diff --git a/salt/elasticsearch/defaults.yaml b/salt/elasticsearch/defaults.yaml index 7b38ed0bb..f55f49197 100644 --- a/salt/elasticsearch/defaults.yaml +++ b/salt/elasticsearch/defaults.yaml @@ -4479,6 +4479,14 @@ elasticsearch: - data - remote_cluster_client - transform + so-managerhype: + config: + node: + roles: + - master + - data + - remote_cluster_client + - transform so-managersearch: config: node: diff --git a/salt/elasticsearch/enabled.sls b/salt/elasticsearch/enabled.sls index af162d9e9..4e1eecd0a 100644 --- a/salt/elasticsearch/enabled.sls +++ b/salt/elasticsearch/enabled.sls @@ -204,7 +204,7 @@ so-elasticsearch-roles-load: - docker_container: so-elasticsearch - file: elasticsearch_sbin_jinja -{% if grains.role in ['so-eval', 'so-standalone', 'so-managersearch', 'so-heavynode', 'so-manager'] %} +{% if GLOBALS.role in ['so-eval', 'so-standalone', 'so-managersearch', 'so-heavynode', 'so-manager', 'so-managerhype'] %} {% if ELASTICSEARCHMERGED.index_clean %} {% set ap = "present" %} {% else %} diff --git a/salt/firewall/defaults.yaml b/salt/firewall/defaults.yaml index 9b4e0a430..930ceac25 100644 --- a/salt/firewall/defaults.yaml +++ b/salt/firewall/defaults.yaml @@ -19,6 +19,7 @@ firewall: localhost: - 127.0.0.1 manager: [] + managerhype: [] managersearch: [] receiver: [] searchnode: [] @@ -573,6 +574,215 @@ firewall: portgroups: [] customhostgroup9: portgroups: [] + managerhype: + chain: + DOCKER-USER: + hostgroups: + managerhype: + portgroups: + - kibana + - redis + - influxdb + - elasticsearch_rest + - elasticsearch_node + - docker_registry + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + - localrules + - sensoroni + fleet: + portgroups: + - elasticsearch_rest + - docker_registry + - influxdb + - sensoroni + - yum + - beats_5044 + - beats_5644 + - beats_5056 + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + idh: + portgroups: + - docker_registry + - influxdb + - sensoroni + - yum + - beats_5044 + - beats_5644 + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + sensor: + portgroups: + - beats_5044 + - beats_5644 + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + - yum + - docker_registry + - influxdb + - sensoroni + searchnode: + portgroups: + - redis + - elasticsearch_rest + - elasticsearch_node + - beats_5644 + - yum + - docker_registry + - influxdb + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + - sensoroni + heavynode: + portgroups: + - redis + - elasticsearch_rest + - elasticsearch_node + - beats_5644 + - yum + - docker_registry + - influxdb + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + - sensoroni + receiver: + portgroups: + - yum + - docker_registry + - influxdb + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + - sensoroni + analyst: + portgroups: + - nginx + beats_endpoint: + portgroups: + - beats_5044 + beats_endpoint_ssl: + portgroups: + - beats_5644 + elasticsearch_rest: + portgroups: + - elasticsearch_rest + elastic_agent_endpoint: + portgroups: + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + endgame: + portgroups: + - endgame + external_suricata: + portgroups: + - external_suricata + desktop: + portgroups: + - docker_registry + - influxdb + - sensoroni + - yum + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + hypervisor: + portgroups: + - yum + - docker_registry + - influxdb + - elastic_agent_control + - elastic_agent_data + - elastic_agent_update + - sensoroni + customhostgroup0: + portgroups: [] + customhostgroup1: + portgroups: [] + customhostgroup2: + portgroups: [] + customhostgroup3: + portgroups: [] + customhostgroup4: + portgroups: [] + customhostgroup5: + portgroups: [] + customhostgroup6: + portgroups: [] + customhostgroup7: + portgroups: [] + customhostgroup8: + portgroups: [] + customhostgroup9: + portgroups: [] + INPUT: + hostgroups: + anywhere: + portgroups: + - ssh + dockernet: + portgroups: + - all + fleet: + portgroups: + - salt_manager + idh: + portgroups: + - salt_manager + localhost: + portgroups: + - all + sensor: + portgroups: + - salt_manager + searchnode: + portgroups: + - salt_manager + heavynode: + portgroups: + - salt_manager + receiver: + portgroups: + - salt_manager + desktop: + portgroups: + - salt_manager + hypervisor: + portgroups: + - salt_manager + self: + portgroups: + - syslog + syslog: + portgroups: + - syslog + customhostgroup0: + portgroups: [] + customhostgroup1: + portgroups: [] + customhostgroup2: + portgroups: [] + customhostgroup3: + portgroups: [] + customhostgroup4: + portgroups: [] + customhostgroup5: + portgroups: [] + customhostgroup6: + portgroups: [] + customhostgroup7: + portgroups: [] + customhostgroup8: + portgroups: [] + customhostgroup9: + portgroups: [] managersearch: chain: DOCKER-USER: diff --git a/salt/logstash/defaults.yaml b/salt/logstash/defaults.yaml index 9930b7bcf..5af366459 100644 --- a/salt/logstash/defaults.yaml +++ b/salt/logstash/defaults.yaml @@ -12,6 +12,8 @@ logstash: - search manager: - manager + managerhype: + - manager managersearch: - manager - search diff --git a/salt/logstash/enabled.sls b/salt/logstash/enabled.sls index 0f44a3767..cd71cd574 100644 --- a/salt/logstash/enabled.sls +++ b/salt/logstash/enabled.sls @@ -16,7 +16,7 @@ include: - elasticsearch.ca {% endif %} {# Kafka ca runs on nodes that can run logstash for Kafka input / output. Only when Kafka is global pipeline #} -{% if GLOBALS.role in ['so-searchnode', 'so-manager', 'so-managersearch', 'so-receiver', 'so-standalone'] and GLOBALS.pipeline == 'KAFKA' %} +{% if GLOBALS.role in ['so-searchnode', 'so-manager', 'so-managerhype', 'so-managersearch', 'so-receiver', 'so-standalone'] and GLOBALS.pipeline == 'KAFKA' %} - kafka.ca - kafka.ssl {% endif %} @@ -65,26 +65,26 @@ so-logstash: - /opt/so/log/logstash:/var/log/logstash:rw - /sys/fs/cgroup:/sys/fs/cgroup:ro - /opt/so/conf/logstash/etc/certs:/usr/share/logstash/certs:ro - {% if GLOBALS.role in ['so-manager', 'so-managersearch', 'so-standalone', 'so-import', 'so-heavynode', 'so-receiver'] %} + {% if GLOBALS.role in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone', 'so-import', 'so-heavynode', 'so-receiver'] %} - /etc/pki/filebeat.crt:/usr/share/logstash/filebeat.crt:ro - /etc/pki/filebeat.p8:/usr/share/logstash/filebeat.key:ro {% endif %} - {% if GLOBALS.role in ['so-manager', 'so-managersearch', 'so-standalone', 'so-import', 'so-eval','so-fleet', 'so-heavynode', 'so-receiver'] %} + {% if GLOBALS.is_manager or GLOBALS.role in ['so-fleet', 'so-heavynode', 'so-receiver'] %} - /etc/pki/elasticfleet-logstash.crt:/usr/share/logstash/elasticfleet-logstash.crt:ro - /etc/pki/elasticfleet-logstash.key:/usr/share/logstash/elasticfleet-logstash.key:ro - /etc/pki/elasticfleet-lumberjack.crt:/usr/share/logstash/elasticfleet-lumberjack.crt:ro - /etc/pki/elasticfleet-lumberjack.key:/usr/share/logstash/elasticfleet-lumberjack.key:ro {% endif %} - {% if GLOBALS.role in ['so-manager', 'so-managersearch', 'so-standalone', 'so-import'] %} + {% if GLOBALS.role in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone', 'so-import'] %} - /etc/pki/ca.crt:/usr/share/filebeat/ca.crt:ro {% else %} - /etc/pki/tls/certs/intca.crt:/usr/share/filebeat/ca.crt:ro {% endif %} - {% if GLOBALS.role in ['so-manager', 'so-managersearch', 'so-standalone', 'so-import', 'so-heavynode', 'so-searchnode' ] %} + {% if GLOBALS.role in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone', 'so-import', 'so-heavynode', 'so-searchnode' ] %} - /opt/so/conf/ca/cacerts:/etc/pki/ca-trust/extracted/java/cacerts:ro - /opt/so/conf/ca/tls-ca-bundle.pem:/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem:ro {% endif %} - {% if GLOBALS.pipeline == "KAFKA" and GLOBALS.role in ['so-manager', 'so-managersearch', 'so-standalone', 'so-searchnode'] %} + {% if GLOBALS.pipeline == "KAFKA" and GLOBALS.role in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone', 'so-searchnode'] %} - /etc/pki/kafka-logstash.p12:/usr/share/logstash/kafka-logstash.p12:ro - /opt/so/conf/kafka/kafka-truststore.jks:/etc/pki/kafka-truststore.jks:ro {% endif %} @@ -100,7 +100,7 @@ so-logstash: {% endfor %} {% endif %} - watch: - {% if grains['role'] in ['so-manager', 'so-eval', 'so-managersearch', 'so-standalone', 'so-import', 'so-fleet', 'so-receiver'] %} + {% if GLOBALS.is_manager or GLOBALS.role in ['so-fleet', 'so-receiver'] %} - x509: etc_elasticfleet_logstash_key - x509: etc_elasticfleet_logstash_crt {% endif %} @@ -111,23 +111,23 @@ so-logstash: - file: ls_pipeline_{{assigned_pipeline}}_{{CONFIGFILE.split('.')[0] | replace("/","_") }} {% endfor %} {% endfor %} - {% if GLOBALS.pipeline == 'KAFKA' and GLOBALS.role in ['so-manager', 'so-managersearch', 'so-standalone', 'so-searchnode'] %} + {% if GLOBALS.pipeline == 'KAFKA' and GLOBALS.role in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone', 'so-searchnode'] %} - file: kafkacertz {% endif %} - require: - {% if grains['role'] in ['so-manager', 'so-managersearch', 'so-standalone', 'so-import', 'so-heavynode', 'so-receiver'] %} + {% if grains['role'] in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone', 'so-import', 'so-heavynode', 'so-receiver'] %} - x509: etc_filebeat_crt {% endif %} - {% if grains['role'] in ['so-manager', 'so-managersearch', 'so-standalone', 'so-import'] %} + {% if grains['role'] in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone', 'so-import'] %} - x509: pki_public_ca_crt {% else %} - x509: trusttheca {% endif %} - {% if grains.role in ['so-manager', 'so-managersearch', 'so-standalone', 'so-import'] %} + {% if grains.role in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone', 'so-import'] %} - file: cacertz - file: capemz {% endif %} - {% if GLOBALS.pipeline == 'KAFKA' and GLOBALS.role in ['so-manager', 'so-managersearch', 'so-standalone', 'so-searchnode'] %} + {% if GLOBALS.pipeline == 'KAFKA' and GLOBALS.role in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone', 'so-searchnode'] %} - file: kafkacertz {% endif %} diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index 6de864e4b..222119bde 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -878,6 +878,23 @@ function createHYPERVISOR() { add_telegraf_to_minion || return 1 } +function createMANAGERHYPE() { + log "INFO" "Creating MANAGERHYPE configuration for minion $MINION_ID" + add_elasticsearch_to_minion || return 1 + add_logstash_to_minion || return 1 + add_elastalert_to_minion || return 1 + add_kibana_to_minion || return 1 + add_redis_to_minion || return 1 + add_telegraf_to_minion || return 1 + add_influxdb_to_minion || return 1 + add_nginx_to_minion || return 1 + add_soc_to_minion || return 1 + add_registry_to_minion || return 1 + add_kratos_to_minion || return 1 + add_idstools_to_minion || return 1 + add_elastic_fleet_package_registry_to_minion || return 1 +} + function createDESKTOP() { log "INFO" "Creating DESKTOP configuration for minion $MINION_ID" add_desktop_to_minion || return 1 diff --git a/salt/nginx/enabled.sls b/salt/nginx/enabled.sls index e2bcef863..76bf7aba4 100644 --- a/salt/nginx/enabled.sls +++ b/salt/nginx/enabled.sls @@ -123,7 +123,7 @@ so-nginx: - /opt/so/tmp/nginx/:/run:rw - /opt/so/saltstack/local/salt/elasticfleet/files/so_agent-installers/:/opt/socore/html/packages - /nsm/elastic-fleet/artifacts/:/opt/socore/html/artifacts - {% if grains.role in ['so-manager', 'so-managersearch', 'so-eval', 'so-standalone', 'so-import'] %} + {% if GLOBALS.is_manager %} - /etc/pki/managerssl.crt:/etc/pki/nginx/server.crt:ro - /etc/pki/managerssl.key:/etc/pki/nginx/server.key:ro # ATT&CK Navigator binds @@ -156,7 +156,7 @@ so-nginx: - file: nginxconfdir - require: - file: nginxconf -{% if grains.role in ['so-manager', 'so-managersearch', 'so-eval', 'so-standalone', 'so-import'] %} +{% if GLOBALS.is_manager %} {% if NGINXMERGED.ssl.replace_cert %} - file: managerssl_key - file: managerssl_crt diff --git a/salt/nginx/etc/nginx.conf b/salt/nginx/etc/nginx.conf index 069e55cdb..0506c1e60 100644 --- a/salt/nginx/etc/nginx.conf +++ b/salt/nginx/etc/nginx.conf @@ -59,7 +59,7 @@ http { {%- endif %} - {%- if role in ['eval', 'managersearch', 'manager', 'standalone', 'import'] %} + {%- if GLOBALS.is_manager %} server { listen 80 default_server; @@ -108,7 +108,7 @@ http { {%- endif %} - {%- if role in ['eval', 'managersearch', 'manager', 'standalone', 'import'] %} + {%- if GLOBALS.is_manager %} server { listen 7788; diff --git a/salt/repo/client/oracle.sls b/salt/repo/client/oracle.sls index 89d41beae..2f421b700 100644 --- a/salt/repo/client/oracle.sls +++ b/salt/repo/client/oracle.sls @@ -49,7 +49,7 @@ so_repo: pkgrepo.managed: - name: securityonion - humanname: Security Onion Repo - {% if GLOBALS.role in ['so-eval', 'so-standalone', 'so-import', 'so-manager', 'so-managersearch'] %} + {% if GLOBALS.is_manager %} - baseurl: file:///nsm/repo/ {% else %} - baseurl: https://{{ GLOBALS.repo_host }}/repo diff --git a/salt/ssl/init.sls b/salt/ssl/init.sls index f5be34c40..0cef8c1e3 100644 --- a/salt/ssl/init.sls +++ b/salt/ssl/init.sls @@ -17,7 +17,7 @@ {% set COMMONNAME = GLOBALS.manager %} {% endif %} -{% if grains.id.split('_')|last in ['manager', 'managersearch', 'eval', 'standalone', 'import'] %} +{% if GLOBALS.is_manager %} include: - ca {% set trusttheca_text = salt['cp.get_file_str']('/etc/pki/ca.crt')|replace('\n', '') %} @@ -99,7 +99,7 @@ influxkeyperms: - mode: 640 - group: 939 -{% if grains['role'] in ['so-manager', 'so-eval', 'so-managersearch', 'so-standalone', 'so-import', 'so-heavynode', 'so-fleet', 'so-receiver'] %} +{% if GLOBALS.is_manager or GLOBALS.role in ['so-heavynode', 'so-fleet', 'so-receiver'] %} # Create a cert for Redis encryption redis_key: x509.private_key_managed: @@ -139,7 +139,7 @@ rediskeyperms: - group: 939 {% endif %} -{% if grains['role'] in ['so-manager', 'so-eval', 'so-managersearch', 'so-standalone', 'so-import', 'so-heavynode', 'so-fleet', 'so-receiver'] %} +{% if GLOBALS.is_manager or GLOBALS.role in ['so-heavynode', 'so-fleet', 'so-receiver'] %} {% if grains['role'] not in [ 'so-heavynode', 'so-receiver'] %} # Start -- Elastic Fleet Host Cert @@ -388,7 +388,7 @@ chownelasticfleetagentkey: {% endif %} -{% if grains['role'] in ['so-manager', 'so-eval', 'so-managersearch', 'so-standalone', 'so-import', 'so-heavynode', 'so-receiver'] %} +{% if GLOBALS.is_manager or GLOBALS.role in ['so-heavynode', 'so-receiver'] %} etc_filebeat_key: x509.private_key_managed: - name: /etc/pki/filebeat.key @@ -552,7 +552,7 @@ elasticp12perms: {% endif %} -{% if grains['role'] in ['so-sensor', 'so-manager', 'so-searchnode', 'so-eval', 'so-managersearch', 'so-heavynode', 'so-fleet', 'so-standalone', 'so-idh', 'so-import', 'so-receiver'] %} +{% if GLOBALS.is_manager or GLOBALS.role in ['so-sensor', 'so-searchnode', 'so-heavynode', 'so-fleet', 'so-idh', 'so-receiver'] %} fbcertdir: file.directory: @@ -663,7 +663,7 @@ elastickeyperms: - group: 930 {%- endif %} -{% if grains['role'] in ['so-manager', 'so-managersearch', 'so-standalone'] %} +{% if GLOBALS.role in ['so-manager', 'so-managerhype', 'so-managersearch', 'so-standalone'] %} elasticfleet_kafka_key: x509.private_key_managed: - name: /etc/pki/elasticfleet-kafka.key diff --git a/salt/telegraf/defaults.yaml b/salt/telegraf/defaults.yaml index d32fff179..79ad9008d 100644 --- a/salt/telegraf/defaults.yaml +++ b/salt/telegraf/defaults.yaml @@ -48,6 +48,15 @@ telegraf: - redis.sh - sostatus.sh - features.sh + managerhype: + - agentstatus.sh + - influxdbsize.sh + - lasthighstate.sh + - os.sh + - raid.sh + - redis.sh + - sostatus.sh + - features.sh managersearch: - agentstatus.sh - eps.sh diff --git a/salt/top.sls b/salt/top.sls index 0d22bd782..260bb9c74 100644 --- a/salt/top.sls +++ b/salt/top.sls @@ -85,7 +85,7 @@ base: - utility - elasticfleet - '*_manager and G@saltversion:{{saltversion}}': + '*_manager or *_managerhype and G@saltversion:{{saltversion}}': - match: compound - salt.master - ca @@ -276,17 +276,19 @@ base: - elasticfleet.install_agent_grid - schedule - '*_hypervisor and G@saltversion:{{saltversion}}': + '*_hypervisor or *_managerhype and I@features:hvn and G@saltversion:{{saltversion}}': - match: compound - ssl - sensoroni - telegraf - firewall - - elasticfleet.install_agent_grid - libvirt - libvirt.images - hypervisor - stig + + '*_hypervisor and I@features:hvn and G@saltversion:{{saltversion}}': + - elasticfleet.install_agent_grid '*_desktop and G@saltversion:{{saltversion}}': - ssl diff --git a/salt/vars/globals.map.jinja b/salt/vars/globals.map.jinja index 000cfa354..ca75437eb 100644 --- a/salt/vars/globals.map.jinja +++ b/salt/vars/globals.map.jinja @@ -38,6 +38,7 @@ 'so-import', 'so-manager', 'so-managersearch', + 'so-managerhype', 'so-standalone' ], 'sensor_roles': [ diff --git a/salt/vars/hypervisor.map.jinja b/salt/vars/hypervisor.map.jinja index b8fd4ac1f..0a9dfd3f7 100644 --- a/salt/vars/hypervisor.map.jinja +++ b/salt/vars/hypervisor.map.jinja @@ -1,6 +1,12 @@ {% import 'vars/init.map.jinja' as INIT %} +{% + set has_br0 = INIT.GRAINS is defined and INIT.GRAINS.ip_interfaces is defined and 'br0' in INIT.GRAINS.ip_interfaces and INIT.GRAINS.ip_interfaces.br0 is defined and INIT.GRAINS.ip_interfaces.br0|length > 0 %} +{% + set has_mainint = INIT.PILLAR is defined and INIT.PILLAR.host is defined and INIT.PILLAR.host.mainint is defined %} +{% + set fallback_ip = INIT.GRAINS.ip_interfaces.get(INIT.PILLAR.host.mainint, ['127.0.0.1'])[0] if has_mainint else '127.0.0.1' %} {% set ROLE_GLOBALS = { - 'node_ip': INIT.GRAINS.ip_interfaces.get('br0')[0] + 'node_ip': INIT.GRAINS.ip_interfaces.get('br0', [fallback_ip])[0] if has_br0 else fallback_ip } %} diff --git a/salt/vars/managerhype.map.jinja b/salt/vars/managerhype.map.jinja new file mode 100644 index 000000000..5f7118f31 --- /dev/null +++ b/salt/vars/managerhype.map.jinja @@ -0,0 +1,8 @@ +{% from 'vars/manager.map.jinja' import ROLE_GLOBALS as MANAGER_GLOBALS %} +{% from 'vars/hypervisor.map.jinja' import ROLE_GLOBALS as HYPERVISOR_GLOBALS %} + +{% set ROLE_GLOBALS = {} %} + +{# Merge both role globals #} +{% do salt['defaults.merge'](ROLE_GLOBALS, HYPERVISOR_GLOBALS, merge_lists=False, in_place=True) %} +{% do salt['defaults.merge'](ROLE_GLOBALS, MANAGER_GLOBALS, merge_lists=False, in_place=True) %} diff --git a/setup/so-functions b/setup/so-functions index 25362f179..db0741851 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -512,7 +512,7 @@ configure_minion() { 'workstation') echo "master: '$MSRV'" >> "$minion_config" ;; - 'manager' | 'eval' | 'managersearch' | 'standalone' | 'import') + 'manager'* | 'eval' | 'standalone' | 'import') cp -f ../salt/ca/files/signing_policies.conf /etc/salt/minion.d/signing_policies.conf printf '%s\n'\ "master: '$HOSTNAME'"\ @@ -609,6 +609,10 @@ check_requirements() { req_mem=8 req_cores=2 req_nics=1 + elif [[ $is_managerhype || $is_hypervisor ]]; then + req_mem=64 + req_cores=32 + req_nics=1 fi if [[ $setup_type == 'network' ]] ; then @@ -1574,6 +1578,10 @@ process_installtype() { is_receiver=true elif [ "$install_type" = 'DESKTOP' ]; then is_desktop=true + elif [ "$install_type" = 'HYPERVISOR' ]; then + is_hypervisor=true + elif [ "$install_type" = 'MANAGERHYPE' ]; then + is_managerhype=true fi } diff --git a/setup/so-setup b/setup/so-setup index 0f445850f..6217511fc 100755 --- a/setup/so-setup +++ b/setup/so-setup @@ -635,6 +635,29 @@ if ! [[ -f $install_opt_file ]]; then set_minion_info whiptail_end_settings + elif [[ $is_managerhype ]]; then + info "Setting up as node type managerhype" + check_elastic_license + waitforstate=true + [[ $is_iso ]] && whiptail_airgap + check_requirements + networking_needful + configure_hyper_bridge + [[ ! $is_airgap ]] && collect_net_method + collect_dockernet + [[ ! $is_airgap ]] && detect_cloud + set_minion_info + set_default_log_size >> $setup_log 2>&1 + info "Verifying all network devices are managed by Network Manager that should be" + check_network_manager_conf + set_network_dev_status_list + calculate_useable_cores + collect_webuser_inputs + get_redirect + collect_so_allow + [[ ! $is_airgap ]] && whiptail_accept_telemetry + whiptail_end_settings + fi if [[ $waitforstate ]]; then diff --git a/setup/so-whiptail b/setup/so-whiptail index 2ea5dd38b..57bd10b8c 100755 --- a/setup/so-whiptail +++ b/setup/so-whiptail @@ -654,9 +654,10 @@ whiptail_install_type_dist_new() { Note: MANAGER is the recommended option for most users. MANAGERSEARCH should only be used in very specific situations. EOM - install_type=$(whiptail --title "$whiptail_title" --menu "$mngr_msg" 20 75 2 \ + install_type=$(whiptail --title "$whiptail_title" --menu "$mngr_msg" 20 75 3 \ "MANAGER" "New grid, requires separate search node(s) " \ "MANAGERSEARCH" "New grid, separate search node(s) are optional " \ + "MANAGERHYPE" "Manager with hypervisor - Security Onion Pro required " \ 3>&1 1>&2 2>&3 ) @@ -681,7 +682,7 @@ whiptail_install_type_dist_existing() { "HEAVYNODE" "Sensor + Search Node " \ "IDH" "Intrusion Detection Honeypot Node " \ "RECEIVER" "Receiver Node " \ - "HYPERVISOR" "Hypervisor Node " \ + "HYPERVISOR" "Hypervisor Node - Security Onion Pro required " \ 3>&1 1>&2 2>&3 # "HOTNODE" "Add Hot Node (Uses Elastic Clustering)" \ # TODO # "WARMNODE" "Add Warm Node to existing Hot or Search node" \ # TODO @@ -714,8 +715,6 @@ whiptail_install_type_dist_existing() { is_receiver=true elif [ "$install_type" = 'DESKTOP' ]; then is_desktop=true - elif [ "$install_type" = 'HYPERVISOR' ]; then - is_hypervisor=true fi local exitstatus=$? From c93a5de460ab8d7fad17b9ac1a3f733956f18449 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 13 Mar 2025 10:55:49 -0400 Subject: [PATCH 156/303] additional changes for managerhype --- pillar/hypervisor/nodes.sls | 2 +- salt/libvirt/packages.sls | 2 +- salt/libvirt/ssh/users.sls | 4 +++- salt/salt/master.sls | 13 ------------- salt/salt/mine_functions.sls | 4 ++-- 5 files changed, 7 insertions(+), 18 deletions(-) diff --git a/pillar/hypervisor/nodes.sls b/pillar/hypervisor/nodes.sls index 0cdec95d3..a25239d8d 100644 --- a/pillar/hypervisor/nodes.sls +++ b/pillar/hypervisor/nodes.sls @@ -1,7 +1,7 @@ {% set node_types = {} %} {% for minionid, ip in salt.saltutil.runner( 'mine.get', - tgt='G@role:so-hypervisor', + tgt='G@role:so-hypervisor or G@role:so-managerhype', fun='network.ip_addrs', tgt_type='compound') | dictsort() %} diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index 195232329..d2cbd6e2d 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -42,7 +42,7 @@ libvirt_python_module: - onchanges: - file: libvirt_python_wheel -{% if 'hyper' in grains.id.split('_') | last %} +{% if 'hype' in grains.id.split('_') | last %} # provides virsh install_libvirt-client: diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls index 9b6a3beb7..375a42c38 100644 --- a/salt/libvirt/ssh/users.sls +++ b/salt/libvirt/ssh/users.sls @@ -21,7 +21,9 @@ qemu_ssh_client_config: - name: /root/.ssh/config - source: salt://libvirt/ssh/files/config -{% else %} +{% endif %} + +{% if GLOBALS.role in ['so-hypervisor', 'so-managerhype'] %} # used for qemu+ssh connection between manager and hypervisors create_soqemussh_user: diff --git a/salt/salt/master.sls b/salt/salt/master.sls index 56f529e89..d6bd84496 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -86,19 +86,6 @@ salt_master_service: - file: engines_config - order: last -{# -# we need to managed adding the following to salt-master config if there are hypervisors -reactor: - - 'salt/key': - - salt://reactor/check_hypervisor.sls - - 'salt/cloud/*/deploying': - - /opt/so/saltstack/default/salt/reactor/createEmptyPillar.sls - - 'setup/so-minion': - - /opt/so/saltstack/default/salt/reactor/sominion_setup.sls - - 'salt/cloud/*/destroyed': - - /opt/so/saltstack/default/salt/reactor/deleteKey.sls -#} - {% else %} {{sls}}_state_not_allowed: diff --git a/salt/salt/mine_functions.sls b/salt/salt/mine_functions.sls index a828add9b..3b81fd4a3 100644 --- a/salt/salt/mine_functions.sls +++ b/salt/salt/mine_functions.sls @@ -8,7 +8,7 @@ # this state is included in the salt.minion state {% set role = salt['grains.get']('role', '') %} -{% if role == 'so-hypervisor' -%} +{% if role in ['so-hypervisor','so-managerhype'] and salt['network.ip_addrs']('br0')|length > 0 -%} {% set interface = 'br0' %} {% else %} {% set interface = pillar.host.mainint %} @@ -22,7 +22,7 @@ mine_functions: mine_functions: network.ip_addrs: - interface: {{ interface }} - {%- if role in ['so-eval','so-import','so-manager','so-managersearch','so-standalone'] %} + {%- if role in ['so-eval','so-import','so-manager','so-managerhype','so-managersearch','so-standalone'] %} x509.get_pem_entries: - glob_path: '/etc/pki/ca.crt' {% endif -%} From 2dc977ddd8cdf2a760074dd3781759ea29ee3783 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 13 Mar 2025 14:33:48 -0400 Subject: [PATCH 157/303] managerhype --- setup/so-functions | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup/so-functions b/setup/so-functions index db0741851..798ab934b 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -1138,7 +1138,7 @@ generate_ca() { generate_ssl() { # if the install type is a manager then we need to wait for the minion to be ready before trying # to run the ssl state since we need the minion to sign the certs - if [[ "$install_type" =~ ^(EVAL|MANAGER|MANAGERSEARCH|STANDALONE|IMPORT|HELIXSENSOR)$ ]]; then + if [[ $waitforstate ]]; then (wait_for_salt_minion "$MINION_ID" "5" '/dev/stdout' || fail_setup) 2>&1 | tee -a "$setup_log" fi info "Applying SSL state" From 269919b980f5149931d3cc52a876bbfaf6469625 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 18 Mar 2025 09:39:49 -0400 Subject: [PATCH 158/303] run setup_hypervisor.setup_environment for mangerhype if needed --- salt/manager/hypervisor.sls | 64 +++++++++++++++++++++++++++++++++++++ salt/top.sls | 10 +++--- 2 files changed, 70 insertions(+), 4 deletions(-) create mode 100644 salt/manager/hypervisor.sls diff --git a/salt/manager/hypervisor.sls b/salt/manager/hypervisor.sls new file mode 100644 index 000000000..d4f07946c --- /dev/null +++ b/salt/manager/hypervisor.sls @@ -0,0 +1,64 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% from 'allowed_states.map.jinja' import allowed_states %} +{% if sls.split('.')[0] in allowed_states %} +{% if 'hvn' in salt['pillar.get']('features', []) %} +{% set manager_hostname = grains.id.split('_')[0] %} + +# Check if hypervisor environment has been set up +{% set ssh_user_exists = salt['user.info']('soqemussh') %} +{% set ssh_keys_exist = salt['file.file_exists']('/etc/ssh/auth_keys/soqemussh/id_ed25519') and + salt['file.file_exists']('/etc/ssh/auth_keys/soqemussh/id_ed25519.pub') and + salt['file.file_exists']('/opt/so/saltstack/local/salt/libvirt/ssh/keys/id_ed25519.pub') %} +{% set base_image_exists = salt['file.file_exists']('/nsm/libvirt/boot/OL9U5_x86_64-kvm-b253.qcow2') %} +{% set vm_files_exist = salt['file.directory_exists']('/opt/so/saltstack/local/salt/libvirt/images/sool9') and + salt['file.file_exists']('/opt/so/saltstack/local/salt/libvirt/images/sool9/sool9.qcow2') and + salt['file.file_exists']('/opt/so/saltstack/local/salt/libvirt/images/sool9/sool9-cidata.iso') %} +{% set hypervisor_host_dir_exists = salt['file.directory_exists']('/opt/so/saltstack/local/salt/hypervisor/hosts/' ~ manager_hostname) %} + +{% if ssh_user_exists and ssh_keys_exist and base_image_exists and vm_files_exist and hypervisor_host_dir_exists %} +# Hypervisor environment is already set up, include the necessary states +include: + - libvirt + - libvirt.images + - hypervisor + +hypervisor_setup_verified: + test.succeed_without_changes: + - name: Hypervisor environment is already set up + - comment: All required files and configurations for the hypervisor environment exist + +{% else %} +# Hypervisor environment needs to be set up +run_setup_hypervisor: + salt.runner: + - name: setup_hypervisor.setup_environment + - minion_id: {{ grains.id }} +{% endif %} + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} + +{% else %} + +{{sls}}_state_not_allowed: + test.fail_without_changes: + - name: {{sls}}_state_not_allowed + +{% endif %} diff --git a/salt/top.sls b/salt/top.sls index 260bb9c74..39ab50165 100644 --- a/salt/top.sls +++ b/salt/top.sls @@ -116,6 +116,10 @@ base: - stig - kafka + '*_managerhype and I@features:hvn and G@saltversion:{{saltversion}}': + - match: compound + - manager.hypervisor + '*_standalone and G@saltversion:{{saltversion}}': - match: compound - salt.master @@ -276,7 +280,7 @@ base: - elasticfleet.install_agent_grid - schedule - '*_hypervisor or *_managerhype and I@features:hvn and G@saltversion:{{saltversion}}': + '*_hypervisor and I@features:hvn and G@saltversion:{{saltversion}}': - match: compound - ssl - sensoroni @@ -285,11 +289,9 @@ base: - libvirt - libvirt.images - hypervisor + - elasticfleet.install_agent_grid - stig - '*_hypervisor and I@features:hvn and G@saltversion:{{saltversion}}': - - elasticfleet.install_agent_grid - '*_desktop and G@saltversion:{{saltversion}}': - ssl - sensoroni From 64f71143dcbb86f03cb14434ad3f3b878d055fbc Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 31 Mar 2025 15:51:32 -0400 Subject: [PATCH 159/303] fix docker fw rules managerhype --- salt/firewall/containers.map.jinja | 2 +- salt/manager/tools/sbin/so-firewall-minion | 4 ++++ setup/so-functions | 2 +- 3 files changed, 6 insertions(+), 2 deletions(-) diff --git a/salt/firewall/containers.map.jinja b/salt/firewall/containers.map.jinja index cc0a20299..2d1135e5f 100644 --- a/salt/firewall/containers.map.jinja +++ b/salt/firewall/containers.map.jinja @@ -21,7 +21,7 @@ 'so-strelka-filestream' ] %} -{% elif GLOBALS.role == 'so-manager' or GLOBALS.role == 'so-standalone' or GLOBALS.role == 'so-managersearch' %} +{% elif GLOBALS.role in ['so-manager', 'so-standalone','so-managersearch', 'so-managerhype'] %} {% set NODE_CONTAINERS = [ 'so-dockerregistry', 'so-elasticsearch', diff --git a/salt/manager/tools/sbin/so-firewall-minion b/salt/manager/tools/sbin/so-firewall-minion index 4b0fb766e..8b8fbfc99 100755 --- a/salt/manager/tools/sbin/so-firewall-minion +++ b/salt/manager/tools/sbin/so-firewall-minion @@ -51,6 +51,10 @@ fi 'MANAGER') so-firewall includehost manager "$IP" ;; + 'MANAGERHYPE') + so-firewall includehost manager "$IP" + so-firewall includehost hypervisor "$IP" --apply + ;; 'MANAGERSEARCH') so-firewall includehost manager "$IP" so-firewall includehost searchnode "$IP" --apply diff --git a/setup/so-functions b/setup/so-functions index 3cad975fd..d28d7baf3 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -2234,7 +2234,7 @@ set_hostname() { set_initial_firewall_policy() { case "$install_type" in - 'EVAL' | 'MANAGER' | 'MANAGERSEARCH' | 'STANDALONE' | 'IMPORT') + 'EVAL' | 'MANAGER' | 'MANAGERHYPE' | 'MANAGERSEARCH' | 'STANDALONE' | 'IMPORT') so-firewall includehost $minion_type $MAINIP --apply ;; esac From e7aa4428de80f4358dfbcd88522dddb65478b3ec Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 31 Mar 2025 16:03:19 -0400 Subject: [PATCH 160/303] managerhype udate mine when switch to br0 --- salt/libvirt/init.sls | 3 +++ salt/salt/mine_functions.sls | 6 ++++++ 2 files changed, 9 insertions(+) diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 4321fdfb1..3e21089b2 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -18,6 +18,7 @@ include: - libvirt.64962 - libvirt.packages - libvirt.ssh.users + - salt.mine_functions install_libvirt: pkg.installed: @@ -99,6 +100,8 @@ down_original_mgmt_interface: - unless: - nmcli -f GENERAL.CONNECTION dev show {{ pillar.host.mainint }} | grep bridge-slave-{{ pillar.host.mainint }} - order: last + - onchanges_in: + - file: mine_functions # virtlogd service may not restart following reboot without this #semanage permissive -a virtlogd_t diff --git a/salt/salt/mine_functions.sls b/salt/salt/mine_functions.sls index 3b81fd4a3..6fc6fcb49 100644 --- a/salt/salt/mine_functions.sls +++ b/salt/salt/mine_functions.sls @@ -26,3 +26,9 @@ mine_functions: x509.get_pem_entries: - glob_path: '/etc/pki/ca.crt' {% endif -%} + +mine_update_mine_functions: + module.run: + - mine.update: [] + - onchanges: + - file: mine_functions From a60e55e5cd009b1a0c6e455f061a375376e60dd7 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 31 Mar 2025 16:44:48 -0400 Subject: [PATCH 161/303] remove whitespace control --- salt/salt/mine_functions.sls | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/salt/salt/mine_functions.sls b/salt/salt/mine_functions.sls index 6fc6fcb49..b167dec4b 100644 --- a/salt/salt/mine_functions.sls +++ b/salt/salt/mine_functions.sls @@ -8,7 +8,7 @@ # this state is included in the salt.minion state {% set role = salt['grains.get']('role', '') %} -{% if role in ['so-hypervisor','so-managerhype'] and salt['network.ip_addrs']('br0')|length > 0 -%} +{% if role in ['so-hypervisor','so-managerhype'] and salt['network.ip_addrs']('br0')|length > 0 %} {% set interface = 'br0' %} {% else %} {% set interface = pillar.host.mainint %} @@ -22,10 +22,10 @@ mine_functions: mine_functions: network.ip_addrs: - interface: {{ interface }} - {%- if role in ['so-eval','so-import','so-manager','so-managerhype','so-managersearch','so-standalone'] %} + {% if role in ['so-eval','so-import','so-manager','so-managerhype','so-managersearch','so-standalone'] %} x509.get_pem_entries: - glob_path: '/etc/pki/ca.crt' - {% endif -%} + {% endif %} mine_update_mine_functions: module.run: From b22fe5bd3d07927cbc43ca061f86fea596dd01cf Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 1 Apr 2025 09:27:50 -0400 Subject: [PATCH 162/303] set interface for hypervisor/managerhype --- salt/salt/map.jinja | 7 +++++++ salt/salt/mine_functions.sls | 8 ++------ salt/salt/service/salt-minion.service.jinja | 4 +++- 3 files changed, 12 insertions(+), 7 deletions(-) diff --git a/salt/salt/map.jinja b/salt/salt/map.jinja index d77e23100..55b3a7ffb 100644 --- a/salt/salt/map.jinja +++ b/salt/salt/map.jinja @@ -3,6 +3,13 @@ https://securityonion.net/license; you may not use this file except in compliance with the Elastic License 2.0. #} +{% set role = salt['grains.get']('role', '') %} +{% if role in ['so-hypervisor','so-managerhype'] and salt['network.ip_addrs']('br0')|length > 0 %} +{% set interface = 'br0' %} +{% else %} +{% set interface = pillar.host.mainint %} +{% endif %} + {% import_yaml 'salt/minion.defaults.yaml' as saltminion %} {% set SALTVERSION = saltminion.salt.minion.version | string %} {% set INSTALLEDSALTVERSION = grains.saltversion | string %} diff --git a/salt/salt/mine_functions.sls b/salt/salt/mine_functions.sls index b167dec4b..305fe2ce4 100644 --- a/salt/salt/mine_functions.sls +++ b/salt/salt/mine_functions.sls @@ -7,12 +7,8 @@ # GLOBALS are imported in the salt.minion state and that is not available at that point in setup # this state is included in the salt.minion state -{% set role = salt['grains.get']('role', '') %} -{% if role in ['so-hypervisor','so-managerhype'] and salt['network.ip_addrs']('br0')|length > 0 %} -{% set interface = 'br0' %} -{% else %} -{% set interface = pillar.host.mainint %} -{% endif %} +{% from 'salt/map.jinja' import interface %} +{% from 'salt/map.jinja' import role %} mine_functions: file.managed: diff --git a/salt/salt/service/salt-minion.service.jinja b/salt/salt/service/salt-minion.service.jinja index 2763b30f5..ba5702654 100644 --- a/salt/salt/service/salt-minion.service.jinja +++ b/salt/salt/service/salt-minion.service.jinja @@ -1,3 +1,5 @@ +{% from 'salt/map.jinja' import interface -%} + [Unit] Description=The Salt Minion Documentation=man:salt-minion(1) file:///usr/share/doc/salt/html/contents.html https://docs.saltproject.io/en/latest/contents.html @@ -8,7 +10,7 @@ KillMode=process Type=notify NotifyAccess=all LimitNOFILE=8192 -ExecStartPre=/bin/bash -c 'until /sbin/ip -4 addr show dev {{ salt["pillar.get"]("host:mainint") }} | grep -q "inet "; do sleep 1; done' +ExecStartPre=/bin/bash -c 'until /sbin/ip -4 addr show dev {{ interface }} | grep -q "inet "; do sleep 1; done' ExecStart=/usr/bin/salt-minion TimeoutStartSec=120 From 3083e3bc63abe6d3e64eb22f5e3721f5481ac0a4 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 3 Apr 2025 13:42:02 -0400 Subject: [PATCH 163/303] sync runners and create soqemussh user ssh keypair for manager and managerhype --- setup/so-setup | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/setup/so-setup b/setup/so-setup index 6217511fc..5b8a14a01 100755 --- a/setup/so-setup +++ b/setup/so-setup @@ -753,8 +753,14 @@ if ! [[ -f $install_opt_file ]]; then logCmd "salt-call state.show_top" sleep 2 # Debug RSA Key format errors logCmd "salt-key -ya $MINION_ID" - logCmd "salt-call saltutil.sync_all" - + # we need to sync the runner and generate the soqemussh user keys so that first highstate after license created + # doesnt have a state failure for soqemussh_pub_key source for id_ed25519.pub missing + if [[ $is_manager || $is_managerhype ]]; then + logCmd "salt-run saltutil.sync_all" + logCmd "salt-run setup_hypervisor.regenerate_ssh_keys" + else + logCmd "salt-call saltutil.sync_all" + fi logCmd "salt-call state.apply common.packages" logCmd "salt-call state.apply common" # this will apply the salt.minion state first since salt.master includes salt.minion From 445afca6eea4a09c383c07e128a75b62776dffd7 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 3 Apr 2025 13:44:13 -0400 Subject: [PATCH 164/303] use vrt --- salt/_runners/setup_hypervisor.py | 13 ++++--------- .../so-salt-emit-vm-deployment-status-event | 2 +- salt/hypervisor/init.sls | 2 +- salt/hypervisor/map.jinja | 2 +- .../tools/sbin_jinja/so-kvm-modify-hardware | 2 +- .../tools/sbin_jinja/so-qcow2-modify-network | 2 +- salt/libvirt/images/init.sls | 2 +- salt/libvirt/init.sls | 2 +- salt/libvirt/packages.sls | 2 +- salt/libvirt/ssh/users.sls | 2 +- salt/manager/hypervisor.sls | 2 +- salt/manager/tools/sbin/so-minion | 8 ++++---- salt/manager/tools/sbin_jinja/so-salt-cloud | 2 +- salt/orch/dyanno_hypervisor.sls | 2 +- salt/orch/vm_pillar_clean.sls | 2 +- salt/salt/cloud/init.sls | 2 +- salt/salt/cloud/reactor_config_hypervisor.sls | 2 +- salt/salt/engines/master/virtual_node_manager.py | 10 +++++----- .../salt/files/{hvn_engine.conf => vrt_engine.conf} | 0 salt/salt/master.sls | 10 +++++----- salt/sensor/init.sls | 2 +- salt/sensor/vm/network.sls | 2 +- salt/soc/dyanno/hypervisor/init.sls | 2 +- .../soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja | 2 +- salt/soc/dyanno/hypervisor/write_status.sls | 2 +- salt/top.sls | 4 ++-- salt/vm_status/init.sls | 2 +- 27 files changed, 41 insertions(+), 46 deletions(-) rename salt/salt/files/{hvn_engine.conf => vrt_engine.conf} (100%) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 6b3f289e8..35d1bad21 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -121,8 +121,8 @@ def _check_license(): log.error("LICENSE: No license_id found in license file") return False - if 'hvn' not in features: - log.error("LICENSE: 'hvn' feature not found in license") + if 'vrt' not in features: + log.error("LICENSE: 'vrt' feature not found in license") return False log.info("LICENSE: License validation successful") @@ -506,7 +506,7 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id if not _check_license(): return { 'success': False, - 'error': 'Invalid license or missing hvn feature', + 'error': 'Invalid license or missing vrt feature', 'vm_result': None } @@ -670,7 +670,7 @@ def create_vm(vm_name: str, disk_size: str = '220G'): if not _check_license(): return { 'success': False, - 'error': 'Invalid license or missing hvn feature', + 'error': 'Invalid license or missing vrt feature', } try: @@ -958,11 +958,6 @@ def regenerate_ssh_keys(): else: print("Failed to regenerate SSH keys") """ - # Check license before proceeding - if not _check_license(): - log.error("MAIN: Invalid license or missing hvn feature") - return False - log.info("MAIN: Starting SSH key regeneration") try: # Verify current state diff --git a/salt/common/tools/sbin_jinja/so-salt-emit-vm-deployment-status-event b/salt/common/tools/sbin_jinja/so-salt-emit-vm-deployment-status-event index 61f071130..fe51485e6 100644 --- a/salt/common/tools/sbin_jinja/so-salt-emit-vm-deployment-status-event +++ b/salt/common/tools/sbin_jinja/so-salt-emit-vm-deployment-status-event @@ -11,7 +11,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) -%} +{% if 'vrt' in salt['pillar.get']('features', []) -%} """ Script for emitting VM deployment status events to the Salt event bus. diff --git a/salt/hypervisor/init.sls b/salt/hypervisor/init.sls index 677ab8642..4a2edad75 100644 --- a/salt/hypervisor/init.sls +++ b/salt/hypervisor/init.sls @@ -11,7 +11,7 @@ {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls in allowed_states %} -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} hypervisor_log_dir: file.directory: diff --git a/salt/hypervisor/map.jinja b/salt/hypervisor/map.jinja index d19aacf48..da8716415 100644 --- a/salt/hypervisor/map.jinja +++ b/salt/hypervisor/map.jinja @@ -9,7 +9,7 @@ in the software, and you may not remove or obscure any functionality in the software that is protected by the license key." #} -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {# Import defaults.yaml for model hardware capabilities #} {% import_yaml 'hypervisor/defaults.yaml' as DEFAULTS %} diff --git a/salt/hypervisor/tools/sbin_jinja/so-kvm-modify-hardware b/salt/hypervisor/tools/sbin_jinja/so-kvm-modify-hardware index 25506a0ae..ebd606b1e 100644 --- a/salt/hypervisor/tools/sbin_jinja/so-kvm-modify-hardware +++ b/salt/hypervisor/tools/sbin_jinja/so-kvm-modify-hardware @@ -11,7 +11,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} """ Script for managing hardware configurations of KVM virtual machines. This script provides diff --git a/salt/hypervisor/tools/sbin_jinja/so-qcow2-modify-network b/salt/hypervisor/tools/sbin_jinja/so-qcow2-modify-network index cd7869fd8..527131f3f 100644 --- a/salt/hypervisor/tools/sbin_jinja/so-qcow2-modify-network +++ b/salt/hypervisor/tools/sbin_jinja/so-qcow2-modify-network @@ -11,7 +11,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) -%} +{% if 'vrt' in salt['pillar.get']('features', []) -%} """ Script for modifying network configurations within QCOW2 virtual machine images. This script provides diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 94cf4959d..c7734c69d 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -11,7 +11,7 @@ {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls.split('.')[0] in allowed_states or sls in allowed_states %} -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} include: - libvirt.packages diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 3e21089b2..f82b3d9c1 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -11,7 +11,7 @@ {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls in allowed_states %} -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {% from 'libvirt/map.jinja' import LIBVIRTMERGED %} include: diff --git a/salt/libvirt/packages.sls b/salt/libvirt/packages.sls index d2cbd6e2d..d0de3d81f 100644 --- a/salt/libvirt/packages.sls +++ b/salt/libvirt/packages.sls @@ -11,7 +11,7 @@ {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls.split('.')[0] in allowed_states or sls in allowed_states %} -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} # allows for creating vm images # any node manipulating images needs this diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls index 375a42c38..0e9c045a0 100644 --- a/salt/libvirt/ssh/users.sls +++ b/salt/libvirt/ssh/users.sls @@ -11,7 +11,7 @@ {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls.split('.')[0] in allowed_states or sls in allowed_states %} -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {% from 'vars/globals.map.jinja' import GLOBALS %} {% if GLOBALS.is_manager %} diff --git a/salt/manager/hypervisor.sls b/salt/manager/hypervisor.sls index d4f07946c..84cd478c8 100644 --- a/salt/manager/hypervisor.sls +++ b/salt/manager/hypervisor.sls @@ -11,7 +11,7 @@ {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls.split('.')[0] in allowed_states %} -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {% set manager_hostname = grains.id.split('_')[0] %} # Check if hypervisor environment has been set up diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index 222119bde..211b036cf 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -235,7 +235,7 @@ function acceptminion() { if [[ "$MINION_ID" == *"_hypervisor" ]]; then FEATURES=$(/usr/sbin/so-yaml.py get /opt/so/saltstack/local/pillar/soc/license.sls features) - if [[ $? -ne 0 || ! "$FEATURES" =~ "hvn" ]]; then + if [[ $? -ne 0 || ! "$FEATURES" =~ "vrt" ]]; then error_msg="Hypervisor nodes are a feature supported only for customers with a valid license.\n Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n for more information about purchasing a license to enable this feature." log "ERROR" "$error_msg" echo -e "Error: $error_msg" @@ -869,7 +869,7 @@ function createRECEIVER() { function createHYPERVISOR() { log "INFO" "Creating HYPERVISOR configuration for minion $MINION_ID" FEATURES=$(/usr/sbin/so-yaml.py get /opt/so/saltstack/local/pillar/soc/license.sls features) - if [[ $? -ne 0 || ! "$FEATURES" =~ "hvn" ]]; then + if [[ $? -ne 0 || ! "$FEATURES" =~ "vrt" ]]; then error_msg="Hypervisor nodes are a feature supported only for customers with a valid license.\n Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n for more information about purchasing a license to enable this feature." log "ERROR" "$error_msg" echo -e "Error: $error_msg" @@ -964,7 +964,7 @@ function updateMineAndApplyStates() { # We don't want a hypervisor node to highstate until the image is downloaded and built. This will be triggered from the setup_hypervisor runner if [[ "$NODETYPE" == "HYPERVISOR" ]]; then FEATURES=$(/usr/sbin/so-yaml.py get /opt/so/saltstack/local/pillar/soc/license.sls features) - if [[ $? -ne 0 || ! "$FEATURES" =~ "hvn" ]]; then + if [[ $? -ne 0 || ! "$FEATURES" =~ "vrt" ]]; then error_msg="Hypervisor nodes are a feature supported only for customers with a valid license.\n Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n for more information about purchasing a license to enable this feature." log "ERROR" "$error_msg" echo -e "Error: $error_msg" @@ -1058,7 +1058,7 @@ case "$OPERATION" in "addVM") log "INFO" "Adding VM minion $MINION_ID" FEATURES=$(/usr/sbin/so-yaml.py get /opt/so/saltstack/local/pillar/soc/license.sls features) - if [[ $? -ne 0 || ! "$FEATURES" =~ "hvn" ]]; then + if [[ $? -ne 0 || ! "$FEATURES" =~ "vrt" ]]; then error_msg="Hypervisor nodes are a feature supported only for customers with a valid license.\n Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n for more information about purchasing a license to enable this feature." log "ERROR" "$error_msg" echo -e "Error: $error_msg" diff --git a/salt/manager/tools/sbin_jinja/so-salt-cloud b/salt/manager/tools/sbin_jinja/so-salt-cloud index cddcbb474..f1346130f 100644 --- a/salt/manager/tools/sbin_jinja/so-salt-cloud +++ b/salt/manager/tools/sbin_jinja/so-salt-cloud @@ -11,7 +11,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) -%} +{% if 'vrt' in salt['pillar.get']('features', []) -%} """ Script for automated virtual machine provisioning and configuration in Security Onion's virtualization infrastructure. diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index 624bb12f3..859e87df6 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -9,7 +9,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {% do salt.log.info('dyanno_hypervisor_orch: Running') %} {% set vm_name = None %} diff --git a/salt/orch/vm_pillar_clean.sls b/salt/orch/vm_pillar_clean.sls index 5c0011f6f..ca5c16054 100644 --- a/salt/orch/vm_pillar_clean.sls +++ b/salt/orch/vm_pillar_clean.sls @@ -9,7 +9,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {% do salt.log.debug('vm_pillar_clean_orch: Running') %} {% set vm_name = pillar.get('vm_name') %} diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index 5ba8b96da..114133204 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -11,7 +11,7 @@ {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls in allowed_states %} -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {% from 'salt/map.jinja' import SALTVERSION %} {% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {} ) %} diff --git a/salt/salt/cloud/reactor_config_hypervisor.sls b/salt/salt/cloud/reactor_config_hypervisor.sls index fcf1a5dfe..d0851d75c 100644 --- a/salt/salt/cloud/reactor_config_hypervisor.sls +++ b/salt/salt/cloud/reactor_config_hypervisor.sls @@ -11,7 +11,7 @@ {% from 'allowed_states.map.jinja' import allowed_states %} {% if sls.split('.')[:2]|join('.') in allowed_states %} -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} reactor_config_hypervisor: file.managed: - name: /etc/salt/master.d/reactor_hypervisor.conf diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index 42d8f6725..78f8f0294 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -63,7 +63,7 @@ State Files: - .error: Error state with detailed message Notes: - - Requires 'hvn' feature license + - Requires 'vrt' feature license - Uses hypervisor's sosmodel grain for hardware capabilities - Hardware allocation based on model-specific configurations - All created files maintain socore ownership @@ -80,7 +80,7 @@ Description: - Lock remains until clean shutdown or error 2. License Validation - - Verifies 'hvn' feature is licensed + - Verifies 'vrt' feature is licensed - Prevents operation if license is invalid 3. Configuration Processing @@ -567,7 +567,7 @@ def mark_invalid_hardware(hypervisor_path: str, vm_name: str, config: dict, erro log.error("Failed to create invalid hardware file: %s", str(e)) raise -def validate_hvn_license() -> bool: +def validate_vrt_license() -> bool: """Check if the license file exists and contains required values.""" if not os.path.exists(LICENSE_PATH): log.error("License file not found at %s", LICENSE_PATH) @@ -588,7 +588,7 @@ def validate_hvn_license() -> bool: log.error("No license_id found in license file") return False - if 'hvn' not in features: + if 'vrt' not in features: log.error("Hypervisor nodes are a feature supported only for customers with a valid license.\n" "Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com\n" "for more information about purchasing a license to enable this feature.") @@ -889,7 +889,7 @@ def start(interval: int = DEFAULT_INTERVAL, """ log.info("Starting virtual node manager engine") - if not validate_hvn_license(): + if not validate_vrt_license(): return # Attempt to acquire lock diff --git a/salt/salt/files/hvn_engine.conf b/salt/salt/files/vrt_engine.conf similarity index 100% rename from salt/salt/files/hvn_engine.conf rename to salt/salt/files/vrt_engine.conf diff --git a/salt/salt/master.sls b/salt/salt/master.sls index d6bd84496..413c90cd5 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -14,7 +14,7 @@ include: - salt.minion -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} - salt.cloud - salt.cloud.reactor_config_hypervisor @@ -48,11 +48,11 @@ pillarWatch_engine: - name: /etc/salt/engines/pillarWatch.py - source: salt://salt/engines/master/pillarWatch.py -{% if 'hvn' in salt['pillar.get']('features', []) %} -hvn_engine_config: +{% if 'vrt' in salt['pillar.get']('features', []) %} +vrt_engine_config: file.managed: - - name: /etc/salt/master.d/hvn_engine.conf - - source: salt://salt/files/hvn_engine.conf + - name: /etc/salt/master.d/vrt_engine.conf + - source: salt://salt/files/vrt_engine.conf - watch_in: - service: salt_master_service diff --git a/salt/sensor/init.sls b/salt/sensor/init.sls index 4008879e9..9c7e52d62 100644 --- a/salt/sensor/init.sls +++ b/salt/sensor/init.sls @@ -9,7 +9,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features') and salt['grains.get']('salt-cloud', {}) %} +{% if 'vrt' in salt['pillar.get']('features') and salt['grains.get']('salt-cloud', {}) %} include: - sensor.vm.network diff --git a/salt/sensor/vm/network.sls b/salt/sensor/vm/network.sls index f056e307a..9e25bca65 100644 --- a/salt/sensor/vm/network.sls +++ b/salt/sensor/vm/network.sls @@ -9,7 +9,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {% set mainint = salt['pillar.get']('host:mainint', 'enp1s0') %} {% set interfaces = salt['network.interfaces']() %} diff --git a/salt/soc/dyanno/hypervisor/init.sls b/salt/soc/dyanno/hypervisor/init.sls index e4ce3b47c..1f17552e7 100644 --- a/salt/soc/dyanno/hypervisor/init.sls +++ b/salt/soc/dyanno/hypervisor/init.sls @@ -9,7 +9,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {% from 'hypervisor/map.jinja' import HYPERVISORS %} diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 17603ab9d..8976e7cc7 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -9,7 +9,7 @@ in the software, and you may not remove or obscure any functionality in the software that is protected by the license key." #} -{%- if 'hvn' in salt['pillar.get']('features', []) -%} +{%- if 'vrt' in salt['pillar.get']('features', []) -%} {%- import_yaml 'soc/dyanno/hypervisor/hypervisor.yaml' as ANNOTATION -%} {%- from 'hypervisor/map.jinja' import HYPERVISORS -%} diff --git a/salt/soc/dyanno/hypervisor/write_status.sls b/salt/soc/dyanno/hypervisor/write_status.sls index d2aa590e6..60a94b3e9 100644 --- a/salt/soc/dyanno/hypervisor/write_status.sls +++ b/salt/soc/dyanno/hypervisor/write_status.sls @@ -9,7 +9,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} {# Import the process steps from map.jinja #} {% from 'soc/dyanno/hypervisor/map.jinja' import PROCESS_STEPS %} diff --git a/salt/top.sls b/salt/top.sls index 5a0c7416b..4f8029706 100644 --- a/salt/top.sls +++ b/salt/top.sls @@ -155,7 +155,7 @@ base: - stig - kafka - '*_managerhype and I@features:hvn and G@saltversion:{{saltversion}}': + '*_managerhype and I@features:vrt and G@saltversion:{{saltversion}}': - match: compound - manager.hypervisor @@ -299,7 +299,7 @@ base: - elasticfleet.install_agent_grid - schedule - '*_hypervisor and I@features:hvn and G@saltversion:{{saltversion}}': + '*_hypervisor and I@features:vrt and G@saltversion:{{saltversion}}': - match: compound - ssl - sensoroni diff --git a/salt/vm_status/init.sls b/salt/vm_status/init.sls index c6b39c12e..570b36d19 100644 --- a/salt/vm_status/init.sls +++ b/salt/vm_status/init.sls @@ -9,7 +9,7 @@ # in the software, and you may not remove or obscure any functionality in the # software that is protected by the license key." -{% if 'hvn' in salt['pillar.get']('features', []) %} +{% if 'vrt' in salt['pillar.get']('features', []) %} # Send highstate trigger event for VM deployment status tracking # so-salt-emit-vm-deployment-status sets event_tag = f'soc/dyanno/hypervisor/{status.lower()}' From 8f3664f26c4dcf057e88f3ece0d2f7a2a7fc71f3 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 4 Apr 2025 09:00:22 -0400 Subject: [PATCH 165/303] need to sync --- setup/so-setup | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/setup/so-setup b/setup/so-setup index 5b8a14a01..115bdadb7 100755 --- a/setup/so-setup +++ b/setup/so-setup @@ -753,13 +753,12 @@ if ! [[ -f $install_opt_file ]]; then logCmd "salt-call state.show_top" sleep 2 # Debug RSA Key format errors logCmd "salt-key -ya $MINION_ID" + logCmd "salt-call saltutil.sync_all" # we need to sync the runner and generate the soqemussh user keys so that first highstate after license created # doesnt have a state failure for soqemussh_pub_key source for id_ed25519.pub missing if [[ $is_manager || $is_managerhype ]]; then logCmd "salt-run saltutil.sync_all" logCmd "salt-run setup_hypervisor.regenerate_ssh_keys" - else - logCmd "salt-call saltutil.sync_all" fi logCmd "salt-call state.apply common.packages" logCmd "salt-call state.apply common" From bf9f92b04eefa7b15d86fafddc4f2e9c0caf71cf Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 4 Apr 2025 13:47:54 -0400 Subject: [PATCH 166/303] remove soc_hypervisor.yaml --- salt/hypervisor/soc_hypervisor.yaml | 15 --------------- 1 file changed, 15 deletions(-) delete mode 100644 salt/hypervisor/soc_hypervisor.yaml diff --git a/salt/hypervisor/soc_hypervisor.yaml b/salt/hypervisor/soc_hypervisor.yaml deleted file mode 100644 index 571b1661d..000000000 --- a/salt/hypervisor/soc_hypervisor.yaml +++ /dev/null @@ -1,15 +0,0 @@ -# This is the start of an example of what this file will look like. It will be generated by Salt, so this yaml file is not used by Salt. -hypervisor: - hosts: - jpphype1: - add_searchnode: - description: Add a new searchnode to the hypervisor. - file: true - global: true - multiline: true - add_sensor: - description: Add a new sensor to the hypervisor. - file: true - global: true - multiline: true - guests: {} From f6a0e6285326cd613386c7fdee4f98c830d4187f Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 8 Apr 2025 09:50:26 -0400 Subject: [PATCH 167/303] include managerhype in orch. run hypervisor state before libvirt states --- salt/manager/hypervisor.sls | 2 +- salt/orch/dyanno_hypervisor.sls | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/salt/manager/hypervisor.sls b/salt/manager/hypervisor.sls index 84cd478c8..315775446 100644 --- a/salt/manager/hypervisor.sls +++ b/salt/manager/hypervisor.sls @@ -28,9 +28,9 @@ {% if ssh_user_exists and ssh_keys_exist and base_image_exists and vm_files_exist and hypervisor_host_dir_exists %} # Hypervisor environment is already set up, include the necessary states include: + - hypervisor - libvirt - libvirt.images - - hypervisor hypervisor_setup_verified: test.succeed_without_changes: diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index 859e87df6..a47e3c1b6 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -89,7 +89,7 @@ {% if vm_name and hypervisor and timestamp and status and tag %} write_vm_status: salt.state: - - tgt: 'G@role:so-manager or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' + - tgt: 'G@role:so-manager or G@role:so-managerhype or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' - tgt_type: compound - sls: - soc.dyanno.hypervisor.write_status @@ -106,7 +106,7 @@ write_vm_status: # Update hypervisor status update_hypervisor_annotation: salt.state: - - tgt: 'G@role:so-manager or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' + - tgt: 'G@role:so-manager or G@role:so-managerhype or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' - tgt_type: compound - sls: - soc.dyanno.hypervisor From 0f120f7500a57e7735b816622962d2a12448fd07 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 9 Apr 2025 11:19:18 -0400 Subject: [PATCH 168/303] ensure manager is in /etc/hosts --- salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja | 2 ++ salt/salt/cloud/init.sls | 2 ++ 2 files changed, 4 insertions(+) diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 00b1a76c1..128dc9fc6 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -34,6 +34,8 @@ sool9-{{host}}: grains: hypervisor_host: {{host ~ "_" ~ role}} preflight_cmds: + - | + tee -a /etc/hosts <<< "{{ MANAGERIP }} {{ MANAGERHOSTNAME }}" - | timeout 600 bash -c 'trap "echo \"Preflight Check: Failed to establish repo connectivity\"; exit 1" TERM; \ while ! dnf makecache --repoid=securityonion >/dev/null 2>&1; do echo "Preflight Check: Waiting for repo connectivity..."; \ diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index 114133204..c2d885e3c 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -40,6 +40,8 @@ cloud_profiles: - source: salt://salt/cloud/cloud.profiles.d/socloud.conf.jinja - defaults: HYPERVISORS: {{HYPERVISORS}} + MANAGERHOSTNAME: {{ grains.host }} + MANAGERIP: {{ pillar.host.mainip }} - template: jinja {% for role, hosts in HYPERVISORS.items() %} From 8ab38956d19c46be66d0058174dfd62c08c5a337 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 9 Apr 2025 11:19:55 -0400 Subject: [PATCH 169/303] change from error to warning --- salt/manager/tools/sbin/so-firewall | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/manager/tools/sbin/so-firewall b/salt/manager/tools/sbin/so-firewall index 44f812cec..23a174588 100755 --- a/salt/manager/tools/sbin/so-firewall +++ b/salt/manager/tools/sbin/so-firewall @@ -89,7 +89,7 @@ def addIp(name, ip): writeYaml(hostgroupsFilename, content) logger.info(f"Successfully added IP {ip} to hostgroup {name}") else: - logger.error(f"IP {ip} already exists in hostgroup {name}") + logger.warning(f"IP {ip} already exists in hostgroup {name}") return 3 return 0 From 888ab162bdbc2ca5a7b422d63393d6ba18836d13 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 10 Apr 2025 15:04:08 -0400 Subject: [PATCH 170/303] update mine_functions and mine after mainint switch to br0. ensure br0 has ip before updating mine --- salt/libvirt/init.sls | 35 +++++++++++++++++++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index f82b3d9c1..1312cc112 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -100,8 +100,39 @@ down_original_mgmt_interface: - unless: - nmcli -f GENERAL.CONNECTION dev show {{ pillar.host.mainint }} | grep bridge-slave-{{ pillar.host.mainint }} - order: last - - onchanges_in: - - file: mine_functions + +update_mine_functions_interface: + file.replace: + - name: /etc/salt/minion.d/mine_functions.conf + - pattern: " - interface: ([a-zA-Z0-9]+)" + - repl: " - interface: br0" + - onchanges: + - cmd: down_original_mgmt_interface + +wait_for_br0_ip: + cmd.run: + - name: | + counter=0 + until ip addr show br0 | grep -q "inet "; do + sleep 1 + counter=$((counter+1)) + if [ $counter -ge 90 ]; then + echo "Timeout waiting for br0 to get an IP address" + exit 1 + fi + done + echo "br0 has IP address: $(ip addr show br0 | grep 'inet ' | awk '{print $2}')" + - timeout: 95 + - onchanges: + - file: update_mine_functions_interface + +mine_update_mine_interface: + module.run: + - mine.send: + - network.ip_addrs + - interface: br0 + - onchanges: + - cmd: wait_for_br0_ip # virtlogd service may not restart following reboot without this #semanage permissive -a virtlogd_t From 0bcb6040c9e0ccccc18ac3ca60c66679877a155b Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 18 Apr 2025 14:02:17 -0400 Subject: [PATCH 171/303] recreate sool9 if user-data or meta-data cloud-init changes --- salt/libvirt/images/init.sls | 30 ++++++++++++++---------------- 1 file changed, 14 insertions(+), 16 deletions(-) diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index c7734c69d..43fc400bd 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -29,6 +29,17 @@ manage_sha256_sool9: - source: salt://libvirt/images/sool9/sool9.sha256 - makedirs: True +# Manage cloud-init files +manage_metadata_sool9: + file.managed: + - name: /nsm/libvirt/images/sool9/meta-data + - source: salt://libvirt/images/sool9/meta-data + +manage_userdata_sool9: + file.managed: + - name: /nsm/libvirt/images/sool9/user-data + - source: salt://libvirt/images/sool9/user-data + # Manage qcow2 image manage_qcow2_sool9: file.managed: @@ -36,27 +47,14 @@ manage_qcow2_sool9: - source: salt://libvirt/images/sool9/sool9.qcow2 - onchanges: - file: manage_sha256_sool9 - -# Manage cloud-init files -manage_metadata_sool9: - file.managed: - - name: /nsm/libvirt/images/sool9/meta-data - - source: salt://libvirt/images/sool9/meta-data - - require: - - file: manage_qcow2_sool9 - -manage_userdata_sool9: - file.managed: - - name: /nsm/libvirt/images/sool9/user-data - - source: salt://libvirt/images/sool9/user-data - - require: - - file: manage_qcow2_sool9 + - file: manage_metadata_sool9 + - file: manage_userdata_sool9 manage_cidata_sool9: file.managed: - name: /nsm/libvirt/images/sool9/sool9-cidata.iso - source: salt://libvirt/images/sool9/sool9-cidata.iso - - require: + - onchanges: - file: manage_qcow2_sool9 # Define the storage pool From 285d73d52632a4b06d37166af8ab58fd934d7b07 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 18 Apr 2025 14:07:32 -0400 Subject: [PATCH 172/303] enable/disable soqemussh. allow for pw to be set --- pillar/top.sls | 5 +++ salt/_runners/setup_hypervisor.py | 29 ++++++++++--- salt/top.sls | 3 +- salt/vm/defaults.yaml | 5 +++ salt/vm/map.jinja | 25 ++++++++++++ salt/vm/soc_vm.yaml | 10 +++++ salt/{vm_status => vm/status}/init.sls | 0 salt/vm/user/init.sls | 56 ++++++++++++++++++++++++++ 8 files changed, 127 insertions(+), 6 deletions(-) create mode 100644 salt/vm/defaults.yaml create mode 100644 salt/vm/map.jinja create mode 100644 salt/vm/soc_vm.yaml rename salt/{vm_status => vm/status}/init.sls (100%) create mode 100644 salt/vm/user/init.sls diff --git a/pillar/top.sls b/pillar/top.sls index c118073a1..1fdb59deb 100644 --- a/pillar/top.sls +++ b/pillar/top.sls @@ -26,6 +26,11 @@ base: - nginx.soc_nginx - nginx.adv_nginx + 'salt-cloud:driver:libvirt': + - match: grain + - vm.soc_vm + - vm.adv_vm + '*_manager or *_managersearch or *_managerhype': - match: compound - node_data.ips diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 35d1bad21..028771291 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -10,8 +10,6 @@ # software that is protected by the license key." """ -TODO: Remove passwd hash prior to release. used for development - This runner performs the initial setup required for hypervisor hosts in the Security Onion environment. It handles downloading the Oracle Linux KVM image, setting up SSH keys for secure communication, and creating virtual machines with cloud-init configuration. @@ -715,6 +713,24 @@ def create_vm(vm_name: str, disk_size: str = '220G'): log.error("CREATEVM: Failed to read SSH public key: %s", str(e)) return {'success': False, 'error': 'Failed to read SSH public key'} + # Read pillar data for soqemussh password hash + pillar_path = '/opt/so/saltstack/local/pillar/vm/soc_vm.sls' + password_hash = None + passwd_line = "" # Default to empty if no hash found + try: + if os.path.exists(pillar_path): + with salt.utils.files.fopen(pillar_path, 'r') as f: + pillar_data = yaml.safe_load(f) + if pillar_data: + password_hash = pillar_data.get('vm', {}).get('user', {}).get('soqemussh', {}).get('passwordHash') + if password_hash: + passwd_line = f" passwd: {password_hash}\n" + log.info("CREATEVM: Found soqemussh password hash in pillar.") + else: + log.info("CREATEVM: No soqemussh password hash found in pillar, omitting passwd line.") + except Exception as e: + log.warning(f"CREATEVM: Error reading or parsing pillar file {pillar_path}: {str(e)}. Omitting passwd line.") + # Read and encode GPG keys keys_dir = '/opt/so/saltstack/default/salt/repo/client/files/oracle/keys' oracle_key = _read_and_encode_key(os.path.join(keys_dir, 'RPM-GPG-KEY-oracle')) @@ -752,8 +768,7 @@ users: shell: /bin/bash sudo: ALL=(ALL) NOPASSWD:ALL lock_passwd: false - passwd: $6$THWuTZMZhIVMGaaw$w9kozn7z7i0Y9LRVGZwN6mcZag4vMpE3hW6eCtKNHlFpL1XLcOdiIr29JyDxx3MLBXNedIqnqcj4psqCjv58d. - ssh_authorized_keys: +{passwd_line} ssh_authorized_keys: - {ssh_pub_key} # Configure where output will go @@ -796,6 +811,10 @@ write_files: content: | {securityonion_key} +# Run on every boot - this will only run *after* the first boot and successful cloud-init run +bootcmd: + - if [ -f /var/lib/cloud/instance/boot-finished ]; then touch /etc/cloud/cloud-init.disabled; fi + runcmd: # Import GPG keys and remove repo files except securityonion.repo - rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-oracle @@ -811,7 +830,6 @@ runcmd: - pvresize /dev/vda2 - lvextend -l +100%FREE /dev/vg_main/lv_root - xfs_growfs /dev/vg_main/lv_root - - touch /etc/cloud/cloud-init.disabled - rm -f /etc/sysconfig/network-scripts/ifcfg-eth0 power_state: @@ -819,6 +837,7 @@ power_state: mode: poweroff timeout: 30 condition: True + message: Cloud-init completed, powering off """ user_data_path = os.path.join(vm_dir, 'user-data') with salt.utils.files.fopen(user_data_path, 'w') as f: diff --git a/salt/top.sls b/salt/top.sls index 4f8029706..073f24d29 100644 --- a/salt/top.sls +++ b/salt/top.sls @@ -11,7 +11,8 @@ base: 'salt-cloud:driver:libvirt': - match: grain - storage - - vm_status + - vm.status + - vm.user '*': - cron.running diff --git a/salt/vm/defaults.yaml b/salt/vm/defaults.yaml new file mode 100644 index 000000000..f9d607532 --- /dev/null +++ b/salt/vm/defaults.yaml @@ -0,0 +1,5 @@ +vm: + user: + soqemussh: + enabled: False + passwordHash: diff --git a/salt/vm/map.jinja b/salt/vm/map.jinja new file mode 100644 index 000000000..c55784e8f --- /dev/null +++ b/salt/vm/map.jinja @@ -0,0 +1,25 @@ +{# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one + or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at + https://securityonion.net/license; you may not use this file except in compliance with the + Elastic License 2.0. + + Note: Per the Elastic License 2.0, the second limitation states: + + "You may not move, change, disable, or circumvent the license key functionality + in the software, and you may not remove or obscure any functionality in the + software that is protected by the license key." #} + +{% if 'vrt' in salt['pillar.get']('features', []) %} + +{% import_yaml 'vm/defaults.yaml' as VMDEFAULTS %} +{% set VMMERGED = salt['pillar.get']('vm', VMDEFAULTS.vm, merge=True) %} + +{% else %} + +{% do salt.log.error( + 'Hypervisor nodes are a feature supported only for customers with a valid license.' + 'Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com' + 'for more information about purchasing a license to enable this feature.' +) %} + +{% endif %} diff --git a/salt/vm/soc_vm.yaml b/salt/vm/soc_vm.yaml new file mode 100644 index 000000000..3b3cdbbfa --- /dev/null +++ b/salt/vm/soc_vm.yaml @@ -0,0 +1,10 @@ +vm: + user: + soqemussh: + enabled: + description: Enable or disable the soqemussh user. + forcedType: bool + passwordHash: + description: 'Enter a SHA-512 password hash to set the soqemussh user password. Generate this hash by running the following command on the manager: `openssl passwd -6`' + forcedType: string + global: True diff --git a/salt/vm_status/init.sls b/salt/vm/status/init.sls similarity index 100% rename from salt/vm_status/init.sls rename to salt/vm/status/init.sls diff --git a/salt/vm/user/init.sls b/salt/vm/user/init.sls new file mode 100644 index 000000000..48185a9da --- /dev/null +++ b/salt/vm/user/init.sls @@ -0,0 +1,56 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% if 'vrt' in salt['pillar.get']('features', []) %} + +{% from 'vm/map.jinja' import VMMERGED %} + +{% if VMMERGED.user.soqemussh.enabled %} + +vm_user_soqemussh: + user.present: + - name: soqemussh + - shell: /bin/bash + - home: /home/soqemussh +{% if VMMERGED.user.soqemussh.passwordHash %} + - password: '{{ VMMERGED.user.soqemussh.passwordHash }}' +{% endif %} + +vm_user_soqemussh_home_directory: + file.directory: + - name: /home/soqemussh + - user: soqemussh + - group: soqemussh + - mode: 700 + - recurse: + - user + - group + +{% else %} + +vm_user_soqemussh: + user.absent: + - name: soqemussh + - force: True + +{% endif %} + +{% else %} + +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." + +{% endif %} From 4df3070a1d1ccc03a57c30c6342b87cba3041d08 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 24 Apr 2025 12:59:06 -0400 Subject: [PATCH 173/303] ensure file permissions of libvirt images --- salt/libvirt/images/init.sls | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 43fc400bd..40017b3a5 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -16,6 +16,15 @@ include: - libvirt.packages +nsm_libvirt_images: + file.directory: + - name: /nsm/libvirt/images/sool9 + - dir_mode: 775 + - file_mode: 640 + - recurse: + - mode + - makedirs: True + # Remove hash file if image isn't present. This will allow for the image to redownload and initialize. remove_sha256_sool9: file.absent: @@ -27,7 +36,6 @@ manage_sha256_sool9: file.managed: - name: /nsm/libvirt/images/sool9/sool9.sha256 - source: salt://libvirt/images/sool9/sool9.sha256 - - makedirs: True # Manage cloud-init files manage_metadata_sool9: From b2bd8577b97a6d9528c87a2b1f31169b65c3df8b Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 24 Apr 2025 12:59:43 -0400 Subject: [PATCH 174/303] only update mine if hypervisor provided --- salt/_runners/setup_hypervisor.py | 45 ++++++++++++++++--------------- 1 file changed, 23 insertions(+), 22 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 028771291..c1984760b 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -516,29 +516,30 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id 'vm_result': None } - # Initialize the LocalClient - local = salt.client.LocalClient() - - # Add retry logic for mine.update - max_retries = 10 - retry_delay = 3 - mine_update_success = False - - for attempt in range(1, max_retries + 1): - mine_update_result = local.cmd(minion_id, 'mine.update') - log.debug(f"DYANNO: mine_update_result: {mine_update_result}") + if minion_id: + # Initialize the LocalClient + local = salt.client.LocalClient() - # Check if mine.update was successful - if mine_update_result and all(mine_update_result.values()): - log.info(f"DYANNO: mine.update successful on attempt {attempt}") - mine_update_success = True - break - else: - log.warning(f"DYANNO: mine.update failed on attempt {attempt}/{max_retries}, retrying in {retry_delay} seconds...") - time.sleep(retry_delay) - - if not mine_update_success: - log.error(f"DYANNO: mine.update failed after {max_retries} attempts") + # Add retry logic for mine.update + max_retries = 10 + retry_delay = 3 + mine_update_success = False + + for attempt in range(1, max_retries + 1): + mine_update_result = local.cmd(minion_id, 'mine.update') + log.debug(f"DYANNO: mine_update_result: {mine_update_result}") + + # Check if mine.update was successful + if mine_update_result and all(mine_update_result.values()): + log.info(f"DYANNO: mine.update successful on attempt {attempt}") + mine_update_success = True + break + else: + log.warning(f"DYANNO: mine.update failed on attempt {attempt}/{max_retries}, retrying in {retry_delay} seconds...") + time.sleep(retry_delay) + + if not mine_update_success: + log.error(f"DYANNO: mine.update failed after {max_retries} attempts") # Apply the soc.dyanno.hypervisor state on the salt master if not _apply_dyanno_hypervisor_state(): From 151db2af30aa7bc17e11f0b553e1d4784aa03917 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 28 Apr 2025 15:38:29 -0400 Subject: [PATCH 175/303] ensure ownership and mode --- salt/_runners/setup_hypervisor.py | 40 +++++++++++++++++++++++++++++-- 1 file changed, 38 insertions(+), 2 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index c1984760b..6db1def5c 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -86,6 +86,19 @@ formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(messag stream_handler.setFormatter(formatter) log.addHandler(stream_handler) +def _set_ownership_and_perms(path: str, mode: int): + """Set ownership to socore:socore and apply file mode.""" + try: + socore_uid = pwd.getpwnam('socore').pw_uid + socore_gid = pwd.getpwnam('socore').pw_gid + os.chown(path, socore_uid, socore_gid) + os.chmod(path, mode) + log.debug(f"PERMS: Set ownership socore:socore and mode {oct(mode)} for {path}") + except KeyError: + log.warning(f"PERMS: socore user not found, skipping ownership/permission change for {path}") + except Exception as e: + log.warning(f"PERMS: Failed to set ownership/permissions for {path}: {str(e)}") + def _read_and_encode_key(key_path: str) -> str: """Read a key file and return its base64 encoded content.""" try: @@ -704,6 +717,8 @@ def create_vm(vm_name: str, disk_size: str = '220G'): base_dir = '/opt/so/saltstack/local/salt/libvirt/images' vm_dir = f'{base_dir}/{vm_name}' os.makedirs(vm_dir, exist_ok=True) + # Set ownership and permissions for the VM directory + _set_ownership_and_perms(vm_dir, mode=0o750) # Read the SSH public key pub_key_path = '/opt/so/saltstack/local/salt/libvirt/ssh/keys/id_ed25519.pub' @@ -745,15 +760,23 @@ def create_vm(vm_name: str, disk_size: str = '220G'): local-hostname: {vm_name} """ meta_data_path = os.path.join(vm_dir, 'meta-data') + # Create empty file, set perms, then write + open(meta_data_path, 'a').close() + _set_ownership_and_perms(meta_data_path, mode=0o640) with salt.utils.files.fopen(meta_data_path, 'w') as f: f.write(meta_data) + log.info("CREATEVM: Created meta-data") # Create network-data network_data = """network: config: disabled""" network_data_path = os.path.join(vm_dir, 'network-data') + # Create empty file, set perms, then write + open(network_data_path, 'a').close() + _set_ownership_and_perms(network_data_path, mode=0o640) with salt.utils.files.fopen(network_data_path, 'w') as f: f.write(network_data) + log.info("CREATEVM: Created network-data") # Create user-data user_data = f"""#cloud-config @@ -841,8 +864,12 @@ power_state: message: Cloud-init completed, powering off """ user_data_path = os.path.join(vm_dir, 'user-data') + # Create empty file, set perms, then write + open(user_data_path, 'a').close() + _set_ownership_and_perms(user_data_path, mode=0o640) with salt.utils.files.fopen(user_data_path, 'w') as f: f.write(user_data) + log.info("CREATEVM: Created user-data") # Copy and resize base image base_image = IMAGE_PATH @@ -852,8 +879,10 @@ power_state: import shutil log.info("CREATEVM: Copying base image to %s", vm_image) shutil.copy2(base_image, vm_image) + # Set ownership and permissions for the copied image + _set_ownership_and_perms(vm_image, mode=0o640) log.info("CREATEVM: Base image copy complete") - + # Get current image size import subprocess try: @@ -908,6 +937,8 @@ power_state: # Check if compression completed successfully if process.returncode == 0: os.replace(temp_image, vm_image) + # Set ownership and permissions for the compressed image + _set_ownership_and_perms(vm_image, mode=0o640) log.info("CREATEVM: Image compression complete") else: error = process.stderr.read().decode('utf-8') @@ -921,6 +952,9 @@ power_state: subprocess.run(['mkisofs', '-output', cidata_iso, '-volid', 'CIDATA', '-rock', user_data_path, meta_data_path, network_data_path], check=True, capture_output=True) + # Set ownership and permissions for the created ISO + _set_ownership_and_perms(cidata_iso, mode=0o640) + log.info("CREATEVM: Created cidata ISO") # Generate SHA256 hash of the qcow2 image sha256_hash = hashlib.sha256() @@ -932,7 +966,9 @@ power_state: hash_file = os.path.join(vm_dir, f'{vm_name}.sha256') with salt.utils.files.fopen(hash_file, 'w') as f: f.write(sha256_hash.hexdigest()) - + # Set ownership and permissions for the hash file + _set_ownership_and_perms(hash_file, mode=0o640) + log.info("CREATEVM: Generated SHA256 hash for %s", vm_image) return { From 6246e25fbeb60c453770ef5e65f3a678ad0d741e Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 29 Apr 2025 10:19:01 -0400 Subject: [PATCH 176/303] 640 for pubkey and empty pillar --- salt/_runners/setup_hypervisor.py | 2 +- salt/reactor/createEmptyPillar.sls | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 6db1def5c..fd1496c85 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -300,7 +300,7 @@ def _setup_ssh_keys(): # Set proper permissions os.chmod(key_path, 0o600) - os.chmod(pub_key_path, 0o644) + os.chmod(pub_key_path, 0o640) log.info("SETUP_KEYS: SSH keys generated successfully") diff --git a/salt/reactor/createEmptyPillar.sls b/salt/reactor/createEmptyPillar.sls index dccf25f89..c6c655bab 100644 --- a/salt/reactor/createEmptyPillar.sls +++ b/salt/reactor/createEmptyPillar.sls @@ -29,7 +29,7 @@ def run(): # Set ownership to socore:socore os.chown(full_path, socore_uid, socore_gid) # Set mode to 644 (rw-r--r--) - os.chmod(full_path, 0o644) + os.chmod(full_path, 0o640) logging.error("createEmptyPillar reactor: created %s with socore:socore ownership and mode 644" % f) except (KeyError, OSError) as e: From c3b3e0ab2142a4032f2bd66af7f2e0cbd54f1d50 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 30 Apr 2025 08:12:35 -0400 Subject: [PATCH 177/303] manager hostname in pubkey --- salt/_runners/setup_hypervisor.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index fd1496c85..618da9dd8 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -289,7 +289,7 @@ def _setup_ssh_keys(): encoding=serialization.Encoding.OpenSSH, format=serialization.PublicFormat.OpenSSH ) - public_bytes = public_bytes + b' soqemussh@salt-master\n' + public_bytes = public_bytes + f' soqemussh@{MANAGER_HOSTNAME}\n'.encode('utf-8') # Write the keys to files with salt.utils.files.fopen(key_path, 'wb') as f: From 7a60afdd5a2f3f0abe5411d7f1843c16aa812d54 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 30 Apr 2025 09:11:55 -0400 Subject: [PATCH 178/303] remove duplicate logging --- salt/_runners/setup_hypervisor.py | 6 ------ 1 file changed, 6 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 618da9dd8..dc0d9eca8 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -79,12 +79,6 @@ from cryptography.hazmat.primitives.asymmetric import ed25519 log = logging.getLogger(__name__) log.setLevel(logging.DEBUG) -# Ensure we have a stream handler -stream_handler = logging.StreamHandler(sys.stdout) -stream_handler.setLevel(logging.DEBUG) -formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') -stream_handler.setFormatter(formatter) -log.addHandler(stream_handler) def _set_ownership_and_perms(path: str, mode: int): """Set ownership to socore:socore and apply file mode.""" From 5a8e542f968df3e74fc29f5173dc44441a604af5 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 30 Apr 2025 13:08:54 -0400 Subject: [PATCH 179/303] create macro for resource regex and fix regex logic for mem and cpu --- .../hypervisor/soc_hypervisor.yaml.jinja | 81 ++++++++++--------- 1 file changed, 45 insertions(+), 36 deletions(-) diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 8976e7cc7..8ac7a7225 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -68,6 +68,49 @@ Base domain has not been initialized. {{- available | join(',') -}} {%- endmacro -%} +{%- macro update_resource_field(field, free_value, total_value, unit_label) -%} +{%- set resource_regex = '' -%} +{%- if free_value < 10 -%} +{%- set resource_regex = '^[1-' ~ free_value ~ ']$' -%} +{%- elif free_value < 100 -%} +{%- set tens_digit = free_value // 10 -%} +{%- set ones_digit = free_value % 10 -%} +{%- if ones_digit == 0 -%} +{%- set resource_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '0)$' -%} +{%- else -%} +{%- set resource_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} +{%- endif -%} +{%- elif free_value < 1000 -%} +{%- set hundreds_digit = free_value // 100 -%} +{%- set tens_digit = (free_value % 100) // 10 -%} +{%- set ones_digit = free_value % 10 -%} +{%- if hundreds_digit == 1 -%} +{%- if tens_digit == 0 and ones_digit == 0 -%} +{%- set resource_regex = '^([1-9]|[1-9][0-9]|100)$' -%} +{%- elif tens_digit == 0 -%} +{%- set resource_regex = '^([1-9]|[1-9][0-9]|10[0-' ~ ones_digit ~ '])$' -%} +{%- elif ones_digit == 0 -%} +{%- set resource_regex = '^([1-9]|[1-9][0-9]|10[0-9]|1[1-' ~ tens_digit ~ ']0)$' -%} +{%- else -%} +{%- set resource_regex = '^([1-9]|[1-9][0-9]|10[0-9]|1[1-' ~ (tens_digit-1) ~ '][0-9]|1' ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} +{%- endif -%} +{%- else -%} +{%- if tens_digit == 0 and ones_digit == 0 -%} +{%- set resource_regex = '^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|[1-' ~ (hundreds_digit-1) ~ '][0-9][0-9]|' ~ hundreds_digit ~ '00)$' -%} +{%- elif ones_digit == 0 -%} +{%- set resource_regex = '^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|[1-' ~ (hundreds_digit-1) ~ '][0-9][0-9]|' ~ hundreds_digit ~ '[0-' ~ tens_digit ~ ']0)$' -%} +{%- else -%} +{%- set resource_regex = '^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|[1-' ~ (hundreds_digit-1) ~ '][0-9][0-9]|' ~ hundreds_digit ~ '[0-' ~ (tens_digit-1) ~ '][0-9]|' ~ hundreds_digit ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} +{%- endif -%} +{%- endif -%} +{%- endif -%} +{%- do field.update({ + 'label': field.label | replace('FREE', free_value | string) | replace('TOTAL', total_value | string), + 'regex': resource_regex, + 'regexFailureMessage': 'Enter a value not exceeding ' ~ free_value | string ~ ' ' ~ unit_label + }) -%} +{%- endmacro -%} + {%- for role in HYPERVISORS -%} {%- for hypervisor in HYPERVISORS[role].keys() -%} {%- set hw_config = HYPERVISORS[role][hypervisor].hardware -%} @@ -122,43 +165,9 @@ Base domain has not been initialized. {%- for field in updated_template.uiElements -%} {%- set updated_field = field.copy() -%} {%- if field.field == 'cpu' -%} -{%- if cpu_free < 10 -%} -{%- set cpu_regex = '^[1-' ~ cpu_free ~ ']$' -%} -{%- elif cpu_free < 100 -%} -{%- set tens_digit = cpu_free // 10 -%} -{%- set ones_digit = cpu_free % 10 -%} -{%- if ones_digit == 0 -%} -{%- set cpu_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '0)$' -%} -{%- else -%} -{%- set cpu_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} -{%- endif -%} -{%- else -%} -{%- set cpu_regex = '^([1-9]|[1-9][0-9]|100)$' -%} -{%- endif -%} -{%- do updated_field.update({ - 'label': field.label | replace('FREE', cpu_free | string) | replace('TOTAL', cpu_total | string), - 'regex': cpu_regex, - 'regexFailureMessage': 'Enter a value not exceeding ' ~ cpu_free | string ~ ' cores' - }) -%} +{%- do update_resource_field(updated_field, cpu_free, cpu_total, 'cores') -%} {%- elif field.field == 'memory' -%} -{%- if mem_free < 10 -%} -{%- set mem_regex = '^[1-' ~ mem_free ~ ']$' -%} -{%- elif mem_free < 100 -%} -{%- set tens_digit = mem_free // 10 -%} -{%- set ones_digit = mem_free % 10 -%} -{%- if ones_digit == 0 -%} -{%- set mem_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '0)$' -%} -{%- else -%} -{%- set mem_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} -{%- endif -%} -{%- else -%} -{%- set mem_regex = '^([1-9]|[1-9][0-9]|[1-9][0-9][0-9])$' -%} -{%- endif -%} -{%- do updated_field.update({ - 'label': field.label | replace('FREE', mem_free | string) | replace('TOTAL', mem_total | string), - 'regex': mem_regex, - 'regexFailureMessage': 'Enter a value not exceeding ' ~ mem_free | string ~ ' GB' - }) -%} +{%- do update_resource_field(updated_field, mem_free, mem_total, 'GB') -%} {%- elif field.field == 'disk' -%} {%- set disk_free_list = disk_free.split(',') if disk_free else [] -%} {%- do updated_field.update({ From 3a31d80a856860d3d95d53b5ae518106204833f5 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 30 Apr 2025 13:10:49 -0400 Subject: [PATCH 180/303] fix regex and label for hypervisor annotation --- salt/soc/dyanno/hypervisor/hypervisor.yaml | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index 6b0458265..a629aebfd 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -31,22 +31,22 @@ hypervisor: - static4 - dhcp4 - field: ip4 - label: "IP Address with netmask. ex. 192.168.1.10/24" + label: "IP address with netmask: 192.168.1.10/24 - If using dhcp, enter a character in this field and delete it. This will eliminate the incomplete/invalid setting entry error as well as the improperly formatted address error." forcedType: string - regex: '^(\d{1,3}\.){3}\d{1,3}/\d{1,2}$' + regex: "^$|^(\\d{1,3}\\.){3}\\d{1,3}/\\d{1,2}$" regexFailureMessage: "Enter a properly formatted CIDR address" readonly: true - field: gw4 - label: "Gateway" + label: "Gateway - If using dhcp, enter a character in this field and delete it. This will eliminate the incomplete/invalid setting entry error as well as the improperly formatted address error." forcedType: string - regex: '^(\d{1,3}\.){3}\d{1,3}$' + regex: "^$|^(\\d{1,3}\\.){3}\\d{1,3}$" regexFailureMessage: "Enter a properly formatted IP address" readonly: true - field: dns4 - label: "DNS. Comma separated list. ex. 192.168.1.1,8.8.8.8" + label: "Single DNS IP or comma separated list: 192.168.1.1,8.8.8.8 - If using dhcp, enter a character in this field and delete it. This will eliminate the incomplete/invalid setting entry error as well as the improperly formatted address error." forcedType: string - regex: '^(\d{1,3}\.){3}\d{1,3}$' - regexFailureMessage: "Enter a properly formatted IP address" + regex: "^$|^(\\d{1,3}\\.){3}\\d{1,3}(,\\s*(\\d{1,3}\\.){3}\\d{1,3})*$" + regexFailureMessage: "Enter a properly formatted IP address or list of addresses" readonly: true - field: search4 label: "Search domain" From e5c0f8a46c2db337f97a8f195daa0ad4e18017fa Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 30 Apr 2025 16:09:57 -0400 Subject: [PATCH 181/303] allow for dhcp4 --- salt/manager/tools/sbin_jinja/so-salt-cloud | 24 +++++++++++++++------ 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/salt/manager/tools/sbin_jinja/so-salt-cloud b/salt/manager/tools/sbin_jinja/so-salt-cloud index f1346130f..bf15efcc2 100644 --- a/salt/manager/tools/sbin_jinja/so-salt-cloud +++ b/salt/manager/tools/sbin_jinja/so-salt-cloud @@ -504,16 +504,26 @@ def run_qcow2_modify_network_config(profile, vm_name, mode, ip=None, gateway=Non interface = 'enp1s0' try: - result = local.cmd(target, 'qcow2.modify_network_config', [ + # Base arguments that are always included + args = [ 'image=' + image, 'interface=' + interface, 'mode=' + mode, - 'vm_name=' + vm_name, - 'ip4=' + ip if ip else '', - 'gw4=' + gateway if gateway else '', - 'dns4=' + dns if dns else '', - 'search4=' + search_domain if search_domain else '' - ]) + 'vm_name=' + vm_name + ] + + # Only include IP-related arguments if not using DHCP + if mode != "dhcp4": + if ip: + args.append('ip4=' + ip) + if gateway: + args.append('gw4=' + gateway) + if dns: + args.append('dns4=' + dns) + if search_domain: + args.append('search4=' + search_domain) + + result = local.cmd(target, 'qcow2.modify_network_config', args) format_qcow2_output('Network configuration', result) except Exception as e: logger.error(f"An error occurred while running qcow2.modify_network_config: {e}") From 26d7ceebb22b92f03c7df1c486097a2061e9426c Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 2 May 2025 11:30:35 -0400 Subject: [PATCH 182/303] libvirt.images requires scripts from hypervisor state --- salt/libvirt/images/init.sls | 1 + salt/top.sls | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 40017b3a5..6ed472405 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -14,6 +14,7 @@ {% if 'vrt' in salt['pillar.get']('features', []) %} include: + - hypervisor - libvirt.packages nsm_libvirt_images: diff --git a/salt/top.sls b/salt/top.sls index 073f24d29..a75346462 100644 --- a/salt/top.sls +++ b/salt/top.sls @@ -306,9 +306,9 @@ base: - sensoroni - telegraf - firewall + - hypervisor - libvirt - libvirt.images - - hypervisor - elasticfleet.install_agent_grid - stig From a167e5e5206ecfe1e388b23b7909c9e05bb7e669 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 2 May 2025 11:32:03 -0400 Subject: [PATCH 183/303] fix whitespace for multiple hypervisors --- salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 128dc9fc6..0b795a8ab 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -3,10 +3,8 @@ https://securityonion.net/license; you may not use this file except in compliance with the Elastic License 2.0. #} -{#- https://docs.saltproject.io/en/latest/topics/cloud/misc.html #} - {%- for role, hosts in HYPERVISORS.items() %} -{%- for host in hosts.keys() -%} +{%- for host in hosts.keys() %} sool9-{{host}}: provider: kvm-ssh-{{host}} @@ -20,10 +18,6 @@ sool9-{{host}}: minion: master: {{ grains.host }} master_port: 4506 - #startup_states: sls - #sls_list: - # - setup.virt.initial_schedule - # - setup.virt.setHostname use_superseded: - module.run features: @@ -52,7 +46,6 @@ sool9-{{host}}: - | salt-call state.apply setup.virt \ pillar='{"host": {"mainint": "enp1s0"}}' - # grains to add to the minion {%- endfor %} {%- endfor %} From a595bc4b31c4947d4580786d7e74f5ea93cc2edf Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 6 May 2025 10:13:02 -0400 Subject: [PATCH 184/303] info to debug log level --- salt/salt/engines/master/virtual_node_manager.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index 78f8f0294..e7c28ef6a 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -594,7 +594,7 @@ def validate_vrt_license() -> bool: "for more information about purchasing a license to enable this feature.") return False - log.info("License validation successful") + log.debug("License validation successful") return True except Exception as e: @@ -887,7 +887,7 @@ def start(interval: int = DEFAULT_INTERVAL, - Admin must restart service to clear lock - Error-level logging used for lock issues """ - log.info("Starting virtual node manager engine") + log.debug("Starting virtual node manager engine") if not validate_vrt_license(): return @@ -908,7 +908,7 @@ def start(interval: int = DEFAULT_INTERVAL, # Clean shutdown - release lock log.debug("Virtual node manager releasing lock") engine_lock.release() - log.info("Virtual node manager completed successfully") + log.debug("Virtual node manager completed successfully") except Exception as e: log.error("Error in virtual node manager - lock will remain until cleared: %s", str(e)) From ef436026d55d520dcc4f8aa214d9407e8658f052 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 6 May 2025 11:51:59 -0400 Subject: [PATCH 185/303] info to debug. remove old reactors --- salt/reactor/setHostname.sls | 22 --- salt/reactor/setSalt.sls | 22 --- salt/reactor/sominion.sls | 21 --- salt/reactor/virtReleaseHardware.sls | 74 ----------- salt/reactor/virtUpdate.sls | 125 ------------------ .../engines/master/virtual_power_manager.py | 4 +- 6 files changed, 2 insertions(+), 266 deletions(-) delete mode 100644 salt/reactor/setHostname.sls delete mode 100644 salt/reactor/setSalt.sls delete mode 100644 salt/reactor/sominion.sls delete mode 100644 salt/reactor/virtReleaseHardware.sls delete mode 100644 salt/reactor/virtUpdate.sls diff --git a/salt/reactor/setHostname.sls b/salt/reactor/setHostname.sls deleted file mode 100644 index 3733a71bb..000000000 --- a/salt/reactor/setHostname.sls +++ /dev/null @@ -1,22 +0,0 @@ -#!py - -# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at -# https://securityonion.net/license; you may not use this file except in compliance with the -# Elastic License 2.0. - -import logging -import salt.client -local = salt.client.LocalClient() - -def run(): - - vm_name = data['name'] - logging.error("setHostname reactor: start for: %s " % vm_name) - - r = local.cmd(vm_name, 'state.apply', ['setup.virt.setHostname']) - - logging.error("setHostname reactor: return for %s: %s " % (vm_name,r)) - logging.error("setHostname reactor: end for: %s " % vm_name) - - return {} diff --git a/salt/reactor/setSalt.sls b/salt/reactor/setSalt.sls deleted file mode 100644 index 5d8b33a4a..000000000 --- a/salt/reactor/setSalt.sls +++ /dev/null @@ -1,22 +0,0 @@ -#!py - -# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at -# https://securityonion.net/license; you may not use this file except in compliance with the -# Elastic License 2.0. - -import logging -import salt.client -local = salt.client.LocalClient() - -def run(): - - vm_name = data['name'] - logging.error("setSalt reactor: start for: %s " % vm_name) - - r = local.cmd(vm_name, 'state.apply', ['setup.virt.setSalt']) - - logging.error("setSalt reactor: return for: %s: %s " % (vm_name,r)) - logging.error("setSalt reactor: end for: %s " % vm_name) - - return {} diff --git a/salt/reactor/sominion.sls b/salt/reactor/sominion.sls deleted file mode 100644 index 24b448f2e..000000000 --- a/salt/reactor/sominion.sls +++ /dev/null @@ -1,21 +0,0 @@ -#!py - -# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at -# https://securityonion.net/license; you may not use this file except in compliance with the -# Elastic License 2.0. - -import logging -import salt.client -local = salt.client.LocalClient() - -def run(): - - vm_name = data['name'] - logging.error("sominion reactor: start for: %s " % vm_name) - - r = local.cmd(vm_name, 'state.apply', ['setup.virt.sominion']) - - logging.error("sominion reactor: end for: %s " % vm_name) - - return {} diff --git a/salt/reactor/virtReleaseHardware.sls b/salt/reactor/virtReleaseHardware.sls deleted file mode 100644 index 8e95e080f..000000000 --- a/salt/reactor/virtReleaseHardware.sls +++ /dev/null @@ -1,74 +0,0 @@ -#!py - -# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at -# https://securityonion.net/license; you may not use this file except in compliance with the -# Elastic License 2.0. - -import logging -import yaml -import os -import glob - -def run(): - - def release_compute(): - compute = hv_data['hypervisor']['hardware'][hw_type] - compute.update({'free': compute.get('free') + vm_data.get(hw_type)}) - logging.error("virtReboot reactor: claiming %s compute: %s " % (hw_type,compute)) - - def release_pci(): - free_hw = hv_data['hypervisor']['hardware'][hw_type]['free'] - # this could be 0 if nothing is assigned - if vm_data[hw_type] != 0: - for hw in vm_data[hw_type]: - f_hw = {hw: hv_data['hypervisor']['hardware'][hw_type]['claimed'].pop(hw)} - free_hw.update(f_hw) - logging.error("virtReleaseHardware reactor: released %s: %s" % (hw_type, f_hw)) - - def get_hypervisor(): - base_dir = '/opt/so/saltstack/local/pillar/hypervisor' - pattern = os.path.join(base_dir, '**', vm_name + '.sls') - files = glob.glob(pattern, recursive=True) - logging.error("virtReleaseHardware reactor: files: %s " % files) - if files: - return files[0].split('/')[7] - - vm_name = data['name'] - # since the vm has been destroyed, we can't get the hypervisor_host grain - hv_name = get_hypervisor() - logging.error("virtReleaseHardware reactor: hv_name: %s " % hv_name) - - with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls") as f: - try: - vm_data=yaml.safe_load(f) - logging.error("virtReleaseHardware reactor: vm_data %s " % vm_data) - #logging.error(yaml.safe_load(f)) - except yaml.YAMLError as exc: - logging.error(exc) - - with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + hv_name + ".sls") as f: - try: - hv_data=yaml.safe_load(f) - logging.error("virtReleaseHardware reactor: hv_data: %s " % hv_data) - #logging.error(yaml.safe_load(f)) - except yaml.YAMLError as exc: - logging.error(exc) - - for hw_type in ['disks', 'copper', 'sfp']: - release_pci() - - for hw_type in ['cpu', 'memory']: - release_compute() - - # update the free hardware for the hypervisor - with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + hv_name + ".sls", 'w') as f: - yaml.dump(hv_data, f, default_flow_style=False) - - # remove the old vm_data file since the vm has been purged - os.remove("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls") - # remove minion pillar files - os.remove("/opt/so/saltstack/local/pillar/minions/adv_" + vm_name + ".sls") - os.remove("/opt/so/saltstack/local/pillar/minions/" + vm_name + ".sls") - - return {} diff --git a/salt/reactor/virtUpdate.sls b/salt/reactor/virtUpdate.sls deleted file mode 100644 index 2e691b5b1..000000000 --- a/salt/reactor/virtUpdate.sls +++ /dev/null @@ -1,125 +0,0 @@ -#!py - -# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one -# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at -# https://securityonion.net/license; you may not use this file except in compliance with the -# Elastic License 2.0. - -import logging -import salt.client -local = salt.client.LocalClient() -import yaml -from time import sleep - -def run(): - - def claim_compute(hw_type): - compute = hv_data['hypervisor']['hardware'][hw_type] - compute.update({'free': compute.get('free') - vm_data.get(hw_type)}) - logging.error("virtUpdate reactor: claiming %s compute: %s " % (hw_type,compute)) - - def claim_pci(hw_type): - claimed_hw = hv_data['hypervisor']['hardware'][hw_type]['claimed'] - # if a list of devices was defined - if type(vm_data[hw_type]) == list: - for hw in vm_data[hw_type]: - try: - c_hw = {hw: hv_data['hypervisor']['hardware'][hw_type]['free'].pop(hw)} - claimed_hw.update(c_hw) - host_devices.append(c_hw[hw]) - except KeyError: - logging.error("virtUpdate reactor: could not claim %s with key %s " % (hw_type,hw)) - return {'key1': 'val1'} - # if a number of devices was defined - else: - n = vm_data[hw_type] - vm_data[hw_type] = [] - # grab the first number of devices as defined for the node type - claiming_hw = list(hv_data['hypervisor']['hardware'][hw_type]['free'].items())[:n] - logging.error("virtUpdate reactor: claiming %s hardware: %s " % (hw_type,claiming_hw)) - # claiming_hw is a list of tuples containing (numerical_id, pci_id) - # claiming_hw example: [(1, 'pci_0000_c4_00_0'), (2, 'pci_0000_c4_00_1')] - for hw in claiming_hw: - c_hw = {hw[0]: hv_data['hypervisor']['hardware'][hw_type]['free'].pop(hw[0])} - claimed_hw.update(c_hw) - vm_data[hw_type].append(hw[0]) - host_devices.append(hw[1]) - logging.error("virtUpdate reactor: claimed_hw: %s " % claimed_hw) - - vm_name = data['id'] - logging.error("virtUpdate reactor: vm_name: %s " % vm_name) - hv_name = local.cmd(vm_name, 'grains.get', ['hypervisor_host']).get(vm_name) - logging.error("virtUpdate reactor: hv_name: %s " % hv_name) - - host_devices = [] - - with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls") as f: - try: - vm_data=yaml.safe_load(f) - logging.error("virtUpdate reactor: vm_data %s " % vm_data) - #logging.error(yaml.safe_load(f)) - except yaml.YAMLError as exc: - logging.error(exc) - - with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + hv_name + ".sls") as f: - try: - hv_data=yaml.safe_load(f) - logging.error("virtUpdate reactor: hv_data: %s " % hv_data) - #logging.error(yaml.safe_load(f)) - except yaml.YAMLError as exc: - logging.error(exc) - - r = local.cmd(hv_name, 'virt.shutdown', ['vm_=' + vm_name]) - logging.error("virtUpdate reactor: virt.shutdown: %s return: %s " % (vm_name,r)) - - c = 0 - while True: - if c == 60: - logging.error("virtUpdate reactor: vm_name: %s failed virt.shutdown in time " % vm_name) - return {} - r = local.cmd(hv_name, 'virt.shutdown', ['vm_=' + vm_name]) - logging.error("virtUpdate reactor: virt.shutdown: %s return: %s " % (vm_name,r)) - if r.get(hv_name): - break - c += 1 - sleep(1) - - c = 0 - while True: - if c == 60: - logging.error("virtUpdate reactor: vm_name: %s failed to go inactive in time " % vm_name) - return {} - r = local.cmd(hv_name, 'virt.list_inactive_vms') - logging.error("virtUpdate reactor: virt.list_inactive_vms: %s " % r.get(hv_name)) - if vm_name in r.get(hv_name): - break - c += 1 - sleep(1) - - for hw_type in ['disks', 'copper', 'sfp']: - claim_pci(hw_type) - - for hw_type in ['cpu', 'memory']: - claim_compute(hw_type) - - logging.error("virtUpdate reactor: host_devices: %s " % host_devices) - - # update the claimed hardware for the hypervisor - with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + hv_name + ".sls", 'w') as f: - yaml.dump(hv_data, f, default_flow_style=False) - - # since the original hw request provided was a count of hw instead of specific pci ids - # we need to update the vm_data file with the assigned pci ids that were claimed - # update the vm_data file with the hardware it claimed - logging.error("virtUpdate reactor: new vm_data: %s " % vm_data) - with open("/opt/so/saltstack/local/pillar/hypervisor/" + hv_name + "/" + vm_name + ".sls", 'w') as f: - yaml.dump(vm_data, f, default_flow_style=False) - - mem = vm_data['memory'] * 1024 - r = local.cmd(hv_name, 'virt.update', ['name=' + vm_name, 'mem=' + str(mem), 'cpu=' + str(vm_data['cpu']), 'host_devices=' + str(host_devices)]) - logging.error("virtUpdate reactor: virt.update: vm_name: %s return: %s" % (vm_name,r)) - - r = local.cmd(hv_name, 'virt.start', ['name=' + vm_name]) - logging.error("virtUpdate reactor: virt.start: vm_name: %s return: %s" % (vm_name,r)) - - return {} diff --git a/salt/salt/engines/master/virtual_power_manager.py b/salt/salt/engines/master/virtual_power_manager.py index 8cca82606..de4b3bc7d 100644 --- a/salt/salt/engines/master/virtual_power_manager.py +++ b/salt/salt/engines/master/virtual_power_manager.py @@ -316,7 +316,7 @@ def start(interval: int = DEFAULT_INTERVAL, interval: Time in seconds between engine runs (managed by salt-master) base_path: Base path containing hypervisor configurations """ - log.info("Starting virtual power manager engine") + log.debug("Starting virtual power manager engine") try: # Process each hypervisor directory @@ -324,7 +324,7 @@ def start(interval: int = DEFAULT_INTERVAL, if os.path.isdir(hypervisor_path): process_hypervisor_power_requests(hypervisor_path) - log.info("Virtual power manager completed successfully") + log.debug("Virtual power manager completed successfully") except Exception as e: log.error("Error in virtual power manager: %s", str(e)) From 9e0f13cce5f89c2b6815bde09ce90e43fd5b5e37 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 7 May 2025 09:01:22 -0400 Subject: [PATCH 186/303] no longer need to create hypervisor pillar directory --- salt/salt/cloud/init.sls | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index c2d885e3c..b9764344e 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -43,16 +43,6 @@ cloud_profiles: MANAGERHOSTNAME: {{ grains.host }} MANAGERIP: {{ pillar.host.mainip }} - template: jinja - -{% for role, hosts in HYPERVISORS.items() %} -{% for host in hosts.keys() %} - -hypervisor_{{host}}_{{role}}_pillar_dir: - file.directory: - - name: /opt/so/saltstack/local/pillar/hypervisor/{{host}}_{{role}} - -{% endfor %} -{% endfor %} {% endif %} {% else %} From 6988f03ebc7fd5746ee1a245a3f18ca5896a69de Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 16 May 2025 14:24:07 -0400 Subject: [PATCH 187/303] setup bridge and fix salt before first highstate for hypervisors --- salt/libvirt/bridge.sls | 49 +++++++++++++++++++++++++++++++++++++++++ salt/libvirt/init.sls | 46 +------------------------------------- setup/so-functions | 9 ++++++++ setup/so-setup | 2 ++ 4 files changed, 61 insertions(+), 45 deletions(-) create mode 100644 salt/libvirt/bridge.sls diff --git a/salt/libvirt/bridge.sls b/salt/libvirt/bridge.sls new file mode 100644 index 000000000..5ff5d670c --- /dev/null +++ b/salt/libvirt/bridge.sls @@ -0,0 +1,49 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + +{% from 'libvirt/map.jinja' import LIBVIRTMERGED %} +{% from 'salt/map.jinja' import SYSTEMD_UNIT_FILE %} + +down_original_mgmt_interface: + cmd.run: + - name: "nmcli con down {{ pillar.host.mainint }}" + - unless: + - nmcli -f GENERAL.CONNECTION dev show {{ pillar.host.mainint }} | grep bridge-slave-{{ pillar.host.mainint }} + - order: last + +wait_for_br0_ip: + cmd.run: + - name: | + counter=0 + until ip addr show br0 | grep -q "inet "; do + sleep 1 + counter=$((counter+1)) + if [ $counter -ge 90 ]; then + echo "Timeout waiting for br0 to get an IP address" + exit 1 + fi + done + echo "br0 has IP address: $(ip addr show br0 | grep 'inet ' | awk '{print $2}')" + - timeout: 95 + - onchanges: + - cmd: down_original_mgmt_interface + +update_mine_functions: + file.managed: + - name: /etc/salt/minion.d/mine_functions.conf + - contents: | + mine_interval: 25 + mine_functions: + network.ip_addrs: + - interface: br0 + - onchanges: + - cmd: wait_for_br0_ip + +restart_salt_minion_service: + service.running: + - name: salt-minion + - enable: True + - listen: + - file: update_mine_functions diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 1312cc112..576c29c33 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -13,12 +13,12 @@ {% if sls in allowed_states %} {% if 'vrt' in salt['pillar.get']('features', []) %} {% from 'libvirt/map.jinja' import LIBVIRTMERGED %} +{% from 'salt/map.jinja' import SYSTEMD_UNIT_FILE %} include: - libvirt.64962 - libvirt.packages - libvirt.ssh.users - - salt.mine_functions install_libvirt: pkg.installed: @@ -93,50 +93,6 @@ disable_default_bridge: - onlyif: - virsh net-list | grep default -# this should only run during the first highstate after setup. it will transfer connection from mgmt to br0 -down_original_mgmt_interface: - cmd.run: - - name: "nmcli con down {{ pillar.host.mainint }}" - - unless: - - nmcli -f GENERAL.CONNECTION dev show {{ pillar.host.mainint }} | grep bridge-slave-{{ pillar.host.mainint }} - - order: last - -update_mine_functions_interface: - file.replace: - - name: /etc/salt/minion.d/mine_functions.conf - - pattern: " - interface: ([a-zA-Z0-9]+)" - - repl: " - interface: br0" - - onchanges: - - cmd: down_original_mgmt_interface - -wait_for_br0_ip: - cmd.run: - - name: | - counter=0 - until ip addr show br0 | grep -q "inet "; do - sleep 1 - counter=$((counter+1)) - if [ $counter -ge 90 ]; then - echo "Timeout waiting for br0 to get an IP address" - exit 1 - fi - done - echo "br0 has IP address: $(ip addr show br0 | grep 'inet ' | awk '{print $2}')" - - timeout: 95 - - onchanges: - - file: update_mine_functions_interface - -mine_update_mine_interface: - module.run: - - mine.send: - - network.ip_addrs - - interface: br0 - - onchanges: - - cmd: wait_for_br0_ip - -# virtlogd service may not restart following reboot without this -#semanage permissive -a virtlogd_t - {% else %} {{sls}}_no_license_detected: test.fail_without_changes: diff --git a/setup/so-functions b/setup/so-functions index d28d7baf3..a03e0166b 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -1186,6 +1186,15 @@ get_minion_type() { echo "$minion_type" } +hypervisor_local_states() { + # these states need to run before the first highstate so that we dont deal with the salt-minion restarting + # and we need these setup prior to the highstate + if [ $is_hypervisor ] || [ $is_managerhype ]; then + salt-call state.apply libvirt.64962 --local --file-root=../salt/ -l info + salt-call state.apply libvirt.bridge --local --file-root=../salt/ -l info pillar='{"host": {"mainint": "enp1s0"}}' + fi +} + install_cleanup() { if [ -f "$temp_install_dir" ]; then info "Installer removing the following files:" diff --git a/setup/so-setup b/setup/so-setup index 115bdadb7..1736da5bc 100755 --- a/setup/so-setup +++ b/setup/so-setup @@ -822,6 +822,7 @@ if ! [[ -f $install_opt_file ]]; then checkin_at_boot set_initial_firewall_access logCmd "salt-call schedule.enable -linfo --local" + hypervisor_local_states verify_setup else touch /root/accept_changes @@ -847,6 +848,7 @@ if ! [[ -f $install_opt_file ]]; then configure_minion "$minion_type" check_sos_appliance drop_install_options + hypervisor_local_states verify_setup fi From 28aedcf50b52bdc2a73e91ca31cf01177bef6d51 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 19 May 2025 09:58:43 -0400 Subject: [PATCH 188/303] remove vm map example --- salt/soc/dyanno/hypervisor/vmMap.example | 14 -------------- 1 file changed, 14 deletions(-) delete mode 100644 salt/soc/dyanno/hypervisor/vmMap.example diff --git a/salt/soc/dyanno/hypervisor/vmMap.example b/salt/soc/dyanno/hypervisor/vmMap.example deleted file mode 100644 index 7a67c7349..000000000 --- a/salt/soc/dyanno/hypervisor/vmMap.example +++ /dev/null @@ -1,14 +0,0 @@ -hypervisor: - vm: - sen41_sensor: - cpu: 16 - memory: 24 - disk: 3 - copper: 3,4 - sfp: 7,8 - sea42_searchnode: - cpu: 16 - memory: 24 - disk: 4 - copper: - sfp: From a32aac71112f226c243b0ed7eef4b073d3963fc5 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 20 May 2025 13:38:24 -0400 Subject: [PATCH 189/303] apply salt.cloud.config when hypervisor joins --- salt/_runners/setup_hypervisor.py | 50 ++++++++++++++++++++++++++++ salt/salt/cloud/config.sls | 55 +++++++++++++++++++++++++++++++ salt/salt/cloud/init.sls | 21 ------------ 3 files changed, 105 insertions(+), 21 deletions(-) create mode 100644 salt/salt/cloud/config.sls diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index dc0d9eca8..47afc25d4 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -467,6 +467,51 @@ def _apply_dyanno_hypervisor_state(): log.error(f"DYANNO: Error applying soc.dyanno.hypervisor state: {str(e)}") return False +def _apply_cloud_config_state(): + """ + Apply the salt.cloud.config state on the salt master. + + Returns: + bool: True if state was applied successfully, False otherwise + """ + try: + log.info("CLOUDCONFIG: Applying salt.cloud.config state on salt master") + + # Initialize the LocalClient + local = salt.client.LocalClient() + + # Target the salt master to apply the soc.dyanno.hypervisor state + target = MANAGER_HOSTNAME + '_*' + state_result = local.cmd(target, 'state.apply', ['salt.cloud.config', 'concurrent=True'], tgt_type='glob') + log.debug(f"CLOUDCONFIG: state_result: {state_result}") + # Check if state was applied successfully + if state_result: + success = True + for minion, states in state_result.items(): + if not isinstance(states, dict): + log.error(f"CLOUDCONFIG: Unexpected result format from {minion}: {states}") + success = False + continue + + for state_id, state_data in states.items(): + if not state_data.get('result', False): + log.error(f"CLOUDCONFIG: State {state_id} failed on {minion}: {state_data.get('comment', 'No comment')}") + success = False + + if success: + log.info("CLOUDCONFIG: Successfully applied salt.cloud.config state") + return True + else: + log.error("CLOUDCONFIG: Failed to apply salt.cloud.config state") + return False + else: + log.error("CLOUDCONFIG: No response from salt master when applying salt.cloud.config state") + return False + + except Exception as e: + log.error(f"CLOUDCONFIG: Error applying salt.cloud.config state: {str(e)}") + return False + def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id: str = None): """ Main entry point to set up the hypervisor environment. @@ -548,6 +593,11 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id if not mine_update_success: log.error(f"DYANNO: mine.update failed after {max_retries} attempts") + # Apply the soc.dyanno.hypervisor state on the salt master + if not _apply_cloud_config_state(): + log.warning("MAIN: Failed to apply salt.cloud.config state, continuing with setup") + # We don't return an error here as we want to continue with the setup process + # Apply the soc.dyanno.hypervisor state on the salt master if not _apply_dyanno_hypervisor_state(): log.warning("MAIN: Failed to apply soc.dyanno.hypervisor state, continuing with setup") diff --git a/salt/salt/cloud/config.sls b/salt/salt/cloud/config.sls new file mode 100644 index 000000000..0456c34dc --- /dev/null +++ b/salt/salt/cloud/config.sls @@ -0,0 +1,55 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. +# +# Note: Per the Elastic License 2.0, the second limitation states: +# +# "You may not move, change, disable, or circumvent the license key functionality +# in the software, and you may not remove or obscure any functionality in the +# software that is protected by the license key." + +{% from 'allowed_states.map.jinja' import allowed_states %} +{% if sls in allowed_states %} +{% if 'vrt' in salt['pillar.get']('features', []) %} +{% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {} ) %} + +{% if HYPERVISORS %} +cloud_providers: + file.managed: + - name: /etc/salt/cloud.providers.d/libvirt.conf + - source: salt://salt/cloud/cloud.providers.d/libvirt.conf.jinja + - defaults: + HYPERVISORS: {{HYPERVISORS}} + - template: jinja + - makedirs: True + +cloud_profiles: + file.managed: + - name: /etc/salt/cloud.profiles.d/socloud.conf + - source: salt://salt/cloud/cloud.profiles.d/socloud.conf.jinja + - defaults: + HYPERVISORS: {{HYPERVISORS}} + MANAGERHOSTNAME: {{ grains.host }} + MANAGERIP: {{ pillar.host.mainip }} + - template: jinja + - makedirs: True +{% endif %} + +{% else %} +{{sls}}_no_license_detected: + test.fail_without_changes: + - name: {{sls}}_no_license_detected + - comment: + - "Hypervisor nodes are a feature supported only for customers with a valid license. + Contact Security Onion Solutions, LLC via our website at https://securityonionsolutions.com + for more information about purchasing a license to enable this feature." +{% endif %} + +{% else %} + +{{sls}}_state_not_allowed: + test.fail_without_changes: + - name: {{sls}}_state_not_allowed + +{% endif %} diff --git a/salt/salt/cloud/init.sls b/salt/salt/cloud/init.sls index b9764344e..5705a3b54 100644 --- a/salt/salt/cloud/init.sls +++ b/salt/salt/cloud/init.sls @@ -13,7 +13,6 @@ {% if sls in allowed_states %} {% if 'vrt' in salt['pillar.get']('features', []) %} {% from 'salt/map.jinja' import SALTVERSION %} -{% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {} ) %} include: - libvirt.packages @@ -25,26 +24,6 @@ install_salt_cloud: - name: salt-cloud - version: {{SALTVERSION}} -{% if HYPERVISORS %} -cloud_providers: - file.managed: - - name: /etc/salt/cloud.providers.d/libvirt.conf - - source: salt://salt/cloud/cloud.providers.d/libvirt.conf.jinja - - defaults: - HYPERVISORS: {{HYPERVISORS}} - - template: jinja - -cloud_profiles: - file.managed: - - name: /etc/salt/cloud.profiles.d/socloud.conf - - source: salt://salt/cloud/cloud.profiles.d/socloud.conf.jinja - - defaults: - HYPERVISORS: {{HYPERVISORS}} - MANAGERHOSTNAME: {{ grains.host }} - MANAGERIP: {{ pillar.host.mainip }} - - template: jinja -{% endif %} - {% else %} {{sls}}_no_license_detected: test.fail_without_changes: From a430a47a3045e24a91ab9ac154eeef74f61a57e2 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 21 May 2025 14:45:34 -0400 Subject: [PATCH 190/303] fix allowed_states check --- salt/salt/cloud/config.sls | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/salt/cloud/config.sls b/salt/salt/cloud/config.sls index 0456c34dc..dfbfda56b 100644 --- a/salt/salt/cloud/config.sls +++ b/salt/salt/cloud/config.sls @@ -10,7 +10,7 @@ # software that is protected by the license key." {% from 'allowed_states.map.jinja' import allowed_states %} -{% if sls in allowed_states %} +{% if '.'.join(sls.split('.')[:2]) in allowed_states %} {% if 'vrt' in salt['pillar.get']('features', []) %} {% set HYPERVISORS = salt['pillar.get']('hypervisor:nodes', {} ) %} From 31df0b5d7d22427ed4f402efe33d2c71e1ba0c40 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 22 May 2025 09:10:09 -0400 Subject: [PATCH 191/303] create vm pillar files --- setup/so-functions | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup/so-functions b/setup/so-functions index a03e0166b..c2eb0b349 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -1472,7 +1472,7 @@ make_some_dirs() { mkdir -p $local_salt_dir/salt/firewall/portgroups mkdir -p $local_salt_dir/salt/firewall/ports - for THEDIR in bpf pcap elasticsearch ntp firewall redis backup influxdb strelka sensoroni soc docker zeek suricata nginx telegraf logstash soc manager kratos hydra idstools idh elastalert stig global kafka versionlock hypervisor; do + for THEDIR in bpf pcap elasticsearch ntp firewall redis backup influxdb strelka sensoroni soc docker zeek suricata nginx telegraf logstash soc manager kratos hydra idstools idh elastalert stig global kafka versionlock hypervisor vm; do mkdir -p $local_salt_dir/pillar/$THEDIR touch $local_salt_dir/pillar/$THEDIR/adv_$THEDIR.sls touch $local_salt_dir/pillar/$THEDIR/soc_$THEDIR.sls From 18d899a7f9c14bbcd2fa5b3115d045cca3bdbb6d Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 22 May 2025 09:29:51 -0400 Subject: [PATCH 192/303] add so-docker-prune from hotfix/2.4.150 --- salt/common/tools/sbin/so-docker-prune | 117 ++++++++++++++----------- 1 file changed, 65 insertions(+), 52 deletions(-) diff --git a/salt/common/tools/sbin/so-docker-prune b/salt/common/tools/sbin/so-docker-prune index 224cbd222..156c3b002 100755 --- a/salt/common/tools/sbin/so-docker-prune +++ b/salt/common/tools/sbin/so-docker-prune @@ -4,22 +4,16 @@ # or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. - - - -import sys, argparse, re, docker +import sys, argparse, re, subprocess, json from packaging.version import Version, InvalidVersion from itertools import groupby, chain - def get_image_name(string) -> str: return ':'.join(string.split(':')[:-1]) - def get_so_image_basename(string) -> str: return get_image_name(string).split('/so-')[-1] - def get_image_version(string) -> str: ver = string.split(':')[-1] if ver == 'latest': @@ -35,56 +29,75 @@ def get_image_version(string) -> str: return '999999.9.9' return ver +def run_command(command): + process = subprocess.run(command, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) + if process.returncode != 0: + print(f"Error executing command: {command}", file=sys.stderr) + print(f"Error message: {process.stderr}", file=sys.stderr) + exit(1) + return process.stdout def main(quiet): - client = docker.from_env() - - # Prune old/stopped containers - if not quiet: print('Pruning old containers') - client.containers.prune() - - image_list = client.images.list(filters={ 'dangling': False }) - - # Map list of image objects to flattened list of tags (format: "name:version") - tag_list = list(chain.from_iterable(list(map(lambda x: x.attrs.get('RepoTags'), image_list)))) - - # Filter to only SO images (base name begins with "so-") - tag_list = list(filter(lambda x: re.match(r'^.*\/so-[^\/]*$', get_image_name(x)), tag_list)) - - # Group tags into lists by base name (sort by same projection first) - tag_list.sort(key=lambda x: get_so_image_basename(x)) - grouped_tag_lists = [ list(it) for _, it in groupby(tag_list, lambda x: get_so_image_basename(x)) ] - - no_prunable = True - for t_list in grouped_tag_lists: try: - # Group tags by version, in case multiple images exist with the same version string - t_list.sort(key=lambda x: Version(get_image_version(x)), reverse=True) - grouped_t_list = [ list(it) for _,it in groupby(t_list, lambda x: get_image_version(x)) ] - - # Keep the 2 most current version groups - if len(grouped_t_list) <= 2: - continue - else: - no_prunable = False - for group in grouped_t_list[2:]: - for tag in group: - if not quiet: print(f'Removing image {tag}') + # Prune old/stopped containers using docker CLI + if not quiet: print('Pruning old containers') + run_command('docker container prune -f') + + # Get list of images using docker CLI + images_json = run_command('docker images --format "{{json .}}"') + + # Parse the JSON output + image_list = [] + for line in images_json.strip().split('\n'): + if line: # Skip empty lines + image_list.append(json.loads(line)) + + # Extract tags in the format "name:version" + tag_list = [] + for img in image_list: + # Skip dangling images + if img.get('Repository') != "" and img.get('Tag') != "": + tag = f"{img.get('Repository')}:{img.get('Tag')}" + # Filter to only SO images (base name begins with "so-") + if re.match(r'^.*\/so-[^\/]*$', get_image_name(tag)): + tag_list.append(tag) + + # Group tags into lists by base name (sort by same projection first) + tag_list.sort(key=lambda x: get_so_image_basename(x)) + grouped_tag_lists = [list(it) for k, it in groupby(tag_list, lambda x: get_so_image_basename(x))] + + no_prunable = True + for t_list in grouped_tag_lists: try: - client.images.remove(tag, force=True) - except docker.errors.ClientError as e: - print(f'Could not remove image {tag}, continuing...') - except (docker.errors.APIError, InvalidVersion) as e: - print(f'so-{get_so_image_basename(t_list[0])}: {e}', file=sys.stderr) - exit(1) + # Group tags by version, in case multiple images exist with the same version string + t_list.sort(key=lambda x: Version(get_image_version(x)), reverse=True) + grouped_t_list = [list(it) for k, it in groupby(t_list, lambda x: get_image_version(x))] + # Keep the 2 most current version groups + if len(grouped_t_list) <= 2: + continue + else: + no_prunable = False + for group in grouped_t_list[2:]: + for tag in group: + if not quiet: print(f'Removing image {tag}') + try: + run_command(f'docker rmi -f {tag}') + except Exception as e: + print(f'Could not remove image {tag}, continuing...') + except (InvalidVersion) as e: + print(f'so-{get_so_image_basename(t_list[0])}: {e}', file=sys.stderr) + exit(1) + except Exception as e: + print('Unhandled exception occurred:') + print(f'so-{get_so_image_basename(t_list[0])}: {e}', file=sys.stderr) + exit(1) + + if no_prunable and not quiet: + print('No Security Onion images to prune') + except Exception as e: - print('Unhandled exception occurred:') - print(f'so-{get_so_image_basename(t_list[0])}: {e}', file=sys.stderr) - exit(1) - - if no_prunable and not quiet: - print('No Security Onion images to prune') - + print(f"Error: {e}", file=sys.stderr) + exit(1) if __name__ == "__main__": main_parser = argparse.ArgumentParser(add_help=False) From 08f208cd38cb3e30be8920503623e812c626df9f Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 22 May 2025 15:37:34 -0400 Subject: [PATCH 193/303] ensure bootstrap-salt is updated for salt-cloud installs --- salt/salt/init.sls | 1 + salt/salt/master.sls | 7 +++++++ 2 files changed, 8 insertions(+) diff --git a/salt/salt/init.sls b/salt/salt/init.sls index b2ea31a65..724f79a95 100644 --- a/salt/salt/init.sls +++ b/salt/salt/init.sls @@ -5,6 +5,7 @@ saltpymodules: - python3-docker {% endif %} +# distribute to minions for salt upgrades salt_bootstrap: file.managed: - name: /usr/sbin/bootstrap-salt.sh diff --git a/salt/salt/master.sls b/salt/salt/master.sls index 413c90cd5..fce702932 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -76,6 +76,13 @@ engines_config: - name: /etc/salt/master.d/engines.conf - source: salt://salt/files/engines.conf +# update the bootstrap script when used for salt-cloud +salt_bootstrap_cloud: + file.managed: + - name: /opt/saltstack/salt/lib/python3.10/site-packages/salt/cloud/deploy/bootstrap-salt.sh + - source: salt://salt/scripts/bootstrap-salt.sh + - show_changes: False + salt_master_service: service.running: - name: salt-master From be5e41227f01ace25d22781a7f75e0d3381a3373 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 23 May 2025 11:41:45 -0400 Subject: [PATCH 194/303] rename step --- salt/_runners/setup_hypervisor.py | 2 +- salt/soc/dyanno/hypervisor/map.jinja | 2 +- salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja | 4 ++-- salt/vm/status/init.sls | 4 ++-- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 47afc25d4..17bdacbd5 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -664,7 +664,7 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id # Run highstate on the hypervisor highstate_result = local.cmd(minion_id, 'state.highstate', [], timeout=1800) if highstate_result and minion_id in highstate_result: - log.info("MAIN: Highstate triggered on %s", minion_id) + log.info("MAIN: Highstate initiated on %s", minion_id) else: log.error("MAIN: Highstate failed or timed out on %s", minion_id) return { diff --git a/salt/soc/dyanno/hypervisor/map.jinja b/salt/soc/dyanno/hypervisor/map.jinja index 88b3f4425..4a5107371 100644 --- a/salt/soc/dyanno/hypervisor/map.jinja +++ b/salt/soc/dyanno/hypervisor/map.jinja @@ -9,6 +9,6 @@ 'Initialize Minion Pillars', 'Created Instance', 'Hardware Configuration', - 'Highstate Triggered', + 'Highstate Initiated', 'Destroyed Instance' ] %} diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 8ac7a7225..4222ff6b2 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -27,7 +27,7 @@ {%- if baseDomainStatus == 'Initialized' %} {%- if vm_list %} #### Virtual Machines -Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. "Last Updated" shows when status changed. After "Highstate Triggered", only "Destroyed Instance" updates the timestamp. +Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. "Last Updated" shows when status changed. After "Highstate Initiated", only "Destroyed Instance" updates the timestamp. | Name | Status | CPU Cores | Memory (GB)| Disk | Copper | SFP | Last Updated | |--------------------|--------------------|-----------|------------|------|--------|------|---------------------| @@ -42,7 +42,7 @@ Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {%- endfor %} {%- else %} #### Virtual Machines -Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. "Last Updated" shows when status changed. After "Highstate Triggered", only "Destroyed Instance" updates the timestamp. +Status values: {% for step in PROCESS_STEPS %}{{ step }}{% if not loop.last %}, {% endif %}{% endfor %}. "Last Updated" shows when status changed. After "Highstate Initiated", only "Destroyed Instance" updates the timestamp. No Virtual Machines Found {%- endif %} diff --git a/salt/vm/status/init.sls b/salt/vm/status/init.sls index 570b36d19..64124aa85 100644 --- a/salt/vm/status/init.sls +++ b/salt/vm/status/init.sls @@ -15,9 +15,9 @@ # so-salt-emit-vm-deployment-status sets event_tag = f'soc/dyanno/hypervisor/{status.lower()}' vm_highstate_trigger: event.send: - - name: soc/dyanno/hypervisor/highstate triggered + - name: soc/dyanno/hypervisor/highstate initiated - data: - status: Highstate Triggered + status: Highstate Initiated vm_name: {{ grains.id }} hypervisor: {{ salt['grains.get']('salt-cloud:profile', '').split('-')[1] }} - order: 1 # Ensure this runs early in the highstate process From e5b12ecdb9e95bb978e4e5ce8409e0330f60ebf2 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 23 May 2025 12:44:42 -0400 Subject: [PATCH 195/303] need to allow for pw removal --- salt/vm/user/init.sls | 2 -- 1 file changed, 2 deletions(-) diff --git a/salt/vm/user/init.sls b/salt/vm/user/init.sls index 48185a9da..6abffe3f9 100644 --- a/salt/vm/user/init.sls +++ b/salt/vm/user/init.sls @@ -20,9 +20,7 @@ vm_user_soqemussh: - name: soqemussh - shell: /bin/bash - home: /home/soqemussh -{% if VMMERGED.user.soqemussh.passwordHash %} - password: '{{ VMMERGED.user.soqemussh.passwordHash }}' -{% endif %} vm_user_soqemussh_home_directory: file.directory: From 05dfce62fbc940135adbca710c15c6153bd50ab9 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 28 May 2025 13:34:17 -0400 Subject: [PATCH 196/303] corrections to allowed_states --- salt/allowed_states.map.jinja | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/salt/allowed_states.map.jinja b/salt/allowed_states.map.jinja index af9bcaa5d..3edda8a4c 100644 --- a/salt/allowed_states.map.jinja +++ b/salt/allowed_states.map.jinja @@ -47,7 +47,9 @@ 'pcap', 'suricata', 'healthcheck', - 'tcpreplay' + 'tcpreplay', + 'zeek', + 'strelka' ] %} {% set kafka_states = [ @@ -78,14 +80,12 @@ ssl_states + manager_states + sensor_states + - elastic_stack_states + elastic_stack_states | reject('equalto', 'logstash') | list ), 'so-heavynode': ( ssl_states + sensor_states + - ['elasticagent', 'zeek', 'strelka'] + - ['elasticsearch', 'logstash', 'redis'] + - stig_states + ['elasticagent', 'elasticsearch', 'logstash', 'redis', 'nginx'] ), 'so-idh': ( ssl_states + @@ -94,9 +94,8 @@ 'so-import': ( ssl_states + manager_states + - sensor_states + - ['zeek'] + - ['elasticsearch', 'elasticsearch.auth', 'kibana', 'kibana.secrets'] + sensor_states | reject('equalto', 'strelka') | reject('equalto', 'healthcheck') | list + + ['elasticsearch', 'elasticsearch.auth', 'kibana', 'kibana.secrets', 'strelka.manager'] ), 'so-manager': ( ssl_states + @@ -124,7 +123,7 @@ ), 'so-searchnode': ( ssl_states + - ['kafka.ca', 'kafka.ssl', 'elasticsearch', 'logstash'] + + ['kafka.ca', 'kafka.ssl', 'elasticsearch', 'logstash', 'nginx'] + stig_states ), 'so-standalone': ( @@ -133,13 +132,12 @@ sensor_states + stig_states + kafka_states + - elastic_stack_states + - ['zeek', 'strelka'] + elastic_stack_states ), 'so-sensor': ( ssl_states + sensor_states + - ['nginx', 'zeek', 'strelka'] + + ['nginx'] + stig_states ), 'so-fleet': ( From 40531dd9192b1d2a24e5ab924b454a131ff9cd3f Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 29 May 2025 12:22:52 -0400 Subject: [PATCH 197/303] add LSHOSTNAME option to so-minion. use -L in sominion_setup reactor --- salt/manager/tools/sbin/so-minion | 4 ++++ salt/reactor/sominion_setup.sls | 13 +++++++++---- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/salt/manager/tools/sbin/so-minion b/salt/manager/tools/sbin/so-minion index 55cd699ae..34ebdaeec 100755 --- a/salt/manager/tools/sbin/so-minion +++ b/salt/manager/tools/sbin/so-minion @@ -75,6 +75,10 @@ for i in "$@"; do ES_HEAP_SIZE="${i#*=}" shift ;; + -L=*|--lshostname=*) + LSHOSTNAME="${i#*=}" + shift + ;; -l=*|--lsheap=*) LSHEAP="${i#*=}" shift diff --git a/salt/reactor/sominion_setup.sls b/salt/reactor/sominion_setup.sls index 547b1b686..64b3666f4 100644 --- a/salt/reactor/sominion_setup.sls +++ b/salt/reactor/sominion_setup.sls @@ -9,12 +9,14 @@ import logging from subprocess import call import yaml +log = logging.getLogger(__name__) + def run(): - logging.debug('sominion_setup_reactor: Running') + log.info('sominion_setup_reactor: Running') minionid = data['id'] DATA = data['data'] hv_name = DATA['HYPERVISOR_HOST'] - logging.debug('sominion_setup_reactor: DATA: %s' % DATA) + log.info('sominion_setup_reactor: DATA: %s' % DATA) # Build the base command cmd = "NODETYPE=" + DATA['NODETYPE'] + " /usr/sbin/so-minion -o=addVM -m=" + minionid + " -n=" + DATA['MNIC'] + " -i=" + DATA['MAINIP'] + " -c=" + str(DATA['CPUCORES']) + " -d='" + DATA['NODE_DESCRIPTION'] + "'" @@ -31,10 +33,13 @@ def run(): if 'LS_HEAP_SIZE' in DATA: cmd += " -l=" + DATA['LS_HEAP_SIZE'] + + if 'LSHOSTNAME' in DATA: + cmd += " -L=" + DATA['LSHOSTNAME'] - logging.debug('sominion_setup_reactor: Command: %s' % cmd) + log.info('sominion_setup_reactor: Command: %s' % cmd) rc = call(cmd, shell=True) - logging.info('sominion_setup_reactor: rc: %s' % rc) + log.info('sominion_setup_reactor: rc: %s' % rc) return {} From 08d99a3890ba45f6e1d5bb9583a277313797019f Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 30 May 2025 12:50:13 -0400 Subject: [PATCH 198/303] remove unneeded files --- salt/_beacons/add_virtual_node_beacon.py | 113 ---------- salt/hypervisor/raid.sh | 20 -- salt/hypervisor/raid3.sh | 200 ------------------ .../{raid2.sh => tools/sbin/so-nvme-raid1.sh} | 34 +++ salt/libvirt/configgood | 50 ----- salt/libvirt/configstock | 51 ----- .../{configstockstock => etc/libvirtd.conf} | 0 salt/libvirt/images/sool9/README | 2 +- salt/libvirt/init.sls | 2 +- salt/libvirt/scripts/createvm.sh | 190 ----------------- salt/libvirt/scripts/createvm2.sh | 144 ------------- salt/setup/highstate_cron.sls | 7 - 12 files changed, 36 insertions(+), 777 deletions(-) delete mode 100644 salt/_beacons/add_virtual_node_beacon.py delete mode 100644 salt/hypervisor/raid.sh delete mode 100644 salt/hypervisor/raid3.sh rename salt/hypervisor/{raid2.sh => tools/sbin/so-nvme-raid1.sh} (80%) delete mode 100644 salt/libvirt/configgood delete mode 100644 salt/libvirt/configstock rename salt/libvirt/{configstockstock => etc/libvirtd.conf} (100%) delete mode 100644 salt/libvirt/scripts/createvm.sh delete mode 100644 salt/libvirt/scripts/createvm2.sh delete mode 100644 salt/setup/highstate_cron.sls diff --git a/salt/_beacons/add_virtual_node_beacon.py b/salt/_beacons/add_virtual_node_beacon.py deleted file mode 100644 index 6cbd3574c..000000000 --- a/salt/_beacons/add_virtual_node_beacon.py +++ /dev/null @@ -1,113 +0,0 @@ -''' -Add Virtual Node Beacon - -This beacon monitors for creation or modification of files matching a specific pattern -and sends the contents of the files up to the Salt Master's event bus, including -the hypervisor and nodetype extracted from the file path. - -Configuration: - - beacons: - add_virtual_node_beacon: - - base_path: /path/to/files/* - -If base_path is not specified, it defaults to '/opt/so/saltstack/local/salt/hypervisor/hosts/*/add_*' -''' - -import os -import glob -import logging -import re - -log = logging.getLogger(__name__) - -__virtualname__ = 'add_virtual_node_beacon' -DEFAULT_BASE_PATH = '/opt/so/saltstack/local/salt/hypervisor/hosts/*/add_*' - -def __virtual__(): - ''' - Return the virtual name of the beacon. - ''' - return __virtualname__ - -def validate(config): - ''' - Validate the beacon configuration. - - Args: - config (list): Configuration of the beacon. - - Returns: - tuple: A tuple of (bool, str) indicating success and message. - ''' - if not isinstance(config, list): - return False, 'Configuration for add_virtual_node_beacon must be a list of dictionaries' - for item in config: - if not isinstance(item, dict): - return False, 'Each item in configuration must be a dictionary' - if 'base_path' in item and not isinstance(item['base_path'], str): - return False, 'base_path must be a string' - return True, 'Valid beacon configuration' - -def beacon(config): - ''' - Monitor for creation or modification of files and send events. - - Args: - config (list): Configuration of the beacon. - - Returns: - list: A list of events to send to the Salt Master. - ''' - if 'add_virtual_node_beacon' not in __context__: - __context__['add_virtual_node_beacon'] = {} - - ret = [] - - for item in config: - base_path = item.get('base_path', DEFAULT_BASE_PATH) - file_list = glob.glob(base_path) - - log.debug('Starting add_virtual_node_beacon. Found %d files matching pattern %s', len(file_list), base_path) - - for file_path in file_list: - try: - mtime = os.path.getmtime(file_path) - prev_mtime = __context__['add_virtual_node_beacon'].get(file_path, 0) - if mtime > prev_mtime: - log.info('File %s is new or modified', file_path) - with open(file_path, 'r') as f: - contents = f.read() - - data = {} - # Parse the contents of the file - for line in contents.splitlines(): - if ':' in line: - key, value = line.split(':', 1) - data[key.strip()] = value.strip() - else: - log.warning('Line in file %s does not contain colon: %s', file_path, line) - - # Extract hypervisor and nodetype from the file path - match = re.match(r'^.*/hosts/(?P[^/]+)/add_(?P[^/]+)$', file_path) - if match: - data['hypervisor'] = match.group('hypervisor') - data['nodetype'] = match.group('nodetype') - else: - log.warning('Unable to extract hypervisor and nodetype from file path: %s', file_path) - data['hypervisor'] = None - data['nodetype'] = None - - event = {'tag': f'add_virtual_node/{os.path.basename(file_path)}', 'data': data} - ret.append(event) - __context__['add_virtual_node_beacon'][file_path] = mtime - else: - log.debug('File %s has not been modified since last check', file_path) - except FileNotFoundError: - log.warning('File not found: %s', file_path) - except PermissionError: - log.error('Permission denied when accessing file: %s', file_path) - except Exception as e: - log.error('Error processing file %s: %s', file_path, str(e)) - - return ret diff --git a/salt/hypervisor/raid.sh b/salt/hypervisor/raid.sh deleted file mode 100644 index b4539ba05..000000000 --- a/salt/hypervisor/raid.sh +++ /dev/null @@ -1,20 +0,0 @@ -# quick script to create raid -# this is an example of the base functions -parted -s /dev/nvme0n1 rm 1 -parted -s /dev/nvme0n1 mklabel gpt -parted -s /dev/nvme0n1 mkpart primary xfs 0% 100% -parted -s /dev/nvme0n1 set 1 raid on -parted -s /dev/nvme1n1 rm 1 -parted -s /dev/nvme1n1 mklabel gpt -parted -s /dev/nvme1n1 mkpart primary xfs 0% 100% -parted -s /dev/nvme1n1 set 1 raid on -yes | mdadm --create /dev/md0 --level=1 --raid-devices=2 /dev/nvme0n1p1 /dev/nvme1n1p1 - -mkfs -t xfs -f /dev/md0 -echo "Create NSM mount point" -mkdir -p /nsm -echo "Add mount to fstab" -echo "/dev/md0 /nsm xfs defaults,nofail 0 0" >> /etc/fstab -echo "Mounting /nsm" -mount -a -mdadm --detail --scan --verbose >> /etc/mdadm.conf diff --git a/salt/hypervisor/raid3.sh b/salt/hypervisor/raid3.sh deleted file mode 100644 index 4e5bd6c7f..000000000 --- a/salt/hypervisor/raid3.sh +++ /dev/null @@ -1,200 +0,0 @@ -#!/bin/bash - -#raid3.sh is a refinement of raid2.sh. raid2.sh was used to create the raid in testing -#More detailed logging -#More thorough RAID array cleanup -#Better organized cleanup procedures -#Simplified device wiping using more modern tools (sgdisk instead of dd) -#More robust handling of existing MD arrays -#The core RAID creation and mounting functionality remains the same between both scripts, but the second version has improved error handling and cleanup procedures. - -# Exit on any error -set -e - -# Function to log messages -log() { - echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" -} - -# Function to check if running as root -check_root() { - if [ "$EUID" -ne 0 ]; then - log "Error: Please run as root" - exit 1 - fi -} - -# Function to perform thorough device cleanup -ensure_devices_free() { - local device=$1 - - log "Performing thorough cleanup of device $device" - - # Kill any processes using the device - fuser -k "${device}"* 2>/dev/null || true - - # Force unmount any partitions - for part in "${device}"*; do - if mount | grep -q "$part"; then - umount -f "$part" 2>/dev/null || true - fi - done - - # Stop any MD arrays using this device - for md in $(ls /dev/md* 2>/dev/null || true); do - if mdadm --detail "$md" 2>/dev/null | grep -q "$device"; then - log "Stopping MD array $md" - mdadm --stop "$md" 2>/dev/null || true - fi - done - - # Thorough RAID cleanup - log "Cleaning RAID metadata from $device" - mdadm --zero-superblock "$device" 2>/dev/null || true - if [ -e "${device}p1" ]; then - mdadm --zero-superblock "${device}p1" 2>/dev/null || true - fi - - # Remove LVM PV if exists - pvremove -ff -y "$device" 2>/dev/null || true - - # Clear all signatures - log "Wiping all signatures from $device" - wipefs -a "$device" 2>/dev/null || true - - # Clear partition table - log "Clearing partition table on $device" - sgdisk -Z "$device" 2>/dev/null || true - - # Force kernel to reread - log "Forcing kernel to reread partition table" - partprobe "$device" 2>/dev/null || true - sleep 2 -} - -# Function to check if RAID is already set up -check_existing_raid() { - # Clear existing mdadm configuration first - log "Initializing clean mdadm configuration" - echo "DEVICE partitions" > /etc/mdadm.conf - - if [ -e "/dev/md0" ]; then - if mdadm --detail /dev/md0 &>/dev/null; then - local raid_state=$(mdadm --detail /dev/md0 | grep "State" | awk '{print $3}') - local mount_point="/nsm" - - log "Found existing RAID array /dev/md0 (State: $raid_state)" - - if mountpoint -q "$mount_point"; then - log "RAID is already mounted at $mount_point" - log "Current RAID details:" - mdadm --detail /dev/md0 - - # Check if resyncing - if grep -q "resync" /proc/mdstat; then - log "RAID is currently resyncing:" - grep resync /proc/mdstat - log "You can monitor progress with: watch -n 60 cat /proc/mdstat" - else - log "RAID is fully synced and operational" - fi - - # Show disk usage - log "Current disk usage:" - df -h "$mount_point" - - exit 0 - fi - fi - fi - - # Check if any MD arrays exist and try to clean them up - if [ -f /proc/mdstat ]; then - log "Checking for existing MD arrays" - if grep -q "md" /proc/mdstat; then - log "Found existing MD arrays, attempting cleanup" - for md in $(awk '/md/{print $1}' /proc/mdstat); do - log "Stopping array $md" - mdadm --stop "/dev/$md" 2>/dev/null || true - done - fi - fi - - # Check if any of the target devices are in use - for device in "/dev/nvme0n1" "/dev/nvme1n1"; do - if lsblk -o NAME,MOUNTPOINT "$device" | grep -q "nsm"; then - log "Error: $device is already mounted at /nsm" - exit 1 - fi - done -} - -# Main script -main() { - log "Starting RAID setup script" - - # Check if running as root - check_root - - # Check for existing RAID setup - check_existing_raid - - # Clean and prepare devices - for device in "/dev/nvme0n1" "/dev/nvme1n1"; do - ensure_devices_free "$device" - - log "Creating new partition table on $device" - sgdisk -Z "$device" - sgdisk -o "$device" - - log "Creating RAID partition" - sgdisk -n 1:0:0 -t 1:fd00 "$device" - - partprobe "$device" - udevadm settle - sleep 5 - done - - log "Final verification of partition availability" - if ! [ -b "/dev/nvme0n1p1" ] || ! [ -b "/dev/nvme1n1p1" ]; then - log "Error: Partitions not available after creation" - exit 1 - fi - - log "Creating RAID array" - mdadm --create /dev/md0 --level=1 --raid-devices=2 \ - --metadata=1.2 \ - /dev/nvme0n1p1 /dev/nvme1n1p1 \ - --force --run - - log "Creating XFS filesystem" - mkfs.xfs -f /dev/md0 - - log "Creating mount point" - mkdir -p /nsm - - log "Updating fstab" - sed -i '/\/dev\/md0/d' /etc/fstab - echo "/dev/md0 /nsm xfs defaults,nofail 0 0" >> /etc/fstab - - log "Reloading systemd daemon" - systemctl daemon-reload - - log "Mounting filesystem" - mount -a - - log "Saving RAID configuration" - mdadm --detail --scan > /etc/mdadm.conf - - log "RAID setup complete" - log "RAID array details:" - mdadm --detail /dev/md0 - - if grep -q "resync" /proc/mdstat; then - log "RAID is currently resyncing. You can monitor progress with:" - log "watch -n 60 cat /proc/mdstat" - fi -} - -# Run main function -main "$@" diff --git a/salt/hypervisor/raid2.sh b/salt/hypervisor/tools/sbin/so-nvme-raid1.sh similarity index 80% rename from salt/hypervisor/raid2.sh rename to salt/hypervisor/tools/sbin/so-nvme-raid1.sh index 83e1970df..79ccbb33c 100644 --- a/salt/hypervisor/raid2.sh +++ b/salt/hypervisor/tools/sbin/so-nvme-raid1.sh @@ -1,5 +1,39 @@ #!/bin/bash +################################################################# +# RAID-1 Setup Script for NVMe Drives +################################################################# +# +# DESCRIPTION: +# This script automatically sets up a RAID-1 (mirrored) array using two NVMe drives +# (/dev/nvme0n1 and /dev/nvme1n1) and mounts it at /nsm with XFS filesystem. +# +# FUNCTIONALITY: +# - Detects and reports existing RAID configurations +# - Thoroughly cleans target drives of any existing data/configurations +# - Creates GPT partition tables with RAID-type partitions +# - Establishes RAID-1 array (/dev/md0) for data redundancy +# - Formats the array with XFS filesystem for performance +# - Automatically mounts at /nsm and configures for boot persistence +# - Provides monitoring information for resync operations +# +# SAFETY FEATURES: +# - Requires root privileges +# - Exits gracefully if RAID already exists and is mounted +# - Performs comprehensive cleanup to avoid conflicts +# - Forces partition table updates and waits for system recognition +# +# PREREQUISITES: +# - Two NVMe drives: /dev/nvme0n1 and /dev/nvme1n1 +# - Root access +# - mdadm, sgdisk, and standard Linux utilities +# +# WARNING: This script will DESTROY all data on the target drives! +# +# USAGE: sudo ./raid_setup.sh +# +################################################################# + # Exit on any error set -e diff --git a/salt/libvirt/configgood b/salt/libvirt/configgood deleted file mode 100644 index 72369709d..000000000 --- a/salt/libvirt/configgood +++ /dev/null @@ -1,50 +0,0 @@ -#listen_tls = "0" -#listen_tcp = "0" -#tls_port = "16514" -#tcp_port = "16509" -#listen_addr = "0.0.0.0" -#unix_sock_group = "root" -#unix_sock_ro_perms = "0777" -#unix_sock_rw_perms = "0770" -#unix_sock_admin_perms = "0700" -#unix_sock_dir = "/run/libvirt" -#auth_unix_ro = "none" -#auth_unix_rw = "none" -#auth_tcp = "none" -#auth_tls = "none" -#access_drivers = "[ \"nop\" ]" -#key_file = "/etc/pki/libvirt/private/serverkey.pem" -#cert_file = "/etc/pki/libvirt/servercert.pem" -#ca_file = "/etc/pki/CA/cacert.pem" -#crl_file = "/etc/pki/CA/crl.pem" -#tls_no_sanity_certificate = "0" -#tls_no_verify_certificate = "0" -#tls_allowed_dn_list = "[\"DN1\", \"DN2\"]" -#tls_priority = "NORMAL" -#sasl_allowed_username_list = "[\"joe@example.com\", \"fred@example.com\"]" -#max_clients = "5000" -#max_queued_clients = "20" -#max_anonymous_clients = "20" -#min_workers = "5" -#max_workers = "20" -#prio_workers = "5" -#max_client_requests = "5" -#admin_min_workers = "1" -#admin_max_workers = "5" -#admin_max_clients = "5" -#admin_max_queued_clients = "5" -#admin_max_client_requests = "5" -#log_level = "3" -#log_filters = "\"1:qemu 1:libvirt 4:object 4:json 4:event 1:util\"" -#log_outputs = "\"3:syslog:libvirtd\"" -#audit_level = "1" -#audit_logging = "0" -#host_uuid = "00000000-0000-0000-0000-000000000000" -#host_uuid_source = "smbios" -#keepalive_interval = "5" -#keepalive_count = "5" -#keepalive_required = "0" -#admin_keepalive_required = "0" -#admin_keepalive_interval = "5" -#admin_keepalive_count = "5" -#ovs_timeout = "5" diff --git a/salt/libvirt/configstock b/salt/libvirt/configstock deleted file mode 100644 index ac1174cfb..000000000 --- a/salt/libvirt/configstock +++ /dev/null @@ -1,51 +0,0 @@ -#listen_tls = 0 -#listen_tcp = 1 -#tls_port = "16514" -#tcp_port = "16509" -#listen_addr = "192.168.0.1" -#unix_sock_group = "libvirt" -#unix_sock_ro_perms = "0777" -#unix_sock_rw_perms = "0770" -#unix_sock_admin_perms = "0700" -#unix_sock_dir = "/run/libvirt" -#auth_unix_ro = "polkit" -#auth_unix_rw = "polkit" -#auth_tcp = "sasl" -#auth_tls = "none" -#tcp_min_ssf = 112 -#access_drivers = [ "polkit" ] -#key_file = "/etc/pki/libvirt/private/serverkey.pem" -#cert_file = "/etc/pki/libvirt/servercert.pem" -#ca_file = "/etc/pki/CA/cacert.pem" -#crl_file = "/etc/pki/CA/crl.pem" -#tls_no_sanity_certificate = 1 -#tls_no_verify_certificate = 1 -#tls_allowed_dn_list = ["DN1", "DN2"] -#tls_priority="NORMAL" -#sasl_allowed_username_list = ["joe@EXAMPLE.COM", "fred@EXAMPLE.COM" ] -#max_clients = 5000 -#max_queued_clients = 1000 -#max_anonymous_clients = 20 -#min_workers = 5 -#max_workers = 20 -#prio_workers = 5 -#max_client_requests = 5 -#admin_min_workers = 1 -#admin_max_workers = 5 -#admin_max_clients = 5 -#admin_max_queued_clients = 5 -#admin_max_client_requests = 5 -#log_level = 3 -#log_filters="1:qemu 1:libvirt 4:object 4:json 4:event 1:util" -#log_outputs="3:syslog:libvirtd" -#audit_level = 2 -#audit_logging = 1 -#host_uuid = "00000000-0000-0000-0000-000000000000" -#host_uuid_source = "smbios" -#keepalive_interval = 5 -#keepalive_count = 5 -#keepalive_required = 1 -#admin_keepalive_required = 1 -#admin_keepalive_interval = 5 -#admin_keepalive_count = 5 -#ovs_timeout = 5 diff --git a/salt/libvirt/configstockstock b/salt/libvirt/etc/libvirtd.conf similarity index 100% rename from salt/libvirt/configstockstock rename to salt/libvirt/etc/libvirtd.conf diff --git a/salt/libvirt/images/sool9/README b/salt/libvirt/images/sool9/README index 286dd8a44..dcb68b4e8 100644 --- a/salt/libvirt/images/sool9/README +++ b/salt/libvirt/images/sool9/README @@ -1 +1 @@ -# The files in this directory (/opt/so/saltstack/local/salt/libvirt/images/sool9) are generated by createvm.sh. They are then distributed to the hypervisors where a storage pool will be created then the image can be installed. +# The files in this directory (/opt/so/saltstack/local/salt/libvirt/images/sool9) are generated by the setup_hypervisor runner. They are then distributed to the hypervisors where a storage pool will be created then the image can be installed. diff --git a/salt/libvirt/init.sls b/salt/libvirt/init.sls index 576c29c33..e25a3bcc6 100644 --- a/salt/libvirt/init.sls +++ b/salt/libvirt/init.sls @@ -34,7 +34,7 @@ libvirt_conf_dir: libvirt_config: file.managed: - name: /opt/so/conf/libvirt/libvirtd.conf - - source: salt://libvirt/configstockstock + - source: salt://libvirt/etc/libvirtd.conf # - source: salt://libvirt/etc/libvirtd.conf.jinja # - template: jinja # - defaults: diff --git a/salt/libvirt/scripts/createvm.sh b/salt/libvirt/scripts/createvm.sh deleted file mode 100644 index 4a88ecb1f..000000000 --- a/salt/libvirt/scripts/createvm.sh +++ /dev/null @@ -1,190 +0,0 @@ -#!/bin/bash - -# Ensure /root/create_vm/var/lib/libvirt/images exists -# Place this script in /root/create_vm -# Download OL9U5_x86_64-kvm-b253.qcow2 from https://yum.oracle.com/oracle-linux-templates.html, place in /root/create_vm/ - -# These steps will be removed from the process to create the final image and is being used for development -# This is used for the user-data auth portion of cloud-init -# Create passwd hash: -# python3 -c 'import crypt; print(crypt.crypt("YOUR_PASSWD_HERE", crypt.mksalt(crypt.METHOD_SHA512)))' -# Create ssh keypair: -# ssh-keygen -t ed25519 -C "soqemussh" -f ~/.ssh/soqemussh - -# Run the script: createvm.sh coreol9Small 205G -# IP options may be removed for final version - -# After running the script, the following will be output: -#[root@jppvirtman create_vm]# ll var/lib/libvirt/images/coreol9Small/ -#total 610376 -#-rw-r--r--. 1 root root 380928 Dec 20 14:33 coreol9Small-cidata.iso -#-rw-r--r--. 1 root root 624623616 Dec 20 14:33 coreol9Small.qcow2 -#-rw-r--r--. 1 root root 55 Dec 20 14:32 meta-data -#-rw-r--r--. 1 root root 333 Dec 20 14:32 network-config -#-rw-r--r--. 1 root root 1047 Dec 20 14:32 user-data - -# These files are now scp to a hypervisor node -# Place the files in /var/lib/libvirt/images/coreol9Small (or whatever is the same as the vm name) -# Create your storage pool as instructed by the script. this is only needed if one doesn't already exist -# Run the virt-install command as instructed by the script - -# Could add the following to the final runcmd in the user-data to fill the disk to avoid the cons of thin provisioning the disk -# - dd if=/dev/zero of=/tmp/fill bs=1M || true -# - rm -f /tmp/fill - -# Exit on any error -set -e - -# Set variables and defaults -VM=${1:-"small-vm"} # VM name -DISK_SIZE=${2:-"205G"} # Disk size with unit (default 205G) -IP=${3:-"192.168.1.10"} # IP address -GATEWAY=${4:-"192.168.1.1"} # Gateway -DNS=${5:-"192.168.1.1"} # Comma-separated list of DNS servers -MAC_ADDRESS="52:54:00:f2:c3:df" # Default MAC - will be overridden if found - -# Show usage if help is requested -if [[ "$1" == "-h" || "$1" == "--help" ]]; then - echo "Usage: $0 " - echo "Example: $0 myvm 100G 192.168.1.50 192.168.1.1 8.8.8.8,8.8.4.4" - echo "Parameters:" - echo " vm_name : Name of the VM (default: small-vm)" - echo " disk_size : Size of the disk with unit G/M (default: 205G)" - echo " ip : IP address (default: 192.168.1.10)" - echo " gateway : Gateway address (default: 192.168.1.1)" - echo " dns_servers: Comma-separated DNS servers (default: 192.168.1.1)" - echo "All parameters are optional and will use defaults if not specified" - exit 0 -fi - -# Validate disk size format -if ! [[ $DISK_SIZE =~ ^[0-9]+[GM]$ ]]; then - echo "Error: Disk size must be a number followed by G (gigabytes) or M (megabytes)" - echo "Example: 100G or 51200M" - exit 1 -fi - -# Convert comma-separated DNS servers to yaml format -format_dns() { - local IFS=',' - local dns_list=($1) - local yaml="" - for dns in "${dns_list[@]}"; do - yaml="$yaml - $dns"$'\n' - done - echo "$yaml" -} - -DNS_YAML=$(format_dns "$DNS") - -# Set up directory structure -D=/root/create_vm/var/lib/libvirt/images -mkdir -vp $D/$VM -cd $D/$VM - -# Create cloud-init metadata -cat > meta-data << EOF -instance-id: ${VM} -local-hostname: ${VM} -EOF - -# Create network configuration -cat > network-config << EOF -version: 2 -ethernets: - eth0: - match: - macaddress: ${MAC_ADDRESS} - dhcp4: false - dhcp6: false - addresses: - - ${IP}/24 - routes: - - to: 0.0.0.0/0 - via: ${GATEWAY} - nameservers: - addresses: -$(format_dns "$DNS") -EOF - -# Create user-data with network configuration -cat > user-data << EOF -#cloud-config -preserve_hostname: False -hostname: ${VM} -fqdn: ${VM}.local - -users: - - default - - name: soqemussh - groups: ['wheel'] - shell: /bin/bash - sudo: ALL=(ALL) NOPASSWD:ALL - lock_passwd: false - passwd: $(echo '___YOUR_HASH_HERE___') - ssh-authorized-keys: - - ssh-ed25519 ___YOUR_PUB_KEY_HERE___ soqemussh - -# Configure where output will go -output: - all: ">> /var/log/cloud-init.log" - -# configure interaction with ssh server -ssh_genkeytypes: ['ed25519', 'rsa'] - -# set timezone for VM -timezone: UTC - -# Install QEMU guest agent. Enable and start the service -packages: - - qemu-guest-agent - -runcmd: - - systemctl enable --now qemu-guest-agent - - systemctl enable --now serial-getty@ttyS0.service - - systemctl enable --now NetworkManager - - growpart /dev/vda 2 - - pvresize /dev/vda2 - - lvextend -l +100%FREE /dev/vg_main/lv_root - - xfs_growfs /dev/vg_main/lv_root -EOF - -# First, copy the base image with progress -echo "Creating base VM image..." -rsync --progress /root/create_vm/OL9U5_x86_64-kvm-b253.qcow2 $VM.qcow2 - -# Resize the image to specified size -echo "Resizing image to $DISK_SIZE..." -echo "Current image size: $(qemu-img info $VM.qcow2 | grep 'virtual size' | cut -d':' -f2 | cut -d'(' -f1 | tr -d ' ')" -qemu-img resize -f qcow2 $VM.qcow2 $DISK_SIZE -echo "New image size: $(qemu-img info $VM.qcow2 | grep 'virtual size' | cut -d':' -f2 | cut -d'(' -f1 | tr -d ' ')" - -# Now compress it with progress -echo "Compressing image..." -qemu-img convert -p -O qcow2 -c $VM.qcow2 $VM-compressed.qcow2 -mv -v $VM-compressed.qcow2 $VM.qcow2 - -# Create a cloud-init ISO with network config and progress indication -echo "Creating cloud-init ISO..." -mkisofs -output $VM-cidata.iso -volid CIDATA -rock -verbose user-data meta-data network-config - -# Echo the configuration for verification -echo "Creating VM with the following configuration:" -echo "VM Name: $VM" -echo "Disk Size: $DISK_SIZE" -echo "IP Address: $IP" -echo "Gateway: $GATEWAY" -echo "DNS Servers: $DNS" -echo "MAC Address: $MAC_ADDRESS" - -echo "Files have been created in $D/$VM" -echo -echo "To complete VM creation on the hypervisor, run:" -echo "virsh pool-create-as --name $VM --type dir --target $D/$VM" -echo "virt-install --import --name ${VM} \\" -echo " --memory 4096 --vcpus 4 --cpu host \\" -echo " --disk ${VM}.qcow2,format=qcow2,bus=virtio \\" -echo " --disk ${VM}-cidata.iso,device=cdrom \\" -echo " --network bridge=br0,model=virtio,mac=${MAC_ADDRESS} \\" -echo " --os-variant=ol9.5 \\" -echo " --noautoconsole" diff --git a/salt/libvirt/scripts/createvm2.sh b/salt/libvirt/scripts/createvm2.sh deleted file mode 100644 index b2be0d5b4..000000000 --- a/salt/libvirt/scripts/createvm2.sh +++ /dev/null @@ -1,144 +0,0 @@ -#!/bin/bash - -# Ensure /root/create_vm/var/lib/libvirt/images exists -# Place this script in /root/create_vm -# Download OL9U5_x86_64-kvm-b253.qcow2 from https://yum.oracle.com/oracle-linux-templates.html, place in /root/create_vm/ - -# These steps will be removed from the process to create the final image and is being used for development -# This is used for the user-data auth portion of cloud-init -# Create passwd hash: -# python3 -c 'import crypt; print(crypt.crypt("YOUR_PASSWD_HERE", crypt.mksalt(crypt.METHOD_SHA512)))' -# Create ssh keypair: -# ssh-keygen -t ed25519 -C "soqemussh" -f ~/.ssh/soqemussh - -# Run the script: createbase.sh coreol9Small 20G -# After running the script, the following will be output: -#[root@jppvirtman create_vm]# ll var/lib/libvirt/images/coreol9Small/ -#total 610376 -#-rw-r--r--. 1 root root 380928 Dec 20 14:33 coreol9Small-cidata.iso -#-rw-r--r--. 1 root root 624623616 Dec 20 14:33 coreol9Small.qcow2 -#-rw-r--r--. 1 root root 55 Dec 20 14:32 meta-data -#-rw-r--r--. 1 root root 1047 Dec 20 14:32 user-data - -# These files are now scp to a hypervisor node -# Place the files in /var/lib/libvirt/images/coreol9Small (or whatever is the same as the vm name) -# Create your storage pool as instructed by the script if one doesn't already exist -# Run the virt-install command as instructed by the script - -# Exit on any error -set -e - -# Set variables and defaults -VM=${1:-"base-vm"} # VM name -DISK_SIZE=${2:-"220G"} # Disk size with unit (default 20G) - -# Show usage if help is requested -if [[ "$1" == "-h" || "$1" == "--help" ]]; then - echo "Usage: $0 " - echo "Example: $0 myvm 20G" - echo "Parameters:" - echo " vm_name : Name of the VM (default: base-vm)" - echo " disk_size : Size of the disk with unit G/M (default: 20G)" - echo "All parameters are optional and will use defaults if not specified" - exit 0 -fi - -# Validate disk size format -if ! [[ $DISK_SIZE =~ ^[0-9]+[GM]$ ]]; then - echo "Error: Disk size must be a number followed by G (gigabytes) or M (megabytes)" - echo "Example: 20G or 20480M" - exit 1 -fi - -# Set up directory structure -#D=/root/create_vm/var/lib/libvirt/images -D=/opt/so/saltstack/local/salt/libvirt/images -mkdir -vp $D/$VM -cd $D/$VM - -# Create cloud-init metadata -cat > meta-data << EOF -instance-id: ${VM} -local-hostname: ${VM} -EOF - -# Create user-data configuration -cat > user-data << EOF -#cloud-config -preserve_hostname: False -hostname: ${VM} -fqdn: ${VM}.local - -users: - - default - - name: soqemussh - groups: ['wheel'] - shell: /bin/bash - sudo: ALL=(ALL) NOPASSWD:ALL - lock_passwd: false - passwd: $(echo '___YOUR_HASH_HERE___') - ssh-authorized-keys: - - ssh-ed25519 ___YOUR_PUB_KEY_HERE___ soqemussh - -# Configure where output will go -output: - all: ">> /var/log/cloud-init.log" - -# configure interaction with ssh server -ssh_genkeytypes: ['ed25519', 'rsa'] - -# set timezone for VM -timezone: UTC - -# Install QEMU guest agent. Enable and start the service -packages: - - qemu-guest-agent - -runcmd: - - systemctl enable --now qemu-guest-agent - - systemctl enable --now serial-getty@ttyS0.service - - systemctl enable --now NetworkManager - - growpart /dev/vda 2 - - pvresize /dev/vda2 - - lvextend -l +100%FREE /dev/vg_main/lv_root - - xfs_growfs /dev/vg_main/lv_root - - touch /etc/cloud/cloud-init.disabled - - shutdown -P now -EOF - -# First, copy the base image with progress -echo "Creating base VM image..." -rsync --progress /root/create_vm/OL9U5_x86_64-kvm-b253.qcow2 $VM.qcow2 - -# Resize the image to specified size -echo "Resizing image to $DISK_SIZE..." -echo "Current image size: $(qemu-img info $VM.qcow2 | grep 'virtual size' | cut -d':' -f2 | cut -d'(' -f1 | tr -d ' ')" -qemu-img resize -f qcow2 $VM.qcow2 $DISK_SIZE -echo "New image size: $(qemu-img info $VM.qcow2 | grep 'virtual size' | cut -d':' -f2 | cut -d'(' -f1 | tr -d ' ')" - -# Now compress it with progress -echo "Compressing image..." -qemu-img convert -p -O qcow2 -c $VM.qcow2 $VM-compressed.qcow2 -mv -v $VM-compressed.qcow2 $VM.qcow2 - -# Create a cloud-init ISO with progress indication -echo "Creating cloud-init ISO..." -mkisofs -output $VM-cidata.iso -volid CIDATA -rock -verbose user-data meta-data - -# Echo the configuration for verification -echo "Creating VM with the following configuration:" -echo "VM Name: $VM" -echo "Disk Size: $DISK_SIZE" - -echo "Files have been created in $D/$VM" -echo -echo "To complete VM creation on the hypervisor, run:" -echo "virsh pool-create-as --name $VM --type dir --target $D/$VM" -echo "virt-install --name ${VM} \\" -echo " --memory 4096 --vcpus 4 --cpu host \\" -echo " --disk ${VM}.qcow2,format=qcow2,bus=virtio \\" -echo " --disk ${VM}-cidata.iso,device=cdrom \\" -echo " --network bridge=br0,model=virtio \\" -echo " --os-variant=ol9.5 \\" -echo " --import \\" -echo " --noautoconsole" diff --git a/salt/setup/highstate_cron.sls b/salt/setup/highstate_cron.sls deleted file mode 100644 index f8f76e737..000000000 --- a/salt/setup/highstate_cron.sls +++ /dev/null @@ -1,7 +0,0 @@ -post_setup_cron: - cron.present: - - name: 'PATH=$PATH:/usr/sbin salt-call state.highstate' - - identifier: post_setup_cron - - user: root - - minute: '*/5' - - identifier: post_setup_cron From 395c4e37bae3fc2fb25595cd4929cc4015a3e5aa Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 4 Jun 2025 16:57:59 -0400 Subject: [PATCH 199/303] fix issue with predicable names after kernel update --- .../tools/sbin/so-qcow2-network-predictable | 74 +++++++++++++++---- 1 file changed, 60 insertions(+), 14 deletions(-) diff --git a/salt/hypervisor/tools/sbin/so-qcow2-network-predictable b/salt/hypervisor/tools/sbin/so-qcow2-network-predictable index 9b09465b9..64ec53953 100644 --- a/salt/hypervisor/tools/sbin/so-qcow2-network-predictable +++ b/salt/hypervisor/tools/sbin/so-qcow2-network-predictable @@ -171,19 +171,21 @@ def modify_bls_entry(g): for i, line in enumerate(lines): if line.startswith('options '): logger.info(f"Found options line: {line}") - # Check if net.ifnames parameter exists - if 'net.ifnames=' in line: - # Replace existing parameter - new_line = re.sub(r'net\.ifnames=[01]', 'net.ifnames=1', line) - if new_line != line: - lines[i] = new_line - modified = True - logger.info(f"Updated existing net.ifnames parameter to 1. New line: {new_line}") - else: - # Add parameter - lines[i] = f"{line} net.ifnames=1" + + # First remove any existing net.ifnames parameters (both =0 and =1) + new_line = re.sub(r'\s*net\.ifnames=[01]\s*', ' ', line) + # Also remove any quoted versions + new_line = re.sub(r'\s*"net\.ifnames=[01]"\s*', ' ', new_line) + # Clean up multiple spaces + new_line = re.sub(r'\s+', ' ', new_line).strip() + + # Now add net.ifnames=1 at the end + new_line = f"{new_line} net.ifnames=1" + + if new_line != line: + lines[i] = new_line modified = True - logger.info(f"Added net.ifnames=1 parameter. New line: {lines[i]}") + logger.info(f"Updated options line. New line: {new_line}") break if modified: @@ -238,10 +240,54 @@ def update_grub_config(g): RuntimeError: If GRUB update fails """ try: + # First, read the current grubenv to get the existing kernelopts + logger.info("Reading current grubenv...") + grubenv_content = g.read_file('/boot/grub2/grubenv').decode('utf-8') + logger.info("Current grubenv content:") + logger.info(grubenv_content) + + # Extract current kernelopts + kernelopts_match = re.search(r'^kernelopts="([^"]+)"', grubenv_content, re.MULTILINE) + if kernelopts_match: + current_kernelopts = kernelopts_match.group(1) + logger.info(f"Current kernelopts: {current_kernelopts}") + + # Remove any existing net.ifnames parameters + new_kernelopts = re.sub(r'\s*net\.ifnames=[01]\s*', ' ', current_kernelopts) + # Clean up multiple spaces + new_kernelopts = re.sub(r'\s+', ' ', new_kernelopts).strip() + # Add net.ifnames=1 + new_kernelopts = f"{new_kernelopts} net.ifnames=1" + + logger.info(f"New kernelopts: {new_kernelopts}") + + # Update grubenv with the new kernelopts + logger.info("Setting kernelopts with net.ifnames=1...") + output_editenv = g.command(['grub2-editenv', '-', 'set', f'kernelopts={new_kernelopts}']) + logger.info("grub2-editenv output:") + logger.info(output_editenv) + else: + # If we can't find existing kernelopts, use the default + logger.warning("Could not find existing kernelopts, using default") + output_editenv = g.command(['grub2-editenv', '-', 'set', 'kernelopts=console=tty0 no_timer_check biosdevname=0 resume=/dev/mapper/vg_main-lv_swap rd.lvm.lv=vg_main/lv_root rd.lvm.lv=vg_main/lv_swap net.ifnames=1 crashkernel=1G-64G:448M,64G-:512M']) + logger.info("grub2-editenv output:") + logger.info(output_editenv) + + logger.info("Updating grubby with net.ifnames=1...") + # First remove any existing net.ifnames arguments + output_grubby_remove = g.command(['grubby', '--update-kernel=ALL', '--remove-args=net.ifnames=0 net.ifnames=1']) + logger.info("grubby remove output:") + logger.info(output_grubby_remove) + + # Then add net.ifnames=1 + output_grubby_add = g.command(['grubby', '--update-kernel=ALL', '--args=net.ifnames=1']) + logger.info("grubby add output:") + logger.info(output_grubby_add) + logger.info("Updating GRUB configuration...") - output = g.command(['grub2-mkconfig', '-o', '/boot/grub2/grub.cfg']) + output_mkconfig = g.command(['grub2-mkconfig', '-o', '/boot/grub2/grub.cfg']) logger.info("GRUB update output:") - logger.info(output) + logger.info(output_mkconfig) logger.info("Successfully updated GRUB configuration") except Exception as e: logger.error(f"Failed to update GRUB configuration: {e}") From d9fb79403b9d32cf72a66bbe69076d9cfc0746d3 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 5 Jun 2025 15:57:56 -0400 Subject: [PATCH 200/303] seems new openldap / libldap.so.2 doesnt have EVP_md2 dependency so check for it before trying to remove it --- salt/libvirt/64962/scripts/so-fix-salt-ldap.py | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/salt/libvirt/64962/scripts/so-fix-salt-ldap.py b/salt/libvirt/64962/scripts/so-fix-salt-ldap.py index 919b50261..90d603904 100644 --- a/salt/libvirt/64962/scripts/so-fix-salt-ldap.py +++ b/salt/libvirt/64962/scripts/so-fix-salt-ldap.py @@ -21,7 +21,9 @@ uname = 'salt' gname = 'salt' lib = lief.parse(str(src_lib)) -sym = next(i for i in lib.imported_symbols if i.name == 'EVP_md2') + +sym = next((i for i in lib.imported_symbols if i.name == 'EVP_md2'), None) + if sym: # Get the Salt services from DBus. sysbus = dbus.SystemBus() @@ -71,5 +73,7 @@ if sym: if svcs: for sn in svcs: mgr.RestartUnit(sn, 'replace') +else: + print('No EVP_md2 symbol found in the library. No modifications needed.') print('Done.') From 0f71b45e0f47b9288276940b5f77c5751c27a7e8 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 9 Jun 2025 09:55:16 -0400 Subject: [PATCH 201/303] CPU model=host is deprecated --- salt/libvirt/images/init.sls | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index 6ed472405..b6a5baf04 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -135,7 +135,7 @@ create_vm_sool9: cmd.run: - name: | virt-install --name sool9 \ - --memory 12288 --vcpus 8 --cpu host \ + --memory 12288 --vcpus 8 --cpu host-model \ --disk /nsm/libvirt/images/sool9/sool9.qcow2,format=qcow2,bus=virtio \ --disk /nsm/libvirt/images/sool9/sool9-cidata.iso,device=cdrom \ --network bridge=br0,model=virtio \ From 4666670f4fd7d1c5e73225101005683c34b36ca9 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 9 Jun 2025 13:53:23 -0400 Subject: [PATCH 202/303] remove logging prefixes --- salt/_runners/setup_hypervisor.py | 208 +++++++++++++++--------------- 1 file changed, 104 insertions(+), 104 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 17bdacbd5..6ddd571c9 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -87,11 +87,11 @@ def _set_ownership_and_perms(path: str, mode: int): socore_gid = pwd.getpwnam('socore').pw_gid os.chown(path, socore_uid, socore_gid) os.chmod(path, mode) - log.debug(f"PERMS: Set ownership socore:socore and mode {oct(mode)} for {path}") + log.debug(f"Set ownership socore:socore and mode {oct(mode)} for {path}") except KeyError: - log.warning(f"PERMS: socore user not found, skipping ownership/permission change for {path}") + log.warning(f"socore user not found, skipping ownership/permission change for {path}") except Exception as e: - log.warning(f"PERMS: Failed to set ownership/permissions for {path}: {str(e)}") + log.warning(f"Failed to set ownership/permissions for {path}: {str(e)}") def _read_and_encode_key(key_path: str) -> str: """Read a key file and return its base64 encoded content.""" @@ -108,7 +108,7 @@ def _check_license(): license_path = '/opt/so/saltstack/local/pillar/soc/license.sls' if not os.path.exists(license_path): - log.error("LICENSE: License file not found at %s", license_path) + log.error("License file not found at %s", license_path) return False try: @@ -116,25 +116,25 @@ def _check_license(): license_data = yaml.safe_load(f) if not license_data: - log.error("LICENSE: Empty or invalid license file") + log.error("Empty or invalid license file") return False license_id = license_data.get('license_id') features = license_data.get('features', []) if not license_id: - log.error("LICENSE: No license_id found in license file") + log.error("No license_id found in license file") return False if 'vrt' not in features: - log.error("LICENSE: 'vrt' feature not found in license") + log.error("vrt feature not found in license") return False - log.info("LICENSE: License validation successful") + log.info("License validation successful") return True except Exception as e: - log.error("LICENSE: Error reading license file: %s", str(e)) + log.error("Error reading license file: %s", str(e)) return False def _check_file_exists(path): @@ -157,11 +157,11 @@ def _validate_image_checksum(path, expected_sha256): downloaded_sha256 = sha256_hash.hexdigest() if downloaded_sha256 != expected_sha256: - log.error("VALIDATE: Checksum validation failed for %s - expected: %s, got: %s", + log.error("Checksum validation failed for %s - expected: %s, got: %s", path, expected_sha256, downloaded_sha256) return False - log.info("VALIDATE: Checksum validation successful for %s", path) + log.info("Checksum validation successful for %s", path) return True # Constants @@ -181,14 +181,14 @@ def _download_image(): if _validate_image_checksum(IMAGE_PATH, IMAGE_SHA256): return True else: - log.warning("DOWNLOAD: Existing image has invalid checksum, will re-download") + log.warning("Existing image has invalid checksum, will re-download") os.unlink(IMAGE_PATH) - log.info("DOWNLOAD: Starting image download process") + log.info("Starting image download process") try: # Download file - log.info("DOWNLOAD: Downloading Oracle Linux KVM image from %s to %s", IMAGE_URL, IMAGE_PATH) + log.info("Downloading Oracle Linux KVM image from %s to %s", IMAGE_URL, IMAGE_PATH) response = requests.get(IMAGE_URL, stream=True) response.raise_for_status() @@ -207,7 +207,7 @@ def _download_image(): current_time = time.time() if current_time - last_log_time >= 1: progress = (downloaded_size / total_size) * 100 if total_size > 0 else 0 - log.info("DOWNLOAD: Progress - %.1f%% (%d/%d bytes)", + log.info("Progress - %.1f%% (%d/%d bytes)", progress, downloaded_size, total_size) last_log_time = current_time @@ -216,11 +216,11 @@ def _download_image(): os.unlink(IMAGE_PATH) return False - log.info("DOWNLOAD: Successfully downloaded and validated Oracle Linux KVM image") + log.info("Successfully downloaded and validated Oracle Linux KVM image") return True except Exception as e: - log.error("DOWNLOAD: Error downloading hypervisor image: %s", str(e)) + log.error("Error downloading hypervisor image: %s", str(e)) if os.path.exists(IMAGE_PATH): os.unlink(IMAGE_PATH) return False @@ -238,7 +238,7 @@ def _check_ssh_keys_exist(): dest_path = os.path.join(dest_dir, os.path.basename(pub_key_path)) if os.path.exists(key_path) and os.path.exists(pub_key_path) and os.path.exists(dest_path): - log.info("SETUP_KEYS: SSH keys already exist") + log.info("SSH keys already exist") return True return False @@ -258,7 +258,7 @@ def _setup_ssh_keys(): return True # Create key directories if they don't exist and set permissions - log.info("SETUP_KEYS: Setting up SSH directory and keys") + log.info("Setting up SSH directory and keys") parent_dir = os.path.dirname(key_dir) # /etc/ssh/auth_keys os.makedirs(parent_dir, exist_ok=True) os.chmod(parent_dir, 0o700) @@ -267,7 +267,7 @@ def _setup_ssh_keys(): os.chmod(key_dir, 0o700) # Generate new ed25519 key pair - log.info("SETUP_KEYS: Generating new SSH keys") + log.info("Generating new SSH keys") private_key = ed25519.Ed25519PrivateKey.generate() public_key = private_key.public_key() @@ -296,7 +296,7 @@ def _setup_ssh_keys(): os.chmod(key_path, 0o600) os.chmod(pub_key_path, 0o640) - log.info("SETUP_KEYS: SSH keys generated successfully") + log.info("SSH keys generated successfully") # Copy public key to saltstack directory dest_dir = '/opt/so/saltstack/local/salt/libvirt/ssh/keys' @@ -307,11 +307,11 @@ def _setup_ssh_keys(): with salt.utils.files.fopen(dest_path, 'wb') as dst: dst.write(src.read()) - log.info("SETUP_KEYS: Public key copied to %s", dest_dir) + log.info("Public key copied to %s", dest_dir) return True except Exception as e: - log.error("SETUP_KEYS: Error setting up SSH keys: %s", str(e)) + log.error("Error setting up SSH keys: %s", str(e)) return False def _check_vm_exists(vm_name: str) -> bool: @@ -335,7 +335,7 @@ def _check_vm_exists(vm_name: str) -> bool: exists = all(os.path.exists(f) for f in required_files) if exists: - log.info("MAIN: VM %s already exists", vm_name) + log.info("VM %s already exists", vm_name) return exists def _ensure_hypervisor_host_dir(minion_id: str = None): @@ -352,7 +352,7 @@ def _ensure_hypervisor_host_dir(minion_id: str = None): bool: True if directory exists or was created successfully, False otherwise """ if not minion_id: - log.warning("HOSTDIR: No minion_id provided, skipping host directory creation") + log.warning("No minion_id provided, skipping host directory creation") return True try: @@ -364,33 +364,33 @@ def _ensure_hypervisor_host_dir(minion_id: str = None): # Check if directory exists and create it if it doesn't if os.path.exists(host_dir): - log.info(f"HOSTDIR: Hypervisor host directory already exists: {host_dir}") + log.info(f"Hypervisor host directory already exists: {host_dir}") # Create the VMs file if it doesn't exist vms_file = f'/opt/so/saltstack/local/salt/hypervisor/hosts/{hostname}VMs' if not os.path.exists(vms_file): with salt.utils.files.fopen(vms_file, 'w') as f: f.write('[]') - log.info(f"HOSTDIR: Created empty VMs file: {vms_file}") + log.info(f"Created empty VMs file: {vms_file}") # Set proper ownership for the VMs file try: socore_uid = pwd.getpwnam('socore').pw_uid socore_gid = pwd.getpwnam('socore').pw_gid os.chown(vms_file, socore_uid, socore_gid) - log.info(f"HOSTDIR: Set ownership to socore:socore for {vms_file}") + log.info(f"Set ownership to socore:socore for {vms_file}") except (KeyError, Exception) as e: - log.warning(f"HOSTDIR: Failed to set ownership for VMs file: {str(e)}") + log.warning(f"Failed to set ownership for VMs file: {str(e)}") return True # Create all necessary parent directories os.makedirs(host_dir, exist_ok=True) - log.info(f"HOSTDIR: Created hypervisor host directory: {host_dir}") + log.info(f"Created hypervisor host directory: {host_dir}") # Create the VMs file with an empty JSON array vms_file = f'/opt/so/saltstack/local/salt/hypervisor/hosts/{hostname}VMs' with salt.utils.files.fopen(vms_file, 'w') as f: f.write('[]') - log.info(f"HOSTDIR: Created empty VMs file: {vms_file}") + log.info(f"Created empty VMs file: {vms_file}") # Set proper ownership (socore:socore) try: @@ -408,15 +408,15 @@ def _ensure_hypervisor_host_dir(minion_id: str = None): if os.path.exists(parent_dir): os.chown(parent_dir, socore_uid, socore_gid) - log.info(f"HOSTDIR: Set ownership to socore:socore for {host_dir} and {vms_file}") + log.info(f"Set ownership to socore:socore for {host_dir} and {vms_file}") except KeyError: - log.warning("HOSTDIR: socore user not found, skipping ownership change") + log.warning("socore user not found, skipping ownership change") except Exception as e: - log.warning(f"HOSTDIR: Failed to set ownership: {str(e)}") + log.warning(f"Failed to set ownership: {str(e)}") return True except Exception as e: - log.error(f"HOSTDIR: Error creating hypervisor host directory: {str(e)}") + log.error(f"Error creating hypervisor host directory: {str(e)}") return False def _apply_dyanno_hypervisor_state(): @@ -430,7 +430,7 @@ def _apply_dyanno_hypervisor_state(): bool: True if state was applied successfully, False otherwise """ try: - log.info("DYANNO: Applying soc.dyanno.hypervisor state on salt master") + log.info("Applying soc.dyanno.hypervisor state on salt master") # Initialize the LocalClient local = salt.client.LocalClient() @@ -438,33 +438,33 @@ def _apply_dyanno_hypervisor_state(): # Target the salt master to apply the soc.dyanno.hypervisor state target = MANAGER_HOSTNAME + '_*' state_result = local.cmd(target, 'state.apply', ['soc.dyanno.hypervisor', "pillar={'baseDomain': {'status': 'PreInit'}}", 'concurrent=True'], tgt_type='glob') - log.debug(f"DYANNO: state_result: {state_result}") + log.debug(f"state_result: {state_result}") # Check if state was applied successfully if state_result: success = True for minion, states in state_result.items(): if not isinstance(states, dict): - log.error(f"DYANNO: Unexpected result format from {minion}: {states}") + log.error(f"Unexpected result format from {minion}: {states}") success = False continue for state_id, state_data in states.items(): if not state_data.get('result', False): - log.error(f"DYANNO: State {state_id} failed on {minion}: {state_data.get('comment', 'No comment')}") + log.error(f"State {state_id} failed on {minion}: {state_data.get('comment', 'No comment')}") success = False if success: - log.info("DYANNO: Successfully applied soc.dyanno.hypervisor state") + log.info("Successfully applied soc.dyanno.hypervisor state") return True else: - log.error("DYANNO: Failed to apply soc.dyanno.hypervisor state") + log.error("Failed to apply soc.dyanno.hypervisor state") return False else: - log.error("DYANNO: No response from salt master when applying soc.dyanno.hypervisor state") + log.error("No response from salt master when applying soc.dyanno.hypervisor state") return False except Exception as e: - log.error(f"DYANNO: Error applying soc.dyanno.hypervisor state: {str(e)}") + log.error(f"Error applying soc.dyanno.hypervisor state: {str(e)}") return False def _apply_cloud_config_state(): @@ -475,7 +475,7 @@ def _apply_cloud_config_state(): bool: True if state was applied successfully, False otherwise """ try: - log.info("CLOUDCONFIG: Applying salt.cloud.config state on salt master") + log.info("Applying salt.cloud.config state on salt master") # Initialize the LocalClient local = salt.client.LocalClient() @@ -483,33 +483,33 @@ def _apply_cloud_config_state(): # Target the salt master to apply the soc.dyanno.hypervisor state target = MANAGER_HOSTNAME + '_*' state_result = local.cmd(target, 'state.apply', ['salt.cloud.config', 'concurrent=True'], tgt_type='glob') - log.debug(f"CLOUDCONFIG: state_result: {state_result}") + log.debug(f"state_result: {state_result}") # Check if state was applied successfully if state_result: success = True for minion, states in state_result.items(): if not isinstance(states, dict): - log.error(f"CLOUDCONFIG: Unexpected result format from {minion}: {states}") + log.error(f"Unexpected result format from {minion}: {states}") success = False continue for state_id, state_data in states.items(): if not state_data.get('result', False): - log.error(f"CLOUDCONFIG: State {state_id} failed on {minion}: {state_data.get('comment', 'No comment')}") + log.error(f"State {state_id} failed on {minion}: {state_data.get('comment', 'No comment')}") success = False if success: - log.info("CLOUDCONFIG: Successfully applied salt.cloud.config state") + log.info("Successfully applied salt.cloud.config state") return True else: - log.error("CLOUDCONFIG: Failed to apply salt.cloud.config state") + log.error("Failed to apply salt.cloud.config state") return False else: - log.error("CLOUDCONFIG: No response from salt master when applying salt.cloud.config state") + log.error("No response from salt master when applying salt.cloud.config state") return False except Exception as e: - log.error(f"CLOUDCONFIG: Error applying salt.cloud.config state: {str(e)}") + log.error(f"Error applying salt.cloud.config state: {str(e)}") return False def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id: str = None): @@ -579,31 +579,31 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id for attempt in range(1, max_retries + 1): mine_update_result = local.cmd(minion_id, 'mine.update') - log.debug(f"DYANNO: mine_update_result: {mine_update_result}") + log.debug(f"mine_update_result: {mine_update_result}") # Check if mine.update was successful if mine_update_result and all(mine_update_result.values()): - log.info(f"DYANNO: mine.update successful on attempt {attempt}") + log.info(f"mine.update successful on attempt {attempt}") mine_update_success = True break else: - log.warning(f"DYANNO: mine.update failed on attempt {attempt}/{max_retries}, retrying in {retry_delay} seconds...") + log.warning(f"mine.update failed on attempt {attempt}/{max_retries}, retrying in {retry_delay} seconds...") time.sleep(retry_delay) if not mine_update_success: - log.error(f"DYANNO: mine.update failed after {max_retries} attempts") + log.error(f"mine.update failed after {max_retries} attempts") # Apply the soc.dyanno.hypervisor state on the salt master if not _apply_cloud_config_state(): - log.warning("MAIN: Failed to apply salt.cloud.config state, continuing with setup") + log.warning("Failed to apply salt.cloud.config state, continuing with setup") # We don't return an error here as we want to continue with the setup process # Apply the soc.dyanno.hypervisor state on the salt master if not _apply_dyanno_hypervisor_state(): - log.warning("MAIN: Failed to apply soc.dyanno.hypervisor state, continuing with setup") + log.warning("Failed to apply soc.dyanno.hypervisor state, continuing with setup") # We don't return an error here as we want to continue with the setup process - log.info("MAIN: Starting setup_environment in setup_hypervisor runner") + log.info("Starting setup_environment in setup_hypervisor runner") # Check if environment is already set up image_exists = _check_file_exists(IMAGE_PATH) @@ -616,9 +616,9 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id # Handle image setup if needed if not image_valid: - log.info("MAIN: Starting image download/validation process") + log.info("Starting image download/validation process") if not _download_image(): - log.error("MAIN: Image download failed") + log.error("Image download failed") return { 'success': False, 'error': 'Image download failed', @@ -628,9 +628,9 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id # Handle SSH key setup if needed if not keys_exist: - log.info("MAIN: Setting up SSH keys") + log.info("Setting up SSH keys") if not _setup_ssh_keys(): - log.error("MAIN: SSH key setup failed") + log.error("SSH key setup failed") return { 'success': False, 'error': 'SSH key setup failed', @@ -641,39 +641,39 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id # Create/recreate VM if needed if create_vm_needed or not vm_exists: if vm_exists: - log.info("MAIN: Environment changes detected, recreating VM %s", vm_name) + log.info("Environment changes detected, recreating VM %s", vm_name) else: - log.info("MAIN: Creating new VM %s", vm_name) + log.info("Creating new VM %s", vm_name) vm_result = create_vm(vm_name, disk_size) else: - log.info("MAIN: No changes detected, using existing VM %s", vm_name) + log.info("No changes detected, using existing VM %s", vm_name) vm_result = { 'success': True, 'vm_dir': f'/opt/so/saltstack/local/salt/libvirt/images/{vm_name}' } success = vm_result.get('success', False) - log.info("MAIN: Setup environment completed with status: %s", "SUCCESS" if success else "FAILED") + log.info("Setup environment completed with status: %s", "SUCCESS" if success else "FAILED") # If setup was successful and we have a minion_id, run highstate if success and minion_id: - log.info("MAIN: Running highstate on hypervisor %s", minion_id) + log.info("Running highstate on hypervisor %s", minion_id) try: # Initialize the LocalClient local = salt.client.LocalClient() # Run highstate on the hypervisor highstate_result = local.cmd(minion_id, 'state.highstate', [], timeout=1800) if highstate_result and minion_id in highstate_result: - log.info("MAIN: Highstate initiated on %s", minion_id) + log.info("Highstate initiated on %s", minion_id) else: - log.error("MAIN: Highstate failed or timed out on %s", minion_id) + log.error("Highstate failed or timed out on %s", minion_id) return { 'success': False, 'error': 'Highstate failed or timed out', 'vm_result': None } except Exception as e: - log.error("MAIN: Error running highstate on %s: %s", minion_id, str(e)) + log.error("Error running highstate on %s: %s", minion_id, str(e)) return { 'success': False, 'error': f'Error running highstate: {str(e)}', @@ -732,16 +732,16 @@ def create_vm(vm_name: str, disk_size: str = '220G'): try: # Input validation if not isinstance(vm_name, str) or not vm_name: - log.error("CREATEVM: Invalid VM name") + log.error("Invalid VM name") return {'success': False, 'error': 'Invalid VM name'} if not vm_name.isalnum() and not all(c in '-_' for c in vm_name if not c.isalnum()): - log.error("CREATEVM: VM name must contain only alphanumeric characters, hyphens, or underscores") + log.error("VM name must contain only alphanumeric characters, hyphens, or underscores") return {'success': False, 'error': 'Invalid VM name format'} # Validate disk size format if not isinstance(disk_size, str) or not disk_size.endswith(('G', 'M')): - log.error("CREATEVM: Invalid disk size format. Must end with G or M") + log.error("Invalid disk size format. Must end with G or M") return {'success': False, 'error': 'Invalid disk size format'} try: @@ -749,12 +749,12 @@ def create_vm(vm_name: str, disk_size: str = '220G'): if size_num <= 0: raise ValueError except ValueError: - log.error("CREATEVM: Invalid disk size number") + log.error("Invalid disk size number") return {'success': False, 'error': 'Invalid disk size number'} # Ensure base image exists if not os.path.exists(IMAGE_PATH): - log.error("CREATEVM: Base image not found at %s", IMAGE_PATH) + log.error("Base image not found at %s", IMAGE_PATH) return {'success': False, 'error': 'Base image not found'} # Set up directory structure @@ -770,7 +770,7 @@ def create_vm(vm_name: str, disk_size: str = '220G'): with salt.utils.files.fopen(pub_key_path, 'r') as f: ssh_pub_key = f.read().strip() except Exception as e: - log.error("CREATEVM: Failed to read SSH public key: %s", str(e)) + log.error("Failed to read SSH public key: %s", str(e)) return {'success': False, 'error': 'Failed to read SSH public key'} # Read pillar data for soqemussh password hash @@ -785,11 +785,11 @@ def create_vm(vm_name: str, disk_size: str = '220G'): password_hash = pillar_data.get('vm', {}).get('user', {}).get('soqemussh', {}).get('passwordHash') if password_hash: passwd_line = f" passwd: {password_hash}\n" - log.info("CREATEVM: Found soqemussh password hash in pillar.") + log.info("Found soqemussh password hash in pillar.") else: - log.info("CREATEVM: No soqemussh password hash found in pillar, omitting passwd line.") + log.info("No soqemussh password hash found in pillar, omitting passwd line.") except Exception as e: - log.warning(f"CREATEVM: Error reading or parsing pillar file {pillar_path}: {str(e)}. Omitting passwd line.") + log.warning(f"Error reading or parsing pillar file {pillar_path}: {str(e)}. Omitting passwd line.") # Read and encode GPG keys keys_dir = '/opt/so/saltstack/default/salt/repo/client/files/oracle/keys' @@ -809,7 +809,7 @@ local-hostname: {vm_name} _set_ownership_and_perms(meta_data_path, mode=0o640) with salt.utils.files.fopen(meta_data_path, 'w') as f: f.write(meta_data) - log.info("CREATEVM: Created meta-data") + log.info("Created meta-data") # Create network-data network_data = """network: @@ -820,7 +820,7 @@ local-hostname: {vm_name} _set_ownership_and_perms(network_data_path, mode=0o640) with salt.utils.files.fopen(network_data_path, 'w') as f: f.write(network_data) - log.info("CREATEVM: Created network-data") + log.info("Created network-data") # Create user-data user_data = f"""#cloud-config @@ -913,7 +913,7 @@ power_state: _set_ownership_and_perms(user_data_path, mode=0o640) with salt.utils.files.fopen(user_data_path, 'w') as f: f.write(user_data) - log.info("CREATEVM: Created user-data") + log.info("Created user-data") # Copy and resize base image base_image = IMAGE_PATH @@ -921,11 +921,11 @@ power_state: # Copy base image with progress logging import shutil - log.info("CREATEVM: Copying base image to %s", vm_image) + log.info("Copying base image to %s", vm_image) shutil.copy2(base_image, vm_image) # Set ownership and permissions for the copied image _set_ownership_and_perms(vm_image, mode=0o640) - log.info("CREATEVM: Base image copy complete") + log.info("Base image copy complete") # Get current image size import subprocess @@ -939,26 +939,26 @@ power_state: # Only resize if requested size is larger if requested_size > current_size: - log.info("CREATEVM: Resizing image to %s", disk_size) + log.info("Resizing image to %s", disk_size) try: result = subprocess.run(['qemu-img', 'resize', '-f', 'qcow2', vm_image, disk_size], check=True, capture_output=True, text=True) - log.info("CREATEVM: Image resize complete") + log.info("Image resize complete") except subprocess.CalledProcessError as e: - log.error("CREATEVM: Failed to resize image: %s", e.stderr) + log.error("Failed to resize image: %s", e.stderr) raise else: - log.info("CREATEVM: Image already at or larger than requested size") + log.info("Image already at or larger than requested size") except subprocess.CalledProcessError as e: - log.error("CREATEVM: Failed to get image info: %s", e.stderr) + log.error("Failed to get image info: %s", e.stderr) raise except json.JSONDecodeError as e: - log.error("CREATEVM: Failed to parse image info: %s", str(e)) + log.error("Failed to parse image info: %s", str(e)) raise # Compress image temp_image = f"{vm_image}.temp" - log.info("CREATEVM: Compressing image") + log.info("Compressing image") # Start compression in a subprocess process = subprocess.Popen(['qemu-img', 'convert', '-O', 'qcow2', '-c', vm_image, temp_image], @@ -974,7 +974,7 @@ power_state: if os.path.exists(temp_image): compressed_size = os.path.getsize(temp_image) progress = (compressed_size / source_size) * 100 - log.info("CREATEVM: Compression progress - %.1f%% (%d/%d bytes)", + log.info("Compression progress - %.1f%% (%d/%d bytes)", progress, compressed_size, source_size) last_log_time = current_time @@ -983,10 +983,10 @@ power_state: os.replace(temp_image, vm_image) # Set ownership and permissions for the compressed image _set_ownership_and_perms(vm_image, mode=0o640) - log.info("CREATEVM: Image compression complete") + log.info("Image compression complete") else: error = process.stderr.read().decode('utf-8') - log.error("CREATEVM: Failed to compress image: %s", error) + log.error("Failed to compress image: %s", error) if os.path.exists(temp_image): os.unlink(temp_image) raise subprocess.CalledProcessError(process.returncode, 'qemu-img convert', stderr=error) @@ -998,7 +998,7 @@ power_state: check=True, capture_output=True) # Set ownership and permissions for the created ISO _set_ownership_and_perms(cidata_iso, mode=0o640) - log.info("CREATEVM: Created cidata ISO") + log.info("Created cidata ISO") # Generate SHA256 hash of the qcow2 image sha256_hash = hashlib.sha256() @@ -1013,7 +1013,7 @@ power_state: # Set ownership and permissions for the hash file _set_ownership_and_perms(hash_file, mode=0o640) - log.info("CREATEVM: Generated SHA256 hash for %s", vm_image) + log.info("Generated SHA256 hash for %s", vm_image) return { 'success': True, @@ -1021,7 +1021,7 @@ power_state: } except Exception as e: - log.error("CREATEVM: Error creating VM: %s", str(e)) + log.error("Error creating VM: %s", str(e)) return {'success': False, 'error': str(e)} def regenerate_ssh_keys(): @@ -1058,11 +1058,11 @@ def regenerate_ssh_keys(): else: print("Failed to regenerate SSH keys") """ - log.info("MAIN: Starting SSH key regeneration") + log.info("Starting SSH key regeneration") try: # Verify current state if not _check_ssh_keys_exist(): - log.warning("MAIN: No existing SSH keys found to regenerate") + log.warning("No existing SSH keys found to regenerate") return _setup_ssh_keys() # Remove existing keys @@ -1075,18 +1075,18 @@ def regenerate_ssh_keys(): for path in [key_path, pub_key_path, dest_path]: try: os.unlink(path) - log.info("MAIN: Removed existing key: %s", path) + log.info("Removed existing key: %s", path) except FileNotFoundError: - log.warning("MAIN: Key file not found: %s", path) + log.warning("Key file not found: %s", path) # Generate new keys if _setup_ssh_keys(): - log.info("MAIN: SSH keys regenerated successfully") + log.info("SSH keys regenerated successfully") return True - log.error("MAIN: Failed to regenerate SSH keys") + log.error("Failed to regenerate SSH keys") return False except Exception as e: - log.error("MAIN: Error regenerating SSH keys: %s", str(e)) + log.error("Error regenerating SSH keys: %s", str(e)) return False From 4c9773c68d7f99b50e4f458d6d4d9c48d701ca0e Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 9 Jun 2025 14:37:06 -0400 Subject: [PATCH 203/303] reenable sslverify --- salt/repo/client/oracle.sls | 2 -- 1 file changed, 2 deletions(-) diff --git a/salt/repo/client/oracle.sls b/salt/repo/client/oracle.sls index 2f421b700..70f529830 100644 --- a/salt/repo/client/oracle.sls +++ b/salt/repo/client/oracle.sls @@ -53,12 +53,10 @@ so_repo: - baseurl: file:///nsm/repo/ {% else %} - baseurl: https://{{ GLOBALS.repo_host }}/repo - - sslverify: 0 {% endif %} - enabled: 1 - gpgcheck: 1 - {% endif %} # TODO: Add a pillar entry for custom repos From 1e2453eddfe8a7ab084139c971f23ad888298446 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 9 Jun 2025 14:47:53 -0400 Subject: [PATCH 204/303] debug loglevel --- salt/hypervisor/map.jinja | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/salt/hypervisor/map.jinja b/salt/hypervisor/map.jinja index da8716415..dae3985d4 100644 --- a/salt/hypervisor/map.jinja +++ b/salt/hypervisor/map.jinja @@ -19,12 +19,12 @@ {# Build enhanced HYPERVISORS structure #} {% set HYPERVISORS = {} %} -{% do salt.log.info('salt/hypervisor/map.jinja: NODES content: ' ~ NODES | tojson) %} +{% do salt.log.debug('salt/hypervisor/map.jinja: NODES content: ' ~ NODES | tojson) %} {% for role, hypervisors in NODES.items() %} - {% do salt.log.info('salt/hypervisor/map.jinja: Processing role: ' ~ role) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Processing role: ' ~ role) %} {% do HYPERVISORS.update({role: {}}) %} {% for hypervisor, config in hypervisors.items() %} - {% do salt.log.info('salt/hypervisor/map.jinja: Processing hypervisor: ' ~ hypervisor ~ ' with config: ' ~ config | tojson) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Processing hypervisor: ' ~ hypervisor ~ ' with config: ' ~ config | tojson) %} {# Get model from cached grains using Salt runner #} {% set grains = salt.saltutil.runner('cache.grains', tgt=hypervisor ~ '_*', tgt_type='glob') %} {% set model = '' %} @@ -38,15 +38,15 @@ {% set vms = {} %} {% set vm_list = [] %} {% set vm_list_file = 'hypervisor/hosts/' ~ hypervisor ~ 'VMs' %} - {% do salt.log.info('salt/hypervisor/map.jinja: VM list file: ' ~ vm_list_file) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: VM list file: ' ~ vm_list_file) %} {% if salt['file.file_exists']('/opt/so/saltstack/local/salt/' ~ vm_list_file) %} {% import_json vm_list_file as vm_list %} {% endif %} {% if vm_list %} - {% do salt.log.info('salt/hypervisor/map.jinja: VM list content: ' ~ vm_list | tojson) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: VM list content: ' ~ vm_list | tojson) %} {% else %} {# we won't get here if the vm_list_file doesn't exist because we will get TemplateNotFound on the import_json #} - {% do salt.log.info('salt/hypervisor/map.jinja: VM list empty: ' ~ vm_list_file) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: VM list empty: ' ~ vm_list_file) %} {% endif %} {# Load status and configuration for each VM #} @@ -54,25 +54,25 @@ {# Get VM details from list entry #} {% set hostname = vm.get('hostname', '') %} {% set role = vm.get('role', '') %} - {% do salt.log.info('salt/hypervisor/map.jinja: Processing VM - hostname: ' ~ hostname ~ ', role: ' ~ role) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Processing VM - hostname: ' ~ hostname ~ ', role: ' ~ role) %} {# Load VM configuration from config file #} {% set vm_file = 'hypervisor/hosts/' ~ hypervisor ~ '/' ~ hostname ~ '_' ~ role %} - {% do salt.log.info('salt/hypervisor/map.jinja: VM config file: ' ~ vm_file) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: VM config file: ' ~ vm_file) %} {% import_json vm_file as vm_state %} {% if vm_state %} - {% do salt.log.info('salt/hypervisor/map.jinja: VM config content: ' ~ vm_state | tojson) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: VM config content: ' ~ vm_state | tojson) %} {% set vm_data = {'config': vm_state.config} %} {# Load VM status from status file #} {% set status_file = vm_file ~ '.status' %} - {% do salt.log.info('salt/hypervisor/map.jinja: VM status file: ' ~ status_file) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: VM status file: ' ~ status_file) %} {% import_json status_file as status_data %} {% if status_data %} - {% do salt.log.info('salt/hypervisor/map.jinja: VM status content: ' ~ status_data | tojson) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: VM status content: ' ~ status_data | tojson) %} {% do vm_data.update({'status': status_data}) %} {% else %} - {% do salt.log.info('salt/hypervisor/map.jinja: Status file empty: ' ~ status_file) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Status file empty: ' ~ status_file) %} {% do vm_data.update({ 'status': { 'status': '', @@ -83,7 +83,7 @@ {% endif %} {% do vms.update({hostname ~ '_' ~ role: vm_data}) %} {% else %} - {% do salt.log.info('salt/hypervisor/map.jinja: Config file empty: ' ~ vm_file) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Config file empty: ' ~ vm_file) %} {% endif %} {% endfor %} @@ -96,11 +96,11 @@ {# Find all status files for this hypervisor #} {% set relative_path = 'hypervisor/hosts/' ~ hypervisor %} {% set absolute_path = '/opt/so/saltstack/local/salt/' ~ relative_path %} - {% do salt.log.info('salt/hypervisor/map.jinja: Scanning for status files in: ' ~ absolute_path) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Scanning for status files in: ' ~ absolute_path) %} {# Try to find status files using file.find with absolute path #} {% set status_files = salt['file.find'](absolute_path, name='*_*.status', type='f') %} - {% do salt.log.info('salt/hypervisor/map.jinja: Found status files: ' ~ status_files | tojson) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Found status files: ' ~ status_files | tojson) %} {# Convert absolute paths back to relative paths for processing #} {% set relative_status_files = [] %} @@ -110,7 +110,7 @@ {% endfor %} {% set status_files = relative_status_files %} - {% do salt.log.info('salt/hypervisor/map.jinja: Converted to relative paths: ' ~ status_files | tojson) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Converted to relative paths: ' ~ status_files | tojson) %} {% for status_file in status_files %} {# Extract the VM name from the filename #} @@ -124,12 +124,12 @@ {% endif %} {# Read the status file #} - {% do salt.log.info('salt/hypervisor/map.jinja: Processing potential destroyed VM status file: ' ~ status_file) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Processing potential destroyed VM status file: ' ~ status_file) %} {% import_json status_file as status_data %} {# Only process files with "Destroyed Instance" status #} {% if status_data and status_data.status == 'Destroyed Instance' %} - {% do salt.log.info('salt/hypervisor/map.jinja: Found VM with Destroyed Instance status: ' ~ vm_name) %} + {% do salt.log.debug('salt/hypervisor/map.jinja: Found VM with Destroyed Instance status: ' ~ vm_name) %} {# Add to vms with minimal config #} {% do vms.update({ From 849f8f13bc8a45f78400959a420d5224db077639 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 10 Jun 2025 13:08:42 -0400 Subject: [PATCH 205/303] create virt feature pillars 160 to 170 soup --- salt/manager/tools/sbin/soup | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/salt/manager/tools/sbin/soup b/salt/manager/tools/sbin/soup index aa030bcdb..bb6a83d86 100755 --- a/salt/manager/tools/sbin/soup +++ b/salt/manager/tools/sbin/soup @@ -418,6 +418,7 @@ preupgrade_changes() { [[ "$INSTALLEDVERSION" == 2.4.140 ]] && up_to_2.4.141 [[ "$INSTALLEDVERSION" == 2.4.141 ]] && up_to_2.4.150 [[ "$INSTALLEDVERSION" == 2.4.150 ]] && up_to_2.4.160 + [[ "$INSTALLEDVERSION" == 2.4.160 ]] && up_to_2.4.170 true } @@ -446,6 +447,7 @@ postupgrade_changes() { [[ "$POSTVERSION" == 2.4.140 ]] && post_to_2.4.141 [[ "$POSTVERSION" == 2.4.141 ]] && post_to_2.4.150 [[ "$POSTVERSION" == 2.4.150 ]] && post_to_2.4.160 + [[ "$POSTVERSION" == 2.4.160 ]] && post_to_2.4.170 true } @@ -586,6 +588,11 @@ post_to_2.4.160() { POSTVERSION=2.4.160 } +post_to_2.4.170() { + echo "Nothing to apply" + POSTVERSION=2.4.170 +} + repo_sync() { echo "Sync the local repo." su socore -c '/usr/sbin/so-repo-sync' || fail "Unable to complete so-repo-sync." @@ -829,6 +836,20 @@ up_to_2.4.160() { INSTALLEDVERSION=2.4.160 } +up_to_2.4.170() { + echo "Creating pillar files for virtualization feature" + + states=("hypervisor" "vm" "libvirt") + + # Create pillar files for each state + for state in "${states[@]}"; do + mkdir -p /opt/so/saltstack/local/pillar/$state + touch /opt/so/saltstack/local/pillar/$state/adv_$state.sls /opt/so/saltstack/local/pillar/$state/soc_$state.sls + done + + INSTALLEDVERSION=2.4.170 +} + add_hydra_pillars() { mkdir -p /opt/so/saltstack/local/pillar/hydra touch /opt/so/saltstack/local/pillar/hydra/soc_hydra.sls From 48dfcab9f0c9ba1fa571d3785b6f28014edf91a8 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 10 Jun 2025 13:44:24 -0400 Subject: [PATCH 206/303] ensure salt-minion is running, salt-master if manager before mine update --- salt/salt/mine_functions.sls | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/salt/salt/mine_functions.sls b/salt/salt/mine_functions.sls index 305fe2ce4..ed786e997 100644 --- a/salt/salt/mine_functions.sls +++ b/salt/salt/mine_functions.sls @@ -18,7 +18,7 @@ mine_functions: mine_functions: network.ip_addrs: - interface: {{ interface }} - {% if role in ['so-eval','so-import','so-manager','so-managerhype','so-managersearch','so-standalone'] %} + {%- if role in ['so-eval','so-import','so-manager','so-managerhype','so-managersearch','so-standalone'] %} x509.get_pem_entries: - glob_path: '/etc/pki/ca.crt' {% endif %} @@ -28,3 +28,8 @@ mine_update_mine_functions: - mine.update: [] - onchanges: - file: mine_functions + - onlyif: + - systemctl is-active --quiet salt-minion + {%- if role in ['so-eval','so-import','so-manager','so-managerhype','so-managersearch','so-standalone'] %} + - systemctl is-active --quiet salt-master + {% endif %} From bd4f2093db796948acbcba7ab7e9eafde7a7da15 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 11 Jun 2025 09:39:15 -0400 Subject: [PATCH 207/303] add vm delete warning for ui element --- salt/soc/dyanno/hypervisor/hypervisor.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/salt/soc/dyanno/hypervisor/hypervisor.yaml b/salt/soc/dyanno/hypervisor/hypervisor.yaml index a629aebfd..d13c928ec 100644 --- a/salt/soc/dyanno/hypervisor/hypervisor.yaml +++ b/salt/soc/dyanno/hypervisor/hypervisor.yaml @@ -6,6 +6,7 @@ hypervisor: syntax: json file: true global: true + uiElementsDeleteMessage: "Warning: Following the actions below will permanently destroy the virtual machine." uiElements: - field: hostname label: "Hostname" From 0b65021f755e6ccc7d1ee14720137c025de6a748 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 12 Jun 2025 16:49:56 -0400 Subject: [PATCH 208/303] exit 1 if vm is not destroyed --- salt/manager/tools/sbin_jinja/so-salt-cloud | 23 +++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/salt/manager/tools/sbin_jinja/so-salt-cloud b/salt/manager/tools/sbin_jinja/so-salt-cloud index bf15efcc2..b56038613 100644 --- a/salt/manager/tools/sbin_jinja/so-salt-cloud +++ b/salt/manager/tools/sbin_jinja/so-salt-cloud @@ -336,20 +336,39 @@ def delete_vm(profile, vm_name, assume_yes=False): text=True ) + # Pattern to detect when no machines were found to be destroyed + no_machines_string = 'No machines were found to be destroyed' + no_machines_pattern = re.compile(re.escape(no_machines_string)) + machines_destroyed = False + # Monitor output for line in iter(process.stdout.readline, ''): if line: logger.info(line.rstrip('\n')) + # Check if no machines were found to be destroyed + if no_machines_pattern.search(line): + machines_destroyed = False + break + # If we see destruction messages, mark as successful + elif 'destroyed' in line.lower() and vm_name in line: + machines_destroyed = True + process.stdout.close() process.wait() - if process.returncode == 0: - # Start cleanup tasks + # Check success criteria: returncode == 0 AND machines were actually destroyed + if process.returncode == 0 and machines_destroyed: + # Start cleanup tasks only when actual deletion occurred cleanup_deleted_vm(ip, role) logger.info(f"Successfully deleted VM {vm_name}") + elif process.returncode == 0 and not machines_destroyed: + # Command succeeded but no machines were destroyed + logger.error(f"VM {vm_name} was not found to be destroyed") + sys.exit(1) else: logger.error(f"Failed to delete VM {vm_name}") + sys.exit(1) except Exception as e: logger.error(f"Failed to delete VM {vm_name}: {e}") From ab6060c48452d02fd0d6d6e801e0b561d0ef7572 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 12 Jun 2025 16:50:38 -0400 Subject: [PATCH 209/303] restore VM to VMs file so that it is still seen in soc if vm destroy fails --- .../engines/master/virtual_node_manager.py | 87 +++++++++++++++++-- 1 file changed, 78 insertions(+), 9 deletions(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index e7c28ef6a..a0e0e38f0 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -763,13 +763,31 @@ def process_vm_deletion(hypervisor_path: str, vm_name: str) -> None: This function handles the deletion of an existing VM. All operations are protected by the engine-wide lock that is acquired at engine start. + If so-salt-cloud fails during VM deletion, the function will restore the VM + configuration back to the VMs file to maintain consistency. + Args: hypervisor_path: Path to the hypervisor directory vm_name: Name of the VM to delete """ + vm_config = None + hypervisor = os.path.basename(hypervisor_path) + try: - # Get the actual hypervisor name (last directory in path) - hypervisor = os.path.basename(hypervisor_path) + # Read VM configuration from tracking file before attempting deletion + vm_file = os.path.join(hypervisor_path, vm_name) + if os.path.exists(vm_file): + try: + vm_data = read_json_file(vm_file) + vm_config = vm_data.get('config') if isinstance(vm_data, dict) else None + if vm_config: + log.debug("Read VM config for %s before deletion", vm_name) + else: + log.warning("No config found in tracking file for %s", vm_name) + except Exception as e: + log.warning("Failed to read VM config from tracking file %s: %s", vm_file, str(e)) + + # Attempt VM deletion with so-salt-cloud cmd = ['so-salt-cloud', '-p', f'sool9-{hypervisor}', vm_name, '-yd'] log.info("Executing: %s", ' '.join(cmd)) @@ -781,20 +799,73 @@ def process_vm_deletion(hypervisor_path: str, vm_name: str) -> None: if result.stderr: log.warning("Command stderr: %s", result.stderr) - # Remove VM tracking file - vm_file = os.path.join(hypervisor_path, vm_name) + # Remove VM tracking file on successful deletion if os.path.exists(vm_file): os.remove(vm_file) - log.info("Successfully removed VM tracking file") + log.info("Successfully removed VM tracking file for %s", vm_name) except subprocess.CalledProcessError as e: error_msg = f"so-salt-cloud deletion failed (code {e.returncode}): {e.stderr}" - log.error(error_msg) + log.error("%s", error_msg) + log.error("Esnure all hypervisors are online. salt-cloud will fail to destroy VMs if any hypervisors are offline.") + + # Attempt to restore VM configuration to VMs file if we have the config + if vm_config: + try: + _restore_vm_to_vms_file(hypervisor_path, hypervisor, vm_config) + except Exception as restore_error: + log.error("Failed to restore VM config after deletion failure: %s", str(restore_error)) + raise except Exception as e: log.error("Error processing VM deletion: %s", str(e)) raise + +def _restore_vm_to_vms_file(hypervisor_path: str, hypervisor: str, vm_config: dict) -> None: + """ + Restore VM configuration to the VMs file after failed deletion. + + Args: + hypervisor_path: Path to the hypervisor directory + hypervisor: Name of the hypervisor + vm_config: VM configuration to restore + """ + try: + # Construct VMs file path + vms_file = os.path.join(os.path.dirname(hypervisor_path), f"{hypervisor}VMs") + + # Read current VMs file + current_vms = [] + if os.path.exists(vms_file): + try: + current_vms = read_json_file(vms_file) + if not isinstance(current_vms, list): + log.warning("VMs file contains non-array data, initializing as empty array") + current_vms = [] + except Exception as e: + log.warning("Failed to read VMs file %s, initializing as empty: %s", vms_file, str(e)) + current_vms = [] + + # Check if VM already exists in VMs file (prevent duplicates) + vm_hostname = vm_config.get('hostname') + if vm_hostname: + for existing_vm in current_vms: + if isinstance(existing_vm, dict) and existing_vm.get('hostname') == vm_hostname: + log.info("VM with hostname %s already exists in VMs file, skipping restoration", vm_hostname) + return + + # Add VM configuration back to VMs file + current_vms.append(vm_config) + + # Write updated VMs file + write_json_file(vms_file, current_vms) + log.info("Successfully restored VM config for %s to VMs file %s", vm_hostname or 'unknown', vms_file) + + except Exception as e: + log.error("Failed to restore VM configuration: %s", str(e)) + raise + def process_hypervisor(hypervisor_path: str) -> None: """ Process VM configurations for a single hypervisor. @@ -876,7 +947,6 @@ def start(interval: int = DEFAULT_INTERVAL, instance of the virtual node manager runs at a time. The lock is: - Acquired at start - Released after processing completes - - Maintained if error occurs Args: interval: Time in seconds between engine runs (managed by salt-master) @@ -911,6 +981,5 @@ def start(interval: int = DEFAULT_INTERVAL, log.debug("Virtual node manager completed successfully") except Exception as e: - log.error("Error in virtual node manager - lock will remain until cleared: %s", str(e)) - # Don't release lock on error - requires admin intervention + log.error("Error in virtual node manager: %s", str(e)) return From 4729e194a049dc0eb3fbb5bdf68d1b5f73fa37c5 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 12 Jun 2025 17:01:23 -0400 Subject: [PATCH 210/303] spell ensure --- salt/salt/engines/master/virtual_node_manager.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index a0e0e38f0..bc098d075 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -807,7 +807,7 @@ def process_vm_deletion(hypervisor_path: str, vm_name: str) -> None: except subprocess.CalledProcessError as e: error_msg = f"so-salt-cloud deletion failed (code {e.returncode}): {e.stderr}" log.error("%s", error_msg) - log.error("Esnure all hypervisors are online. salt-cloud will fail to destroy VMs if any hypervisors are offline.") + log.error("Ensure all hypervisors are online. salt-cloud will fail to destroy VMs if any hypervisors are offline.") # Attempt to restore VM configuration to VMs file if we have the config if vm_config: From d3b1a4f92886bda2cd5375f9437150d437761e30 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 13 Jun 2025 15:21:23 -0400 Subject: [PATCH 211/303] use state file to only send highstate initiated event once --- salt/vm/status/init.sls | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/salt/vm/status/init.sls b/salt/vm/status/init.sls index 64124aa85..d4051e50c 100644 --- a/salt/vm/status/init.sls +++ b/salt/vm/status/init.sls @@ -20,7 +20,17 @@ vm_highstate_trigger: status: Highstate Initiated vm_name: {{ grains.id }} hypervisor: {{ salt['grains.get']('salt-cloud:profile', '').split('-')[1] }} - - order: 1 # Ensure this runs early in the highstate process + - unless: test -f /opt/so/state/highstate_trigger.txt + - order: 1 # Ensure this runs early in the highstate process + +# Check if the trigger has already run +vm_highstate_trigger_file: + file.managed: + - name: /opt/so/state/highstate_trigger.txt + - contents: | + VM Highstate Trigger executed at: {{ salt['cmd.run']('date') }} + - onchanges: + - event: vm_highstate_trigger {% else %} From 19fb081fa09d26722efaa1da517724c6c5b682bc Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 13 Jun 2025 15:21:38 -0400 Subject: [PATCH 212/303] additional log info --- salt/manager/tools/sbin_jinja/so-salt-cloud | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/manager/tools/sbin_jinja/so-salt-cloud b/salt/manager/tools/sbin_jinja/so-salt-cloud index b56038613..c8d61e2f3 100644 --- a/salt/manager/tools/sbin_jinja/so-salt-cloud +++ b/salt/manager/tools/sbin_jinja/so-salt-cloud @@ -364,7 +364,7 @@ def delete_vm(profile, vm_name, assume_yes=False): logger.info(f"Successfully deleted VM {vm_name}") elif process.returncode == 0 and not machines_destroyed: # Command succeeded but no machines were destroyed - logger.error(f"VM {vm_name} was not found to be destroyed") + logger.error(f"VM {vm_name} was not found to be destroyed. Verify that all configured hypervisors are online.") sys.exit(1) else: logger.error(f"Failed to delete VM {vm_name}") From 480e248131c8512cdfcd2e84649497b8e4e7ed19 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 20 Jun 2025 16:24:54 -0400 Subject: [PATCH 213/303] ensure bond and interfaces only added once --- salt/sensor/vm/network.sls | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/salt/sensor/vm/network.sls b/salt/sensor/vm/network.sls index 9e25bca65..3e388adf6 100644 --- a/salt/sensor/vm/network.sls +++ b/salt/sensor/vm/network.sls @@ -35,6 +35,7 @@ bond0_interface: connection.autoconnect yes nmcli con mod bond0 ethernet.mtu 9000 nmcli con up bond0 + - unless: nmcli con show bond0 {% if non_enp1s0_interfaces|length > 0 %} - require_in: {% for iface in non_enp1s0_interfaces %} @@ -55,7 +56,7 @@ bond0_interface: slave-type bond \ ethernet.mtu 9000 nmcli con up bond0-slave-{{ iface }} - + - unless: nmcli con show bond0-slave-{{ iface }} {% endfor %} {% endif %} From fbb6d8146a3887d838370ec834bb7a958de7dda9 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 25 Jun 2025 00:21:49 -0500 Subject: [PATCH 214/303] regen installers --- salt/manager/tools/sbin/soup | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/salt/manager/tools/sbin/soup b/salt/manager/tools/sbin/soup index d27239228..8c94bd6cb 100755 --- a/salt/manager/tools/sbin/soup +++ b/salt/manager/tools/sbin/soup @@ -576,13 +576,13 @@ post_to_2.4.141() { } post_to_2.4.150() { - echo "Regenerating Elastic Agent Installers" - /sbin/so-elastic-agent-gen-installers + echo "Nothing to apply" POSTVERSION=2.4.150 } post_to_2.4.160() { - echo "Nothing to apply" + echo "Regenerating Elastic Agent Installers" + /sbin/so-elastic-agent-gen-installers POSTVERSION=2.4.160 } From 373ef9fe91f9ccf918011ccfd083a879affba76b Mon Sep 17 00:00:00 2001 From: Mike Reeves Date: Wed, 25 Jun 2025 13:58:25 -0400 Subject: [PATCH 215/303] Update VERSION --- VERSION | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VERSION b/VERSION index 3fe7dce73..032d0bb01 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -2.4.160 +2.4.170 From 5e62d3ecb230f1a2afbce32fab147e30dec15d90 Mon Sep 17 00:00:00 2001 From: Mike Reeves Date: Wed, 25 Jun 2025 13:58:57 -0400 Subject: [PATCH 216/303] Update 2-4.yml --- .github/DISCUSSION_TEMPLATE/2-4.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/DISCUSSION_TEMPLATE/2-4.yml b/.github/DISCUSSION_TEMPLATE/2-4.yml index d192a0eec..dca40818a 100644 --- a/.github/DISCUSSION_TEMPLATE/2-4.yml +++ b/.github/DISCUSSION_TEMPLATE/2-4.yml @@ -29,6 +29,7 @@ body: - 2.4.141 - 2.4.150 - 2.4.160 + - 2.4.170 - Other (please provide detail below) validations: required: true From 34e561f358e82cea5292ecb3a26bd66c3fcf7a53 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 25 Jun 2025 13:47:44 -0500 Subject: [PATCH 217/303] soup 2.4.170 --- salt/manager/tools/sbin/soup | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/salt/manager/tools/sbin/soup b/salt/manager/tools/sbin/soup index 8c94bd6cb..9fd8171bd 100755 --- a/salt/manager/tools/sbin/soup +++ b/salt/manager/tools/sbin/soup @@ -418,6 +418,7 @@ preupgrade_changes() { [[ "$INSTALLEDVERSION" == 2.4.140 ]] && up_to_2.4.141 [[ "$INSTALLEDVERSION" == 2.4.141 ]] && up_to_2.4.150 [[ "$INSTALLEDVERSION" == 2.4.150 ]] && up_to_2.4.160 + [[ "$INSTALLEDVERSION" == 2.4.160 ]] && up_to_2.4.170 true } @@ -446,6 +447,7 @@ postupgrade_changes() { [[ "$POSTVERSION" == 2.4.140 ]] && post_to_2.4.141 [[ "$POSTVERSION" == 2.4.141 ]] && post_to_2.4.150 [[ "$POSTVERSION" == 2.4.150 ]] && post_to_2.4.160 + [[ "$POSTVERSION" == 2.4.160 ]] && post_to_2.4.170 true } @@ -581,9 +583,14 @@ post_to_2.4.150() { } post_to_2.4.160() { + echo "Nothing to apply" + POSTVERSION=2.4.160 +} + +post_to_2.4.170() { echo "Regenerating Elastic Agent Installers" /sbin/so-elastic-agent-gen-installers - POSTVERSION=2.4.160 + POSTVERSION=2.4.170 } repo_sync() { @@ -829,6 +836,12 @@ up_to_2.4.160() { INSTALLEDVERSION=2.4.160 } +up_to_2.4.170() { + echo "Nothing to do for 2.4.170" + + INSTALLEDVERSION=2.4.170 +} + add_hydra_pillars() { mkdir -p /opt/so/saltstack/local/pillar/hydra touch /opt/so/saltstack/local/pillar/hydra/soc_hydra.sls From b2acf2f8078f99c573266889e8db7bddf368dfec Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 25 Jun 2025 15:05:49 -0400 Subject: [PATCH 218/303] change logic for determining if vm was destroyed --- salt/manager/tools/sbin_jinja/so-salt-cloud | 33 ++++++++++++++++----- 1 file changed, 25 insertions(+), 8 deletions(-) diff --git a/salt/manager/tools/sbin_jinja/so-salt-cloud b/salt/manager/tools/sbin_jinja/so-salt-cloud index c8d61e2f3..daa92fa67 100644 --- a/salt/manager/tools/sbin_jinja/so-salt-cloud +++ b/salt/manager/tools/sbin_jinja/so-salt-cloud @@ -339,33 +339,50 @@ def delete_vm(profile, vm_name, assume_yes=False): # Pattern to detect when no machines were found to be destroyed no_machines_string = 'No machines were found to be destroyed' no_machines_pattern = re.compile(re.escape(no_machines_string)) + + # Track if we found any successful destruction machines_destroyed = False + output_lines = [] # Monitor output for line in iter(process.stdout.readline, ''): if line: logger.info(line.rstrip('\n')) + output_lines.append(line.strip()) # Check if no machines were found to be destroyed if no_machines_pattern.search(line): machines_destroyed = False break - # If we see destruction messages, mark as successful - elif 'destroyed' in line.lower() and vm_name in line: - machines_destroyed = True process.stdout.close() process.wait() - # Check success criteria: returncode == 0 AND machines were actually destroyed + # If we hit the "No machines were found" case, it's a failure + if no_machines_pattern.search('\n'.join(output_lines)): + logger.error(f"VM {vm_name} was not found to be destroyed. Verify that all configured hypervisors are online.") + sys.exit(1) + + # Check for successful destruction patterns in the output + # Look for the VM name appearing in libvirt section - this indicates successful processing + full_output = '\n'.join(output_lines) + if vm_name in full_output and 'libvirt:' in full_output: + # VM was processed by libvirt, which means destruction was attempted + # If we reach here and didn't hit the "No machines found" case, it's success + machines_destroyed = True + + # Check success criteria: returncode == 0 AND we found evidence of destruction if process.returncode == 0 and machines_destroyed: # Start cleanup tasks only when actual deletion occurred cleanup_deleted_vm(ip, role) logger.info(f"Successfully deleted VM {vm_name}") - elif process.returncode == 0 and not machines_destroyed: - # Command succeeded but no machines were destroyed - logger.error(f"VM {vm_name} was not found to be destroyed. Verify that all configured hypervisors are online.") - sys.exit(1) + elif process.returncode == 0: + # Command succeeded but we couldn't confirm destruction - this is the edge case we're fixing + # If salt-cloud returned 0 and we didn't hit the "No machines found" case, + # but we also don't see clear destruction evidence, we should still consider it success + # because salt-cloud returning 0 means it completed successfully + cleanup_deleted_vm(ip, role) + logger.info(f"Successfully deleted VM {vm_name} (salt-cloud completed successfully)") else: logger.error(f"Failed to delete VM {vm_name}") sys.exit(1) From daaad3699c7c2ea531f3b707398dace61d08a02d Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 25 Jun 2025 17:20:17 -0400 Subject: [PATCH 219/303] allow wheel files --- .github/.gitleaks.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/.gitleaks.toml b/.github/.gitleaks.toml index 2111ed7bc..32c27b355 100644 --- a/.github/.gitleaks.toml +++ b/.github/.gitleaks.toml @@ -542,4 +542,5 @@ paths = [ '''(.*?)(jpg|gif|doc|pdf|bin|svg|socket)$''', '''(go.mod|go.sum)$''', '''salt/nginx/files/enterprise-attack.json''' + '''(.*?)whl$ ] From 8fdc7049f939e7b40ca18d87d2b5376a9d6c4439 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 27 Jun 2025 10:53:03 -0400 Subject: [PATCH 220/303] add missing , --- .github/.gitleaks.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/.gitleaks.toml b/.github/.gitleaks.toml index 32c27b355..40e6ccabf 100644 --- a/.github/.gitleaks.toml +++ b/.github/.gitleaks.toml @@ -541,6 +541,6 @@ paths = [ '''gitleaks.toml''', '''(.*?)(jpg|gif|doc|pdf|bin|svg|socket)$''', '''(go.mod|go.sum)$''', - '''salt/nginx/files/enterprise-attack.json''' + '''salt/nginx/files/enterprise-attack.json''', '''(.*?)whl$ ] From b0f521877511af728634ab0672fbc7494dadf55f Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 27 Jun 2025 10:58:14 -0400 Subject: [PATCH 221/303] add quotes --- .github/.gitleaks.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/.gitleaks.toml b/.github/.gitleaks.toml index 40e6ccabf..009f1c613 100644 --- a/.github/.gitleaks.toml +++ b/.github/.gitleaks.toml @@ -542,5 +542,5 @@ paths = [ '''(.*?)(jpg|gif|doc|pdf|bin|svg|socket)$''', '''(go.mod|go.sum)$''', '''salt/nginx/files/enterprise-attack.json''', - '''(.*?)whl$ + '''(.*?)whl$''' ] From 493359e5a2dc5efb82f549a6a3d7799cbedcb062 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 27 Jun 2025 11:00:35 -0400 Subject: [PATCH 222/303] cleanup --- .gitignore | 8 -------- 1 file changed, 8 deletions(-) diff --git a/.gitignore b/.gitignore index fc9d41531..fb154cae7 100644 --- a/.gitignore +++ b/.gitignore @@ -67,11 +67,3 @@ __pycache__ # Analyzer dev/test config files *_dev.yaml site-packages - -# Project Scope Directory -.projectScope/ -.clinerules -cline_docs/ - -# vscode settings -.vscode/ From b93c6c02702e721c43abaeb548bf4a5dc7d8343b Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 30 Jun 2025 09:51:40 -0400 Subject: [PATCH 223/303] allow standalone and managersearch to run salt.cloud state --- salt/allowed_states.map.jinja | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/salt/allowed_states.map.jinja b/salt/allowed_states.map.jinja index 3edda8a4c..2f65b9213 100644 --- a/salt/allowed_states.map.jinja +++ b/salt/allowed_states.map.jinja @@ -116,7 +116,7 @@ 'so-managersearch': ( ssl_states + manager_states + - ['strelka.manager'] + + ['salt.cloud', 'strelka.manager'] + stig_states + kafka_states + elastic_stack_states @@ -129,6 +129,7 @@ 'so-standalone': ( ssl_states + manager_states + + ['salt.cloud'] + sensor_states + stig_states + kafka_states + From 5035ec25397071fb4ca5f11e57a40217d7054e88 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 30 Jun 2025 11:21:45 -0400 Subject: [PATCH 224/303] allow libvirt states --- salt/allowed_states.map.jinja | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/salt/allowed_states.map.jinja b/salt/allowed_states.map.jinja index 2f65b9213..068722ca2 100644 --- a/salt/allowed_states.map.jinja +++ b/salt/allowed_states.map.jinja @@ -116,7 +116,7 @@ 'so-managersearch': ( ssl_states + manager_states + - ['salt.cloud', 'strelka.manager'] + + ['salt.cloud', 'libvirt.packages', 'libvirt.ssh.users', 'strelka.manager'] + stig_states + kafka_states + elastic_stack_states @@ -129,7 +129,7 @@ 'so-standalone': ( ssl_states + manager_states + - ['salt.cloud'] + + ['salt.cloud', 'libvirt.packages', 'libvirt.ssh.users'] + sensor_states + stig_states + kafka_states + From 33c23c30d32c27ad8ced37f9932e6031998d69bc Mon Sep 17 00:00:00 2001 From: Corey Ogburn Date: Mon, 30 Jun 2025 11:43:02 -0600 Subject: [PATCH 225/303] Refactors playbook repo configuration Replaces individual playbook repo fields with an array of repos to support multiple playbook sources. Refactor Jinja. --- salt/soc/defaults.yaml | 14 +++++++++----- salt/soc/merged.map.jinja | 6 +++--- 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/salt/soc/defaults.yaml b/salt/soc/defaults.yaml index 66355fa24..42e07a7c0 100644 --- a/salt/soc/defaults.yaml +++ b/salt/soc/defaults.yaml @@ -1464,12 +1464,16 @@ soc: autoUpdateEnabled: true playbookImportFrequencySeconds: 86400 playbookImportErrorSeconds: 600 - playbookRepoUrl: - default: https://github.com/Security-Onion-Solutions/securityonion-resources-playbooks - airgap: file:///nsm/airgap-resources/playbooks/securityonion-resources-playbooks - playbookRepoBranch: main playbookRepoPath: /opt/sensoroni/playbooks/ - playbookPathInRepo: securityonion-normalized + playbookRepos: + default: + - repo: https://github.com/Security-Onion-Solutions/securityonion-resources-playbooks + branch: main + folder: securityonion-normalized + airgap: + - repo: file:///nsm/airgap-resources/playbooks/securityonion-resources-playbooks + branch: main + folder: securityonion-normalized salt: queueDir: /opt/sensoroni/queue timeoutMs: 45000 diff --git a/salt/soc/merged.map.jinja b/salt/soc/merged.map.jinja index c950d8a60..e053ce63f 100644 --- a/salt/soc/merged.map.jinja +++ b/salt/soc/merged.map.jinja @@ -61,11 +61,11 @@ {% do SOCMERGED.config.server.update({'airgapEnabled': false}) %} {% endif %} -{# set playbookRepoUrl based on airgap or not #} +{# set playbookRepos based on airgap or not #} {% if GLOBALS.airgap %} -{% do SOCMERGED.config.server.modules.playbook.update({'playbookRepoUrl': SOCMERGED.config.server.modules.playbook.playbookRepoUrl.airgap}) %} +{% do SOCMERGED.config.server.modules.playbook.update({'playbookRepos': SOCMERGED.config.server.modules.playbook.playbookRepos.airgap}) %} {% else %} -{% do SOCMERGED.config.server.modules.playbook.update({'playbookRepoUrl': SOCMERGED.config.server.modules.playbook.playbookRepoUrl.default}) %} +{% do SOCMERGED.config.server.modules.playbook.update({'playbookRepos': SOCMERGED.config.server.modules.playbook.playbookRepos.default}) %} {% endif %} {# remove these modules if detections is disabled #} From a86105294b9ef7f4f8270bd59f43d13df719fccd Mon Sep 17 00:00:00 2001 From: Corey Ogburn Date: Mon, 30 Jun 2025 12:50:56 -0600 Subject: [PATCH 226/303] Playbook Annotations --- salt/soc/soc_soc.yaml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/salt/soc/soc_soc.yaml b/salt/soc/soc_soc.yaml index 58560e89e..bbe963ec8 100644 --- a/salt/soc/soc_soc.yaml +++ b/salt/soc/soc_soc.yaml @@ -552,6 +552,23 @@ soc: description: How far back to search for ATT&CK-tagged alerts. (days) global: True helpLink: attack-navigator.html + playbook: + playbookRepos: + default: &pbRepos + description: "Custom Git repositories to pull Playbooks from. Playbooks are pulled when SOC starts and automatically refreshed every 24 hours. If this grid is airgapped then edit the airgap repos. Otherwise edit the default repos." + global: True + advanced: True + forcedType: "[]{}" + syntax: json + uiElements: + - field: repo + label: Repo URL + required: True + - field: branch + label: Branch + - field: folder + label: Folder + airgap: *pbRepos client: enableReverseLookup: description: Set to true to enable reverse DNS lookups for IP addresses in the SOC UI. From dea9c149d78b9b728d4a0c82193bfef07ce7ca28 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 30 Jun 2025 15:30:39 -0400 Subject: [PATCH 227/303] only run storage state if box has nvme --- salt/storage/init.sls | 6 ++++++ salt/storage/nsm_mount.sls | 2 +- salt/storage/{files => tools/sbin}/so-nsm-cleanup | 0 salt/storage/{files => tools/sbin}/so-nsm-mount | 0 4 files changed, 7 insertions(+), 1 deletion(-) rename salt/storage/{files => tools/sbin}/so-nsm-cleanup (100%) rename salt/storage/{files => tools/sbin}/so-nsm-mount (100%) diff --git a/salt/storage/init.sls b/salt/storage/init.sls index 5bce7e71a..533366fd0 100644 --- a/salt/storage/init.sls +++ b/salt/storage/init.sls @@ -3,5 +3,11 @@ # https://securityonion.net/license; you may not use this file except in compliance with the # Elastic License 2.0. + +{% set nvme_devices = salt['cmd.shell']("find /dev -name 'nvme*n1' 2>/dev/null") %} +{% if nvme_devices %} + include: - storage.nsm_mount + +{% endif %} diff --git a/salt/storage/nsm_mount.sls b/salt/storage/nsm_mount.sls index b0476e054..ed9e97c33 100644 --- a/salt/storage/nsm_mount.sls +++ b/salt/storage/nsm_mount.sls @@ -23,7 +23,7 @@ storage_nsm_mount_logdir: storage_nsm_mount_script: file.managed: - name: /usr/sbin/so-nsm-mount - - source: salt://storage/files/so-nsm-mount + - source: salt://storage/tools/sbin/so-nsm-mount - mode: 755 - user: root - group: root diff --git a/salt/storage/files/so-nsm-cleanup b/salt/storage/tools/sbin/so-nsm-cleanup similarity index 100% rename from salt/storage/files/so-nsm-cleanup rename to salt/storage/tools/sbin/so-nsm-cleanup diff --git a/salt/storage/files/so-nsm-mount b/salt/storage/tools/sbin/so-nsm-mount similarity index 100% rename from salt/storage/files/so-nsm-mount rename to salt/storage/tools/sbin/so-nsm-mount From d003e1380f0e7dc2b648aea30bcc4241c58cfc39 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 2 Jul 2025 16:14:43 -0400 Subject: [PATCH 228/303] ensure hypervisor is remove from salt cloud profiles when key is deleted --- salt/orch/delete_hypervisor.sls | 17 +++++++++++++++++ salt/reactor/check_hypervisor.sls | 16 +++++++++++++++- 2 files changed, 32 insertions(+), 1 deletion(-) create mode 100644 salt/orch/delete_hypervisor.sls diff --git a/salt/orch/delete_hypervisor.sls b/salt/orch/delete_hypervisor.sls new file mode 100644 index 000000000..3249d11b5 --- /dev/null +++ b/salt/orch/delete_hypervisor.sls @@ -0,0 +1,17 @@ +{% set hypervisor = pillar.minion_id %} + +ensure_hypervisor_mine_deleted: + salt.function: + - name: file.remove + - tgt: 'G@role:so-manager or G@role:so-managerhype or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' + - tgt_type: compound + - arg: + - /var/cache/salt/master/minions/{{hypervisor}} + +update_salt_cloud_profile: + salt.state: + - tgt: 'G@role:so-manager or G@role:so-managerhype or G@role:so-managersearch or G@role:so-standalone or G@role:so-eval' + - tgt_type: compound + - sls: + - salt.cloud.config + - concurrent: True diff --git a/salt/reactor/check_hypervisor.sls b/salt/reactor/check_hypervisor.sls index 889656b36..2f3831471 100644 --- a/salt/reactor/check_hypervisor.sls +++ b/salt/reactor/check_hypervisor.sls @@ -1,5 +1,19 @@ -{% if data['act'] == 'accept' and data['id'].endswith(('_hypervisor', '_managerhyper')) and data['result'] == True %} +{% if data['id'].endswith('_hypervisor') and data['result'] == True %} + +{% if data['act'] == 'accept' %} check_and_trigger: runner.setup_hypervisor.setup_environment: - minion_id: {{ data['id'] }} +{% endif %} + +{% if data['act'] == 'delete' %} +delete_hypervisor: + runner.state.orchestrate: + - args: + - mods: orch.delete_hypervisor + - pillar: + minion_id: {{ data['id'] }} +{% endif %} + {% endif %} + From 6d7066c38162316e8286f3290c33049e2640ae97 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 2 Jul 2025 16:20:30 -0400 Subject: [PATCH 229/303] add license --- salt/orch/delete_hypervisor.sls | 5 +++++ salt/reactor/check_hypervisor.sls | 5 +++++ 2 files changed, 10 insertions(+) diff --git a/salt/orch/delete_hypervisor.sls b/salt/orch/delete_hypervisor.sls index 3249d11b5..3f0bd02b6 100644 --- a/salt/orch/delete_hypervisor.sls +++ b/salt/orch/delete_hypervisor.sls @@ -1,3 +1,8 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + {% set hypervisor = pillar.minion_id %} ensure_hypervisor_mine_deleted: diff --git a/salt/reactor/check_hypervisor.sls b/salt/reactor/check_hypervisor.sls index 2f3831471..91b7c0c02 100644 --- a/salt/reactor/check_hypervisor.sls +++ b/salt/reactor/check_hypervisor.sls @@ -1,3 +1,8 @@ +# Copyright Security Onion Solutions LLC and/or licensed to Security Onion Solutions LLC under one +# or more contributor license agreements. Licensed under the Elastic License 2.0 as shown at +# https://securityonion.net/license; you may not use this file except in compliance with the +# Elastic License 2.0. + {% if data['id'].endswith('_hypervisor') and data['result'] == True %} {% if data['act'] == 'accept' %} From d8be6e42e13a427e3acaa9d02f7a8f72bc908691 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Mon, 7 Jul 2025 12:58:00 -0500 Subject: [PATCH 230/303] es 8.18.3 --- VERSION | 2 +- salt/elasticsearch/defaults.yaml | 2 +- salt/kibana/defaults.yaml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/VERSION b/VERSION index 032d0bb01..452820224 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -2.4.170 +2.4.0-foxtrot \ No newline at end of file diff --git a/salt/elasticsearch/defaults.yaml b/salt/elasticsearch/defaults.yaml index 1f81e95d2..73c29c8c6 100644 --- a/salt/elasticsearch/defaults.yaml +++ b/salt/elasticsearch/defaults.yaml @@ -1,6 +1,6 @@ elasticsearch: enabled: false - version: 8.17.3 + version: 8.18.3 index_clean: true config: action: diff --git a/salt/kibana/defaults.yaml b/salt/kibana/defaults.yaml index 2446821f1..a636f9b79 100644 --- a/salt/kibana/defaults.yaml +++ b/salt/kibana/defaults.yaml @@ -22,7 +22,7 @@ kibana: - default - file migrations: - discardCorruptObjects: "8.17.3" + discardCorruptObjects: "8.18.3" telemetry: enabled: False security: From 4bf2c931e9e7279b64f79da589c6000a58506d14 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 8 Jul 2025 08:43:24 -0500 Subject: [PATCH 231/303] make sure required file exists to generate ADDON_INTEGRATION_DEFAULTS --- salt/manager/managed_soc_annotations.sls | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/manager/managed_soc_annotations.sls b/salt/manager/managed_soc_annotations.sls index 17621f973..9ef0b1ea1 100644 --- a/salt/manager/managed_soc_annotations.sls +++ b/salt/manager/managed_soc_annotations.sls @@ -5,7 +5,7 @@ {# Managed elasticsearch/soc_elasticsearch.yaml file for adding integration configuration items to UI #} {% set managed_integrations = salt['pillar.get']('elasticsearch:managed_integrations', []) %} -{% if managed_integrations %} +{% if managed_integrations and salt['file.file_exists']('/opt/so/state/esfleet_package_components.json') %} {% from 'elasticfleet/integration-defaults.map.jinja' import ADDON_INTEGRATION_DEFAULTS %} {% set addon_integration_keys = ADDON_INTEGRATION_DEFAULTS.keys() %} {% set matched_integration_names = [] %} From 42552810fb1ce3b217deef9573495becce365044 Mon Sep 17 00:00:00 2001 From: Josh Brower Date: Tue, 8 Jul 2025 09:50:08 -0400 Subject: [PATCH 232/303] Add user.name to kratos query --- salt/soc/defaults.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/soc/defaults.yaml b/salt/soc/defaults.yaml index 42e07a7c0..cb12671f8 100644 --- a/salt/soc/defaults.yaml +++ b/salt/soc/defaults.yaml @@ -1910,7 +1910,7 @@ soc: query: 'event.dataset:kratos.audit AND msg:*authenticated* | groupby http_request.headers.x-real-ip | groupby -sankey http_request.headers.x-real-ip user.name | groupby user.name | groupby http_request.headers.user-agent' - name: SOC Login Failures description: SOC (Security Onion Console) login failures - query: 'event.dataset:kratos.audit AND msg:*Encountered*self-service*login*error* | groupby http_request.headers.x-real-ip | groupby -sankey http_request.headers.x-real-ip http_request.headers.user-agent | groupby http_request.headers.user-agent' + query: 'event.dataset:kratos.audit AND msg:*Encountered*self-service*login*error* | groupby user.name | groupby http_request.headers.x-real-ip | groupby -sankey http_request.headers.x-real-ip http_request.headers.user-agent | groupby http_request.headers.user-agent' - name: Alerts description: Overview of all alerts query: 'tags:alert | groupby event.module* | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby rule.name | groupby event.severity | groupby destination_geo.organization_name' From d4f0cbcb677b80407e70d940d7a5a4f153429495 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 8 Jul 2025 15:23:46 -0500 Subject: [PATCH 233/303] changes for 'generic' integrations with no compoent templates assigned. Default to using the logs-filestream.generic@package componet template --- .../integration-defaults.map.jinja | 132 ++++++++++-------- ...o-elastic-fleet-optional-integrations-load | 4 + .../so-elasticsearch-templates-load | 2 +- 3 files changed, 81 insertions(+), 57 deletions(-) diff --git a/salt/elasticfleet/integration-defaults.map.jinja b/salt/elasticfleet/integration-defaults.map.jinja index 5449e791e..62e37b229 100644 --- a/salt/elasticfleet/integration-defaults.map.jinja +++ b/salt/elasticfleet/integration-defaults.map.jinja @@ -4,6 +4,7 @@ {% import_json '/opt/so/state/esfleet_package_components.json' as ADDON_PACKAGE_COMPONENTS %} +{% import_json '/opt/so/state/esfleet_package_components.json' as INSTALLED_COMPONENT_TEMPLATES %} {% import_yaml 'elasticfleet/defaults.yaml' as ELASTICFLEETDEFAULTS %} {% set CORE_ESFLEET_PACKAGES = ELASTICFLEETDEFAULTS.get('elasticfleet', {}).get('packages', {}) %} @@ -62,70 +63,89 @@ {% else %} {% set integration_type = "" %} {% endif %} -{% set component_name = pkg.name ~ "." ~ pattern.title %} -{# fix weirdly named components #} -{% if component_name in WEIRD_INTEGRATIONS %} -{% set component_name = WEIRD_INTEGRATIONS[component_name] %} -{% endif %} +{% set component_name = pkg.name ~ "." ~ pattern.title %} +{% set index_pattern = pattern.name %} + +{# fix weirdly named components #} +{% if component_name in WEIRD_INTEGRATIONS %} +{% set component_name = WEIRD_INTEGRATIONS[component_name] %} +{% endif %} + +{# create duplicate of component_name, so we can split generics from @custom component templates in the index template below and overwrite the default @package when needed + eg. having to replace unifiedlogs.generic@package with filestream.generic@package, but keep the ability to customize unifiedlogs.generic@custom and its ILM policy #} +{% set custom_component_name = component_name %} + +{# duplicate integration_type to assist with sometimes needing to overwrite component templates with 'logs-filestream.generic@package' (there is no metrics-filestream.generic@package) #} +{% set generic_integration_type = integration_type %} + {# component_name_x maintains the functionality of merging local pillar changes with generated 'defaults' via SOC UI #} {% set component_name_x = component_name.replace(".","_x_") %} {# pillar overrides/merge expects the key names to follow the naming in elasticsearch/defaults.yaml eg. so-logs-1password_x_item_usages . The _x_ is replaced later on in elasticsearch/template.map.jinja #} {% set integration_key = "so-" ~ integration_type ~ component_name_x %} +{% if ".generic" in component_name and component_name not in INSTALLED_COMPONENT_TEMPLATES %} +{# these generic templates by default are directed to index_pattern of 'logs-generic-*', overwrite that here to point to eg gcp_pubsub.generic-* #} +{% set index_pattern = integration_type ~ component_name ~ "-*" %} +{# includes use of .generic component template, but it doesn't exist in installed component templates. Redirect it to filestream.generic@package #} +{% set component_name = "filestream.generic" %} +{% set generic_integration_type = "logs-" %} +{% endif %} + {# Default integration settings #} {% set integration_defaults = { - "index_sorting": false, - "index_template": { - "composed_of": [integration_type ~ component_name ~ "@package", integration_type ~ component_name ~ "@custom", "so-fleet_integrations.ip_mappings-1", "so-fleet_globals-1", "so-fleet_agent_id_verification-1"], - "data_stream": { - "allow_custom_routing": false, - "hidden": false - }, - "ignore_missing_component_templates": [integration_type ~ component_name ~ "@custom"], - "index_patterns": [pattern.name], - "priority": 501, - "template": { - "settings": { - "index": { - "lifecycle": {"name": "so-" ~ integration_type ~ component_name ~ "-logs"}, - "number_of_replicas": 0 - } - } - } - }, - "policy": { - "phases": { - "cold": { - "actions": { - "set_priority": {"priority": 0} - }, - "min_age": "60d" + "index_sorting": false, + "index_template": { + "composed_of": [generic_integration_type ~ component_name ~ "@package", integration_type ~ custom_component_name ~ "@custom", "so-fleet_integrations.ip_mappings-1", "so-fleet_globals-1", "so-fleet_agent_id_verification-1"], + "data_stream": { + "allow_custom_routing": false, + "hidden": false + }, + "ignore_missing_component_templates": [integration_type ~ custom_component_name ~ "@custom"], + "index_patterns": [index_pattern], + "priority": 501, + "template": { + "settings": { + "index": { + "lifecycle": {"name": "so-" ~ integration_type ~ custom_component_name ~ "-logs"}, + "number_of_replicas": 0 + } + } + } + }, + "policy": { + "phases": { + "cold": { + "actions": { + "set_priority": {"priority": 0} + }, + "min_age": "60d" + }, + "delete": { + "actions": { + "delete": {} + }, + "min_age": "365d" + }, + "hot": { + "actions": { + "rollover": { + "max_age": "30d", + "max_primary_shard_size": "50gb" + }, + "set_priority": {"priority": 100} }, - "delete": { - "actions": { - "delete": {} - }, - "min_age": "365d" - }, - "hot": { - "actions": { - "rollover": { - "max_age": "30d", - "max_primary_shard_size": "50gb" - }, - "set_priority": {"priority": 100} - }, - "min_age": "0ms" - }, - "warm": { - "actions": { - "set_priority": {"priority": 50} - }, - "min_age": "30d" - } - } - } - } %} + "min_age": "0ms" + }, + "warm": { + "actions": { + "set_priority": {"priority": 50} + }, + "min_age": "30d" + } + } + } + } %} + {% do ADDON_INTEGRATION_DEFAULTS.update({integration_key: integration_defaults}) %} {% endfor %} {% endif %} diff --git a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load index 26d775e82..df01608f5 100644 --- a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load +++ b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load @@ -19,6 +19,7 @@ BULK_INSTALL_PACKAGE_LIST=/tmp/esfleet_bulk_install.json BULK_INSTALL_PACKAGE_TMP=/tmp/esfleet_bulk_install_tmp.json BULK_INSTALL_OUTPUT=/opt/so/state/esfleet_bulk_install_results.json PACKAGE_COMPONENTS=/opt/so/state/esfleet_package_components.json +COMPONENT_TEMPLATES=/opt/so/state/esfleet_component_templates.txt PENDING_UPDATE=false @@ -155,6 +156,9 @@ if [[ -f $STATE_FILE_SUCCESS ]]; then # Write out file for generating index/component/ilm templates latest_installed_package_list=$(elastic_fleet_installed_packages) echo $latest_installed_package_list | jq '[.items[] | {name: .name, es_index_patterns: .dataStreams}]' > $PACKAGE_COMPONENTS + # Refresh installed component template list + latest_component_templates_list=$(so-elasticsearch-query _component_template | jq '.component_templates[] | .name' | jq -s '.') + echo $latest_component_templates_list > $COMPONENT_TEMPLATES else # This is the installation of add-on integrations and upgrade of existing integrations. Exiting without error, next highstate will attempt to re-run. diff --git a/salt/elasticsearch/tools/sbin_jinja/so-elasticsearch-templates-load b/salt/elasticsearch/tools/sbin_jinja/so-elasticsearch-templates-load index 758f601eb..ba5767255 100755 --- a/salt/elasticsearch/tools/sbin_jinja/so-elasticsearch-templates-load +++ b/salt/elasticsearch/tools/sbin_jinja/so-elasticsearch-templates-load @@ -136,7 +136,7 @@ if [ ! -f $STATE_FILE_SUCCESS ]; then TEMPLATE=${i::-14} COMPONENT_PATTERN=${TEMPLATE:3} MATCH=$(echo "$TEMPLATE" | grep -E "^so-logs-|^so-metrics" | grep -vE "detections|osquery") - if [[ -n "$MATCH" && ! "$COMPONENT_LIST" =~ "$COMPONENT_PATTERN" && ! "$COMPONENT_PATTERN" =~ logs-http_endpoint\.generic|logs-winlog\.winlog ]]; then + if [[ -n "$MATCH" && ! "$COMPONENT_LIST" =~ "$COMPONENT_PATTERN" && ! "$COMPONENT_PATTERN" =~ *\.generic|logs-winlog\.winlog ]]; then load_failures=$((load_failures+1)) echo "Component template does not exist for $COMPONENT_PATTERN. The index template will not be loaded. Load failures: $load_failures" else From bef2fa9e8d5b06c13f045cb7436da05e16c64b1b Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 8 Jul 2025 16:09:16 -0500 Subject: [PATCH 234/303] 8.18.3 pipeline updates --- .../grid-nodes_general/import-evtx-logs.json | 2 +- ...nse.log-1.21.0 => logs-pfsense.log-1.23.0} | 28 +++++++------------ ...icata => logs-pfsense.log-1.23.0-suricata} | 0 3 files changed, 11 insertions(+), 19 deletions(-) rename salt/elasticsearch/files/ingest/{logs-pfsense.log-1.21.0 => logs-pfsense.log-1.23.0} (93%) rename salt/elasticsearch/files/ingest/{logs-pfsense.log-1.21.0-suricata => logs-pfsense.log-1.23.0-suricata} (100%) diff --git a/salt/elasticfleet/files/integrations/grid-nodes_general/import-evtx-logs.json b/salt/elasticfleet/files/integrations/grid-nodes_general/import-evtx-logs.json index 46717f3e1..415e333e7 100644 --- a/salt/elasticfleet/files/integrations/grid-nodes_general/import-evtx-logs.json +++ b/salt/elasticfleet/files/integrations/grid-nodes_general/import-evtx-logs.json @@ -20,7 +20,7 @@ ], "data_stream.dataset": "import", "custom": "", - "processors": "- dissect:\n tokenizer: \"/nsm/import/%{import.id}/evtx/%{import.file}\"\n field: \"log.file.path\"\n target_prefix: \"\"\n- decode_json_fields:\n fields: [\"message\"]\n target: \"\"\n- drop_fields:\n fields: [\"host\"]\n ignore_missing: true\n- add_fields:\n target: data_stream\n fields:\n type: logs\n dataset: system.security\n- add_fields:\n target: event\n fields:\n dataset: system.security\n module: system\n imported: true\n- add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.security-1.67.0\n- if:\n equals:\n winlog.channel: 'Microsoft-Windows-Sysmon/Operational'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: windows.sysmon_operational\n - add_fields:\n target: event\n fields:\n dataset: windows.sysmon_operational\n module: windows\n imported: true\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-windows.sysmon_operational-2.5.0\n- if:\n equals:\n winlog.channel: 'Application'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: system.application\n - add_fields:\n target: event\n fields:\n dataset: system.application\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.application-1.67.0\n- if:\n equals:\n winlog.channel: 'System'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: system.system\n - add_fields:\n target: event\n fields:\n dataset: system.system\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.system-1.67.0\n \n- if:\n equals:\n winlog.channel: 'Microsoft-Windows-PowerShell/Operational'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: windows.powershell_operational\n - add_fields:\n target: event\n fields:\n dataset: windows.powershell_operational\n module: windows\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-windows.powershell_operational-2.5.0\n- add_fields:\n target: data_stream\n fields:\n dataset: import", + "processors": "- dissect:\n tokenizer: \"/nsm/import/%{import.id}/evtx/%{import.file}\"\n field: \"log.file.path\"\n target_prefix: \"\"\n- decode_json_fields:\n fields: [\"message\"]\n target: \"\"\n- drop_fields:\n fields: [\"host\"]\n ignore_missing: true\n- add_fields:\n target: data_stream\n fields:\n type: logs\n dataset: system.security\n- add_fields:\n target: event\n fields:\n dataset: system.security\n module: system\n imported: true\n- add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.security-2.3.1\n- if:\n equals:\n winlog.channel: 'Microsoft-Windows-Sysmon/Operational'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: windows.sysmon_operational\n - add_fields:\n target: event\n fields:\n dataset: windows.sysmon_operational\n module: windows\n imported: true\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-windows.sysmon_operational-3.0.0\n- if:\n equals:\n winlog.channel: 'Application'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: system.application\n - add_fields:\n target: event\n fields:\n dataset: system.application\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.application-2.3.1\n- if:\n equals:\n winlog.channel: 'System'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: system.system\n - add_fields:\n target: event\n fields:\n dataset: system.system\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.system-2.3.1\n \n- if:\n equals:\n winlog.channel: 'Microsoft-Windows-PowerShell/Operational'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: windows.powershell_operational\n - add_fields:\n target: event\n fields:\n dataset: windows.powershell_operational\n module: windows\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-windows.powershell_operational-3.0.0\n- add_fields:\n target: data_stream\n fields:\n dataset: import", "tags": [ "import" ] diff --git a/salt/elasticsearch/files/ingest/logs-pfsense.log-1.21.0 b/salt/elasticsearch/files/ingest/logs-pfsense.log-1.23.0 similarity index 93% rename from salt/elasticsearch/files/ingest/logs-pfsense.log-1.21.0 rename to salt/elasticsearch/files/ingest/logs-pfsense.log-1.23.0 index 7c4f2575f..e79b91b26 100644 --- a/salt/elasticsearch/files/ingest/logs-pfsense.log-1.21.0 +++ b/salt/elasticsearch/files/ingest/logs-pfsense.log-1.23.0 @@ -107,61 +107,61 @@ }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-firewall", + "name": "logs-pfsense.log-1.23.0-firewall", "if": "ctx.event.provider == 'filterlog'" } }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-openvpn", + "name": "logs-pfsense.log-1.23.0-openvpn", "if": "ctx.event.provider == 'openvpn'" } }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-ipsec", + "name": "logs-pfsense.log-1.23.0-ipsec", "if": "ctx.event.provider == 'charon'" } }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-dhcp", + "name": "logs-pfsense.log-1.23.0-dhcp", "if": "[\"dhcpd\", \"dhclient\", \"dhcp6c\"].contains(ctx.event.provider)" } }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-unbound", + "name": "logs-pfsense.log-1.23.0-unbound", "if": "ctx.event.provider == 'unbound'" } }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-haproxy", + "name": "logs-pfsense.log-1.23.0-haproxy", "if": "ctx.event.provider == 'haproxy'" } }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-php-fpm", + "name": "logs-pfsense.log-1.23.0-php-fpm", "if": "ctx.event.provider == 'php-fpm'" } }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-squid", + "name": "logs-pfsense.log-1.23.0-squid", "if": "ctx.event.provider == 'squid'" } }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-snort", + "name": "logs-pfsense.log-1.23.0-snort", "if": "ctx.event.provider == 'snort'" } }, { "pipeline": { - "name": "logs-pfsense.log-1.21.0-suricata", + "name": "logs-pfsense.log-1.23.0-suricata", "if": "ctx.event.provider == 'suricata'" } }, @@ -358,14 +358,6 @@ "source": "void handleMap(Map map) {\n for (def x : map.values()) {\n if (x instanceof Map) {\n handleMap(x);\n } else if (x instanceof List) {\n handleList(x);\n }\n }\n map.values().removeIf(v -> v == null || (v instanceof String && v == \"-\"));\n}\nvoid handleList(List list) {\n for (def x : list) {\n if (x instanceof Map) {\n handleMap(x);\n } else if (x instanceof List) {\n handleList(x);\n }\n }\n}\nhandleMap(ctx);\n" } }, - { - "remove": { - "field": "event.original", - "if": "ctx.tags == null || !(ctx.tags.contains('preserve_original_event'))", - "ignore_failure": true, - "ignore_missing": true - } - }, { "pipeline": { "name": "global@custom", diff --git a/salt/elasticsearch/files/ingest/logs-pfsense.log-1.21.0-suricata b/salt/elasticsearch/files/ingest/logs-pfsense.log-1.23.0-suricata similarity index 100% rename from salt/elasticsearch/files/ingest/logs-pfsense.log-1.21.0-suricata rename to salt/elasticsearch/files/ingest/logs-pfsense.log-1.23.0-suricata From 59628ec8b76f0f713fc8eb55ff407edce9b413fd Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 8 Jul 2025 16:15:18 -0500 Subject: [PATCH 235/303] revert foxtrot change --- VERSION | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VERSION b/VERSION index 452820224..c3344819a 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -2.4.0-foxtrot \ No newline at end of file +2.4.170 \ No newline at end of file From 47bbc9987e509d20d913163b66d91b48034878b3 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 8 Jul 2025 16:39:48 -0500 Subject: [PATCH 236/303] elastic agent upgrade prereq --- salt/manager/tools/sbin/soup | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/salt/manager/tools/sbin/soup b/salt/manager/tools/sbin/soup index f361da688..0c6ebfd26 100755 --- a/salt/manager/tools/sbin/soup +++ b/salt/manager/tools/sbin/soup @@ -802,9 +802,6 @@ up_to_2.4.130() { # Remove any old Elastic Defend config files rm -f /opt/so/conf/elastic-fleet/integrations/endpoints-initial/elastic-defend-endpoints.json - # Elastic Update for this release, so download Elastic Agent files - determine_elastic_agent_upgrade - # Ensure override exists to allow nmcli access to other devices touch /etc/NetworkManager/conf.d/10-globally-managed-devices.conf @@ -847,6 +844,9 @@ up_to_2.4.170() { touch /opt/so/saltstack/local/pillar/$state/adv_$state.sls /opt/so/saltstack/local/pillar/$state/soc_$state.sls done + # Elastic Update for this release, so download Elastic Agent files + determine_elastic_agent_upgrade + INSTALLEDVERSION=2.4.170 } From 76ab0eac03ce8e2fc1f726e5e561c1425edf89bd Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 8 Jul 2025 16:45:27 -0500 Subject: [PATCH 237/303] foxtrot Signed-off-by: reyesj2 <94730068+reyesj2@users.noreply.github.com> --- VERSION | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VERSION b/VERSION index c3344819a..7d52aac7f 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -2.4.170 \ No newline at end of file +2.4.0-foxtrot From b9d813cef2b67325e7aa253e66b06da33a111191 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 8 Jul 2025 18:26:46 -0500 Subject: [PATCH 238/303] typo --- .../tools/sbin_jinja/so-elasticsearch-templates-load | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/elasticsearch/tools/sbin_jinja/so-elasticsearch-templates-load b/salt/elasticsearch/tools/sbin_jinja/so-elasticsearch-templates-load index ba5767255..4ac1b4d5f 100755 --- a/salt/elasticsearch/tools/sbin_jinja/so-elasticsearch-templates-load +++ b/salt/elasticsearch/tools/sbin_jinja/so-elasticsearch-templates-load @@ -136,7 +136,7 @@ if [ ! -f $STATE_FILE_SUCCESS ]; then TEMPLATE=${i::-14} COMPONENT_PATTERN=${TEMPLATE:3} MATCH=$(echo "$TEMPLATE" | grep -E "^so-logs-|^so-metrics" | grep -vE "detections|osquery") - if [[ -n "$MATCH" && ! "$COMPONENT_LIST" =~ "$COMPONENT_PATTERN" && ! "$COMPONENT_PATTERN" =~ *\.generic|logs-winlog\.winlog ]]; then + if [[ -n "$MATCH" && ! "$COMPONENT_LIST" =~ "$COMPONENT_PATTERN" && ! "$COMPONENT_PATTERN" =~ \.generic|logs-winlog\.winlog ]]; then load_failures=$((load_failures+1)) echo "Component template does not exist for $COMPONENT_PATTERN. The index template will not be loaded. Load failures: $load_failures" else From 07a22a0b4b22ad8f1eaee2d0647c0c12a4a9184c Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 8 Jul 2025 18:32:14 -0500 Subject: [PATCH 239/303] version --- VERSION | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VERSION b/VERSION index 7d52aac7f..c3344819a 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -2.4.0-foxtrot +2.4.170 \ No newline at end of file From f1cbe23f575ab80c7952212b63269c82291e9662 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 8 Jul 2025 21:17:57 -0500 Subject: [PATCH 240/303] update default kibana space --- salt/kibana/tools/sbin_jinja/so-kibana-space-defaults | 2 +- salt/manager/tools/sbin/soup | 6 ++++++ 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/salt/kibana/tools/sbin_jinja/so-kibana-space-defaults b/salt/kibana/tools/sbin_jinja/so-kibana-space-defaults index a22aba066..cbd16a2de 100755 --- a/salt/kibana/tools/sbin_jinja/so-kibana-space-defaults +++ b/salt/kibana/tools/sbin_jinja/so-kibana-space-defaults @@ -13,6 +13,6 @@ echo "Setting up default Space:" {% if HIGHLANDER %} curl -K /opt/so/conf/elasticsearch/curl.config -b "sid=$SESSIONCOOKIE" -L -X PUT "localhost:5601/api/spaces/space/default" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d' {"id":"default","name":"Default","disabledFeatures":["enterpriseSearch"]} ' >> /opt/so/log/kibana/misc.log {% else %} -curl -K /opt/so/conf/elasticsearch/curl.config -b "sid=$SESSIONCOOKIE" -L -X PUT "localhost:5601/api/spaces/space/default" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d' {"id":"default","name":"Default","disabledFeatures":["ml","enterpriseSearch","logs","infrastructure","apm","uptime","monitoring","stackAlerts","actions","securitySolutionCasesV2","inventory","dataQuality","actions"]} ' >> /opt/so/log/kibana/misc.log +curl -K /opt/so/conf/elasticsearch/curl.config -b "sid=$SESSIONCOOKIE" -L -X PUT "localhost:5601/api/spaces/space/default" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d' {"id":"default","name":"Default","disabledFeatures":["ml","enterpriseSearch","logs","infrastructure","apm","uptime","monitoring","stackAlerts","actions","securitySolutionCasesV3","inventory","dataQuality","searchSynonyms","enterpriseSearchApplications","enterpriseSearchAnalytics","securitySolutionTimeline","securitySolutionNotes","entityManager"]} ' >> /opt/so/log/kibana/misc.log {% endif %} echo diff --git a/salt/manager/tools/sbin/soup b/salt/manager/tools/sbin/soup index 0c6ebfd26..e37ccbfda 100755 --- a/salt/manager/tools/sbin/soup +++ b/salt/manager/tools/sbin/soup @@ -590,6 +590,12 @@ post_to_2.4.160() { post_to_2.4.170() { echo "Regenerating Elastic Agent Installers" /sbin/so-elastic-agent-gen-installers + + # Update kibana default space + salt-call state.apply kibana.config queue=True + echo "Updating Kibana default space" + /usr/sbin/so-kibana-space-defaults + POSTVERSION=2.4.170 } From 3fb703cd22797e8a641627de65377540821ba258 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 9 Jul 2025 11:59:25 -0500 Subject: [PATCH 241/303] check if generic template exists in installed component templates before defaulting to logs-filestream.generic@package --- salt/elasticfleet/integration-defaults.map.jinja | 5 +++-- .../sbin_jinja/so-elastic-fleet-optional-integrations-load | 2 +- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/salt/elasticfleet/integration-defaults.map.jinja b/salt/elasticfleet/integration-defaults.map.jinja index 62e37b229..d385c15aa 100644 --- a/salt/elasticfleet/integration-defaults.map.jinja +++ b/salt/elasticfleet/integration-defaults.map.jinja @@ -4,7 +4,7 @@ {% import_json '/opt/so/state/esfleet_package_components.json' as ADDON_PACKAGE_COMPONENTS %} -{% import_json '/opt/so/state/esfleet_package_components.json' as INSTALLED_COMPONENT_TEMPLATES %} +{% import_json '/opt/so/state/esfleet_component_templates.json' as INSTALLED_COMPONENT_TEMPLATES %} {% import_yaml 'elasticfleet/defaults.yaml' as ELASTICFLEETDEFAULTS %} {% set CORE_ESFLEET_PACKAGES = ELASTICFLEETDEFAULTS.get('elasticfleet', {}).get('packages', {}) %} @@ -83,7 +83,8 @@ {# pillar overrides/merge expects the key names to follow the naming in elasticsearch/defaults.yaml eg. so-logs-1password_x_item_usages . The _x_ is replaced later on in elasticsearch/template.map.jinja #} {% set integration_key = "so-" ~ integration_type ~ component_name_x %} -{% if ".generic" in component_name and component_name not in INSTALLED_COMPONENT_TEMPLATES %} +{# if its a .generic template make sure that a .generic@package for the integration exists. Else default to logs-filestream.generic@package #} +{% if ".generic" in component_name and integration_type ~ component_name ~ "@package" not in INSTALLED_COMPONENT_TEMPLATES %} {# these generic templates by default are directed to index_pattern of 'logs-generic-*', overwrite that here to point to eg gcp_pubsub.generic-* #} {% set index_pattern = integration_type ~ component_name ~ "-*" %} {# includes use of .generic component template, but it doesn't exist in installed component templates. Redirect it to filestream.generic@package #} diff --git a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load index df01608f5..e877a9e37 100644 --- a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load +++ b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load @@ -19,7 +19,7 @@ BULK_INSTALL_PACKAGE_LIST=/tmp/esfleet_bulk_install.json BULK_INSTALL_PACKAGE_TMP=/tmp/esfleet_bulk_install_tmp.json BULK_INSTALL_OUTPUT=/opt/so/state/esfleet_bulk_install_results.json PACKAGE_COMPONENTS=/opt/so/state/esfleet_package_components.json -COMPONENT_TEMPLATES=/opt/so/state/esfleet_component_templates.txt +COMPONENT_TEMPLATES=/opt/so/state/esfleet_component_templates.json PENDING_UPDATE=false From a03764d95678625a29b682e21b20ef43da1eeadb Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 9 Jul 2025 12:34:53 -0500 Subject: [PATCH 242/303] additional weird integration --- salt/elasticfleet/integration-defaults.map.jinja | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/salt/elasticfleet/integration-defaults.map.jinja b/salt/elasticfleet/integration-defaults.map.jinja index d385c15aa..182dc95a3 100644 --- a/salt/elasticfleet/integration-defaults.map.jinja +++ b/salt/elasticfleet/integration-defaults.map.jinja @@ -46,7 +46,10 @@ 'synthetics.browser_screenshot': 'synthetics-browser.screenshot', 'synthetics.http': 'synthetics-http', 'synthetics.icmp': 'synthetics-icmp', - 'synthetics.tcp': 'synthetics-tcp' + 'synthetics.tcp': 'synthetics-tcp', + 'swimlane.swimlane_api': 'swimlane.api', + 'swimlane.tenant_api': 'swimlane.tenant', + 'swimlane.turbine_api': 'turbine.api' } %} {% for pkg in ADDON_PACKAGE_COMPONENTS %} From 33e2d18aa7094272b59a50b1af9d1729381b1279 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 9 Jul 2025 13:59:01 -0500 Subject: [PATCH 243/303] endpoint policy update --- .../elastic-defend-endpoints.json | 64 ++++++++++--------- 1 file changed, 33 insertions(+), 31 deletions(-) diff --git a/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json b/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json index 87870c7bc..ee55551e3 100644 --- a/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json +++ b/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json @@ -1,32 +1,34 @@ { - "name": "elastic-defend-endpoints", - "namespace": "default", - "description": "", - "package": { - "name": "endpoint", - "title": "Elastic Defend", - "version": "8.17.0", - "requires_root": true - }, - "enabled": true, - "policy_id": "endpoints-initial", - "vars": {}, - "inputs": [ - { - "type": "endpoint", - "enabled": true, - "config": { - "integration_config": { - "value": { - "type": "endpoint", - "endpointConfig": { - "preset": "DataCollection" - } - } - } - }, - "streams": [] - } - ] - } - \ No newline at end of file + "name": "elastic-defend-endpoints", + "namespace": "default", + "description": "", + "package": { + "name": "endpoint", + "title": "Elastic Defend", + "version": "8.18.1", + "requires_root": true + }, + "enabled": true, + "policy_ids": [ + "endpoints-initial" + ], + "vars": {}, + "inputs": [ + { + "type": "ENDPOINT_INTEGRATION_CONFIG", + "enabled": true, + "config": { + "_config": { + "value": { + "type": "endpoint", + "endpointConfig": { + "preset": "DataCollection" + } + } + } + }, + "streams": [] + } + ], + "force": false +} \ No newline at end of file From fa6f4100dd350b10cdb98314d48343d46e50990c Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 9 Jul 2025 14:48:15 -0500 Subject: [PATCH 244/303] ensure elasticsearch is up --- .../so-elastic-fleet-optional-integrations-load | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load index e877a9e37..8a2c388b1 100644 --- a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load +++ b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load @@ -156,9 +156,11 @@ if [[ -f $STATE_FILE_SUCCESS ]]; then # Write out file for generating index/component/ilm templates latest_installed_package_list=$(elastic_fleet_installed_packages) echo $latest_installed_package_list | jq '[.items[] | {name: .name, es_index_patterns: .dataStreams}]' > $PACKAGE_COMPONENTS - # Refresh installed component template list - latest_component_templates_list=$(so-elasticsearch-query _component_template | jq '.component_templates[] | .name' | jq -s '.') - echo $latest_component_templates_list > $COMPONENT_TEMPLATES + if retry 3 1 "so-elasticsearch-query / --fail --output /dev/null"; then + # Refresh installed component template list + latest_component_templates_list=$(so-elasticsearch-query _component_template | jq '.component_templates[] | .name' | jq -s '.') + echo $latest_component_templates_list > $COMPONENT_TEMPLATES + fi else # This is the installation of add-on integrations and upgrade of existing integrations. Exiting without error, next highstate will attempt to re-run. From 3b2942651e9890726d1a040086b69d519790a736 Mon Sep 17 00:00:00 2001 From: Jorge Reyes <94730068+reyesj2@users.noreply.github.com> Date: Wed, 9 Jul 2025 15:14:24 -0500 Subject: [PATCH 245/303] Update salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json --- .../integrations/elastic-defend/elastic-defend-endpoints.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json b/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json index ee55551e3..27162669d 100644 --- a/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json +++ b/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json @@ -30,5 +30,5 @@ "streams": [] } ], - "force": false +} } \ No newline at end of file From d846fe55e14d93666dfd7e13ff1411863d2b1abb Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 9 Jul 2025 15:40:36 -0500 Subject: [PATCH 246/303] typos --- .../integrations/elastic-defend/elastic-defend-endpoints.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json b/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json index 27162669d..fb9069e83 100644 --- a/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json +++ b/salt/elasticfleet/files/integrations/elastic-defend/elastic-defend-endpoints.json @@ -29,6 +29,5 @@ }, "streams": [] } - ], -} + ] } \ No newline at end of file From 317d7dea7d7c5561a42662cbb546cd4c7424c6f9 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 9 Jul 2025 17:25:36 -0500 Subject: [PATCH 247/303] check required files exist before loading map file Signed-off-by: reyesj2 <94730068+reyesj2@users.noreply.github.com> --- salt/elasticsearch/template.map.jinja | 2 +- salt/manager/managed_soc_annotations.sls | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/salt/elasticsearch/template.map.jinja b/salt/elasticsearch/template.map.jinja index aa90cb81b..414d8a6b4 100644 --- a/salt/elasticsearch/template.map.jinja +++ b/salt/elasticsearch/template.map.jinja @@ -15,7 +15,7 @@ {% set ES_INDEX_SETTINGS_ORIG = ELASTICSEARCHDEFAULTS.elasticsearch.index_settings %} {# start generation of integration default index_settings #} -{% if salt['file.file_exists']('/opt/so/state/esfleet_package_components.json') %} +{% if salt['file.file_exists']('/opt/so/state/esfleet_package_components.json') and salt['file.file_exists']('/opt/so/state/esfleet_component_templates.json') %} {% set check_package_components = salt['file.stats']('/opt/so/state/esfleet_package_components.json') %} {% if check_package_components.size > 1 %} {% from 'elasticfleet/integration-defaults.map.jinja' import ADDON_INTEGRATION_DEFAULTS %} diff --git a/salt/manager/managed_soc_annotations.sls b/salt/manager/managed_soc_annotations.sls index 9ef0b1ea1..d8f175df6 100644 --- a/salt/manager/managed_soc_annotations.sls +++ b/salt/manager/managed_soc_annotations.sls @@ -5,7 +5,7 @@ {# Managed elasticsearch/soc_elasticsearch.yaml file for adding integration configuration items to UI #} {% set managed_integrations = salt['pillar.get']('elasticsearch:managed_integrations', []) %} -{% if managed_integrations and salt['file.file_exists']('/opt/so/state/esfleet_package_components.json') %} +{% if managed_integrations and salt['file.file_exists']('/opt/so/state/esfleet_package_components.json') and salt['file.file_exists']('/opt/so/state/esfleet_component_templates.json') %} {% from 'elasticfleet/integration-defaults.map.jinja' import ADDON_INTEGRATION_DEFAULTS %} {% set addon_integration_keys = ADDON_INTEGRATION_DEFAULTS.keys() %} {% set matched_integration_names = [] %} From bf8da6060555c57de61b616493f4b8d305c53b53 Mon Sep 17 00:00:00 2001 From: Jason Ertel Date: Thu, 10 Jul 2025 07:47:53 -0400 Subject: [PATCH 248/303] exclude component updates indexes with error in the name --- salt/common/tools/sbin/so-log-check | 1 + 1 file changed, 1 insertion(+) diff --git a/salt/common/tools/sbin/so-log-check b/salt/common/tools/sbin/so-log-check index 96881aa56..c84fc7803 100755 --- a/salt/common/tools/sbin/so-log-check +++ b/salt/common/tools/sbin/so-log-check @@ -158,6 +158,7 @@ if [[ $EXCLUDE_FALSE_POSITIVE_ERRORS == 'Y' ]]; then EXCLUDED_ERRORS="$EXCLUDED_ERRORS|adding index lifecycle policy" # false positive (elasticsearch policy names contain 'error') EXCLUDED_ERRORS="$EXCLUDED_ERRORS|adding ingest pipeline" # false positive (elasticsearch ingest pipeline names contain 'error') EXCLUDED_ERRORS="$EXCLUDED_ERRORS|updating index template" # false positive (elasticsearch index or template names contain 'error') + EXCLUDED_ERRORS="$EXCLUDED_ERRORS|updating component template" # false positive (elasticsearch index or template names contain 'error') fi if [[ $EXCLUDE_KNOWN_ERRORS == 'Y' ]]; then From 95ba327eb3e9eab2b031cf80c49658cedb0b5b79 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Thu, 10 Jul 2025 11:08:46 -0500 Subject: [PATCH 249/303] cribl metrics template rename --- salt/elasticfleet/integration-defaults.map.jinja | 1 + 1 file changed, 1 insertion(+) diff --git a/salt/elasticfleet/integration-defaults.map.jinja b/salt/elasticfleet/integration-defaults.map.jinja index 182dc95a3..500a9e63c 100644 --- a/salt/elasticfleet/integration-defaults.map.jinja +++ b/salt/elasticfleet/integration-defaults.map.jinja @@ -15,6 +15,7 @@ 'awsfirehose.logs': 'awsfirehose', 'awsfirehose.metrics': 'aws.cloudwatch', 'cribl.logs': 'cribl', + 'cribl.metrics': 'cribl', 'sentinel_one_cloud_funnel.logins': 'sentinel_one_cloud_funnel.login', 'azure_application_insights.app_insights': 'azure.app_insights', 'azure_application_insights.app_state': 'azure.app_state', From a4e8e7ea535251d9aeb826a5fd97c9ef18fe977e Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Thu, 10 Jul 2025 13:12:26 -0500 Subject: [PATCH 250/303] update syslog-tcp-514 policy --- .../integrations/grid-nodes_general/syslog-tcp-514.json | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/salt/elasticfleet/files/integrations/grid-nodes_general/syslog-tcp-514.json b/salt/elasticfleet/files/integrations/grid-nodes_general/syslog-tcp-514.json index 4088f5a87..f284ede06 100644 --- a/salt/elasticfleet/files/integrations/grid-nodes_general/syslog-tcp-514.json +++ b/salt/elasticfleet/files/integrations/grid-nodes_general/syslog-tcp-514.json @@ -11,7 +11,7 @@ "tcp-tcp": { "enabled": true, "streams": { - "tcp.generic": { + "tcp.tcp": { "enabled": true, "vars": { "listen_address": "0.0.0.0", @@ -23,7 +23,8 @@ "syslog" ], "syslog_options": "field: message\n#format: auto\n#timezone: Local", - "ssl": "" + "ssl": "", + "custom": "" } } } From 8a57b79b779f60fa04b22cdd8226bbd1f1eb07c7 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Thu, 10 Jul 2025 15:52:59 -0500 Subject: [PATCH 251/303] make package installs go in groups of 25 or less --- ...so-elastic-fleet-optional-integrations-load | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load index 8a2c388b1..886bbf75c 100644 --- a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load +++ b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-optional-integrations-load @@ -148,8 +148,22 @@ if [[ -f $STATE_FILE_SUCCESS ]]; then done <<< "$(jq -c '.packages[]' "$INSTALLED_PACKAGE_LIST")" if [ "$PENDING_UPDATE" = true ]; then - # Run bulk install of packages - elastic_fleet_bulk_package_install $BULK_INSTALL_PACKAGE_LIST > $BULK_INSTALL_OUTPUT + # Run chunked install of packages + echo "" > $BULK_INSTALL_OUTPUT + pkg_group=1 + pkg_filename="${BULK_INSTALL_PACKAGE_LIST%.json}" + + jq -c '.packages | _nwise(25)' $BULK_INSTALL_PACKAGE_LIST | while read -r line; do + echo "$line" | jq '{ "packages": . }' > "${pkg_filename}_${pkg_group}.json" + pkg_group=$((pkg_group + 1)) + done + + for file in "${pkg_filename}_"*.json; do + [ -e "$file" ] || continue + elastic_fleet_bulk_package_install $file >> $BULK_INSTALL_OUTPUT + done + # cleanup any temp files for chunked package install + rm -f ${pkg_filename}_*.json $BULK_INSTALL_PACKAGE_LIST else echo "Elastic integrations don't appear to need installation/updating..." fi From 10e3b32fedd1bdb3cf87b82b329692aa2021c4d3 Mon Sep 17 00:00:00 2001 From: Jason Ertel Date: Fri, 11 Jul 2025 11:29:16 -0400 Subject: [PATCH 252/303] fix typo --- salt/soc/soc_soc.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/salt/soc/soc_soc.yaml b/salt/soc/soc_soc.yaml index 58560e89e..00342b4b8 100644 --- a/salt/soc/soc_soc.yaml +++ b/salt/soc/soc_soc.yaml @@ -589,6 +589,10 @@ soc: global: True advanced: True forcedType: "[]{}" + exportNodeId: + description: The node ID on which export jobs will be executed. + global: True + advanced: True hunt: &appSettings groupItemsPerPage: description: Default number of aggregations to show per page. Larger values consume more vertical area in the SOC UI. @@ -712,7 +716,7 @@ soc: global: True status: labels: - description: List of available case statuses. Some statuses have specifial characteristics and related functionality built into SOC. + description: List of available case statuses. Note that some default statuses have special characteristics and related functionality built into SOC. global: True customEnabled: description: Set to true to allow users add their own case statuses directly in the SOC UI. From 9b125fbe531dbbf76bffb68883da934cf4ef2508 Mon Sep 17 00:00:00 2001 From: Jason Ertel Date: Fri, 11 Jul 2025 11:30:01 -0400 Subject: [PATCH 253/303] fix typo --- salt/soc/soc_soc.yaml | 4 ---- 1 file changed, 4 deletions(-) diff --git a/salt/soc/soc_soc.yaml b/salt/soc/soc_soc.yaml index 00342b4b8..da3549039 100644 --- a/salt/soc/soc_soc.yaml +++ b/salt/soc/soc_soc.yaml @@ -589,10 +589,6 @@ soc: global: True advanced: True forcedType: "[]{}" - exportNodeId: - description: The node ID on which export jobs will be executed. - global: True - advanced: True hunt: &appSettings groupItemsPerPage: description: Default number of aggregations to show per page. Larger values consume more vertical area in the SOC UI. From 415f456661fd24b846c68159000c882993d4c9de Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Sat, 12 Jul 2025 08:30:04 -0500 Subject: [PATCH 254/303] ignore composable templates with error in the name --- salt/common/tools/sbin/so-log-check | 1 + 1 file changed, 1 insertion(+) diff --git a/salt/common/tools/sbin/so-log-check b/salt/common/tools/sbin/so-log-check index c84fc7803..72ece1919 100755 --- a/salt/common/tools/sbin/so-log-check +++ b/salt/common/tools/sbin/so-log-check @@ -159,6 +159,7 @@ if [[ $EXCLUDE_FALSE_POSITIVE_ERRORS == 'Y' ]]; then EXCLUDED_ERRORS="$EXCLUDED_ERRORS|adding ingest pipeline" # false positive (elasticsearch ingest pipeline names contain 'error') EXCLUDED_ERRORS="$EXCLUDED_ERRORS|updating index template" # false positive (elasticsearch index or template names contain 'error') EXCLUDED_ERRORS="$EXCLUDED_ERRORS|updating component template" # false positive (elasticsearch index or template names contain 'error') + EXCLUDED_ERRORS="$EXCLUDED_ERRORS|upgrading composable template" # false positive (elasticsearch composable template names contain 'error') fi if [[ $EXCLUDE_KNOWN_ERRORS == 'Y' ]]; then From f8108e93d5a9a99c16c471d9132d1a225a9f4f2c Mon Sep 17 00:00:00 2001 From: Doug Burks Date: Mon, 14 Jul 2025 12:04:46 -0400 Subject: [PATCH 255/303] FEATURE: Add SOC default fields for iptables logs #14836 --- salt/soc/defaults.yaml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/salt/soc/defaults.yaml b/salt/soc/defaults.yaml index cb12671f8..35eb22ab0 100644 --- a/salt/soc/defaults.yaml +++ b/salt/soc/defaults.yaml @@ -1336,6 +1336,13 @@ soc: - soc.fields.statusCode - event.action - soc.fields.error + ':iptables:': + - soc_timestamp + - source.ip + - source.port + - destination.ip + - destination.port + - message server: bindAddress: 0.0.0.0:9822 baseUrl: / From 10bf3e8fab0681d0f9f2f11fa7a23666f7fc5fe9 Mon Sep 17 00:00:00 2001 From: Doug Burks Date: Mon, 14 Jul 2025 12:07:02 -0400 Subject: [PATCH 256/303] FEATURE: Add SOC default fields for CEF logs #14837 --- salt/soc/defaults.yaml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/salt/soc/defaults.yaml b/salt/soc/defaults.yaml index 35eb22ab0..e84a5b017 100644 --- a/salt/soc/defaults.yaml +++ b/salt/soc/defaults.yaml @@ -1343,6 +1343,14 @@ soc: - destination.ip - destination.port - message + ':cef:': + - soc_timestamp + - cef.device.event_class_id + - cef.device.vendor + - cef.device.product + - cef.device.version + - log.source.address + - message server: bindAddress: 0.0.0.0:9822 baseUrl: / From ab9d03bc2e7cd4b38f08e596ab14e4ad205007d2 Mon Sep 17 00:00:00 2001 From: Doug Burks Date: Mon, 14 Jul 2025 12:21:08 -0400 Subject: [PATCH 257/303] FEATURE: Add SOC Dashboards for UniFi logs #14838 --- salt/soc/defaults.yaml | 30 +++++++++++++++++++++--------- 1 file changed, 21 insertions(+), 9 deletions(-) diff --git a/salt/soc/defaults.yaml b/salt/soc/defaults.yaml index e84a5b017..23c966bb4 100644 --- a/salt/soc/defaults.yaml +++ b/salt/soc/defaults.yaml @@ -2142,15 +2142,6 @@ soc: - name: ICS S7 description: S7 (Siemens) network metadata query: 'tags:s7* | groupby event.dataset | groupby -sankey event.dataset source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port' - - name: NetFlow - description: NetFlow records - query: 'event.module:netflow | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby network.type | groupby network.transport | groupby network.direction | groupby netflow.type | groupby netflow.exporter.version | groupby observer.ip | groupby source.as.organization.name | groupby source.geo.country_name | groupby destination.as.organization.name | groupby destination.geo.country_name' - - name: Firewall - description: Firewall logs - query: 'observer.type:firewall | groupby event.action | groupby -sankey event.action observer.ingress.interface.name | groupby observer.ingress.interface.name | groupby network.type | groupby network.transport | groupby source.ip | groupby destination.ip | groupby destination.port' - - name: Firewall Auth - description: Firewall authentication logs - query: 'observer.type:firewall AND event.category:authentication | groupby user.name | groupby -sankey user.name source.ip | groupby source.ip | table soc_timestamp user.name source.ip message' - name: VLAN description: VLAN (Virtual Local Area Network) tagged logs query: '* AND _exists_:network.vlan.id | groupby network.vlan.id | groupby -sankey network.vlan.id source.ip | groupby source.ip | groupby destination.ip | groupby destination.port | groupby event.dataset | groupby event.module | groupby observer.name | groupby source.geo.country_name | groupby destination.geo.country_name' @@ -2166,6 +2157,27 @@ soc: - name: GeoIP - Source Organizations description: GeoIP tagged logs visualized by source organizations query: '* AND _exists_:source_geo.organization_name | groupby source_geo.organization_name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby source.geo.country_name | groupby event.dataset | groupby event.module' + - name: NetFlow + description: NetFlow records + query: 'event.module:netflow | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby network.type | groupby network.transport | groupby network.direction | groupby netflow.type | groupby netflow.exporter.version | groupby observer.ip | groupby source.as.organization.name | groupby source.geo.country_name | groupby destination.as.organization.name | groupby destination.geo.country_name' + - name: Firewall - pfSense/OPNsense + description: pfSense/OPNsense firewall logs + query: 'observer.type:firewall | groupby event.action | groupby -sankey event.action observer.ingress.interface.name | groupby observer.ingress.interface.name | groupby network.type | groupby network.transport | groupby source.ip | groupby destination.ip | groupby destination.port' + - name: Firewall - pfSense/OPNsense Auth + description: pfSense/OPNsense firewall authentication logs + query: 'observer.type:firewall AND event.category:authentication | groupby user.name | groupby -sankey user.name source.ip | groupby source.ip | table soc_timestamp user.name source.ip message' + - name: Firewall - UniFi Firewall Overview + description: All network traffic logged by UniFi firewall + query: 'event.module:iptables AND event.type:connection | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' + - name: Firewall - UniFi Firewall Blocks + description: Network traffic blocked by UniFi firewall + query: 'event.module:iptables AND event.type:connection AND (message:iptables-dropped OR message:block) | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' + - name: Firewall - UniFi Firewall Allows + description: Network traffic allowed by UniFi firewall + query: 'event.module:iptables AND event.type:connection AND NOT (message:iptables-dropped OR message:block) | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' + - name: Firewall - UniFi Auth + description: UniFi authentication logs + query: 'event.module:cef | groupby cef.device.event_class_id | groupby -sankey cef.device.event_class_id cef.device.vendor | groupby cef.device.vendor | groupby cef.device.product | groupby cef.device.version | groupby log.source.address' - name: Kismet - WiFi Devices description: WiFi devices seen by Kismet sensors query: 'event.module: kismet | groupby network.wireless.ssid | groupby device.manufacturer | groupby -pie device.manufacturer | groupby event.dataset' From 4f8bd16910050c973d2dfc8e65fb1c599516e3fa Mon Sep 17 00:00:00 2001 From: Doug Burks Date: Mon, 14 Jul 2025 15:37:10 -0400 Subject: [PATCH 258/303] FEATURE: Add SOC Dashboards for CEF, iptables, and UniFi logs #14838 --- salt/soc/defaults.yaml | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/salt/soc/defaults.yaml b/salt/soc/defaults.yaml index 23c966bb4..0c5967753 100644 --- a/salt/soc/defaults.yaml +++ b/salt/soc/defaults.yaml @@ -2166,6 +2166,9 @@ soc: - name: Firewall - pfSense/OPNsense Auth description: pfSense/OPNsense firewall authentication logs query: 'observer.type:firewall AND event.category:authentication | groupby user.name | groupby -sankey user.name source.ip | groupby source.ip | table soc_timestamp user.name source.ip message' + - name: Firewall - iptables + description: All network traffic logged by Elastic integration for iptables + query: 'event.module:iptables AND event.type:connection | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' - name: Firewall - UniFi Firewall Overview description: All network traffic logged by UniFi firewall query: 'event.module:iptables AND event.type:connection | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' @@ -2175,8 +2178,11 @@ soc: - name: Firewall - UniFi Firewall Allows description: Network traffic allowed by UniFi firewall query: 'event.module:iptables AND event.type:connection AND NOT (message:iptables-dropped OR message:block) | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' - - name: Firewall - UniFi Auth - description: UniFi authentication logs + - name: Firewall - UniFi System + description: UniFi system logs + query: 'event.module:cef | groupby cef.device.event_class_id | groupby -sankey cef.device.event_class_id cef.device.vendor | groupby cef.device.vendor | groupby cef.device.product | groupby cef.device.version | groupby log.source.address' + - name: CEF + description: Logs handled by the Elastic integration for CEF query: 'event.module:cef | groupby cef.device.event_class_id | groupby -sankey cef.device.event_class_id cef.device.vendor | groupby cef.device.vendor | groupby cef.device.product | groupby cef.device.version | groupby log.source.address' - name: Kismet - WiFi Devices description: WiFi devices seen by Kismet sensors @@ -2184,9 +2190,6 @@ soc: - name: SOC Detections - Runtime Status description: Runtime Status of Detections query: 'event.dataset:soc.detections | groupby soc.detection_type soc.error_type | groupby soc.error_analysis | groupby soc.rule.name | groupby soc.error_message' - - - job: alerts: advanced: false From 81d2c5286727e7ab7033213d7a307aeed1f28ac2 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Mon, 14 Jul 2025 16:08:11 -0500 Subject: [PATCH 259/303] kibana listingLimit --- salt/kibana/files/config_saved_objects.ndjson.jinja | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/kibana/files/config_saved_objects.ndjson.jinja b/salt/kibana/files/config_saved_objects.ndjson.jinja index 4902a1445..b1c2f0fb7 100644 --- a/salt/kibana/files/config_saved_objects.ndjson.jinja +++ b/salt/kibana/files/config_saved_objects.ndjson.jinja @@ -1,3 +1,3 @@ {% import_yaml 'elasticsearch/defaults.yaml' as ELASTICSEARCHDEFAULTS -%} -{"attributes": {"buildNum": 39457,"defaultIndex": "logs-*","defaultRoute": "/app/dashboards#/view/a8411b30-6d03-11ea-b301-3d6c35840645","discover:sampleSize": 100,"theme:darkMode": true,"timepicker:timeDefaults": "{\n \"from\": \"now-24h\",\n \"to\": \"now\"\n}"},"coreMigrationVersion": "{{ ELASTICSEARCHDEFAULTS.elasticsearch.version }}","id": "{{ ELASTICSEARCHDEFAULTS.elasticsearch.version }}","references": [],"type": "config","updated_at": "2021-10-10T10:10:10.105Z","version": "WzI5NzUsMl0="} +{"attributes": {"buildNum": 39457,"defaultIndex": "logs-*","defaultRoute": "/app/dashboards#/view/a8411b30-6d03-11ea-b301-3d6c35840645","discover:sampleSize": 100,"savedObjects:listingLimit":1500,"theme:darkMode": true,"timepicker:timeDefaults": "{\n \"from\": \"now-24h\",\n \"to\": \"now\"\n}"},"coreMigrationVersion": "{{ ELASTICSEARCHDEFAULTS.elasticsearch.version }}","id": "{{ ELASTICSEARCHDEFAULTS.elasticsearch.version }}","references": [],"type": "config","version": "WzI5NzUsMl0="} From 6bb6c24641d26f96585050df531f0dc8bdcf9d3a Mon Sep 17 00:00:00 2001 From: Doug Burks Date: Wed, 16 Jul 2025 07:20:39 -0400 Subject: [PATCH 260/303] Simplify UniFi dashboards #14838 --- salt/soc/defaults.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/salt/soc/defaults.yaml b/salt/soc/defaults.yaml index 0c5967753..ad7d51f68 100644 --- a/salt/soc/defaults.yaml +++ b/salt/soc/defaults.yaml @@ -2174,10 +2174,10 @@ soc: query: 'event.module:iptables AND event.type:connection | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' - name: Firewall - UniFi Firewall Blocks description: Network traffic blocked by UniFi firewall - query: 'event.module:iptables AND event.type:connection AND (message:iptables-dropped OR message:block) | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' + query: 'event.module:iptables AND event.type:connection AND message:block | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' - name: Firewall - UniFi Firewall Allows description: Network traffic allowed by UniFi firewall - query: 'event.module:iptables AND event.type:connection AND NOT (message:iptables-dropped OR message:block) | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' + query: 'event.module:iptables AND event.type:connection AND NOT message:block | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby -sankey destination.ip destination.port | groupby destination.port' - name: Firewall - UniFi System description: UniFi system logs query: 'event.module:cef | groupby cef.device.event_class_id | groupby -sankey cef.device.event_class_id cef.device.vendor | groupby cef.device.vendor | groupby cef.device.product | groupby cef.device.version | groupby log.source.address' From 98a67530f5d01f3b665bbccf48fc4565fb2397ef Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 16 Jul 2025 12:14:25 -0400 Subject: [PATCH 261/303] update qcow2 hosted location --- salt/_runners/setup_hypervisor.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 6ddd571c9..9d7116d59 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -165,7 +165,7 @@ def _validate_image_checksum(path, expected_sha256): return True # Constants -IMAGE_URL = "https://yum.oracle.com/templates/OracleLinux/OL9/u5/x86_64/OL9U5_x86_64-kvm-b253.qcow2" +IMAGE_URL = "https://download.securityonion.net/file/securityonion/OL9U5_x86_64-kvm-b253.qcow2" IMAGE_SHA256 = "3b00bbbefc8e78dd28d9f538834fb9e2a03d5ccdc2cadf2ffd0036c0a8f02021" IMAGE_PATH = "/nsm/libvirt/boot/OL9U5_x86_64-kvm-b253.qcow2" MANAGER_HOSTNAME = socket.gethostname() From cd5de5cd0516799d310569c70cda3d348cb52aea Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 16 Jul 2025 12:14:54 -0400 Subject: [PATCH 262/303] add sos hw models --- salt/hypervisor/defaults.yaml | 122 +++++++++++++++++++++++++--------- 1 file changed, 92 insertions(+), 30 deletions(-) diff --git a/salt/hypervisor/defaults.yaml b/salt/hypervisor/defaults.yaml index 06509828c..8cf754193 100644 --- a/salt/hypervisor/defaults.yaml +++ b/salt/hypervisor/defaults.yaml @@ -17,42 +17,104 @@ hypervisor: 6: pci_0000_02_00_1 7: pci_0000_41_00_0 8: pci_0000_41_00_1 - model1: + SOSSNNV: hardware: cpu: 128 - memory: 128 + memory: 256 disk: - 1: pci_0000_c7_00_0 - 2: pci_0000_c8_00_0 + 1: pci_0000_42_00_0 + 2: pci_0000_43_00_0 + 3: pci_0000_44_00_0 + 4: pci_0000_45_00_0 copper: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 + sfp: + 1: pci_0000_02_00_0 + 2: pci_0000_02_00_1 + 3: pci_0000_41_00_0 + 4: pci_0000_41_00_1 + SOSSNNV-DE02: + cpu: 128 + memory: 384 + disk: + 1: pci_0000_41_00_0 + 2: pci_0000_42_00_0 + 3: pci_0000_81_00_0 + 4: pci_0000_82_00_0 + 5: pci_0000_83_00_0 + 6: pci_0000_84_00_0 + copper: + 1: pci_0000_85_00_0 + 2: pci_0000_85_00_1 + 3: pci_0000_85_00_2 + 4: pci_0000_85_00_3 + sfp: + 5: pci_0000_c4_00_0 + 6: pci_0000_c4_00_1 + 7: pci_0000_c5_00_0 + 8: pci_0000_c5_00_1 + 9: pci_0000_c5_00_2 + 10: pci_0000_c5_00_3 + SOSSN7200: + cpu: 128 + memory: 256 + copper: + 1: pci_0000_03_00_0 + 2: pci_0000_03_00_1 + 3: pci_0000_03_00_2 + 4: pci_0000_03_00_3 sfp: 5: pci_0000_02_00_0 6: pci_0000_02_00_1 - 7: pci_0000_41_00_0 - 8: pci_0000_41_00_1 - model2: - cpu: 256 - memory: 256 - disk: - 1: pci_0000_c7_00_0 - 2: pci_0000_c8_00_0 - 3: pci_0000_c9_00_0 - 4: pci_0000_c10_00_0 + 7: pci_0000_81_00_0 + 8: pci_0000_81_00_1 + 9: pci_0000_81_00_2 + 10: pci_0000_81_00_3 + SOSSN7200-DE02: + cpu: 128 + memory: 384 copper: - 1: pci_0000_c4_00_0 - 2: pci_0000_c4_00_1 - 3: pci_0000_c4_00_2 - 4: pci_0000_c4_00_3 - 5: pci_0000_c5_00_0 - 6: pci_0000_c5_00_1 - 7: pci_0000_c5_00_2 - 8: pci_0000_c5_00_3 + 1: pci_0000_82_00_0 + 2: pci_0000_82_00_1 + 3: pci_0000_82_00_2 + 4: pci_0000_82_00_3 sfp: - 9: pci_0000_02_00_0 - 10: pci_0000_02_00_1 - 11: pci_0000_41_00_0 - 12: pci_0000_41_00_1 \ No newline at end of file + 5: pci_0000_c4_00_0 + 6: pci_0000_c4_00_1 + 7: pci_0000_c5_00_0 + 8: pci_0000_c5_00_1 + 9: pci_0000_c6_00_0 + 10: pci_0000_c6_00_1 + 11: pci_0000_c6_00_2 + 12: pci_0000_c6_00_3 + SOS4000: + cpu: 128 + memory: 256 + copper: + 1: pci_0000_03_00_0 + 2: pci_0000_03_00_1 + 3: pci_0000_03_00_2 + 4: pci_0000_03_00_3 + sfp: + 5: pci_0000_02_00_0 + 6: pci_0000_02_00_1 + 7: pci_0000_81_00_0 + 8: pci_0000_81_00_1 + 9: pci_0000_81_00_2 + 10: pci_0000_81_00_3 + SOS5000-DE02: + cpu: 128 + memory: 384 + copper: + 1: pci_0000_82_00_0 + 2: pci_0000_82_00_1 + 3: pci_0000_82_00_2 + 4: pci_0000_82_00_3 + sfp: + 5: pci_0000_c4_00_0 + 6: pci_0000_c4_00_1 + 7: pci_0000_c5_00_0 + 8: pci_0000_c5_00_1 + 9: pci_0000_c6_00_0 + 10: pci_0000_c6_00_1 + 11: pci_0000_c6_00_2 + 12: pci_0000_c6_00_3 From a3fb2f13be3848c906f53511c2c73fc41c4a8ef7 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 16 Jul 2025 14:14:16 -0400 Subject: [PATCH 263/303] dont show state changes for user-data --- salt/libvirt/images/init.sls | 1 + 1 file changed, 1 insertion(+) diff --git a/salt/libvirt/images/init.sls b/salt/libvirt/images/init.sls index b6a5baf04..21ab0553d 100644 --- a/salt/libvirt/images/init.sls +++ b/salt/libvirt/images/init.sls @@ -48,6 +48,7 @@ manage_userdata_sool9: file.managed: - name: /nsm/libvirt/images/sool9/user-data - source: salt://libvirt/images/sool9/user-data + - show_changes: False # Manage qcow2 image manage_qcow2_sool9: From 1aa876f4ebe601790acebc75d22e38b64e19bb4b Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 16 Jul 2025 14:20:55 -0400 Subject: [PATCH 264/303] add missing hardware key --- salt/hypervisor/defaults.yaml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/salt/hypervisor/defaults.yaml b/salt/hypervisor/defaults.yaml index 8cf754193..938fa8bb2 100644 --- a/salt/hypervisor/defaults.yaml +++ b/salt/hypervisor/defaults.yaml @@ -33,6 +33,7 @@ hypervisor: 3: pci_0000_41_00_0 4: pci_0000_41_00_1 SOSSNNV-DE02: + hardware: cpu: 128 memory: 384 disk: @@ -55,6 +56,7 @@ hypervisor: 9: pci_0000_c5_00_2 10: pci_0000_c5_00_3 SOSSN7200: + hardware: cpu: 128 memory: 256 copper: @@ -70,6 +72,7 @@ hypervisor: 9: pci_0000_81_00_2 10: pci_0000_81_00_3 SOSSN7200-DE02: + hardware: cpu: 128 memory: 384 copper: @@ -87,6 +90,7 @@ hypervisor: 11: pci_0000_c6_00_2 12: pci_0000_c6_00_3 SOS4000: + hardware: cpu: 128 memory: 256 copper: @@ -102,6 +106,7 @@ hypervisor: 9: pci_0000_81_00_2 10: pci_0000_81_00_3 SOS5000-DE02: + hardware: cpu: 128 memory: 384 copper: From e61e2f04b3e645645f05ce2b6c3ff1a5a5374479 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 16 Jul 2025 15:24:43 -0400 Subject: [PATCH 265/303] handle hw not having sfp,disk or copper. show none for total if that is the case --- .../hypervisor/soc_hypervisor.yaml.jinja | 23 ++++++++++++------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 4222ff6b2..07577a1fb 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -22,7 +22,7 @@ | | CPU Cores | Memory (GB) | Disk | Copper | SFP | |-----------|-----------|-------------|-------------|-------------|-------------| | Available | {{ cpu_free }} | {{ mem_free }} | {{ disk_free | replace('\n', ',') if disk_free else 'None' }} | {{ copper_free | replace('\n', ',') if copper_free else 'None' }} | {{ sfp_free | replace('\n', ',') if sfp_free else 'None' }} | -| Total | {{ cpu_total }} | {{ mem_total }} | {{ disk_total | replace('\n', ',') }} | {{ copper_total | replace('\n', ',') }} | {{ sfp_total | replace('\n', ',') }} | +| Total | {{ cpu_total }} | {{ mem_total }} | {{ disk_total | replace('\n', ',') if disk_total else 'None' }} | {{ copper_total | replace('\n', ',') if copper_total else 'None' }} | {{ sfp_total | replace('\n', ',') if sfp_total else 'None' }} | {%- if baseDomainStatus == 'Initialized' %} {%- if vm_list %} @@ -60,7 +60,8 @@ Base domain has not been initialized. {%- macro get_available_pci(hw_config, device_type, used_indices) -%} {%- set available = [] -%} -{%- for idx in hw_config.get(device_type, {}).keys() -%} +{%- set device_config = hw_config.get(device_type, {}) or {} -%} +{%- for idx in device_config.keys() -%} {%- if idx | string not in used_indices -%} {%- do available.append(idx) -%} {%- endif -%} @@ -155,9 +156,9 @@ Base domain has not been initialized. {# Get total resources #} {%- set cpu_total = hw_config.cpu -%} {%- set mem_total = hw_config.memory -%} -{%- set disk_total = hw_config.disk.keys() | join('\n') -%} -{%- set copper_total = hw_config.copper.keys() | join('\n') -%} -{%- set sfp_total = hw_config.sfp.keys() | join('\n') -%} +{%- set disk_total = (hw_config.get('disk', {}) or {}).keys() | join('\n') if hw_config.get('disk', {}) else '' -%} +{%- set copper_total = (hw_config.get('copper', {}) or {}).keys() | join('\n') if hw_config.get('copper', {}) else '' -%} +{%- set sfp_total = (hw_config.get('sfp', {}) or {}).keys() | join('\n') if hw_config.get('sfp', {}) else '' -%} {# Update field labels with total and free values #} {%- set updated_template = TEMPLATE.copy() -%} @@ -170,20 +171,26 @@ Base domain has not been initialized. {%- do update_resource_field(updated_field, mem_free, mem_total, 'GB') -%} {%- elif field.field == 'disk' -%} {%- set disk_free_list = disk_free.split(',') if disk_free else [] -%} +{%- set disk_free_safe = disk_free if disk_free is defined else '' -%} +{%- set disk_total_safe = disk_total if disk_total is defined else '' -%} {%- do updated_field.update({ - 'label': field.label | replace('FREE', disk_free) | replace('TOTAL', disk_total | replace('\n', ',')), + 'label': field.label | replace('FREE', disk_free_safe) | replace('TOTAL', disk_total_safe | replace('\n', ',')), 'options': disk_free_list }) -%} {%- elif field.field == 'copper' -%} {%- set copper_free_list = copper_free.split(',') if copper_free else [] -%} +{%- set copper_free_safe = copper_free if copper_free is defined else '' -%} +{%- set copper_total_safe = copper_total if copper_total is defined else '' -%} {%- do updated_field.update({ - 'label': field.label | replace('FREE', copper_free) | replace('TOTAL', copper_total | replace('\n', ',')), + 'label': field.label | replace('FREE', copper_free_safe) | replace('TOTAL', copper_total_safe | replace('\n', ',')), 'options': copper_free_list }) -%} {%- elif field.field == 'sfp' -%} {%- set sfp_free_list = sfp_free.split(',') if sfp_free else [] -%} +{%- set sfp_free_safe = sfp_free if sfp_free is defined else '' -%} +{%- set sfp_total_safe = sfp_total if sfp_total is defined else '' -%} {%- do updated_field.update({ - 'label': field.label | replace('FREE', sfp_free) | replace('TOTAL', sfp_total | replace('\n', ',')), + 'label': field.label | replace('FREE', sfp_free_safe) | replace('TOTAL', sfp_total_safe | replace('\n', ',')), 'options': sfp_free_list }) -%} {%- endif -%} From b3eb06f53e839ac9792d842836a21706e8e42ff8 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 16 Jul 2025 15:56:34 -0500 Subject: [PATCH 266/303] ja4 Signed-off-by: reyesj2 <94730068+reyesj2@users.noreply.github.com> --- salt/elasticsearch/defaults.yaml | 5 ++ salt/elasticsearch/files/ingest/zeek.conn | 4 ++ salt/elasticsearch/files/ingest/zeek.http | 1 + salt/elasticsearch/files/ingest/zeek.http2 | 1 + salt/elasticsearch/files/ingest/zeek.ja4ssh | 10 +++ salt/elasticsearch/files/ingest/zeek.ssl | 2 + salt/elasticsearch/files/ingest/zeek.x509 | 1 + .../templates/component/ecs/hash.json | 69 +++++++++++++++++++ 8 files changed, 93 insertions(+) create mode 100644 salt/elasticsearch/files/ingest/zeek.ja4ssh create mode 100644 salt/elasticsearch/templates/component/ecs/hash.json diff --git a/salt/elasticsearch/defaults.yaml b/salt/elasticsearch/defaults.yaml index 73c29c8c6..4046cf146 100644 --- a/salt/elasticsearch/defaults.yaml +++ b/salt/elasticsearch/defaults.yaml @@ -567,6 +567,7 @@ elasticsearch: - common-settings - common-dynamic-mappings - winlog-mappings + - hash-mappings data_stream: {} ignore_missing_component_templates: [] index_patterns: @@ -3874,6 +3875,7 @@ elasticsearch: - vulnerability-mappings - common-settings - common-dynamic-mappings + - hash-mappings data_stream: {} ignore_missing_component_templates: [] index_patterns: @@ -3987,6 +3989,7 @@ elasticsearch: - vulnerability-mappings - common-settings - common-dynamic-mappings + - hash-mappings data_stream: {} ignore_missing_component_templates: [] index_patterns: @@ -4100,6 +4103,7 @@ elasticsearch: - vulnerability-mappings - common-settings - common-dynamic-mappings + - hash-mappings data_stream: {} ignore_missing_component_templates: [] index_patterns: @@ -4329,6 +4333,7 @@ elasticsearch: - zeek-mappings - common-settings - common-dynamic-mappings + - hash-mappings data_stream: {} ignore_missing_component_templates: [] index_patterns: diff --git a/salt/elasticsearch/files/ingest/zeek.conn b/salt/elasticsearch/files/ingest/zeek.conn index 6051d93a1..fe3d3b832 100644 --- a/salt/elasticsearch/files/ingest/zeek.conn +++ b/salt/elasticsearch/files/ingest/zeek.conn @@ -24,6 +24,10 @@ { "rename": { "field": "message2.resp_cc", "target_field": "server.country_code", "ignore_missing": true } }, { "rename": { "field": "message2.sensorname", "target_field": "observer.name", "ignore_missing": true } }, { "rename": { "field": "message2.vlan", "target_field": "network.vlan.id", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4l", "target_field": "hash.ja4l", "ignore_missing" : true }}, + { "rename": { "field": "message2.ja4ls", "target_field": "hash.ja4ls", "ignore_missing" : true }}, + { "rename": { "field": "message2.ja4t", "target_field": "hash.ja4t", "ignore_missing" : true }}, + { "rename": { "field": "message2.ja4ts", "target_field": "hash.ja4ts", "ignore_missing" : true }}, { "script": { "lang": "painless", "source": "ctx.network.bytes = (ctx.client.bytes + ctx.server.bytes)", "ignore_failure": true } }, { "set": { "if": "ctx.connection?.state == 'S0'", "field": "connection.state_description", "value": "Connection attempt seen, no reply" } }, { "set": { "if": "ctx.connection?.state == 'S1'", "field": "connection.state_description", "value": "Connection established, not terminated" } }, diff --git a/salt/elasticsearch/files/ingest/zeek.http b/salt/elasticsearch/files/ingest/zeek.http index 2224da2f7..8b2a320f9 100644 --- a/salt/elasticsearch/files/ingest/zeek.http +++ b/salt/elasticsearch/files/ingest/zeek.http @@ -27,6 +27,7 @@ { "rename": { "field": "message2.resp_fuids", "target_field": "log.id.resp_fuids", "ignore_missing": true } }, { "rename": { "field": "message2.resp_filenames", "target_field": "file.resp_filenames", "ignore_missing": true } }, { "rename": { "field": "message2.resp_mime_types", "target_field": "file.resp_mime_types", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4h", "target_field": "hash.ja4h", "ignore_missing": true } }, { "script": { "lang": "painless", "source": "ctx.uri_length = ctx.uri.length()", "ignore_failure": true } }, { "script": { "lang": "painless", "source": "ctx.useragent_length = ctx.useragent.length()", "ignore_failure": true } }, { "script": { "lang": "painless", "source": "ctx.virtual_host_length = ctx.virtual_host.length()", "ignore_failure": true } }, diff --git a/salt/elasticsearch/files/ingest/zeek.http2 b/salt/elasticsearch/files/ingest/zeek.http2 index eeeecef8c..e72259dda 100644 --- a/salt/elasticsearch/files/ingest/zeek.http2 +++ b/salt/elasticsearch/files/ingest/zeek.http2 @@ -27,6 +27,7 @@ { "rename": { "field": "message2.resp_filenames", "target_field": "file.resp_filenames", "ignore_missing": true } }, { "rename": { "field": "message2.resp_mime_types", "target_field": "file.resp_mime_types", "ignore_missing": true } }, { "rename": { "field": "message2.stream_id", "target_field": "http2.stream_id", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4h", "target_field": "hash.ja4h", "ignore_missing": true } }, { "remove": { "field": "message2.tags", "ignore_failure": true } }, { "remove": { "field": ["host"], "ignore_failure": true } }, { "script": { "lang": "painless", "source": "ctx.uri_length = ctx.uri.length()", "ignore_failure": true } }, diff --git a/salt/elasticsearch/files/ingest/zeek.ja4ssh b/salt/elasticsearch/files/ingest/zeek.ja4ssh new file mode 100644 index 000000000..45a569792 --- /dev/null +++ b/salt/elasticsearch/files/ingest/zeek.ja4ssh @@ -0,0 +1,10 @@ +{ + "description": "zeek.ja4ssh", + "processors": [ + {"set": {"field": "event.dataset","value": "ja4ssh"}}, + {"remove": {"field": "host","ignore_missing": true,"ignore_failure": true}}, + {"json": {"field": "message","target_field": "message2","ignore_failure": true}}, + {"rename": {"field": "message2.ja4ssh", "target_field": "ja4.ja4ssh", "ignore_missing": true}}, + {"pipeline": {"name": "zeek.common"}} + ] +} \ No newline at end of file diff --git a/salt/elasticsearch/files/ingest/zeek.ssl b/salt/elasticsearch/files/ingest/zeek.ssl index 87174d3d2..c694ab333 100644 --- a/salt/elasticsearch/files/ingest/zeek.ssl +++ b/salt/elasticsearch/files/ingest/zeek.ssl @@ -23,6 +23,8 @@ { "rename": { "field": "message2.validation_status","target_field": "ssl.validation_status", "ignore_missing": true } }, { "rename": { "field": "message2.ja3", "target_field": "hash.ja3", "ignore_missing": true } }, { "rename": { "field": "message2.ja3s", "target_field": "hash.ja3s", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4", "target_field": "hash.ja4", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4s", "target_field": "hash.ja4s", "ignore_missing": true } }, { "foreach": { "if": "ctx?.tls?.client?.hash?.sha256 !=null", diff --git a/salt/elasticsearch/files/ingest/zeek.x509 b/salt/elasticsearch/files/ingest/zeek.x509 index 64d06131a..daec96245 100644 --- a/salt/elasticsearch/files/ingest/zeek.x509 +++ b/salt/elasticsearch/files/ingest/zeek.x509 @@ -42,6 +42,7 @@ { "dot_expander": { "field": "basic_constraints.path_length", "path": "message2", "ignore_failure": true } }, { "rename": { "field": "message2.basic_constraints.path_length", "target_field": "x509.basic_constraints.path_length", "ignore_missing": true } }, { "rename": { "field": "message2.fingerprint", "target_field": "hash.sha256", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4x", "target_field": "hash.ja4x", "ignore_missing": true } }, { "pipeline": { "name": "zeek.common_ssl" } } ] } diff --git a/salt/elasticsearch/templates/component/ecs/hash.json b/salt/elasticsearch/templates/component/ecs/hash.json new file mode 100644 index 000000000..c9d1f5a5d --- /dev/null +++ b/salt/elasticsearch/templates/component/ecs/hash.json @@ -0,0 +1,69 @@ +{ + "template": { + "mappings": { + "properties": { + "hash": { + "type": "object", + "properties": { + "ja3": { + "type": "keyword", + "ignore_above": 1024 + }, + "ja3s": { + "type": "keyword", + "ignore_above": 1024 + }, + "hassh": { + "type": "keyword", + "ignore_above": 1024 + }, + "md5": { + "type": "keyword", + "ignore_above": 1024 + }, + "sha1": { + "type": "keyword", + "ignore_above": 1024 + }, + "sha256": { + "type": "keyword", + "ignore_above": 1024 + }, + "ja4": { + "type": "keyword", + "ignore_above": 1024 + }, + "ja4l": { + "type": "keyword", + "ignore_above": 1024 + }, + "ja4ls": { + "type": "keyword", + "ignore_above": 1024 + }, + "ja4t": { + "type": "keyword", + "ignore_above": 1024 + }, + "ja4ts": { + "type": "keyword", + "ignore_above": 1024 + }, + "ja4ssh": { + "type": "keyword", + "ignore_above": 1024 + }, + "ja4h": { + "type": "keyword", + "ignore_above": 1024 + }, + "ja4x": { + "type": "keyword", + "ignore_above": 1024 + } + } + } + } + } + } +} \ No newline at end of file From c29f11863e96b86540fae76386c5e5ec3b8fe7d4 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Thu, 17 Jul 2025 10:47:00 -0500 Subject: [PATCH 267/303] ja4 ignore empty strings --- salt/elasticsearch/files/ingest/zeek.conn | 8 ++++---- salt/elasticsearch/files/ingest/zeek.http | 2 +- salt/elasticsearch/files/ingest/zeek.http2 | 2 +- salt/elasticsearch/files/ingest/zeek.ja4ssh | 2 +- salt/elasticsearch/files/ingest/zeek.ssl | 4 ++-- salt/elasticsearch/files/ingest/zeek.x509 | 2 +- 6 files changed, 10 insertions(+), 10 deletions(-) diff --git a/salt/elasticsearch/files/ingest/zeek.conn b/salt/elasticsearch/files/ingest/zeek.conn index fe3d3b832..57558e863 100644 --- a/salt/elasticsearch/files/ingest/zeek.conn +++ b/salt/elasticsearch/files/ingest/zeek.conn @@ -24,10 +24,10 @@ { "rename": { "field": "message2.resp_cc", "target_field": "server.country_code", "ignore_missing": true } }, { "rename": { "field": "message2.sensorname", "target_field": "observer.name", "ignore_missing": true } }, { "rename": { "field": "message2.vlan", "target_field": "network.vlan.id", "ignore_missing": true } }, - { "rename": { "field": "message2.ja4l", "target_field": "hash.ja4l", "ignore_missing" : true }}, - { "rename": { "field": "message2.ja4ls", "target_field": "hash.ja4ls", "ignore_missing" : true }}, - { "rename": { "field": "message2.ja4t", "target_field": "hash.ja4t", "ignore_missing" : true }}, - { "rename": { "field": "message2.ja4ts", "target_field": "hash.ja4ts", "ignore_missing" : true }}, + { "rename": { "field": "message2.ja4l", "target_field": "hash.ja4l", "ignore_missing" : true, "if": "ctx.message2?.ja4l != null && ctx.message2.ja4l.length() > 0" }}, + { "rename": { "field": "message2.ja4ls", "target_field": "hash.ja4ls", "ignore_missing" : true, "if": "ctx.message2?.ja4ls != null && ctx.message2.ja4ls.length() > 0" }}, + { "rename": { "field": "message2.ja4t", "target_field": "hash.ja4t", "ignore_missing" : true, "if": "ctx.message2?.ja4t != null && ctx.message2.ja4t.length() > 0" }}, + { "rename": { "field": "message2.ja4ts", "target_field": "hash.ja4ts", "ignore_missing" : true, "if": "ctx.message2?.ja4ts != null && ctx.message2.ja4ts.length() > 0" }}, { "script": { "lang": "painless", "source": "ctx.network.bytes = (ctx.client.bytes + ctx.server.bytes)", "ignore_failure": true } }, { "set": { "if": "ctx.connection?.state == 'S0'", "field": "connection.state_description", "value": "Connection attempt seen, no reply" } }, { "set": { "if": "ctx.connection?.state == 'S1'", "field": "connection.state_description", "value": "Connection established, not terminated" } }, diff --git a/salt/elasticsearch/files/ingest/zeek.http b/salt/elasticsearch/files/ingest/zeek.http index 8b2a320f9..40642052a 100644 --- a/salt/elasticsearch/files/ingest/zeek.http +++ b/salt/elasticsearch/files/ingest/zeek.http @@ -27,7 +27,7 @@ { "rename": { "field": "message2.resp_fuids", "target_field": "log.id.resp_fuids", "ignore_missing": true } }, { "rename": { "field": "message2.resp_filenames", "target_field": "file.resp_filenames", "ignore_missing": true } }, { "rename": { "field": "message2.resp_mime_types", "target_field": "file.resp_mime_types", "ignore_missing": true } }, - { "rename": { "field": "message2.ja4h", "target_field": "hash.ja4h", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4h", "target_field": "hash.ja4h", "ignore_missing": true, "if": "ctx?.message2?.ja4h != null && ctx.message2.ja4h.length() > 0" } }, { "script": { "lang": "painless", "source": "ctx.uri_length = ctx.uri.length()", "ignore_failure": true } }, { "script": { "lang": "painless", "source": "ctx.useragent_length = ctx.useragent.length()", "ignore_failure": true } }, { "script": { "lang": "painless", "source": "ctx.virtual_host_length = ctx.virtual_host.length()", "ignore_failure": true } }, diff --git a/salt/elasticsearch/files/ingest/zeek.http2 b/salt/elasticsearch/files/ingest/zeek.http2 index e72259dda..34cce0f7b 100644 --- a/salt/elasticsearch/files/ingest/zeek.http2 +++ b/salt/elasticsearch/files/ingest/zeek.http2 @@ -27,7 +27,7 @@ { "rename": { "field": "message2.resp_filenames", "target_field": "file.resp_filenames", "ignore_missing": true } }, { "rename": { "field": "message2.resp_mime_types", "target_field": "file.resp_mime_types", "ignore_missing": true } }, { "rename": { "field": "message2.stream_id", "target_field": "http2.stream_id", "ignore_missing": true } }, - { "rename": { "field": "message2.ja4h", "target_field": "hash.ja4h", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4h", "target_field": "hash.ja4h", "ignore_missing": true, "if": "ctx?.message2?.ja4h != null && ctx.message2.ja4h.length() > 0" } }, { "remove": { "field": "message2.tags", "ignore_failure": true } }, { "remove": { "field": ["host"], "ignore_failure": true } }, { "script": { "lang": "painless", "source": "ctx.uri_length = ctx.uri.length()", "ignore_failure": true } }, diff --git a/salt/elasticsearch/files/ingest/zeek.ja4ssh b/salt/elasticsearch/files/ingest/zeek.ja4ssh index 45a569792..5901e65f1 100644 --- a/salt/elasticsearch/files/ingest/zeek.ja4ssh +++ b/salt/elasticsearch/files/ingest/zeek.ja4ssh @@ -4,7 +4,7 @@ {"set": {"field": "event.dataset","value": "ja4ssh"}}, {"remove": {"field": "host","ignore_missing": true,"ignore_failure": true}}, {"json": {"field": "message","target_field": "message2","ignore_failure": true}}, - {"rename": {"field": "message2.ja4ssh", "target_field": "ja4.ja4ssh", "ignore_missing": true}}, + {"rename": {"field": "message2.ja4ssh", "target_field": "hash.ja4ssh", "ignore_missing": true, "if": "ctx?.message2?.ja4ssh != null && ctx.message2.ja4ssh.length() > 0" }}, {"pipeline": {"name": "zeek.common"}} ] } \ No newline at end of file diff --git a/salt/elasticsearch/files/ingest/zeek.ssl b/salt/elasticsearch/files/ingest/zeek.ssl index c694ab333..0bd6fedb2 100644 --- a/salt/elasticsearch/files/ingest/zeek.ssl +++ b/salt/elasticsearch/files/ingest/zeek.ssl @@ -23,8 +23,8 @@ { "rename": { "field": "message2.validation_status","target_field": "ssl.validation_status", "ignore_missing": true } }, { "rename": { "field": "message2.ja3", "target_field": "hash.ja3", "ignore_missing": true } }, { "rename": { "field": "message2.ja3s", "target_field": "hash.ja3s", "ignore_missing": true } }, - { "rename": { "field": "message2.ja4", "target_field": "hash.ja4", "ignore_missing": true } }, - { "rename": { "field": "message2.ja4s", "target_field": "hash.ja4s", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4", "target_field": "hash.ja4", "ignore_missing": true, "if": "ctx?.message2?.ja4 != null && ctx.message2.ja4.length() > 0" } }, + { "rename": { "field": "message2.ja4s", "target_field": "hash.ja4s", "ignore_missing": true, "if": "ctx?.message2?.ja4s != null && ctx.message2.ja4s.length() > 0" } }, { "foreach": { "if": "ctx?.tls?.client?.hash?.sha256 !=null", diff --git a/salt/elasticsearch/files/ingest/zeek.x509 b/salt/elasticsearch/files/ingest/zeek.x509 index daec96245..b639cb417 100644 --- a/salt/elasticsearch/files/ingest/zeek.x509 +++ b/salt/elasticsearch/files/ingest/zeek.x509 @@ -42,7 +42,7 @@ { "dot_expander": { "field": "basic_constraints.path_length", "path": "message2", "ignore_failure": true } }, { "rename": { "field": "message2.basic_constraints.path_length", "target_field": "x509.basic_constraints.path_length", "ignore_missing": true } }, { "rename": { "field": "message2.fingerprint", "target_field": "hash.sha256", "ignore_missing": true } }, - { "rename": { "field": "message2.ja4x", "target_field": "hash.ja4x", "ignore_missing": true } }, + { "rename": { "field": "message2.ja4x", "target_field": "hash.ja4x", "ignore_missing": true, "if": "ctx?.message2?.ja4x != null && ctx.message2.ja4x.length() > 0" } }, { "pipeline": { "name": "zeek.common_ssl" } } ] } From 0b1f2252ee6c07964c9321ebf5379d641d292d8b Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Thu, 17 Jul 2025 13:27:54 -0500 Subject: [PATCH 268/303] elasticsearch troubleshoot script --- .../tools/sbin/so-elasticsearch-troubleshoot | 194 ++++++++++++++++++ 1 file changed, 194 insertions(+) create mode 100644 salt/elasticsearch/tools/sbin/so-elasticsearch-troubleshoot diff --git a/salt/elasticsearch/tools/sbin/so-elasticsearch-troubleshoot b/salt/elasticsearch/tools/sbin/so-elasticsearch-troubleshoot new file mode 100644 index 000000000..b6b201c3c --- /dev/null +++ b/salt/elasticsearch/tools/sbin/so-elasticsearch-troubleshoot @@ -0,0 +1,194 @@ +#!/bin/bash + +. /usr/sbin/so-common + +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +BLUE='\033[0;34m' +BOLD='\033[1;37m' +NC='\033[0m' + +log_title() { + if [ $1 == "LOG" ]; then + echo -e "\n${BOLD}================ $2 ================${NC}\n" + elif [ $1 == "OK" ]; then + echo -e "${GREEN} $2 ${NC}" + elif [ $1 == "WARN" ]; then + echo -e "${YELLOW} $2 ${NC}" + elif [ $1 == "ERROR" ]; then + echo -e "${RED} $2 ${NC}" + fi +} + +health_report() { + if ! health_report_output=$(so-elasticsearch-query _health_report?format=json --fail 2>/dev/null); then + log_title "ERROR" "Failed to retrieve health report from Elasticsearch" + return 1 + fi + non_green_count=$(echo "$health_report_output" | jq '[.indicators | to_entries[] | select(.value.status != "green")] | length') + + if [ "$non_green_count" -gt 0 ]; then + echo "$health_report_output" | jq -r '.indicators | to_entries[] | select(.value.status != "green") | .key' | while read -r indicator_name; do + indicator=$(echo "$health_report_output" | jq -r ".indicators.\"$indicator_name\"") + status=$(echo "$indicator" | jq -r '.status') + symptom=$(echo "$indicator" | jq -r '.symptom // "No symptom available"') + + # reormat indicator name + display_name=$(echo "$indicator_name" | tr '_' ' ' | sed 's/\b\(.\)/\u\1/g') + + if [ "$status" = "yellow" ]; then + log_title "WARN" "$display_name: $symptom" + else + log_title "ERROR" "$display_name: $symptom" + fi + + # diagnosis if available + echo "$indicator" | jq -c '.diagnosis[]? // empty' | while read -r diagnosis; do + cause=$(echo "$diagnosis" | jq -r '.cause // "Unknown"') + action=$(echo "$diagnosis" | jq -r '.action // "No action specified"') + + echo -e " ${BOLD}Cause:${NC} $cause\n" + echo -e " ${BOLD}Action:${NC} $action\n" + + # Check for affected indices + affected_indices=$(echo "$diagnosis" | jq -r '.affected_resources.indices[]? // empty') + if [ -n "$affected_indices" ]; then + echo -e " ${BOLD}Affected indices:${NC}" + total_indices=$(echo "$affected_indices" | wc -l) + echo "$affected_indices" | head -10 | while read -r index; do + echo " - $index" + done + if [ "$total_indices" -gt 10 ]; then + remaining=$((total_indices - 10)) + echo " ... and $remaining more indices (truncated for readability)" + fi + fi + echo + done + done + else + log_title "OK" "All health indicators are green" + fi +} + +elasticsearch_status() { + log_title "LOG" "Elasticsearch Status" + if so-elasticsearch-query / --fail --output /dev/null; then + health_report + else + log_title "ERROR" "Elasticsearch API is not accessible" + so-status + log_title "ERROR" "Make sure Elasticsearch is running. Addtionally, check for startup errors in /opt/so/log/elasticsearch/securityonion.log${NC}\n" + + exit 1 + fi + +} + +indices_by_age() { + log_title "LOG" "Indices by Creation Date - Size > 1KB" + log_title "WARN" "Since high/flood watermark has been reached consider updating ILM policies.\n" + if ! indices_output=$(so-elasticsearch-query '_cat/indices?v&s=creation.date:asc&h=creation.date.string,index,status,health,docs.count,pri.store.size&bytes=b&format=json' --fail 2>/dev/null); then + log_title "ERROR" "Failed to retrieve indices list from Elasticsearch" + return 1 + fi + + # Filter for indices with size > 1KB (1024 bytes) and format output + echo -e "${BOLD}Creation Date Name Size${NC}" + echo -e "${BOLD}--------------------------------------------------------------------------------------------------------------${NC}" + + # Create list of indices excluding .internal, so-detection*, so-case* + echo "$indices_output" | jq -r '.[] | select((."pri.store.size" | tonumber) > 1024) | select(.index | (startswith(".internal") or startswith("so-detection") or startswith("so-case")) | not ) | "\(."creation.date.string") | \(.index) | \(."pri.store.size")"' | while IFS='|' read -r creation_date index_name size_bytes; do + # Convert bytes to GB / MB + if [ "$size_bytes" -gt 1073741824 ]; then + size_human=$(echo "scale=2; $size_bytes / 1073741824" | bc)GB + else + size_human=$(echo "scale=2; $size_bytes / 1048576" | bc)MB + fi + + creation_date=$(date -d "$creation_date" '+%Y-%m-%dT%H:%MZ' ) + + # Format output with spacing + printf "%-19s %-76s %10s\n" "$creation_date" "$index_name" "$size_human" + done +} + +watermark_settings() { + watermark_path=".defaults.cluster.routing.allocation.disk.watermark" + if ! watermark_output=$(so-elasticsearch-query _cluster/settings?include_defaults=true\&filter_path=*.cluster.routing.allocation.disk.* --fail 2>/dev/null); then + log_title "ERROR" "Failed to retrieve watermark settings from Elasticsearch" + return 1 + fi + + if ! disk_allocation_output=$(so-elasticsearch-query _cat/nodes?v\&h=name,ip,disk.used_percent,disk.avail,disk.total\&format=json --fail 2>/dev/null); then + log_title "ERROR" "Failed to retrieve disk allocation data from Elasticsearch" + return 1 + fi + + flood=$(echo $watermark_output | jq -r "$watermark_path.flood_stage" ) + high=$(echo $watermark_output | jq -r "$watermark_path.high" ) + low=$(echo $watermark_output | jq -r "$watermark_path.low" ) + + # Strip percentage signs for comparison + flood_num=${flood%\%} + high_num=${high%\%} + low_num=${low%\%} + + # Check each nodes disk usage + log_title "LOG" "Disk Usage Check" + echo -e "${BOLD}LOW:${GREEN}$low${NC}${BOLD} HIGH:${YELLOW}${high}${NC}${BOLD} FLOOD:${RED}${flood}${NC}\n" + + echo "$disk_allocation_output" | jq -r '.[] | "\(.name)|\(.["disk.used_percent"])"' | while IFS='|' read -r node_name disk_used; do + disk_used_num=$(echo $disk_used | bc) + + if (( $(echo "$disk_used_num >= $flood_num" | bc -l) )); then + log_title "ERROR" "$node_name is at or above the flood watermark ($flood)! Disk usage: ${disk_used}%" + touch /tmp/watermark_reached + elif (( $(echo "$disk_used_num >= $high_num" | bc -l) )); then + log_title "ERROR" "$node_name is at or above the high watermark ($high)! Disk usage: ${disk_used}%" + touch /tmp/watermark_reached + else + log_title "OK" "$node_name disk usage: ${disk_used}%" + fi + done + + # Check if we need to show indices by age + if [ -f /tmp/watermark_reached ]; then + indices_by_age + rm -f /tmp/watermark_reached + fi + +} + +unassigned_shards() { + + if ! unassigned_shards_output=$(so-elasticsearch-query _cat/shards?v\&h=index,shard,prirep,state,unassigned.reason,unassigned.details\&s=state\&format=json --fail 2>/dev/null); then + log_title "ERROR" "Failed to retrieve shard data from Elasticsearch" + return 1 + fi + + log_title "LOG" "Unassigned Shards Check" + # Check if there are any UNASSIGNED shards + unassigned_count=$(echo "$unassigned_shards_output" | jq '[.[] | select(.state == "UNASSIGNED")] | length') + + if [ "$unassigned_count" -gt 0 ]; then + echo "$unassigned_shards_output" | jq -r '.[] | select(.state == "UNASSIGNED") | "\(.index)|\(.shard)|\(.prirep)|\(."unassigned.reason")"' | while IFS='|' read -r index shard prirep reason; do + if [ "$prirep" = "r" ]; then + log_title "WARN" "Replica shard for index $index is unassigned. Reason: $reason" + elif [ "$prirep" = "p" ]; then + log_title "ERROR" "Primary shard for index $index is unassigned. Reason: $reason" + fi + done + else + log_title "OK" "All shards are assigned" + fi +} + +main() { + elasticsearch_status + watermark_settings + unassigned_shards +} + +main From f27714890a08a9a16ad24deedab6945c157571a3 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Fri, 18 Jul 2025 09:35:51 -0500 Subject: [PATCH 269/303] update file ownership to socore --- salt/idh/config.sls | 2 +- salt/idstools/config.sls | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/salt/idh/config.sls b/salt/idh/config.sls index 91f809f9e..2e6315007 100644 --- a/salt/idh/config.sls +++ b/salt/idh/config.sls @@ -86,7 +86,7 @@ idh_sbin: file.recurse: - name: /usr/sbin - source: salt://idh/tools/sbin - - user: 934 + - user: 939 - group: 939 - file_mode: 755 diff --git a/salt/idstools/config.sls b/salt/idstools/config.sls index a44b02807..cea75ab9a 100644 --- a/salt/idstools/config.sls +++ b/salt/idstools/config.sls @@ -20,7 +20,7 @@ idstools_sbin: file.recurse: - name: /usr/sbin - source: salt://idstools/tools/sbin - - user: 934 + - user: 939 - group: 939 - file_mode: 755 @@ -29,7 +29,7 @@ idstools_sbin: # file.recurse: # - name: /usr/sbin # - source: salt://idstools/tools/sbin_jinja -# - user: 934 +# - user: 939 # - group: 939 # - file_mode: 755 # - template: jinja @@ -38,7 +38,7 @@ idstools_so-rule-update: file.managed: - name: /usr/sbin/so-rule-update - source: salt://idstools/tools/sbin_jinja/so-rule-update - - user: 934 + - user: 939 - group: 939 - mode: 755 - template: jinja From 246161018cb7a63d30af8ff258b8f9de0786fec5 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 18 Jul 2025 14:17:38 -0400 Subject: [PATCH 270/303] upgrade and start salt process change --- salt/salt/minion.sls | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/salt/salt/minion.sls b/salt/salt/minion.sls index 3ae7ded9a..4dfa54391 100644 --- a/salt/salt/minion.sls +++ b/salt/salt/minion.sls @@ -38,25 +38,33 @@ unhold_salt_packages: {% endfor %} install_salt_minion: + cmd.run: + - name: /bin/sh -c '{{ UPGRADECOMMAND }}' + +# minion service is in failed state after upgrade. this command will start it after the state run for the upgrade completes +start_minion: cmd.run: - name: | exec 0>&- # close stdin exec 1>&- # close stdout exec 2>&- # close stderr - nohup /bin/sh -c '{{ UPGRADECOMMAND }}' & + nohup /bin/sh -c 'sleep 30; systemctl start salt-minion' & + - require: + - cmd: install_salt_minion + - watch: + - cmd: install_salt_minion + - order: last {% endif %} {% if INSTALLEDSALTVERSION|string == SALTVERSION|string %} -# only hold the package if it is already installed + hold_salt_packages: pkg.held: - pkgs: -{% for package in SALTPACKAGES %} -{% if salt['pkg.version'](package) %} +{% for package in SALTPACKAGES %} - {{ package }}: {{SALTVERSION}}-0.* -{% endif %} -{% endfor %} +{% endfor %} remove_error_log_level_logfile: file.line: From 05a368681a6d76f085357fe37de3a5635d4a8e06 Mon Sep 17 00:00:00 2001 From: Mike Reeves Date: Mon, 21 Jul 2025 10:53:54 -0400 Subject: [PATCH 271/303] Create config.zeek.ja4 --- salt/zeek/files/config.zeek.ja4 | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 salt/zeek/files/config.zeek.ja4 diff --git a/salt/zeek/files/config.zeek.ja4 b/salt/zeek/files/config.zeek.ja4 new file mode 100644 index 000000000..e3dd08a48 --- /dev/null +++ b/salt/zeek/files/config.zeek.ja4 @@ -0,0 +1,25 @@ +module FINGERPRINT; + +export { + option delimiter: string = "_"; + + # BSD licensed + option JA4_enabled: bool = T; + option JA4_raw: bool = F; + + # FoxIO license required for JA4+ + option JA4S_enabled: bool = F; + option JA4S_raw: bool = F; + + option JA4H_enabled: bool = F; + option JA4H_raw: bool = F; + + option JA4L_enabled: bool = F; + + option JA4SSH_enabled: bool = F; + + option JA4T_enabled: bool = F; + option JA4TS_enabled: bool = F; + + option JA4X_enabled: bool = F; +} From 93024738d31715f9b613520e9adbc0d7b1d4d262 Mon Sep 17 00:00:00 2001 From: Mike Reeves Date: Mon, 21 Jul 2025 10:57:45 -0400 Subject: [PATCH 272/303] Update config.sls --- salt/zeek/config.sls | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/salt/zeek/config.sls b/salt/zeek/config.sls index 7fdbd8560..761c6f7d3 100644 --- a/salt/zeek/config.sls +++ b/salt/zeek/config.sls @@ -150,6 +150,13 @@ plcronscript: - source: salt://zeek/cron/packetloss.sh - mode: 755 +zeekja4cfg: + file.managed: + - name: /opt/so/conf/zeek/config.zeek + - source: salt://zeek/files/config.zeek.ja4 + - user: 937 + - group: 939 + # BPF compilation and configuration {% if ZEEKBPF %} {% set BPF_CALC = salt['cmd.script']('salt://common/tools/sbin/so-bpf-compile', GLOBALS.sensor.interface + ' ' + ZEEKBPF|join(" "),cwd='/root') %} From 5dac3ff2a672fde5d7faaef2774bcf4d489bfeea Mon Sep 17 00:00:00 2001 From: Mike Reeves Date: Mon, 21 Jul 2025 10:58:25 -0400 Subject: [PATCH 273/303] Update enabled.sls --- salt/zeek/enabled.sls | 1 + 1 file changed, 1 insertion(+) diff --git a/salt/zeek/enabled.sls b/salt/zeek/enabled.sls index 7d444ff43..ff090428f 100644 --- a/salt/zeek/enabled.sls +++ b/salt/zeek/enabled.sls @@ -34,6 +34,7 @@ so-zeek: - /opt/so/conf/zeek/policy/cve-2020-0601:/opt/zeek/share/zeek/policy/cve-2020-0601:ro - /opt/so/conf/zeek/policy/intel:/opt/zeek/share/zeek/policy/intel:rw - /opt/so/conf/zeek/bpf:/opt/zeek/etc/bpf:ro + - /opt/so/conf/zeek/config.zeek:/opt/zeek/share/zeek/site/packages/ja4/config.zeek:ro {% if DOCKER.containers['so-zeek'].custom_bind_mounts %} {% for BIND in DOCKER.containers['so-zeek'].custom_bind_mounts %} - {{ BIND }} From eabca5df1897c9330e641bf71d4854430e2497b8 Mon Sep 17 00:00:00 2001 From: Mike Reeves Date: Mon, 21 Jul 2025 11:01:33 -0400 Subject: [PATCH 274/303] Update defaults.yaml --- salt/zeek/defaults.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/salt/zeek/defaults.yaml b/salt/zeek/defaults.yaml index 1daf77102..d87a67ac6 100644 --- a/salt/zeek/defaults.yaml +++ b/salt/zeek/defaults.yaml @@ -52,6 +52,7 @@ zeek: - policy/frameworks/notice/community-id - policy/protocols/conn/community-id-logging - ja3 + - ja4 - hassh - intel - cve-2020-0601 From beda0bc89ce04d6a6f18cf76b47592e01ec836a8 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 21 Jul 2025 15:40:36 -0400 Subject: [PATCH 275/303] new state name. no longer need to close stdin, stderr stdout --- salt/salt/minion.sls | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/salt/salt/minion.sls b/salt/salt/minion.sls index 4dfa54391..ba1613b82 100644 --- a/salt/salt/minion.sls +++ b/salt/salt/minion.sls @@ -42,13 +42,9 @@ install_salt_minion: - name: /bin/sh -c '{{ UPGRADECOMMAND }}' # minion service is in failed state after upgrade. this command will start it after the state run for the upgrade completes -start_minion: +start_minion_post_upgrade: cmd.run: - - name: | - exec 0>&- # close stdin - exec 1>&- # close stdout - exec 2>&- # close stderr - nohup /bin/sh -c 'sleep 30; systemctl start salt-minion' & + - name: nohup /bin/sh -c 'sleep 30; systemctl start salt-minion' & - require: - cmd: install_salt_minion - watch: From 442aecb9f47adbc1e792d258642997ce8c221f38 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 22 Jul 2025 10:30:59 -0400 Subject: [PATCH 276/303] bootstrap dont start daemon, use state to start it --- salt/salt/map.jinja | 4 ++-- salt/salt/minion.sls | 6 +++++- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/salt/salt/map.jinja b/salt/salt/map.jinja index 55b3a7ffb..1e3b200f4 100644 --- a/salt/salt/map.jinja +++ b/salt/salt/map.jinja @@ -26,9 +26,9 @@ {% if INSTALLEDSALTVERSION != SALTVERSION %} {% if grains.os_family|lower == 'redhat' %} - {% set UPGRADECOMMAND = 'yum clean all ; /usr/sbin/bootstrap-salt.sh -s 120 -r -F stable ' ~ SALTVERSION %} + {% set UPGRADECOMMAND = 'yum clean all ; /usr/sbin/bootstrap-salt.sh -X -r -F stable ' ~ SALTVERSION %} {% elif grains.os_family|lower == 'debian' %} - {% set UPGRADECOMMAND = '/usr/sbin/bootstrap-salt.sh -s 120 -F stable ' ~ SALTVERSION %} + {% set UPGRADECOMMAND = '/usr/sbin/bootstrap-salt.sh -X -F stable ' ~ SALTVERSION %} {% endif %} {% else %} {% set UPGRADECOMMAND = 'echo Already running Salt Minion version ' ~ SALTVERSION %} diff --git a/salt/salt/minion.sls b/salt/salt/minion.sls index ba1613b82..8736f4eb2 100644 --- a/salt/salt/minion.sls +++ b/salt/salt/minion.sls @@ -44,7 +44,11 @@ install_salt_minion: # minion service is in failed state after upgrade. this command will start it after the state run for the upgrade completes start_minion_post_upgrade: cmd.run: - - name: nohup /bin/sh -c 'sleep 30; systemctl start salt-minion' & + - name: | + exec 0>&- # close stdin + exec 1>&- # close stdout + exec 2>&- # close stderr + nohup /bin/sh -c 'sleep 30; systemctl start salt-minion' & - require: - cmd: install_salt_minion - watch: From 669d219fdc6e30eeddd648d676119b5edeb1ac48 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 22 Jul 2025 11:52:50 -0400 Subject: [PATCH 277/303] splay highstate schedule 2minutes for non managers --- salt/schedule.sls | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/salt/schedule.sls b/salt/schedule.sls index 74c9acb56..c3b5d85ae 100644 --- a/salt/schedule.sls +++ b/salt/schedule.sls @@ -1,5 +1,10 @@ +{% from 'vars/globals.map.jinja' import GLOBALS %} + highstate_schedule: schedule.present: - function: state.highstate - minutes: 15 - maxrunning: 1 +{% if not GLOBALS.is_manager %} + - splay: 120 +{% endif %} From af49a8e4ef72f4b9a6c9bfa376c14bddc71e151d Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Tue, 22 Jul 2025 13:22:50 -0400 Subject: [PATCH 278/303] add back comment --- salt/salt/minion.sls | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/salt/minion.sls b/salt/salt/minion.sls index 8736f4eb2..b6db9d046 100644 --- a/salt/salt/minion.sls +++ b/salt/salt/minion.sls @@ -58,7 +58,7 @@ start_minion_post_upgrade: {% endif %} {% if INSTALLEDSALTVERSION|string == SALTVERSION|string %} - +# only hold the package if it is already installed hold_salt_packages: pkg.held: - pkgs: From 2a166af52400a4ce2e21c7fd0483c8858fff70aa Mon Sep 17 00:00:00 2001 From: Doug Burks Date: Tue, 22 Jul 2025 16:10:44 -0400 Subject: [PATCH 279/303] UPGRADE: Zeek Ethercat plugin #14783 --- salt/zeek/defaults.yaml | 1 - 1 file changed, 1 deletion(-) diff --git a/salt/zeek/defaults.yaml b/salt/zeek/defaults.yaml index d87a67ac6..81bfa3d9d 100644 --- a/salt/zeek/defaults.yaml +++ b/salt/zeek/defaults.yaml @@ -116,7 +116,6 @@ zeek: excluded: - broker - capture_loss - - ecat_arp_info - known_hosts - known_services - loaded_scripts From 4728b96c51991a888738e0c1f9162405e79401d9 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 22 Jul 2025 16:16:28 -0500 Subject: [PATCH 280/303] add a retry to so-elastic-fleet-integration-upgrade when response isn't what was expected that way the error message isn't throwin into sosetup / soup log --- .../tools/sbin/so-elastic-fleet-common | 18 ++++++++++++++---- .../so-elastic-fleet-integration-upgrade | 16 ++++++++++++---- 2 files changed, 26 insertions(+), 8 deletions(-) diff --git a/salt/elasticfleet/tools/sbin/so-elastic-fleet-common b/salt/elasticfleet/tools/sbin/so-elastic-fleet-common index d8d0bdb1e..9780c8b12 100644 --- a/salt/elasticfleet/tools/sbin/so-elastic-fleet-common +++ b/salt/elasticfleet/tools/sbin/so-elastic-fleet-common @@ -88,7 +88,13 @@ elastic_fleet_package_version_check() { elastic_fleet_package_latest_version_check() { PACKAGE=$1 - curl -s -K /opt/so/conf/elasticsearch/curl.config -b "sid=$SESSIONCOOKIE" -L -X GET "localhost:5601/api/fleet/epm/packages/$PACKAGE" | jq -r '.item.latestVersion' + if output=$(curl -s -K /opt/so/conf/elasticsearch/curl.config -b "sid=$SESSIONCOOKIE" -L -X GET "localhost:5601/api/fleet/epm/packages/$PACKAGE" --fail); then + if version=$(jq -e -r '.item.latestVersion' <<< $output); then + echo "$version" + fi + else + echo "Error: Failed to get latest version for $PACKAGE" + fi } elastic_fleet_package_install() { @@ -149,9 +155,13 @@ elastic_fleet_integration_policy_package_name() { elastic_fleet_integration_policy_package_version() { AGENT_POLICY=$1 INTEGRATION=$2 - curl -s -K /opt/so/conf/elasticsearch/curl.config -b "sid=$SESSIONCOOKIE" -L -X GET "localhost:5601/api/fleet/agent_policies/$AGENT_POLICY" | jq -r --arg INTEGRATION "$INTEGRATION" '.item.package_policies[] | select(.name==$INTEGRATION)| .package.version' - if [ $? -ne 0 ]; then - echo "Error: Failed to retrieve package version for '$INTEGRATION' in '$AGENT_POLICY'." + + if output=$(curl -s -K /opt/so/conf/elasticsearch/curl.config -L -X GET "localhost:5601/api/fleet/agent_policies/$AGENT_POLICY" --fail); then + if version=$(jq -e -r --arg INTEGRATION "$INTEGRATION" '.item.package_policies[] | select(.name==$INTEGRATION)| .package.version' <<< $output); then + echo "$version" + fi + else + echo "Error: Failed to retrieve agent policy $AGENT_POLICY" exit 1 fi } diff --git a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-integration-upgrade b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-integration-upgrade index 54540ba33..68a644798 100644 --- a/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-integration-upgrade +++ b/salt/elasticfleet/tools/sbin_jinja/so-elastic-fleet-integration-upgrade @@ -34,10 +34,18 @@ for AGENT_POLICY in $agent_policies; do if [[ " ${default_packages[@]} " =~ " $PACKAGE_NAME " ]]; then {%- endif %} # Get currently installed version of package - PACKAGE_VERSION=$(elastic_fleet_integration_policy_package_version "$AGENT_POLICY" "$INTEGRATION") - - # Get latest available version of package - AVAILABLE_VERSION=$(elastic_fleet_package_latest_version_check "$PACKAGE_NAME") + attempt=0 + max_attempts=3 + while [ $attempt -lt $max_attempts ]; do + if PACKAGE_VERSION=$(elastic_fleet_integration_policy_package_version "$AGENT_POLICY" "$INTEGRATION") && AVAILABLE_VERSION=$(elastic_fleet_package_latest_version_check "$PACKAGE_NAME"); then + break + fi + attempt=$((attempt + 1)) + done + if [ $attempt -eq $max_attempts ]; then + echo "Error: Failed getting $PACKAGE_VERSION or $AVAILABLE_VERSION" + exit 1 + fi # Get integration ID INTEGRATION_ID=$(elastic_fleet_integration_id "$AGENT_POLICY" "$INTEGRATION") From 3fc244ee854297e09138954d7a5cf661bd2442e9 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 22 Jul 2025 16:56:51 -0500 Subject: [PATCH 281/303] 8.18.4 --- VERSION | 2 +- salt/elasticsearch/defaults.yaml | 2 +- salt/kibana/defaults.yaml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/VERSION b/VERSION index c3344819a..7d52aac7f 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -2.4.170 \ No newline at end of file +2.4.0-foxtrot diff --git a/salt/elasticsearch/defaults.yaml b/salt/elasticsearch/defaults.yaml index 4046cf146..e08978e0d 100644 --- a/salt/elasticsearch/defaults.yaml +++ b/salt/elasticsearch/defaults.yaml @@ -1,6 +1,6 @@ elasticsearch: enabled: false - version: 8.18.3 + version: 8.18.4 index_clean: true config: action: diff --git a/salt/kibana/defaults.yaml b/salt/kibana/defaults.yaml index a636f9b79..29d9b9bf6 100644 --- a/salt/kibana/defaults.yaml +++ b/salt/kibana/defaults.yaml @@ -22,7 +22,7 @@ kibana: - default - file migrations: - discardCorruptObjects: "8.18.3" + discardCorruptObjects: "8.18.4" telemetry: enabled: False security: From 56748ea6e76fcd83083498206fd9e473cf2ceb21 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 23 Jul 2025 10:16:12 -0400 Subject: [PATCH 282/303] add pack only holding package if installed. remove redundant hold on salt-master package --- salt/salt/master.sls | 5 ----- salt/salt/minion.sls | 13 ++++++++----- 2 files changed, 8 insertions(+), 10 deletions(-) diff --git a/salt/salt/master.sls b/salt/salt/master.sls index fce702932..6486e9126 100644 --- a/salt/salt/master.sls +++ b/salt/salt/master.sls @@ -23,11 +23,6 @@ sync_runners: - name: saltutil.sync_runners {% endif %} -hold_salt_master_package: - module.run: - - pkg.hold: - - name: salt-master - # prior to 2.4.30 this engine ran on the manager with salt-minion # this has changed to running with the salt-master in 2.4.30 remove_engines_config: diff --git a/salt/salt/minion.sls b/salt/salt/minion.sls index b6db9d046..b0e078e79 100644 --- a/salt/salt/minion.sls +++ b/salt/salt/minion.sls @@ -58,12 +58,15 @@ start_minion_post_upgrade: {% endif %} {% if INSTALLEDSALTVERSION|string == SALTVERSION|string %} -# only hold the package if it is already installed -hold_salt_packages: - pkg.held: - - pkgs: + {% for package in SALTPACKAGES %} - - {{ package }}: {{SALTVERSION}}-0.* +# only hold the package if it is already installed +{% if salt['pkg.version'](package) %} +hold_{{ package }}_package: + pkg.held: + - name: {{ package }} + - version: {{SALTVERSION}}-0.* +{% endif %} {% endfor %} remove_error_log_level_logfile: From 2e5682f11c7412342999ebbb0cad1fc4f6ae6935 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 23 Jul 2025 09:53:04 -0500 Subject: [PATCH 283/303] 8.18.4 import evtx pipelines --- .../files/integrations/grid-nodes_general/import-evtx-logs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/elasticfleet/files/integrations/grid-nodes_general/import-evtx-logs.json b/salt/elasticfleet/files/integrations/grid-nodes_general/import-evtx-logs.json index 415e333e7..059e4b8cc 100644 --- a/salt/elasticfleet/files/integrations/grid-nodes_general/import-evtx-logs.json +++ b/salt/elasticfleet/files/integrations/grid-nodes_general/import-evtx-logs.json @@ -20,7 +20,7 @@ ], "data_stream.dataset": "import", "custom": "", - "processors": "- dissect:\n tokenizer: \"/nsm/import/%{import.id}/evtx/%{import.file}\"\n field: \"log.file.path\"\n target_prefix: \"\"\n- decode_json_fields:\n fields: [\"message\"]\n target: \"\"\n- drop_fields:\n fields: [\"host\"]\n ignore_missing: true\n- add_fields:\n target: data_stream\n fields:\n type: logs\n dataset: system.security\n- add_fields:\n target: event\n fields:\n dataset: system.security\n module: system\n imported: true\n- add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.security-2.3.1\n- if:\n equals:\n winlog.channel: 'Microsoft-Windows-Sysmon/Operational'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: windows.sysmon_operational\n - add_fields:\n target: event\n fields:\n dataset: windows.sysmon_operational\n module: windows\n imported: true\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-windows.sysmon_operational-3.0.0\n- if:\n equals:\n winlog.channel: 'Application'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: system.application\n - add_fields:\n target: event\n fields:\n dataset: system.application\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.application-2.3.1\n- if:\n equals:\n winlog.channel: 'System'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: system.system\n - add_fields:\n target: event\n fields:\n dataset: system.system\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.system-2.3.1\n \n- if:\n equals:\n winlog.channel: 'Microsoft-Windows-PowerShell/Operational'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: windows.powershell_operational\n - add_fields:\n target: event\n fields:\n dataset: windows.powershell_operational\n module: windows\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-windows.powershell_operational-3.0.0\n- add_fields:\n target: data_stream\n fields:\n dataset: import", + "processors": "- dissect:\n tokenizer: \"/nsm/import/%{import.id}/evtx/%{import.file}\"\n field: \"log.file.path\"\n target_prefix: \"\"\n- decode_json_fields:\n fields: [\"message\"]\n target: \"\"\n- drop_fields:\n fields: [\"host\"]\n ignore_missing: true\n- add_fields:\n target: data_stream\n fields:\n type: logs\n dataset: system.security\n- add_fields:\n target: event\n fields:\n dataset: system.security\n module: system\n imported: true\n- add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.security-2.3.3\n- if:\n equals:\n winlog.channel: 'Microsoft-Windows-Sysmon/Operational'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: windows.sysmon_operational\n - add_fields:\n target: event\n fields:\n dataset: windows.sysmon_operational\n module: windows\n imported: true\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-windows.sysmon_operational-3.1.0\n- if:\n equals:\n winlog.channel: 'Application'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: system.application\n - add_fields:\n target: event\n fields:\n dataset: system.application\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.application-2.3.3\n- if:\n equals:\n winlog.channel: 'System'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: system.system\n - add_fields:\n target: event\n fields:\n dataset: system.system\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-system.system-2.3.3\n \n- if:\n equals:\n winlog.channel: 'Microsoft-Windows-PowerShell/Operational'\n then: \n - add_fields:\n target: data_stream\n fields:\n dataset: windows.powershell_operational\n - add_fields:\n target: event\n fields:\n dataset: windows.powershell_operational\n module: windows\n - add_fields:\n target: \"@metadata\"\n fields:\n pipeline: logs-windows.powershell_operational-3.1.0\n- add_fields:\n target: data_stream\n fields:\n dataset: import", "tags": [ "import" ] From 7ae0369a3b4542779d553245b9a888d87d71911d Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 23 Jul 2025 09:58:55 -0500 Subject: [PATCH 284/303] VERSION --- VERSION | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VERSION b/VERSION index 7d52aac7f..032d0bb01 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -2.4.0-foxtrot +2.4.170 From e8c25d157fd55c200704030d7c5ded9eb7a714d1 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Wed, 23 Jul 2025 15:52:50 -0500 Subject: [PATCH 285/303] drop empty ip fields when its a opencanary startup log (1001) to prevent elasticsearch doc ingest error --- .../files/integrations/grid-nodes_general/idh-logs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/elasticfleet/files/integrations/grid-nodes_general/idh-logs.json b/salt/elasticfleet/files/integrations/grid-nodes_general/idh-logs.json index db4b1a8f6..9f66c1937 100644 --- a/salt/elasticfleet/files/integrations/grid-nodes_general/idh-logs.json +++ b/salt/elasticfleet/files/integrations/grid-nodes_general/idh-logs.json @@ -19,7 +19,7 @@ ], "data_stream.dataset": "idh", "tags": [], - "processors": "\n- decode_json_fields:\n fields: [\"message\"]\n target: \"\"\n add_error_key: true\n- drop_fields:\n when:\n equals:\n logtype: \"1001\"\n fields: [\"src_host\", \"src_port\", \"dst_host\", \"dst_port\" ]\n ignore_missing: true\n- rename:\n fields:\n - from: \"src_host\"\n to: \"source.ip\"\n - from: \"src_port\"\n to: \"source.port\"\n - from: \"dst_host\"\n to: \"destination.host\"\n - from: \"dst_port\"\n to: \"destination.port\"\n ignore_missing: true\n- convert:\n fields:\n - {from: \"logtype\", to: \"event.code\", type: \"string\"}\n ignore_missing: true\n- drop_fields:\n fields: '[\"prospector\", \"input\", \"offset\", \"beat\"]'\n- add_fields:\n target: event\n fields:\n category: host\n module: opencanary", + "processors": "\n- decode_json_fields:\n fields: [\"message\"]\n target: \"\"\n add_error_key: true\n- convert:\n fields:\n - {from: \"logtype\", to: \"event.code\", type: \"string\"}\n- drop_fields:\n when:\n equals:\n event.code: \"1001\"\n fields: [\"src_host\", \"src_port\", \"dst_host\", \"dst_port\" ]\n ignore_missing: true\n- rename:\n fields:\n - from: \"src_host\"\n to: \"source.ip\"\n - from: \"src_port\"\n to: \"source.port\"\n - from: \"dst_host\"\n to: \"destination.host\"\n - from: \"dst_port\"\n to: \"destination.port\"\n ignore_missing: true\n- drop_fields:\n fields: '[\"prospector\", \"input\", \"offset\", \"beat\"]'\n- add_fields:\n target: event\n fields:\n category: host\n module: opencanary", "custom": "pipeline: common" } } From 84b38daf6282b0e7053da7ba906eb373d0d01454 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Fri, 25 Jul 2025 16:17:22 -0500 Subject: [PATCH 286/303] name destination_geo & source_geo to destination.as and source.as better aligning with ECS and linking other log sources already using .as for ASN geo data. Signed-off-by: reyesj2 <94730068+reyesj2@users.noreply.github.com> --- salt/common/tools/sbin_jinja/so-import-pcap | 2 +- .../elasticsearch/files/ingest-dynamic/common | 8 ++- salt/soc/defaults.yaml | 68 +++++++++---------- salt/soc/files/soc/motd.md | 2 +- 4 files changed, 42 insertions(+), 38 deletions(-) diff --git a/salt/common/tools/sbin_jinja/so-import-pcap b/salt/common/tools/sbin_jinja/so-import-pcap index 5f2370a4a..e8c2b84c8 100755 --- a/salt/common/tools/sbin_jinja/so-import-pcap +++ b/salt/common/tools/sbin_jinja/so-import-pcap @@ -248,7 +248,7 @@ fi START_OLDEST_SLASH=$(echo $START_OLDEST | sed -e 's/-/%2F/g') END_NEWEST_SLASH=$(echo $END_NEWEST | sed -e 's/-/%2F/g') if [[ $VALID_PCAPS_COUNT -gt 0 ]] || [[ $SKIPPED_PCAPS_COUNT -gt 0 ]]; then - URL="https://{{ URLBASE }}/#/dashboards?q=$HASH_FILTERS%20%7C%20groupby%20event.module*%20%7C%20groupby%20-sankey%20event.module*%20event.dataset%20%7C%20groupby%20event.dataset%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20network.protocol%20%7C%20groupby%20rule.name%20rule.category%20event.severity_label%20%7C%20groupby%20dns.query.name%20%7C%20groupby%20file.mime_type%20%7C%20groupby%20http.virtual_host%20http.uri%20%7C%20groupby%20notice.note%20notice.message%20notice.sub_message%20%7C%20groupby%20ssl.server_name%20%7C%20groupby%20source_geo.organization_name%20source.geo.country_name%20%7C%20groupby%20destination_geo.organization_name%20destination.geo.country_name&t=${START_OLDEST_SLASH}%2000%3A00%3A00%20AM%20-%20${END_NEWEST_SLASH}%2000%3A00%3A00%20AM&z=UTC" + URL="https://{{ URLBASE }}/#/dashboards?q=$HASH_FILTERS%20%7C%20groupby%20event.module*%20%7C%20groupby%20-sankey%20event.module*%20event.dataset%20%7C%20groupby%20event.dataset%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20network.protocol%20%7C%20groupby%20rule.name%20rule.category%20event.severity_label%20%7C%20groupby%20dns.query.name%20%7C%20groupby%20file.mime_type%20%7C%20groupby%20http.virtual_host%20http.uri%20%7C%20groupby%20notice.note%20notice.message%20notice.sub_message%20%7C%20groupby%20ssl.server_name%20%7C%20groupby%20source.as.organization.name%20source.geo.country_name%20%7C%20groupby%20destination.as.organization.name%20destination.geo.country_name&t=${START_OLDEST_SLASH}%2000%3A00%3A00%20AM%20-%20${END_NEWEST_SLASH}%2000%3A00%3A00%20AM&z=UTC" status "Import complete!" status diff --git a/salt/elasticsearch/files/ingest-dynamic/common b/salt/elasticsearch/files/ingest-dynamic/common index e84702909..814d8d4d5 100644 --- a/salt/elasticsearch/files/ingest-dynamic/common +++ b/salt/elasticsearch/files/ingest-dynamic/common @@ -26,7 +26,7 @@ { "geoip": { "field": "destination.ip", - "target_field": "destination_geo", + "target_field": "destination.as", "database_file": "GeoLite2-ASN.mmdb", "ignore_missing": true, "ignore_failure": true, @@ -36,13 +36,17 @@ { "geoip": { "field": "source.ip", - "target_field": "source_geo", + "target_field": "source.as", "database_file": "GeoLite2-ASN.mmdb", "ignore_missing": true, "ignore_failure": true, "properties": ["ip", "asn", "organization_name", "network"] } }, + { "rename": { "field": "destination.as.organization_name", "target_field": "destination.as.organization.name", "ignore_failure": true, "ignore_missing": true } }, + { "rename": { "field": "source.as.organization_name", "target_field": "source.as.organization.name", "ignore_failure": true, "ignore_missing": true } }, + { "rename": { "field": "destination.as.asn", "target_field": "destination.as.number", "ignore_failure": true, "ignore_missing": true } }, + { "rename": { "field": "source.as.asn", "target_field": "source.as.number", "ignore_failure": true, "ignore_missing": true } }, { "set": { "if": "ctx.event?.severity == 1", "field": "event.severity_label", "value": "low", "override": true } }, { "set": { "if": "ctx.event?.severity == 2", "field": "event.severity_label", "value": "medium", "override": true } }, { "set": { "if": "ctx.event?.severity == 3", "field": "event.severity_label", "value": "high", "override": true } }, diff --git a/salt/soc/defaults.yaml b/salt/soc/defaults.yaml index ad7d51f68..0e3e50240 100644 --- a/salt/soc/defaults.yaml +++ b/salt/soc/defaults.yaml @@ -10,7 +10,7 @@ soc: icon: fa-crosshairs target: links: - - '/#/hunt?q="{value|escape}" | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source_geo.organization_name source.geo.country_name | groupby destination_geo.organization_name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' + - '/#/hunt?q="{value|escape}" | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source.as.organization.name source.geo.country_name | groupby destination.as.organization.name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' - name: actionAddToCase description: actionAddToCaseHelp icon: fa-briefcase @@ -24,13 +24,13 @@ soc: icon: fa-magnifying-glass-arrow-right target: '' links: - - '/#/hunt?q=("{:log.id.fuid}" OR "{:log.id.uid}" OR "{:network.community_id}") | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source_geo.organization_name source.geo.country_name | groupby destination_geo.organization_name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' - - '/#/hunt?q=("{:log.id.fuid}" OR "{:log.id.uid}") | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source_geo.organization_name source.geo.country_name | groupby destination_geo.organization_name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' - - '/#/hunt?q=("{:log.id.fuid}" OR "{:network.community_id}") | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source_geo.organization_name source.geo.country_name | groupby destination_geo.organization_name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' - - '/#/hunt?q=("{:log.id.uid}" OR "{:network.community_id}") | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source_geo.organization_name source.geo.country_name | groupby destination_geo.organization_name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' - - '/#/hunt?q="{:log.id.fuid}" | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source_geo.organization_name source.geo.country_name | groupby destination_geo.organization_name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' - - '/#/hunt?q="{:log.id.uid}" | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source_geo.organization_name source.geo.country_name | groupby destination_geo.organization_name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' - - '/#/hunt?q="{:network.community_id}" | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source_geo.organization_name source.geo.country_name | groupby destination_geo.organization_name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' + - '/#/hunt?q=("{:log.id.fuid}" OR "{:log.id.uid}" OR "{:network.community_id}") | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source.as.organization.name source.geo.country_name | groupby destination.as.organization.name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' + - '/#/hunt?q=("{:log.id.fuid}" OR "{:log.id.uid}") | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source.as.organization.name source.geo.country_name | groupby destination.as.organization.name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' + - '/#/hunt?q=("{:log.id.fuid}" OR "{:network.community_id}") | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source.as.organization.name source.geo.country_name | groupby destination.as.organization.name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' + - '/#/hunt?q=("{:log.id.uid}" OR "{:network.community_id}") | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source.as.organization.name source.geo.country_name | groupby destination.as.organization.name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' + - '/#/hunt?q="{:log.id.fuid}" | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source.as.organization.name source.geo.country_name | groupby destination.as.organization.name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' + - '/#/hunt?q="{:log.id.uid}" | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source.as.organization.name source.geo.country_name | groupby destination.as.organization.name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' + - '/#/hunt?q="{:network.community_id}" | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip source.port destination.ip destination.port | groupby network.protocol | groupby source.as.organization.name source.geo.country_name | groupby destination.as.organization.name destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby file.mime_type | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby ssl.server_name | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid&gridId={gridId}' - name: actionPcap description: actionPcapHelp icon: fa-stream @@ -1928,10 +1928,10 @@ soc: query: 'event.dataset:kratos.audit AND msg:*Encountered*self-service*login*error* | groupby user.name | groupby http_request.headers.x-real-ip | groupby -sankey http_request.headers.x-real-ip http_request.headers.user-agent | groupby http_request.headers.user-agent' - name: Alerts description: Overview of all alerts - query: 'tags:alert | groupby event.module* | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby rule.name | groupby event.severity | groupby destination_geo.organization_name' + query: 'tags:alert | groupby event.module* | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby rule.name | groupby event.severity | groupby destination.as.organization.name' - name: NIDS Alerts description: NIDS (Network Intrusion Detection System) alerts - query: 'event.category:network AND tags:alert | groupby rule.category | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby rule.name | groupby rule.uuid | groupby rule.gid | groupby destination_geo.organization_name' + query: 'event.category:network AND tags:alert | groupby rule.category | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby rule.name | groupby rule.uuid | groupby rule.gid | groupby destination.as.organization.name' - name: Elastic Agent Overview description: Overview of all events from Elastic Agents query: 'event.module:endpoint | groupby event.dataset | groupby host.name | groupby -sankey host.name user.name | groupby user.name | groupby -sankey user.name process.name | groupby process.name' @@ -1982,34 +1982,34 @@ soc: query: 'event.module:strelka | groupby file.mime_type | groupby -sankey file.mime_type file.source | groupby file.source | groupby -sankey file.source file.name | groupby file.name' - name: Zeek Notice description: Zeek notice logs - query: 'event.dataset:zeek.notice | groupby notice.note | groupby -sankey notice.note source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby notice.message | groupby notice.sub_message | groupby source_geo.organization_name | groupby destination_geo.organization_name' + query: 'event.dataset:zeek.notice | groupby notice.note | groupby -sankey notice.note source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby notice.message | groupby notice.sub_message | groupby source.as.organization.name | groupby destination.as.organization.name' - name: Connections and Metadata with Community ID description: Network connections that include network.community_id - query: '_exists_:network.community_id | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip | groupby destination.ip | groupby destination.port | groupby network.protocol | groupby source_geo.organization_name | groupby source.geo.country_name | groupby destination_geo.organization_name | groupby destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid' + query: '_exists_:network.community_id | groupby event.module* | groupby -sankey event.module* event.dataset | groupby event.dataset | groupby source.ip | groupby destination.ip | groupby destination.port | groupby network.protocol | groupby source.as.organization.name | groupby source.geo.country_name | groupby destination.as.organization.name | groupby destination.geo.country_name | groupby rule.name rule.category event.severity_label | groupby dns.query.name | groupby http.virtual_host http.uri | groupby notice.note notice.message notice.sub_message | groupby source.ip host.hostname user.name event.action event.type process.executable process.pid' - name: Connections seen by Zeek or Suricata description: Network connections logged by Zeek or Suricata query: 'tags:conn | groupby source.ip | groupby destination.ip | groupby destination.port | groupby -sankey destination.port network.protocol | groupby network.protocol | groupby network.transport | groupby connection.history | groupby connection.state | groupby connection.state_description | groupby source.geo.country_name | groupby destination.geo.country_name | groupby client.ip_bytes | groupby server.ip_bytes | groupby client.oui' - name: DCE_RPC description: DCE_RPC (Distributed Computing Environment / Remote Procedure Calls) network metadata - query: 'tags:dce_rpc | groupby dce_rpc.endpoint | groupby -sankey dce_rpc.endpoint dce_rpc.operation | groupby dce_rpc.operation | groupby -sankey dce_rpc.operation dce_rpc.named_pipe | groupby dce_rpc.named_pipe | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name' + query: 'tags:dce_rpc | groupby dce_rpc.endpoint | groupby -sankey dce_rpc.endpoint dce_rpc.operation | groupby dce_rpc.operation | groupby -sankey dce_rpc.operation dce_rpc.named_pipe | groupby dce_rpc.named_pipe | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name' - name: DHCP description: DHCP (Dynamic Host Configuration Protocol) leases query: 'tags:dhcp | groupby host.hostname | groupby -sankey host.hostname client.address | groupby client.address | groupby -sankey client.address server.address | groupby server.address | groupby dhcp.message_types | groupby host.domain' - name: DNS description: DNS (Domain Name System) queries - query: 'tags:dns | groupby dns.query.name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby dns.highest_registered_domain | groupby dns.parent_domain | groupby dns.query.type_name | groupby dns.response.code_name | groupby dns.answers.name | groupby destination_geo.organization_name' + query: 'tags:dns | groupby dns.query.name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby dns.highest_registered_domain | groupby dns.parent_domain | groupby dns.query.type_name | groupby dns.response.code_name | groupby dns.answers.name | groupby destination.as.organization.name' - name: DPD description: DPD (Dynamic Protocol Detection) errors - query: 'tags:dpd | groupby error.reason | groupby -sankey error.reason source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby network.protocol | groupby destination_geo.organization_name' + query: 'tags:dpd | groupby error.reason | groupby -sankey error.reason source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby network.protocol | groupby destination.as.organization.name' - name: Files description: Files seen in network traffic - query: 'tags:file | groupby file.mime_type | groupby -sankey file.mime_type file.source | groupby file.source | groupby file.bytes.total | groupby source.ip | groupby destination.ip | groupby destination_geo.organization_name' + query: 'tags:file | groupby file.mime_type | groupby -sankey file.mime_type file.source | groupby file.source | groupby file.bytes.total | groupby source.ip | groupby destination.ip | groupby destination.as.organization.name' - name: FTP description: FTP (File Transfer Protocol) network metadata - query: 'tags:ftp | groupby ftp.command | groupby -sankey ftp.command source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name | groupby ftp.argument | groupby ftp.user' + query: 'tags:ftp | groupby ftp.command | groupby -sankey ftp.command source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name | groupby ftp.argument | groupby ftp.user' - name: HTTP description: HTTP (Hyper Text Transport Protocol) network metadata - query: '(tags:http OR tags:http2) | groupby http.method | groupby -sankey http.method http.virtual_host | groupby http.virtual_host | groupby http.uri | groupby http.useragent | groupby http.status_code | groupby http.status_message | groupby file.resp_mime_types | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name' + query: '(tags:http OR tags:http2) | groupby http.method | groupby -sankey http.method http.virtual_host | groupby http.virtual_host | groupby http.uri | groupby http.useragent | groupby http.status_code | groupby http.status_message | groupby file.resp_mime_types | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name' - name: Intel description: Zeek Intel framework hits query: 'tags:intel | groupby intel.indicator | groupby -sankey intel.indicator source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby intel.indicator_type | groupby intel.seen_where' @@ -2018,7 +2018,7 @@ soc: query: 'tags:ipsec | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.geo.country_name | groupby ipsec.version' - name: IRC description: IRC (Internet Relay Chat) network metadata - query: 'tags:irc | groupby irc.command.type | groupby -sankey irc.command.type irc.username | groupby irc.username | groupby irc.nickname | groupby irc.command.value | groupby irc.command.info | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name' + query: 'tags:irc | groupby irc.command.type | groupby -sankey irc.command.type irc.username | groupby irc.username | groupby irc.nickname | groupby irc.command.value | groupby irc.command.info | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name' - name: Kerberos description: Kerberos network metadata query: 'tags:kerberos | groupby kerberos.service | groupby -sankey kerberos.service source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby kerberos.client | groupby kerberos.request_type' @@ -2042,22 +2042,22 @@ soc: query: 'tags:pe | groupby file.machine | groupby -sankey file.machine file.os | groupby file.os | groupby -sankey file.os file.subsystem | groupby file.subsystem | groupby file.section_names | groupby file.is_exe | groupby file.is_64bit' - name: QUIC description: QUIC network metadata - query: 'tags:quic | groupby quic.server_name | groupby -sankey quic.server_name source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name | groupby quic.server_scid | groupby quic.version | groupby quic.client_protocol' + query: 'tags:quic | groupby quic.server_name | groupby -sankey quic.server_name source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name | groupby quic.server_scid | groupby quic.version | groupby quic.client_protocol' - name: RADIUS description: RADIUS (Remote Authentication Dial-In User Service) network metadata - query: 'tags:radius | groupby user.name | groupby -sankey user.name source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name' + query: 'tags:radius | groupby user.name | groupby -sankey user.name source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name' - name: RDP description: RDP (Remote Desktop Protocol) network metadata - query: 'tags:rdp | groupby client.name | groupby -sankey client.name source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name' + query: 'tags:rdp | groupby client.name | groupby -sankey client.name source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name' - name: RFB description: RFB (Remote Frame Buffer) network metadata - query: 'tags:rfb | groupby rfb.desktop.name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name' + query: 'tags:rfb | groupby rfb.desktop.name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name' - name: Signatures description: Zeek signatures query: 'event.dataset:zeek.signatures | groupby signature_id' - name: SIP description: SIP (Session Initiation Protocol) network metadata - query: 'tags:sip | groupby sip.method | groupby -sankey sip.method source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name | groupby client.user_agent | groupby sip.method | groupby sip.uri' + query: 'tags:sip | groupby sip.method | groupby -sankey sip.method source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name | groupby client.user_agent | groupby sip.method | groupby sip.uri' - name: SMB_Files description: Files transferred via SMB (Server Message Block) query: 'tags:smb_files | groupby file.action | groupby -sankey file.action source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby file.path | groupby file.name' @@ -2066,7 +2066,7 @@ soc: query: 'tags:smb_mapping | groupby smb.share_type | groupby -sankey smb.share_type smb.path | groupby smb.path | groupby -sankey smb.path smb.service | groupby smb.service | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port' - name: SMTP description: SMTP (Simple Mail Transfer Protocol) network metadata - query: 'tags:smtp | groupby smtp.mail_from | groupby -sankey smtp.mail_from smtp.recipient_to | groupby smtp.recipient_to | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby smtp.subject | groupby destination_geo.organization_name' + query: 'tags:smtp | groupby smtp.mail_from | groupby -sankey smtp.mail_from smtp.recipient_to | groupby smtp.recipient_to | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby smtp.subject | groupby destination.as.organization.name' - name: SNMP description: SNMP (Simple Network Management Protocol) network metadat query: 'tags:snmp | groupby snmp.community | groupby -sankey snmp.community source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby snmp.version' @@ -2075,16 +2075,16 @@ soc: query: 'tags:software | groupby software.type | groupby -sankey software.type source.ip | groupby source.ip | groupby software.name' - name: SSH description: SSH (Secure Shell) connections seen by Zeek - query: 'tags:ssh | groupby ssh.client | groupby -sankey ssh.client source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby ssh.server | groupby ssh.version | groupby ssh.hassh_version | groupby ssh.direction | groupby source_geo.organization_name | groupby destination_geo.organization_name' + query: 'tags:ssh | groupby ssh.client | groupby -sankey ssh.client source.ip | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby ssh.server | groupby ssh.version | groupby ssh.hassh_version | groupby ssh.direction | groupby source.as.organization.name | groupby destination.as.organization.name' - name: SSL description: SSL/TLS network metadata - query: 'tags:ssl | groupby ssl.version | groupby -sankey ssl.version ssl.server_name | groupby ssl.server_name | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name' + query: 'tags:ssl | groupby ssl.version | groupby -sankey ssl.version ssl.server_name | groupby ssl.server_name | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name' - name: SSL - Suricata description: SSL/TLS network metadata from Suricata - query: 'event.dataset:suricata.ssl | groupby ssl.version | groupby -sankey ssl.version ssl.server_name | groupby ssl.server_name | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name | groupby ssl.certificate.issuer | groupby ssl.certificate.subject' + query: 'event.dataset:suricata.ssl | groupby ssl.version | groupby -sankey ssl.version ssl.server_name | groupby ssl.server_name | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name | groupby ssl.certificate.issuer | groupby ssl.certificate.subject' - name: SSL - Zeek description: SSL/TLS network metadata from Zeek - query: 'event.dataset:zeek.ssl | groupby ssl.version | groupby ssl.validation_status | groupby -sankey ssl.validation_status ssl.server_name | groupby ssl.server_name | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name' + query: 'event.dataset:zeek.ssl | groupby ssl.version | groupby ssl.validation_status | groupby -sankey ssl.validation_status ssl.server_name | groupby ssl.server_name | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name' - name: STUN description: STUN (Session Traversal Utilities for NAT) network metadata query: 'tags:stun* | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.geo.country_name | groupby stun.class | groupby -sankey stun.class stun.method | groupby stun.method | groupby stun.attribute.types' @@ -2099,7 +2099,7 @@ soc: query: 'tags:tunnel | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby tunnel.type | groupby event.action | groupby destination.geo.country_name' - name: Weird description: Weird network traffic seen by Zeek - query: 'event.dataset:zeek.weird | groupby weird.name | groupby -sankey weird.name source.ip | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name' + query: 'event.dataset:zeek.weird | groupby weird.name | groupby -sankey weird.name source.ip | groupby source.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name' - name: WireGuard description: WireGuard VPN network metadata query: 'tags:wireguard | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.geo.country_name' @@ -2147,16 +2147,16 @@ soc: query: '* AND _exists_:network.vlan.id | groupby network.vlan.id | groupby -sankey network.vlan.id source.ip | groupby source.ip | groupby destination.ip | groupby destination.port | groupby event.dataset | groupby event.module | groupby observer.name | groupby source.geo.country_name | groupby destination.geo.country_name' - name: GeoIP - Destination Countries description: GeoIP tagged logs visualized by destination countries - query: '* AND _exists_:destination.geo.country_name | groupby destination.geo.country_name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination_geo.organization_name | groupby event.dataset | groupby event.module' + query: '* AND _exists_:destination.geo.country_name | groupby destination.geo.country_name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.as.organization.name | groupby event.dataset | groupby event.module' - name: GeoIP - Destination Organizations description: GeoIP tagged logs visualized by destination organizations - query: '* AND _exists_:destination_geo.organization_name | groupby destination_geo.organization_name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.geo.country_name | groupby event.dataset | groupby event.module' + query: '* AND _exists_:destination.as.organization.name | groupby destination.as.organization.name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby destination.geo.country_name | groupby event.dataset | groupby event.module' - name: GeoIP - Source Countries description: GeoIP tagged logs visualized by source countries - query: '* AND _exists_:source.geo.country_name | groupby source.geo.country_name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby source_geo.organization_name | groupby event.dataset | groupby event.module' + query: '* AND _exists_:source.geo.country_name | groupby source.geo.country_name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby source.as.organization.name | groupby event.dataset | groupby event.module' - name: GeoIP - Source Organizations description: GeoIP tagged logs visualized by source organizations - query: '* AND _exists_:source_geo.organization_name | groupby source_geo.organization_name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby source.geo.country_name | groupby event.dataset | groupby event.module' + query: '* AND _exists_:source.as.organization.name | groupby source.as.organization.name | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby source.geo.country_name | groupby event.dataset | groupby event.module' - name: NetFlow description: NetFlow records query: 'event.module:netflow | groupby source.ip | groupby -sankey source.ip destination.ip | groupby destination.ip | groupby destination.port | groupby network.type | groupby network.transport | groupby network.direction | groupby netflow.type | groupby netflow.exporter.version | groupby observer.ip | groupby source.as.organization.name | groupby source.geo.country_name | groupby destination.as.organization.name | groupby destination.geo.country_name' diff --git a/salt/soc/files/soc/motd.md b/salt/soc/files/soc/motd.md index 91c603851..69b3145fa 100644 --- a/salt/soc/files/soc/motd.md +++ b/salt/soc/files/soc/motd.md @@ -6,7 +6,7 @@ If you're ready to dive in, take a look at the [Alerts](/#/alerts) interface to Next, go to the [Dashboards](/#/dashboards) interface for a general overview of all logs collected. Here are a few overview dashboards to get you started: -[Overview Dashboard](/#/dashboards) | [Elastic Agent Overview](/#/dashboards?q=event.module%3Aendpoint%20%7C%20groupby%20event.dataset%20%7C%20groupby%20host.name%20%7C%20groupby%20-sankey%20host.name%20user.name%20%7C%20groupby%20user.name%20%7C%20groupby%20-sankey%20user.name%20process.name%20%7C%20groupby%20process.name) | [Network Connection Overview](/#/dashboards?q=tags%3Aconn%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20-sankey%20destination.port%20network.protocol%20%7C%20groupby%20network.protocol%20%7C%20groupby%20network.transport%20%7C%20groupby%20connection.history%20%7C%20groupby%20connection.state%20%7C%20groupby%20connection.state_description%20%7C%20groupby%20source.geo.country_name%20%7C%20groupby%20destination.geo.country_name%20%7C%20groupby%20client.ip_bytes%20%7C%20groupby%20server.ip_bytes%20%7C%20groupby%20client.oui) | [DNS](/#/dashboards?q=tags%3Adns%20%7C%20groupby%20dns.query.name%20%7C%20groupby%20source.ip%20%7C%20groupby%20-sankey%20source.ip%20destination.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20dns.highest_registered_domain%20%7C%20groupby%20dns.parent_domain%20%7C%20groupby%20dns.query.type_name%20%7C%20groupby%20dns.response.code_name%20%7C%20groupby%20dns.answers.name%20%7C%20groupby%20destination_geo.organization_name) | [Files](/#/dashboards?q=tags%3Afile%20%7C%20groupby%20file.mime_type%20%7C%20groupby%20-sankey%20file.mime_type%20file.source%20%7C%20groupby%20file.source%20%7C%20groupby%20file.bytes.total%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination_geo.organization_name) | [HTTP](/#/dashboards?q=tags%3Ahttp%20%7C%20groupby%20http.method%20%7C%20groupby%20-sankey%20http.method%20http.virtual_host%20%7C%20groupby%20http.virtual_host%20%7C%20groupby%20http.uri%20%7C%20groupby%20http.useragent%20%7C%20groupby%20http.status_code%20%7C%20groupby%20http.status_message%20%7C%20groupby%20file.resp_mime_types%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20destination_geo.organization_name) | [SSL](/#/dashboards?q=tags%3Assl%20%7C%20groupby%20ssl.version%20%7C%20groupby%20-sankey%20ssl.version%20ssl.server_name%20%7C%20groupby%20ssl.server_name%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20destination_geo.organization_name) +[Overview Dashboard](/#/dashboards) | [Elastic Agent Overview](/#/dashboards?q=event.module%3Aendpoint%20%7C%20groupby%20event.dataset%20%7C%20groupby%20host.name%20%7C%20groupby%20-sankey%20host.name%20user.name%20%7C%20groupby%20user.name%20%7C%20groupby%20-sankey%20user.name%20process.name%20%7C%20groupby%20process.name) | [Network Connection Overview](/#/dashboards?q=tags%3Aconn%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20-sankey%20destination.port%20network.protocol%20%7C%20groupby%20network.protocol%20%7C%20groupby%20network.transport%20%7C%20groupby%20connection.history%20%7C%20groupby%20connection.state%20%7C%20groupby%20connection.state_description%20%7C%20groupby%20source.geo.country_name%20%7C%20groupby%20destination.geo.country_name%20%7C%20groupby%20client.ip_bytes%20%7C%20groupby%20server.ip_bytes%20%7C%20groupby%20client.oui) | [DNS](/#/dashboards?q=tags%3Adns%20%7C%20groupby%20dns.query.name%20%7C%20groupby%20source.ip%20%7C%20groupby%20-sankey%20source.ip%20destination.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20dns.highest_registered_domain%20%7C%20groupby%20dns.parent_domain%20%7C%20groupby%20dns.query.type_name%20%7C%20groupby%20dns.response.code_name%20%7C%20groupby%20dns.answers.name%20%7C%20groupby%20destination.as.organization.name) | [Files](/#/dashboards?q=tags%3Afile%20%7C%20groupby%20file.mime_type%20%7C%20groupby%20-sankey%20file.mime_type%20file.source%20%7C%20groupby%20file.source%20%7C%20groupby%20file.bytes.total%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.as.organization.name) | [HTTP](/#/dashboards?q=tags%3Ahttp%20%7C%20groupby%20http.method%20%7C%20groupby%20-sankey%20http.method%20http.virtual_host%20%7C%20groupby%20http.virtual_host%20%7C%20groupby%20http.uri%20%7C%20groupby%20http.useragent%20%7C%20groupby%20http.status_code%20%7C%20groupby%20http.status_message%20%7C%20groupby%20file.resp_mime_types%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20destination.as.organization.name) | [SSL](/#/dashboards?q=tags%3Assl%20%7C%20groupby%20ssl.version%20%7C%20groupby%20-sankey%20ssl.version%20ssl.server_name%20%7C%20groupby%20ssl.server_name%20%7C%20groupby%20source.ip%20%7C%20groupby%20destination.ip%20%7C%20groupby%20destination.port%20%7C%20groupby%20destination.as.organization.name) Click the drop-down menu in Dashboards to find many more dashboards. You might also want to explore the [Hunt](/#/hunt) interface for more focused threat hunting. From d49cd3cb85583c4aebecf7323976808168830aae Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Mon, 28 Jul 2025 15:14:12 -0500 Subject: [PATCH 287/303] increased timeout for so-elasticsearch-roles-load from default of 30s --- salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load b/salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load index 90b262989..93f9d88c2 100755 --- a/salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load +++ b/salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load @@ -21,7 +21,7 @@ while [[ "$COUNT" -le 240 ]]; do ELASTICSEARCH_CONNECTED="yes" echo "connected!" # Check cluster health once connected - so-elasticsearch-query _cluster/health?wait_for_status=yellow > /dev/null 2>&1 + so-elasticsearch-query _cluster/health?wait_for_status=yellow\&timeout=600s > /dev/null 2>&1 break else ((COUNT+=1)) From fbf5bafae760c37eb452bf5642b41394d891a93a Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Mon, 28 Jul 2025 15:17:04 -0500 Subject: [PATCH 288/303] set 2m timeout --- salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load b/salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load index 93f9d88c2..d1111fe2f 100755 --- a/salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load +++ b/salt/elasticsearch/tools/sbin/so-elasticsearch-roles-load @@ -21,7 +21,7 @@ while [[ "$COUNT" -le 240 ]]; do ELASTICSEARCH_CONNECTED="yes" echo "connected!" # Check cluster health once connected - so-elasticsearch-query _cluster/health?wait_for_status=yellow\&timeout=600s > /dev/null 2>&1 + so-elasticsearch-query _cluster/health?wait_for_status=yellow\&timeout=120s > /dev/null 2>&1 break else ((COUNT+=1)) From 07305d87992a83ab343aebe13080510d3f4eda26 Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 29 Jul 2025 14:15:43 -0500 Subject: [PATCH 289/303] only show data nodes in disk usage output --- salt/elasticsearch/tools/sbin/so-elasticsearch-troubleshoot | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/salt/elasticsearch/tools/sbin/so-elasticsearch-troubleshoot b/salt/elasticsearch/tools/sbin/so-elasticsearch-troubleshoot index b6b201c3c..1f59610e9 100644 --- a/salt/elasticsearch/tools/sbin/so-elasticsearch-troubleshoot +++ b/salt/elasticsearch/tools/sbin/so-elasticsearch-troubleshoot @@ -121,7 +121,7 @@ watermark_settings() { return 1 fi - if ! disk_allocation_output=$(so-elasticsearch-query _cat/nodes?v\&h=name,ip,disk.used_percent,disk.avail,disk.total\&format=json --fail 2>/dev/null); then + if ! disk_allocation_output=$(so-elasticsearch-query _cat/nodes?v\&h=name,ip,disk.used_percent,disk.avail,disk.total,node.role\&format=json --fail 2>/dev/null); then log_title "ERROR" "Failed to retrieve disk allocation data from Elasticsearch" return 1 fi @@ -139,7 +139,8 @@ watermark_settings() { log_title "LOG" "Disk Usage Check" echo -e "${BOLD}LOW:${GREEN}$low${NC}${BOLD} HIGH:${YELLOW}${high}${NC}${BOLD} FLOOD:${RED}${flood}${NC}\n" - echo "$disk_allocation_output" | jq -r '.[] | "\(.name)|\(.["disk.used_percent"])"' | while IFS='|' read -r node_name disk_used; do + # Only show data nodes (d=data, h=hot, w=warm, c=cold, f=frozen, s=content) + echo "$disk_allocation_output" | jq -r '.[] | select(.["node.role"] | test("[dhwcfs]")) | "\(.name)|\(.["disk.used_percent"])"' | while IFS='|' read -r node_name disk_used; do disk_used_num=$(echo $disk_used | bc) if (( $(echo "$disk_used_num >= $flood_num" | bc -l) )); then From adb1e01c7aa07e2a9b9d3fedc687ff78571bb0fd Mon Sep 17 00:00:00 2001 From: reyesj2 <94730068+reyesj2@users.noreply.github.com> Date: Tue, 29 Jul 2025 15:31:53 -0500 Subject: [PATCH 290/303] exclude so_agent_installer dir from config backups --- salt/backup/tools/sbin/so-config-backup.jinja | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/salt/backup/tools/sbin/so-config-backup.jinja b/salt/backup/tools/sbin/so-config-backup.jinja index 23e407653..7f65bbba3 100755 --- a/salt/backup/tools/sbin/so-config-backup.jinja +++ b/salt/backup/tools/sbin/so-config-backup.jinja @@ -11,6 +11,10 @@ TODAY=$(date '+%Y_%m_%d') BACKUPDIR={{ DESTINATION }} BACKUPFILE="$BACKUPDIR/so-config-backup-$TODAY.tar" MAXBACKUPS=7 +EXCLUSIONS=( + "--exclude=/opt/so/saltstack/local/salt/elasticfleet/files/so_agent-installers" +) + # Create backup dir if it does not exist mkdir -p /nsm/backup @@ -23,7 +27,7 @@ if [ ! -f $BACKUPFILE ]; then # Loop through all paths defined in global.sls, and append them to backup file {%- for LOCATION in BACKUPLOCATIONS %} - tar -rf $BACKUPFILE {{ LOCATION }} + tar -rf $BACKUPFILE "${EXCLUSIONS[@]}" {{ LOCATION }} {%- endfor %} fi From c98042fa80fb621aa1bc99300ac367a3701126c6 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 30 Jul 2025 09:44:58 -0400 Subject: [PATCH 291/303] match user soqemussh for ssh config. allow for user edits to not be overwritten in ssh config. --- salt/libvirt/ssh/files/config | 2 +- salt/libvirt/ssh/users.sls | 11 +++++++++-- 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/salt/libvirt/ssh/files/config b/salt/libvirt/ssh/files/config index 360d5c182..de6cb7b34 100644 --- a/salt/libvirt/ssh/files/config +++ b/salt/libvirt/ssh/files/config @@ -1,2 +1,2 @@ -Host * +Match user soqemussh IdentityFile /etc/ssh/auth_keys/soqemussh/id_ed25519 diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls index 0e9c045a0..173a3e095 100644 --- a/salt/libvirt/ssh/users.sls +++ b/salt/libvirt/ssh/users.sls @@ -16,10 +16,17 @@ {% if GLOBALS.is_manager %} -qemu_ssh_client_config: - file.managed: +root_ssh_config: + file.touch: - name: /root/.ssh/config + +qemu_ssh_client_config: + file.blockreplace: + - name: /root/.ssh/config + - marker_start: "# START of block managed by Salt - soqemussh config" + - marker_end: "# END of block managed by Salt - soqemussh config" - source: salt://libvirt/ssh/files/config + - prepend_if_not_found: True {% endif %} From 7b5980bfe54e9bbc73e1f871296ab5e7e0bae205 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 30 Jul 2025 16:04:10 -0400 Subject: [PATCH 292/303] setup bridge for hypervisor using $MNIC --- setup/so-functions | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/setup/so-functions b/setup/so-functions index c2eb0b349..91d717c11 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -1187,14 +1187,18 @@ get_minion_type() { } hypervisor_local_states() { - # these states need to run before the first highstate so that we dont deal with the salt-minion restarting - # and we need these setup prior to the highstate - if [ $is_hypervisor ] || [ $is_managerhype ]; then - salt-call state.apply libvirt.64962 --local --file-root=../salt/ -l info - salt-call state.apply libvirt.bridge --local --file-root=../salt/ -l info pillar='{"host": {"mainint": "enp1s0"}}' - fi + # these states need to run before the first highstate so that we dont deal with the salt-minion restarting + # and we need these setup prior to the highstate + info "Check if hypervisor or managerhype" + if [ $is_hypervisor ] || [ $is_managerhype ]; then + info "Running libvirt states for hypervisor" + logCmd "salt-call state.apply libvirt.64962 --local --file-root=../salt/ -l info" + info "Setting up bridge for $MNIC" + salt-call state.apply libvirt.bridge --local --file-root=../salt/ -l info pillar="{\"host\": {\"mainint\": \"$MNIC\"}}" + fi } + install_cleanup() { if [ -f "$temp_install_dir" ]; then info "Installer removing the following files:" From 8720a4540a4cfa8dade196554609fd6dd1ae74c0 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 30 Jul 2025 16:36:40 -0400 Subject: [PATCH 293/303] remove extra line --- setup/so-functions | 1 - 1 file changed, 1 deletion(-) diff --git a/setup/so-functions b/setup/so-functions index 91d717c11..522446be4 100755 --- a/setup/so-functions +++ b/setup/so-functions @@ -1198,7 +1198,6 @@ hypervisor_local_states() { fi } - install_cleanup() { if [ -f "$temp_install_dir" ]; then info "Installer removing the following files:" From 15cbc626c4fba7a3c9f91bf4fddba548436c340c Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Wed, 30 Jul 2025 16:37:19 -0400 Subject: [PATCH 294/303] resolve for already configured RAID --- salt/hypervisor/tools/sbin/so-nvme-raid1.sh | 120 ++++++++++++++------ 1 file changed, 88 insertions(+), 32 deletions(-) diff --git a/salt/hypervisor/tools/sbin/so-nvme-raid1.sh b/salt/hypervisor/tools/sbin/so-nvme-raid1.sh index 79ccbb33c..ab97e3c88 100644 --- a/salt/hypervisor/tools/sbin/so-nvme-raid1.sh +++ b/salt/hypervisor/tools/sbin/so-nvme-raid1.sh @@ -12,7 +12,7 @@ # - Detects and reports existing RAID configurations # - Thoroughly cleans target drives of any existing data/configurations # - Creates GPT partition tables with RAID-type partitions -# - Establishes RAID-1 array (/dev/md0) for data redundancy +# - Establishes RAID-1 array (${RAID_DEVICE}) for data redundancy # - Formats the array with XFS filesystem for performance # - Automatically mounts at /nsm and configures for boot persistence # - Provides monitoring information for resync operations @@ -37,6 +37,11 @@ # Exit on any error set -e +# Configuration variables +RAID_ARRAY_NAME="md0" +RAID_DEVICE="/dev/${RAID_ARRAY_NAME}" +MOUNT_POINT="/nsm" + # Function to log messages log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" @@ -50,36 +55,68 @@ check_root() { fi } +# Function to find MD arrays using specific devices +find_md_arrays_using_devices() { + local target_devices=("$@") + local found_arrays=() + + # Parse /proc/mdstat to find arrays using our target devices + if [ -f "/proc/mdstat" ]; then + while IFS= read -r line; do + if [[ $line =~ ^(md[0-9]+) ]]; then + local array_name="${BASH_REMATCH[1]}" + local array_path="/dev/$array_name" + + # Check if this array uses any of our target devices + for device in "${target_devices[@]}"; do + if echo "$line" | grep -q "${device##*/}"; then + found_arrays+=("$array_path") + break + fi + done + fi + done < /proc/mdstat + fi + + printf '%s\n' "${found_arrays[@]}" +} + # Function to check if RAID is already set up check_existing_raid() { - if [ -e "/dev/md0" ]; then - if mdadm --detail /dev/md0 &>/dev/null; then - local raid_state=$(mdadm --detail /dev/md0 | grep "State" | awk '{print $3}') - local mount_point="/nsm" - - log "Found existing RAID array /dev/md0 (State: $raid_state)" - - if mountpoint -q "$mount_point"; then - log "RAID is already mounted at $mount_point" - log "Current RAID details:" - mdadm --detail /dev/md0 + local target_devices=("/dev/nvme0n1p1" "/dev/nvme1n1p1") + local found_arrays=($(find_md_arrays_using_devices "${target_devices[@]}")) + + # Check if we found any arrays using our target devices + if [ ${#found_arrays[@]} -gt 0 ]; then + for array_path in "${found_arrays[@]}"; do + if mdadm --detail "$array_path" &>/dev/null; then + local raid_state=$(mdadm --detail "$array_path" | grep "State" | awk '{print $3}') + local mount_point="/nsm" - # Check if resyncing - if grep -q "resync" /proc/mdstat; then - log "RAID is currently resyncing:" - grep resync /proc/mdstat - log "You can monitor progress with: watch -n 60 cat /proc/mdstat" - else - log "RAID is fully synced and operational" + log "Found existing RAID array $array_path (State: $raid_state)" + + if mountpoint -q "$mount_point"; then + log "RAID is already mounted at $mount_point" + log "Current RAID details:" + mdadm --detail "$array_path" + + # Check if resyncing + if grep -q "resync" /proc/mdstat; then + log "RAID is currently resyncing:" + grep resync /proc/mdstat + log "You can monitor progress with: watch -n 60 cat /proc/mdstat" + else + log "RAID is fully synced and operational" + fi + + # Show disk usage + log "Current disk usage:" + df -h "$mount_point" + + exit 0 fi - - # Show disk usage - log "Current disk usage:" - df -h "$mount_point" - - exit 0 fi - fi + done fi # Check if any of the target devices are in use @@ -90,10 +127,29 @@ check_existing_raid() { fi if mdadm --examine "$device" &>/dev/null || mdadm --examine "${device}p1" &>/dev/null; then + # Find the actual array name for this device + local device_arrays=($(find_md_arrays_using_devices "${device}p1")) + local array_name="" + + if [ ${#device_arrays[@]} -gt 0 ]; then + array_name="${device_arrays[0]}" + else + # Fallback: try to find array name from /proc/mdstat + local partition_name="${device##*/}p1" + array_name=$(grep -l "$partition_name" /proc/mdstat 2>/dev/null | head -1) + if [ -n "$array_name" ]; then + array_name=$(grep "^md[0-9]" /proc/mdstat | grep "$partition_name" | awk '{print "/dev/" $1}' | head -1) + fi + # Final fallback + if [ -z "$array_name" ]; then + array_name="$RAID_DEVICE" + fi + fi + log "Error: $device appears to be part of an existing RAID array" log "To reuse this device, you must first:" log "1. Unmount any filesystems" - log "2. Stop the RAID array: mdadm --stop /dev/md0" + log "2. Stop the RAID array: mdadm --stop $array_name" log "3. Zero the superblock: mdadm --zero-superblock ${device}p1" exit 1 fi @@ -183,20 +239,20 @@ main() { fi log "Creating RAID array" - mdadm --create /dev/md0 --level=1 --raid-devices=2 \ + mdadm --create "$RAID_DEVICE" --level=1 --raid-devices=2 \ --metadata=1.2 \ /dev/nvme0n1p1 /dev/nvme1n1p1 \ --force --run log "Creating XFS filesystem" - mkfs.xfs -f /dev/md0 + mkfs.xfs -f "$RAID_DEVICE" log "Creating mount point" mkdir -p /nsm log "Updating fstab" - sed -i '/\/dev\/md0/d' /etc/fstab - echo "/dev/md0 /nsm xfs defaults,nofail 0 0" >> /etc/fstab + sed -i "\|${RAID_DEVICE}|d" /etc/fstab + echo "${RAID_DEVICE} ${MOUNT_POINT} xfs defaults,nofail 0 0" >> /etc/fstab log "Reloading systemd daemon" systemctl daemon-reload @@ -209,7 +265,7 @@ main() { log "RAID setup complete" log "RAID array details:" - mdadm --detail /dev/md0 + mdadm --detail "$RAID_DEVICE" if grep -q "resync" /proc/mdstat; then log "RAID is currently resyncing. You can monitor progress with:" From 930c8147e79a17bf576e410156e08b95398bfb53 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 1 Aug 2025 08:52:21 -0400 Subject: [PATCH 295/303] simplify cpu and memory regex --- .../hypervisor/soc_hypervisor.yaml.jinja | 36 +------------------ 1 file changed, 1 insertion(+), 35 deletions(-) diff --git a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja index 07577a1fb..926263b9d 100644 --- a/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja +++ b/salt/soc/dyanno/hypervisor/soc_hypervisor.yaml.jinja @@ -70,41 +70,7 @@ Base domain has not been initialized. {%- endmacro -%} {%- macro update_resource_field(field, free_value, total_value, unit_label) -%} -{%- set resource_regex = '' -%} -{%- if free_value < 10 -%} -{%- set resource_regex = '^[1-' ~ free_value ~ ']$' -%} -{%- elif free_value < 100 -%} -{%- set tens_digit = free_value // 10 -%} -{%- set ones_digit = free_value % 10 -%} -{%- if ones_digit == 0 -%} -{%- set resource_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '0)$' -%} -{%- else -%} -{%- set resource_regex = '^([1-9]|[1-' ~ (tens_digit-1) ~ '][0-9]|' ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} -{%- endif -%} -{%- elif free_value < 1000 -%} -{%- set hundreds_digit = free_value // 100 -%} -{%- set tens_digit = (free_value % 100) // 10 -%} -{%- set ones_digit = free_value % 10 -%} -{%- if hundreds_digit == 1 -%} -{%- if tens_digit == 0 and ones_digit == 0 -%} -{%- set resource_regex = '^([1-9]|[1-9][0-9]|100)$' -%} -{%- elif tens_digit == 0 -%} -{%- set resource_regex = '^([1-9]|[1-9][0-9]|10[0-' ~ ones_digit ~ '])$' -%} -{%- elif ones_digit == 0 -%} -{%- set resource_regex = '^([1-9]|[1-9][0-9]|10[0-9]|1[1-' ~ tens_digit ~ ']0)$' -%} -{%- else -%} -{%- set resource_regex = '^([1-9]|[1-9][0-9]|10[0-9]|1[1-' ~ (tens_digit-1) ~ '][0-9]|1' ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} -{%- endif -%} -{%- else -%} -{%- if tens_digit == 0 and ones_digit == 0 -%} -{%- set resource_regex = '^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|[1-' ~ (hundreds_digit-1) ~ '][0-9][0-9]|' ~ hundreds_digit ~ '00)$' -%} -{%- elif ones_digit == 0 -%} -{%- set resource_regex = '^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|[1-' ~ (hundreds_digit-1) ~ '][0-9][0-9]|' ~ hundreds_digit ~ '[0-' ~ tens_digit ~ ']0)$' -%} -{%- else -%} -{%- set resource_regex = '^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|[1-' ~ (hundreds_digit-1) ~ '][0-9][0-9]|' ~ hundreds_digit ~ '[0-' ~ (tens_digit-1) ~ '][0-9]|' ~ hundreds_digit ~ tens_digit ~ '[0-' ~ ones_digit ~ '])$' -%} -{%- endif -%} -{%- endif -%} -{%- endif -%} +{%- set resource_regex = '^[0-9]{1,3}$' -%} {%- do field.update({ 'label': field.label | replace('FREE', free_value | string) | replace('TOTAL', total_value | string), 'regex': resource_regex, From e9e3252bb5114ed5ddd7996fe1f2fcbfbbfadef4 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 1 Aug 2025 08:53:45 -0400 Subject: [PATCH 296/303] nvme script move nsm if mounted --- salt/hypervisor/tools/sbin/so-nvme-raid1.sh | 92 +++++++++++++++++---- 1 file changed, 75 insertions(+), 17 deletions(-) diff --git a/salt/hypervisor/tools/sbin/so-nvme-raid1.sh b/salt/hypervisor/tools/sbin/so-nvme-raid1.sh index ab97e3c88..9b9fcba2b 100644 --- a/salt/hypervisor/tools/sbin/so-nvme-raid1.sh +++ b/salt/hypervisor/tools/sbin/so-nvme-raid1.sh @@ -95,20 +95,83 @@ check_existing_raid() { log "Found existing RAID array $array_path (State: $raid_state)" - if mountpoint -q "$mount_point"; then - log "RAID is already mounted at $mount_point" + # Check what's currently mounted at /nsm + local current_mount=$(findmnt -n -o SOURCE "$mount_point" 2>/dev/null || echo "") + + if [ -n "$current_mount" ]; then + if [ "$current_mount" = "$array_path" ]; then + log "RAID array $array_path is already correctly mounted at $mount_point" + log "Current RAID details:" + mdadm --detail "$array_path" + + # Check if resyncing + if grep -q "resync" /proc/mdstat; then + log "RAID is currently resyncing:" + grep resync /proc/mdstat + log "You can monitor progress with: watch -n 60 cat /proc/mdstat" + else + log "RAID is fully synced and operational" + fi + + # Show disk usage + log "Current disk usage:" + df -h "$mount_point" + + exit 0 + else + log "Found $mount_point mounted on $current_mount, but RAID array $array_path exists" + log "Will unmount current filesystem and remount on RAID array" + + # Unmount current filesystem + log "Unmounting $mount_point" + umount "$mount_point" + + # Remove old fstab entry + log "Removing old fstab entry for $current_mount" + sed -i "\|$current_mount|d" /etc/fstab + + # Mount the RAID array + log "Mounting RAID array $array_path at $mount_point" + mount "$array_path" "$mount_point" + + # Update fstab + log "Updating fstab for RAID array" + sed -i "\|${array_path}|d" /etc/fstab + echo "${array_path} ${mount_point} xfs defaults,nofail 0 0" >> /etc/fstab + + log "RAID array is now mounted at $mount_point" + log "Current RAID details:" + mdadm --detail "$array_path" + + # Check if resyncing + if grep -q "resync" /proc/mdstat; then + log "RAID is currently resyncing:" + grep resync /proc/mdstat + log "You can monitor progress with: watch -n 60 cat /proc/mdstat" + else + log "RAID is fully synced and operational" + fi + + # Show disk usage + log "Current disk usage:" + df -h "$mount_point" + + exit 0 + fi + else + # /nsm not mounted, mount the RAID array + log "Mounting RAID array $array_path at $mount_point" + mount "$array_path" "$mount_point" + + # Update fstab + log "Updating fstab for RAID array" + sed -i "\|${array_path}|d" /etc/fstab + echo "${array_path} ${mount_point} xfs defaults,nofail 0 0" >> /etc/fstab + + log "RAID array is now mounted at $mount_point" log "Current RAID details:" mdadm --detail "$array_path" - # Check if resyncing - if grep -q "resync" /proc/mdstat; then - log "RAID is currently resyncing:" - grep resync /proc/mdstat - log "You can monitor progress with: watch -n 60 cat /proc/mdstat" - else - log "RAID is fully synced and operational" - fi - # Show disk usage log "Current disk usage:" df -h "$mount_point" @@ -120,12 +183,7 @@ check_existing_raid() { fi # Check if any of the target devices are in use - for device in "/dev/nvme0n1" "/dev/nvme1n1"; do - if lsblk -o NAME,MOUNTPOINT "$device" | grep -q "nsm"; then - log "Error: $device is already mounted at /nsm" - exit 1 - fi - + for device in "/dev/nvme0n1" "/dev/nvme1n1"; do if mdadm --examine "$device" &>/dev/null || mdadm --examine "${device}p1" &>/dev/null; then # Find the actual array name for this device local device_arrays=($(find_md_arrays_using_devices "${device}p1")) From 9d96a117530ea07334304606d3c648e163177bb8 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Fri, 1 Aug 2025 08:55:38 -0400 Subject: [PATCH 297/303] update usage --- salt/hypervisor/tools/sbin/so-nvme-raid1.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/salt/hypervisor/tools/sbin/so-nvme-raid1.sh b/salt/hypervisor/tools/sbin/so-nvme-raid1.sh index 9b9fcba2b..cc9916a4c 100644 --- a/salt/hypervisor/tools/sbin/so-nvme-raid1.sh +++ b/salt/hypervisor/tools/sbin/so-nvme-raid1.sh @@ -30,7 +30,7 @@ # # WARNING: This script will DESTROY all data on the target drives! # -# USAGE: sudo ./raid_setup.sh +# USAGE: sudo ./so-nvme-raid1.sh # ################################################################# From 453c32df0d937361aeab57a240509043a9fea388 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Mon, 4 Aug 2025 15:25:26 -0400 Subject: [PATCH 298/303] handle - in hypervisor hostname --- salt/manager/tools/sbin_jinja/so-salt-cloud | 28 +++++++++---------- salt/orch/dyanno_hypervisor.sls | 4 +-- .../cloud/cloud.profiles.d/socloud.conf.jinja | 2 +- .../engines/master/virtual_node_manager.py | 4 +-- salt/setup/virt/soinstall.map.jinja | 2 +- salt/vm/status/init.sls | 2 +- 6 files changed, 21 insertions(+), 21 deletions(-) diff --git a/salt/manager/tools/sbin_jinja/so-salt-cloud b/salt/manager/tools/sbin_jinja/so-salt-cloud index daa92fa67..0c98750f4 100644 --- a/salt/manager/tools/sbin_jinja/so-salt-cloud +++ b/salt/manager/tools/sbin_jinja/so-salt-cloud @@ -77,10 +77,10 @@ Examples: 1. Static IP Configuration with Multiple PCI Devices: Command: - so-salt-cloud -p sool9-hyper1 vm1_sensor --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 \ + so-salt-cloud -p sool9_hyper1 vm1_sensor --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 \ --dns4 192.168.1.1,192.168.1.2 --search4 example.local -c 4 -m 8192 -P 0000:c7:00.0 -P 0000:c4:00.0 - This command provisions a VM named vm1_sensor using the sool9-hyper1 profile with the following settings: + This command provisions a VM named vm1_sensor using the sool9_hyper1 profile with the following settings: - Static IPv4 configuration: - IP Address: 192.168.1.10/24 @@ -95,21 +95,21 @@ Examples: 2. DHCP Configuration with Default Hardware Settings: Command: - so-salt-cloud -p sool9-hyper1 vm2_master --dhcp4 + so-salt-cloud -p sool9_hyper1 vm2_master --dhcp4 - This command provisions a VM named vm2_master using the sool9-hyper1 profile with DHCP for network configuration and default hardware settings. + This command provisions a VM named vm2_master using the sool9_hyper1 profile with DHCP for network configuration and default hardware settings. 3. Static IP Configuration without Hardware Specifications: Command: - so-salt-cloud -p sool9-hyper1 vm3_search --static4 --ip4 192.168.1.20/24 --gw4 192.168.1.1 + so-salt-cloud -p sool9_hyper1 vm3_search --static4 --ip4 192.168.1.20/24 --gw4 192.168.1.1 This command provisions a VM named vm3_search with a static IP configuration and default hardware settings. 4. DHCP Configuration with Custom Hardware Specifications and Multiple PCI Devices: Command: - so-salt-cloud -p sool9-hyper1 vm4_node --dhcp4 -c 8 -m 16384 -P 0000:c7:00.0 -P 0000:c4:00.0 -P 0000:c4:00.1 + so-salt-cloud -p sool9_hyper1 vm4_node --dhcp4 -c 8 -m 16384 -P 0000:c7:00.0 -P 0000:c4:00.0 -P 0000:c4:00.1 This command provisions a VM named vm4_node using DHCP for network configuration and custom hardware settings: @@ -120,9 +120,9 @@ Examples: 5. Static IP Configuration with DNS and Search Domain: Command: - so-salt-cloud -p sool9-hyper1 vm1_sensor --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1 --search4 example.local + so-salt-cloud -p sool9_hyper1 vm1_sensor --static4 --ip4 192.168.1.10/24 --gw4 192.168.1.1 --dns4 192.168.1.1 --search4 example.local - This command provisions a VM named vm1_sensor using the sool9-hyper1 profile with static IPv4 configuration: + This command provisions a VM named vm1_sensor using the sool9_hyper1 profile with static IPv4 configuration: - Static IPv4 configuration: - IP Address: 192.168.1.10/24 @@ -133,14 +133,14 @@ Examples: 6. Delete a VM with Confirmation: Command: - so-salt-cloud -p sool9-hyper1 vm1_sensor -d + so-salt-cloud -p sool9_hyper1 vm1_sensor -d This command deletes the VM named vm1_sensor and will prompt for confirmation before proceeding. 7. Delete a VM without Confirmation: Command: - so-salt-cloud -p sool9-hyper1 vm1_sensor -yd + so-salt-cloud -p sool9_hyper1 vm1_sensor -yd This command deletes the VM named vm1_sensor without prompting for confirmation. @@ -439,8 +439,8 @@ def call_salt_cloud(profile, vm_name, destroy=False, assume_yes=False): delete_vm(profile, vm_name, assume_yes) return - # Extract hypervisor hostname from profile (e.g., sool9-jpphype1 -> jpphype1) - hypervisor = profile.split('-', 1)[1] if '-' in profile else None + # Extract hypervisor hostname from profile (e.g., sool9_hype1 -> hype1) + hypervisor = profile.split('_', 1)[1] if '_' in profile else None if hypervisor: logger.info("Ensuring host key exists for hypervisor %s", hypervisor) if not _add_hypervisor_host_key(hypervisor): @@ -512,7 +512,7 @@ def format_qcow2_output(operation, result): logger.info(f"{operation} result from {host}: {host_result}") def run_qcow2_modify_hardware_config(profile, vm_name, cpu=None, memory=None, pci_list=None, start=False): - hv_name = profile.split('-')[1] + hv_name = profile.split('_')[1] target = hv_name + "_*" try: @@ -534,7 +534,7 @@ def run_qcow2_modify_hardware_config(profile, vm_name, cpu=None, memory=None, pc logger.error(f"An error occurred while running qcow2.modify_hardware_config: {e}") def run_qcow2_modify_network_config(profile, vm_name, mode, ip=None, gateway=None, dns=None, search_domain=None): - hv_name = profile.split('-')[1] + hv_name = profile.split('_')[1] target = hv_name + "_*" image = '/nsm/libvirt/images/sool9/sool9.qcow2' interface = 'enp1s0' diff --git a/salt/orch/dyanno_hypervisor.sls b/salt/orch/dyanno_hypervisor.sls index a47e3c1b6..9ef8f7252 100644 --- a/salt/orch/dyanno_hypervisor.sls +++ b/salt/orch/dyanno_hypervisor.sls @@ -70,13 +70,13 @@ {% set vm_name = tag.split('/')[2] %} {% do salt.log.debug('dyanno_hypervisor_orch: Got vm_name from tag: ' ~ vm_name) %} {% if tag.endswith('/deploying') %} -{% set hypervisor = data.get('kwargs').get('cloud_grains').get('profile').split('-')[1] %} +{% set hypervisor = data.get('kwargs').get('cloud_grains').get('profile').split('_')[1] %} {% endif %} {# Set the hypervisor #} {# First try to get it from the event #} {% if data.get('profile', False) %} {% do salt.log.debug('dyanno_hypervisor_orch: Did not get cache.grains.') %} -{% set hypervisor = data.profile.split('-')[1] %} +{% set hypervisor = data.profile.split('_')[1] %} {% do salt.log.debug('dyanno_hypervisor_orch: Got hypervisor from data: ' ~ hypervisor) %} {% else %} {% set hypervisor = find_hypervisor_from_status(vm_name) %} diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 0b795a8ab..94cc85117 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -6,7 +6,7 @@ {%- for role, hosts in HYPERVISORS.items() %} {%- for host in hosts.keys() %} -sool9-{{host}}: +sool9_{{host}}: provider: kvm-ssh-{{host}} base_domain: sool9 ip_source: qemu-agent diff --git a/salt/salt/engines/master/virtual_node_manager.py b/salt/salt/engines/master/virtual_node_manager.py index bc098d075..88ccede9c 100644 --- a/salt/salt/engines/master/virtual_node_manager.py +++ b/salt/salt/engines/master/virtual_node_manager.py @@ -650,7 +650,7 @@ def process_vm_creation(hypervisor_path: str, vm_config: dict) -> None: create_vm_tracking_file(hypervisor_path, vm_name, vm_config) # Build and execute so-salt-cloud command - cmd = ['so-salt-cloud', '-p', f'sool9-{hypervisor}', vm_name] + cmd = ['so-salt-cloud', '-p', f'sool9_{hypervisor}', vm_name] # Add network configuration if vm_config['network_mode'] == 'static4': @@ -788,7 +788,7 @@ def process_vm_deletion(hypervisor_path: str, vm_name: str) -> None: log.warning("Failed to read VM config from tracking file %s: %s", vm_file, str(e)) # Attempt VM deletion with so-salt-cloud - cmd = ['so-salt-cloud', '-p', f'sool9-{hypervisor}', vm_name, '-yd'] + cmd = ['so-salt-cloud', '-p', f'sool9_{hypervisor}', vm_name, '-yd'] log.info("Executing: %s", ' '.join(cmd)) result = subprocess.run(cmd, capture_output=True, text=True, check=True) diff --git a/salt/setup/virt/soinstall.map.jinja b/salt/setup/virt/soinstall.map.jinja index d839235b0..45aa503da 100644 --- a/salt/setup/virt/soinstall.map.jinja +++ b/salt/setup/virt/soinstall.map.jinja @@ -4,7 +4,7 @@ Elastic License 2.0. #} {% set nodetype = grains.id.split("_") | last %} -{% set hypervisor = salt['grains.get']('salt-cloud:profile').split('-')[1] %} +{% set hypervisor = salt['grains.get']('salt-cloud:profile').split('_')[1] %} {# Import hardware details from VM hardware tracking file #} {% import_json 'hypervisor/hosts/' ~ hypervisor ~ '/' ~ grains.id as vm_hardware %} diff --git a/salt/vm/status/init.sls b/salt/vm/status/init.sls index d4051e50c..4e530f827 100644 --- a/salt/vm/status/init.sls +++ b/salt/vm/status/init.sls @@ -19,7 +19,7 @@ vm_highstate_trigger: - data: status: Highstate Initiated vm_name: {{ grains.id }} - hypervisor: {{ salt['grains.get']('salt-cloud:profile', '').split('-')[1] }} + hypervisor: {{ salt['grains.get']('salt-cloud:profile', '').split('_')[1] }} - unless: test -f /opt/so/state/highstate_trigger.txt - order: 1 # Ensure this runs early in the highstate process From 82894d88b6d9ffa36715e8854225b4e30a1b1d39 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 7 Aug 2025 14:40:58 -0400 Subject: [PATCH 299/303] ecdsa instead of ed25519 --- salt/_runners/setup_hypervisor.py | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/salt/_runners/setup_hypervisor.py b/salt/_runners/setup_hypervisor.py index 9d7116d59..929801783 100644 --- a/salt/_runners/setup_hypervisor.py +++ b/salt/_runners/setup_hypervisor.py @@ -38,7 +38,7 @@ Examples: Notes: - Verifies Security Onion license - Downloads and validates Oracle Linux KVM image if needed - - Generates Ed25519 SSH keys if not present + - Generates ECDSA SSH keys if not present - Creates/recreates VM based on environment changes - Forces hypervisor configuration via highstate after successful setup (when minion_id provided) @@ -46,7 +46,7 @@ Examples: The setup process includes: 1. License validation 2. Oracle Linux KVM image download and checksum verification - 3. SSH key generation for secure VM access + 3. ECDSA SSH key generation for secure VM access 4. Cloud-init configuration for VM provisioning 5. VM creation with specified disk size 6. Hypervisor configuration via highstate (when minion_id provided and setup successful) @@ -74,7 +74,7 @@ import sys import time import yaml from cryptography.hazmat.primitives import serialization -from cryptography.hazmat.primitives.asymmetric import ed25519 +from cryptography.hazmat.primitives.asymmetric import ec # Configure logging log = logging.getLogger(__name__) log.setLevel(logging.DEBUG) @@ -232,7 +232,7 @@ def _check_ssh_keys_exist(): bool: True if both private and public keys exist, False otherwise """ key_dir = '/etc/ssh/auth_keys/soqemussh' - key_path = f'{key_dir}/id_ed25519' + key_path = f'{key_dir}/id_ecdsa' pub_key_path = f'{key_path}.pub' dest_dir = '/opt/so/saltstack/local/salt/libvirt/ssh/keys' dest_path = os.path.join(dest_dir, os.path.basename(pub_key_path)) @@ -250,7 +250,7 @@ def _setup_ssh_keys(): """ try: key_dir = '/etc/ssh/auth_keys/soqemussh' - key_path = f'{key_dir}/id_ed25519' + key_path = f'{key_dir}/id_ecdsa' pub_key_path = f'{key_path}.pub' # Check if keys already exist @@ -266,9 +266,9 @@ def _setup_ssh_keys(): os.makedirs(key_dir, exist_ok=True) os.chmod(key_dir, 0o700) - # Generate new ed25519 key pair + # Generate new ECDSA key pair using SECP256R1 curve log.info("Generating new SSH keys") - private_key = ed25519.Ed25519PrivateKey.generate() + private_key = ec.generate_private_key(ec.SECP256R1()) public_key = private_key.public_key() # Serialize private key @@ -540,7 +540,7 @@ def setup_environment(vm_name: str = 'sool9', disk_size: str = '220G', minion_id Notes: - Verifies Security Onion license - Downloads and validates Oracle Linux KVM image if needed - - Generates Ed25519 SSH keys if not present + - Generates ECDSA SSH keys if not present - Creates/recreates VM based on environment changes - Forces hypervisor configuration via highstate after successful setup (when minion_id is provided) @@ -765,7 +765,7 @@ def create_vm(vm_name: str, disk_size: str = '220G'): _set_ownership_and_perms(vm_dir, mode=0o750) # Read the SSH public key - pub_key_path = '/opt/so/saltstack/local/salt/libvirt/ssh/keys/id_ed25519.pub' + pub_key_path = '/opt/so/saltstack/local/salt/libvirt/ssh/keys/id_ecdsa.pub' try: with salt.utils.files.fopen(pub_key_path, 'r') as f: ssh_pub_key = f.read().strip() @@ -844,7 +844,7 @@ output: all: ">> /var/log/cloud-init.log" # configure interaction with ssh server -ssh_genkeytypes: ['ed25519', 'rsa'] +ssh_genkeytypes: ['ecdsa', 'rsa'] # set timezone for VM timezone: UTC @@ -1038,7 +1038,7 @@ def regenerate_ssh_keys(): Notes: - Validates Security Onion license - Removes existing keys if present - - Generates new Ed25519 key pair + - Generates new ECDSA key pair - Sets secure permissions (600 for private, 644 for public) - Distributes public key to required locations @@ -1048,7 +1048,7 @@ def regenerate_ssh_keys(): 2. Checks for existing SSH keys 3. Removes old keys if present 4. Creates required directories with secure permissions - 5. Generates new Ed25519 key pair + 5. Generates new ECDSA key pair 6. Sets appropriate file permissions 7. Distributes public key to required locations @@ -1067,7 +1067,7 @@ def regenerate_ssh_keys(): # Remove existing keys key_dir = '/etc/ssh/auth_keys/soqemussh' - key_path = f'{key_dir}/id_ed25519' + key_path = f'{key_dir}/id_ecdsa' pub_key_path = f'{key_path}.pub' dest_dir = '/opt/so/saltstack/local/salt/libvirt/ssh/keys' dest_path = os.path.join(dest_dir, os.path.basename(pub_key_path)) From c5db0a7195ced047e89bd54f33ce896dd6e13cd8 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 7 Aug 2025 15:02:45 -0400 Subject: [PATCH 300/303] more ed25519 to ecdsa --- salt/libvirt/ssh/files/config | 2 +- salt/libvirt/ssh/users.sls | 2 +- salt/manager/hypervisor.sls | 6 +++--- salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja | 2 +- setup/so-setup | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/salt/libvirt/ssh/files/config b/salt/libvirt/ssh/files/config index de6cb7b34..9b8f89442 100644 --- a/salt/libvirt/ssh/files/config +++ b/salt/libvirt/ssh/files/config @@ -1,2 +1,2 @@ Match user soqemussh - IdentityFile /etc/ssh/auth_keys/soqemussh/id_ed25519 + IdentityFile /etc/ssh/auth_keys/soqemussh/id_ecdsa diff --git a/salt/libvirt/ssh/users.sls b/salt/libvirt/ssh/users.sls index 173a3e095..8bbf2ca7e 100644 --- a/salt/libvirt/ssh/users.sls +++ b/salt/libvirt/ssh/users.sls @@ -46,7 +46,7 @@ create_soqemussh_user: soqemussh_pub_key: ssh_auth.present: - user: soqemussh - - source: salt://libvirt/ssh/keys/id_ed25519.pub + - source: salt://libvirt/ssh/keys/id_ecdsa.pub {% endif %} diff --git a/salt/manager/hypervisor.sls b/salt/manager/hypervisor.sls index 315775446..080d0699c 100644 --- a/salt/manager/hypervisor.sls +++ b/salt/manager/hypervisor.sls @@ -16,9 +16,9 @@ # Check if hypervisor environment has been set up {% set ssh_user_exists = salt['user.info']('soqemussh') %} -{% set ssh_keys_exist = salt['file.file_exists']('/etc/ssh/auth_keys/soqemussh/id_ed25519') and - salt['file.file_exists']('/etc/ssh/auth_keys/soqemussh/id_ed25519.pub') and - salt['file.file_exists']('/opt/so/saltstack/local/salt/libvirt/ssh/keys/id_ed25519.pub') %} +{% set ssh_keys_exist = salt['file.file_exists']('/etc/ssh/auth_keys/soqemussh/id_ecdsa') and + salt['file.file_exists']('/etc/ssh/auth_keys/soqemussh/id_ecdsa.pub') and + salt['file.file_exists']('/opt/so/saltstack/local/salt/libvirt/ssh/keys/id_ecdsa.pub') %} {% set base_image_exists = salt['file.file_exists']('/nsm/libvirt/boot/OL9U5_x86_64-kvm-b253.qcow2') %} {% set vm_files_exist = salt['file.directory_exists']('/opt/so/saltstack/local/salt/libvirt/images/sool9') and salt['file.file_exists']('/opt/so/saltstack/local/salt/libvirt/images/sool9/sool9.qcow2') and diff --git a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja index 94cc85117..025e23d89 100644 --- a/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja +++ b/salt/salt/cloud/cloud.profiles.d/socloud.conf.jinja @@ -11,7 +11,7 @@ sool9_{{host}}: base_domain: sool9 ip_source: qemu-agent ssh_username: soqemussh - private_key: /etc/ssh/auth_keys/soqemussh/id_ed25519 + private_key: /etc/ssh/auth_keys/soqemussh/id_ecdsa sudo: True deploy_command: sh /tmp/.saltcloud-*/deploy.sh script_args: -r -F -x python3 stable 3006.9 diff --git a/setup/so-setup b/setup/so-setup index f955917bc..347a7165c 100755 --- a/setup/so-setup +++ b/setup/so-setup @@ -755,7 +755,7 @@ if ! [[ -f $install_opt_file ]]; then logCmd "salt-key -ya $MINION_ID" logCmd "salt-call saltutil.sync_all" # we need to sync the runner and generate the soqemussh user keys so that first highstate after license created - # doesnt have a state failure for soqemussh_pub_key source for id_ed25519.pub missing + # doesnt have a state failure for soqemussh_pub_key source for id_ecdsa.pub missing if [[ $is_manager || $is_managerhype ]]; then logCmd "salt-run saltutil.sync_all" logCmd "salt-run setup_hypervisor.regenerate_ssh_keys" From 9617da1791507d64302bf2e7b9a638832a8d3109 Mon Sep 17 00:00:00 2001 From: Josh Patterson Date: Thu, 7 Aug 2025 16:13:59 -0400 Subject: [PATCH 301/303] remove managerhype from whiptail --- setup/so-whiptail | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/setup/so-whiptail b/setup/so-whiptail index 57bd10b8c..4c92f6a48 100755 --- a/setup/so-whiptail +++ b/setup/so-whiptail @@ -654,10 +654,9 @@ whiptail_install_type_dist_new() { Note: MANAGER is the recommended option for most users. MANAGERSEARCH should only be used in very specific situations. EOM - install_type=$(whiptail --title "$whiptail_title" --menu "$mngr_msg" 20 75 3 \ + install_type=$(whiptail --title "$whiptail_title" --menu "$mngr_msg" 20 75 2 \ "MANAGER" "New grid, requires separate search node(s) " \ "MANAGERSEARCH" "New grid, separate search node(s) are optional " \ - "MANAGERHYPE" "Manager with hypervisor - Security Onion Pro required " \ 3>&1 1>&2 2>&3 ) From ae0ffc4977eb560685022328d30564fc83320257 Mon Sep 17 00:00:00 2001 From: Mike Reeves Date: Tue, 12 Aug 2025 09:32:42 -0400 Subject: [PATCH 302/303] 2.4.170 --- DOWNLOAD_AND_VERIFY_ISO.md | 22 ++++++++++---------- sigs/securityonion-2.4.170-20250812.iso.sig | Bin 0 -> 566 bytes 2 files changed, 11 insertions(+), 11 deletions(-) create mode 100644 sigs/securityonion-2.4.170-20250812.iso.sig diff --git a/DOWNLOAD_AND_VERIFY_ISO.md b/DOWNLOAD_AND_VERIFY_ISO.md index 2e0b2aa5d..e05cf651c 100644 --- a/DOWNLOAD_AND_VERIFY_ISO.md +++ b/DOWNLOAD_AND_VERIFY_ISO.md @@ -1,17 +1,17 @@ -### 2.4.160-20250625 ISO image released on 2025/06/25 +### 2.4.170-20250812 ISO image released on 2025/06/25 ### Download and Verify -2.4.160-20250625 ISO image: -https://download.securityonion.net/file/securityonion/securityonion-2.4.160-20250625.iso +2.4.170-20250812 ISO image: +https://download.securityonion.net/file/securityonion/securityonion-2.4.170-20250812.iso -MD5: 78CF5602EFFAB84174C56AD2826E6E4E -SHA1: FC7EEC3EC95D97D3337501BAA7CA8CAE7C0E15EA -SHA256: 0ED965E8BEC80EE16AE90A0F0F96A3046CEF2D92720A587278DDDE3B656C01C2 +MD5: 50ECAAD05736298452DECEAE074FA773 +SHA1: 1B1EB520DE61ECC4BF34E512DAFE307317D7666A +SHA256: 87D176A48A58BAD1C2D57196F999BED23DE9B526226E3754F0C166C866CCDC1A Signature for ISO image: -https://github.com/Security-Onion-Solutions/securityonion/raw/2.4/main/sigs/securityonion-2.4.160-20250625.iso.sig +https://github.com/Security-Onion-Solutions/securityonion/raw/2.4/main/sigs/securityonion-2.4.170-20250812.iso.sig Signing key: https://raw.githubusercontent.com/Security-Onion-Solutions/securityonion/2.4/main/KEYS @@ -25,22 +25,22 @@ wget https://raw.githubusercontent.com/Security-Onion-Solutions/securityonion/2. Download the signature file for the ISO: ``` -wget https://github.com/Security-Onion-Solutions/securityonion/raw/2.4/main/sigs/securityonion-2.4.160-20250625.iso.sig +wget https://github.com/Security-Onion-Solutions/securityonion/raw/2.4/main/sigs/securityonion-2.4.170-20250812.iso.sig ``` Download the ISO image: ``` -wget https://download.securityonion.net/file/securityonion/securityonion-2.4.160-20250625.iso +wget https://download.securityonion.net/file/securityonion/securityonion-2.4.170-20250812.iso ``` Verify the downloaded ISO image using the signature file: ``` -gpg --verify securityonion-2.4.160-20250625.iso.sig securityonion-2.4.160-20250625.iso +gpg --verify securityonion-2.4.170-20250812.iso.sig securityonion-2.4.170-20250812.iso ``` The output should show "Good signature" and the Primary key fingerprint should match what's shown below: ``` -gpg: Signature made Wed 25 Jun 2025 10:13:33 AM EDT using RSA key ID FE507013 +gpg: Signature made Fri 08 Aug 2025 06:24:56 PM EDT using RSA key ID FE507013 gpg: Good signature from "Security Onion Solutions, LLC " gpg: WARNING: This key is not certified with a trusted signature! gpg: There is no indication that the signature belongs to the owner. diff --git a/sigs/securityonion-2.4.170-20250812.iso.sig b/sigs/securityonion-2.4.170-20250812.iso.sig new file mode 100644 index 0000000000000000000000000000000000000000..df29c07b52de66ebd153c31a66ed6f44888ed7f0 GIT binary patch literal 566 zcmV-60?GY}0y6{v0SEvc79j-41gSkXz6^6dp_W8^5Ma0dP;e6k0%(?bH~5PT3| zxBgIY6OMZi|9c42+U)G%bR9qJ+x;7VidQ}2%)OCKP;{%ny8AXNqr#E^ z{z+v02l;K>WQ%rt!yQ<`*L1LfATKOPXvrJhkaVa{#4BvQ8ze%F(X(Jec zjsF(|lLOTUVf zLs#JgYHT~~pGp`UerUeTH}OfPWT2dD)&F-pa+nsu=T03t3R6YehVjO&ji2wIS?RN< zsDOkfs@!CZpJu?IQas<&k*!#uY=F zrt=PAT3}yFD#g4qzPnwHr0EWq6kBB;?r+4VUNxe&nhs6LB4_6m&9A+WiCY_Nu}rv8 z4Nm#=2vq30npWr6^ilaoYZA*ux)b}p2a9?4ls9| Date: Tue, 12 Aug 2025 09:40:18 -0400 Subject: [PATCH 303/303] 2.4.170 --- DOWNLOAD_AND_VERIFY_ISO.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/DOWNLOAD_AND_VERIFY_ISO.md b/DOWNLOAD_AND_VERIFY_ISO.md index e05cf651c..6b966957c 100644 --- a/DOWNLOAD_AND_VERIFY_ISO.md +++ b/DOWNLOAD_AND_VERIFY_ISO.md @@ -1,4 +1,4 @@ -### 2.4.170-20250812 ISO image released on 2025/06/25 +### 2.4.170-20250812 ISO image released on 2025/08/12 ### Download and Verify

+ + + +
+ Skip to content + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + + + + + + +
+ + + + + +
+ + + + + + + + + +
+
+
+ + + + + + + + + + + + +
+ +
+ +
+ +
+ + + + / + + securityonion + + + Public +
+ + +
+ +
+ + +
+
+ +
+
+ + + + +
+ + + + + + +
+ + + + + + + + + + + + + + + + + + +

Latest commit

 

History

History
152 KB

certifi-2022.12.7-py3-none-any.whl

File metadata and controls

152 KB
Raw
View raw
+ + + + + +
+ + + +
+
+ +
+ +
+

Footer

+ + + + +
+
+ + + + + © 2024 GitHub, Inc. + +
+ + +
+
+ + + + + + + + + + + + + + + + + + + +