Moving Iotellect Server Installation

Relocating or replicating Iotellect Server installation from one machine to another can be useful in the following cases:

  • at first stages of project development, for moving from a development PC to a production server
  • if a production server is switched to a new hardware configuration or operating system

The relocation process comprises following steps:

  • Installation of Iotellect Server on a new machine
  • Configuration file copying
  • Database replication
  • Statistics replication

    • Installing New Iotellect Server

    A fresh copy of Iotellect Server should be installed on a new server machine. Version of Iotellect Server installed on a new machine must be same (recommended) or newer than Iotellect Server version of a moved installation. The installation language must be the same as of the installation being moved.

    The new installation should include the same set of vertical market extensions (and, thus, Iotellect Server plugins and drivers) as the old installation.

    Copying Configuration File

    At the second step, server.xml global configuration file should be copied from the old installation to the new one by overriding default config file of the new installation.

    Database Replication

    Third step is moving server database to the new installation. There are several ways to perform this:

  • By installing a fresh copy of database engine on the new server and manually moving database files according to server's database relocation instructions.
  • By installing a fresh copy of database engine on the new server, creating an empty database, and following Switching to Another Database Engine instruction set to move data from the old database to the new one.
  • If the new Iotellect Server installation should use same standalone database that was used by the old one, just check/modify databaseUrl parameter in the copied server configuration file (server.xml) to make sure IP address or host name of the database server is the correct one that should be used from the new server location.

    • If Iotellect Server uses a bundled MySQL or Apache Derby database, the database relocation should be very simple:

    • For bundled MySQL database, just copy /mysql subfolder of old Iotellect Server installation folder to the new server. Make sure both servers are stopped during this process! When the copy is created, make sure MySQL auto-started during startup of the new server machine. For example, on a Windows machine it's possible to use mysqld --install command to install MySQL as a service. See details here: http://dev.mysql.com/doc/refman/4.1/en/windows-start-service.html
    • For bundled Apache Derby database, just copy /db subfolder of old Iotellect Server installation folder to the new server. Make sure both servers are stopped during this process!

    Statistics Replication

    To relocate a Round-Robin Database used by statistical process control module:

    • Make sure both old and new servers are stopped
    • Copy or move /statistics folder from the old installation to the new one. Check statisticsFolder parameter the old configuration file (server.xml) to locate statistics folder in the old installation (it's located in Iotellect Server installation folder by default). Check or modify statisticsFolder parameter in the new installation's configuration file to find out the proper destination of copied statistics folder.

    Was this page helpful?