Welcome Guest [Log In] [Register]

AWS FreePBX Updates
>>> Join the AWS FreePBX Updates Mailing List <<<


Posted Image

Welcome to TheWebMachine Networks AWS Support Forum. We hope you enjoy your visit.

You're currently viewing our forum as a guest. This means you are limited to certain areas of the board and there are some features you can't use. If you register, you'll be able to access member-only sections, and use many member-only features such as customizing your profile, sending personal messages, and voting in polls. Registration is simple, fast, and completely free. Registration on this forum is entirely optional and only needed to post in the forum. You can submit Support Requests using the blue button bar on the right side of this page. You can sign up for our AWS FreePBX Updates mailing list using the link above, beneath our Updates ticker.


Register now!


If you're already a member please log in to your account to access all of our features:

Username:   Password:
Add Reply
! Presenting the AWSFPBX SmartUpgrade System !; Current Version: 2.8 (EXPERT-MODE v2.4)
Topic Started: Feb 19 2016, 12:09 AM (2,776 Views)
TheWebMachine
Member Avatar
Administrator
UPDATE 2018-01-16: We have been receiving complaints that Sangoma's Automatic Updates are causing random issues on AMI v3.0 instances. We have published a patch for AMI v3.0 FreePBX 14 instances that disables the Sangoma Automatic Update client. This is to prevent conflicts with AWS FreePBX and our SmartUpgrade system. Please use SmartUpgrade for all system updates. The next time you run SmartUpgrade on your AMI v3.0 instance, Sangoma's Automatic Updates will be fully disabled and the related GUI page will be removed. This change only applies to TWM-AMI v3.0, as earlier versions of FreePBX do not have this automatic update client. We will be releasing our own Automatic Update for SmartUpgrade in the near future.

Introducing SmartUpgrade!
The always-up-to-date upgrade scripting engine for AWS FreePBX.


NO MORE GUESSING which version you have!
NO MORE FUMBLING with downloading a bunch of different files!
ONE CONVENIENT COMMAND you can run any time to ensure your system is running the latest and best we have to offer!


NOTICE: IF YOU ARE CURRENTLY ON AMI v2.x WITH FREEPBX 13 AND ARE READY TO UPGRADE TO AMI v3.x WITH FREEPBX 14, PLEASE SEE THIS PAGE TO COMPLETE THIS MAJOR VERSION UPGRADE >>> https://www.thewebmachine.net/aws-freepbx-v3

SmartUpgrade is already baked into TWM-AMI v2.5+ for new instances. In order to add SmartUpgrade to your existing v1.x and v2.0-2.4 instances, we have created a quick install method. Once you have completed the initial SmartUpgrade install, all future upgrades on that instance will only require running a single command from your SSH console. This new upgrade system will ensure you always receive the latest software without having to know your existing version or downloading a bunch of confusing script files. The SmartUpgrade system will also accept optional commands to perform custom functions, like calling the /var/spool volume migration utility.

WARNING: DO NOT ATTEMPT TO INSTALL OR USE SMARTUPGRADE ON A LOCAL FREEPBX SYSTEM OR CLOUD SYSTEMS PROVIDED BY OTHER COMPANIES!
SMARTUPGRADE WILL ONLY FUNCTION ON AWS FREEPBX BY THEWEBMACHINE NETWORKS AND WILL PROBABLY BREAK OTHER SYSTEMS!


Excited yet!? Alright, let's get this installed on your instance! (If you are already on TWM-AMI v2.5 or higher, skip to the usage section below.) First, we need to access your instance via SSH. If you've patched or upgraded your instance before, you know the drill:

SSH CONNECTION TUTORIAL
Spoiler: click to toggle



Once you are connected to your instance via SSH, simply execute this single-line command string to download, install, and configure the SmartUpgrade package:
SSH
 
sudo wget http://files.thewebmachine.net/smartupgrade-installer.sh && sudo chmod +x smartupgrade-installer.sh && sudo ./smartupgrade-installer.sh && sudo su


That's it! You will see output like the following and be returned to the command prompt:
Posted Image


Once you have installed SmartUpgrade, you can upgrade your system and run custom patch scripts at any time from the SSH console:

To simply upgrade your instance to the latest TWM-AMI version:
SSH
 
smartupgrade [--auto]



To run a custom patch script:
SSH
 
smartupgrade [--auto] name-of-custom-command



With SmartUpgrade v2.0, we have incorporated better error checking and reporting, fully re-optimized upgrade scripts, and improved usability. We have also just released a new "Expert Mode" menu system to allow for things like in-between version upgrades (instead of upgrading to the absolute latest version available), patches/fixes status and installation, and convenient maintenance tasks like migrating a spool volume, S3 Bucket sync and Automatic File Deletion services! You can give EXPERT-MODE a try by running the following command. NOTE: EXPERT-MODE must be in ALL CAPS and you CANNOT use the --auto option:
SSH
 
