auto-lease v3.x Upgrading HOWTO

From Apez

Jump to: navigation, search

Starting with auto-lease v3.2, the standard package contains an 'updater' device which can be used to upgrade any auto-lease unit between v2.10 and v3.2 to the latest version (v3.4 as of this writing). The updater contains instructions for its use in a notecard (reproduced below).

The updater is capable of updating all auto-leases within a single region (sim) in bulk (except that it does them in batches of 30 at a time). While you can let is run unattended, you'll probably want to hang around to grant debt permission as each unit is reset.

An alternative to updating units in-place it to just replace them with a newly rezzed copy. You can then use the 'mark' and 'copy' commands to transfer setting and lease state over. See the Instructions and Setup Guide for details on how to use "copy".


Apez Auto-Lease Updater 3.4

IMPORTANT: Please read the caveats below before using the updater.

Usage instructions are at the bottom.


What does it do?

This updater can update all v2.11, v2.12, v3.0,v3.1 & v3.2 auto-lease units within one region (sim) to version 3.4, upto 30 at a time. It operates unattended since it can take about 2.5minutes per unit (an SL limitation) - although you'll want to remain in the sim in order to grant debt permission to each unit updated as it resets.

You can use it on vacant or leases units - it will not lose the lease information or major settings (unless the unit is out-of-sync with the site due to comms issues - see below for tips).


When should I use it?

In general, you only need to update your auto-lease units, if you'd like the new features provided by the new version, or your units are effected by issues that are addressed by a bug-fix release.

  • All owners of v3.x auto-leases are strongly encouraged to upgrade to v3.2*

Owners of v2.x series auto-leases may wish to upgrade due to the significant new features offered by the 3.x series.

This version also includes new functionality designed to work-around SL communication problems (by supporting the Apez.relay device - to be released in future).


How do I use it?

Before you begin:

  • The updater requires communication with the Apez server and all the units it needs to update - and it updates their inventory. So, if the SL grid is experiencing any issues related to inventory or networking, or the Apez server is unavailable, the updater may malfunction. Best to check the official SL blog and wait until your sim is running smoothly.
  • If you suspect any of your leases may be out-of-sync with the site, check them first before updating. After the update the units will take their lease state & settings from the server.
    • for auto-lease v2.x units, you can use the "update" chat command to force the unit to send an update to the server
    • for auto-lease v3.x units, if the information online is correct, just use the "force download" icon on the lease.spaces page, or reset the unit. If the unit is correct but the online information seems wrong, modify it online first.
    • if the unit doesn't appear to be listed online at all, use the "register" command for v2.x, and "update" for v3.x. Failing that, manually record the information so you can enter it online after the update.
  • Note that once started, the updater cannot be stopped (except by being deleted)
    • if you need to delete it, do it during the 'gathering information' phase between unit updates to avoid leaving a unit in a partially-updated state.


To update auto-lease units in a region (sim):

  • Rezz the updater
    • be sure it will not be auto-returned before it completes (which could take over an hour if updating 30 units)
  • Touch it to begin
    • either hand around the sim so you can grant debt-permission to each unit as it resets, or be sure to reset each one afterward.

(you can reset a unit using the Edit mode SL Tools menu command "reset scripts in selection". Don't reset more than about 5 at once if you use multiple-selection or you may exceed your sim's outgoing communication limit)

It will show the status of the update in float-text and will also chat when it completes each unit.

  • If you have further units to update, simple touch it again to re-start the process. It will not attempt to update the units that are already up-to-date.

Note that prior to the update of each unit's data online, the server creates a backup. So, if anything goes terribly wrong and you'd like to have the data restored, you can open a help ticket with the location & name of the unit and we can restore it for you. (if the unit appears online, don't use the online 'delete' action as that will overwrite the backup data)

Tip: the pop-up tool-tip information displayed when you hover your mouse over the "tick" icon on the lease.spaces page includes the version number of the unit.


Caveats:

  • Some auto-lease settings are not migrated during an update
    • v2.x - rules, prim size and offset
    • <v3.4 - prim size and offset
  • auto-lease units linked into other objects are not supported
  • if the updater is deleted/interrupted during the update of a unit, it may still be able to be updated again. However, if the server has already migrated the data, it may not know it wasn't completed. In this case it is best to delete the unit and replace it with a new one.
  • Note to auto-lease v2.x owners: the new 3.x supports credit of Apez.bank accounts for payments, in addition to your avatar directly (as v2.x). By default, when a v2.x unit is upgraded, it is set to continue to pay your avatar. If you'd like it to pay into an account instead, you'll need to set the 'linked account' option online.
Retrieved from "http://www2.apez.biz/wiki/auto-lease_v3.x_Upgrading_HOWTO"
Personal tools

A d v e r t i s m e n t