Class: Xolo::Core::BaseClasses::Version

Inherits:

ServerObject

Object
ServerObject
Xolo::Core::BaseClasses::Version

show all

Defined in:: lib/xolo/core/base_classes/version.rb

Overview

The base class for dealing with Versions/Patches in the Xolo Server, Admin, and Client modules.

This class holds the common aspects of Xolo Versinos as used on the Xolo server, in the Xolo Admin CLI app ‘xadm’, and the client app ‘xolo’ - most importately it defines which data they exchange.

Direct Known Subclasses

Admin::Version

Constant Summary collapse

DEFAULT_MIN_OS = The title editor requires a value for min os, so use this as the default if not specified in the server config

'10.9'

USE_TITLE_FOR_KILLAPP = when this is provided as a killapp, the killapp will be defined by the app_name and app_bundle_id used in the title.

'use-title'

STATUS_PENDING = Has been created in Xolo, but not yet made available for installation

'pending'

STATUS_PILOT = Has been released from the Title Editor, but is only available for piloting in Xolo. Will be auto-installed on non-excluded members of the pilot groups

'pilot'

STATUS_RELEASED = Has been fully released in Xolo, this is the currently ‘live’ version. Will be auto-installed on non-excluded members of the release groups

'released'

STATUS_SKIPPED = Was pending or pilot, but was never released in Xolo, and now a newer version has been released

'skipped'

STATUS_DEPRECATED = Was released in Xolo, but now a newer version has been released

'deprecated'

ATTRIBUTES = Attributes of Versions See the definition for Title::ATTRIBUTES

