{"id":832,"date":"2019-07-22T12:44:46","date_gmt":"2019-07-22T19:44:46","guid":{"rendered":"https:\/\/portal.staylinked.com\/sl\/kb\/?post_type=ht_kb&p=832"},"modified":"2022-09-07T08:05:59","modified_gmt":"2022-09-07T15:05:59","slug":"server-migration","status":"publish","type":"ht_kb","link":"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/server-migration\/","title":{"rendered":"Server Migration"},"content":{"rendered":"\n

Moving the StayLinked Server Process <\/h2>\n\n\n\n

Since there is an occasional need to migrate the StayLinked server process from one system to another, we\u2019ve created this summary article to support a trouble-free transition. As a Java process, the StayLinked server can be installed on a variety of hosts. This guide is intended as an overview and does not include information specific to any of the various host platforms. This guide is a supplement to the installation guide for each server platform. All StayLinked servers must meet the prerequisites described in the server installation guide for your server platform. Moves from one server platform to another should consult the new installation checklist<\/a>, since many settings may need to be adjusted for the new server configuration.<\/strong><\/p>\n\n\n\n

General\nOverview<\/p>\n\n\n\n

  1. Install StayLinked Server Process on new server.<\/li>
  2. Contact StayLinked with the Serial Number generated by the server process.<\/li>
  3. Copy the configuration files from the production system to the new server.<\/li>
  4. Start the server process on the new system.<\/li>
  5. Install testing\/temporary licensing for the new serial number.<\/li>
  6. Move server addresses or redirect devices to the new server.<\/li>
  7. Complete a license transfer and install permanent licensing.<\/li><\/ol>\n\n\n\n

    Moving permanent licenses from one server to another requires a License Transfer Agreement to be completed by an authorized representative of the purchasing company. The StayLinked technical support team is available to customers with current support contracts. Software upgrades are available only to customers with current support.<\/p>\n\n\n\n

    The Old Server<\/h2>\n\n\n\n

    Depending on your install date or last upgrade, it may be important to check your current StayLinked version before you move to a new system. This can be especially important with virtualization, which has become more popular in recent years. StayLinked typically releases a new build of the server about every nine months. While it is understandable that you might not want to change versions during your move, it is important to recognize that we cannot provide extensive support for versions that have been retired. <\/p>\n\n\n\n

    The New Server<\/h2>\n\n\n\n

    For StayLinked purposes, the new system is going to fall into one of two categories: a new installation or a migration. Migrating with a system virtualization or save\/restore processes will take all of your settings along. If you\u2019re starting a new installation, you\u2019ll need to transfer your configuration. Any time the server is moved, you\u2019ll want to be sure to revisit your settings and adjust any relative configuration.<\/p>\n\n\n\n

    Copying Server Configuration<\/h3>\n\n\n\n

    There are a few options to copy the\nconfiguration from one server to another. You can manually copy the\nconfiguration files, manually match the configuration dialogues, or use StayLinked\nAdministrator\u2019s Import\/Export features.<\/p>\n\n\n\n

    The Import\/Export options are available in\nv10.1, but may be hidden or locked depending on the configuration of your user\naccount.<\/p>\n\n\n\n

    Manually copying the configuration files requires access to the file system of both the new and existing servers. With the exception of one file, the \\config and \\devices subdirectories can be copied from one system to another. The one file to exclude or adjust is called \\config\\espadmin.xml. This file contains the server licensing, which is validated to the hardware of a particular server. The \\config files can be copied while the server is running, while the \\devices directory must be copied while the server process has been stopped. If the \\config files are copied to a running system, create an empty file named reload.xml in the \\config directory and the server will automatically re-read the affected files.<\/p>\n\n\n\n

    Server version 15.3 build 214 and newer allow for the production and alternate licensing to be installed at the same time. This allows the replication of the espadmin.xml file. More details on this can be found in the Administrator User Guide section for Server Administrator<\/a>.<\/p>\n\n\n\n

    Export Server Configuration<\/strong><\/h3>\n\n\n\n

    When you select Servers > Configuration > Export from the pulldown menus, you will be prompted for a location to save the \u2018StayLinked Configuration (.slc)\u2019 file. The default file name will match the server name. This file will contain the configuration files for \u2018Telnet Host Groups\u2019, \u2018Device Groups\u2019, \u2018Keyboard Maps\u2019, \u2018Tap Spots\u2019, \u2018Client Settings\u2019, \u2018Session Partnerships\u2019 and \u2018Scan2Command\/Configure Profiles\u2019 exported from the current StayLinked server. <\/p>\n\n\n\n

    Import Server Configuration<\/strong><\/h3>\n\n\n\n

    When you select to import the server configuration, you will be prompted for the location of the \u2018StayLinked Configuration (.slc)\u2019 file that you wish to import to the current server. Once you select a valid SLC file, you will be presented with an \u2018Import\u2019 dialog that will allow you to select the various configuration files available. You will be prompted to confirm the import of any configuration files. <\/p>\n\n\n\n

    Licensing<\/a><\/h2>\n\n\n\n

    StayLinked licensing is based on the hardware hosting the StayLinked server process. Installing StayLinked on a new system will almost always result in a new StayLinked serial number. It is recommended that StayLinked is installed on the new system prior to the implementation of production services on the new system. StayLinked support can provide licensing for any testing that may be required before the live transition.<\/p>\n\n\n\n

    In some cases, the method of determining the StayLinked server serial numbers has changed. Upgrading your StayLinked server may require new licensing. StayLinked serial numbers are displayed in the StayLinked Administrator: <\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Client \u2013 Server Configuration<\/h2>\n\n\n\n

    If the new server is taking over the network address of the old system, the devices will continue to connect to the same network address after the server move is complete. If you plan to keep the new server on a different network address, the devices may need to be redirected to the new server. If you use DNS names instead of hard addresses, you may choose to simply change the resolving address for the DNS entry. <\/p>\n\n\n\n

    StayLinked devices can be redirected to a new StayLinked server using the \u2018StayLinked Server IP\u2019 client setting in the StayLinked Administrator. The server IP address is configured as part of the \u2018Server\u2019 group. Scan2Configure programming barcodes can also be used to change the server address. These options are detailed in the Administrator User\u2019s Guide. <\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Devices that should have the option to connect to multiple StayLinked servers can use the servers.ini supplemental configuration file. This file can also be distributed as a \u2018configuration file transfer\u2019 client setting. Details on servers.ini can be found in the client guide for your device operating system and client version.<\/p>\n\n\n\n

    <\/p>\n","protected":false},"excerpt":{"rendered":"

    Moving the StayLinked Server Process Since there is an occasional need to migrate the StayLinked server process from one system to another, we\u2019ve created this summary article to support a trouble-free transition. As a Java process, the StayLinked server can be installed on a variety of hosts. This guide is…<\/p>\n","protected":false},"author":7,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[38],"ht-kb-tag":[],"yoast_head":"\nServer Migration – StayLinked<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.staylinked.com\/knowledge-base\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Server Migration – StayLinked\" \/>\n<meta property=\"og:description\" content=\"Moving the StayLinked Server Process Since there is an occasional need to migrate the StayLinked server process from one system to another, we\u2019ve created this summary article to support a trouble-free transition. As a Java process, the StayLinked server can be installed on a variety of hosts. This guide is...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/server-migration\/\" \/>\n<meta property=\"og:site_name\" content=\"StayLinked\" \/>\n<meta property=\"article:modified_time\" content=\"2022-09-07T15:05:59+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/07\/ServerMig-Lic.jpg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/#website\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/\",\"name\":\"StayLinked Knowledge Base\",\"description\":\"Partner Portal Resources and Support\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/portal.staylinked.com\/sl\/kb\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/server-migration\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/07\/ServerMig-Lic.jpg\",\"contentUrl\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2019\/07\/ServerMig-Lic.jpg\",\"width\":912,\"height\":425},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/server-migration\/#webpage\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/server-migration\/\",\"name\":\"Server Migration – StayLinked\",\"isPartOf\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/server-migration\/#primaryimage\"},\"datePublished\":\"2019-07-22T19:44:46+00:00\",\"dateModified\":\"2022-09-07T15:05:59+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/server-migration\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/server-migration\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/server-migration\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/portal.staylinked.com\/sl\/kb\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Articles\",\"item\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Server Migration\"}]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","_links":{"self":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/832"}],"collection":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/comments?post=832"}],"version-history":[{"count":2,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/832\/revisions"}],"predecessor-version":[{"id":4106,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/832\/revisions\/4106"}],"wp:attachment":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/media?parent=832"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=832"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=832"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}