Skip to main content

Migrating mobile device registrations

The migratedata.exe Bravura Security Data Migration Utility may be used during a migration to export and import the mobile device registration data for users so that they are not required to re-register their devices on the Bravura Security Fabric server that the data will be imported into.

When migrating the mobile device registrations and the instance name has changed for Bravura Security Fabric and/or the company name has changed for the Bravura One mobile proxy server Apache configuration, the Proxy server URL address for the Mobile Worker Service may remain the same, however the rewrite rule in the Apache configuration on the Bravura One mobile proxy server will need to be modified. This is to ensure that when one or both of these names have changed, that users will not be required to re-register their mobile devices.

The following will need to be added for the rewrite rule from the previous version in the Apache configuration:

E=COMPANY:<new-company-name>,E=INSTANCE:<new-instance-name>

A second rewrite rule will need to be added that includes the following:

E=PREVURLPATH:<company>/<instance>/

The two rules are required to ensure that mobile devices that were registered with the previous instance will still work with the new instance as well as for when new mobile devices are registered using the new instance.

For example, the rewrite rule from the previous version is removed and replaced with the following two rewrite rules:

RewriteRule ^/<company>/<instance>/(.⋆)$ /cgi-bin/mobproxy-new-version [L,PT,E=COMPANY:<new-company-name>,E=INSTANCE:<new-instance-name>,E=BYPASSAUTH:.+\\.(woff|woff2|htm|html|jpg|gif|png|js|css)$,E=DEBUGDUMPENVS:0,E=HTTP_AUTHORIZATION:%{HTTP:Authorization},E=HTTP_MOBPROXY_KEY:<proxyauthenticationkey>]

RewriteRule ^/<new-company-name>/<new-instance-name>/(.⋆)$ /cgi-bin/mobproxy-new-version [L,PT,E=PREVURLPATH:<company>/<instance>/,E=BYPASSAUTH:.+\\.(woff|woff2|htm|html|jpg|gif|png|js|css)$,E=DEBUGDUMPENVS:0,E=HTTP_AUTHORIZATION:%{HTTP:Authorization},E=HTTP_MOBPROXY_KEY:<proxyauthenticationkey>]

See Migration for more detailed information about migrations and the migratedata.exe Bravura Security Data Migration Utility.

In this section: