Pulse Phone docs

Updating

10. Updating from an older version

Existing numbers, accounts and device records are kept, and older pro and promax handset IDs stay readable. Always take stream/ and ui/ from the same release as the rest of the folder.

  1. Keep a copy of your old phone folder, and back up your database. Move the old folder out of resources: two phone folders start two phones.
  2. Put the new phone folder in its place.
  3. Keep the new configuration files and transfer the settings you changed by their Config names. Version 1.2.7 groups the former individual feature files into config/apps.lua and moves call settings into config/config.lua. Do not overwrite these with the old split files: those files no longer load. Animations, music and trivia retain their own files. Preserve private settings in config/apiKeys.lua if you use it; existing server.cfg credentials continue working. Keep the new translations and merge your own wording where needed. Leave Config.Radio.registerChannelChecks = false unless you want Pulse to manage restricted radio channels.
  4. Copy your files in ownermedia/ back, and your media/ folder if you use the built-in photo store.
  5. Don't copy old bridge/ files back (or the custom-adapter folders of an older version). If you changed one, make the same change in the new file.
  6. Add any new items from config/items/ to your inventory (section 4).
  7. Restart. The database updates itself. Read the start-up check in the console.

Settings your older config.lua doesn't have run on their defaults. To change one, copy that section from the new config/config.lua into yours. For example, without Config.Block dead and cuffed players can't use the phone and downed players can call 911; without Config.Charging no cable is needed (the console says so once); without Config.Store.box phones come without a box.

  • Rolling back: put the previous folder back. On MySQL, data written by the newer version stays readable.
  • Without a database, also back up FXServer's key/value store (the db folder in your server data folder) before updating.
  • Never set phone_dev 1 on a public server. It turns on developer test tools.