smartupgrade EXPERT-MODE



Posted Image



Here is a list of custom commands currently available (this list will be updated with all new scripts as they become available):


SYNTAX: smartupgrade [--auto] <custom-command>

--auto
  • This MUST be the first option when used and tells SmartUpgrade to proceed without seeking user confirmation. This allows you to call upon SmartUpgrade in non-interactive modes (or called from another script) to accomplish tasks.
  • USE THIS OPTION WITH CAUTION!

EXPERT-MODE
  • This MUST be the only option when used and launches the SmartUpgrade EXPERT-MODE menu system. This allows you to have more finite control, status information on available updates/fixes/patches, and the ability to complete advanced maintenance tasks.
  • PLEASE READ ALL PROMPTS AND WARNINGS VERY CAREFULLY WHEN USING EXPERT-MODE!

awsfpbx-spool-migration
  • This is used to migrate your /var/spool directory to a new volume you have ALREADY attached to your instance (attach the volume before you run this script).
  • For more information, please see this FAQ: http://forum.thewebmachine.net/topic/8307330/
  • NOTE: This cannot be used in conjunction with the --auto option, as user intervention is absolutely required to complete this process.

fix-asterisk13-resampling
  • This is used to fix the Asterisk 13 custom sound file upload bug found to exist in TWM-AMI versions 2.0, 2.1, 2.2, and 2.3 WITHOUT performing an instance upgrade to the latest TWM-AMI version. This bug was corrected in TWM-AMI v2.3.1 and newer.
  • For more information, please see this FAQ: http://forum.thewebmachine.net/topic/8332985/

fix-postfix
  • This is used to fix postfix permission issues that are preventing alert and voicemail notifications from being sent by your instance. If you are not receiving these emails from your instance and you are certain your settings are correct, you may wish to try this fix.
  • For more information, please see this FAQ: http://forum.thewebmachine.net/topic/8321547/
  • NOTE: This cannot be used in conjunction with the --auto option, as there is no user intervention required by default.

fix-swap
  • This is used to fix the swap partition on instances launched from TWM-AMI v2.1-2.5. This issue has been corrected in TWM-AMI v2.6 and newer.
  • For more information, please see this FAQ: http://forum.thewebmachine.net/topic/8487666/

patch-glibc
  • This will update glibc to address a critical vulnerability. This vulnerability affects all previous versions of glibc and all versions of linux running those versions. This patch script makes no other changes to your system and has been incorporated in all other SmartUpgrade scripts. You should only need to run this patch separately under special circumstances.
  • For more information, please see this CERT article: http://www.kb.cert.org/vuls/id/457759

show-current-version
  • This will show your current TWM-AMI version number. If you are running an older system and are missing the TWM-AMI version tags or you have made other major customizations to the core software, this will calculate your current TWM-AMI version and generate new version tags to speed up future upgrades.

show-log
  • This will display the SmartUpgrade.log file allowing you to see debugging information from your recent upgrades. You will also be given the option to delete the log and even email a copy to yourself after you exit the log viewer. You can send this log to us to assist in troubleshooting if you contact us for upgrade issues.

smartupgrade-installer
  • This option is for repairing or upgrading the base stub of the SmartUpgrade system. If you run into problems such as script looping (it just keeps displaying the same status messages again and again), an error message or any other unexpected messages, try running with this option to ensure you have all the latest components.

tail <serviceID>
  • This is used to show a live running log for the <serviceID> specified after tail
  • You must specify either afd for Auto File Deletion or s3ss for S3 Sync Service as the <serviceID>
  • You cannot use the --auto option with this command.

volume-resize-fix
  • This is used to update the automatic volume resizing script to address a critical bug. This patch has been incorporated into TWM-AMI v2.5 and newer and will be automatically applied if you use the awsfobx-spool-migration option from this point forward.
  • For more information, please see this FAQ: http://forum.thewebmachine.net/topic/8368475/

vm-storage-switch
  • This is used to switch between Local and IMAP Storage methods for Voicemail.
  • THERE ARE SIGNIFICANT STEPS AND CONSIDERATIONS TO BE MADE WHEN SWITCHING VM STORAGE TYPES, YOU MUST READ THE FOLLOWING GUIDE BEFORE YOU SWITCH STORAGE: http://forum.thewebmachine.net/topic/10187012/

wipe-cdr-db
  • This is used to wipe clean the CDR and CEL databases. This does NOT delete any call recording audio files from the local filesystem!