{

  # @!attribute title
  #   @return [String] The title to which this version belongs
  title: {
    label: 'Title',
    read_only: true,
    immutable: true,
    cli: false,
    type: :string,
    validate: true,
    invalid_msg: 'Not a valid version! Cannot already exist in this title.',
    desc: <<~ENDDESC
      A unique version string identifying this version in this title, e.g. '12.34.5'.
    ENDDESC
  },

  # @!attribute version
  #   @return [String] The version-string for this version.
  version: {
    label: 'Version',
    required: true,
    immutable: true,
    do_not_inherit: true,
    cli: false,
    type: :string,
    validate: true,
    invalid_msg: 'Not a valid version! Cannot already exist in this title.',
    ted_attribute: :version,
    desc: <<~ENDDESC
      A unique version string identifying this version in this title, e.g. '12.34.5'.
    ENDDESC
  },

  # @!attribute publish_date
  #   @return [Time] When the publisher released this version. Defaults to today.
  publish_date: {
    label: 'Publish Date',
    type: :time,
    default: -> { Time.now.to_s },
    title_type: Xolo::MANAGED,
    do_not_inherit: true,
    cli: :d,
    validate: true,
    changelog: true,
    ted_attribute: :releaseDate,
    invalid_msg: 'Not a valid date!',
    desc: <<~ENDDESC
      The date this version was released by the publisher.
      Default is today.
    ENDDESC
  },

  # @!attribute min_os = required to create the Title Editor Patch
  #   @return [String] The minimum OS version that this version can be installed on.
  min_os: {
    label: 'Minimum OS',
    cli: :o,
    type: :string,
    title_type: Xolo::MANAGED,
    required: false,
    validate: true,
    default: DEFAULT_MIN_OS,
    changelog: true,
    ted_attribute: :minimumOperatingSystem,
    invalid_msg: "Not a valid OS version! Must be XX[.YY[.ZZ]] format, e.g. '10.9' or '11.0.1'.",
    desc: <<~ENDDESC
      The lowest version of macOS able to run this version of this title. Defaults to a value set in the server config, or #{DEFAULT_MIN_OS}.
    ENDDESC
  },

  # @!attribute max_os
  #   @return [String] The maximum OS version that this version can be installed on.
  max_os: {
    label: 'Maximum OS',
    cli: :O,
    type: :string,
    title_type: Xolo::MANAGED,
    validate: true,
    changelog: true,
    # default: Xolo::NONE,
    invalid_msg: "Not a valid OS version! Must be XX[.YY[.ZZ]] format, e.g. '10.9' or '11.0.1'.",
    desc: <<~ENDDESC
      The highest version of macOS able to run this version of this title.
    ENDDESC
  },

  # @!attribute reboot
  #   @return [Boolean] Does this version need a reboot after installing?
  reboot: {
    label: 'Reboot',
    cli: :r,
    type: :boolean,
    title_type: Xolo::MANAGED,
    validate: :validate_boolean,
    ted_attribute: :reboot,
    default: false,
    changelog: true,
    desc: <<~ENDDESC
      The installation of this version requires the computer to reboot. Users will be notified before installation.
    ENDDESC
  },

  # @!attribute standalone
  #   @return [Boolean] Is this version a full installer? (if not, its an incremental patch)
  standalone: {
    label: 'Standalone',
    cli: :s,
    type: :boolean,
    title_type: Xolo::MANAGED,
    validate: :validate_boolean,
    default: true,
    ted_attribute: :standalone,
    changelog: true,
    desc: <<~ENDDESC
      The installer for this version is a full installer, not an incremental patch that must be installed on top of an earlier version.
    ENDDESC
  },

  # @!attribute killapps
  #   @return [Array<String>] The apps that cannot be running when this version is installed
  killapps: {
    label: 'KillApps',
    cli: :k,
    type: :string,
    title_type: Xolo::MANAGED,
    multi: true,
    readline: true,
    readline_prompt: 'KillApp',
    validate: true,
    changelog: true,
    # default: Xolo::NONE,
    invalid_msg: 'Not a valid killapp!',
    desc: <<~ENDDESC
      A killapp is an application that cannot be running while this version is installed.
      If running, installation is delayed, and users are notified to quit.

      Killapps are defined by an app name e.g. 'Google Chrome.app', and the app's Bundle ID
      e.g. 'com.google.chrome'.

      Specify them together separated by a semi-colon, e.g.
         'Google Chrome.app;com.google.chrome'

      If the title for this version has a defined --app-name and --app-bundle-id, you can
      use them as a killapp by specifying '#{USE_TITLE_FOR_KILLAPP}'

      If not using --walkthru you can use --killapps multiple times
    ENDDESC
  },

  # @!attribute patch_unknown
  #   @return [Boolean] Should 'unknown' versions of this title be updated to this version automatically?
  patch_unknown: {
    label: 'Patch Unknown Versions',
    cli: :U,
    type: :boolean,
    validate: :validate_boolean,
    default: false,
    changelog: true,
    desc: <<~ENDDESC
      Should 'unknown' versions of this title be updated to this version automatically by Jamf Patch Management?

      When Jamf Patch determines that a title is installed on a computer, but version reported is not among those known to Jamf Patch, it marks the version as 'unknown'. Setting this option to true will cause Jamf Patch to automatically install the pkg for this version on those Macs with 'unknown' versions.

      This can cause problems if that unknown version is actually newer than this version, e.g. a beta or pre-release version, or when the app has a 'self-update' mechanism that installs newer versions outside of Jamf Patch before it is aware of them.

      But sometimes it may be desirable to have all unknown versions updated to this version, e.g. when the title is a helper app that is not regularly updated, or when the title is being newly managed by Xolo/Jamf Patch and you want to get all existing installations onto this version.
    ENDDESC
  },

  # @!attribute pilot_groups
  #   @return [Array<String>] Jamf groups that will automatically get this version installed or
  #     updated for piloting
  pilot_groups: {
    label: 'Pilot Computer Groups',
    cli: :p,
    validate: true,
    type: :string,
    multi: true,
    changelog: true,
    readline_prompt: 'Group Name',
    readline: :jamf_computer_group_names,
    invalid_msg: "Invalid group. Must be an existing Jamf Computer Group, or '#{Xolo::NONE}'.",
    desc: <<~ENDDESC
      One or more Jamf Computer Groups whose members will automatically have this version installed or updated for testing before it is released.

      These computers will be used for testing not just the software, but the installation process itself. Exclusions win, so computers that are also in an excluded group for the title will not be used as pilots.

      When this version is released, the computers in the release_groups defined in the title will automatically have this version installed - and any computers with an older version will have it updated.

      When using the --pilot-groups CLI option, you can specify more than one group by using the option more than once, or by providing a single option value with the groups separated by commas.

      When adding a new version, the pilot groups from the previous version will be inherited if you don't specify any. To make the new version have no pilot groups use '#{Xolo::NONE}'.

      NOTE: Any non-excluded computer can be used for piloting at any time by manually installing the yet-to-be-released version using `sudo xolo install <title> <version>`.  The members of the pilot groups are just the ones that will have it auto-installed.
    ENDDESC
  },

  # @!attribute jamf_pkg
  #   @return [String] The file name of the installer for the Jamf Package object that
  #     installs this version.  'xolo-<title>-<version>.pkg' (or .zip)
  pkg_to_upload: {
    label: 'Upload Package',
    type: :string,
    cli: :u,
    validate: true,
    readline: :get_files,
    do_not_inherit: true,
    hide_from_info: true,
    invalid_msg: 'Invalid installer pkg. Must exist locally and be a flat .pkg file',
    desc: <<~ENDDESC
      The path to a local copy of the installer package for this version. Will be uploaded to Xolo and then Jamf Pro distribution point(s), replacing any previously uploaded.

      Must be a flat .pkg file, or a .zip compressed old-style bundle package.

      It will be renamed to 'xolo-<title>-<version>.pkg' (or .zip).
      If your Xolo server is confiured to sign unsigned packages, it will do so along the way.

      Required when creating a new version unless the title is configrued to use autopkg.
    ENDDESC
  },

  # @!attribute status
  #   @return [String] One of: STATUS_PENDING, STATUS_PILOT, STATUS_RELEASED,
  #     STATUS_SKIPPED, or STATUS_DEPRECATED
  status: {
    label: 'Status',
    type: :symbol,
    do_not_inherit: true,
    cli: false,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The status of this version in Xolo:
      - pending: Not yet available for installation.
      - pilot: Can be installed for piloting, will auto install on any pilot-groups.
      - released: This is the current version, generally available, will auto-install on target groups.
      - skipped: Was created, and maybe piloted, but never released.
      - deprecated: Was released, but a newer version has since been released.
    ENDDESC
  },

  # @!attribute created_by
  #   @return [String] The login of the admin who created this version.
  created_by: {
    label: 'Created By',
    type: :string,
    do_not_inherit: true,
    cli: false,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The login of the admin who created this version.
    ENDDESC
  },

  # @!attribute creation_date
  #   @return [Time] The date this version was created.
  creation_date: {
    label: 'Creation Date',
    type: :time,
    do_not_inherit: true,
    cli: false,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      When this version was created.
    ENDDESC
  },

  # @!attribute modified_by
  #   @return [String] The login of the admin who last modified this version.
  modified_by: {
    label: 'Modified By',
    type: :string,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The login of the admin who last modified this version.
    ENDDESC
  },

  # @!attribute modification_date
  #   @return [Time] The date this version was last modified.
  modification_date: {
    label: 'Modification Date',
    type: :time,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      When this version was last modified.
    ENDDESC
  },

  # @!attribute deployed_by
  #   @return [String] The login of the admin who released this version in Xolo.
  #     This is when the Xolo sets the status of this version to 'released', making it
  #     no longer 'in pilot' and the one to be installed or updated by default.
  released_by: {
    label: 'Released By',
    type: :string,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The login of the admin who released this version in Xolo.
      This is when the Xolo sets the status of this version to 'released', making it
      no longer 'in pilot' and the one to be installed or updated by default.
    ENDDESC
  },

  # @!attribute release_date
  #   @return [Time] The timestamp this version was released in Xolo.
  #     This is when the Xolo sets the status of this version to 'released', making it
  #     no longer 'in pilot' and the one to be installed or updated by default.
  release_date: {
    label: 'Release Date',
    type: :time,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      When this version was released in Xolo.
      This is when the Xolo sets the status of this version to 'released', making it
      no longer 'in pilot' and the one to be installed or updated by default.
    ENDDESC
  },

  # @!attribute deprecated_by
  #   @return [String] The login of the admin who deprecated this version in Xolo by releasing
  #     a newer version.
  deprecated_by: {
    label: 'Deprecated By',
    type: :string,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The login of the admin who deprecated this version in Xolo by releasing a newer version.
    ENDDESC
  },

  # @!attribute deprecation_date
  #   @return [Time] The timestamp this version was deprecated in Xolo.
  #     This is when the Xolo sets the status of this version to 'deprecated', meaning
  #     it was released, but a newer version has since been released.
  deprecation_date: {
    label: 'Deprecation Date',
    type: :time,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      When this version was deprecated in Xolo.
      This is when the Xolo sets the status of this version to 'deprecated', which is when a newer version has been released.
      It will still be available for manual installation until it is deleted.
      Deletion is automatic after a period of time, unless the server is configured otherwise.
    ENDDESC
  },

  # @!attribute skipped_by
  #   @return [String] The login of the admin who skipped this version in Xolo by releasing
  #     a newer version.
  skipped_by: {
    label: 'Skipped By',
    type: :string,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The login of the admin who skipped this version in Xolo by releasing a newer version.
    ENDDESC
  },

  # @!attribute skipped_date
  #   @return [Time] The timestamp this version was skipped in Xolo.
  #     This is when the Xolo sets the status of this version to 'skipped', meaning
  #     it was never released in Xolo, and now a newer version has been released.
  skipped_date: {
    label: 'Skipped Date',
    type: :time,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      When this version was skipped in Xolo.
      This is when the Xolo sets the status of this version to 'skipped', meaning it was never released in Xolo, and now a newer version has been released.
      It will be automatically deleted at the next nightly cleanup, unless the server is configured otherwise.
    ENDDESC
  },

  # @!attribute jamf_pkg_name
  #   @return [String] The display name of the Jamf Package object that installs this version.
  #     'xolo-<title>-<version>'
  jamf_pkg_name: {
    label: 'Jamf Package Name',
    type: :string,
    do_not_inherit: true,
    cli: false,
    desc: <<~ENDDESC
      The display name of the Jamf Package object that installs this version. 'xolo-<title>-<version>'
    ENDDESC
  },

  # @!attribute jamf_pkg_id
  #   @return [String] The id of the Jamf Package object that installs this version.
  #      This is an integer in a string, as are all IDs in the Jamf Pro API.
  #      TODO: Stop using pkgID - or any jamf ID, use names for accessing all jamf objects
  jamf_pkg_id: {
    label: 'Jamf Package ID',
    type: :string,
    read_only: true,
    do_not_inherit: true,
    cli: false,
    desc: <<~ENDDESC
      The id of the Jamf Package object that installs this version. 'xolo-<title>-<version>'
    ENDDESC
  },

  # @!attribute jamf_pkg_file
  #   @return [String] The file name of the installer.pkg file used by the Jamf Package object to
  #    installs this version. 'xolo-<title>-<version>.pkg'
  jamf_pkg_file: {
    label: 'Jamf Package File',
    type: :string,
    do_not_inherit: true,
    cli: false,
    desc: <<~ENDDESC
      The installer filename of the Jamf Package object that installs this version: 'xolo-<title>-<version>.pkg' (or .zip).
    ENDDESC
  },

  # @!attribute upload_date
  #   @return [Time] Timestamp of the original pkg upload
  upload_date: {
    label: 'Original Pkg Upload Date',
    type: :time,
    do_not_inherit: true,
    cli: false,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The time the first .pkg for this version was uploaded.
    ENDDESC
  },

  # @!attribute uploaded_by
  #   @return [String] The login of the admin who uploaded the original pkg
  uploaded_by: {
    label: 'Original Pkg Uploaded By',
    type: :string,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The login of the admin who last uploaded the first .pkg for this version.
    ENDDESC
  },

  # @!attribute reupload_date
  #   @return [Time] Timestamp of the latest pkg reupload
  reupload_date: {
    label: 'Latest Pkg Re-Upload Date',
    type: :time,
    do_not_inherit: true,
    cli: false,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The last time the .pkg for this version was re-uploaded, after the initial upload.
    ENDDESC
  },

  # @!attribute reuploaded_by
  #   @return [String] The login of the admin who reuploaded the latest pkg
  reuploaded_by: {
    label: 'Latest Pkg Re-Uploaded By',
    type: :string,
    cli: false,
    do_not_inherit: true,
    read_only: true, # maintained by the server, not editable by xadm TODO: same as cli: false??
    desc: <<~ENDDESC
      The login of the admin who last re-uploaded the .pkg for this version, after the initial upload.
    ENDDESC
  },

  # @!attribute dist_pkg
  #   @return [Boolean] Is the most recently uploaded package a Distribution package? If so it can be used
  #      for MDM deployment.
  dist_pkg: {
    label: 'Distribution Package',
    type: :boolean,
    do_not_inherit: true,
    cli: false,
    desc: <<~ENDDESC
      If true, the most recently uploaded .pkg file is a flat Distribution package, and can be deployed via MDM using the 'xadm deploy' command. Nil if no pkg was ever uploaded via xolo. Uploading a different .pkg file via other means will not change this value, and may cause the pkg to fail to deploy via MDM.
      This value is set by the server when the pkg is uploaded.
    ENDDESC
  },

  # @!attribute sha_512
  #   @return [String] The SHA512 checksum of the most recently uploaded package
  sha_512: {
    label: 'Package Checksum (SHA512)',
    type: :string,
    do_not_inherit: true,
    cli: false,
    desc: <<~ENDDESC
      The SHA512 checksum of the most recently uploaded package.
      NOTE: The Jamf Server may use an MD5 checksum in the package object.
      This value is set by the server when the pkg is uploaded.
    ENDDESC
  }

}.freeze

