Upgrading to Eclipse Amlen version 1.0: server configuration only

System administrators can upgrade their IBM® IoT MessageSight version 1.2 systems to Eclipse Amlen version 1.0 by exporting and importing the server configuration file. The server configuration file is exported from an IBM IoT MessageSight version 1.2 physical or virtual appliance and imported into a running Eclipse Amlen version 1.0 environment.

The IBM IoT MessageSight version 1.2 server must be at the latest interim fix level. A list of interim fixes is available here: Fixes released for IBM IoT MessageSight.
The Eclipse Amlen version 1.0 server to which you are exporting the server configuration file must be installed and configured and have no configured objects.
It is best practice to take a backup of the IBM IoT MessageSight production system store to test the upgrade process before you perform the upgrade process. For instructions for taking a backup of the IBM IoT MessageSight production system store, see Upgrading to Eclipse Amlen version 1.0: taking a backup of the IBM IoT MessageSight version 1.2 configuration and store.

Only those configuration items from the server such as endpoints, messaging policies, connection policies, LDAP configuration objects, and any configuration objects that are configured by using commands by an administrator are included in the upgrade process that exports and imports the server configuration file only. The server store is not migrated.

Export the IBM IoT MessageSight version 1.2 server configuration file to Eclipse Amlen version 1.0.
1. Create a backup copy of the server configuration file by using the imaserver backup command.
  For example:
```
imaserver backup "Password=mybackuppw" "V2Migration=True" 
```
  The IBM IoT MessageSight server can now back up server configuration without the need to enter maintenance mode.
  For information about using the imaserver backup command, see imaserver backup command
2. Copy the exported server configuration file to a commonly accessible server. Upload the backup file to an SSH server for storage by using the file put command.
  For information about using the file put command, see file put command.
3. Upload the server configuration file to the Eclipse Amlen version 1.0 server by using the REST API PUT method.
  For example:
```
curl -X PUT -T /path/to/directory/imaBackup.215448-05262016
http://<server>:<port>/ima/v1/file/imaBackup.215448-05262018
```
Import the server configuration backup file on the Eclipse Amlen version 1.0 server by using the REST API POST method:
```
curl -X POST  http://<server>:<port>/ima/v1/service/import -d '{
"FileName":"imaBackup.215448-05262018","Password":"mybackuppw","DisableObjects":true,"ApplyConfig":true|false}'
```
where:
- Filename
  
  Specifies the path to a file in the virtual file system inside the server.
  
  The argument should match the filename that is used in the URL in step 1c.
- ApplyConfig: true|false
  
  Specifies whether the imported server configuration is to be applied to the server. By default, the imported configuration is returned as a response to the REST call for users to verify an imported configuration.
  
  The default is false.
The server restarts in maintenance mode.
Review, modify and fix the following migrated configuration:
In particular, review and fix:
- Endpoint configuration, particularly if your endpoints were listening on specific interfaces. If such explicit interfaces are different, the upgrade process cannot update the configuration to the new values.
- Existing LDAP configuration which might need to be changed.
- Other configuration items that might need to be amended for the new environment.
The configuration changes can be made either by using REST APIs, or by using the WebUI.

The Eclipse Amlen version 1.0 server is ready for messaging traffic. You can now switch messaging traffic from IBM IoT MessageSight to the Eclipse Amlen version1.0 server.