Runtime Reconfiguration (reconfigure-mms) Utility

Reconfigures local or remote Unwired Servers to use different cache database (CDB) properties. You can enter new values for the CDB host, port, server name, user name, password, or start mode. This utility is located in <UnwiredPlatform_InstallDir>\Servers\UnwiredServer\bin.

This script updates connection values for the cluster database, endpoints and DSNs for the Unwired Server. If the CDB is on the same host (local), the script also recreates the CDB Windows service.

Before using this command:

If the CDB installed on a different host from Unwired Server, ensure that the CDB server is running.
If the CDB server is co-hosted with Unwired Server, ensure that all the services, including the CDB services, are stopped.

Syntax

reconfigure-mms.bat [-installtype {default | remote}] [-servicemode {auto | manual}] [-cdbuser {cdb_user_name}] [-cdbpwd {cdb_user_password}] [-cdbhost {cdb_host}] [-cdbport {cdbport}] [-cdbserver {cdb_server_name}]

Parameters

installtype – the type of database install; either default or remote. Use remote when moving database to different host than the one shared with Unwired Server
cdbhost – the name of the machine where the existing database server is running.
cdbport – the port over which CDB communication takes place. Default: 5200.
cdbpwd – the database user password. Default: sql.
cdbserver – the name of the database server used to manage requests for the cache database. Default: <MyComputer>_primary. If the database is on another host or is part of a cluster, you may need to use another host name.
cdbuser – the user name to log into the CDB.
servicemode – start mode of Unwired Server. Use auto to start Unwired Server in service mode. Use manual to start it in application mode.

Examples

Basic Example – This command start the CDB at a new port of 5300:
```
reconfigure-mms.bat -cdbport 5300
```
Advanced Example – This command changes the host, port, and server name of CDB because it has moved to a different host:
```
reconfigure-mms.bat -cdbhost W2K3-VM -cdbport 5200 -cdbuser dba -cdbpwd sql -cdbserver
W2K3-VM_primary
```

Usage

The usage varies depending on whether or not the CDB is co-hosted with Unwired Server:

When CDB is hosted separately – Perform these steps:
1. If you are moving the CDB to a new host, copy the .db and .log files from <UnwiredPlatform_InstallDir>\UnwiredPlatform\Servers\UnwiredServer\data from the existing host to the new host.
2. Start the CDB server.
3. Run reconfigure-mms.bat by passing necessary property values as described in syntax.
4. Restart Unwired Platform services.
When CDB is co-hosted – Perform these steps:
1. Stop all Unwired Platform services, including CDB services.
2. Run reconfigure-mms.bat by passing necessary property values as described in syntax. At minimum, the cdbhost property is required.
3. Restart Unwired Platform services.