Instance Attribute Summary collapse

#created_by ⇒ String

The login of the admin who created this version.
#creation_date ⇒ Time

The date this version was created.
#deployed_by ⇒ String

The login of the admin who released this version in Xolo.
#deprecated_by ⇒ String

The login of the admin who deprecated this version in Xolo by releasing a newer version.
#deprecation_date ⇒ Time

The timestamp this version was deprecated in Xolo.
#dist_pkg ⇒ Boolean

Is the most recently uploaded package a Distribution package? If so it can be used for MDM deployment.
#jamf_pkg ⇒ String

The file name of the installer for the Jamf Package object that installs this version.
#jamf_pkg_file ⇒ String

The file name of the installer.pkg file used by the Jamf Package object to installs this version.
#jamf_pkg_id ⇒ String

The id of the Jamf Package object that installs this version.
#jamf_pkg_name ⇒ String

The display name of the Jamf Package object that installs this version.
#modification_date ⇒ Time

The date this version was last modified.
#modified_by ⇒ String

The login of the admin who last modified this version.
#release_date ⇒ Time

The timestamp this version was released in Xolo.
#reupload_date ⇒ Time

Timestamp of the latest pkg reupload.
#reuploaded_by ⇒ String

The login of the admin who reuploaded the latest pkg.
#sha_512 ⇒ String

The SHA512 checksum of the most recently uploaded package.
#skipped_by ⇒ String

The login of the admin who skipped this version in Xolo by releasing a newer version.
#skipped_date ⇒ Time

The timestamp this version was skipped in Xolo.
#status ⇒ String

One of: STATUS_PENDING, STATUS_PILOT, STATUS_RELEASED, STATUS_SKIPPED, or STATUS_DEPRECATED.
#upload_date ⇒ Time

Timestamp of the original pkg upload.
#uploaded_by ⇒ String

The login of the admin who uploaded the original pkg.

Methods inherited from ServerObject

#initialize, #to_h, #to_json

Methods included from JSONWrappers

extended, included, #parse_json

Constructor Details

This class inherits a constructor from Xolo::Core::BaseClasses::ServerObject

Instance Attribute Details

#created_by ⇒ `String`

Returns The login of the admin who created this version.

Returns:

(String) —

The login of the admin who created this version.

# File 'lib/xolo/core/base_classes/version.rb', line 314

#creation_date ⇒ `Time`

Returns The date this version was created.

Returns:

(Time) —

The date this version was created.

# File 'lib/xolo/core/base_classes/version.rb', line 327

#deployed_by ⇒ `String`

Returns The login of the admin who released this version in Xolo. This is when the Xolo sets the status of this version to ‘released’, making it no longer ‘in pilot’ and the one to be installed or updated by default.

Returns:

(String) —

The login of the admin who released this version in Xolo. This is when the Xolo sets the status of this version to ‘released’, making it no longer ‘in pilot’ and the one to be installed or updated by default.

# File 'lib/xolo/core/base_classes/version.rb', line 366

#deprecated_by ⇒ `String`

Returns The login of the admin who deprecated this version in Xolo by releasing a newer version.

Returns:

(String) —

The login of the admin who deprecated this version in Xolo by releasing a newer version.

# File 'lib/xolo/core/base_classes/version.rb', line 400

#deprecation_date ⇒ `Time`

Returns The timestamp this version was deprecated in Xolo. This is when the Xolo sets the status of this version to ‘deprecated’, meaning it was released, but a newer version has since been released.

Returns:

(Time) —

The timestamp this version was deprecated in Xolo. This is when the Xolo sets the status of this version to ‘deprecated’, meaning it was released, but a newer version has since been released.

# File 'lib/xolo/core/base_classes/version.rb', line 414

#dist_pkg ⇒ `Boolean`

Returns Is the most recently uploaded package a Distribution package? If so it can be used for MDM deployment.

Returns:

(Boolean) —

Is the most recently uploaded package a Distribution package? If so it can be used for MDM deployment.

# File 'lib/xolo/core/base_classes/version.rb', line 556

