jbaker10 / lanrevimporter

AutoPkg Processor for LANrev

Notice:

This is the new LANrevImporter processor for AutoPkg, which is a fork of the AbsoluteManageExport processor. All future enhancements and issues for this processor should be done using this repo. The old AbsoluteManageExport repo will remain available to ease the transition, but will no longer be maintained or updated.

If you are switching from using the AbsoluteManageExport processor, please see Switching from AbsoluteManageExport to LANrevImporter for help with migrating your recipes.

LANrevImporter

LANrevImporter is an AutoPkg Processor for LANrev by HEAT Software.

Configure LANrev

Enable External SD Package Upload. Run this in the same user context that you will be running LANrev Admin:

defaults write com.poleposition-sw.lanrev_admin AllowURLSDPackageImport -bool true

Launch the LANrev Admin application. Sign into the correct server with a user that has rights to upload SD packages.

/Applications/LANrev Admin.app

Double check there is a folder entry for your server - username in:

~/Library/Application Support/LANrev Admin/Database/

You should be all set to run your LANrev recipes.

Installing the Processor

You can install this processor locally on the system by running this installer: https://github.com/jbaker10/LANrevImporter/releases/latest

AutoPkg Shared Processor

As of AutoPkg 0.4.0 you can use this processor as a shared processor.

Add the processor repo:

autopkg repo-add https://github.com/jbaker10/LANrevImporter

Then use this as the processor in your recipes:

com.github.jbaker10.LANrevImporter/LANrevImporter

See this wiki for more information on shared processor: https://github.com/autopkg/autopkg/wiki/Processor-Locations

Available Input Variables

• add_s_to_availability_date
• availability_hour
• dest_payload_path
• download_payloads_before_user_dialog
• import_pkg_to_servercenter
• installation_condition_name
• installation_condition_version_string
• max_os
• min_os
• os_platform
• payload_name_prefix
• platform_arch
• sd_name_prefix
• sdpackages_ampkgprops_path
• source_payload_path
• staging_server_option

Sample Processor

<dict>
    <key>Processor</key>
    <string>com.github.jbaker10.LANrevImporter/LANrevImporter</string>
    <key>Arguments</key>
    <dict>
        <key>dest_payload_path</key>
        <string>%RECIPE_CACHE_DIR%/%NAME%-%version%.amsdpackages</string>
        <key>sdpackages_ampkgprops_path</key>
        <string>%RECIPE_DIR%/%NAME%-Defaults.ampkgprops</string>
        <key>source_payload_path</key>
        <string>%pkg_path%</string>
        <key>sd_name_prefix</key>
        <string>(OSX AutoPkg) </string>
        <key>payload_name_prefix</key>
        <string>(OSX) </string>
        <key>availability_hour</key>
        <integer>20</integer>
        <key>import_pkg_to_servercenter</key>
        <true/>
        <key>installation_condition_name</key>
        <string>%NAME%.app</string>
        <key>installation_condition_version_string</key>
        <string>1.0</string>
        <key>os_platform</key>
        <string>Mac</string>
        <key>min_os</key>
        <string>OSX10.7</string>
        <key>max_os</key>
        <string>OSX10.10</string>
        <key>download_payloads_before_user_dialog</key>
        <true/>
        <key>staging_server_option</key>
        <integer>2</integer>
    </dict>
</dict>

Expected Behavior

LANrevImporter currently only performs a basic check to see if an executable with the same name is already in the SD Package database. If so, no upload takes place. If not, a new Software Package and Payload are created.

New package uploaded.

Remember, the LANrev Admin app must be open for an upload to complete.

LANrevImporter
LANrevImporter: [+] Exported [/Users/burgintj/Library/AutoPkg/Cache/com.github.tburgin.Absolute.AdobeFlashPlayer/AdobeFlashPlayer-16.0.0.305.pkg] to [/Users/burgintj/Library/AutoPkg/Cache/com.github.tburgin.Absolute.AdobeFlashPlayer/AdobeFlashPlayer-16.0.0.305.amsdpackages]
LANrevImporter: [+] Checking if [AdobeFlashPlayer-16.0.0.305] exists in SDCaches.db
LANrevImporter: [+] Attemting to upload [/Users/burgintj/Library/AutoPkg/Cache/com.github.tburgin.Absolute.AdobeFlashPlayer/AdobeFlashPlayer-16.0.0.305.amsdpackages] to LANrev Server Center
Receipt written to /Users/burgintj/Library/AutoPkg/Cache/com.github.tburgin.Absolute.AdobeFlashPlayer/receipts/AdobeFlashPlayer-receipt-20150223-232722.plist

Package Exists

LANrevImporter
LANrevImporter: [+] Exported [/Users/burgintj/Library/AutoPkg/Cache/com.github.tburgin.Absolute.AdobeFlashPlayer/AdobeFlashPlayer-16.0.0.305.pkg] to [/Users/burgintj/Library/AutoPkg/Cache/com.github.tburgin.Absolute.AdobeFlashPlayer/AdobeFlashPlayer-16.0.0.305.amsdpackages]
LANrevImporter: [+] Checking if [AdobeFlashPlayer-16.0.0.305] exists in SDCaches.db
LANrevImporter: [+] [AdobeFlashPlayer-16.0.0.305.pkg] already exists in LANrev Server Center
LANrevImporter: [+] Nothing uploaded to Absolute Manage
Receipt written to /Users/burgintj/Library/AutoPkg/Cache/com.github.tburgin.Absolute.AdobeFlashPlayer/receipts/AdobeFlashPlayer-receipt-20150223-232413.plist

Sources

The get_pref method I borrowed from munki.

Contributors

Thanks to:

Tom Burgin

• Tom is the original creator of the formerly named AbsoluteManageExport, that evolved into LANrevImporter when the application was bought by HEAT. Thanks Tom for all the hard work that makes us look good!
• Patrick Gallagher
• Elliot Jordan
• Andy

License

Copyright 2017 Jeremiah Baker.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.