This page was last updated 2018-April-13 @ 4:20AM CST




Thank you for choosing AWS FreePBX!

If you like our product, please help us let others know by leaving a review on the AWS Marketplace!

We have ANNUAL subscriptions available. An Annual Subscription NOW saves you 17% (TWO MONTHS FREE) versus paying hourly!
Visit your AWS Subscriptions page to purchase annual subscription(s) for your instance(s) and start saving today!

Offline Profile Quote Post Goto Top
 
TheWebMachine
Member Avatar
Administrator
ChangeLog for SmartUpgrade v2.8 (2017-AUG-24):

  • Further tightening of security against SIPVICIOUS and other "friendly" type of attacks. This update will be automagically applied to your system the next time you run SmartUpgrade from the console, even if you refuse all other possible updates. DO NOT DO THIS DURING NORMAL BUSINESS HOURS, AS PHONE SERVICES WILL BE INTERRUPTED FOR APPROXIMATELY 5 MINUTES DURING THE UPDATE!!!

ChangeLog for EXPERT-MODE v2.4:

  • Update for AMI v3.0
  • Update for Asterisk 15
  • Fixed an issue where IMAP VM Storage modules were not being respected by asterisk-version-switch when changing asterisk versions. If you are using IMAP VM Storage, this will now be preserved properly if you switch asterisk versions

    Previous updates:

    • Added ability to view FreePBX Notifications from within EXPERT-MODE (option N on the Main Menu)
    • Corrected a bug in S3 Sync where Call Recordings get synced back to the local server from S3 after being deleted from the local server in some semi-rare cases. Update your S3cmd and Sync service from the S3 menu if you are using S3 Sync for Call Recordings!
    • Added new Custom Files and Directories option to S3 Sync. Now you can sync any files or folders of your choice to S3! Update your S3cmd and Sync service from the S3 menu then check out the S3 Sync options menu for this new option
    • Considerable improvement to the initial loading speed of EXPERT-MODE. Some processes have been offloaded to the background to run asynchronously with the menu interface
    • Added the ability to run Auto File Deletion on-demand using the same Retention policy you have set for scheduled deletion (option X in the AFD Configuration menu)
    • Clean-up of S3 Sync Configuration screen, providing better explanation of how Sync works and added live status for Custom Files and Folders Sync
    • Added vm-storage-switch to the Troubleshooting and Maintenance section. Please read the following page BEFORE switching VM Storage options: http://forum.thewebmachine.net/topic/10187012/

    • A BRAND NEW MENU SYSTEM you have to see to believe. EXPERT-MODE is now even EASIER to use than ever before!

      • A much cleaner and better organized appearance
      • New built-in help screens to guide you
      • New simplified S3 Sync and Auto File Deletion service configuration screens
      • Use your mouse to point and click on menu options instead of relying on the keyboard alone*
      • Hold SHIFT or ALT on your keyboard and select text with your mouse to copy it to your clipboard, which is useful for web links*
        (*works in popular SSH terminal/console applications like PuTTY)

    • Corrected a bug in Automatic File Deletion Service that affects some users with Daily or Weekly AFD cycles. Update your AFD service from the EXPERT-MODE Auto File Deletion menu.
    • Automatic File Deletion Service has been added! You can now have Call Recordings deleted at a schedule of your choosing, while still retaining a select number of days on the local storage. This is great for keeping your instance storage requirements low and your server tidy. Auto File Deletion can be found under the Troubleshooting and Maintenance section.
    • S3 Sync Service has been added! You can now have Voicemails and Call Recordings sync to an S3 Bucket automatically at regular intervals. S3 Sync Service can be found under the Main Menu.
    • Fixed a few unreleased variables within the engine
    • Additional code optimizations and error logging
    • Added proper support for Asterisk 14 (BETA)
    • Added asterisk-version-switch to the Troubleshooting and Maintenance section, allowing you to switch Asterisk versions while keeping your existing dialplan intact
    • Added View/Email/Delete SmartUpgrade.log option to the Main Menu

      • Selecting this option will display the entire SmartUpgrade log. Follow the guide at the bottom of your SSH console to navigate the log [↑/↓/PgUp/PgDn=Scroll, </>=First/Last Line, /{pAtTeRn}=Search, Q=Quit]
      • After you Quit the viewer, you will be given the option to Delete and/or Email the log file (you will be asked for the destination address)
      • This is useful if you need to contact us for support for issues stemming from the upgrade process


Offline Profile Quote Post Goto Top
 
« Previous Topic · FAQ and Tutorials · Next Topic »
Add Reply

FreePBX® is a Registered Trademark of Sangoma Technologies and is used with permission.
TheWebMachine Networks is a fully certified Sangoma partner.