#jamf_pkg ⇒ `String`

Returns The file name of the installer for the Jamf Package object that installs this version. ‘xolo-<title>-<version>.pkg’ (or .zip).

Returns:

(String) —

The file name of the installer for the Jamf Package object that installs this version. ‘xolo-<title>-<version>.pkg’ (or .zip)

# File 'lib/xolo/core/base_classes/version.rb', line 271

#jamf_pkg_file ⇒ `String`

Returns The file name of the installer.pkg file used by the Jamf Package object to installs this version. ‘xolo-<title>-<version>.pkg’.

Returns:

(String) —

The file name of the installer.pkg file used by the Jamf Package object to installs this version. ‘xolo-<title>-<version>.pkg’

# File 'lib/xolo/core/base_classes/version.rb', line 491

#jamf_pkg_id ⇒ `String`

Returns The id of the Jamf Package object that installs this version. This is an integer in a string, as are all IDs in the Jamf Pro API. TODO: Stop using pkgID - or any jamf ID, use names for accessing all jamf objects.

Returns:

(String) —

The id of the Jamf Package object that installs this version. This is an integer in a string, as are all IDs in the Jamf Pro API. TODO: Stop using pkgID - or any jamf ID, use names for accessing all jamf objects

# File 'lib/xolo/core/base_classes/version.rb', line 476

#jamf_pkg_name ⇒ `String`

Returns The display name of the Jamf Package object that installs this version. ‘xolo-<title>-<version>’.

Returns:

(String) —

The display name of the Jamf Package object that installs this version. ‘xolo-<title>-<version>’

# File 'lib/xolo/core/base_classes/version.rb', line 463

#modification_date ⇒ `Time`

Returns The date this version was last modified.

Returns:

(Time) —

The date this version was last modified.

# File 'lib/xolo/core/base_classes/version.rb', line 353

#modified_by ⇒ `String`

Returns The login of the admin who last modified this version.

Returns:

(String) —

The login of the admin who last modified this version.

# File 'lib/xolo/core/base_classes/version.rb', line 340

#release_date ⇒ `Time`

Returns The timestamp this version was released in Xolo. This is when the Xolo sets the status of this version to ‘released’, making it no longer ‘in pilot’ and the one to be installed or updated by default.

Returns:

(Time) —

The timestamp this version was released in Xolo. This is when the Xolo sets the status of this version to ‘released’, making it no longer ‘in pilot’ and the one to be installed or updated by default.

# File 'lib/xolo/core/base_classes/version.rb', line 383

#reupload_date ⇒ `Time`

Returns Timestamp of the latest pkg reupload.

Returns:

(Time) —

Timestamp of the latest pkg reupload

# File 'lib/xolo/core/base_classes/version.rb', line 530

#reuploaded_by ⇒ `String`

Returns The login of the admin who reuploaded the latest pkg.

Returns:

(String) —

The login of the admin who reuploaded the latest pkg

# File 'lib/xolo/core/base_classes/version.rb', line 543

#sha_512 ⇒ `String`

Returns The SHA512 checksum of the most recently uploaded package.

Returns:

(String) —

The SHA512 checksum of the most recently uploaded package

# File 'lib/xolo/core/base_classes/version.rb', line 570

#skipped_by ⇒ `String`

Returns The login of the admin who skipped this version in Xolo by releasing a newer version.

Returns:

(String) —

The login of the admin who skipped this version in Xolo by releasing a newer version.

# File 'lib/xolo/core/base_classes/version.rb', line 432

#skipped_date ⇒ `Time`

Returns The timestamp this version was skipped in Xolo. This is when the Xolo sets the status of this version to ‘skipped’, meaning it was never released in Xolo, and now a newer version has been released.

Returns:

(Time) —

The timestamp this version was skipped in Xolo. This is when the Xolo sets the status of this version to ‘skipped’, meaning it was never released in Xolo, and now a newer version has been released.

# File 'lib/xolo/core/base_classes/version.rb', line 446

#status ⇒ `String`

Returns One of: STATUS_PENDING, STATUS_PILOT, STATUS_RELEASED, STATUS_SKIPPED, or STATUS_DEPRECATED.

Returns:

(String) —

One of: STATUS_PENDING, STATUS_PILOT, STATUS_RELEASED, STATUS_SKIPPED, or STATUS_DEPRECATED

# File 'lib/xolo/core/base_classes/version.rb', line 295

#upload_date ⇒ `Time`

Returns Timestamp of the original pkg upload.

Returns:

(Time) —

Timestamp of the original pkg upload

# File 'lib/xolo/core/base_classes/version.rb', line 504

#uploaded_by ⇒ `String`

Returns The login of the admin who uploaded the original pkg.

Returns:

(String) —

The login of the admin who uploaded the original pkg

# File 'lib/xolo/core/base_classes/version.rb', line 517

Instance Method Details

#deprecated? ⇒ `Boolean`

Returns:

(Boolean)



626
627
628

# File 'lib/xolo/core/base_classes/version.rb', line 626

def deprecated?
  status == STATUS_DEPRECATED
end

#pending? ⇒ `Boolean`

Returns:

(Boolean)



631
632
633

# File 'lib/xolo/core/base_classes/version.rb', line 631

def pending?
  status == STATUS_PENDING
end

#pilot? ⇒ `Boolean`

Returns:

(Boolean)



611
612
613

# File 'lib/xolo/core/base_classes/version.rb', line 611

def pilot?
  status == STATUS_PILOT || status.nil?
end

#released? ⇒ `Boolean`

Returns:

(Boolean)



616
617
618

# File 'lib/xolo/core/base_classes/version.rb', line 616

def released?
  status == STATUS_RELEASED
end

#skipped? ⇒ `Boolean`

Returns:

(Boolean)



621
622
623

# File 'lib/xolo/core/base_classes/version.rb', line 621

def skipped?
  status == STATUS_SKIPPED
end

Class: Xolo::Core::BaseClasses::Version

Overview

Direct Known Subclasses

Constant Summary collapse

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from ServerObject

Methods included from JSONWrappers

Constructor Details

Instance Attribute Details

#created_by ⇒ String

#creation_date ⇒ Time

#deployed_by ⇒ String

#deprecated_by ⇒ String

#deprecation_date ⇒ Time

#dist_pkg ⇒ Boolean

#jamf_pkg ⇒ String

#jamf_pkg_file ⇒ String

#jamf_pkg_id ⇒ String

#jamf_pkg_name ⇒ String

#modification_date ⇒ Time

#modified_by ⇒ String

#release_date ⇒ Time

#reupload_date ⇒ Time

#reuploaded_by ⇒ String

#sha_512 ⇒ String

#skipped_by ⇒ String

#skipped_date ⇒ Time

#status ⇒ String

#upload_date ⇒ Time

#uploaded_by ⇒ String

Instance Method Details

#deprecated? ⇒ Boolean

#pending? ⇒ Boolean

#pilot? ⇒ Boolean

#released? ⇒ Boolean

#skipped? ⇒ Boolean

#created_by ⇒ `String`

#creation_date ⇒ `Time`

#deployed_by ⇒ `String`

#deprecated_by ⇒ `String`

#deprecation_date ⇒ `Time`

#dist_pkg ⇒ `Boolean`

#jamf_pkg ⇒ `String`

#jamf_pkg_file ⇒ `String`

#jamf_pkg_id ⇒ `String`

#jamf_pkg_name ⇒ `String`

#modification_date ⇒ `Time`

#modified_by ⇒ `String`

#release_date ⇒ `Time`

#reupload_date ⇒ `Time`

#reuploaded_by ⇒ `String`

#sha_512 ⇒ `String`

#skipped_by ⇒ `String`

#skipped_date ⇒ `Time`

#status ⇒ `String`

#upload_date ⇒ `Time`

#uploaded_by ⇒ `String`

#deprecated? ⇒ `Boolean`

#pending? ⇒ `Boolean`

#pilot? ⇒ `Boolean`

#released? ⇒ `Boolean`

#skipped? ⇒ `Boolean`