Upgrading to Eclipse Amlen version 1.0: taking a backup of the IBM IoT MessageSight version 1.2 configuration and store

Before you migrate the IBM® IoT MessageSight version 1.2 configuration file and store to a running Eclipse Amlen version 1.0 server, it is best practice to take a backup of the production server store and copy it to a test environment to test the upgrade process.

You must have an IBM IoT MessageSight version 1.2 server that is not in production for restoring the backup and testing the upgrade process. Do not use a production system to test the upgrade process.
You must be prepared for a server outage and restart of your IBM IoT MessageSight version 1.2 server.

Put your IBM IoT MessageSight version 1.2 server into maintenance mode by issuing the following commands:
```
imaserver runmode maintenance
imaserver stop
imaserver start
```

Back up the store by using the imaserver backup command.

For example:

imaserver backup "Password=backup_password"
"StoreDestinationURL=scp://10.10.0.2:/data/backup/store_backup_201605091530"
"StoreDestinationUserID=root" 'StoreDestinationPassword=mypassword'

For more information about using the imaserver backup command, see imaserver backup command.

Put your IBM IoT MessageSight version 1.2 server into production mode by issuing the following commands:
```
imaserver runmode production
imaserver stop
imaserver start
```
Use the file put command to copy the backup file that was created by the imaserver backup to the same server that was used for the store backup.
For example:
```
file put imaBackup.153121-05092016 scp://root@10.10.0.2:/data/backup
```
For more information about using the file put command, see file put command.
Use the file get command to copy the backup file to the IBM IoT MessageSight version 1.2 server that is to be used for testing the backup and upgrade process.
For example:
```
file get scp://root@10.10.0.2:/data/backup/imaBackup.153121-05092016 imaBackup.153121-05092016
```
For more information about using the file get command, see file get command.
Put your IBM IoT MessageSight version 1.2 test server into maintenance mode by issuing the following commands:
```
imaserver runmode maintenance
imaserver stop
imaserver start
```

Restore the store backup file and configuration backup file on the test server by using the imaserver restore command.

For example:

imaserver restore "Name=imaBackup.153121-05092016"  "Password=backup_password"
"Appliance=False"  "StoreSourceURL=scp://10.10.0.2:/data/backup/store_backup_20160509"
"StoreSourceUserID=root" "StoreSourcePassword=mypassword"

For more information about using the imaserver restore command, see imaserver backup command

The IBM IoT MessageSight version 1.2 test server is ready to use to test the upgrade process. Follow the instructions in Upgrading to Eclipse Amlen version 1.0: server configuration and store.